@memberjunction/ng-core-entity-forms 5.37.0 → 5.39.0

package/README.md

@@ -132,6 +132,27 @@ The `MemberJunctionCoreEntityFormsModule` contains extended form components that
 2. `EntityActionExtendedFormComponent` - Enhanced form for EntityAction management
 3. `ActionTopComponentExtended` - Custom top section for Action forms
 
+## Extending Generated Forms — Two Patterns
+
+Before reaching for a full custom form override, check whether the lighter-weight `BaseFormPanel` slot system covers your need.
+
+### Pattern 1: `BaseFormPanel` slots (lightweight, additive)
+
+Standalone Angular components that extend `BaseFormPanel` and self-register via `@RegisterClassEx(BaseFormPanel, { metadata: { entity, slot, sortKey } })`. They mount into generated forms dynamically through `<mj-form-panel-slot>`. **No `*Extended` class, no restating the generated layout.** Panels live in `src/lib/panels/{entity-folder}/` in this package (see `panels/content-sources/` for the `TagPipelineConfigurationPanel` and `WebsiteCrawlerSettingsPanel` reference implementations).
+
+When you'd reach for this:
+- Adding governance / metrics / typed-config panels alongside generated fields.
+- Source-type-conditional panels (gate inside the panel template).
+- Anything that's "the generated form plus N extra sections."
+
+Full authoring guide + slot positions + fallback chain: [`packages/Angular/Generic/base-forms/PANELS.md`](../../Generic/base-forms/PANELS.md).
+
+### Pattern 2: Full custom form override (heavyweight, replaces layout)
+
+The classic pattern documented below. Use when the generated layout is the wrong starting point — you need to hide generated panels, restructure the toolbar, embed a fundamentally different UX (flow editor, Kanban board, wizard), or otherwise own the entire form's render. `AIAgentFormComponentExtended` is the canonical example: the flow editor isn't a "panel alongside fields," it IS the form.
+
+In doubt: "generated form + extras" → Pattern 1. "generated form is the wrong shape entirely" → Pattern 2.
+
 ## Custom Form Development Guide
 
 ### **Core Architecture & Setup**
@@ -416,7 +437,7 @@ When viewing an entity that participates in IS-A relationships, the form display
 The IS-A visualization is built into the generated entity forms and automatically activates when an entity has IS-A relationships defined in the metadata. No additional configuration is required beyond setting up the IS-A relationships in the database schema.
 
 For more information on IS-A relationships and implementation, see:
-- [IS-A Relationships Documentation](../../../../MJCore/docs/isa-relationships.md)
+- [IS-A Relationships Documentation](../../../MJCore/docs/isa-relationships.md)
 
 ## Virtual Entity UI
 
@@ -457,5 +478,5 @@ Virtual entities are commonly used for:
 Virtual entities are defined by setting the `IsVirtualEntity` flag in the entity metadata. The form UI automatically detects this flag and applies the appropriate read-only restrictions and visual indicators.
 
 For more information on virtual entities and implementation, see:
-- [Virtual Entities Documentation](../../../../MJCore/docs/virtual-entities.md)
+- [Virtual Entities Documentation](../../../MJCore/docs/virtual-entities.md)
 

package/dist/lib/custom/AIPromptRuns/ai-prompt-run-form.component.d.ts

@@ -67,6 +67,16 @@ export declare class MJAIPromptRunFormComponentExtended extends MJAIPromptRunFor
     formatDuration(ms: number | null): string;
     formatCost(cost: number | null): string;
     formatTokens(tokens: number | null): string;
+    /**
+     * Total tokens the provider actually processed = uncached (TokensUsed = prompt+completion) PLUS
+     * the cache buckets. TokensUsed alone excludes cache by design, so a heavily-cached run looks
+     * tiny; this is the real throughput figure for the headline. Equals TokensUsed when no caching.
+     */
+    get TotalTokensProcessed(): number;
+    /** Sum of cache read + write tokens for this run (the cached portion of TotalTokensProcessed). */
+    get CachedTokens(): number;
+    /** Percentage of this run's input tokens served from the provider's prompt cache. */
+    get CacheHitRatePct(): number;
     getRunTypeIcon(runType: string | null): string;
     getRunTypeColor(runType: string | null): string;
     navigateToEntity(entityName: string, recordId: string | null): void;

