@memberjunction/record-set-processor 0.0.1 → 5.43.0

package/dist/processors/AgentRecordProcessor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Processor that runs an Agent (top-level, ExposeAsAction) over each record. The
+ * record is mapped into the agent's `data` via the generic value-mapping resolver (`InputMapping`),
+ * and the agent's structured output payload becomes the record result; the AI Agent Run is captured
+ * for tracing.
+ * @module @memberjunction/record-set-processor
+ */
+import { IRecordProcessor, RecordProcessorContext, RecordRef, RecordResult } from '@memberjunction/record-set-processor-base';
+/** Runs an Agent for each record, mapping the record into the agent's input data. */
+export declare class AgentRecordProcessor implements IRecordProcessor {
+    private readonly agentID;
+    private readonly inputMapping?;
+    /**
+     * @param agentID - ID of the Agent to run (must be top-level + `ExposeAsAction`).
+     * @param inputMapping - Optional mapping config resolved against `{ record, recordId, entityId }`
+     *   to build the agent's `data`. When omitted, the whole record is passed as `data`.
+     */
+    constructor(agentID: string, inputMapping?: unknown);
+    /** Builds the agent `data` payload from the record + optional input mapping. */
+    static buildData(inputMapping: unknown, record: RecordRef): Record<string, unknown>;
+    ProcessRecord(record: RecordRef, context: RecordProcessorContext): Promise<RecordResult>;
+}
+//# sourceMappingURL=AgentRecordProcessor.d.ts.map

package/dist/processors/AgentRecordProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRecordProcessor.d.ts","sourceRoot":"","sources":["../../src/processors/AgentRecordProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACH,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,YAAY,EACf,MAAM,2CAA2C,CAAC;AAEnD,qFAAqF;AACrF,qBAAa,oBAAqB,YAAW,gBAAgB;IAM7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAL5E;;;;OAIG;gBAC0B,OAAO,EAAE,MAAM,EAAmB,YAAY,CAAC,EAAE,OAAO;IAErF,gFAAgF;WAClE,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ7E,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;CAsBxG"}

package/dist/processors/AgentRecordProcessor.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Processor that runs an Agent (top-level, ExposeAsAction) over each record. The
+ * record is mapped into the agent's `data` via the generic value-mapping resolver (`InputMapping`),
+ * and the agent's structured output payload becomes the record result; the AI Agent Run is captured
+ * for tracing.
+ * @module @memberjunction/record-set-processor
+ */
+import { UUIDsEqual, resolveValueMapping } from '@memberjunction/global';
+import { AIEngine } from '@memberjunction/aiengine';
+import { AgentRunner } from '@memberjunction/ai-agents';
+/** Runs an Agent for each record, mapping the record into the agent's input data. */
+export class AgentRecordProcessor {
+    /**
+     * @param agentID - ID of the Agent to run (must be top-level + `ExposeAsAction`).
+     * @param inputMapping - Optional mapping config resolved against `{ record, recordId, entityId }`
+     *   to build the agent's `data`. When omitted, the whole record is passed as `data`.
+     */
+    constructor(agentID, inputMapping) {
+        this.agentID = agentID;
+        this.inputMapping = inputMapping;
+    }
+    /** Builds the agent `data` payload from the record + optional input mapping. */
+    static buildData(inputMapping, record) {
+        if (!inputMapping) {
+            return { record: record.Record ?? {}, recordId: record.RecordID, entityId: record.EntityID };
+        }
+        const sources = { record: record.Record ?? {}, recordId: record.RecordID, entityId: record.EntityID };
+        return resolveValueMapping(inputMapping, sources);
+    }
+    async ProcessRecord(record, context) {
+        await AIEngine.Instance.Config(false, context.contextUser);
+        const agent = AIEngine.Instance.Agents.find((a) => UUIDsEqual(a.ID, this.agentID));
+        if (!agent) {
+            return { Status: 'Failed', ErrorMessage: `Agent '${this.agentID}' not found` };
+        }
+        const runner = new AgentRunner();
+        const result = await runner.RunAgent({
+            agent,
+            conversationMessages: [],
+            contextUser: context.contextUser,
+            data: AgentRecordProcessor.buildData(this.inputMapping, record),
+        });
+        return {
+            Status: result.success ? 'Succeeded' : 'Failed',
+            ResultPayload: result.payload,
+            ErrorMessage: result.success ? undefined : (result.agentRun?.ErrorMessage ?? 'Agent failed'),
+            AIAgentRunID: result.agentRun?.ID,
+        };
+    }
+}
+//# sourceMappingURL=AgentRecordProcessor.js.map

