@memberjunction/server 5.34.1 → 5.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "5.34.1",
+  "version": "5.35.0",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -27,73 +27,73 @@
     "@as-integrations/express5": "^1.0.0",
     "@graphql-tools/schema": "latest",
     "@graphql-tools/utils": "^11.0.0",
-    "@memberjunction/actions": "5.34.1",
-    "@memberjunction/actions-apollo": "5.34.1",
-    "@memberjunction/actions-base": "5.34.1",
-    "@memberjunction/actions-bizapps-accounting": "5.34.1",
-    "@memberjunction/actions-bizapps-crm": "5.34.1",
-    "@memberjunction/actions-bizapps-formbuilders": "5.34.1",
-    "@memberjunction/actions-bizapps-lms": "5.34.1",
-    "@memberjunction/actions-bizapps-social": "5.34.1",
-    "@memberjunction/ai": "5.34.1",
-    "@memberjunction/ai-agent-manager": "5.34.1",
-    "@memberjunction/ai-agent-manager-actions": "5.34.1",
-    "@memberjunction/ai-agents": "5.34.1",
-    "@memberjunction/ai-core-plus": "5.34.1",
-    "@memberjunction/ai-mcp-client": "5.34.1",
-    "@memberjunction/ai-prompts": "5.34.1",
-    "@memberjunction/ai-provider-bundle": "5.34.1",
-    "@memberjunction/ai-vector-sync": "5.34.1",
-    "@memberjunction/ai-vectordb": "5.34.1",
-    "@memberjunction/ai-vectors-pinecone": "5.34.1",
-    "@memberjunction/aiengine": "5.34.1",
-    "@memberjunction/api-keys": "5.34.1",
-    "@memberjunction/auth-providers": "5.34.1",
-    "@memberjunction/codegen-lib": "5.34.1",
-    "@memberjunction/communication-ms-graph": "5.34.1",
-    "@memberjunction/communication-sendgrid": "5.34.1",
-    "@memberjunction/communication-types": "5.34.1",
-    "@memberjunction/component-registry-client-sdk": "5.34.1",
-    "@memberjunction/computer-use-engine": "5.34.1",
-    "@memberjunction/config": "5.34.1",
-    "@memberjunction/core": "5.34.1",
-    "@memberjunction/core-actions": "5.34.1",
-    "@memberjunction/core-entities": "5.34.1",
-    "@memberjunction/core-entities-server": "5.34.1",
-    "@memberjunction/data-context": "5.34.1",
-    "@memberjunction/data-context-server": "5.34.1",
-    "@memberjunction/doc-utils": "5.34.1",
-    "@memberjunction/encryption": "5.34.1",
-    "@memberjunction/entity-communications-base": "5.34.1",
-    "@memberjunction/entity-communications-server": "5.34.1",
-    "@memberjunction/external-change-detection": "5.34.1",
-    "@memberjunction/generic-database-provider": "5.34.1",
-    "@memberjunction/global": "5.34.1",
-    "@memberjunction/graphql-dataprovider": "5.34.1",
-    "@memberjunction/integration-engine": "5.34.1",
-    "@memberjunction/integration-schema-builder": "5.34.1",
-    "@memberjunction/interactive-component-types": "5.34.1",
-    "@memberjunction/notifications": "5.34.1",
-    "@memberjunction/postgresql-dataprovider": "5.34.1",
-    "@memberjunction/queue": "5.34.1",
-    "@memberjunction/redis-provider": "5.34.1",
-    "@memberjunction/scheduling-actions": "5.34.1",
-    "@memberjunction/scheduling-base-types": "5.34.1",
-    "@memberjunction/scheduling-engine": "5.34.1",
-    "@memberjunction/scheduling-engine-base": "5.34.1",
-    "@memberjunction/schema-engine": "5.34.1",
-    "@memberjunction/search-engine": "5.34.1",
-    "@memberjunction/server-extensions-core": "5.34.1",
-    "@memberjunction/skip-types": "5.34.1",
-    "@memberjunction/sql-dialect": "5.34.1",
-    "@memberjunction/sqlserver-dataprovider": "5.34.1",
-    "@memberjunction/storage": "5.34.1",
-    "@memberjunction/tag-engine": "5.34.1",
-    "@memberjunction/tag-engine-base": "5.34.1",
-    "@memberjunction/templates": "5.34.1",
-    "@memberjunction/testing-engine": "5.34.1",
-    "@memberjunction/testing-engine-base": "5.34.1",
-    "@memberjunction/version-history": "5.34.1",
+    "@memberjunction/actions": "5.35.0",
+    "@memberjunction/actions-apollo": "5.35.0",
+    "@memberjunction/actions-base": "5.35.0",
+    "@memberjunction/actions-bizapps-accounting": "5.35.0",
+    "@memberjunction/actions-bizapps-crm": "5.35.0",
+    "@memberjunction/actions-bizapps-formbuilders": "5.35.0",
+    "@memberjunction/actions-bizapps-lms": "5.35.0",
+    "@memberjunction/actions-bizapps-social": "5.35.0",
+    "@memberjunction/ai": "5.35.0",
+    "@memberjunction/ai-agent-manager": "5.35.0",
+    "@memberjunction/ai-agent-manager-actions": "5.35.0",
+    "@memberjunction/ai-agents": "5.35.0",
+    "@memberjunction/ai-core-plus": "5.35.0",
+    "@memberjunction/ai-mcp-client": "5.35.0",
+    "@memberjunction/ai-prompts": "5.35.0",
+    "@memberjunction/ai-provider-bundle": "5.35.0",
+    "@memberjunction/ai-vector-sync": "5.35.0",
+    "@memberjunction/ai-vectordb": "5.35.0",
+    "@memberjunction/ai-vectors-pinecone": "5.35.0",
+    "@memberjunction/aiengine": "5.35.0",
+    "@memberjunction/api-keys": "5.35.0",
+    "@memberjunction/auth-providers": "5.35.0",
+    "@memberjunction/codegen-lib": "5.35.0",
+    "@memberjunction/communication-ms-graph": "5.35.0",
+    "@memberjunction/communication-sendgrid": "5.35.0",
+    "@memberjunction/communication-types": "5.35.0",
+    "@memberjunction/component-registry-client-sdk": "5.35.0",
+    "@memberjunction/computer-use-engine": "5.35.0",
+    "@memberjunction/config": "5.35.0",
+    "@memberjunction/core": "5.35.0",
+    "@memberjunction/core-actions": "5.35.0",
+    "@memberjunction/core-entities": "5.35.0",
+    "@memberjunction/core-entities-server": "5.35.0",
+    "@memberjunction/data-context": "5.35.0",
+    "@memberjunction/data-context-server": "5.35.0",
+    "@memberjunction/doc-utils": "5.35.0",
+    "@memberjunction/encryption": "5.35.0",
+    "@memberjunction/entity-communications-base": "5.35.0",
+    "@memberjunction/entity-communications-server": "5.35.0",
+    "@memberjunction/external-change-detection": "5.35.0",
+    "@memberjunction/generic-database-provider": "5.35.0",
+    "@memberjunction/global": "5.35.0",
+    "@memberjunction/graphql-dataprovider": "5.35.0",
+    "@memberjunction/integration-engine": "5.35.0",
+    "@memberjunction/integration-schema-builder": "5.35.0",
+    "@memberjunction/interactive-component-types": "5.35.0",
+    "@memberjunction/notifications": "5.35.0",
+    "@memberjunction/postgresql-dataprovider": "5.35.0",
+    "@memberjunction/queue": "5.35.0",
+    "@memberjunction/redis-provider": "5.35.0",
+    "@memberjunction/scheduling-actions": "5.35.0",
+    "@memberjunction/scheduling-base-types": "5.35.0",
+    "@memberjunction/scheduling-engine": "5.35.0",
+    "@memberjunction/scheduling-engine-base": "5.35.0",
+    "@memberjunction/schema-engine": "5.35.0",
+    "@memberjunction/search-engine": "5.35.0",
+    "@memberjunction/server-extensions-core": "5.35.0",
+    "@memberjunction/skip-types": "5.35.0",
+    "@memberjunction/sql-dialect": "5.35.0",
+    "@memberjunction/sqlserver-dataprovider": "5.35.0",
+    "@memberjunction/storage": "5.35.0",
+    "@memberjunction/tag-engine": "5.35.0",
+    "@memberjunction/tag-engine-base": "5.35.0",
+    "@memberjunction/templates": "5.35.0",
+    "@memberjunction/testing-engine": "5.35.0",
+    "@memberjunction/testing-engine-base": "5.35.0",
+    "@memberjunction/version-history": "5.35.0",
     "@types/compression": "^1.8.1",
     "@types/cors": "^2.8.19",
     "@types/jsonwebtoken": "9.0.10",

