@memberjunction/server 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/services/TaskGraphAgentRunner.js

@@ -13,8 +13,11 @@
  * @module @memberjunction/server
  */
 import { AgentRunner } from '@memberjunction/ai-agents';
+import { AIEngine } from '@memberjunction/aiengine';
 import { ChatMessageRole } from '@memberjunction/ai';
 import { LogError } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { UserCache } from '@memberjunction/generic-database-provider';
 export class TaskGraphAgentRunner {
     async RunAgentForTask(params) {
         try {
@@ -22,20 +25,70 @@ export class TaskGraphAgentRunner {
             if (!(await agent.Load(params.AgentID))) {
                 return { Success: false, ErrorMessage: `Agent ${params.AgentID} could not be loaded.` };
             }
-            const result = await new AgentRunner().RunAgent({
+            const parentRun = await this.loadSubmittingRun(params);
+            const actingUser = this.resolveActingUser(parentRun?.UserID, params.ContextUser);
+            const engineLoaded = (AIEngine.Instance?.Agents?.length ?? 0) > 0;
+            if (engineLoaded && actingUser && typeof AIEngine.Instance.CanUserRunAgent === 'function') {
+                const permitted = await AIEngine.Instance.CanUserRunAgent(agent.ID, actingUser);
+                if (!permitted) {
+                    return {
+                        Success: false,
+                        ErrorMessage: `User does not have permission to run agent "${agent.Name}".`,
+                    };
+                }
+            }
+            const taskContext = await this.resolveTaskContext(params);
+            const conversationDetailId = parentRun?.ConversationDetailID ?? taskContext.conversationDetailId ?? undefined;
+            const runner = new AgentRunner(params.Provider);
+            const result = await runner.RunAgent({
                 agent,
-                conversationMessages: [{ role: ChatMessageRole.user, content: this.buildPrompt(params) }],
-                contextUser: params.ContextUser,
+                provider: params.Provider,
+                conversationMessages: [{
+                        role: ChatMessageRole.user,
+                        content: this.buildPrompt(params, taskContext.name, taskContext.description),
+                    }],
+                contextUser: actingUser,
+                conversationId: parentRun?.ConversationID ?? undefined,
+                // A task-graph step receives its explicit InputPayload and DependencyOutputs.
+                // Passing an empty inputArtifacts array prevents AgentRunner.hydrateConversationArtifacts
+                // from loading unrelated artifacts from earlier turns in the conversation and tempting
+                // the step agent to emit `version-source` against a prior turn's artifact.
+                inputArtifacts: [],
                 // Inherited from the graph, so a graph this run goes on to emit is one hop deeper
                 // rather than starting the chain over. Without it MAX_REINVOKE_DEPTH never fires.
                 continuationDepth: params.ContinuationDepth ?? 0,
-                parentRun: await this.loadSubmittingRun(params),
+                parentRun,
                 // The bridge from the agent's own progress stream up to graph-level observers: the
                 // dispatcher turns these into rate-limited `NodeProgress` frames, which is how a
                 // running Agent step shows "what it is doing right now" on the workflow canvas.
                 onProgress: this.bridgeProgress(params),
             });
             const success = result?.success === true;
+            if (success &&
+                result?.payload != null &&
+                conversationDetailId &&
+                result.artifactDirective?.behavior !== 'suppress' &&
+                typeof runner.ProcessAgentArtifacts === 'function') {
+                try {
+                    // Each step in a task graph is an independent workflow node and multiple steps
+                    // in the same graph share the originating ConversationDetailID. Enforcing
+                    // `behavior: 'create-new'` (while preserving any directive name/description)
+                    // prevents a step from accidentally versioning an earlier turn's artifact or
+                    // overwriting a sibling DAG step's artifact via FindPreviousArtifactForMessage.
+                    const stepArtifactResult = {
+                        ...result,
+                        artifactDirective: {
+                            ...result.artifactDirective,
+                            behavior: 'create-new',
+                        },
+                    };
+                    await runner.ProcessAgentArtifacts(stepArtifactResult, conversationDetailId, undefined, actingUser, params.Provider);
+                }
+                catch (artifactErr) {
+                    LogError(`[TaskGraphAgentRunner] Task ${params.TaskID}: artifact persistence failed (non-fatal): ` +
+                        `${artifactErr instanceof Error ? artifactErr.message : String(artifactErr)}`);
+                }
+            }
             return {
                 Success: success,
                 Output: this.extractOutput(result),
@@ -49,6 +102,54 @@ export class TaskGraphAgentRunner {
             return { Success: false, ErrorMessage: message };
         }
     }
+    resolveActingUser(ownerUserId, fallback) {
+        if (!ownerUserId) {
+            return fallback;
+        }
+        try {
+            const users = UserCache.Instance?.Users ?? UserCache.Users ?? [];
+            const matched = users.find((u) => UUIDsEqual(u.ID, ownerUserId));
+            if (matched) {
+                return matched;
+            }
+        }
+        catch {
+            // Fall back to params.ContextUser when UserCache is not initialized.
+        }
+        return fallback;
+    }
+    /**
+     * Resolves the step task's `Name`, `Description`, and originating `ConversationDetailID`
+     * (falling back to the parent workflow task row for `ConversationDetailID`).
+     */
+    async resolveTaskContext(params) {
+        if (!params.TaskID) {
+            return { name: null, description: null, conversationDetailId: null };
+        }
+        try {
+            const task = await params.Provider.GetEntityObject('MJ: Tasks', params.ContextUser);
+            if (!(await task.Load(params.TaskID))) {
+                return { name: null, description: null, conversationDetailId: null };
+            }
+            const rawDesc = (task.Description || '').trim();
+            const cleanDesc = rawDesc.split(/\n\n--- (?:Output|Error) ---\n/)[0]?.trim() || null;
+            let conversationDetailId = task.ConversationDetailID ?? null;
+            if (!conversationDetailId && task.ParentID) {
+                const parentTask = await params.Provider.GetEntityObject('MJ: Tasks', params.ContextUser);
+                if (await parentTask.Load(task.ParentID)) {
+                    conversationDetailId = parentTask.ConversationDetailID ?? null;
+                }
+            }
+            return {
+                name: task.Name?.trim() || null,
+                description: cleanDesc,
+                conversationDetailId,
+            };
+        }
+        catch {
+            return { name: null, description: null, conversationDetailId: null };
+        }
+    }
     /**
      * Adapts the agent framework's progress callback onto the dispatcher's plain sink.
      *
@@ -95,14 +196,19 @@ export class TaskGraphAgentRunner {
         }
     }
     /**
-     * Builds the agent's instruction from the task's own input plus its dependencies' outputs.
+     * Builds the agent's instruction from the task's name/description, its structured input payload,
+     * and its dependencies' outputs.
      *
      * Dependency outputs are included inline because a task's whole reason for depending on another
      * is to consume what it produced. They are rendered as labelled JSON rather than prose so the
      * agent can parse them reliably rather than inferring structure from formatting.
      */
-    buildPrompt(params) {
+    buildPrompt(params, taskName, taskDescription) {
         const sections = [];
+        if (taskName || taskDescription) {
+            const header = taskName ? `## Task: ${taskName}` : '## Task Description';
+            sections.push(taskDescription ? `${header}\n${taskDescription}` : header);
+        }
         if (params.InputPayload != null) {
             sections.push(`## Task input\n\`\`\`json\n${JSON.stringify(params.InputPayload, null, 2)}\n\`\`\``);
         }
@@ -116,12 +222,54 @@ export class TaskGraphAgentRunner {
             ? sections.join('\n\n')
             : 'Execute this task.';
     }
-    /** Prefers a structured payload over prose, so downstream tasks get data rather than text. */
+    /**
+     * Prefers a structured payload over prose so downstream tasks get data rather than text,
+     * while preserving `agentRun.Message` when the payload object has no `message`/`summary`
+     * property (e.g., when a sub-agent returns a clarification question or human-readable summary)
+     * and normalizing `results` / `result` / `succeeded` for downstream condition evaluation.
+     */
     extractOutput(result) {
         const r = result;
-        if (r?.payload != null)
+        const runMessage = typeof r?.agentRun?.Message === 'string' ? r.agentRun.Message.trim() : '';
+        const isChatStop = r?.agentRun?.FinalStep === 'Chat';
+        if (r?.payload != null) {
+            if (typeof r.payload === 'object' && !Array.isArray(r.payload)) {
+                const payloadObj = r.payload;
+                const enriched = { ...payloadObj };
+                if (enriched.results &&
+                    typeof enriched.results === 'object' &&
+                    !Array.isArray(enriched.results)) {
+                    for (const [k, v] of Object.entries(enriched.results)) {
+                        if (enriched[k] === undefined) {
+                            enriched[k] = v;
+                        }
+                    }
+                }
+                if (enriched.results !== undefined && enriched.result === undefined) {
+                    enriched.result = enriched.results;
+                }
+                else if (enriched.result !== undefined && enriched.results === undefined) {
+                    enriched.results = enriched.result;
+                }
+                if (runMessage && enriched.message == null && enriched.summary == null) {
+                    enriched.message = runMessage;
+                }
+                if (isChatStop) {
+                    enriched.finalStep = 'Chat';
+                }
+                else if (typeof r.success === 'boolean' && enriched.succeeded === undefined) {
+                    enriched.succeeded = r.success;
+                }
+                return enriched;
+            }
             return r.payload;
-        return r?.agentRun?.Message ?? null;
+        }
+        if (runMessage) {
+            return isChatStop
+                ? { message: runMessage, finalStep: 'Chat' }
+                : { message: runMessage, succeeded: r?.success === true };
+        }
+        return null;
     }
 }
 //# sourceMappingURL=TaskGraphAgentRunner.js.map

package/dist/services/TaskGraphAgentRunner.js.map

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

package/dist/services/TaskGraphContinuationDeliverer.d.ts

@@ -13,6 +13,7 @@
  * @module @memberjunction/server
  */
 import { type UserInfo } from '@memberjunction/core';
+import type { PubSubEngine } from 'type-graphql';
 import type { ProviderFactory, TaskContinuationDeliverer, TaskContinuationParams } from '@memberjunction/task-graph';
 /**
  * Delivers a finished graph's outcome — as a conversation message, or by starting the submitting
@@ -29,14 +30,16 @@ import type { ProviderFactory, TaskContinuationDeliverer, TaskContinuationParams
 export declare class TaskGraphContinuationDeliverer implements TaskContinuationDeliverer {
     private readonly providerFactory;
     private readonly contextUser;
+    private readonly pubSub?;
     /**
      * @param providerFactory mints a fresh provider per delivery, for the same reason the dispatcher
      *        does: deliveries run outside any request and concurrently with task execution, so
      *        sharing one provider would share one transaction scope across unrelated work.
      */
-    constructor(providerFactory: ProviderFactory, contextUser: UserInfo);
+    constructor(providerFactory: ProviderFactory, contextUser: UserInfo, pubSub?: PubSubEngine);
     /**
-     * Posts the roll-up as an AI-role message in the graph's conversation.
+     * Posts the roll-up as an AI-role message in the graph's conversation, on the fork of the
+     * message that started the graph (Main when that message is in Main).
      *
      * Never throws. The dispatcher calls this inside the compare-and-swap that marks a completion
      * delivered; an error escaping would either abort that guard or leave the graph looking
@@ -54,8 +57,58 @@ export declare class TaskGraphContinuationDeliverer implements TaskContinuationD
      * means there is budget left, and stamping the depth is what keeps that true for the next hop.
      */
     Reinvoke(params: TaskContinuationParams): Promise<void>;
-    /** The conversation a detail belongs to. */
-    private resolveConversationID;
+    /**
+     * Broadcasts a completion event on `PUSH_STATUS_UPDATES_TOPIC` so open conversation tabs
+     * immediately reload both the originating workflow message and the newly posted continuation reply.
+     */
+    private publishCompletion;
+    /**
+     * The conversation, fork (null is Main), owner user, loaded entity, and whether the originating
+     * detail is still the latest visible message in the conversation; null when it cannot be loaded.
+     */
+    private resolveOrigin;
+    /**
+     * Returns `true` when `originDetailId` is the newest visible message on its conversation branch,
+     * meaning no intervening messages were posted while the workflow ran in the background.
+     */
+    private isLatestConversationMessage;
+    /**
+     * Replaces the originating message's stale "I'll follow up when it finishes" copy with a clean
+     * completion note when the workflow outcome was delivered in a separate bottom continuation message.
+     */
+    private markOriginDetailCompleted;
+    /**
+     * Looks up the conversation owner's `UserID` from `MJ: Conversations` when the originating
+     * `MJ: Conversation Details` row is an AI message (`detail.UserID === null`).
+     */
+    private lookupConversationOwnerId;
+    /**
+     * Resolves the conversation owner's `UserInfo` from `UserCache` so `MJConversationDetailEntityExtended`
+     * ownership checks and artifact ownership succeed. Falls back to `this.contextUser` when not cached.
+     */
+    private resolveActingUser;
+    /**
+     * Loads child task `OutputPayload` rows for `params.ParentTaskID`, strips upstream payload keys
+     * inherited unchanged via `TaskGraphDispatcher.applyStepOutputMapping`, and replaces generic
+     * `"output available (N chars)"` summaries with readable output excerpts so both `PostMessage`
+     * and `Reinvoke` carry each step's own concrete results into the conversation.
+     */
+    private enrichTasksWithOutputs;
+    /**
+     * Resolves a human-readable explanation for each `Skipped` task in `params.Tasks` by inspecting
+     * its `MJ: Task Dependencies` (`Condition` and upstream prerequisite status).
+     */
+    private resolveSkippedTaskReasons;
+    /**
+     * Removes top-level JSON keys from `rawOutput` whose serialized value is identical to an
+     * earlier step's output in the same workflow (`TaskGraphDispatcher.applyStepOutputMapping`
+     * merges `{ ...payload, ...output }`), while recording this step's keys for downstream steps.
+     */
+    private stripInheritedUpstreamKeys;
+    /**
+     * Extracts a human-readable excerpt from a task's serialized `OutputPayload` (up to 2,500 chars).
+     */
+    private extractOutputExcerpt;
     /**
      * Renders the outcome as Markdown.
      *

package/dist/services/TaskGraphContinuationDeliverer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskGraphContinuationDeliverer.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphContinuationDeliverer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA+C,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKlG,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAKrH;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,YAAW,yBAAyB;IAOxE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAPhC;;;;OAIG;gBAEkB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,QAAQ;IAG1C;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvE;;;;;;;;;OASG;IACU,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDpE,4CAA4C;YAC9B,qBAAqB;IAKnC;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;CAQrB"}
+{"version":3,"file":"TaskGraphContinuationDeliverer.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphContinuationDeliverer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAwD,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAO3G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMrH;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,YAAW,yBAAyB;IAOxE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR5B;;;;OAIG;gBAEkB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,YAAY;IAG1C;;;;;;;OAOG;IACU,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgFvE;;;;;;;;;OASG;IACU,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2LpE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsDzB;;;OAGG;YACW,aAAa;IA4C3B;;;OAGG;YACW,2BAA2B;IAiCzC;;;OAGG;YACW,yBAAyB;IAsBvC;;;OAGG;YACW,yBAAyB;IAyBvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;;;OAKG;YACW,sBAAsB;IAwEpC;;;OAGG;YACW,yBAAyB;IA6EvC;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyG5B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;CASrB"}