package/dist/processors/AgentRecordProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRecordProcessor.js","sourceRoot":"","sources":["../../src/processors/AgentRecordProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQxD,qFAAqF;AACrF,MAAM,OAAO,oBAAoB;IAC7B;;;;OAIG;IACH,YAA6B,OAAe,EAAmB,YAAsB;QAAxD,YAAO,GAAP,OAAO,CAAQ;QAAmB,iBAAY,GAAZ,YAAY,CAAU;IAAG,CAAC;IAEzF,gFAAgF;IACzE,MAAM,CAAC,SAAS,CAAC,YAAqB,EAAE,MAAiB;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjG,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtG,OAAO,mBAAmB,CAA0B,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,MAAiB,EAAE,OAA+B;QACzE,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,IAAI,CAAC,OAAO,aAAa,EAAE,CAAC;QACnF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACjC,KAAK;YACL,oBAAoB,EAAE,EAAE;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;SAClE,CAAC,CAAC;QAEH,OAAO;YACH,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;YAC/C,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,IAAI,cAAc,CAAC;YAC5F,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE;SACpC,CAAC;IACN,CAAC;CACJ"}

package/dist/processors/FieldRulesProcessor.d.ts

@@ -0,0 +1,44 @@
+import { type FieldChange, type FieldRuleSet } from '@memberjunction/global';
+import { type IRecordProcessor, type RecordProcessorContext, type RecordRef, type RecordResult } from '@memberjunction/record-set-processor-base';
+/** Options for a {@link FieldRulesProcessor}. */
+export interface FieldRulesProcessorOptions {
+    /** The rules to apply to each record. */
+    RuleSet: FieldRuleSet;
+    /** When true, COMPUTE the changes but do NOT save — each result payload carries the per-field diff. */
+    DryRun?: boolean;
+}
+/** The structured payload recorded on each Process Run Detail (the per-record diff). */
+export interface FieldRulesResultPayload {
+    DryRun: boolean;
+    Changes: FieldChange[];
+    ChangedFields: string[];
+}
+/**
+ * Applies field rules to a single record via {@link EntityFieldRules}. Single-primary-key entities only
+ * (composite keys return a clear Failed result). On a real run the record is persisted via
+ * `BaseEntity.Save()`, so MJ's built-in Record Changes versioning captures the before/after automatically.
+ */
+export declare class FieldRulesProcessor implements IRecordProcessor {
+    private readonly options;
+    constructor(options: FieldRulesProcessorOptions);
+    ProcessRecord(record: RecordRef, context: RecordProcessorContext): Promise<RecordResult>;
+    /** Maps the entity-level apply result onto the record-level outcome. */
+    private toRecordResult;
+    /** Loads the BaseEntity for a record, or returns an error string. */
+    private loadRecord;
+    /**
+     * Supplies core's `EntityFieldRules` with a real `AIPromptRunner`-backed resolver for `prompt` rule
+     * sources (core can't depend on the AI stack itself). Each prompt source runs the named prompt with
+     * the record (or its shaped data) as input; the prompt's output becomes the field value. One model
+     * call per record per prompt-rule — pair with dry-run + bounded concurrency on large sets.
+     */
+    private buildPromptResolver;
+    /**
+     * Supplies core's `EntityFieldRules` with a resolver for `entityDocument` rule sources, backed by the
+     * existing Entity Document + Template render infrastructure (core can't depend on templates itself).
+     * Renders the named Entity Document's template against the record and returns the text — typically
+     * fed into a `prompt` source's `Data` to give the LLM a curated rendering of the record.
+     */
+    private buildEntityDocumentResolver;
+}
+//# sourceMappingURL=FieldRulesProcessor.d.ts.map

package/dist/processors/FieldRulesProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldRulesProcessor.d.ts","sourceRoot":"","sources":["../../src/processors/FieldRulesProcessor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,YAAY,EAAuB,MAAM,wBAAwB,CAAC;AAO9G,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,YAAY,EACpB,MAAM,2CAA2C,CAAC;AAEnD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACvC,yCAAyC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,uGAAuG;IACvG,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAMnD,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;IAerG,wEAAwE;IACxE,OAAO,CAAC,cAAc;IAkBtB,qEAAqE;YACvD,UAAU;IAgBxB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;CAkBtC"}