package/src/generated/generated.ts

@@ -7094,7 +7094,7 @@ export class MJAIAgentRunStep_ {
     @Field(() => Int, {description: `Sequential number of this step within the agent run, starting from 1`}) 
     StepNumber: number;
         
-    @Field({description: `Type of execution step: Prompt, Actions, Sub-Agent, Decision, Chat, Validation`}) 
+    @Field({description: `Type of execution step: Prompt, Actions, Sub-Agent, Decision, Chat, Validation, ForEach, While, Tool`}) 
     @MaxLength(50)
     StepType: string;
         
@@ -9453,6 +9453,9 @@ if this limit is exceeded.`})
     @MaxLength(20)
     SearchScopeAccess: string;
         
+    @Field(() => Boolean, {description: `Per-agent opt-in to a Generic Binary fallback for file uploads whose MIME type does not match any registered Artifact Type. When false (default), unrecognized uploads are rejected at upload time with an actionable error. When true, unrecognized uploads resolve to the Generic Binary artifact type, exposing only get_full and get_metadata tools. Scoped per agent — there is no system-wide global flag.`}) 
+    AcceptUnregisteredFiles: boolean;
+        
     @Field({nullable: true}) 
     @MaxLength(255)
     Parent?: string;
@@ -9763,6 +9766,9 @@ export class CreateMJAIAgentInput {
     @Field({ nullable: true })
     SearchScopeAccess?: string;
 
+    @Field(() => Boolean, { nullable: true })
+    AcceptUnregisteredFiles?: boolean;
+
     @Field(() => RestoreContextInput, { nullable: true })
     RestoreContext___?: RestoreContextInput;
 }
@@ -9962,6 +9968,9 @@ export class UpdateMJAIAgentInput {
     @Field({ nullable: true })
     SearchScopeAccess?: string;
 
+    @Field(() => Boolean, { nullable: true })
+    AcceptUnregisteredFiles?: boolean;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 
@@ -21569,6 +21578,16 @@ export class MJArtifactType_ {
     @MaxLength(100)
     ToolLibraryClass?: string;
         
+    @Field(() => Int, {description: `Deterministic tiebreaker when multiple Artifact Types match the same MIME pattern. Higher values win. Within a specificity tier (exact > subtype-wildcard), the resolver sorts by Priority desc, then SystemSupplied = false beats SystemSupplied = true, then lowest ID wins.`}) 
+    Priority: number;
+        
+    @Field({description: `How artifacts of this type are delivered to the LLM by default. Inline: emitted as an inline content block (image_url, audio_url, small text, etc.) when the model supports the modality and the size is under the inline cap. ToolsOnly: never inlined; the agent reaches the bytes only through tool calls (get_full, library-specific tools). Per-instance override is one-way via ConversationArtifactVersion.ForceToolsOnly — an instance can opt out of inline but never opt in when the type default is ToolsOnly.`}) 
+    @MaxLength(20)
+    DefaultDeliveryMode: string;
+        
+    @Field(() => Boolean, {description: `True for Artifact Types shipped as part of the MemberJunction default registry (JSON, PDF, Office variants, Image/Audio/Video, Generic Text, Generic Binary). False for user/org-supplied customizations. Used as a tiebreaker in MIME pattern resolution: user customizations win over shipped defaults at equal Priority.`}) 
+    SystemSupplied: boolean;
+        
     @Field({nullable: true}) 
     @MaxLength(100)
     Parent?: string;
@@ -21632,6 +21651,15 @@ export class CreateMJArtifactTypeInput {
     @Field({ nullable: true })
     ToolLibraryClass: string | null;
 
+    @Field(() => Int, { nullable: true })
+    Priority?: number;
+
+    @Field({ nullable: true })
+    DefaultDeliveryMode?: string;
+
+    @Field(() => Boolean, { nullable: true })
+    SystemSupplied?: boolean;
+
     @Field(() => RestoreContextInput, { nullable: true })
     RestoreContext___?: RestoreContextInput;
 }
@@ -21675,6 +21703,15 @@ export class UpdateMJArtifactTypeInput {
     @Field({ nullable: true })
     ToolLibraryClass?: string | null;
 
+    @Field(() => Int, { nullable: true })
+    Priority?: number;
+
+    @Field({ nullable: true })
+    DefaultDeliveryMode?: string;
+
+    @Field(() => Boolean, { nullable: true })
+    SystemSupplied?: boolean;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 
@@ -22245,6 +22282,9 @@ export class MJArtifactVersion_ {
     @Field(() => Int, {nullable: true, description: `Size of the stored file in bytes. Denormalized for display without loading the file. Only populated when ContentMode is 'File'.`}) 
     ContentSizeBytes?: number;
         
+    @Field(() => Boolean, {description: `One-way override that forces this artifact version to be delivered via tools regardless of the Artifact Type's DefaultDeliveryMode. When true, the resolver never emits an inline content block for this version. There is no inverse override — an instance cannot be widened from ToolsOnly to Inline. Default false.`}) 
+    ForceToolsOnly: boolean;
+        
     @Field() 
     @MaxLength(255)
     Artifact: string;
@@ -22269,6 +22309,9 @@ export class MJArtifactVersion_ {
     @Field(() => [MJConversationDetailArtifact_])
     MJConversationDetailArtifacts_ArtifactVersionIDArray: MJConversationDetailArtifact_[]; // Link to MJConversationDetailArtifacts
     
+    @Field(() => [MJConversationDetailAttachment_])
+    MJConversationDetailAttachments_ArtifactVersionIDArray: MJConversationDetailAttachment_[]; // Link to MJConversationDetailAttachments
+    
 }
 
 //****************************************************************************
@@ -22321,6 +22364,9 @@ export class CreateMJArtifactVersionInput {
     @Field(() => Int, { nullable: true })
     ContentSizeBytes: number | null;
 
+    @Field(() => Boolean, { nullable: true })
+    ForceToolsOnly?: boolean;
+
     @Field(() => RestoreContextInput, { nullable: true })
     RestoreContext___?: RestoreContextInput;
 }
@@ -22376,6 +22422,9 @@ export class UpdateMJArtifactVersionInput {
     @Field(() => Int, { nullable: true })
     ContentSizeBytes?: number | null;
 
+    @Field(() => Boolean, { nullable: true })
+    ForceToolsOnly?: boolean;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 
@@ -22480,6 +22529,16 @@ export class MJArtifactVersionResolver extends ResolverBase {
         return result;
     }
         
+    @FieldResolver(() => [MJConversationDetailAttachment_])
+    async MJConversationDetailAttachments_ArtifactVersionIDArray(@Root() mjartifactversion_: MJArtifactVersion_, @Ctx() { userPayload, providers }: AppContext, @PubSub() pubSub: PubSubEngine) {
+        this.CheckUserReadPermissions('MJ: Conversation Detail Attachments', userPayload);
+        const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
+        const sSQL = `SELECT * FROM ${provider.QuoteSchemaAndView(Metadata.Provider.ConfigData.MJCoreSchemaName, 'vwConversationDetailAttachments')} WHERE ${provider.QuoteIdentifier('ArtifactVersionID')}='${mjartifactversion_.ID}' ` + this.getRowLevelSecurityWhereClause(provider, 'MJ: Conversation Detail Attachments', userPayload, EntityPermissionType.Read, 'AND');
+        const rows = await provider.ExecuteSQL(sSQL, undefined, undefined, this.GetUserFromPayload(userPayload));
+        const result = await this.ArrayMapFieldNamesToCodeNames('MJ: Conversation Detail Attachments', rows, this.GetUserFromPayload(userPayload));
+        return result;
+    }
+        
     @Mutation(() => MJArtifactVersion_)
     async CreateMJArtifactVersion(
         @Arg('input', () => CreateMJArtifactVersionInput) input: CreateMJArtifactVersionInput,
@@ -32828,6 +32887,10 @@ export class MJConversationDetailAttachment_ {
     @Field({nullable: true, description: `Description of the attachment providing context about its content and purpose.`}) 
     Description?: string;
         
+    @Field({nullable: true, description: `Foreign key to the ArtifactVersion created alongside this attachment by the storage-unification path. When set, the agent resolver routes via the artifact path (manifest + tool dispatch) and skips inline embedding of the attachment to avoid double-processing. NULL for pre-v5.35 attachment rows authored before storage unification.`}) 
+    @MaxLength(36)
+    ArtifactVersionID?: string;
+        
     @Field() 
     ConversationDetail: string;
         
@@ -32839,6 +32902,10 @@ export class MJConversationDetailAttachment_ {
     @MaxLength(500)
     File?: string;
         
+    @Field({nullable: true}) 
+    @MaxLength(255)
+    ArtifactVersion?: string;
+        
 }
 
 //****************************************************************************
@@ -32888,6 +32955,9 @@ export class CreateMJConversationDetailAttachmentInput {
     @Field({ nullable: true })
     Description: string | null;
 
+    @Field({ nullable: true })
+    ArtifactVersionID: string | null;
+
     @Field(() => RestoreContextInput, { nullable: true })
     RestoreContext___?: RestoreContextInput;
 }
@@ -32940,6 +33010,9 @@ export class UpdateMJConversationDetailAttachmentInput {
     @Field({ nullable: true })
     Description?: string | null;
 
+    @Field({ nullable: true })
+    ArtifactVersionID?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 
@@ -60908,7 +60981,7 @@ export class MJRecordGeoCode_ {
     @Field({nullable: true, description: `Timestamp of when geocoding was last attempted (success or failure).`}) 
     GeocodedAt?: Date;
         
-    @Field({nullable: true, description: `How this geocode was produced: google (Google Geocoding API), reference_data (resolved via Country/StateProvince tables), manual (user-entered), ip_geolocation (IP lookup), native (copied from entity lat/lng fields), reverse (reverse geocode from coordinates).`}) 
+    @Field({nullable: true, description: `Source that produced this geocode. One of: google, geocodio, here, reference_data, manual, ip_geolocation, native, reverse.`}) 
     @MaxLength(30)
     GeocodingSource?: string;
         

package/src/generic/ResolverBase.ts

@@ -359,7 +359,8 @@ export class ResolverBase {
           viewInput.Aggregates,
           viewInput.AfterKey
             ? CompositeKey.FromKeyValuePairs((viewInput.AfterKey as { KeyValuePairs: { FieldName: string; Value: string }[] }).KeyValuePairs)
-            : undefined
+            : undefined,
+          viewInput.BypassCache
         );
       }
       else {
@@ -400,7 +401,9 @@ export class ResolverBase {
         userPayload,
         viewInput.MaxRows,
         viewInput.StartRow,
-        viewInput.Aggregates
+        viewInput.Aggregates,
+        undefined,
+        viewInput.BypassCache
       );
     } catch (err) {
       console.log(err);
@@ -444,7 +447,9 @@ export class ResolverBase {
         userPayload,
         viewInput.MaxRows,
         viewInput.StartRow,
-        viewInput.Aggregates
+        viewInput.Aggregates,
+        undefined,
+        viewInput.BypassCache
       );
     } catch (err) {
       console.log(err);
@@ -517,6 +522,7 @@ export class ResolverBase {
           resultType: viewInput.ResultType,
           userPayload,
           aggregates: viewInput.Aggregates,
+          bypassCache: viewInput.BypassCache,
         });
       } catch (err) {
         LogError(err);
@@ -693,7 +699,8 @@ export class ResolverBase {
     maxRows: number | undefined,
     startRow: number | undefined,
     aggregates?: AggregateExpression[],
-    afterKey?: CompositeKey
+    afterKey?: CompositeKey,
+    bypassCache?: boolean
   ) {
     try {
       if (!viewInfo || !userPayload) return null;
@@ -757,6 +764,7 @@ export class ResolverBase {
           AuditLogDescription: auditLogDescription,
           ResultType: rt,
           Aggregates: aggregates,
+          BypassCache: bypassCache,
         },
         user
       );
@@ -870,6 +878,7 @@ export class ResolverBase {
           AuditLogDescription: param.auditLogDescription,
           ResultType: rt,
           Aggregates: param.aggregates,
+          BypassCache: param.bypassCache,
         });
       }
 

package/src/generic/RunViewResolver.ts

@@ -170,6 +170,13 @@ export class RunViewByIDInput {
     description: 'Optional aggregate expressions to calculate on the full result set (e.g., SUM, COUNT, AVG). Results are returned in AggregateResults.',
   })
   Aggregates?: AggregateExpressionInput[];
+
+  @Field(() => Boolean, {
+    nullable: true,
+    description:
+      'Optional, when true bypasses ALL server-side caching for this view run — the pre-check cache lookup is skipped and the result is not stored in the cache. Use for maintenance/audit queries that must see true database state, or to force-refresh views whose filters reference rows the server cache invalidator cannot follow (e.g., cross-entity subqueries against vwListDetails).',
+  })
+  BypassCache?: boolean;
 }
 
 @InputType()
@@ -277,6 +284,13 @@ export class RunViewByNameInput {
     description: 'Optional aggregate expressions to calculate on the full result set (e.g., SUM, COUNT, AVG). Results are returned in AggregateResults.',
   })
   Aggregates?: AggregateExpressionInput[];
+
+  @Field(() => Boolean, {
+    nullable: true,
+    description:
+      'Optional, when true bypasses ALL server-side caching for this view run — the pre-check cache lookup is skipped and the result is not stored in the cache. Use for maintenance/audit queries that must see true database state, or to force-refresh views whose filters reference rows the server cache invalidator cannot follow (e.g., cross-entity subqueries against vwListDetails).',
+  })
+  BypassCache?: boolean;
 }
 
 @InputType()
