@mj-biz-apps/marketing-server 0.0.0 → 0.2.0

package/dist/agents/MarketingExperimentationAgent.d.ts

@@ -0,0 +1,123 @@
+import type { AgentConfiguration, AIPromptParams, ExecuteAgentParams, BaseAgentNextStep, MJAIAgentRunEntityExtended, MJAIAgentRunStepEntityExtended } from '@memberjunction/ai-core-plus';
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+/**
+ * Marketing Programs Agent — driver class.
+ *
+ * The `MJ: AI Agents` metadata row has declared `DriverClass = MarketingExperimentationAgent`
+ * since the agent was seeded, but no such class existed, so MJ's ClassFactory silently fell back
+ * to plain `BaseAgent` and none of the doctrine below was enforced. (Exactly what had happened to
+ * MarketingStrategyOnboardingAgent before its driver class was written.)
+ *
+ * PRD §4 is binding on this agent, and the division of labour follows from it:
+ *
+ *   * "Code owns numbers and dates" — the agent NEVER computes a metric, a threshold comparison,
+ *     or a decision. `findingSynthesis` composes the factual finding from measured values before
+ *     the agent is consulted.
+ *   * "No invented evidence" — the agent's only contribution to a Learning is the MECHANISM, the
+ *     causal reading that code cannot derive. It passes through `enrichFinding`, which rejects any
+ *     interpretation citing a number that is not among the measured facts, or asserting an outcome
+ *     that contradicts the recorded decision.
+ *   * "Flow-critical outcomes run in post-hooks, never as optional LLM tool calls" — the learning
+ *     write happens in `validateSuccessNextStep` below. It is not a tool the model may decline to
+ *     call, because a decision that produces no Learning is the failure mode this whole framework
+ *     exists to prevent.
+ *   * "The prompt narrates published state" — the agent may not claim a program launched or
+ *     decided. Those transitions belong to the lifecycle service, which the agent does not call.
+ */
+export declare class MarketingExperimentationAgent extends BaseMarketingAgent {
+    /**
+     * Payload key the prompt writes its causal reading into.
+     *
+     * Deliberately named for what it is. The model is asked for a mechanism WITHOUT numbers — the
+     * numbers are already in the factual sentence this gets appended to, and every number the model
+     * adds is one more thing the guard has to reject.
+     */
+    private static readonly INTERPRETATION_KEY;
+    /** Payload key naming which decided program the interpretation is about. */
+    private static readonly PROGRAM_KEY;
+    /**
+     * Injects the program knowledge base before every prompt turn.
+     *
+     * This is what makes the agent propose FROM evidence rather than from the strategy document
+     * plus its own priors. It runs on every turn, deterministically, in code — not as a tool the
+     * model may choose to call, because an agent that can decline to look at prior results will
+     * eventually propose something that was already killed.
+     *
+     * Exposed to the template as `{{ programKnowledge }}`. A load failure is logged and the turn
+     * proceeds WITHOUT the block rather than aborting: losing the history degrades proposal
+     * quality, while failing the run loses the turn entirely. The block is self-describing, so its
+     * absence cannot be mistaken by the model for "there is no history".
+     */
+    protected preparePromptParams<P>(config: AgentConfiguration, payload: P, params: ExecuteAgentParams): Promise<AIPromptParams>;
+    /**
+     * The text findings are ranked against, drawn from the conversation.
+     *
+     * The obvious candidate — the draft hypothesis — does not exist yet: this runs BEFORE the model
+     * writes anything. What does exist is the user's request, which is what the turn is about, so it
+     * is the honest relevance signal available at this point.
+     *
+     * Returns null for a short or generic request ("review the programs", "what next?"). Ranking
+     * against those would narrow the corpus on noise, and a narrowed corpus is strictly worse than
+     * the full one when the query carries no topic — the model would lose evidence and be told the
+     * remainder was "most relevant".
+     */
+    private retrievalQuery;
+    /**
+     * Post-hook: fold the agent's mechanism into the Learning the decision already recorded.
+     *
+     * Runs after a successful step, so it sees the payload the model produced. Everything it needs
+     * beyond that comes from the database, never from the model: the program's own numbers, and
+     * the Learning row the writeback wrote.
+     *
+     * Failures here are logged and swallowed. A missing mechanism leaves a Learning that is still
+     * true and still cites its numbers; aborting the agent run over it would trade a complete
+     * record for no record.
+     */
+    protected validateSuccessNextStep<P>(params: ExecuteAgentParams, nextStep: BaseAgentNextStep<P>, currentPayload: P, agentRun: MJAIAgentRunEntityExtended, currentStep: MJAIAgentRunStepEntityExtended): Promise<BaseAgentNextStep<P>>;
+    /** A turn that ends by asking the user something can still have proposed — same stamp. */
+    protected validateChatNextStep<P>(params: ExecuteAgentParams, nextStep: BaseAgentNextStep<P>, currentPayload: P, agentRun: MJAIAgentRunEntityExtended, currentStep: MJAIAgentRunStepEntityExtended): Promise<BaseAgentNextStep<P>>;
+    /**
+     * Decides, in code, whether this run may SAVE a proposal or only DRAFT one.
+     *
+     * Inside the in-app Assistant a person is reading the proposal as it is written, so the
+     * Program row is theirs to create: the run drafts (`Propose Program` with `DraftOnly=true`)
+     * and the proposal card's Approve click commits. Everywhere else — the hourly agent, sprint
+     * end, a scheduled job — nobody is watching, and a draft nobody can see would simply be lost,
+     * so those runs commit directly and queue for approval as before.
+     *
+     * The Assistant is recognised by the app context it sends (the same signal that makes the
+     * brand picker authoritative). The template reads `proposalMode`; it does not decide it.
+     */
+    protected initializeStartingPayload<P = unknown>(params: ExecuteAgentParams<unknown, P>): Promise<void>;
+    /**
+     * Stamps what THIS run proposed onto the payload, as `proposals`.
+     *
+     * The payload is what the conversation renders as the run's artifact, and the proposal card
+     * is drawn from this list. It is built from the run's own recorded `Propose Program` action
+     * results — never from the model's account of what it did ("the prompt narrates published
+     * state"):
+     *   * DRAFTED  → the full validated draft rides along, because no row exists to load. The card
+     *                renders it, and re-submits exactly these inputs when the user approves.
+     *   * SUCCESS  → a committed program; ids only, and the card loads the row live.
+     * A failed or blocked call produced no proposal and is skipped.
+     */
+    private attachProposals;
+    /** One recorded `Propose Program` result → a proposal reference, or null when it produced none. */
+    private proposalFromStep;
+    /**
+     * Applies the model's mechanism to the most recent Learning for the named program.
+     *
+     * No-ops silently when the payload carries no interpretation — the agent has other jobs
+     * (proposing), and only the decision-interpretation turn produces one.
+     */
+    private applyLearningInterpretation;
+    /**
+     * `Program.Decision` is title-case ('Keep'); the writeback rules are upper-case ('KEEP').
+     * The two columns genuinely disagree on casing, so the mapping is explicit rather than a
+     * `toUpperCase()` that would quietly produce an invalid value for anything unexpected.
+     */
+    private toDecisionOutcome;
+}
+/** Anti-tree-shaking loader — the @RegisterClass above is a side effect. */
+export declare function LoadMarketingExperimentationAgent(): void;
+//# sourceMappingURL=MarketingExperimentationAgent.d.ts.map