package/dist/processors/FieldRulesProcessor.js

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview FieldRulesProcessor — applies a declarative {@link FieldRuleSet} to each record: the
+ * rules-based bulk-update unit of work for the Record Set Processor.
+ *
+ * It is intentionally thin: the record set + batching / concurrency / pause-resume come from the engine,
+ * and the actual rule logic (compute → metadata-validate → type-coerce → write/preview, plus the
+ * RunView-backed lookup resolver) lives in {@link EntityFieldRules} in `@memberjunction/core`. This
+ * processor just maps a {@link RecordRef} to a loaded entity and translates the apply result into a
+ * {@link RecordResult}. The transform/rule substrate beneath `EntityFieldRules` is the pure
+ * field-rules engine in `@memberjunction/global` — the same one the integration field-mapping engine uses.
+ * @module @memberjunction/record-set-processor
+ */
+import { CompositeKey, EntityFieldRules } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { AIEngine } from '@memberjunction/aiengine';
+import { AIPromptRunner } from '@memberjunction/ai-prompts';
+import { AIPromptParams } from '@memberjunction/ai-core-plus';
+import { TemplateEngineServer } from '@memberjunction/templates';
+import { RegisterFieldRulesTransforms } from '@memberjunction/field-rules-transforms';
+/**
+ * Applies field rules to a single record via {@link EntityFieldRules}. Single-primary-key entities only
+ * (composite keys return a clear Failed result). On a real run the record is persisted via
+ * `BaseEntity.Save()`, so MJ's built-in Record Changes versioning captures the before/after automatically.
+ */
+export class FieldRulesProcessor {
+    constructor(options) {
+        this.options = options;
+        // Make the extended transforms (jsonpath / xpath) available to rules. Idempotent — registers
+        // the plugins into the global transform registry the first time a processor is created.
+        RegisterFieldRulesTransforms();
+    }
+    async ProcessRecord(record, context) {
+        const started = Date.now();
+        try {
+            const obj = await this.loadRecord(record, context);
+            if (typeof obj === 'string') {
+                return { Status: 'Failed', ErrorMessage: obj, DurationMs: Date.now() - started };
+            }
+            const rules = new EntityFieldRules(context.contextUser, this.buildPromptResolver(context), this.buildEntityDocumentResolver(context));
+            const result = await rules.ApplyToEntity(obj, this.options.RuleSet, { DryRun: this.options.DryRun });
+            return this.toRecordResult(result, started);
+        }
+        catch (err) {
+            return { Status: 'Failed', ErrorMessage: err instanceof Error ? err.message : String(err), DurationMs: Date.now() - started };
+        }
+    }
+    /** Maps the entity-level apply result onto the record-level outcome. */
+    toRecordResult(result, started) {
+        const ResultPayload = { DryRun: result.DryRun, Changes: result.Changes, ChangedFields: result.AppliedFields };
+        const DurationMs = Date.now() - started;
+        if (result.Errors.length > 0) {
+            return { Status: 'Failed', ResultPayload, ErrorMessage: result.Errors.join('; '), DurationMs };
+        }
+        if (result.DryRun) {
+            return { Status: 'Succeeded', ResultPayload, DurationMs }; // preview — the diff is the deliverable
+        }
+        if (result.AppliedFields.length === 0) {
+            return { Status: 'Skipped', ResultPayload, DurationMs };
+        }
+        if (!result.Saved) {
+            return { Status: 'Failed', ResultPayload, ErrorMessage: result.SaveError ?? 'save failed', DurationMs };
+        }
+        return { Status: 'Succeeded', ResultPayload, DurationMs };
+    }
+    /** Loads the BaseEntity for a record, or returns an error string. */
+    async loadRecord(record, context) {
+        const entity = context.provider.EntityByID(record.EntityID);
+        if (!entity) {
+            return `entity '${record.EntityID}' not found in metadata`;
+        }
+        if (entity.PrimaryKeys.length !== 1) {
+            return `field-rules updates support single-primary-key entities only ('${entity.Name}')`;
+        }
+        const obj = await context.provider.GetEntityObject(entity.Name, context.contextUser);
+        const loaded = await obj.InnerLoad(CompositeKey.FromKeyValuePair(entity.FirstPrimaryKey.Name, record.RecordID));
+        if (!loaded) {
+            return `record '${record.RecordID}' of '${entity.Name}' not found`;
+        }
+        return obj;
+    }
+    /**
+     * Supplies core's `EntityFieldRules` with a real `AIPromptRunner`-backed resolver for `prompt` rule
+     * sources (core can't depend on the AI stack itself). Each prompt source runs the named prompt with
+     * the record (or its shaped data) as input; the prompt's output becomes the field value. One model
+     * call per record per prompt-rule — pair with dry-run + bounded concurrency on large sets.
+     */
+    buildPromptResolver(context) {
+        return async ({ PromptID, Data }) => {
+            await AIEngine.Instance.Config(false, context.contextUser);
+            const prompt = AIEngine.Instance.Prompts.find((p) => UUIDsEqual(p.ID, PromptID));
+            if (!prompt) {
+                throw new Error(`AI Prompt '${PromptID}' not found`);
+            }
+            const params = new AIPromptParams();
+            params.prompt = prompt;
+            params.data = Data;
+            params.contextUser = context.contextUser;
+            const result = await new AIPromptRunner().ExecutePrompt(params);
+            if (!result.success) {
+                throw new Error(result.errorMessage ?? 'AI prompt execution failed');
+            }
+            return result.result;
+        };
+    }
+    /**
+     * Supplies core's `EntityFieldRules` with a resolver for `entityDocument` rule sources, backed by the
+     * existing Entity Document + Template render infrastructure (core can't depend on templates itself).
+     * Renders the named Entity Document's template against the record and returns the text — typically
+     * fed into a `prompt` source's `Data` to give the LLM a curated rendering of the record.
+     */
+    buildEntityDocumentResolver(context) {
+        return async ({ EntityDocumentID, Record }) => {
+            if (!EntityDocumentID) {
+                throw new Error('an entityDocument source requires an EntityDocumentID');
+            }
+            // Configure the template engine first so the EntityDocument's virtual TemplateText resolves.
+            await TemplateEngineServer.Instance.Config(false, context.contextUser);
+            const doc = await context.provider.GetEntityObject('MJ: Entity Documents', context.contextUser);
+            if (!(await doc.Load(EntityDocumentID))) {
+                throw new Error(`Entity Document '${EntityDocumentID}' not found`);
+            }
+            const rendered = await TemplateEngineServer.Instance.RenderTemplateSimple(doc.TemplateText, Record);
+            if (!rendered.Success) {
+                throw new Error(rendered.Message ?? 'entity document render failed');
+            }
+            return rendered.Output ?? '';
+        };
+    }
+}
+//# sourceMappingURL=FieldRulesProcessor.js.map

