@salesforce/lds-adapters-service-einsteinllm 1.403.0 → 1.404.0-dev10

package/src/raml/api.raml

@@ -356,7 +356,7 @@ types:
         type: string
       value:
         description: The value of a field in its raw data form.
-        type: boolean | integer | string | nil
+        type: boolean | integer | string | string[] | nil # TODO Hand-rolled W-20480888
   EinsteinPromptRecordInputRepresentation:
     description: Input representation for creating a prompt template
     type: object
@@ -435,6 +435,10 @@ types:
         description: Additional configuration to fine tune model parameters
         type: EinsteinLlmAdditionalConfigInputRepresentation # Hand-rolled update from 'object'
         required: false # TODO Hand-rolled W-9314597
+      includeMetrics:
+        description: Whether to return metrics
+        type: boolean
+        required: false
       inputParams:
         description: Dictionary of input parameters to generate prompt from prompt
           template.
@@ -481,6 +485,11 @@ types:
         description: Any provider specific attributes will be included as part of
           this object
         type: WrappedMap | nil # Hand-rolled union 'nil'
+      performance:
+        description: Performance metrics including overall latency and detailed execution
+          breakdown
+        required: false
+        type: EinsteinPromptTemplatePerformanceRepresentation
       prompt:
         description: Prompt used for the generation
         type: string | nil # Hand-rolled union 'nil'
@@ -520,6 +529,10 @@ types:
         required: false # TODO Hand-rolled W-17552098
         items:
           type: EinsteinPromptTemplateAttachmentRepresentation
+      tokenUsage:
+        description: token usage information
+        required: false
+        type: EinsteinPromptTemplateTokenUsageRepresentation
   EinsteinLlmGenerationCitationRepresentation:
     description: Output of a Einstein LLM Generation Citation output
     type: object
@@ -551,6 +564,10 @@ types:
         description: Link
         type: string
         required: false # TODO Hand-rolled W-19304625
+      label:
+        description: Label
+        type: string
+        required: false
       sourceObjectApiName:
         description: SourceObjectApiName
         type: string
@@ -563,6 +580,10 @@ types:
     description: Representation of file data for prompt template attachments
     type: object
     properties:
+      actualFileMimeType:
+        description: Actual detected MIME type when file is excluded due to MIME/extension mismatch
+        type: string
+        required: false
       exclusionInfo:
         description: data for file exclusion from LLM request
         type: EinsteinPromptTemplateAttachmentExclusionInfoRepresentation
@@ -666,6 +687,74 @@ types:
       enableModeration:
         description: enable moderation value
         type: boolean
+  EinsteinPromptTemplateStatusRepresentation:
+    description: Comprehensive representation for prompt template operations including creation, updates, and activation/deactivation
+    type: object
+    properties:
+      additionalData?: # TODO Hand-rolled W-20775798
+        description: Additional data, such as references
+        type: WrappedMap
+      errorMessages:
+        description: Error Messages
+        type: array
+        items:
+          type: string
+      hasWarning:
+        description: has warning messages
+        type: boolean
+      isSuccessful:
+        description: IsSuccessful
+        type: boolean
+      statusCode:
+        description: Status Code of connect api
+        type: string
+        required: false # TODO Hand-rolled W-20775798
+      templateId:
+        description: Template Id
+        type: string
+      templateType:
+        description: Template Type
+        type: string
+        required: false # TODO Hand-rolled W-20775798
+      warningMessages:
+        description: Warning Messages
+        type: array
+        items:
+          type: string
+  EinsteinPromptTemplateReferencesRepresentation:
+    description: Representation for prompt template references response
+    type: object
+    properties:
+      additionalData?: # TODO Hand-rolled W-20775798
+        description: Additional data, such as references
+        type: WrappedMap
+      errorMessages:
+        description: Error Messages
+        type: array
+        items:
+          type: string
+      hasWarning:
+        description: has warning messages
+        type: boolean
+      isSuccessful:
+        description: IsSuccessful
+        type: boolean
+      statusCode:
+        description: Status Code of connect api
+        type: string
+        required: false # TODO Hand-rolled W-20775798
+      templateId:
+        description: Template Id
+        type: string
+      templateType:
+        description: Template Type
+        type: string
+        required: false # TODO Hand-rolled W-20775798
+      warningMessages:
+        description: Warning Messages
+        type: array
+        items:
+          type: string
   EinsteinPromptTemplateSupportedLanguageErrorRepresentation:
     description: Representation of an error encountered when returning the Prompt Template Version Supported Languages.
     type: object
@@ -946,6 +1035,121 @@ types:
       versionId:
         description: Prompt Template Version Id
         type: string
