@memberjunction/server 5.22.0 → 5.23.0

package/README.md

@@ -958,9 +958,44 @@ This package includes GraphQL resolvers for the Knowledge Hub:
 - **`SearchKnowledgeResolver`** — Unified search combining vector similarity (Pinecone) with full-text search via `Metadata.FullTextSearch()` and RRF fusion
 - **`VectorizeEntityResolver`** — Triggers entity vectorization via `EntityVectorSyncer`
 - **`PipelineProgressResolver`** — GraphQL subscription for real-time pipeline progress
+- **`FetchEntityVectorsResolver`** — Retrieves vectors and metadata from the vector database for a given entity document
 
 See the **[Full-Text Search Guide](../MJCore/docs/FULL_TEXT_SEARCH_GUIDE.md)** for the complete FTS architecture.
 
+### FetchEntityVectorsResolver
+
+Fetches vectors and their associated metadata from a vector database (e.g., Pinecone) for a specific entity document. Used by the clustering dashboard to obtain raw vectors for visualization.
+
+**How it works:** The resolver performs a zero-vector query against the vector index with an entity metadata filter (`Entity: { $eq: entityName }`). Since the query vector is all zeros, similarity scores are meaningless -- the purpose is purely to retrieve vectors matching the entity filter. This approach is used because Pinecone's list API does not support metadata filtering, but the query API does.
+
+```graphql
+query {
+  FetchEntityVectors(
+    entityDocumentID: "doc-uuid"
+    maxRecords: 500
+    filter: ""
+  ) {
+    Success
+    Results {
+      ID
+      Values
+      Metadata
+    }
+    TotalCount
+    ElapsedMs
+    ErrorMessage
+  }
+}
+```
+
+| Argument | Type | Default | Description |
+|---|---|---|---|
+| `entityDocumentID` | `String!` | -- | The entity document whose vector index to query |
+| `maxRecords` | `Int` | `1000` | Maximum number of vectors to return |
+| `filter` | `String` | -- | Reserved for future metadata filter extensions |
+
+The resolver resolves the vector index for the entity document using a fallback chain: explicit `VectorIndexID` on the document, then matching by `VectorDatabaseID` + `EmbeddingModelID`.
+
 ## Contributing
 
 See the [MemberJunction Contributing Guide](../../CONTRIBUTING.md) for development setup and guidelines.

package/dist/generated/generated.d.ts