package/dist/processors/FieldRulesProcessor.js.map

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

package/dist/processors/FunctionRecordProcessor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview A processor that delegates to a plain function — the simplest executor seam, useful
+ * for inline logic and tests. Action / Agent / Infer-&-Write-Back processors are added alongside
+ * their consuming features.
+ * @module @memberjunction/record-set-processor
+ */
+import { IRecordProcessor, RecordProcessorContext, RecordRef, RecordResult } from '@memberjunction/record-set-processor-base';
+/** Per-record handler function wrapped by {@link FunctionRecordProcessor}. */
+export type RecordProcessorFn = (record: RecordRef, context: RecordProcessorContext) => Promise<RecordResult> | RecordResult;
+/** An {@link IRecordProcessor} backed by a function. */
+export declare class FunctionRecordProcessor implements IRecordProcessor {
+    private readonly fn;
+    constructor(fn: RecordProcessorFn);
+    ProcessRecord(record: RecordRef, context: RecordProcessorContext): Promise<RecordResult>;
+}
+//# sourceMappingURL=FunctionRecordProcessor.d.ts.map

package/dist/processors/FunctionRecordProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionRecordProcessor.d.ts","sourceRoot":"","sources":["../../src/processors/FunctionRecordProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,YAAY,EACf,MAAM,2CAA2C,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE7H,wDAAwD;AACxD,qBAAa,uBAAwB,YAAW,gBAAgB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,iBAAiB;IAErC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;CAGxG"}

