@memberjunction/ai-agent-manager 6.2.0-edge.0 → 6.2.0-edge.1

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @memberjunction/ai-agent-manager@6.2.0-edge.0 build /home/runner/work/MJ/MJ/packages/AI/AgentManager/core
+> @memberjunction/ai-agent-manager@6.2.0-edge.1 build /home/runner/work/MJ/MJ/packages/AI/AgentManager/core
 > tsc && tsc-alias -f
 

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @memberjunction/ai-agent-manager
 
+## 6.2.0-edge.1
+
+### Patch Changes
+
+- 80905a1: Rename public class members and exported functions to PascalCase, per MJ's naming convention,
+  **without breaking a single consumer**.
+
+  Every renamed symbol keeps its old name beside the new one as a `@deprecated` stub that forwards to
+  it — a delegating method or function, a getter/setter pair for a property, and for Angular a
+  readable accessor pair for an `@Input` and a second `@Output` sharing the same `EventEmitter`, so a
+  template still binding the old name keeps receiving events. Old names still compile, still resolve,
+  and still behave identically; the deprecation tag rides through to the published `.d.ts`, so editors
+  point callers at the replacement. Where a package re-exports through an explicit `export { … }`
+  list, the new name is added alongside the old, so the correct name is actually on the public surface
+  rather than merely declared.
+
+  The rename is deliberately refused wherever a mechanical stub would not be equivalent, because
+  several of those shapes change a type contract while still compiling in the package that declares
+  them:
+  - an **optional** property or parameter property — TypeScript has no optional accessor, so a stub
+    would promote `foo?` to a required member and break every object literal that omits it;
+  - a class that is a **data shape** (no methods, or `@ObjectType`/`@InputType`) — object literals are
+    assigned to it, and an accessor stub changes what they must supply;
+  - a property whose **subclass redeclares it**, since TypeScript forbids a property overriding an
+    accessor (TS2610);
+  - a name whose PascalCase form is **already bound** in that file or class;
+  - decorated members, `get`/`set` pairs behind a decorator, generators, destructured parameters,
+    overload sets and abstract members.
+
+  **One wire-visible consequence, for version skew only.** `BaseInfo.toJSON` walks `_`-prefixed
+  backing fields and emits them through their public getter, preferring the PascalCase one. Renaming
+  the 23 field aliases in `MJCore/src/generic` therefore changes what `AllMetadata` carries:
+  `EntityInfo.spCreate` and friends now serialize as `SpCreate`. A same-version client is unaffected —
+  `copyInitData` accepts a value through a settable accessor, so either spelling lands on the right
+  field. An OLDER client against a newer server has no such path in its `copyInitData` and drops those
+  fields silently. Same-version deployments, which is the supported configuration, see no change.
+
+  Each package was verified against its own pre-change baseline rather than against zero, because
+  several packages in this repo do not typecheck cleanly to begin with. Angular packages were verified
+  with `ngc`, not `tsc`: a plain typecheck does not compile templates, and an earlier write-only
+  `@Input` alias passed `tsc` while breaking six template reads.
+
+- Updated dependencies [ddcd666]
+- Updated dependencies [a50948e]
+- Updated dependencies [0eeb89d]
+- Updated dependencies [a3539d2]
+- Updated dependencies [41274aa]
+- Updated dependencies [67f6c85]
+- Updated dependencies [eb3a8d3]
+- Updated dependencies [e1dd673]
+- Updated dependencies [9b8a84e]
+- Updated dependencies [307da67]
+- Updated dependencies [a7da50b]
+- Updated dependencies [1d43161]
+- Updated dependencies [7110019]
+- Updated dependencies [17cc774]
+- Updated dependencies [80905a1]
+- Updated dependencies [6b08ebf]
+- Updated dependencies [c4993f3]
+  - @memberjunction/aiengine@6.2.0-edge.1
+  - @memberjunction/core-entities@6.2.0-edge.1
+  - @memberjunction/ai-agents@6.2.0-edge.1
+  - @memberjunction/ai-core-plus@6.2.0-edge.1
+  - @memberjunction/core@6.2.0-edge.1
+  - @memberjunction/global@6.2.0-edge.1
+  - @memberjunction/templates@6.2.0-edge.1
+  - @memberjunction/ai-engine-base@6.2.0-edge.1
+
 ## 6.2.0-edge.0
 
 ### Patch Changes