@@ -817,6 +817,50 @@ export declare class MJAIAgentCategoryResolver extends ResolverBase {
     UpdateMJAIAgentCategory(input: UpdateMJAIAgentCategoryInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     DeleteMJAIAgentCategory(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
 }
+export declare class MJAIAgentClientTool_ {
+    ID: string;
+    AgentID: string;
+    ClientToolDefinitionID: string;
+    IsRequired: boolean;
+    Priority: number;
+    _mj__CreatedAt: Date;
+    _mj__UpdatedAt: Date;
+    Agent?: string;
+    ClientToolDefinition: string;
+}
+export declare class CreateMJAIAgentClientToolInput {
+    ID?: string;
+    AgentID?: string;
+    ClientToolDefinitionID?: string;
+    IsRequired?: boolean;
+    Priority?: number;
+}
+export declare class UpdateMJAIAgentClientToolInput {
+    ID: string;
+    AgentID?: string;
+    ClientToolDefinitionID?: string;
+    IsRequired?: boolean;
+    Priority?: number;
+    OldValues___?: KeyValuePairInput[];
+}
+export declare class RunMJAIAgentClientToolViewResult {
+    Results: MJAIAgentClientTool_[];
+    UserViewRunID?: string;
+    RowCount: number;
+    TotalRowCount: number;
+    ExecutionTime: number;
+    ErrorMessage?: string;
+    Success: boolean;
+}
+export declare class MJAIAgentClientToolResolver extends ResolverBase {
+    RunMJAIAgentClientToolViewByID(input: RunViewByIDInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    RunMJAIAgentClientToolViewByName(input: RunViewByNameInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    RunMJAIAgentClientToolDynamicView(input: RunDynamicViewInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    MJAIAgentClientTool(ID: string, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<MJAIAgentClientTool_ | null>;
+    CreateMJAIAgentClientTool(input: CreateMJAIAgentClientToolInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+    UpdateMJAIAgentClientTool(input: UpdateMJAIAgentClientToolInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+    DeleteMJAIAgentClientTool(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+}
 export declare class MJAIAgentConfiguration_ {
     ID: string;
     AgentID: string;
@@ -2300,6 +2344,7 @@ export declare class MJAIAgent_ {
     AutoArchiveEnabled: boolean;
     RerankerConfiguration?: string;
     CategoryID?: string;
+    AllowEphemeralClientTools: boolean;
     Parent?: string;
     ContextCompressionPrompt?: string;
     Type?: string;
@@ -2318,6 +2363,7 @@ export declare class MJAIAgent_ {
     MJAIAgentPermissions_AgentIDArray: MJAIAgentPermission_[];
     MJAIAgentDataSources_AgentIDArray: MJAIAgentDataSource_[];
     MJAIAgentModalities_AgentIDArray: MJAIAgentModality_[];
+    MJAIAgentClientTools_AgentIDArray: MJAIAgentClientTool_[];
     MJAIAgentNotes_AgentIDArray: MJAIAgentNote_[];
     MJAIAgentPrompts_AgentIDArray: MJAIAgentPrompt_[];
     MJAIAgentRuns_AgentIDArray: MJAIAgentRun_[];
@@ -2392,6 +2438,7 @@ export declare class CreateMJAIAgentInput {
     AutoArchiveEnabled?: boolean;
     RerankerConfiguration: string | null;
     CategoryID: string | null;
+    AllowEphemeralClientTools?: boolean;
 }
 export declare class UpdateMJAIAgentInput {
     ID: string;
@@ -2454,6 +2501,7 @@ export declare class UpdateMJAIAgentInput {
     AutoArchiveEnabled?: boolean;
     RerankerConfiguration?: string | null;
     CategoryID?: string | null;
+    AllowEphemeralClientTools?: boolean;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJAIAgentViewResult {
@@ -2480,6 +2528,7 @@ export declare class MJAIAgentResolver extends ResolverBase {
     MJAIAgentPermissions_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentDataSources_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentModalities_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJAIAgentClientTools_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentNotes_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentPrompts_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentRuns_AgentIDArray(mjaiagent_: MJAIAgent_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
@@ -2553,6 +2602,59 @@ export declare class MJAIArchitectureResolver extends ResolverBase {
     UpdateMJAIArchitecture(input: UpdateMJAIArchitectureInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     DeleteMJAIArchitecture(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
 }
+export declare class MJAIClientToolDefinition_ {
+    ID: string;
+    Name: string;
+    Description: string;
+    Category?: string;
+    InputSchemaJSON?: string;
+    OutputSchemaJSON?: string;
+    DefaultTimeoutMs?: number;
+    RequiresContextType?: string;
+    _mj__CreatedAt: Date;
+    _mj__UpdatedAt: Date;
+    MJAIAgentClientTools_ClientToolDefinitionIDArray: MJAIAgentClientTool_[];
+}
+export declare class CreateMJAIClientToolDefinitionInput {
+    ID?: string;
+    Name?: string;
+    Description?: string;
+    Category: string | null;
+    InputSchemaJSON: string | null;
+    OutputSchemaJSON: string | null;
+    DefaultTimeoutMs?: number | null;
+    RequiresContextType: string | null;
+}
+export declare class UpdateMJAIClientToolDefinitionInput {
+    ID: string;
+    Name?: string;
+    Description?: string;
+    Category?: string | null;
+    InputSchemaJSON?: string | null;
+    OutputSchemaJSON?: string | null;
+    DefaultTimeoutMs?: number | null;
+    RequiresContextType?: string | null;
+    OldValues___?: KeyValuePairInput[];
+}
+export declare class RunMJAIClientToolDefinitionViewResult {
+    Results: MJAIClientToolDefinition_[];
+    UserViewRunID?: string;
+    RowCount: number;
+    TotalRowCount: number;
+    ExecutionTime: number;
+    ErrorMessage?: string;
+    Success: boolean;
+}
+export declare class MJAIClientToolDefinitionResolver extends ResolverBase {
+    RunMJAIClientToolDefinitionViewByID(input: RunViewByIDInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    RunMJAIClientToolDefinitionViewByName(input: RunViewByNameInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    RunMJAIClientToolDefinitionDynamicView(input: RunDynamicViewInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
+    MJAIClientToolDefinition(ID: string, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<MJAIClientToolDefinition_ | null>;
+    MJAIAgentClientTools_ClientToolDefinitionIDArray(mjaiclienttooldefinition_: MJAIClientToolDefinition_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    CreateMJAIClientToolDefinition(input: CreateMJAIClientToolDefinitionInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+    UpdateMJAIClientToolDefinition(input: UpdateMJAIClientToolDefinitionInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+    DeleteMJAIClientToolDefinition(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
+}
 export declare class MJAIConfigurationParam_ {
     ID: string;
     ConfigurationID: string;
@@ -3274,7 +3376,9 @@ export declare class MJAIModel_ {
     MJAIModelVendors_ModelIDArray: MJAIModelVendor_[];
     MJGeneratedCodes_GeneratedByModelIDArray: MJGeneratedCode_[];
     MJAIModelCosts_ModelIDArray: MJAIModelCost_[];
+    MJContentTypes_EmbeddingModelIDArray: MJContentType_[];
     MJAIPromptModels_ModelIDArray: MJAIPromptModel_[];
+    MJContentSources_EmbeddingModelIDArray: MJContentSource_[];
     MJAIPromptRuns_OriginalModelIDArray: MJAIPromptRun_[];
     MJAIAgentRuns_OverrideModelIDArray: MJAIAgentRun_[];
     MJQueries_EmbeddingModelIDArray: MJQuery_[];
@@ -3356,7 +3460,9 @@ export declare class MJAIModelResolver extends ResolverBase {
     MJAIModelVendors_ModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJGeneratedCodes_GeneratedByModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIModelCosts_ModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJContentTypes_EmbeddingModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIPromptModels_ModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJContentSources_EmbeddingModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIPromptRuns_OriginalModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJAIAgentRuns_OverrideModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJQueries_EmbeddingModelIDArray(mjaimodel_: MJAIModel_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
@@ -6837,17 +6943,20 @@ export declare class MJContentItemTag_ {
     Tag: string;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    Weight: number;
     Item?: string;
 }
 export declare class CreateMJContentItemTagInput {
     ID?: string;
     ItemID?: string;
     Tag?: string;
+    Weight?: number;
 }
 export declare class UpdateMJContentItemTagInput {
     ID: string;
     ItemID?: string;
     Tag?: string;
+    Weight?: number;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJContentItemTagViewResult {
@@ -7113,9 +7222,13 @@ export declare class MJContentSource_ {
     URL: string;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    EmbeddingModelID?: string;
+    VectorIndexID?: string;
     ContentType: string;
     ContentSourceType: string;
     ContentFileType: string;
+    EmbeddingModel?: string;
+    VectorIndex?: string;
     MJContentItems_ContentSourceIDArray: MJContentItem_[];
     MJContentProcessRuns_SourceIDArray: MJContentProcessRun_[];
     MJContentSourceParams_ContentSourceIDArray: MJContentSourceParam_[];
@@ -7127,6 +7240,8 @@ export declare class CreateMJContentSourceInput {
     ContentSourceTypeID?: string;
     ContentFileTypeID?: string;
     URL?: string;
+    EmbeddingModelID: string | null;
+    VectorIndexID: string | null;
 }
 export declare class UpdateMJContentSourceInput {
     ID: string;
@@ -7135,6 +7250,8 @@ export declare class UpdateMJContentSourceInput {
     ContentSourceTypeID?: string;
     ContentFileTypeID?: string;
     URL?: string;
+    EmbeddingModelID?: string | null;
+    VectorIndexID?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJContentSourceViewResult {
@@ -7209,7 +7326,11 @@ export declare class MJContentType_ {
     MaxTags: number;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    EmbeddingModelID?: string;
+    VectorIndexID?: string;
     AIModel: string;
+    EmbeddingModel?: string;
+    VectorIndex?: string;
     MJContentSources_ContentTypeIDArray: MJContentSource_[];
     MJContentItems_ContentTypeIDArray: MJContentItem_[];
 }
@@ -7220,6 +7341,8 @@ export declare class CreateMJContentTypeInput {
     AIModelID?: string;
     MinTags?: number;
     MaxTags?: number;
+    EmbeddingModelID: string | null;
+    VectorIndexID: string | null;
 }
 export declare class UpdateMJContentTypeInput {
     ID: string;
@@ -7228,6 +7351,8 @@ export declare class UpdateMJContentTypeInput {
     AIModelID?: string;
     MinTags?: number;
     MaxTags?: number;
+    EmbeddingModelID?: string | null;
+    VectorIndexID?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJContentTypeViewResult {
@@ -8602,6 +8727,7 @@ export declare class MJDuplicateRunDetailMatch_ {
     MergedAt: Date;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    RecordMetadata?: string;
     DuplicateRunDetail: string;
     RecordMergeLog?: string;
 }
@@ -8617,6 +8743,7 @@ export declare class CreateMJDuplicateRunDetailMatchInput {
     RecordMergeLogID: string | null;
     MergeStatus?: string;
     MergedAt?: Date;
+    RecordMetadata: string | null;
 }
 export declare class UpdateMJDuplicateRunDetailMatchInput {
     ID: string;
@@ -8630,6 +8757,7 @@ export declare class UpdateMJDuplicateRunDetailMatchInput {
     RecordMergeLogID?: string | null;
     MergeStatus?: string;
     MergedAt?: Date;
+    RecordMetadata?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJDuplicateRunDetailMatchViewResult {
@@ -8661,6 +8789,7 @@ export declare class MJDuplicateRunDetail_ {
     MergeErrorMessage?: string;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    RecordMetadata?: string;
     DuplicateRun: string;
     MJDuplicateRunDetailMatches_DuplicateRunDetailIDArray: MJDuplicateRunDetailMatch_[];
 }
@@ -8673,6 +8802,7 @@ export declare class CreateMJDuplicateRunDetailInput {
     MatchErrorMessage: string | null;
     MergeStatus?: string;
     MergeErrorMessage: string | null;
+    RecordMetadata: string | null;
 }
 export declare class UpdateMJDuplicateRunDetailInput {
     ID: string;
@@ -8683,6 +8813,7 @@ export declare class UpdateMJDuplicateRunDetailInput {
     MatchErrorMessage?: string | null;
     MergeStatus?: string;
     MergeErrorMessage?: string | null;
+    RecordMetadata?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJDuplicateRunDetailViewResult {
@@ -8708,7 +8839,7 @@ export declare class MJDuplicateRun_ {
     ID: string;
     EntityID: string;
     StartedByUserID: string;
-    SourceListID: string;
+    SourceListID?: string;
     StartedAt: Date;
     EndedAt?: Date;
     ApprovalStatus: string;
@@ -8720,7 +8851,7 @@ export declare class MJDuplicateRun_ {
     _mj__UpdatedAt: Date;
     Entity: string;
     StartedByUser: string;
-    SourceList: string;
+    SourceList?: string;
     ApprovedByUser?: string;
     MJDuplicateRunDetails_DuplicateRunIDArray: MJDuplicateRunDetail_[];
 }
@@ -8728,7 +8859,7 @@ export declare class CreateMJDuplicateRunInput {
     ID?: string;
     EntityID?: string;
     StartedByUserID?: string;
-    SourceListID?: string;
+    SourceListID: string | null;
     StartedAt?: Date;
     EndedAt: Date | null;
     ApprovalStatus?: string;
@@ -8741,7 +8872,7 @@ export declare class UpdateMJDuplicateRunInput {
     ID: string;
     EntityID?: string;
     StartedByUserID?: string;
-    SourceListID?: string;
+    SourceListID?: string | null;
     StartedAt?: Date;
     EndedAt?: Date | null;
     ApprovalStatus?: string;
@@ -10117,6 +10248,9 @@ export declare class MJEntityField_ {
     IsSoftPrimaryKey: boolean;
     IsSoftForeignKey: boolean;
     RelatedEntityJoinFields?: string;
+    JSONType?: string;
+    JSONTypeIsArray: boolean;
+    JSONTypeDefinition?: string;
     FieldCodeName?: string;
     Entity: string;
     SchemaName: string;
@@ -10176,6 +10310,9 @@ export declare class CreateMJEntityFieldInput {
     IsSoftPrimaryKey?: boolean;
     IsSoftForeignKey?: boolean;
     RelatedEntityJoinFields: string | null;
+    JSONType: string | null;
+    JSONTypeIsArray?: boolean;
+    JSONTypeDefinition: string | null;
 }
 export declare class UpdateMJEntityFieldInput {
     ID: string;
@@ -10221,6 +10358,9 @@ export declare class UpdateMJEntityFieldInput {
     IsSoftPrimaryKey?: boolean;
     IsSoftForeignKey?: boolean;
     RelatedEntityJoinFields?: string | null;
+    JSONType?: string | null;
+    JSONTypeIsArray?: boolean;
+    JSONTypeDefinition?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunMJEntityFieldViewResult {
@@ -17463,6 +17603,8 @@ export declare class MJVectorIndex_ {
     EmbeddingModel: string;
     MJEntityRecordDocuments_VectorIndexIDArray: MJEntityRecordDocument_[];
     MJEntityDocuments_VectorIndexIDArray: MJEntityDocument_[];
+    MJContentTypes_VectorIndexIDArray: MJContentType_[];
+    MJContentSources_VectorIndexIDArray: MJContentSource_[];
 }
 export declare class CreateMJVectorIndexInput {
     ID?: string;
@@ -17503,6 +17645,8 @@ export declare class MJVectorIndexResolver extends ResolverBase {
     MJVectorIndex(ID: string, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<MJVectorIndex_ | null>;
     MJEntityRecordDocuments_VectorIndexIDArray(mjvectorindex_: MJVectorIndex_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJEntityDocuments_VectorIndexIDArray(mjvectorindex_: MJVectorIndex_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJContentTypes_VectorIndexIDArray(mjvectorindex_: MJVectorIndex_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJContentSources_VectorIndexIDArray(mjvectorindex_: MJVectorIndex_, { userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     CreateMJVectorIndex(input: CreateMJVectorIndexInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     UpdateMJVectorIndex(input: UpdateMJVectorIndexInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     DeleteMJVectorIndex(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;