package/dist/processors/FunctionRecordProcessor.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview A processor that delegates to a plain function — the simplest executor seam, useful
+ * for inline logic and tests. Action / Agent / Infer-&-Write-Back processors are added alongside
+ * their consuming features.
+ * @module @memberjunction/record-set-processor
+ */
+/** An {@link IRecordProcessor} backed by a function. */
+export class FunctionRecordProcessor {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    async ProcessRecord(record, context) {
+        return this.fn(record, context);
+    }
+}
+//# sourceMappingURL=FunctionRecordProcessor.js.map

package/dist/processors/FunctionRecordProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionRecordProcessor.js","sourceRoot":"","sources":["../../src/processors/FunctionRecordProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,wDAAwD;AACxD,MAAM,OAAO,uBAAuB;IAChC,YAA6B,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAE/C,KAAK,CAAC,aAAa,CAAC,MAAiB,EAAE,OAA+B;QACzE,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;CACJ"}

package/dist/processors/InferProcessor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Infer processor — for each record, runs an AI Prompt over the record's data and
+ * returns the structured result as the record's `ResultPayload`. Write-back is NOT done here: the
+ * `WriteBackProcessor` wrapper (added by `RecordProcessExecutor` when an OutputMapping is set)
+ * applies the Record Process's OutputMapping uniformly across Action / Agent / Infer work types.
+ * @module @memberjunction/record-set-processor
+ */
+import { IRecordProcessor, RecordProcessorContext, RecordRef, RecordResult } from '@memberjunction/record-set-processor-base';
+/** Runs an AI Prompt per record and returns its structured output (write-back is the wrapper's job). */
+export declare class InferProcessor implements IRecordProcessor {
+    private readonly promptID;
+    private readonly inputMapping?;
+    /**
+     * @param promptID - The `MJ: AI Prompts` ID to run for each record.
+     * @param inputMapping - Optional mapping shaping the data passed to the prompt (default: `{ record }`).
+     */
+    constructor(promptID: string, inputMapping?: Record<string, string>);
+    ProcessRecord(record: RecordRef, context: RecordProcessorContext): Promise<RecordResult>;
+    /** Builds the data object passed to the prompt — the record's fields under `record`, optionally remapped. */
+    private buildPromptData;
+    /** Extracts a plain field map from the record (BaseEntity → GetAll(), plain object → as-is). */
+    private recordToPlain;
+}
+//# sourceMappingURL=InferProcessor.d.ts.map

package/dist/processors/InferProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferProcessor.d.ts","sourceRoot":"","sources":["../../src/processors/InferProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EACH,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,YAAY,EACf,MAAM,2CAA2C,CAAC;AAEnD,wGAAwG;AACxG,qBAAa,cAAe,YAAW,gBAAgB;IAM/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IANlC;;;OAGG;gBAEkB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAG7C,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBrG,6GAA6G;IAC7G,OAAO,CAAC,eAAe;IASvB,gGAAgG;IAChG,OAAO,CAAC,aAAa;CAUxB"}

