@memberjunction/ai-agents 5.45.0 → 5.46.0

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from './agent-types/loop-agent-response-type.js';
 export * from './agent-types/loop-agent-prompt-params.js';
 export * from './base-agent.js';
 export * from './prompt-component-resolver.js';
+export * from './scoped-prompt-config-resolver.js';
 export * from './agent-run-watchdog.js';
 export * from './agent-types/index.js';
 export * from './AgentRunner.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AAKnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AAGpD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AAKnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AAGpD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -13,6 +13,7 @@ export * from './agent-types/loop-agent-response-type.js';
 export * from './agent-types/loop-agent-prompt-params.js';
 export * from './base-agent.js';
 export * from './prompt-component-resolver.js';
+export * from './scoped-prompt-config-resolver.js';
 export * from './agent-run-watchdog.js';
 export * from './agent-types/index.js';
 export * from './AgentRunner.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,4FAA4F;AAC5F,8FAA8F;AAC9F,2FAA2F;AAC3F,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAkE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AAEpD,wDAAwD;AACxD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAG1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,4FAA4F;AAC5F,8FAA8F;AAC9F,2FAA2F;AAC3F,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAkE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AAEpD,wDAAwD;AACxD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAG1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}

package/dist/scoped-prompt-config-resolver.d.ts

@@ -0,0 +1,50 @@
+import { MJScopedPromptConfigEntity } from "@memberjunction/core-entities";
+import { SecondaryScopeValue } from "@memberjunction/ai-core-plus";
+import { PromptComponentScope } from "./prompt-component-resolver.js";
+/**
+ * The subset of `AIPromptParams` fields a resolved config writes onto. Kept as a minimal
+ * structural shape (rather than importing `AIPromptParams`) so the apply step is unit-testable
+ * and free of a hard prompt-runtime dependency — `AIPromptParams` is structurally assignable to it.
+ */
+export interface ScopedPromptConfigTarget {
+    override?: {
+        modelId?: string;
+        vendorId?: string;
+    };
+    configurationId?: string;
+    effortLevel?: number;
+    additionalParameters?: Record<string, unknown>;
+}
+/**
+ * ScopedPromptConfigResolver — the run-settings sibling of {@link PromptComponentResolver}.
+ * Picks the single most-specific in-scope `MJ: Scoped Prompt Configs` row for a prompt (whole-row
+ * wins: SecondaryScopes match (+4) > PrimaryScopeRecord (+2) > global (+1), tie-broken by
+ * `Priority`), then overlays its non-null columns onto the prompt run's params.
+ *
+ * **Pluggable (ClassFactory).** Obtained via
+ * `MJGlobal.Instance.ClassFactory.CreateInstance(ScopedPromptConfigResolver)` — base by default, or
+ * a `@RegisterClass(ScopedPromptConfigResolver)` subclass. Protected hooks
+ * ({@link getCandidates}, {@link isInScope}, {@link score}) are the override points, mirroring
+ * the parts resolver.
+ */
+export declare class ScopedPromptConfigResolver {
+    /** Resolve the single winning config for `promptID` under `scope`, or null if none in scope. */
+    Resolve(promptID: string, scope: PromptComponentScope): MJScopedPromptConfigEntity | null;
+    /** Candidate configs for a prompt: same PromptID + resolvable Status. */
+    protected getCandidates(promptID: string): MJScopedPromptConfigEntity[];
+    /** Is this config compatible with the run scope? (cascading: it may only require dims the run has) */
+    protected isInScope(c: MJScopedPromptConfigEntity, scope: PromptComponentScope): boolean;
+    /** Specificity score: SecondaryScopes match (+4) > PrimaryScopeRecord (+2) > Global (+1). */
+    protected score(c: MJScopedPromptConfigEntity): number;
+    protected parseScopes(raw: string | null): Record<string, unknown>;
+}
+/**
+ * Overlay a resolved `ScopedPromptConfig` onto a prompt run's params. Only sets values the caller
+ * has NOT already specified (runtime-explicit overrides win); null columns are skipped (inherit the
+ * prompt default). Model/vendor → `override.{modelId,vendorId}`; configuration → `configurationId`;
+ * effort → `effortLevel`; the sampling knobs → `additionalParameters` (existing keys win). Returns
+ * the applied config (for observability) or null when nothing resolved.
+ */
+export declare function ApplyScopedPromptConfig(resolver: ScopedPromptConfigResolver, promptID: string, scope: PromptComponentScope, params: ScopedPromptConfigTarget): MJScopedPromptConfigEntity | null;
+export type { PromptComponentScope, SecondaryScopeValue };
+//# sourceMappingURL=scoped-prompt-config-resolver.d.ts.map