@@ -370,6 +384,13 @@ export class RunDynamicViewInput {
     description: 'Optional aggregate expressions to calculate on the full result set (e.g., SUM, COUNT, AVG). Results are returned in AggregateResults.',
   })
   Aggregates?: AggregateExpressionInput[];
+
+  @Field(() => Boolean, {
+    nullable: true,
+    description:
+      'Optional, when true bypasses ALL server-side caching for this view run — the pre-check cache lookup is skipped and the result is not stored in the cache. Use for maintenance/audit queries that must see true database state, or to force-refresh views whose filters reference rows the server cache invalidator cannot follow (e.g., cross-entity subqueries against vwListDetails).',
+  })
+  BypassCache?: boolean;
 }
 
 @InputType()
@@ -492,6 +513,13 @@ export class RunViewGenericInput {
     description: 'Optional aggregate expressions to calculate on the full result set (e.g., SUM, COUNT, AVG). Results are returned in AggregateResults.',
   })
   Aggregates?: AggregateExpressionInput[];
+
+  @Field(() => Boolean, {
+    nullable: true,
+    description:
+      'Optional, when true bypasses ALL server-side caching for this view run — the pre-check cache lookup is skipped and the result is not stored in the cache. Use for maintenance/audit queries that must see true database state, or to force-refresh views whose filters reference rows the server cache invalidator cannot follow (e.g., cross-entity subqueries against vwListDetails).',
+  })
+  BypassCache?: boolean;
 }
 
 //****************************************************************************