package/dist/processors/InferProcessor.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Infer processor — for each record, runs an AI Prompt over the record's data and
+ * returns the structured result as the record's `ResultPayload`. Write-back is NOT done here: the
+ * `WriteBackProcessor` wrapper (added by `RecordProcessExecutor` when an OutputMapping is set)
+ * applies the Record Process's OutputMapping uniformly across Action / Agent / Infer work types.
+ * @module @memberjunction/record-set-processor
+ */
+import { UUIDsEqual, resolveValueMapping } from '@memberjunction/global';
+import { AIEngine } from '@memberjunction/aiengine';
+import { AIPromptRunner } from '@memberjunction/ai-prompts';
+import { AIPromptParams } from '@memberjunction/ai-core-plus';
+/** Runs an AI Prompt per record and returns its structured output (write-back is the wrapper's job). */
+export class InferProcessor {
+    /**
+     * @param promptID - The `MJ: AI Prompts` ID to run for each record.
+     * @param inputMapping - Optional mapping shaping the data passed to the prompt (default: `{ record }`).
+     */
+    constructor(promptID, inputMapping) {
+        this.promptID = promptID;
+        this.inputMapping = inputMapping;
+    }
+    async ProcessRecord(record, context) {
+        await AIEngine.Instance.Config(false, context.contextUser);
+        const prompt = AIEngine.Instance.Prompts.find((p) => UUIDsEqual(p.ID, this.promptID));
+        if (!prompt) {
+            return { Status: 'Failed', ErrorMessage: `AI Prompt '${this.promptID}' not found` };
+        }
+        const params = new AIPromptParams();
+        params.prompt = prompt;
+        params.data = this.buildPromptData(record);
+        params.contextUser = context.contextUser;
+        const result = await new AIPromptRunner().ExecutePrompt(params);
+        const aiPromptRunID = result.promptRun?.ID;
+        if (!result.success) {
+            return { Status: 'Failed', ErrorMessage: result.errorMessage ?? 'AI prompt execution failed', AIPromptRunID: aiPromptRunID };
+        }
+        return { Status: 'Succeeded', ResultPayload: result.result ?? {}, AIPromptRunID: aiPromptRunID };
+    }
+    /** Builds the data object passed to the prompt — the record's fields under `record`, optionally remapped. */
+    buildPromptData(record) {
+        const recordData = this.recordToPlain(record);
+        if (!this.inputMapping) {
+            return { record: recordData };
+        }
+        const mapped = resolveValueMapping(this.inputMapping, { record: recordData });
+        return mapped && typeof mapped === 'object' ? mapped : { record: recordData };
+    }
+    /** Extracts a plain field map from the record (BaseEntity → GetAll(), plain object → as-is). */
+    recordToPlain(record) {
+        const r = record.Record;
+        if (r && typeof r.GetAll === 'function') {
+            return r.GetAll();
+        }
+        if (r && typeof r === 'object') {
+            return r;
+        }
+        return { RecordID: record.RecordID, EntityID: record.EntityID };
+    }
+}
+//# sourceMappingURL=InferProcessor.js.map

package/dist/processors/InferProcessor.js.map

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

package/dist/processors/WriteBackProcessor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview A processor decorator that runs an inner processor (Action/Agent/Infer) and then
+ * applies the Record Process's `OutputMapping` write-back (fields / child record) using the inner
+ * result's payload. Lets any work type share the same declarative write-back.
+ * @module @memberjunction/record-set-processor
+ */
+import { IRecordProcessor, RecordProcessorContext, RecordRef, RecordResult } from '@memberjunction/record-set-processor-base';
+import { OutputMappingConfig } from '../writeBack.js';
+/** Wraps a processor and applies output-mapping write-back to each successful result. */
+export declare class WriteBackProcessor implements IRecordProcessor {
+    private readonly inner;
+    private readonly outputMapping;
+    /**
+     * @param inner - The processor that produces the work result.
+     * @param outputMapping - The `OutputMapping` config to apply to each successful result.
+     */
+    constructor(inner: IRecordProcessor, outputMapping: OutputMappingConfig);
+    ProcessRecord(record: RecordRef, context: RecordProcessorContext): Promise<RecordResult>;
+}
+//# sourceMappingURL=WriteBackProcessor.d.ts.map

package/dist/processors/WriteBackProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteBackProcessor.d.ts","sourceRoot":"","sources":["../../src/processors/WriteBackProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,YAAY,EACf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAEvE,yFAAyF;AACzF,qBAAa,kBAAmB,YAAW,gBAAgB;IAK3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAoB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJpF;;;OAGG;gBAC0B,KAAK,EAAE,gBAAgB,EAAmB,aAAa,EAAE,mBAAmB;IAE5F,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;CAoBxG"}