package/dist/agent-spec-sync.d.ts

@@ -78,7 +78,11 @@ export declare class AgentSpecSync {
     /**
      * The raw specification data structure containing all agent configuration
      */
-    spec: AgentSpec;
+    Spec: AgentSpec;
+    /** @deprecated Use {@link Spec}. */
+    get spec(): AgentSpec;
+    /** @deprecated Use {@link Spec}. */
+    set spec(value: AgentSpec);
     /**
      * Tracks whether this spec has been loaded from the database
      * @private
@@ -132,10 +136,14 @@ export declare class AgentSpecSync {
      * Get all mutations tracked during the last save operation
      * @returns Array of mutations
      */
+    GetMutations(): AgentSpecSyncMutation[];
+    /** @deprecated Use {@link GetMutations}. */
     getMutations(): AgentSpecSyncMutation[];
     /**
      * Clear all tracked mutations
      */
+    ClearMutations(): void;
+    /** @deprecated Use {@link ClearMutations}. */
     clearMutations(): void;
     /**
      * Load an agent and its complete hierarchy from the database by ID.
@@ -450,12 +458,16 @@ export declare class AgentSpecSync {
      *
      * @returns True if there are unsaved changes, false otherwise
      */
+    get IsDirty(): boolean;
+    /** @deprecated Use {@link IsDirty}. */
     get isDirty(): boolean;
     /**
      * Check if this spec has been loaded from the database.
      *
      * @returns True if loaded from database, false if created in memory
      */
+    get IsLoaded(): boolean;
+    /** @deprecated Use {@link IsLoaded}. */
     get isLoaded(): boolean;
     /**
      * Mark the spec as having changes.
@@ -472,6 +484,8 @@ export declare class AgentSpecSync {
      * await spec.SaveToDatabase();
      * ```
      */
+    MarkDirty(): void;
+    /** @deprecated Use {@link MarkDirty}. */
     markDirty(): void;
     /**
      * Mark the spec as having been loaded from the database.
@@ -490,6 +504,8 @@ export declare class AgentSpecSync {
      * await childSync.SaveToDatabase();
      * ```
      */
+    MarkLoaded(): void;
+    /** @deprecated Use {@link MarkLoaded}. */
     markLoaded(): void;
     /**
      * Load the current state of all agent-related records from the database.

package/dist/agent-spec-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-spec-sync.d.ts","sourceRoot":"","sources":["../src/agent-spec-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,QAAQ,EAER,iBAAiB,EACpB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACH,SAAS,EAIZ,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACtC;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,aAAa;IACtB;;OAEG;IACI,IAAI,EAAE,SAAS,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAC,CAAW;IAEhC;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,CAAoB;IAEtC;;;;OAIG;IACH,OAAO,KAAK,aAAa,GAExB;IAED;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA+B;IAEjD;;;;;;;;;;OAUG;gBACS,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IAoB3F;;;OAGG;IACH,OAAO,CAAC,aAAa;IAcrB;;;OAGG;IACI,YAAY,IAAI,qBAAqB,EAAE;IAI9C;;OAEG;IACI,cAAc,IAAI,IAAI;IAM7B;;;;;;;;;;;;;;;;;;;;;;OAsBG;WACU,gBAAgB,CACzB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,QAAQ,EACtB,gBAAgB,GAAE,OAAc,EAChC,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAMzB;;;;;;;;;;;;;;;;;OAiBG;WACU,UAAU,CACnB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,QAAQ,EACtB,gBAAgB,GAAE,OAAc,EAChC,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAyBzB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,aAAa;IAM3G;;;;;;;;;;;OAWG;YACW,gBAAgB;IAiK9B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,oBAAoB;IAiF5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,cAAc,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgE5E;;;;;;;OAOG;YACW,eAAe;IAqH7B;;;;;;;;;;OAUG;YACW,WAAW;IAkDzB;;;;;;;;;;OAUG;YACW,aAAa;IAc3B;;;;;;;;;;;;;;OAcG;YACW,iBAAiB;IA2C/B;;;;;;;;;;OAUG;YACW,mBAAmB;IAsDjC;;;;;;;;;;OAUG;YACW,WAAW;IAkIzB;;;;;;;;;OASG;YACW,SAAS;IA6HvB;;;;;;;;;OASG;YACW,aAAa;IA8E3B;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAgDtB;;;;;;;;;;;;;;;OAeG;IACI,MAAM,IAAI,SAAS;IAI1B;;;;OAIG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;OAIG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;;;;;;;;;;;OAcG;IACI,SAAS,IAAI,IAAI;IAIxB;;;;;;;;;;;;;;;;OAgBG;IACI,UAAU,IAAI,IAAI;IAMzB;;;;;;;;;;OAUG;YACW,wBAAwB;IAuEtC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,eAAe;IAsCvB;;;;;;;;;;;;;;OAcG;YACW,aAAa;IAuH3B;;;;;;;;;;;;;;OAcG;YACW,gBAAgB;CAmBjC"}
+{"version":3,"file":"agent-spec-sync.d.ts","sourceRoot":"","sources":["../src/agent-spec-sync.ts"],"names":[],"mappings":"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"}

package/dist/agent-spec-sync.js

@@ -51,6 +51,14 @@ import { UUIDsEqual } from '@memberjunction/global';
  * @module @memberjunction/ai-agent-manager
  */
 export class AgentSpecSync {
+    /** @deprecated Use {@link Spec}. */
+    get spec() {
+        return this.Spec;
+    }
+    /** @deprecated Use {@link Spec}. */
+    set spec(value) {
+        this.Spec = value;
+    }
     /**
      * Returns the metadata provider to use for entity operations. Prefers a
      * caller-supplied provider for server isolation; otherwise falls back to
@@ -87,12 +95,12 @@ export class AgentSpecSync {
          */
         this._mutations = [];
         if (spec) {
-            this.spec = this.initializeSpec(spec);
+            this.Spec = this.initializeSpec(spec);
             this._isDirty = true;
         }
         else {
             // Create minimal empty spec
-            this.spec = {
+            this.Spec = {
                 ID: '', // Will be set on save if empty
                 Name: '',
                 StartingPayloadValidationMode: 'Fail',
@@ -120,15 +128,23 @@ export class AgentSpecSync {
      * Get all mutations tracked during the last save operation
      * @returns Array of mutations
      */
-    getMutations() {
+    GetMutations() {
         return [...this._mutations];
     }
+    /** @deprecated Use {@link GetMutations}. */
+    getMutations() {
+        return this.GetMutations();
+    }
     /**
      * Clear all tracked mutations
      */
-    clearMutations() {
+    ClearMutations() {
         this._mutations = [];
     }
+    /** @deprecated Use {@link ClearMutations}. */
+    clearMutations() {
+        return this.ClearMutations();
+    }
     // ===== STATIC FACTORY METHODS =====
     /**
      * Load an agent and its complete hierarchy from the database by ID.
@@ -342,11 +358,11 @@ export class AgentSpecSync {
             };
         }
         // Step 3: Map entities to raw spec format
-        this.spec = this.mapEntitiesToRawSpec(agentEntity, actionsResult.Results || [], childAgentsResult.Results || [], relatedAgentsResult.Results || [], promptsResult.Results || [], fullPromptsResult.Results || [], stepsResult.Results || [], pathsResult.Results || []);
+        this.Spec = this.mapEntitiesToRawSpec(agentEntity, actionsResult.Results || [], childAgentsResult.Results || [], relatedAgentsResult.Results || [], promptsResult.Results || [], fullPromptsResult.Results || [], stepsResult.Results || [], pathsResult.Results || []);
         // Step 4: Recursively load sub-agents if requested
-        if (includeSubAgents && this.spec.SubAgents && this.spec.SubAgents.length > 0) {
+        if (includeSubAgents && this.Spec.SubAgents && this.Spec.SubAgents.length > 0) {
             // Recursively load complete specs for all sub-agents
-            for (const subAgentSpec of this.spec.SubAgents) {
+            for (const subAgentSpec of this.Spec.SubAgents) {
                 if (subAgentSpec.SubAgent && subAgentSpec.SubAgent.ID) {
                     try {
                         // Load the complete sub-agent spec recursively
@@ -604,22 +620,22 @@ export class AgentSpecSync {
      */
     async SaveToDatabase(validate = true) {
         // Clear previous mutations
-        this.clearMutations();
+        this.ClearMutations();
         if (!this._isDirty && this._isLoaded) {
             // No changes to save
             return {
-                agentId: this.spec.ID,
+                agentId: this.Spec.ID,
                 success: true,
                 mutations: []
             };
         }
         try {
             // Step 0: Delete orphaned records (if this is an update)
-            if (this._isLoaded && this.spec.ID) {
-                console.log(`🗑️ SaveToDatabase: Loading current database state for agent ${this.spec.ID}...`);
-                const dbState = await this.loadCurrentDatabaseState(this.spec.ID);
+            if (this._isLoaded && this.Spec.ID) {
+                console.log(`🗑️ SaveToDatabase: Loading current database state for agent ${this.Spec.ID}...`);
+                const dbState = await this.loadCurrentDatabaseState(this.Spec.ID);
                 console.log(`🔍 SaveToDatabase: Identifying orphaned records...`);
-                const orphans = this.identifyOrphans(dbState, this.spec);
+                const orphans = this.identifyOrphans(dbState, this.Spec);
                 console.log(`🗑️ SaveToDatabase: Deleting ${orphans.paths.length} paths, ${orphans.actions.length} actions, ${orphans.steps.length} steps, ${orphans.prompts.length} prompts, ${orphans.relationships.length} relationships, orphaning ${orphans.childAgents.length} child agents...`);
                 await this.deleteOrphans(orphans);
                 console.log(`✅ SaveToDatabase: Orphan cleanup complete`);
@@ -641,15 +657,15 @@ export class AgentSpecSync {
             return {
                 agentId,
                 success: true,
-                mutations: this.getMutations()
+                mutations: this.GetMutations()
             };
         }
         catch (error) {
             // Return failure with whatever mutations were completed before error
             return {
-                agentId: this.spec.ID || '',
+                agentId: this.Spec.ID || '',
                 success: false,
-                mutations: this.getMutations()
+                mutations: this.GetMutations()
             };
         }
     }
@@ -665,69 +681,69 @@ export class AgentSpecSync {
         const md = this.providerToUse;
         const agentEntity = await md.GetEntityObject('MJ: AI Agents', this._contextUser);
         // Track if this is an update or create
-        const isUpdate = !!this.spec.ID;
+        const isUpdate = !!this.Spec.ID;
         // If ID exists, load existing record
-        if (this.spec.ID) {
-            const loaded = await agentEntity.Load(this.spec.ID);
+        if (this.Spec.ID) {
+            const loaded = await agentEntity.Load(this.Spec.ID);
             if (!loaded) {
-                throw new Error(`Cannot update non-existent agent with ID ${this.spec.ID}`);
+                throw new Error(`Cannot update non-existent agent with ID ${this.Spec.ID}`);
             }
         }
         // Map spec to entity fields
-        agentEntity.Name = this.spec.Name;
-        agentEntity.Description = this.spec.Description || null;
-        agentEntity.IconClass = this.spec.IconClass || null;
-        agentEntity.LogoURL = this.spec.LogoURL || null;
-        agentEntity.ParentID = this.spec.ParentID || null;
-        agentEntity.DriverClass = this.spec.DriverClass || null;
-        agentEntity.ModelSelectionMode = this.spec.ModelSelectionMode || 'Agent Type';
+        agentEntity.Name = this.Spec.Name;
+        agentEntity.Description = this.Spec.Description || null;
+        agentEntity.IconClass = this.Spec.IconClass || null;
+        agentEntity.LogoURL = this.Spec.LogoURL || null;
+        agentEntity.ParentID = this.Spec.ParentID || null;
+        agentEntity.DriverClass = this.Spec.DriverClass || null;
+        agentEntity.ModelSelectionMode = this.Spec.ModelSelectionMode || 'Agent Type';
         // Handle TypeID - supports lookup references or direct GUID
-        if (this.spec.TypeID) {
-            agentEntity.TypeID = this.spec.TypeID;
+        if (this.Spec.TypeID) {
+            agentEntity.TypeID = this.Spec.TypeID;
         }
         // Handle Status - defaults to Active if not specified. Typed rather than cast: the cast is
         // what let `'Inactive'` — a value the CHECK constraint rejects — reach the entity unchallenged.
-        agentEntity.Status = this.spec.Status ?? 'Active';
+        agentEntity.Status = this.Spec.Status ?? 'Active';
         // Serialize JSON fields
-        agentEntity.PayloadDownstreamPaths = JSON.stringify(this.spec.PayloadDownstreamPaths || ['*']);
-        agentEntity.PayloadUpstreamPaths = JSON.stringify(this.spec.PayloadUpstreamPaths || ['*']);
-        agentEntity.PayloadSelfReadPaths = this.spec.PayloadSelfReadPaths
-            ? JSON.stringify(this.spec.PayloadSelfReadPaths)
+        agentEntity.PayloadDownstreamPaths = JSON.stringify(this.Spec.PayloadDownstreamPaths || ['*']);
+        agentEntity.PayloadUpstreamPaths = JSON.stringify(this.Spec.PayloadUpstreamPaths || ['*']);
+        agentEntity.PayloadSelfReadPaths = this.Spec.PayloadSelfReadPaths
+            ? JSON.stringify(this.Spec.PayloadSelfReadPaths)
             : null;
-        agentEntity.PayloadSelfWritePaths = this.spec.PayloadSelfWritePaths
-            ? JSON.stringify(this.spec.PayloadSelfWritePaths)
+        agentEntity.PayloadSelfWritePaths = this.Spec.PayloadSelfWritePaths
+            ? JSON.stringify(this.Spec.PayloadSelfWritePaths)
             : null;
-        agentEntity.PayloadScope = this.spec.PayloadScope || null;
+        agentEntity.PayloadScope = this.Spec.PayloadScope || null;
         // Validation fields
-        agentEntity.FinalPayloadValidation = this.spec.FinalPayloadValidation || null;
-        agentEntity.FinalPayloadValidationMode = this.spec.FinalPayloadValidationMode || 'Retry';
-        agentEntity.FinalPayloadValidationMaxRetries = this.spec.FinalPayloadValidationMaxRetries || 3;
-        agentEntity.StartingPayloadValidation = this.spec.StartingPayloadValidation || null;
-        agentEntity.StartingPayloadValidationMode = this.spec.StartingPayloadValidationMode || 'Fail';
+        agentEntity.FinalPayloadValidation = this.Spec.FinalPayloadValidation || null;
+        agentEntity.FinalPayloadValidationMode = this.Spec.FinalPayloadValidationMode || 'Retry';
+        agentEntity.FinalPayloadValidationMaxRetries = this.Spec.FinalPayloadValidationMaxRetries || 3;
+        agentEntity.StartingPayloadValidation = this.Spec.StartingPayloadValidation || null;
+        agentEntity.StartingPayloadValidationMode = this.Spec.StartingPayloadValidationMode || 'Fail';
         // Resource limits
-        agentEntity.MaxCostPerRun = this.spec.MaxCostPerRun || null;
-        agentEntity.MaxTokensPerRun = this.spec.MaxTokensPerRun || null;
-        agentEntity.MaxIterationsPerRun = this.spec.MaxIterationsPerRun || null;
-        agentEntity.MaxTimePerRun = this.spec.MaxTimePerRun || null;
+        agentEntity.MaxCostPerRun = this.Spec.MaxCostPerRun || null;
+        agentEntity.MaxTokensPerRun = this.Spec.MaxTokensPerRun || null;
+        agentEntity.MaxIterationsPerRun = this.Spec.MaxIterationsPerRun || null;
+        agentEntity.MaxTimePerRun = this.Spec.MaxTimePerRun || null;
         // Execution frequency
-        agentEntity.MinExecutionsPerRun = this.spec.MinExecutionsPerRun || null;
-        agentEntity.MaxExecutionsPerRun = this.spec.MaxExecutionsPerRun || null;
+        agentEntity.MinExecutionsPerRun = this.Spec.MinExecutionsPerRun || null;
+        agentEntity.MaxExecutionsPerRun = this.Spec.MaxExecutionsPerRun || null;
         // Other config
-        agentEntity.DefaultPromptEffortLevel = this.spec.DefaultPromptEffortLevel || null;
-        agentEntity.ChatHandlingOption = this.spec.ChatHandlingOption || null;
-        agentEntity.DefaultArtifactTypeID = this.spec.DefaultArtifactTypeID || null;
+        agentEntity.DefaultPromptEffortLevel = this.Spec.DefaultPromptEffortLevel || null;
+        agentEntity.ChatHandlingOption = this.Spec.ChatHandlingOption || null;
+        agentEntity.DefaultArtifactTypeID = this.Spec.DefaultArtifactTypeID || null;
         // Set OwnerUserID - always use contextUser if available (user creating/modifying the agent)
         if (this._contextUser) {
             agentEntity.OwnerUserID = this._contextUser.ID;
         }
-        else if (this.spec.OwnerUserID) {
+        else if (this.Spec.OwnerUserID) {
             // Fallback to spec value if no contextUser provided
-            agentEntity.OwnerUserID = this.spec.OwnerUserID;
+            agentEntity.OwnerUserID = this.Spec.OwnerUserID;
         }
-        agentEntity.InvocationMode = this.spec.InvocationMode || 'Any';
+        agentEntity.InvocationMode = this.Spec.InvocationMode || 'Any';
         // Requirements and design documentation
-        agentEntity.FunctionalRequirements = this.spec.FunctionalRequirements || null;
-        agentEntity.TechnicalDesign = this.spec.TechnicalDesign || null;
+        agentEntity.FunctionalRequirements = this.Spec.FunctionalRequirements || null;
+        agentEntity.TechnicalDesign = this.Spec.TechnicalDesign || null;
         // Validate if requested
         if (validate) {
             const validation = agentEntity.Validate();
@@ -742,9 +758,9 @@ export class AgentSpecSync {
             throw new Error('Failed to save agent entity');
         }
         // Update spec with saved ID
-        this.spec.ID = agentEntity.ID;
+        this.Spec.ID = agentEntity.ID;
         // Track the mutation
-        this.trackMutation('MJ: AI Agents', isUpdate ? 'Update' : 'Create', agentEntity.ID, `${isUpdate ? 'Updated' : 'Created'} agent: ${this.spec.Name}`);
+        this.trackMutation('MJ: AI Agents', isUpdate ? 'Update' : 'Create', agentEntity.ID, `${isUpdate ? 'Updated' : 'Created'} agent: ${this.Spec.Name}`);
         return agentEntity.ID;
     }
     /**
@@ -759,11 +775,11 @@ export class AgentSpecSync {
      * @throws {Error} If any action save fails
      */
     async saveActions(agentId) {
-        if (!this.spec.Actions || this.spec.Actions.length === 0) {
+        if (!this.Spec.Actions || this.Spec.Actions.length === 0) {
             return;
         }
         const md = this.providerToUse;
-        for (const actionSpec of this.spec.Actions) {
+        for (const actionSpec of this.Spec.Actions) {
             const actionEntity = await md.GetEntityObject('MJ: AI Agent Actions', this._contextUser);
             // Track if this is an update or create
             const isUpdate = !!actionSpec.AgentActionID;
@@ -803,10 +819,10 @@ export class AgentSpecSync {
      * @throws {Error} If any sub-agent save fails
      */
     async saveSubAgents(agentId) {
-        if (!this.spec.SubAgents || this.spec.SubAgents.length === 0) {
+        if (!this.Spec.SubAgents || this.Spec.SubAgents.length === 0) {
             return;
         }
-        for (const SubAgentSpec of this.spec.SubAgents) {
+        for (const SubAgentSpec of this.Spec.SubAgents) {
             if (SubAgentSpec.Type === 'child') {
                 await this.saveChildSubAgent(agentId, SubAgentSpec);
             }
@@ -928,17 +944,17 @@ export class AgentSpecSync {
      * @throws {Error} If any prompt save fails
      */
     async savePrompts(agentId) {
-        console.log(`💬 savePrompts: Called with agentId=${agentId}, Prompts=${this.spec.Prompts ? this.spec.Prompts.length : 'undefined'}`);
-        if (!this.spec.Prompts || this.spec.Prompts.length === 0) {
+        console.log(`💬 savePrompts: Called with agentId=${agentId}, Prompts=${this.Spec.Prompts ? this.Spec.Prompts.length : 'undefined'}`);
+        if (!this.Spec.Prompts || this.Spec.Prompts.length === 0) {
             console.log('💬 savePrompts: No prompts to save, returning early');
             return;
         }
-        console.log(`💬 savePrompts: Processing ${this.spec.Prompts.length} prompt(s)...`);
+        console.log(`💬 savePrompts: Processing ${this.Spec.Prompts.length} prompt(s)...`);
         const md = this.providerToUse;
         const rv = RunView.FromMetadataProvider(this._provider);
         // Step 1: Create or update AIPrompt records
-        for (let i = 0; i < this.spec.Prompts.length; i++) {
-            const promptSpec = this.spec.Prompts[i];
+        for (let i = 0; i < this.Spec.Prompts.length; i++) {
+            const promptSpec = this.Spec.Prompts[i];
             // Check if this is an update (has PromptID) or create (no PromptID)
             let promptEntity = await md.GetEntityObject('MJ: AI Prompts', this._contextUser);
             let isUpdate = false;
@@ -954,8 +970,8 @@ export class AgentSpecSync {
                 }
             }
             // Set all required fields (both create and update)
-            promptEntity.Name = `${this.spec.Name} - Prompt ${i + 1}`;
-            promptEntity.Description = `Agent prompt ${i + 1} for ${this.spec.Name}`;
+            promptEntity.Name = `${this.Spec.Name} - Prompt ${i + 1}`;
+            promptEntity.Description = `Agent prompt ${i + 1} for ${this.Spec.Name}`;
             promptEntity.TypeID = 'a6da423e-f36b-1410-8dac-00021f8b792e'; // Chat type
             promptEntity.Status = 'Active';
             promptEntity.ResponseFormat = 'JSON';
@@ -981,7 +997,7 @@ export class AgentSpecSync {
             }
             const saved = await promptEntity.Save();
             if (!saved) {
-                throw new Error(`Failed to save prompt ${i + 1} for agent ${this.spec.Name}`);
+                throw new Error(`Failed to save prompt ${i + 1} for agent ${this.Spec.Name}`);
             }
             // Track mutation
             this.trackMutation('MJ: AI Prompts', isUpdate ? 'Update' : 'Create', promptEntity.ID, `${isUpdate ? 'Updated' : 'Created'} prompt: ${promptEntity.Name}`);
@@ -1021,7 +1037,7 @@ export class AgentSpecSync {
             this.trackMutation('MJ: AI Agent Prompts', isJunctionUpdate ? 'Update' : 'Create', agentPromptEntity.ID, `${isJunctionUpdate ? 'Updated' : 'Created'} agent-prompt junction for prompt ${promptEntity.ID}`);
             console.log(`✅ savePrompts: ${isJunctionUpdate ? 'Updated' : 'Created'} AIAgentPrompt junction with ID: ${agentPromptEntity.ID}`);
         }
-        console.log(`✅ savePrompts: Successfully saved all ${this.spec.Prompts.length} prompt(s)`);
+        console.log(`✅ savePrompts: Successfully saved all ${this.Spec.Prompts.length} prompt(s)`);
     }
     /**
      * Save all steps for this agent (Flow agents only).
@@ -1034,14 +1050,14 @@ export class AgentSpecSync {
      * @throws {Error} If any step save fails
      */
     async saveSteps(agentId) {
-        console.log(`🔷 saveSteps: Called with agentId=${agentId}, Steps=${this.spec.Steps ? this.spec.Steps.length : 'undefined'}`);
-        if (!this.spec.Steps || this.spec.Steps.length === 0) {
+        console.log(`🔷 saveSteps: Called with agentId=${agentId}, Steps=${this.Spec.Steps ? this.Spec.Steps.length : 'undefined'}`);
+        if (!this.Spec.Steps || this.Spec.Steps.length === 0) {
             console.log('🔷 saveSteps: No steps to save, returning early');
             return;
         }
-        console.log(`🔷 saveSteps: Processing ${this.spec.Steps.length} step(s)...`);
+        console.log(`🔷 saveSteps: Processing ${this.Spec.Steps.length} step(s)...`);
         const md = this.providerToUse;
-        for (const stepSpec of this.spec.Steps) {
+        for (const stepSpec of this.Spec.Steps) {
             const stepEntity = await md.GetEntityObject('MJ: AI Agent Steps', this._contextUser);
             // Load existing if ID provided
             const isUpdate = !!(stepSpec.ID && stepSpec.ID !== '');
@@ -1116,7 +1132,7 @@ export class AgentSpecSync {
             }
             const saved = await stepEntity.Save();
             if (!saved) {
-                throw new Error(`Failed to save step "${stepSpec.Name}" for agent ${this.spec.Name}`);
+                throw new Error(`Failed to save step "${stepSpec.Name}" for agent ${this.Spec.Name}`);
             }
             // Track mutation
             this.trackMutation('AI Agent Steps', isUpdate ? 'Update' : 'Create', stepEntity.ID, `${isUpdate ? 'Updated' : 'Created'} step: ${stepSpec.Name}`);
@@ -1124,7 +1140,7 @@ export class AgentSpecSync {
             stepSpec.ID = stepEntity.ID;
             console.log(`✅ saveSteps: Created AIAgentStep with ID: ${stepEntity.ID}`);
         }
-        console.log(`✅ saveSteps: Successfully saved all ${this.spec.Steps.length} step(s)`);
+        console.log(`✅ saveSteps: Successfully saved all ${this.Spec.Steps.length} step(s)`);
     }
     /**
      * Save all step paths for this agent (Flow agents only).
@@ -1137,23 +1153,23 @@ export class AgentSpecSync {
      * @throws {Error} If any path save fails
      */
     async saveStepPaths(agentId) {
-        console.log(`🔶 saveStepPaths: Called with agentId=${agentId}, Paths=${this.spec.Paths ? this.spec.Paths.length : 'undefined'}`);
-        if (!this.spec.Paths || this.spec.Paths.length === 0) {
+        console.log(`🔶 saveStepPaths: Called with agentId=${agentId}, Paths=${this.Spec.Paths ? this.Spec.Paths.length : 'undefined'}`);
+        if (!this.Spec.Paths || this.Spec.Paths.length === 0) {
             console.log('🔶 saveStepPaths: No paths to save, returning early');
             return;
         }
-        console.log(`🔶 saveStepPaths: Processing ${this.spec.Paths.length} path(s)...`);
+        console.log(`🔶 saveStepPaths: Processing ${this.Spec.Paths.length} path(s)...`);
         const md = this.providerToUse;
         // Create a map of step names to IDs for easy lookup
         const stepNameToId = new Map();
-        if (this.spec.Steps) {
-            for (const step of this.spec.Steps) {
+        if (this.Spec.Steps) {
+            for (const step of this.Spec.Steps) {
                 if (step.ID) {
                     stepNameToId.set(step.Name, step.ID);
                 }
             }
         }
-        for (const pathSpec of this.spec.Paths) {
+        for (const pathSpec of this.Spec.Paths) {
             const pathEntity = await md.GetEntityObject('MJ: AI Agent Step Paths', this._contextUser);
             // Load existing if ID provided
             const isUpdate = !!(pathSpec.ID && pathSpec.ID !== '');
@@ -1188,7 +1204,7 @@ export class AgentSpecSync {
             pathSpec.ID = pathEntity.ID;
             console.log(`✅ saveStepPaths: Created AIAgentStepPath with ID: ${pathEntity.ID}`);
         }
-        console.log(`✅ saveStepPaths: Successfully saved all ${this.spec.Paths.length} path(s)`);
+        console.log(`✅ saveStepPaths: Successfully saved all ${this.Spec.Paths.length} path(s)`);
     }
     // ===== UTILITY METHODS =====
     /**
@@ -1283,24 +1299,32 @@ export class AgentSpecSync {
      * ```
      */
     toJSON() {
-        return { ...this.spec };
+        return { ...this.Spec };
     }
     /**
      * Check if this spec has unsaved changes.
      *
      * @returns True if there are unsaved changes, false otherwise
      */
-    get isDirty() {
+    get IsDirty() {
         return this._isDirty;
     }
+    /** @deprecated Use {@link IsDirty}. */
+    get isDirty() {
+        return this.IsDirty;
+    }
     /**
      * Check if this spec has been loaded from the database.
      *
      * @returns True if loaded from database, false if created in memory
      */
-    get isLoaded() {
+    get IsLoaded() {
         return this._isLoaded;
     }
+    /** @deprecated Use {@link IsLoaded}. */
+    get isLoaded() {
+        return this.IsLoaded;
+    }
     /**
      * Mark the spec as having changes.
      *
@@ -1316,9 +1340,13 @@ export class AgentSpecSync {
      * await spec.SaveToDatabase();
      * ```
      */
-    markDirty() {
+    MarkDirty() {
         this._isDirty = true;
     }
+    /** @deprecated Use {@link MarkDirty}. */
+    markDirty() {
+        return this.MarkDirty();
+    }
     /**
      * Mark the spec as having been loaded from the database.
      *
@@ -1336,9 +1364,13 @@ export class AgentSpecSync {
      * await childSync.SaveToDatabase();
      * ```
      */
-    markLoaded() {
+    MarkLoaded() {
         this._isLoaded = true;
     }
+    /** @deprecated Use {@link MarkLoaded}. */
+    markLoaded() {
+        return this.MarkLoaded();
+    }
     // ===== DELETE/ORPHAN METHODS =====
     /**
      * Load the current state of all agent-related records from the database.