package/dist/lib/custom/AIPromptRuns/ai-prompt-run-form.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-prompt-run-form.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom/AIPromptRuns/ai-prompt-run-form.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAoB,SAAS,EAAmC,MAAM,eAAe,CAAC;AAGvH,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qEAAqE,CAAC;AAEjH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;;AAIjD,qBAQa,kCAAmC,SAAQ,0BAA2B,YAAW,aAAa,EAAE,SAAS;IAC3G,MAAM,EAAG,2BAA2B,CAAC;IAC5C,SAAgB,aAAa,4DAAgC;IAE7D,4EAA4E;IAC5D,uBAAuB,IAAI,UAAU,GAAG,YAAY;IAG7D,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAQ;IAC/C,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;IACrC,SAAS,EAAE,2BAA2B,GAAG,IAAI,CAAQ;IACrD,SAAS,EAAE,2BAA2B,EAAE,CAAM;IAG9C,oBAAoB,UAAS;IAC7B,iBAAiB,UAAS;IAC1B,aAAa,UAAQ;IACrB,gBAAgB,UAAQ;IACxB,YAAY,UAAS;IACrB,WAAW,UAAS;IACpB,cAAc,UAAS;IACvB,eAAe,UAAS;IACxB,iBAAiB,UAAS;IAC1B,kBAAkB,UAAS;IAC3B,qBAAqB,UAAS;IAGrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,sBAAsB,CAAS;IAGhC,iBAAiB,SAAM;IACvB,eAAe,SAAM;IACrB,0BAA0B,SAAM;IAChC,2BAA2B,SAAM;IACjC,aAAa,SAAM;IACnB,uBAAuB,SAAM;IAC7B,qBAAqB,SAAM;IAC3B,qCAAqC,SAAM;IAG3C,YAAY,EAAE,WAAW,EAAE,CAAM;IACjC,SAAS,EAAE,GAAG,CAAQ;IAGtB,kBAAkB,EAAE,GAAG,EAAE,CAAM;IAC/B,iBAAiB,EAAE,GAAG,CAAQ;IAG9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACxC,kBAAkB,SAAU;IAC5B,eAAe,SAAM;IAG5B,OAAO,CAAC,wBAAwB,CAA2C;IAC3E,OAAO,CAAC,gBAAgB,CAA4B;IAE9C,QAAQ;IA4Bd,eAAe;IAOf,WAAW;IAMX,kBAAkB,CAAC,KAAK,EAAE,GAAG;IAM7B,mBAAmB,CAAC,KAAK,EAAE,GAAG;IAM9B,uBAAuB,CAAC,KAAK,EAAE,GAAG;IAMlC,oBAAoB,CAAC,KAAK,EAAE,GAAG;IAM/B,0BAA0B,CAAC,KAAK,EAAE,GAAG;IAMrC,2BAA2B,CAAC,KAAK,EAAE,GAAG;YAKxB,eAAe;YAsCf,aAAa;IAgB3B,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,kCAAkC;IAqB1C,cAAc,IAAI,MAAM;IAcxB,aAAa,IAAI,MAAM;IAcvB,aAAa,IAAI,MAAM;IAcvB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAczC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAKvC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAK3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAe9C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAe/C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM5D,qBAAqB;IAMrB,WAAW;IAoCX,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IASzC,WAAW;IAgBV,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtE,eAAe,IAAI,IAAI;IAK9B,OAAO,CAAC,kBAAkB;yCAxejB,kCAAkC;2CAAlC,kCAAkC;CAihB9C"}
+{"version":3,"file":"ai-prompt-run-form.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom/AIPromptRuns/ai-prompt-run-form.component.ts"],"names":[],"mappings":"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"}