package/dist/scoped-prompt-config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-prompt-config-resolver.d.ts","sourceRoot":"","sources":["../src/scoped-prompt-config-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA0B;IACnC,gGAAgG;IACzF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,0BAA0B,GAAG,IAAI;IAShG,yEAAyE;IACzE,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,EAAE;IAMvE,sGAAsG;IACtG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,0BAA0B,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO;IA0BxF,6FAA6F;IAC7F,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,0BAA0B,GAAG,MAAM;IAOtD,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASrE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,0BAA0B,EACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,wBAAwB,GACjC,0BAA0B,GAAG,IAAI,CA8CnC;AAGD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/scoped-prompt-config-resolver.js

@@ -0,0 +1,134 @@
+import { LogStatus } from "@memberjunction/core";
+import { UUIDsEqual } from "@memberjunction/global";
+import { AIEngine } from "@memberjunction/aiengine";
+/** Statuses eligible for resolution. Archived configs are excluded. */
+const RESOLVABLE_STATUSES = new Set(["Active", "Provisional"]);
+/**
+ * ScopedPromptConfigResolver — the run-settings sibling of {@link PromptComponentResolver}.
+ * Picks the single most-specific in-scope `MJ: Scoped Prompt Configs` row for a prompt (whole-row
+ * wins: SecondaryScopes match (+4) > PrimaryScopeRecord (+2) > global (+1), tie-broken by
+ * `Priority`), then overlays its non-null columns onto the prompt run's params.
+ *
+ * **Pluggable (ClassFactory).** Obtained via
+ * `MJGlobal.Instance.ClassFactory.CreateInstance(ScopedPromptConfigResolver)` — base by default, or
+ * a `@RegisterClass(ScopedPromptConfigResolver)` subclass. Protected hooks
+ * ({@link getCandidates}, {@link isInScope}, {@link score}) are the override points, mirroring
+ * the parts resolver.
+ */
+export class ScopedPromptConfigResolver {
+    /** Resolve the single winning config for `promptID` under `scope`, or null if none in scope. */
+    Resolve(promptID, scope) {
+        const inScope = this.getCandidates(promptID).filter((c) => this.isInScope(c, scope));
+        if (inScope.length === 0)
+            return null;
+        inScope.sort((a, b) => this.score(b) - this.score(a) || b.Priority - a.Priority);
+        return inScope[0];
+    }
+    // ── Protected hooks (override points) ──────────────────────────────────────
+    /** Candidate configs for a prompt: same PromptID + resolvable Status. */
+    getCandidates(promptID) {
+        return AIEngine.Instance.ScopedPromptConfigs.filter((c) => UUIDsEqual(c.PromptID, promptID) && RESOLVABLE_STATUSES.has(c.Status));
+    }
+    /** Is this config compatible with the run scope? (cascading: it may only require dims the run has) */
+    isInScope(c, scope) {
+        if (c.PrimaryScopeRecordID) {
+            if (!scope.primaryScopeRecordId ||
+                c.PrimaryScopeRecordID.toLowerCase() !== scope.primaryScopeRecordId.toLowerCase()) {
+                return false;
+            }
+            if (c.PrimaryScopeEntityID &&
+                scope.primaryScopeEntityId &&
+                !UUIDsEqual(c.PrimaryScopeEntityID, scope.primaryScopeEntityId)) {
+                return false;
+            }
+        }
+        const cfgScopes = this.parseScopes(c.SecondaryScopes);
+        for (const key of Object.keys(cfgScopes)) {
+            const runValue = scope.secondaryScopes?.[key];
+            if (runValue === undefined || String(runValue) !== String(cfgScopes[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /** Specificity score: SecondaryScopes match (+4) > PrimaryScopeRecord (+2) > Global (+1). */
+    score(c) {
+        let s = 1;
+        if (c.PrimaryScopeRecordID)
+            s += 2;
+        if (Object.keys(this.parseScopes(c.SecondaryScopes)).length > 0)
+            s += 4;
+        return s;
+    }
+    parseScopes(raw) {
+        if (!raw)
+            return {};
+        try {
+            const o = JSON.parse(raw);
+            return o && typeof o === "object" ? o : {};
+        }
+        catch {
+            return {};
+        }
+    }
+}
+/**
+ * Overlay a resolved `ScopedPromptConfig` onto a prompt run's params. Only sets values the caller
+ * has NOT already specified (runtime-explicit overrides win); null columns are skipped (inherit the
+ * prompt default). Model/vendor → `override.{modelId,vendorId}`; configuration → `configurationId`;
+ * effort → `effortLevel`; the sampling knobs → `additionalParameters` (existing keys win). Returns
+ * the applied config (for observability) or null when nothing resolved.
+ */
+export function ApplyScopedPromptConfig(resolver, promptID, scope, params) {
+    const cfg = resolver.Resolve(promptID, scope);
+    if (!cfg)
+        return null;
+    if (cfg.ModelID && !params.override?.modelId) {
+        params.override = { ...(params.override ?? {}), modelId: cfg.ModelID };
+        if (cfg.VendorID && !params.override.vendorId) {
+            params.override.vendorId = cfg.VendorID;
+        }
+    }
+    if (cfg.ConfigurationID && params.configurationId == null) {
+        params.configurationId = cfg.ConfigurationID;
+    }
+    if (cfg.EffortLevel != null && params.effortLevel == null) {
+        params.effortLevel = cfg.EffortLevel;
+    }
+    // Sampling knobs → additionalParameters (existing/runtime keys win).
+    const knobs = {};
+    if (cfg.Temperature != null)
+        knobs.temperature = cfg.Temperature;
+    if (cfg.TopP != null)
+        knobs.topP = cfg.TopP;
+    if (cfg.TopK != null)
+        knobs.topK = cfg.TopK;
+    if (cfg.MinP != null)
+        knobs.minP = cfg.MinP;
+    if (cfg.FrequencyPenalty != null)
+        knobs.frequencyPenalty = cfg.FrequencyPenalty;
+    if (cfg.PresencePenalty != null)
+        knobs.presencePenalty = cfg.PresencePenalty;
+    if (cfg.Seed != null)
+        knobs.seed = cfg.Seed;
+    // StopSequences is comma-delimited text (like the prompt default); the runner's additionalParameters
+    // contract expects a ready-made string[] (it assigns it as-is to ChatParams.stopSequences), so split
+    // + trim here rather than passing the raw string. NOTE: the additionalParameters path intentionally
+    // bypasses AIPromptRunner's shouldApplyStopSequences driver-support gate — a scope-level override is
+    // taken as an explicit caller instruction, same as any runtime-supplied additionalParameters.
+    if (cfg.StopSequences) {
+        const stops = cfg.StopSequences.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+        if (stops.length > 0)
+            knobs.stopSequences = stops;
+    }
+    if (cfg.ResponseFormat)
+        knobs.responseFormat = cfg.ResponseFormat;
+    if (Object.keys(knobs).length > 0) {
+        params.additionalParameters = { ...knobs, ...(params.additionalParameters ?? {}) };
+    }
+    LogStatus(`ScopedPromptConfigResolver: applied config ${cfg.ID} for prompt ${promptID} ` +
+        `(scope record=${scope.primaryScopeRecordId ?? "global"}` +
+        `${cfg.ModelID ? `, model=${cfg.ModelID}` : ""})`);
+    return cfg;
+}
+//# sourceMappingURL=scoped-prompt-config-resolver.js.map

package/dist/scoped-prompt-config-resolver.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-agents",
   "type": "module",
-  "version": "5.45.0",
+  "version": "5.46.0",
   "description": "MemberJunction: AI Agent Execution and Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,23 +17,23 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/actions": "5.45.0",
-    "@memberjunction/actions-base": "5.45.0",
-    "@memberjunction/ai": "5.45.0",
-    "@memberjunction/ai-core-plus": "5.45.0",
-    "@memberjunction/ai-engine-base": "5.45.0",
-    "@memberjunction/ai-prompts": "5.45.0",
-    "@memberjunction/ai-reranker": "5.45.0",
-    "@memberjunction/ai-vector-dupe": "5.45.0",
-    "@memberjunction/ai-vector-sync": "5.45.0",
-    "@memberjunction/aiengine": "5.45.0",
-    "@memberjunction/context-crush": "5.45.0",
-    "@memberjunction/core": "5.45.0",
-    "@memberjunction/core-entities": "5.45.0",
-    "@memberjunction/global": "5.45.0",
-    "@memberjunction/search-engine": "5.45.0",
-    "@memberjunction/storage": "5.45.0",
-    "@memberjunction/templates": "5.45.0",
+    "@memberjunction/actions": "5.46.0",
+    "@memberjunction/actions-base": "5.46.0",
+    "@memberjunction/ai": "5.46.0",
+    "@memberjunction/ai-core-plus": "5.46.0",
+    "@memberjunction/ai-engine-base": "5.46.0",
+    "@memberjunction/ai-prompts": "5.46.0",
+    "@memberjunction/ai-reranker": "5.46.0",
+    "@memberjunction/ai-vector-dupe": "5.46.0",
+    "@memberjunction/ai-vector-sync": "5.46.0",
+    "@memberjunction/aiengine": "5.46.0",
+    "@memberjunction/context-crush": "5.46.0",
+    "@memberjunction/core": "5.46.0",
+    "@memberjunction/core-entities": "5.46.0",
+    "@memberjunction/global": "5.46.0",
+    "@memberjunction/search-engine": "5.46.0",
+    "@memberjunction/storage": "5.46.0",
+    "@memberjunction/templates": "5.46.0",
     "dotenv": "^17.2.4",
     "exceljs": "^4.4.0",
     "lodash": "^4.17.23",