package/dist/processors/WriteBackProcessor.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview A processor decorator that runs an inner processor (Action/Agent/Infer) and then
+ * applies the Record Process's `OutputMapping` write-back (fields / child record) using the inner
+ * result's payload. Lets any work type share the same declarative write-back.
+ * @module @memberjunction/record-set-processor
+ */
+import { LogError } from '@memberjunction/core';
+import { applyOutputMapping } from '../writeBack.js';
+/** Wraps a processor and applies output-mapping write-back to each successful result. */
+export class WriteBackProcessor {
+    /**
+     * @param inner - The processor that produces the work result.
+     * @param outputMapping - The `OutputMapping` config to apply to each successful result.
+     */
+    constructor(inner, outputMapping) {
+        this.inner = inner;
+        this.outputMapping = outputMapping;
+    }
+    async ProcessRecord(record, context) {
+        const result = await this.inner.ProcessRecord(record, context);
+        if (result.Status !== 'Succeeded') {
+            return result;
+        }
+        try {
+            const writeBack = await applyOutputMapping({
+                outputMapping: this.outputMapping,
+                result: result.ResultPayload,
+                record,
+                contextUser: context.contextUser,
+                provider: context.provider,
+            });
+            return { ...result, ResultPayload: { output: result.ResultPayload, writeBack } };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            LogError(`WriteBackProcessor: write-back failed for record '${record.RecordID}': ${message}`);
+            return { ...result, Status: 'Failed', ErrorMessage: `Write-back failed: ${message}` };
+        }
+    }
+}
+//# sourceMappingURL=WriteBackProcessor.js.map

package/dist/processors/WriteBackProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteBackProcessor.js","sourceRoot":"","sources":["../../src/processors/WriteBackProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAOhD,OAAO,EAAuB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvE,yFAAyF;AACzF,MAAM,OAAO,kBAAkB;IAC3B;;;OAGG;IACH,YAA6B,KAAuB,EAAmB,aAAkC;QAA5E,UAAK,GAAL,KAAK,CAAkB;QAAmB,kBAAa,GAAb,aAAa,CAAqB;IAAG,CAAC;IAEtG,KAAK,CAAC,aAAa,CAAC,MAAiB,EAAE,OAA+B;QACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC;gBACvC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,MAAM,CAAC,aAAa;gBAC5B,MAAM;gBACN,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC7B,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3D,QAAQ,CAAC,qDAAqD,MAAM,CAAC,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;YAC9F,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC;QAC1F,CAAC;IACL,CAAC;CACJ"}

package/dist/trackers/GenericProcessRunTracker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview The default persistence tracker — writes `MJ: Process Runs` (the run header) and
+ * `MJ: Process Run Details` (one row per processed record), and implements the pause/cancel
+ * handshake by re-reading the run row's `CancellationRequested` flag at each checkpoint.
+ * @module @memberjunction/record-set-processor
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { IProcessRunTracker, ProcessCursor, ProcessRunMeta, ProcessRunSummary, RecordRef, RecordResult, RunCounts, RunHandle } from '@memberjunction/record-set-processor-base';
+/** The default tracker, persisting to the generic `MJ: Process Runs` / `MJ: Process Run Details` tables. */
+export declare class GenericProcessRunTracker implements IProcessRunTracker {
+    /**
+     * Fire-and-forget queue for per-record detail INSERTs. Each detail is its own entity instance (a
+     * distinct key), so detail writes run concurrently without blocking the per-record loop; `CompleteRun`
+     * flushes them before finalizing the run. (Reliable/insert-before-fire mode is a future enhancement —
+     * it needs a per-record start hook on `IProcessRunTracker`.)
+     */
+    private readonly detailQueue;
+    BeginRun(meta: ProcessRunMeta, contextUser: UserInfo, provider?: IMetadataProvider): Promise<RunHandle>;
+    RecordResult(handle: RunHandle, record: RecordRef, result: RecordResult, contextUser: UserInfo, provider?: IMetadataProvider): Promise<void>;
+    Checkpoint(handle: RunHandle, cursor: ProcessCursor, counts: RunCounts, _contextUser: UserInfo, _provider?: IMetadataProvider): Promise<boolean>;
+    CompleteRun(handle: RunHandle, summary: ProcessRunSummary, _contextUser: UserInfo, _provider?: IMetadataProvider): Promise<void>;
+    LoadResumeCursor(handle: RunHandle, _contextUser: UserInfo, _provider?: IMetadataProvider): Promise<ProcessCursor | undefined>;
+}
+//# sourceMappingURL=GenericProcessRunTracker.d.ts.map

package/dist/trackers/GenericProcessRunTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericProcessRunTracker.d.ts","sourceRoot":"","sources":["../../src/trackers/GenericProcessRunTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAuB,iBAAiB,EAAsB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5G,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACZ,MAAM,2CAA2C,CAAC;AAOnD,4GAA4G;AAC5G,qBAAa,wBAAyB,YAAW,kBAAkB;IAC/D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAE5C,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAgCvG,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5I,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BhJ,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhI,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;CAU9I"}