+  EinsteinPromptTemplatePerformanceRepresentation:
+    description: Performance metrics including overall latency and detailed execution
+      breakdown
+    type: object
+    properties:
+      execution:
+        description: Detailed latency breakdown for all execution steps
+        type: EinsteinPromptTemplateLatencyExecutionRepresentation
+      latency:
+        description: Overall latency metrics for the entire operation
+        type: EinsteinPromptTemplateLatencyRepresentation
+  EinsteinPromptTemplateLatencyBreakdownItemRepresentation:
+    description: Latency breakdown item with reference name and latency metrics
+    type: object
+    properties:
+      latency:
+        description: Latency information for this breakdown item
+        type: EinsteinPromptTemplateLatencyRepresentation
+      referenceName:
+        description: Reference name for the breakdown item
+        type: string
+  EinsteinPromptTemplateLatencyExecutionRepresentation:
+    description: Latency execution breakdown with metrics for all execution steps
+    type: object
+    properties:
+      generation:
+        description: Latency metrics for generation step
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+        required: false
+      hydration:
+        description: Latency metrics for hydration step
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+        required: false
+      loadTemplate:
+        description: Latency metrics for loading the template
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+      mask:
+        description: Latency metrics for masking step
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+        required: false
+      resolveData:
+        description: Latency metrics for resolving all data (inputs and data providers)
+          with breakdown
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+        required: false
+      summarize:
+        description: Latency metrics for summarization step
+        type: EinsteinPromptTemplateLatencyStepRepresentation
+        required: false
+  EinsteinPromptTemplateLatencyRepresentation:
+    description: Latency information with duration and start time
+    type: object
+    properties:
+      duration:
+        description: Duration of the operation in milliseconds
+        type: integer
+      startTime:
+        description: Start time of the operation in milliseconds
+        type: integer
+  EinsteinPromptTemplateLatencyStepRepresentation:
+    description: Latency step information with latency metrics and breakdown
+    type: object
+    properties:
+      breakdown:
+        description: Breakdown of latency by reference name
+        type: array
+        required: false
+        items:
+          type: EinsteinPromptTemplateLatencyBreakdownItemRepresentation
+      latency:
+        description: Latency information for this step
+        type: EinsteinPromptTemplateLatencyRepresentation
+  EinsteinPromptTemplatePromptTokenUsageRepresentation:
+    description: Output representation for prompt token usage with breakdown
+    type: object
+    properties:
+      breakdown:
+        description: Breakdown of token usage by source (text expressions, files,
+          etc.)
+        required: false
+        type: array
+        items:
+          type: EinsteinPromptTemplateTokenBreakdownRepresentation
+      total:
+        description: Total number of tokens used in the prompt
+        type: integer
+  EinsteinPromptTemplateTokenUsageRepresentation:
+    description: Output representation for token usage and its breakdown
+    type: object
+    properties:
+      completion:
+        description: Number of tokens used for completion
+        type: integer
+      prompt:
+        description: Prompt token usage details including breakdown by source
+        type: EinsteinPromptTemplatePromptTokenUsageRepresentation
+      total:
+        description: Total number of tokens used in the request
+        type: integer
+  EinsteinPromptTemplateTokenBreakdownRepresentation:
+    description: Output representation for a single token breakdown item by source
+    type: object
+    properties:
+      occurrences:
+        description: Number of times this expression appears in the prompt
+        type: integer
+      role:
+        description: Role associated with source of token.
+        type: string
+      source:
+        description: Specific part of prompt that contributed to tokens.
+        type: string
+      tokens:
+        description: Number of tokens contributed by this source
+        type: integer
   WrappedListString:
     description: Wrapped list of String for use in Apex.
     type: object
@@ -1171,6 +1375,38 @@ types:
       promptTemplateDevName:
         type: string
         required: true
+    /status:
+      put:
+        displayName: putEinsteinPromptTemplateStatus
+        description: Update prompt template status (deactivate)
+        responses:
+          '200':
+            description: Success
+            body:
+              application/json:
+                type: EinsteinPromptTemplateStatusRepresentation
+        queryParameters:
+          action:
+            type: string
+            required: false
+      uriParameters:
+        promptTemplateDevName:
+          type: string
+          required: true
+    /references:
+      get:
+        displayName: getEinsteinPromptTemplateReferences
+        description: Get references to a Prompt Template by prompttemplate developer name or id
+        responses:
+          '200':
+            description: Success
+            body:
+              application/json:
+                type: EinsteinPromptTemplateReferencesRepresentation
+      uriParameters:
+        promptTemplateDevName:
+          type: string
+          required: true
     /versions:
       get:
         displayName: getEinsteinPromptTemplateVersions

package/src/raml/luvio.raml

@@ -33,6 +33,13 @@ types:
     (luvio.ttl): 100
     (luvio.key):
       versionId: versionId
+  EinsteinPromptTemplateReferencesRepresentation:
+    (luvio.ttl): 100
+    (luvio.opaque): true
+  EinsteinPromptTemplateStatusRepresentation:
+    (luvio.ttl): 100
+    (luvio.key):
+      templateId: templateId
   PromptTemplateDataProviderInstanceConfigCollectionRepresentation:
     (luvio.ttl): 300
     (luvio.opaque): true
@@ -124,6 +131,16 @@ types:
     (luvio.adapter):
       name: createEmbeddings
 
+/einstein/prompt-templates/{promptTemplateDevName}/status:
+  put:
+    (luvio.adapter):
+      name: putEinsteinPromptTemplateStatus
+
+/einstein/prompt-templates/{promptTemplateDevName}/references:
+  get:
+    (luvio.adapter):
+      name: getEinsteinPromptTemplateReferences
+
 /einstein/prompt-templates/{promptTemplateDevName}/versions/{versionId}/status:
   put:
     (luvio.adapter):