@memberjunction/ai-agent-manager 6.2.0-edge.1 → 6.2.0-edge.3

package/dist/flow-step-validation.js

@@ -1,7 +1,13 @@
+import { CollectDecisionStepKeys, CompileFlowToTaskGraph, ValidateTaskGraphSpec } from '@memberjunction/ai-core-plus';
+import { UUIDsEqual } from '@memberjunction/global';
 /** True when this step repeats a body rather than being one. */
 export function IsLoopStep(step) {
     return step.StepType === 'ForEach' || step.StepType === 'While';
 }
+/** True when this step is a fast typed decision. */
+export function IsDecisionStep(step) {
+    return step.StepType === 'Decision';
+}
 /**
  * Which field carries the body's id, per body type.
  *
@@ -99,4 +105,212 @@ function parseLoopConfiguration(step, where, errors) {
         return null;
     }
 }
+/**
+ * Normalizes a Decision step's configuration so the aliases a model tends to write (`text` for a
+ * question's `instructions`, and `text` for an option's `description`) read as the fields
+ * `ReadFlowDecisionStepConfiguration` expects. Returns a copy; the input is not changed.
+ */
+export function NormalizeDecisionConfiguration(raw) {
+    const cloned = structuredClone(raw);
+    const questions = cloned.questions;
+    if (!isPlainObject(questions)) {
+        return cloned;
+    }
+    for (const question of Object.values(questions)) {
+        if (!isPlainObject(question))
+            continue;
+        copyAlias(question, 'text', 'instructions');
+        if (Array.isArray(question.options)) {
+            for (const option of question.options) {
+                if (isPlainObject(option))
+                    copyAlias(option, 'text', 'description');
+            }
+        }
+    }
+    return cloned;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Sets `record[to]` from `record[from]` when only the alias is present. */
+function copyAlias(record, from, to) {
+    if (!record[to] && typeof record[from] === 'string') {
+        record[to] = record[from];
+    }
+}
+/**
+ * A Decision step's configuration as JSON text, normalized. A model may write the configuration as
+ * an object rather than as JSON text, as it may for a loop; text that is not a JSON object is
+ * returned unchanged, so `ReadFlowDecisionStepConfiguration` reports why it cannot be read.
+ */
+export function DecisionConfigurationText(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw !== 'string') {
+        // Typed as an object, but it is a model's JSON: an array or a number can arrive here too, and
+        // is written as the JSON it is so the reader can say it is not an object.
+        return isPlainObject(raw) ? JSON.stringify(NormalizeDecisionConfiguration(raw)) : JSON.stringify(raw);
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return isPlainObject(parsed) ? JSON.stringify(NormalizeDecisionConfiguration(parsed)) : raw;
+    }
+    catch {
+        return raw;
+    }
+}
+/**
+ * A step's `Configuration` as the JSON text `AIAgentStep.Configuration` stores, which is what the
+ * runtime reads. An object is written as text, and a Decision step's is normalized
+ * ({@link DecisionConfigurationText}). `AgentSpecSync` saves this and {@link ValidateFlowGraph}
+ * compiles it, so what is validated is what is saved.
+ */
+export function StepConfigurationText(step) {
+    if (step.StepType === 'Decision')
+        return DecisionConfigurationText(step.Configuration);
+    const raw = step.Configuration;
+    if (raw == null || raw === '')
+        return null;
+    return typeof raw === 'string' ? raw : JSON.stringify(raw);
+}
+/**
+ * Every problem the runtime would refuse a Flow agent's steps and paths for, as messages that name
+ * the steps. Empty when the flow can run.
+ *
+ * The flow is compiled with `CompileFlowToTaskGraph` and the result validated with
+ * `ValidateTaskGraphSpec`, exactly as a Flow agent is before it runs, so a flow this passes is one
+ * the runtime runs and a flow it refuses is one the runtime refuses. That covers every Decision step
+ * the flow can reach: its configuration, its key, each condition that reads `decisions.<key>` (the
+ * key, the question, and whether that question's answer has the field read), and a fork on a Choice
+ * question that has no path for one of its options.
+ *
+ * Two checks come from outside the compiler, because it cannot see what they catch:
+ *  - a path whose origin or destination names no step, which the compiler drops without a word and
+ *    `AgentSpecSync` cannot save;
+ *  - a key two Decision steps share when the flow cannot reach one of them. The compiler checks only
+ *    the steps it compiles, but the in-run walker checks every step, since it can start at any.
+ *
+ * Names behind IDs are not resolved here: each ID stands in for its own name. The Architect checks
+ * a spec's actions, and a Decision step's prompt, separately. It also accepts a step whose sub-agent
+ * or inline prompt has no ID until the spec is saved, so a placeholder stands in for that ID.
+ *
+ * @param steps the flow's steps
+ * @param paths the flow's paths: `AgentSpec.Paths`, which is what `AgentSpecSync` saves
+ * @param workflowName the agent's name, which the compiled workflow carries
+ */
+export function ValidateFlowGraph(steps, paths, workflowName) {
+    const compilerSteps = steps.map(toCompilerStep);
+    const resolved = resolvePaths(paths, steps);
+    const compiled = CompileFlowToTaskGraph(compilerSteps, resolved.Paths, compilerOptions(workflowName));
+    return [
+        ...resolved.Errors,
+        // Over every step, as the in-run walker checks them. The compiler's own check covers only the
+        // steps it compiles, so every step it flags is flagged here too.
+        ...CollectDecisionStepKeys(compilerSteps).Errors.map(compileErrorMessage),
+        ...compiled.Errors.filter((e) => e.Code !== 'DuplicateDecisionKey').map(compileErrorMessage),
+        ...(compiled.Spec ? graphErrorMessages(compiled.Spec) : []),
+    ];
+}
+/** What stands in for an ID the Architect lets a spec leave empty until it is saved. */
+const FILLED_ON_SAVE = '(set when the spec is saved)';
+/** A step's identity in a spec: its ID, or its name for a step not yet saved. */
+function stepRef(step) {
+    return step.ID || step.Name;
+}
+/** A spec step as the compiler reads it: the row `AgentSpecSync` would save. */
+function toCompilerStep(step) {
+    return {
+        ID: stepRef(step),
+        Name: step.Name,
+        Description: step.Description ?? null,
+        StepType: step.StepType,
+        StartingStep: step.StartingStep === true,
+        // AgentSpecSync saves every step Active.
+        Status: 'Active',
+        ActionID: step.ActionID || null,
+        SubAgentID: step.SubAgentID || (runsSubAgent(step) ? FILLED_ON_SAVE : null),
+        PromptID: step.PromptID || (hasInlinePrompt(step) ? FILLED_ON_SAVE : null),
+        LoopBodyType: step.LoopBodyType,
+        Configuration: StepConfigurationText(step),
+        ActionInputMapping: mappingText(step.ActionInputMapping),
+        ActionOutputMapping: mappingText(step.ActionOutputMapping),
+    };
+}
+/** A Sub-Agent step, or a loop whose body is one. The Architect accepts either with no sub-agent ID yet. */
+function runsSubAgent(step) {
+    return step.StepType === 'Sub-Agent' || (IsLoopStep(step) && step.LoopBodyType === 'Sub-Agent');
+}
+/** A Prompt step, or a loop whose body is one, with its prompt written inline as `PromptText`. */
+function hasInlinePrompt(step) {
+    const runsPrompt = step.StepType === 'Prompt' || (IsLoopStep(step) && step.LoopBodyType === 'Prompt');
+    return runsPrompt && !!step.PromptText?.trim();
+}
+/** An action mapping as the JSON text the column stores. */
+function mappingText(mapping) {
+    if (mapping == null || mapping === '')
+        return null;
+    return typeof mapping === 'string' ? mapping : JSON.stringify(mapping);
+}
+/**
+ * The spec's paths with both ends resolved to their steps, and a message for each path that names a
+ * step no spec step has. An end names a step by its ID, compared as a UUID, or by its name, exactly
+ * as written — the match `AgentSpecSync` makes when it saves the path.
+ */
+function resolvePaths(paths, steps) {
+    const resolved = { Paths: [], Errors: [] };
+    paths.forEach((path, index) => {
+        const origin = findStep(steps, path.OriginStepID);
+        const destination = findStep(steps, path.DestinationStepID);
+        if (!origin || !destination) {
+            resolved.Errors.push(unknownEndMessage(path, !origin, !destination));
+            return;
+        }
+        resolved.Paths.push({
+            // A new path has no ID yet, and the compiler tells a fork's paths apart by ID.
+            ID: path.ID || `new-path-${index}`,
+            OriginStepID: stepRef(origin),
+            DestinationStepID: stepRef(destination),
+            Condition: path.Condition ?? null,
+            Priority: Number.isFinite(path.Priority) ? path.Priority : 0,
+            PathPoints: path.PathPoints ?? null,
+        });
+    });
+    return resolved;
+}
+/** The step a path end names, if any. */
+function findStep(steps, ref) {
+    if (!ref)
+        return undefined;
+    return steps.find((s) => !!s.ID && UUIDsEqual(s.ID, ref)) ?? steps.find((s) => s.Name === ref);
+}
+function unknownEndMessage(path, originUnknown, destinationUnknown) {
+    const ends = [originUnknown ? 'origin' : null, destinationUnknown ? 'destination' : null].filter((e) => e !== null);
+    return `❌ The path from "${path.OriginStepID}" to "${path.DestinationStepID}" names no step as its ${ends.join(' or ')}. `
+        + 'Name each end by a step\'s exact Name, or by its ID for a step that already exists.';
+}
+/** The compiler's settings: names are placeholders, and a fork is an exclusive choice, as when a Flow agent runs. */
+function compilerOptions(workflowName) {
+    const placeholderName = (id) => id;
+    return {
+        WorkflowName: workflowName?.trim() || 'Flow agent',
+        ResolveAgentName: placeholderName,
+        ResolveActionName: placeholderName,
+        ResolvePromptName: placeholderName,
+        TraversalMode: 'sequential',
+    };
+}
+function compileErrorMessage(error) {
+    return `❌ [${error.Code}] ${error.Message}`;
+}
+/**
+ * What `ValidateTaskGraphSpec` refuses in the compiled workflow. A compiled step is named by its
+ * spec step's ID where it has one, so each ID in a message becomes the step's name, as the Flow agent
+ * does when it reports these.
+ */
+function graphErrorMessages(spec) {
+    return ValidateTaskGraphSpec(spec).Errors.map((e) => `❌ [${e.Code}] ${namedBySteps(e.Message, spec)}`);
+}
+function namedBySteps(message, spec) {
+    return spec.tasks.reduce((text, task) => (task.tempId && task.name && task.tempId !== task.name ? text.split(task.tempId).join(task.name) : text), message);
+}
 //# sourceMappingURL=flow-step-validation.js.map

