@salesforce/lds-adapters-service-einsteinllm 1.383.0 → 1.385.0

package/src/raml/api.raml

@@ -6,7 +6,7 @@ version: '62.0'
 mediaType: application/json
 protocols:
   - https
-baseUri: /services/data/v65.0
+baseUri: /services/data/v66.0
 securitySchemes:
   OAuth2:
     type: OAuth 2.0
@@ -467,6 +467,10 @@ types:
     description: Output of a einstein llm generations response for given prompt template
     type: object
     properties:
+      citations:
+        description: Generation Citations Mapping
+        required: false # TODO Hand-rolled W-19304625
+        type: EinsteinLlmGenerationCitationRepresentation
       generationErrors:
         description: generated prompt template generationErrors
         type: array
@@ -518,6 +522,45 @@ types:
         required: false # TODO Hand-rolled W-17552098
         items:
           type: EinsteinPromptTemplateAttachmentRepresentation
+  EinsteinLlmGenerationCitationRepresentation:
+    description: Output of a Einstein LLM Generation Citation output
+    type: object
+    properties:
+      citedReferences:
+        description: Cited References
+        required: false # TODO Hand-rolled W-19304625
+        type: array
+        items:
+          type: EinsteinLlmGenerationGenAiCitedReferenceRepresentation
+  EinsteinLlmGenerationGenAiCitedReferenceRepresentation:
+    description: Output of a Einstein LLM Generation Gen AI Citation output
+    type: object
+    properties:
+      citationLocations:
+        description: Array of locations where that particular citation needs to appear
+          in the input text
+        type: array
+        required: false # TODO Hand-rolled W-19304625
+        items:
+          type: integer
+      claims:
+        description: Matching chunk from the input text
+        type: array
+        required: false # TODO Hand-rolled W-19304625
+        items:
+          type: string
+      link:
+        description: Link
+        type: string
+        required: false # TODO Hand-rolled W-19304625
+      sourceObjectApiName:
+        description: SourceObjectApiName
+        type: string
+        required: false # TODO Hand-rolled W-19304625
+      sourceObjectRecordId:
+        description: SourceObjectRecordId
+        type: string
+        required: false # TODO Hand-rolled W-19304625
   EinsteinPromptTemplateAttachmentRepresentation:
     description: Representation of file data for prompt template attachments
     type: object
@@ -699,9 +742,10 @@ types:
       additionalParam:
         description: Additional parameters for the data provider configuration
         type: object
+        required: false # TODO Hand-rolled W-18968514
         properties:
           //:
-            type: object
+            type: any #TODO Hand-rolled W-18968514
       definition:
         description: The definition of the data provider instance
         type: string
@@ -757,6 +801,7 @@ types:
       nodeIcon:
         description: The icon identifier for the data provider instance
         type: string | nil
+        required: false # TODO Hand-rolled W-18968514
       outputParams:
         description: The list of all output parameters for the data provider instance
         type: array
@@ -786,6 +831,45 @@ types:
       label:
         description: The label of the output parameter
         type: string
+  PromptTemplateDataProviderTypeConfigCollectionRepresentation:
+    description: Collection of data provider type configurations for a prompt template
+      type
+    type: object
+    properties:
+      dataProviderTypeConfigs:
+        description: List of data provider type configs
+        type: array
+        items:
+          type: PromptTemplateDataProviderTypeConfigRepresentation
+  PromptTemplateDataProviderTypeConfigRepresentation:
+    description: Output representation of a data provider type configuration
+    type: object
+    properties:
+      description:
+        description: The localized description of the data provider type
+        type: string
+        required: false # TODO Hand-rolled W-19333313
+      groupName:
+        description: The group name of the data provider type
+        type: string
+      icon:
+        description: The icon identifier for the data provider type
+        type: string
+      isTopLevel:
+        description: Indicates whether this is a top level data provider type
+        type: boolean
+      label:
+        description: The localized label of the data provider type
+        type: string
+      parentNode:
+        description: The parent node identifier for hierarchical data provider types
+        type: string
+        required: false # TODO Hand-rolled W-19333313
+      scope:
+        description: The scope configuration for the data provider type (can be 'ALL'
+          or list of specific scopes)
+        type: any # TODO Hand-rolled W-19333313, scope can be a string, list of string, or just "ALL"
+        required: false # TODO Hand-rolled W-19333313
   EinsteinPromptTemplateVersionOutputLanguagesRepresentation:
     description: Representation of all supported output languages for a given Prompt
       Template Version
@@ -945,20 +1029,78 @@ types:
         application/json:
           type: EinsteinPromptRecordInputRepresentation
           (oas-body-name): templateInput
