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

package/dist/agents/MarketingPodcastIngestionAgent.js

@@ -0,0 +1,33 @@
+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 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.
+ */
+let MarketingPodcastIngestionAgent = class MarketingPodcastIngestionAgent extends BaseMarketingAgent {
+};
+MarketingPodcastIngestionAgent = __decorate([
+    RegisterClass(BaseAgent, 'MarketingPodcastIngestionAgent')
+], MarketingPodcastIngestionAgent);
+export { MarketingPodcastIngestionAgent };
+export function LoadMarketingPodcastIngestionAgent() { }
+//# sourceMappingURL=MarketingPodcastIngestionAgent.js.map

package/dist/agents/MarketingPodcastIngestionAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingPodcastIngestionAgent.js","sourceRoot":"","sources":["../../src/agents/MarketingPodcastIngestionAgent.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;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,8BAA8B,GAApC,MAAM,8BAA+B,SAAQ,kBAAkB;CACrE,CAAA;AADY,8BAA8B;IAD1C,aAAa,CAAC,SAAS,EAAE,gCAAgC,CAAC;GAC9C,8BAA8B,CAC1C;;AAED,MAAM,UAAU,kCAAkC,KAAI,CAAC"}

package/dist/agents/MarketingStrategyOnboardingAgent.d.ts