package/dist/agents/MarketingExperimentationAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingExperimentationAgent.d.ts","sourceRoot":"","sources":["../../src/agents/MarketingExperimentationAgent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAa1L,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAmC7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,6BAA8B,SAAQ,kBAAkB;IACjE;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;IAEtE,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA0B;IAE7D;;;;;;;;;;;;OAYG;cACsB,mBAAmB,CAAC,CAAC,EAC1C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IA6B1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;;;;;;;OAUG;cACsB,uBAAuB,CAAC,CAAC,EAC9C,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAahC,0FAA0F;cACjE,oBAAoB,CAAC,CAAC,EAC3C,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC;;;;;;;;;;;OAWG;cACsB,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtH;;;;;;;;;;;OAWG;YACW,eAAe;IAkC7B,mGAAmG;IACnG,OAAO,CAAC,gBAAgB;IA0CxB;;;;;OAKG;YACW,2BAA2B;IA0FzC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAc5B;AAED,4EAA4E;AAC5E,wBAAgB,iCAAiC,IAAI,IAAI,CAAG"}

package/dist/agents/MarketingExperimentationAgent.js

@@ -0,0 +1,371 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var MarketingExperimentationAgent_1;
+import { EscapeSQLString, RegisterClass } from '@memberjunction/global';
+import { BaseAgent } from '@memberjunction/ai-agents';
+import { LogStatus, LogError, Metadata, RunView } from '@memberjunction/core';
+import { enrichFinding, loadProgramKnowledge, renderKnowledgeBase, toMarketingEntityName, } from '@mj-biz-apps/marketing-core';
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+/** Below this, a request is too short to rank a corpus against. */
+const MIN_RETRIEVAL_QUERY_CHARS = 25;
+/**
+ * Process vocabulary that says nothing about SUBJECT. "Review the programs and propose one"
+ * is a valid instruction and a useless retrieval query — stripping these leaves nothing, which is
+ * the signal to fall back to the full corpus.
+ */
+const GENERIC_REQUEST_WORDS = /\b(review|propose|suggest|new|next|one|an?|the|and|or|for|to|of|please|what|should|we|i|you|program|programs|please|now|then|also|with|from|this|that|it|be|do|make|create|give|me|us|any|some|based|on|using|cite|codes?|numbers?)\b/g;
+/**
+ * Marketing Programs Agent — driver class.
+ *
+ * The `MJ: AI Agents` metadata row has declared `DriverClass = MarketingExperimentationAgent`
+ * since the agent was seeded, but no such class existed, so MJ's ClassFactory silently fell back
+ * to plain `BaseAgent` and none of the doctrine below was enforced. (Exactly what had happened to
+ * MarketingStrategyOnboardingAgent before its driver class was written.)
+ *
+ * PRD §4 is binding on this agent, and the division of labour follows from it:
+ *
+ *   * "Code owns numbers and dates" — the agent NEVER computes a metric, a threshold comparison,
+ *     or a decision. `findingSynthesis` composes the factual finding from measured values before
+ *     the agent is consulted.
+ *   * "No invented evidence" — the agent's only contribution to a Learning is the MECHANISM, the
+ *     causal reading that code cannot derive. It passes through `enrichFinding`, which rejects any
+ *     interpretation citing a number that is not among the measured facts, or asserting an outcome
+ *     that contradicts the recorded decision.
+ *   * "Flow-critical outcomes run in post-hooks, never as optional LLM tool calls" — the learning
+ *     write happens in `validateSuccessNextStep` below. It is not a tool the model may decline to
+ *     call, because a decision that produces no Learning is the failure mode this whole framework
+ *     exists to prevent.
+ *   * "The prompt narrates published state" — the agent may not claim a program launched or
+ *     decided. Those transitions belong to the lifecycle service, which the agent does not call.
+ */
+let MarketingExperimentationAgent = class MarketingExperimentationAgent extends BaseMarketingAgent {
+    static { MarketingExperimentationAgent_1 = this; }
+    /**
+     * Payload key the prompt writes its causal reading into.
+     *
+     * Deliberately named for what it is. The model is asked for a mechanism WITHOUT numbers — the
+     * numbers are already in the factual sentence this gets appended to, and every number the model
+     * adds is one more thing the guard has to reject.
+     */
+    static { this.INTERPRETATION_KEY = 'learningInterpretation'; }
+    /** Payload key naming which decided program the interpretation is about. */
+    static { this.PROGRAM_KEY = 'interpretedProgramId'; }
+    /**
+     * Injects the program knowledge base before every prompt turn.
+     *
+     * This is what makes the agent propose FROM evidence rather than from the strategy document
+     * plus its own priors. It runs on every turn, deterministically, in code — not as a tool the
+     * model may choose to call, because an agent that can decline to look at prior results will
+     * eventually propose something that was already killed.
+     *
+     * Exposed to the template as `{{ programKnowledge }}`. A load failure is logged and the turn
+     * proceeds WITHOUT the block rather than aborting: losing the history degrades proposal
+     * quality, while failing the run loses the turn entirely. The block is self-describing, so its
+     * absence cannot be mistaken by the model for "there is no history".
+     */
+    async preparePromptParams(config, payload, params) {
+        const result = await super.preparePromptParams(config, payload, params);
+        const bag = (payload ?? {});
+        const brandId = typeof bag['brandId'] === 'string' ? bag['brandId'] : null;
+        if (!brandId || !result.data)
+            return result;
+        try {
+            // Rank the corpus against what is actually being asked, when there is something to rank
+            // against. The draft hypothesis does not exist yet at injection time — the model has not
+            // written one — so the user's request is the best available signal for relevance, and it
+            // is what the whole turn is about.
+            const relevantTo = this.retrievalQuery(params);
+            const kb = await loadProgramKnowledge({
+                brandId,
+                contextUser: params.contextUser,
+                ...(relevantTo ? { relevantTo } : {}),
+            });
+            result.data['programKnowledge'] = renderKnowledgeBase(kb);
+            LogStatus(`MarketingExperimentationAgent: injected ${kb.learnings.length} finding(s) and `
+                + `${kb.sprints.length} sprint(s) of history (${kb.excludedStrategyFacts} strategy fact(s) excluded)`
+                + `${kb.rankedSemantically ? ` — ranked semantically against "${(relevantTo ?? '').slice(0, 60)}…"` : ' — date order'}.`);
+        }
+        catch (e) {
+            LogError('MarketingExperimentationAgent: knowledge base load failed, proceeding without it — '
+                + (e instanceof Error ? e.message : String(e)));
+        }
+        return result;
+    }
+    /**
+     * The text findings are ranked against, drawn from the conversation.
+     *
+     * The obvious candidate — the draft hypothesis — does not exist yet: this runs BEFORE the model
+     * writes anything. What does exist is the user's request, which is what the turn is about, so it
+     * is the honest relevance signal available at this point.
+     *
+     * Returns null for a short or generic request ("review the programs", "what next?"). Ranking
+     * against those would narrow the corpus on noise, and a narrowed corpus is strictly worse than
+     * the full one when the query carries no topic — the model would lose evidence and be told the
+     * remainder was "most relevant".
+     */
+    retrievalQuery(params) {
+        // The FIRST user message, not the last. The agent loop appends its own turns with
+        // role='user' — including action results — so by turn 3 the "latest user message" is the
+        // text of an action result, and ranking findings against that is arbitrary. Observed:
+        // turn 1 ranked against the real request, turn 3 against "Action results: …".
+        // The originating request is stable across the loop and is what the turn is about.
+        const messages = params.conversationMessages ?? [];
+        const firstUser = messages.find(m => m.role === 'user');
+        const text = typeof firstUser?.content === 'string' ? firstUser.content.trim() : '';
+        if (text.length < MIN_RETRIEVAL_QUERY_CHARS)
+            return null;
+        // A request made only of process words carries no topic to rank on.
+        const withoutFiller = text.toLowerCase().replace(GENERIC_REQUEST_WORDS, ' ').replace(/\s+/g, ' ').trim();
+        if (withoutFiller.length < MIN_RETRIEVAL_QUERY_CHARS)
+            return null;
+        return text;
+    }
+    /**
+     * Post-hook: fold the agent's mechanism into the Learning the decision already recorded.
+     *
+     * Runs after a successful step, so it sees the payload the model produced. Everything it needs
+     * beyond that comes from the database, never from the model: the program's own numbers, and
+     * the Learning row the writeback wrote.
+     *
+     * Failures here are logged and swallowed. A missing mechanism leaves a Learning that is still
+     * true and still cites its numbers; aborting the agent run over it would trade a complete
+     * record for no record.
+     */
+    async validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep) {
+        const baseResult = await super.validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep);
+        if (baseResult.step === 'Retry')
+            return baseResult;
+        try {
+            await this.applyLearningInterpretation(currentPayload, params.contextUser, agentRun.ID);
+        }
+        catch (e) {
+            LogError(`MarketingExperimentationAgent: learning enrichment failed — ${e instanceof Error ? e.message : String(e)}`);
+        }
+        await this.attachProposals(baseResult, currentPayload, agentRun, params.contextUser);
+        return baseResult;
+    }
+    /** A turn that ends by asking the user something can still have proposed — same stamp. */
+    async validateChatNextStep(params, nextStep, currentPayload, agentRun, currentStep) {
+        const baseResult = await super.validateChatNextStep(params, nextStep, currentPayload, agentRun, currentStep);
+        await this.attachProposals(baseResult, currentPayload, agentRun, params.contextUser);
+        return baseResult;
+    }
+    /**
+     * Decides, in code, whether this run may SAVE a proposal or only DRAFT one.
+     *
+     * Inside the in-app Assistant a person is reading the proposal as it is written, so the
+     * Program row is theirs to create: the run drafts (`Propose Program` with `DraftOnly=true`)
+     * and the proposal card's Approve click commits. Everywhere else — the hourly agent, sprint
+     * end, a scheduled job — nobody is watching, and a draft nobody can see would simply be lost,
+     * so those runs commit directly and queue for approval as before.
+     *
+     * The Assistant is recognised by the app context it sends (the same signal that makes the
+     * brand picker authoritative). The template reads `proposalMode`; it does not decide it.
+     */
+    async initializeStartingPayload(params) {
+        await super.initializeStartingPayload(params);
+        const payload = params.payload;
+        if (payload)
+            payload['proposalMode'] = this.brandFromAppContext(params) ? 'draft' : 'commit';
+    }
+    /**
+     * Stamps what THIS run proposed onto the payload, as `proposals`.
+     *
+     * The payload is what the conversation renders as the run's artifact, and the proposal card
+     * is drawn from this list. It is built from the run's own recorded `Propose Program` action
+     * results — never from the model's account of what it did ("the prompt narrates published
+     * state"):
+     *   * DRAFTED  → the full validated draft rides along, because no row exists to load. The card
+     *                renders it, and re-submits exactly these inputs when the user approves.
+     *   * SUCCESS  → a committed program; ids only, and the card loads the row live.
+     * A failed or blocked call produced no proposal and is skipped.
+     */
+    async attachProposals(nextStep, currentPayload, agentRun, contextUser) {
+        const bag = (currentPayload ?? {});
+        try {
+            const res = await new RunView().RunView({
+                EntityName: 'MJ: AI Agent Run Steps',
+                ExtraFilter: `AgentRunID='${EscapeSQLString(agentRun.ID)}' AND StepType='Actions' AND Status='Completed' AND StepName LIKE '%Propose Program%'`,
+                Fields: ['OutputData'],
+                OrderBy: 'StepNumber ASC', ResultType: 'simple', BypassCache: true,
+            }, contextUser);
+            if (!res.Success) {
+                LogError(`MarketingExperimentationAgent: could not read this run's proposal steps — ${res.ErrorMessage}`);
+                return;
+            }
+            const proposals = (res.Results ?? [])
+                .map(step => this.proposalFromStep(step.OutputData))
+                .filter((p) => p !== null);
+            if (proposals.length === 0)
+                return;
+            bag['proposals'] = proposals;
+            const next = nextStep.newPayload;
+            if (next && next !== bag)
+                next['proposals'] = proposals;
+            LogStatus(`MarketingExperimentationAgent: ${proposals.length} proposal(s) from this run attached to the payload `
+                + `(${proposals.filter(p => p.draft).length} draft).`);
+        }
+        catch (e) {
+            LogError(`MarketingExperimentationAgent: attaching proposals failed — ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /** One recorded `Propose Program` result → a proposal reference, or null when it produced none. */
+    proposalFromStep(outputData) {
+        if (!outputData)
+            return null;
+        let parsed;
+        try {
+            parsed = JSON.parse(outputData);
+        }
+        catch {
+            return null; // not JSON — not an action result this shell understands
+        }
+        const result = parsed.actionResult;
+        if (!result?.success || !Array.isArray(result.parameters))
+            return null;
+        const byType = (type) => Object.fromEntries(result.parameters.filter(p => p.Type === type && p.Value !== null && p.Value !== undefined).map(p => [p.Name, p.Value]));
+        const inputs = byType('Input');
+        const outputs = byType('Output');
+        const text = (v) => (typeof v === 'string' && v.trim() ? v : null);
+        if (result.resultCode === 'DRAFTED') {
+            const draftKey = text(outputs['DraftKey']);
+            if (!draftKey)
+                return null;
+            delete inputs['DraftOnly']; // the re-submit on Approve must COMMIT
+            return {
+                programId: null, code: null, name: text(inputs['Name']), approvalRequestId: null,
+                draft: {
+                    key: draftKey,
+                    inputs,
+                    programTier: text(outputs['ProgramTier']),
+                    programType: text(outputs['ProgramType']),
+                    proposalConfidence: text(outputs['ProposalConfidence']),
+                    requiresOverride: outputs['RequiresOverride'] === true,
+                },
+            };
+        }
+        const programId = text(outputs['ProgramID']);
+        if (!programId)
+            return null;
+        return {
+            programId, code: text(outputs['Code']), name: text(inputs['Name']),
+            approvalRequestId: text(outputs['ApprovalRequestID']), draft: null,
+        };
+    }
+    /**
+     * Applies the model's mechanism to the most recent Learning for the named program.
+     *
+     * No-ops silently when the payload carries no interpretation — the agent has other jobs
+     * (proposing), and only the decision-interpretation turn produces one.
+     */
+    async applyLearningInterpretation(payload, contextUser, agentRunId) {
+        const bag = (payload ?? {});
+        const interpretation = bag[MarketingExperimentationAgent_1.INTERPRETATION_KEY];
+        const programId = bag[MarketingExperimentationAgent_1.PROGRAM_KEY];
+        if (typeof interpretation !== 'string' || !interpretation.trim())
+            return;
+        if (typeof programId !== 'string' || !programId.trim()) {
+            LogError('MarketingExperimentationAgent: an interpretation was supplied with no '
+                + `${MarketingExperimentationAgent_1.PROGRAM_KEY} — refusing to guess which program it belongs to.`);
+            return;
+        }
+        const rv = new RunView();
+        // The program's own numbers define what the model is allowed to cite.
+        const exp = (await rv.RunView({
+            EntityName: toMarketingEntityName('Programs'),
+            ExtraFilter: `ID='${EscapeSQLString(programId)}'`,
+            Fields: ['ID', 'Code', 'Decision', 'MetricBaseline', 'KeepThreshold', 'KillThreshold', 'IterateRangeMin', 'IterateRangeMax'],
+            MaxRows: 1, ResultType: 'simple', BypassCache: true,
+        }, contextUser)).Results?.[0];
+        if (!exp) {
+            LogError(`MarketingExperimentationAgent: program ${programId} not found; interpretation dropped.`);
+            return;
+        }
+        if (!exp.Decision) {
+            LogError(`MarketingExperimentationAgent: program ${exp.Code ?? programId} has no recorded Decision. `
+                + 'An interpretation cannot precede the decision it interprets — dropped.');
+            return;
+        }
+        // The Learning the writeback already created. Read fresh: it was written moments ago.
+        const learningRow = (await rv.RunView({
+            EntityName: toMarketingEntityName('Agent Learnings'),
+            ExtraFilter: `RelatedProgramID='${EscapeSQLString(programId)}'`,
+            Fields: ['ID', 'Finding'],
+            OrderBy: '__mj_CreatedAt DESC', MaxRows: 1, ResultType: 'simple', BypassCache: true,
+        }, contextUser)).Results?.[0];
+        if (!learningRow) {
+            LogError(`MarketingExperimentationAgent: no Learning recorded for ${exp.Code ?? programId} yet; `
+                + 'nothing to enrich. The decision writeback runs first.');
+            return;
+        }
+        // Observed values live on the segment results the observation path wrote.
+        const observed = (await rv.RunView({
+            EntityName: toMarketingEntityName('Program Segment Results'),
+            ExtraFilter: `ProgramID='${EscapeSQLString(programId)}'`,
+            Fields: ['ObservedMetric', 'ConversionsCount'], ResultType: 'simple', BypassCache: true,
+        }, contextUser)).Results ?? [];
+        const allowedNumbers = [
+            exp.MetricBaseline, exp.KeepThreshold, exp.KillThreshold, exp.IterateRangeMin, exp.IterateRangeMax,
+            ...observed.flatMap(o => [o.ObservedMetric, o.ConversionsCount]),
+        ];
+        const result = enrichFinding(learningRow.Finding ?? '', interpretation, {
+            decision: this.toDecisionOutcome(exp.Decision),
+            allowedNumbers,
+        });
+        if (!result.enriched) {
+            // Not an error — the guard doing its job. Logged loudly because a repeatedly-rejected
+            // interpretation means the prompt needs fixing, not the guard.
+            LogStatus(`MarketingExperimentationAgent: interpretation REJECTED for ${exp.Code ?? programId} `
+                + `(${result.problems.join('; ')}). The factual finding stands unchanged.`);
+            return;
+        }
+        const md = new Metadata();
+        const learning = await md.GetEntityObject(toMarketingEntityName('Agent Learnings'), contextUser);
+        if (!await learning.Load(learningRow.ID)) {
+            LogError(`MarketingExperimentationAgent: could not load Learning ${learningRow.ID}.`);
+            return;
+        }
+        learning.Finding = result.finding;
+        // Source moves off 'program' only when an agent actually contributed: 'analysis' is the
+        // value list's slot for agent-derived reasoning, and it keeps agent-enriched findings
+        // distinguishable from purely mechanical ones.
+        learning.Source = 'analysis';
+        if (!await learning.Save()) {
+            LogError(`MarketingExperimentationAgent: Learning ${learningRow.ID} save failed — `
+                + `${learning.LatestResult?.CompleteMessage ?? 'unknown'}`);
+            return;
+        }
+        LogStatus(`MarketingExperimentationAgent: enriched Learning ${learningRow.ID} for ${exp.Code ?? programId} `
+            + `(agent run ${agentRunId}).`);
+    }
+    /**
+     * `Program.Decision` is title-case ('Keep'); the writeback rules are upper-case ('KEEP').
+     * The two columns genuinely disagree on casing, so the mapping is explicit rather than a
+     * `toUpperCase()` that would quietly produce an invalid value for anything unexpected.
+     */
+    toDecisionOutcome(decision) {
+        switch (decision.trim().toLowerCase()) {
+            case 'keep': return 'KEEP';
+            case 'iterate': return 'ITERATE';
+            case 'kill': return 'KILL';
+            case 'graduate': return 'GRADUATE';
+            default:
+                // Treat an unknown decision as the most restrictive: ITERATE permits no
+                // outcome claim at all, so a mismatched interpretation gets rejected.
+                LogError(`MarketingExperimentationAgent: unrecognised Decision "${decision}" — `
+                    + 'treating as ITERATE so no outcome claim is licensed.');
+                return 'ITERATE';
+        }
+    }
+};
+MarketingExperimentationAgent = MarketingExperimentationAgent_1 = __decorate([
+    RegisterClass(BaseAgent, 'MarketingExperimentationAgent')
+], MarketingExperimentationAgent);
+export { MarketingExperimentationAgent };
+/** Anti-tree-shaking loader — the @RegisterClass above is a side effect. */
+export function LoadMarketingExperimentationAgent() { }
+//# sourceMappingURL=MarketingExperimentationAgent.js.map

package/dist/agents/MarketingExperimentationAgent.js.map

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

package/dist/agents/MarketingOperationsAgent.d.ts

@@ -0,0 +1,24 @@
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+/**
+ * Marketing Operations Agent — driver class (PRD v3 S7 item 4 / readiness follow-through).
+ *
+ * The `MJ: AI Agents` row for the Operations Agent declared no DriverClass at all, so MJ's
+ * ClassFactory instantiated plain `BaseAgent` and NONE of the marketing base-class doctrine
+ * applied to the hourly loop: no brand self-resolution from the caller's grants, no payload
+ * bootstrap (`brandName`/`companyId`), no authorized-brand disambiguation. The same silent
+ * fallback had already bitten MarketingStrategyOnboardingAgent and
+ * MarketingExperimentationAgent before their driver classes were written — this closes the
+ * last gap in the set.
+ *
+ * Deliberately THIN. The Operations Agent's work is tool calls (Refresh Program Status, Close
+ * Due Sprints, Start Due Sprints, Sync Marketing Data, Get Program Context …), and every one of
+ * those actions enforces its own brand/role gate server-side — the doctrine this class needs is
+ * exactly what {@link BaseMarketingAgent} centralizes, nothing more. Numbers and dates stay
+ * owned by code inside the actions; the loop narrates and sequences. When the ops loop grows a
+ * flow-critical outcome of its own (the Experimentation agent's learning post-hook is the
+ * precedent), it gets a post-hook here — not an optional tool the model may forget.
+ */
+export declare class MarketingOperationsAgent extends BaseMarketingAgent {
+}
+export declare function LoadMarketingOperationsAgent(): void;
+//# sourceMappingURL=MarketingOperationsAgent.d.ts.map

package/dist/agents/MarketingOperationsAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingOperationsAgent.d.ts","sourceRoot":"","sources":["../../src/agents/MarketingOperationsAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,wBAAyB,SAAQ,kBAAkB;CAC/D;AAED,wBAAgB,4BAA4B,SAAK"}

package/dist/agents/MarketingOperationsAgent.js

@@ -0,0 +1,36 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseAgent } from '@memberjunction/ai-agents';
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+/**
+ * Marketing Operations Agent — driver class (PRD v3 S7 item 4 / readiness follow-through).
+ *
+ * The `MJ: AI Agents` row for the Operations Agent declared no DriverClass at all, so MJ's
+ * ClassFactory instantiated plain `BaseAgent` and NONE of the marketing base-class doctrine
+ * applied to the hourly loop: no brand self-resolution from the caller's grants, no payload
+ * bootstrap (`brandName`/`companyId`), no authorized-brand disambiguation. The same silent
+ * fallback had already bitten MarketingStrategyOnboardingAgent and
+ * MarketingExperimentationAgent before their driver classes were written — this closes the
+ * last gap in the set.
+ *
+ * Deliberately THIN. The Operations Agent's work is tool calls (Refresh Program Status, Close
+ * Due Sprints, Start Due Sprints, Sync Marketing Data, Get Program Context …), and every one of
+ * those actions enforces its own brand/role gate server-side — the doctrine this class needs is
+ * exactly what {@link BaseMarketingAgent} centralizes, nothing more. Numbers and dates stay
+ * owned by code inside the actions; the loop narrates and sequences. When the ops loop grows a
+ * flow-critical outcome of its own (the Experimentation agent's learning post-hook is the
+ * precedent), it gets a post-hook here — not an optional tool the model may forget.
+ */
+let MarketingOperationsAgent = class MarketingOperationsAgent extends BaseMarketingAgent {
+};
+MarketingOperationsAgent = __decorate([
+    RegisterClass(BaseAgent, 'MarketingOperationsAgent')
+], MarketingOperationsAgent);
+export { MarketingOperationsAgent };
+export function LoadMarketingOperationsAgent() { }
+//# sourceMappingURL=MarketingOperationsAgent.js.map

package/dist/agents/MarketingOperationsAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingOperationsAgent.js","sourceRoot":"","sources":["../../src/agents/MarketingOperationsAgent.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,kBAAkB;CAC/D,CAAA;AADY,wBAAwB;IADpC,aAAa,CAAC,SAAS,EAAE,0BAA0B,CAAC;GACxC,wBAAwB,CACpC;;AAED,MAAM,UAAU,4BAA4B,KAAI,CAAC"}

package/dist/agents/MarketingPodcastIngestionAgent.d.ts

@@ -0,0 +1,21 @@
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+/**
+ * Marketing Podcast Ingestion Agent — driver class (Content Engine PRD, Phase A row A2).
+ *
+ * The `MJ: AI Agents` row named this class but nothing defined it, so MJ's ClassFactory fell
+ * back to plain `BaseAgent` — the same silent fault that bit the Onboarding, Experimentation and
+ * Operations agents in turn: no brand self-resolution from the caller's grants or the app
+ * context, no payload bootstrap (`brandName` / `companyId`), no authorized-brand disambiguation.
+ * With Content's "Ingest now" and the per-brand Ingest-sources job about to run this agent, the
+ * brand must come from the run's context, never from a question.
+ *
+ * Deliberately THIN, like the Operations agent. The ingestion work is tool calls (Fetch Podcast
+ * From RSS, Intake Podcast From Box, Diarize Podcast Episode, Transcribe Audio …) and every one
+ * of them enforces its own brand gate server-side; the doctrine this class needs is exactly what
+ * {@link BaseMarketingAgent} centralizes. Idempotency lives in the actions and, for generation,
+ * in the pipeline's final-save check (CE-7) — not in the narration here.
+ */
+export declare class MarketingPodcastIngestionAgent extends BaseMarketingAgent {
+}
+export declare function LoadMarketingPodcastIngestionAgent(): void;
+//# sourceMappingURL=MarketingPodcastIngestionAgent.d.ts.map

package/dist/agents/MarketingPodcastIngestionAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingPodcastIngestionAgent.d.ts","sourceRoot":"","sources":["../../src/agents/MarketingPodcastIngestionAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,qBACa,8BAA+B,SAAQ,kBAAkB;CACrE;AAED,wBAAgB,kCAAkC,SAAK"}