-  /prompt-templates/data-providers/mapped:
+  /prompt-templates/data-providers:
+    /mapped:
+      post:
+        displayName: postDataProviderInputMatchDiscovery
+        description: Get Data Provider Discovery Info List
+        responses:
+          '200':
+            description: Success
+            body:
+              application/json:
+                type: PromptTemplateDataProviderInstanceConfigCollectionRepresentation
+        body:
+          application/json:
+            type: PromptTemplateDataProviderDiscoveryInputRepresentation
+            (oas-body-name): dataProviderDiscoveryInput
+    /{templateType}:
+      get:
+        displayName: getPromptTemplateDataProviderDiscovery
+        description: Discover available data providers for prompt templates
+        responses:
+          '200':
+            description: Success
+            body:
+              application/json:
+                type: PromptTemplateDataProviderInstanceConfigCollectionRepresentation
+        queryParameters:
+          groupNames:
+            description: The group names for data provider discovery
+            type: array
+            required: false
+            items:
+              type: string
+              (oas-collectionFormat): csv
+          targets:
+            description: The scoped targets for data provider discovery
+            type: array
+            required: false
+            items:
+              type: string
+              (oas-collectionFormat): csv
+      uriParameters:
+        templateType:
+          type: string
+          required: true
+  /prompt-templates/data-provider/describe:
     post:
-      displayName: postDataProviderInputMatchDiscovery
-      description: Get Data Provider Discovery Info List
+      displayName: postPromptTemplateDataProviderInstanceConfig
+      description: Get Data Provider Instance Configuration for given definition name
       responses:
         '200':
           description: Success
           body:
             application/json:
-              type: PromptTemplateDataProviderInstanceConfigCollectionRepresentation
+              type: PromptTemplateDataProviderInstanceConfigRepresentation
       body:
         application/json:
-          type: PromptTemplateDataProviderDiscoveryInputRepresentation
-          (oas-body-name): dataProviderDiscoveryInput
+          type: PromptTemplateDataProviderInstanceConfigInputRepresentation
+          (oas-body-name): dataProviderInstanceConfigInput
+  /prompt-templates/data-provider-types/{templateType}:
+    get:
+      displayName: getPromptTemplateDataProviderTypeConfig
+      description: Get available data provider types for the specified template type
+      responses:
+        '200':
+          description: Success
+          body:
+            application/json:
+              type: PromptTemplateDataProviderTypeConfigCollectionRepresentation
+    uriParameters:
+      templateType:
+        type: string
+        required: true
   /prompt-templates/{promptTemplateDevName}:
     get:
       displayName: getEinsteinPromptTemplate
@@ -1016,6 +1158,30 @@ types:
         versionId:
           type: string
           required: true
+    /versions/{versionId}/status:
+      put:
+        displayName: putEinsteinPromptTemplateVersionStatus
+        description: Update prompt template version status (activate/deactivate)
+        responses:
+          '200':
+            description: Success
+            body:
+              application/json:
+                type: EinsteinPromptTemplateRepresentation
+        queryParameters:
+          action:
+            type: string
+            required: false
+          ignoreWarnings:
+            type: boolean
+            required: false
+      uriParameters:
+        promptTemplateDevName:
+          type: string
+          required: true
+        versionId:
+          type: string
+          required: true
   /prompt-templates/{promptTemplateDevName}/generations:
     post:
       displayName: postEinsteinPromptTemplateGenerations

package/src/raml/luvio.raml

@@ -36,6 +36,12 @@ types:
   PromptTemplateDataProviderInstanceConfigCollectionRepresentation:
     (luvio.ttl): 300
     (luvio.opaque): true
+  PromptTemplateDataProviderInstanceConfigRepresentation:
+    (luvio.ttl): 300
+    (luvio.opaque): true
+  PromptTemplateDataProviderTypeConfigCollectionRepresentation:
+    (luvio.ttl): 300
+    (luvio.opaque): true
 
 /einstein/llm/prompt/generations:
   post:
@@ -57,6 +63,23 @@ types:
     (luvio.adapter):
       name: getInputMappedDataProviders
 
+# Treat this POST operation as GET, so LDS can handle automatic caching,
+/einstein/prompt-templates/data-provider/describe:
+  post:
+    (luvio.method): get
+    (luvio.adapter):
+      name: getDataProviderInstanceConfig
+
+/einstein/prompt-templates/data-providers/{templateType}:
+  get:
+    (luvio.adapter):
+      name: getDataProviders
+
+/einstein/prompt-templates/data-provider-types/{templateType}:
+  get:
+    (luvio.adapter):
+      name: getDataProviderTypeConfigs
+
 /einstein/prompt-templates/{promptTemplateDevName}:
   get:
     (luvio.adapter):
@@ -92,3 +115,8 @@ types:
     (luvio.method): get
     (luvio.adapter):
       name: createEmbeddings
+
+/einstein/prompt-templates/{promptTemplateDevName}/versions/{versionId}/status:
+  put:
+    (luvio.adapter):
+      name: putEinsteinPromptTemplateVersionStatus