@@ -0,0 +1,206 @@
+import { AIPromptParams, AgentConfiguration, ExecuteAgentParams, BaseAgentNextStep, MJAIAgentRunEntityExtended, MJAIAgentRunStepEntityExtended } from "@memberjunction/ai-core-plus";
+import { BaseMarketingAgent } from './BaseMarketingAgent.js';
+export declare class MarketingStrategyOnboardingAgent extends BaseMarketingAgent {
+    protected initializeStartingPayload<P = unknown>(params: ExecuteAgentParams<unknown, P>): Promise<void>;
+    protected preparePromptParams<P>(config: AgentConfiguration, payload: P, params: ExecuteAgentParams): Promise<AIPromptParams>;
+    /**
+     * Deterministic brand resolution for multi-brand users. The base ladder
+     * sets `authorizedBrands` (instead of `brandId`) when the user is
+     * authorized for several brands, and the prompt can't be trusted to write
+     * `brandId` back — so when the founder has NAMED one of those brands
+     * anywhere in the conversation, the shell resolves it itself.
+     * Longest-name match wins ("Acme Health" beats "Acme").
+     *
+     * Brand names are only unique WITHIN a company, so a tie between two
+     * equally-long matched names is broken by the parent company name also
+     * appearing in the conversation. Still ambiguous ⇒ resolve nothing and
+     * let the agent ask; guessing here would write a strategy onto the wrong
+     * tenant's brand.
+     */
+    /** Is this brand one the caller actually holds a grant for? */
+    private isAuthorizedBrand;
+    private resolveBrandFromConversation;
+    /**
+     * The founder's own words ARE the interview evidence. Reading them here
+     * (rather than asking the model to copy them into the payload and yield)
+     * removes the round-trip that made the loop possible: by the time the
+     * prompt runs, synthesis has already happened and the model's only job is
+     * to talk to the founder.
+     *
+     * Turns already folded into the running objective are skipped, so a
+     * re-render of the same turn can't double-count them.
+     */
+    private deriveInterviewEvidence;
+    /**
+     * Enforce the interview contract in CODE, not in the prompt.
+     *
+     * Skip's drivers validate the model's proposed next step and correct it
+     * (SkipRequirementsExpertAgent.validateChatNextStep demotes Chat->Success in
+     * update mode). A prompt rule is advice the model may ignore; this is the
+     * layer where an invariant actually holds.
+     *
+     * Two invariants:
+     *  - In Grill, a reply MUST carry the batched questions. Observed live: the
+     *    model narrated the synthesis and said "I'll start with Customer
+     *    Journey" with no form attached, burning the founder's turn.
+     *  - In AwaitingBrand, a reply MUST offer the brand choices, or the founder
+     *    is asked a question with no way to answer it that the shell can read.
+     *
+     * A corrective Retry carries an errorMessage, so it counts against the
+     * framework's consecutive-unproductive-retry cap (10) and cannot loop.
+     */
+    /**
+     * P2 — terminate on Complete.
+     *
+     * `Chat` always terminates the TURN, but the run only *succeeds* on a
+     * Success step, and `FinalPayloadValidation` is evaluated nowhere else. An
+     * interview that can never emit Success can never be validated and never
+     * signals completion to a caller.
+     */
+    protected validateChatNextStep<P>(params: ExecuteAgentParams, nextStep: BaseAgentNextStep<P>, currentPayload: P, agentRun: MJAIAgentRunEntityExtended, currentStep: MJAIAgentRunStepEntityExtended): Promise<BaseAgentNextStep<P>>;
+    /** Grill/AwaitingBrand replies must carry the form that makes them answerable. */
+    private enforceInterviewContract;
+    /**
+     * P3 — ban the bare model Retry in CODE, not in prose.
+     *
+     * The framework's unproductive-retry cap only counts retries that carry an
+     * errorMessage (base-agent: `step==='Retry' && !terminate && !!errorMessage`).
+     * A model that emits a naked Retry is therefore exempt — that exemption is
+     * what let the 2026-08-05/06 loops run until the heap died. The prompt now
+     * forbids Retry, but a prompt is advice; this is the enforcement.
+     *
+     * Framework-generated retries are legitimate and must pass through: action
+     * results, artifact tools, context recovery and FinalPayloadValidation all
+     * carry retryInstructions or an errorMessage.
+     */
+    protected validateRetryNextStep<P>(params: ExecuteAgentParams, nextStep: BaseAgentNextStep<P>, currentPayload: P, agentRun: MJAIAgentRunEntityExtended, currentStep: MJAIAgentRunStepEntityExtended): Promise<BaseAgentNextStep<P>>;
+    /**
+     * P1 — read the founder's ACTUAL answer to the approval form.
+     *
+     * A depth-0 Chat step with a responseForm creates an `MJ: AI Agent Requests`
+     * row carrying the form schema; the founder's reply lands in `Response`.
+     * Reading it is the deterministic equivalent of Skip's
+     * IntentDetector.checkFormResponseForApproval, which parses the form token
+     * and lets an explicit choice BLOCK any LLM re-interpretation. Until now
+     * nothing in this app read that answer at all — the approve/revise buttons
+     * were decoration.
+     */
+    private readPriorFormAnswer;
+    /**
+     * Read the founder's form answer from where Explorer ACTUALLY delivers it.
+     *
+     * A responseForm click does not fill `MJ: AI Agent Requests`.`Response`
+     * (verified live: every row stays `Requested`/NULL). It arrives as a USER
+     * conversation message whose body is `@`-prefixed JSON:
+     *
+     *   @{"_mode":"form","action":"formSubmit","fields":[
+     *       {"name":"action","value":"approved",...},
+     *       {"name":"feedback","value":null,...}]}
+     *
+     * Note the outer `action` is the transport verb ("formSubmit") — the
+     * founder's answer lives in `fields[]`. This flattens those into the
+     * {action, feedback, ...} record the approval flow reads. The most recent
+     * form answer wins; founder chit-chat after it does not cancel it (the
+     * materialized-once guard makes a re-applied approve a no-op).
+     */
+    private readFormAnswerFromConversation;
+    /** Fallback only: scan the in-memory transcript (known to be display-text in Explorer). */
+    private readFormAnswerFromTranscript;
+    /** Parse one message as an Explorer formSubmit; null if it isn't one. */
+    private parseFormSubmitMessage;
+    /**
+     * P1 — finalize intent, derived fresh EVERY turn and never latched.
+     *
+     * The previous one-way flag meant a single false positive disabled grilling
+     * and the messaging gate permanently. Skip's rules, ported: a long message
+     * is almost always a change request, and "approval + but…" is a change
+     * request, so negations and hedges near the trigger disqualify it.
+     */
+    private founderAskedToFinalize;
+    /**
+     * P15 — keep the giant blobs out of the step log.
+     *
+     * MJ serializes the payload into PayloadAtStart/PayloadAtEnd on EVERY step.
+     * Ours carries whole scraped pages in `rawSources[].text`, the accumulated
+     * founder transcript, and the fully rendered strategy markdown — so a long
+     * interview writes megabytes of duplicated text per turn. Skip does the
+     * same projection on its two heaviest agents (base-skip-agent
+     * shouldSummarizePayload / summarizePayload).
+     *
+     * This affects LOGGING ONLY. The live payload is untouched.
+     */
+    protected serializePayloadAtStart(payload: unknown): string | null;
+    protected serializePayloadAtEnd(payload: unknown): string | null;
+    private summarizeForLog;
+    /** Mark derived turns consumed — only after a synthesis has ingested them. */
+    private commitConsumedTurns;
+    /**
+     * Deterministic finalize-intent detection on the LATEST founder message
+     * only (not history — an early "we'll finalize later" must not trigger).
+     * The LLM-set payload flag is the primary channel; this catches the
+     * explicit phrasings even when the LLM fails to set it.
+     */
+    private latestUserMessageRequestsFinalize;
+    /** The deterministic onboarding shell. Fail-open: an error here logs and lets the turn proceed undirected. */
+    private runOnboardingShell;
+    /**
+     * Button-group labels for the AwaitingBrand phase. Two brands of DIFFERENT
+     * companies can share a name, so a repeated name is qualified with its
+     * company — otherwise the founder is asked to choose between two identical
+     * buttons.
+     */
+    private brandChoiceLabels;
+    /**
+     * Publish the turn's STATE — never a command.
+     *
+     * Skip's agents don't take injected imperatives: their prompts branch on
+     * payload the model can see and verify (`{% if _CURRENT_PAYLOAD.changeRequest %}`),
+     * and `preparePromptParams` only ever adds evidence. A directive is a
+     * second control channel with no defined behavior when it's absent — which
+     * is exactly how a turn with no directive fell through to "gather and
+     * Retry" and looped. State always has a branch.
+     */
+    /**
+     * M2.3 — turn the founder's approval into published state.
+     *
+     * Runs in the shell, never as an LLM tool choice: approval is a boundary
+     * the model may narrate but must not decide. This calls the
+     * materialization SERVICE directly rather than the `Materialize Strategy
+     * Version` action — an action invoking another action is the documented
+     * anti-pattern, and that action is only the founder/UI/tasks-flow entry
+     * point onto this same call.
+     *
+     * Every outcome lands on the payload so the prompt can branch on what
+     * actually happened rather than on what it hoped happened.
+     */
+    private materializeApprovedStrategy;
+    /**
+     * Complete the founder's approval Task after a successful publish.
+     *
+     * Best-effort by design: the strategy IS Active by the time this runs, so
+     * a stuck task must never turn a successful publish into a reported
+     * failure. It surfaces on its own payload key instead.
+     */
+    private closeApprovalTask;
+    /**
+     * Resolve the newest artifact version emitted in this conversation — the
+     * snapshot the founder actually approved, and the row whose id gets
+     * stamped as ApprovedArtifactVersionID.
+     *
+     * Two hops, because the framework links artifacts through
+     * ConversationDetailArtifact and neither that entity nor
+     * `MJ: Artifact Versions` denormalizes ConversationID.
+     */
+    private resolveApprovedArtifactVersionId;
+    private publishState;
+    /**
+     * Maintain payload.spec — the MarketingStrategySpec working draft that
+     * artifact versions serialize (Rev 5 §2.7.1). Slots merge from synthesis
+     * results (fields + narrative + derived confidence); sources accumulate
+     * from consumed evidence; displayMarkdown re-renders via the one shared
+     * renderer so the artifact viewer's extract rule never re-derives it.
+     */
+    private mergeSpec;
+}
+export declare function LoadMarketingStrategyOnboardingAgent(): void;
+//# sourceMappingURL=MarketingStrategyOnboardingAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarketingStrategyOnboardingAgent.d.ts","sourceRoot":"","sources":["../../src/agents/MarketingStrategyOnboardingAgent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAErL,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAsF7D,qBACa,gCAAiC,SAAQ,kBAAkB;cAC3C,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;cAc7F,mBAAmB,CAAC,CAAC,EAC1C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAO1B;;;;;;;;;;;;;OAaG;IACH,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,4BAA4B;IAiDpC;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;;;;;;;;;;;;;;;;OAiBG;IAEH;;;;;;;OAOG;cACsB,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;IAYhC,kFAAkF;YACpE,wBAAwB;IAoDtC;;;;;;;;;;;;OAYG;cACsB,qBAAqB,CAAC,CAAC,EAC5C,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;IAiBhC;;;;;;;;;;OAUG;YACW,mBAAmB;IAqBjC;;;;;;;;;;;;;;;;OAgBG;YACW,8BAA8B;IAuC5C,2FAA2F;IAC3F,OAAO,CAAC,4BAA4B;IAapC,yEAAyE;IACzE,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;;;;;;;;;;OAWG;cACgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;cAIxD,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIzE,OAAO,CAAC,eAAe;IA0BvB,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;IAQ3B;;;;;OAKG;IACH,OAAO,CAAC,iCAAiC;IASzC,8GAA8G;YAChG,kBAAkB;IAmYhC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;;;OASG;IACH;;;;;;;;;;;;OAYG;YACW,2BAA2B;IAmFzC;;;;;;OAMG;YACW,iBAAiB;IAuB/B;;;;;;;;OAQG;YACW,gCAAgC;IA2C9C,OAAO,CAAC,YAAY;IAmDpB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;CA0DpB;AAsCD,wBAAgB,oCAAoC,SAAK"}