package/dist/flow-step-validation.js.map

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

package/dist/workflow-agent-writer.d.ts

@@ -40,8 +40,15 @@ export declare class WorkflowAgentWriter extends WorkflowAgentWriterBase {
     }): Promise<string>;
     /** Resolves the Flow agent type, so the persisted agent is a Flow rather than a Loop. */
     private resolveFlowAgentTypeID;
-    /** Name → ID for every agent, lowercased so a spec's human-entered name still resolves. */
-    private buildAgentNameIndex;
+    /**
+     * Name → ID for every agent, action and prompt, in one batch, lowercased so a spec's
+     * human-entered name still resolves.
+     *
+     * A failed load throws rather than leaving an index empty: an empty index resolves nothing, and
+     * every agent, action and prompt in the workflow would then be reported lost — or, for an action,
+     * saved pointing at nothing.
+     */
+    private buildNameIndexes;
 }
 /** Prevents tree-shaking of the registered writer. */
 export declare function LoadWorkflowAgentWriter(): void;

package/dist/workflow-agent-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-agent-writer.d.ts","sourceRoot":"","sources":["../src/workflow-agent-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAqB,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAGH,KAAK,YAAY,EACpB,MAAM,8BAA8B,CAAC;AAGtC,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D,2FAA2F;AAC3F,8BAAsB,uBAAuB;aACzB,gBAAgB,CAC5B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC;CACrB;AAED,qBACa,mBAAoB,SAAQ,uBAAuB;IAC5D;;;;;;;;OAQG;IACU,gBAAgB,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC;IAyClB,yFAAyF;YAC3E,sBAAsB;IAUpC,2FAA2F;YAC7E,mBAAmB;CASpC;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}
+{"version":3,"file":"workflow-agent-writer.d.ts","sourceRoot":"","sources":["../src/workflow-agent-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAqB,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAGH,KAAK,YAAY,EACpB,MAAM,8BAA8B,CAAC;AAGtC,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D,2FAA2F;AAC3F,8BAAsB,uBAAuB;aACzB,gBAAgB,CAC5B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC;CACrB;AAED,qBACa,mBAAoB,SAAQ,uBAAuB;IAC5D;;;;;;;;OAQG;IACU,gBAAgB,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC;IA8ClB,yFAAyF;YAC3E,sBAAsB;IAUpC;;;;;;;OAOG;YACW,gBAAgB;CAsBjC;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/workflow-agent-writer.js

@@ -40,14 +40,19 @@ let WorkflowAgentWriter = class WorkflowAgentWriter extends WorkflowAgentWriterB
      */
     async PersistFlowAgent(spec, context) {
         const flowTypeID = await this.resolveFlowAgentTypeID(context);
-        const agentIDsByName = await this.buildAgentNameIndex(context);
+        const { Agents, Actions, Prompts } = await this.buildNameIndexes(context);
+        const byName = (index, name) => index.get(name.trim().toLowerCase()) ?? null;
         let counter = 0;
         const result = ConvertTaskGraphToAgentSpec(spec.graph, {
             // Deterministic within one call, and unique because AgentSpecSync assigns real keys on
             // insert — these only have to correlate steps to paths inside this payload.
             AgentID: `workflow-${Date.now()}-${counter}`,
             NextID: () => `wf-node-${++counter}`,
-            ResolveAgentID: (name) => agentIDsByName.get(name.trim().toLowerCase()) ?? null,
+            ResolveAgentID: (name) => byName(Agents, name),
+            // Without these, a saved Action step carries no action and a Decision step loses its
+            // named prompt: the spec addresses both by name, and a step stores the ID.
+            ResolveActionID: (name) => byName(Actions, name),
+            ResolvePromptID: (name) => byName(Prompts, name),
             FlowAgentTypeID: flowTypeID,
             Name: spec.name,
         });
@@ -80,10 +85,29 @@ let WorkflowAgentWriter = class WorkflowAgentWriter extends WorkflowAgentWriterB
             throw new Error("The 'Flow' agent type was not found — has the metadata seed been pushed?");
         return id;
     }
-    /** Name → ID for every agent, lowercased so a spec's human-entered name still resolves. */
-    async buildAgentNameIndex(context) {
-        const result = await RunView.FromMetadataProvider(context.Provider).RunView({ EntityName: 'MJ: AI Agents', Fields: ['ID', 'Name'], ResultType: 'simple' }, context.ContextUser);
-        return new Map((result.Results ?? []).map((a) => [a.Name.trim().toLowerCase(), a.ID]));
+    /**
+     * Name → ID for every agent, action and prompt, in one batch, lowercased so a spec's
+     * human-entered name still resolves.
+     *
+     * A failed load throws rather than leaving an index empty: an empty index resolves nothing, and
+     * every agent, action and prompt in the workflow would then be reported lost — or, for an action,
+     * saved pointing at nothing.
+     */
+    async buildNameIndexes(context) {
+        const entityNames = ['MJ: AI Agents', 'MJ: Actions', 'MJ: AI Prompts'];
+        const results = await RunView.FromMetadataProvider(context.Provider).RunViews(entityNames.map((EntityName) => ({
+            EntityName,
+            Fields: ['ID', 'Name'],
+            ResultType: 'simple',
+        })), context.ContextUser);
+        const failed = entityNames.filter((_, i) => !results[i]?.Success);
+        if (failed.length > 0) {
+            const reasons = failed.map((name) => `${name}: ${results[entityNames.indexOf(name)]?.ErrorMessage || 'no result'}`);
+            throw new Error(`Could not load the names a workflow's steps refer to (${reasons.join('; ')}).`);
+        }
+        const [agents, actions, prompts] = results;
+        const index = (rows) => new Map(rows.map((r) => [r.Name.trim().toLowerCase(), r.ID]));
+        return { Agents: index(agents.Results), Actions: index(actions.Results), Prompts: index(prompts.Results) };
     }
 };
 WorkflowAgentWriter = __decorate([

package/dist/workflow-agent-writer.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-agent-manager",
   "type": "module",
-  "version": "6.2.0-edge.1",
+  "version": "6.2.0-edge.3",
   "description": "Core interfaces and types for the MemberJunction Agent Manager system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,14 +14,14 @@
   "author": "MemberJunction",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/ai-agents": "6.2.0-edge.1",
-    "@memberjunction/ai-core-plus": "6.2.0-edge.1",
-    "@memberjunction/ai-engine-base": "6.2.0-edge.1",
-    "@memberjunction/aiengine": "6.2.0-edge.1",
-    "@memberjunction/core": "6.2.0-edge.1",
-    "@memberjunction/core-entities": "6.2.0-edge.1",
-    "@memberjunction/global": "6.2.0-edge.1",
-    "@memberjunction/templates": "6.2.0-edge.1"
+    "@memberjunction/ai-agents": "6.2.0-edge.3",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.3",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.3",
+    "@memberjunction/aiengine": "6.2.0-edge.3",
+    "@memberjunction/core": "6.2.0-edge.3",
+    "@memberjunction/core-entities": "6.2.0-edge.3",
+    "@memberjunction/global": "6.2.0-edge.3",
+    "@memberjunction/templates": "6.2.0-edge.3"
   },
   "devDependencies": {
     "@types/node": "^24.10.11",

package/src/__tests__/agent-spec-sync-decision-roundtrip.test.ts

@@ -0,0 +1,218 @@
+/**
+ * Round-trip coverage for Decision steps in AgentSpecSync.
+ *
+ * Verifies that a Decision step's PromptID (whether custom or omitted) and Configuration
+ * (whether supplied as JSON string or parsed object) survive save and load round trips.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+const { capturedStepEntities, mockGetEntityObject, mockRunView, mockRunViews } = vi.hoisted(() => {
+    const capturedStepEntities: Record<string, unknown>[] = [];
+
+    const makeEntity = (entityName: string) => {
+        const entity: Record<string, unknown> = {
+            Load: vi.fn().mockResolvedValue(true),
+            Save: vi.fn().mockResolvedValue(true),
+            Delete: vi.fn().mockResolvedValue(true),
+            NewRecord: vi.fn(),
+            Validate: vi.fn().mockReturnValue({ Success: true, Errors: [] }),
+            ID: 'saved-id-1',
+            Name: 'Test Agent',
+            TypeID: '4F6A189B-C068-4736-9F23-3FF540B40FDD',
+            Status: 'Active',
+            StartingPayloadValidationMode: 'Fail',
+        };
+
+        if (entityName === 'MJ: AI Agent Steps') {
+            capturedStepEntities.push(entity);
+        }
+
+        return entity;
+    };
+
+    const empty = { Success: true, Results: [], RowCount: 0 };
+    return {
+        capturedStepEntities,
+        mockGetEntityObject: vi.fn((name: string) => Promise.resolve(makeEntity(name))),
+        mockRunView: vi.fn(() => Promise.resolve(empty)),
+        mockRunViews: vi.fn(() => Promise.resolve([empty, empty, empty, empty, empty])),
+    };
+});
+
+vi.mock('@memberjunction/core', () => {
+    const rvInstance = { RunView: mockRunView, RunViews: mockRunViews };
+    return {
+        Metadata: Object.assign(
+            vi.fn().mockImplementation(() => ({ GetEntityObject: mockGetEntityObject })),
+            { Provider: { GetEntityObject: mockGetEntityObject } }
+        ),
+        RunView: Object.assign(
+            vi.fn().mockImplementation(() => rvInstance),
+            { FromMetadataProvider: vi.fn(() => rvInstance) }
+        ),
+        UserInfo: vi.fn(),
+        LogError: vi.fn(),
+    };
+});
+
+vi.mock('@memberjunction/core-entities', () => ({
+    MJAIAgentEntity: vi.fn(),
+    MJAIAgentActionEntity: vi.fn(),
+    MJAIAgentRelationshipEntity: vi.fn(),
+    MJAIAgentStepEntity: vi.fn(),
+    MJAIAgentStepPathEntity: vi.fn(),
+}));
+
+vi.mock('@memberjunction/ai-core-plus', () => ({
+    AgentSpec: vi.fn(),
+    AgentActionSpec: vi.fn(),
+    SubAgentSpec: vi.fn(),
+}));
+
+import { UserInfo } from '@memberjunction/core';
+import { AgentSpecSync } from '../agent-spec-sync';
+
+describe('AgentSpecSync Decision step round-trip', () => {
+    // UserInfo is mocked above, so this is the mock's instance.
+    const mockUser = new UserInfo();
+
+    beforeEach(() => {
+        vi.clearAllMocks();
+        capturedStepEntities.length = 0;
+    });
+
+    it('persists a Decision step with custom PromptID and object Configuration', async () => {
+        const decisionConfig = {
+            key: 'triage',
+            questions: {
+                category: {
+                    instructions: 'What category?',
+                    kind: 'Choice',
+                    options: [
+                        { value: 'billing', description: 'Billing' },
+                        { value: 'tech', description: 'Technical' },
+                    ],
+                },
+            },
+        };
+
+        const sync = new AgentSpecSync(
+            {
+                ID: 'agent-1',
+                Name: 'Decision Flow Agent',
+                TypeID: '4F6A189B-C068-4736-9F23-3FF540B40FDD',
+                Steps: [
+                    {
+                        ID: 'step-1',
+                        Name: 'Triage Issue',
+                        StepType: 'Decision',
+                        StartingStep: true,
+                        PromptID: 'custom-prompt-uuid-999',
+                        Configuration: decisionConfig,
+                    },
+                ],
+            },
+            mockUser
+        );
+
+        const result = await sync.SaveToDatabase();
+        expect(result.success).toBe(true);
+
+        const savedStep = capturedStepEntities.find(s => s.Name === 'Triage Issue');
+        expect(savedStep).toBeDefined();
+        expect(savedStep?.StepType).toBe('Decision');
+        expect(savedStep?.PromptID).toBe('custom-prompt-uuid-999');
+        expect(savedStep?.Configuration).toBe(JSON.stringify(decisionConfig));
+    });
+
+    it('persists a Decision step with null PromptID when none is provided', async () => {
+        const sync = new AgentSpecSync(
+            {
+                ID: 'agent-2',
+                Name: 'Decision Agent Without Prompt',
+                TypeID: '4F6A189B-C068-4736-9F23-3FF540B40FDD',
+                Steps: [
+                    {
+                        ID: 'step-2',
+                        Name: 'Default Decision Step',
+                        StepType: 'Decision',
+                        StartingStep: true,
+                        Configuration: JSON.stringify({ key: 'route', questions: {} }),
+                    },
+                ],
+            },
+            mockUser
+        );
+
+        const result = await sync.SaveToDatabase();
+        expect(result.success).toBe(true);
+
+        const savedStep = capturedStepEntities.find(s => s.Name === 'Default Decision Step');
+        expect(savedStep).toBeDefined();
+        expect(savedStep?.PromptID).toBeNull();
+        expect(savedStep?.Configuration).toBe(JSON.stringify({ key: 'route', questions: {} }));
+    });
+
+    it('loads a Decision step from database preserving PromptID and Configuration', async () => {
+        const decisionConfigJson = JSON.stringify({
+            key: 'triage',
+            questions: {
+                priority: {
+                    text: 'What priority?',
+                    kind: 'Rating',
+                    minRating: 1,
+                    maxRating: 5,
+                },
+            },
+        });
+
+        const mockAgentEntity = {
+            Load: vi.fn().mockResolvedValue(true),
+            ID: 'agent-3',
+            Name: 'Loaded Decision Agent',
+            TypeID: '4F6A189B-C068-4736-9F23-3FF540B40FDD',
+            Status: 'Active',
+            StartingPayloadValidationMode: 'Fail',
+        };
+
+        const mockStepEntity = {
+            ID: 'step-3',
+            AgentID: 'agent-3',
+            Name: 'Rate Priority',
+            StepType: 'Decision',
+            StartingStep: true,
+            PromptID: 'decision-prompt-777',
+            Configuration: decisionConfigJson,
+            Status: 'Active',
+        };
+
+        mockGetEntityObject.mockImplementation((name: string) => {
+            if (name === 'MJ: AI Agents') {
+                return Promise.resolve(mockAgentEntity);
+            }
+            return Promise.resolve({
+                Load: vi.fn().mockResolvedValue(true),
+                Save: vi.fn().mockResolvedValue(true),
+                Validate: vi.fn().mockReturnValue({ Success: true, Errors: [] }),
+            });
+        });
+
+        // Set up RunViews return: [actions, childAgents, relatedAgents, prompts, steps]
+        const empty = { Success: true, Results: [], RowCount: 0 };
+        const stepsResult = { Success: true, Results: [mockStepEntity], RowCount: 1 };
+        mockRunViews.mockResolvedValueOnce([empty, empty, empty, empty, stepsResult]);
+        // mockRunView for paths
+        mockRunView.mockResolvedValueOnce(empty);
+
+        const loadedSync = await AgentSpecSync.LoadFromDatabase('agent-3', mockUser);
+
+        expect(loadedSync.Spec.Steps).toBeDefined();
+        expect(loadedSync.Spec.Steps).toHaveLength(1);
+
+        const loadedStep = loadedSync.Spec.Steps![0];
+        expect(loadedStep.Name).toBe('Rate Priority');
+        expect(loadedStep.StepType).toBe('Decision');
+        expect(loadedStep.PromptID).toBe('decision-prompt-777');
+        expect(loadedStep.Configuration).toBe(decisionConfigJson);
+    });
+});