@aws-sdk/client-qconnect 3.940.0 → 3.943.0

package/dist-types/models/models_1.d.ts

@@ -1,5 +1,691 @@
-import { ChannelSubtype, ImportJobType, MessageTemplateFilterOperator, MessageTemplateQueryOperator, Order, Priority, QueryResultType, QuickResponseFilterOperator, QuickResponseQueryOperator, QuickResponseStatus, RecommendationType, RelevanceLevel } from "./enums";
-import { ContentDataDetails, ContentSummary, DataReference, Document, EmailOverviewChunkDataDetails, EmailResponseChunkDataDetails, ExternalSourceConfiguration, GroupingConfiguration, ImportJobData, IntentDetectedDataDetails, KnowledgeBaseData, MessageTemplateAttachment, MessageTemplateAttributes, MessageTemplateContentProvider, MessageTemplateData, MessageTemplateSourceConfiguration, MessageTemplateSourceConfigurationSummary, QuickResponseContents, QuickResponseData, QuickResponseDataProvider, RankingData, RecommendationTrigger, SearchExpression, SourceContentDataDetails } from "./models_0";
+import { AIAgentType, AIPromptType, ChannelSubtype, ExternalSource, ImportJobStatus, ImportJobType, KnowledgeBaseSearchType, KnowledgeBaseStatus, KnowledgeBaseType, MessageTemplateFilterOperator, MessageTemplateQueryOperator, Order, Participant, Priority, QueryResultType, QuickResponseFilterOperator, QuickResponseQueryOperator, QuickResponseStatus, RecommendationType, RelevanceLevel, SpanStatus, SpanType } from "./enums";
+import { CaseSummarizationChunkDataDetails, Configuration, ContentDataDetails, ContentSummary, DataReference, Document, EmailOverviewChunkDataDetails, EmailResponseChunkDataDetails, ExtendedMessageTemplateData, FilterAttribute, GroupingConfiguration, IntentDetectedDataDetails, KnowledgeBaseData, KnowledgeSource, MessageTemplateAttachment, MessageTemplateAttributes, MessageTemplateContentProvider, MessageTemplateData, MessageTemplateSourceConfiguration, MessageTemplateSourceConfigurationSummary, NotesChunkDataDetails, NotesDataDetails, QuickResponseContents, QuickResponseData, QuickResponseDataProvider, RankingData, RecommendationTrigger, RenderingConfiguration, SearchExpression, ServerSideEncryptionConfiguration, SourceConfiguration, SourceContentDataDetails, SpanTextValue, SpanToolUseValue, SuggestedMessageDataDetails, VectorIngestionConfiguration } from "./models_0";
+/**
+ * @public
+ */
+export interface DeleteImportJobRequest {
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the import job to be deleted.</p>
+     * @public
+     */
+    importJobId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteImportJobResponse {
+}
+/**
+ * @public
+ */
+export interface DeleteKnowledgeBaseRequest {
+    /**
+     * <p>The knowledge base to delete content from. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteKnowledgeBaseResponse {
+}
+/**
+ * @public
+ */
+export interface DeleteMessageTemplateRequest {
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the message template. Can be either the ID or the ARN.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteMessageTemplateResponse {
+}
+/**
+ * @public
+ */
+export interface DeleteMessageTemplateAttachmentRequest {
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the message template. Can be either the ID or the ARN. It cannot contain any qualifier.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>The identifier of the attachment file.</p>
+     * @public
+     */
+    attachmentId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteMessageTemplateAttachmentResponse {
+}
+/**
+ * @public
+ */
+export interface DeleteQuickResponseRequest {
+    /**
+     * <p>The knowledge base from which the quick response is deleted. The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the quick response to delete.</p>
+     * @public
+     */
+    quickResponseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteQuickResponseResponse {
+}
+/**
+ * <p>The configuration information of the external data source.</p>
+ * @public
+ */
+export interface ExternalSourceConfiguration {
+    /**
+     * <p>The type of the external data source.</p>
+     * @public
+     */
+    source: ExternalSource | undefined;
+    /**
+     * <p>The configuration information of the external data source.</p>
+     * @public
+     */
+    configuration: Configuration | undefined;
+}
+/**
+ * @public
+ */
+export interface GetImportJobRequest {
+    /**
+     * <p>The identifier of the import job to retrieve.</p>
+     * @public
+     */
+    importJobId: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base that the import job belongs to.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * <p>Summary information about the import job.</p>
+ * @public
+ */
+export interface ImportJobData {
+    /**
+     * <p>The identifier of the import job.</p>
+     * @public
+     */
+    importJobId: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>A pointer to the uploaded asset. This value is returned by <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_StartContentUpload.html">StartContentUpload</a>.</p>
+     * @public
+     */
+    uploadId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseArn: string | undefined;
+    /**
+     * <p>The type of the import job.</p>
+     * @public
+     */
+    importJobType: ImportJobType | undefined;
+    /**
+     * <p>The status of the import job.</p>
+     * @public
+     */
+    status: ImportJobStatus | undefined;
+    /**
+     * <p>The download link to the resource file that is uploaded to the import job.</p>
+     * @public
+     */
+    url: string | undefined;
+    /**
+     * <p>The link to download the information of resource data that failed to be imported.</p>
+     * @public
+     */
+    failedRecordReport?: string | undefined;
+    /**
+     * <p>The expiration time of the URL as an epoch timestamp.</p>
+     * @public
+     */
+    urlExpiry: Date | undefined;
+    /**
+     * <p>The timestamp when the import job was created.</p>
+     * @public
+     */
+    createdTime: Date | undefined;
+    /**
+     * <p>The timestamp when the import job data was last modified.</p>
+     * @public
+     */
+    lastModifiedTime: Date | undefined;
+    /**
+     * <p>The metadata fields of the imported Amazon Q in Connect resources.</p>
+     * @public
+     */
+    metadata?: Record<string, string> | undefined;
+    /**
+     * <p>The configuration information of the external data source.</p>
+     * @public
+     */
+    externalSourceConfiguration?: ExternalSourceConfiguration | undefined;
+}
+/**
+ * @public
+ */
+export interface GetImportJobResponse {
+    /**
+     * <p>The import job.</p>
+     * @public
+     */
+    importJob?: ImportJobData | undefined;
+}
+/**
+ * @public
+ */
+export interface GetKnowledgeBaseRequest {
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetKnowledgeBaseResponse {
+    /**
+     * <p>The knowledge base.</p>
+     * @public
+     */
+    knowledgeBase?: KnowledgeBaseData | undefined;
+}
+/**
+ * @public
+ */
+export interface GetMessageTemplateRequest {
+    /**
+     * <p>The identifier of the message template. Can be either the ID or the ARN.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetMessageTemplateResponse {
+    /**
+     * <p>The message template.</p>
+     * @public
+     */
+    messageTemplate?: ExtendedMessageTemplateData | undefined;
+}
+/**
+ * @public
+ */
+export interface GetQuickResponseRequest {
+    /**
+     * <p>The identifier of the quick response.</p>
+     * @public
+     */
+    quickResponseId: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base. This should be a QUICK_RESPONSES type knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetQuickResponseResponse {
+    /**
+     * <p>The quick response.</p>
+     * @public
+     */
+    quickResponse?: QuickResponseData | undefined;
+}
+/**
+ * <p>Summary information about the import job.</p>
+ * @public
+ */
+export interface ImportJobSummary {
+    /**
+     * <p>The identifier of the import job.</p>
+     * @public
+     */
+    importJobId: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>A pointer to the uploaded asset. This value is returned by <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_StartContentUpload.html">StartContentUpload</a>.</p>
+     * @public
+     */
+    uploadId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseArn: string | undefined;
+    /**
+     * <p>The type of import job.</p>
+     * @public
+     */
+    importJobType: ImportJobType | undefined;
+    /**
+     * <p>The status of the import job.</p>
+     * @public
+     */
+    status: ImportJobStatus | undefined;
+    /**
+     * <p>The timestamp when the import job was created.</p>
+     * @public
+     */
+    createdTime: Date | undefined;
+    /**
+     * <p>The timestamp when the import job was last modified.</p>
+     * @public
+     */
+    lastModifiedTime: Date | undefined;
+    /**
+     * <p>The metadata fields of the imported Amazon Q in Connect resources.</p>
+     * @public
+     */
+    metadata?: Record<string, string> | undefined;
+    /**
+     * <p>The configuration information of the external source that the resource data are imported from.</p>
+     * @public
+     */
+    externalSourceConfiguration?: ExternalSourceConfiguration | undefined;
+}
+/**
+ * @public
+ */
+export interface ListImportJobsRequest {
+    /**
+     * <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+    /**
+     * <p>The maximum number of results to return per page.</p>
+     * @public
+     */
+    maxResults?: number | undefined;
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListImportJobsResponse {
+    /**
+     * <p>Summary information about the import jobs.</p>
+     * @public
+     */
+    importJobSummaries: ImportJobSummary[] | undefined;
+    /**
+     * <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListKnowledgeBasesRequest {
+    /**
+     * <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+    /**
+     * <p>The maximum number of results to return per page.</p>
+     * @public
+     */
+    maxResults?: number | undefined;
+}
+/**
+ * <p>Summary information about the knowledge base.</p>
+ * @public
+ */
+export interface KnowledgeBaseSummary {
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseArn: string | undefined;
+    /**
+     * <p>The name of the knowledge base.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The type of knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseType: KnowledgeBaseType | undefined;
+    /**
+     * <p>The status of the knowledge base summary.</p>
+     * @public
+     */
+    status: KnowledgeBaseStatus | undefined;
+    /**
+     * <p>Configuration information about the external data source.</p>
+     * @public
+     */
+    sourceConfiguration?: SourceConfiguration | undefined;
+    /**
+     * <p>Contains details about how to ingest the documents in a data source.</p>
+     * @public
+     */
+    vectorIngestionConfiguration?: VectorIngestionConfiguration | undefined;
+    /**
+     * <p>Information about how to render the content.</p>
+     * @public
+     */
+    renderingConfiguration?: RenderingConfiguration | undefined;
+    /**
+     * <p>The configuration information for the customer managed key used for encryption. </p> <p>This KMS key must have a policy that allows <code>kms:CreateGrant</code>, <code>kms:DescribeKey</code>, <code>kms:Decrypt</code>, and <code>kms:GenerateDataKey*</code> permissions to the IAM identity using the key to invoke Amazon Q in Connect. </p> <p>For more information about setting up a customer managed key for Amazon Q in Connect, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/enable-q.html">Enable Amazon Q in Connect for your instance</a>.</p>
+     * @public
+     */
+    serverSideEncryptionConfiguration?: ServerSideEncryptionConfiguration | undefined;
+    /**
+     * <p>The description of the knowledge base.</p>
+     * @public
+     */
+    description?: string | undefined;
+    /**
+     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * @public
+     */
+    tags?: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface ListKnowledgeBasesResponse {
+    /**
+     * <p>Information about the knowledge bases.</p>
+     * @public
+     */
+    knowledgeBaseSummaries: KnowledgeBaseSummary[] | undefined;
+    /**
+     * <p>If there are additional results, this is the token for the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListMessageTemplatesRequest {
+    /**
+     * <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+    /**
+     * <p>The maximum number of results to return per page.</p>
+     * @public
+     */
+    maxResults?: number | undefined;
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+}
+/**
+ * <p>The summary of the message template.</p>
+ * @public
+ */
+export interface MessageTemplateSummary {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the message template.</p>
+     * @public
+     */
+    messageTemplateArn: string | undefined;
+    /**
+     * <p>The identifier of the message template.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseArn: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The name of the message template.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The channel this message template applies to.</p>
+     * @public
+     */
+    channel?: string | undefined;
+    /**
+     * <p>The channel subtype this message template applies to.</p>
+     * @public
+     */
+    channelSubtype: ChannelSubtype | undefined;
+    /**
+     * <p>The timestamp when the message template was created.</p>
+     * @public
+     */
+    createdTime: Date | undefined;
+    /**
+     * <p>The timestamp when the message template data was last modified.</p>
+     * @public
+     */
+    lastModifiedTime: Date | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the user who last updated the message template data.</p>
+     * @public
+     */
+    lastModifiedBy: string | undefined;
+    /**
+     * <p>The container of message template source configuration.</p>
+     * @public
+     */
+    sourceConfiguration?: MessageTemplateSourceConfiguration | undefined;
+    /**
+     * <p>The version number of the message template version that is activated.</p>
+     * @public
+     */
+    activeVersionNumber?: number | undefined;
+    /**
+     * <p>The description of the message template.</p>
+     * @public
+     */
+    description?: string | undefined;
+    /**
+     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * @public
+     */
+    tags?: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface ListMessageTemplatesResponse {
+    /**
+     * <p>Summary information about the message template.</p>
+     * @public
+     */
+    messageTemplateSummaries: MessageTemplateSummary[] | undefined;
+    /**
+     * <p>If there are additional results, this is the token for the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListMessageTemplateVersionsRequest {
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the message template. Can be either the ID or the ARN. It cannot contain any qualifier.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+    /**
+     * <p>The maximum number of results to return per page.</p>
+     * @public
+     */
+    maxResults?: number | undefined;
+}
+/**
+ * <p>The summary of the message template version.</p>
+ * @public
+ */
+export interface MessageTemplateVersionSummary {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the message template.</p>
+     * @public
+     */
+    messageTemplateArn: string | undefined;
+    /**
+     * <p>The identifier of the message template.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseArn: string | undefined;
+    /**
+     * <p>The identifier of the knowledge base.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The name of the message template.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The channel of the message template.</p>
+     * @public
+     */
+    channel?: string | undefined;
+    /**
+     * <p>The channel subtype this message template applies to.</p>
+     * @public
+     */
+    channelSubtype: ChannelSubtype | undefined;
+    /**
+     * <p>Whether the version of the message template is activated.</p>
+     * @public
+     */
+    isActive: boolean | undefined;
+    /**
+     * <p>The version number of the message template version.</p>
+     * @public
+     */
+    versionNumber: number | undefined;
+}
+/**
+ * @public
+ */
+export interface ListMessageTemplateVersionsResponse {
+    /**
+     * <p>Summary information about the versions of a message template.</p>
+     * @public
+     */
+    messageTemplateVersionSummaries: MessageTemplateVersionSummary[] | undefined;
+    /**
+     * <p>If there are additional results, this is the token for the next set of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface RenderMessageTemplateRequest {
+    /**
+     * <p>The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The identifier of the message template. Can be either the ID or the ARN.</p>
+     * @public
+     */
+    messageTemplateId: string | undefined;
+    /**
+     * <p>An object that specifies the values to use for variables in the message template. This object contains different categories of key-value pairs. Each key defines a variable or placeholder in the message template. The corresponding value defines the value for that variable.</p>
+     * @public
+     */
+    attributes: MessageTemplateAttributes | undefined;
+}
 /**
  * @public
  */
@@ -926,91 +1612,552 @@ export interface StartImportJobResponse {
  */
 export interface UpdateKnowledgeBaseTemplateUriRequest {
     /**
-     * <p>The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * <p>The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.</p>
+     * @public
+     */
+    knowledgeBaseId: string | undefined;
+    /**
+     * <p>The template URI to update.</p>
+     * @public
+     */
+    templateUri: string | undefined;
+}
+/**
+ * @public
+ */
+export interface UpdateKnowledgeBaseTemplateUriResponse {
+    /**
+     * <p>The knowledge base to update.</p>
+     * @public
+     */
+    knowledgeBase?: KnowledgeBaseData | undefined;
+}
+/**
+ * @public
+ */
+export interface ListTagsForResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * @public
+     */
+    resourceArn: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListTagsForResourceResponse {
+    /**
+     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * @public
+     */
+    tags?: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface TagResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * @public
+     */
+    resourceArn: string | undefined;
+    /**
+     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * @public
+     */
+    tags: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface TagResourceResponse {
+}
+/**
+ * @public
+ */
+export interface UntagResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * @public
+     */
+    resourceArn: string | undefined;
+    /**
+     * <p>The tag keys.</p>
+     * @public
+     */
+    tagKeys: string[] | undefined;
+}
+/**
+ * @public
+ */
+export interface UntagResourceResponse {
+}
+/**
+ * <p>Message content value - can be text, tool invocation, or tool result</p>
+ * @public
+ */
+export type SpanMessageValue = SpanMessageValue.TextMember | SpanMessageValue.ToolResultMember | SpanMessageValue.ToolUseMember | SpanMessageValue.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace SpanMessageValue {
+    /**
+     * <p>Text message content</p>
+     * @public
+     */
+    interface TextMember {
+        text: SpanTextValue;
+        toolUse?: never;
+        toolResult?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Tool invocation message content</p>
+     * @public
+     */
+    interface ToolUseMember {
+        text?: never;
+        toolUse: SpanToolUseValue;
+        toolResult?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Tool result message content</p>
+     * @public
+     */
+    interface ToolResultMember {
+        text?: never;
+        toolUse?: never;
+        toolResult: SpanToolResultValue;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        toolUse?: never;
+        toolResult?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: SpanTextValue) => T;
+        toolUse: (value: SpanToolUseValue) => T;
+        toolResult: (value: SpanToolResultValue) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Tool result message content</p>
+ * @public
+ */
+export interface SpanToolResultValue {
+    /**
+     * <p>Relates this result back to the tool invocation</p>
+     * @public
+     */
+    toolUseId: string | undefined;
+    /**
+     * <p>The tool results</p>
+     * @public
+     */
+    values: SpanMessageValue[] | undefined;
+    /**
+     * <p>The tool invocation error if failed</p>
+     * @public
+     */
+    error?: string | undefined;
+}
+/**
+ * <p>Configuration for filtering content during retrieval operations.</p>
+ * @public
+ */
+export type RetrievalFilterConfiguration = RetrievalFilterConfiguration.AndAllMember | RetrievalFilterConfiguration.EqualsMember | RetrievalFilterConfiguration.GreaterThanMember | RetrievalFilterConfiguration.GreaterThanOrEqualsMember | RetrievalFilterConfiguration.InMember | RetrievalFilterConfiguration.LessThanMember | RetrievalFilterConfiguration.LessThanOrEqualsMember | RetrievalFilterConfiguration.ListContainsMember | RetrievalFilterConfiguration.NotEqualsMember | RetrievalFilterConfiguration.NotInMember | RetrievalFilterConfiguration.OrAllMember | RetrievalFilterConfiguration.StartsWithMember | RetrievalFilterConfiguration.StringContainsMember | RetrievalFilterConfiguration.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace RetrievalFilterConfiguration {
+    /**
+     * <p>Filter configuration that requires all conditions to be met.</p>
+     * @public
+     */
+    interface AndAllMember {
+        andAll: RetrievalFilterConfiguration[];
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for exact equality matching.</p>
+     * @public
+     */
+    interface EqualsMember {
+        andAll?: never;
+        equals: FilterAttribute;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for greater than comparison.</p>
+     * @public
+     */
+    interface GreaterThanMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan: FilterAttribute;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for greater than or equal comparison.</p>
+     * @public
+     */
+    interface GreaterThanOrEqualsMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals: FilterAttribute;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for membership in a set of values.</p>
+     * @public
+     */
+    interface InMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in: FilterAttribute;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for less than comparison.</p>
+     * @public
+     */
+    interface LessThanMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan: FilterAttribute;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for less than or equal comparison.</p>
+     * @public
+     */
+    interface LessThanOrEqualsMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals: FilterAttribute;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for checking if a list contains a value.</p>
+     * @public
+     */
+    interface ListContainsMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains: FilterAttribute;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for inequality matching.</p>
+     * @public
+     */
+    interface NotEqualsMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals: FilterAttribute;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for exclusion from a set of values.</p>
+     * @public
+     */
+    interface NotInMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn: FilterAttribute;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration where any condition can be met.</p>
+     * @public
+     */
+    interface OrAllMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll: RetrievalFilterConfiguration[];
+        startsWith?: never;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for prefix matching.</p>
+     * @public
+     */
+    interface StartsWithMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith: FilterAttribute;
+        stringContains?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Filter configuration for substring matching.</p>
+     * @public
+     */
+    interface StringContainsMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains: FilterAttribute;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        andAll?: never;
+        equals?: never;
+        greaterThan?: never;
+        greaterThanOrEquals?: never;
+        in?: never;
+        lessThan?: never;
+        lessThanOrEquals?: never;
+        listContains?: never;
+        notEquals?: never;
+        notIn?: never;
+        orAll?: never;
+        startsWith?: never;
+        stringContains?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        andAll: (value: RetrievalFilterConfiguration[]) => T;
+        equals: (value: FilterAttribute) => T;
+        greaterThan: (value: FilterAttribute) => T;
+        greaterThanOrEquals: (value: FilterAttribute) => T;
+        in: (value: FilterAttribute) => T;
+        lessThan: (value: FilterAttribute) => T;
+        lessThanOrEquals: (value: FilterAttribute) => T;
+        listContains: (value: FilterAttribute) => T;
+        notEquals: (value: FilterAttribute) => T;
+        notIn: (value: FilterAttribute) => T;
+        orAll: (value: RetrievalFilterConfiguration[]) => T;
+        startsWith: (value: FilterAttribute) => T;
+        stringContains: (value: FilterAttribute) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A message in the conversation history with participant role and content values</p>
+ * @public
+ */
+export interface SpanMessage {
+    /**
+     * <p>Unique message identifier</p>
+     * @public
+     */
+    messageId: string | undefined;
+    /**
+     * <p>Message source role</p>
      * @public
      */
-    knowledgeBaseId: string | undefined;
+    participant: Participant | undefined;
     /**
-     * <p>The template URI to update.</p>
+     * <p>Message timestamp</p>
      * @public
      */
-    templateUri: string | undefined;
-}
-/**
- * @public
- */
-export interface UpdateKnowledgeBaseTemplateUriResponse {
+    timestamp: Date | undefined;
     /**
-     * <p>The knowledge base to update.</p>
+     * <p>Message content values (text, tool use, tool result)</p>
      * @public
      */
-    knowledgeBase?: KnowledgeBaseData | undefined;
+    values: SpanMessageValue[] | undefined;
 }
 /**
+ * <p>Configuration for content retrieval operations.</p>
  * @public
  */
-export interface ListTagsForResourceRequest {
+export interface RetrievalConfiguration {
     /**
-     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * <p>The knowledge source configuration for content retrieval.</p>
      * @public
      */
-    resourceArn: string | undefined;
-}
-/**
- * @public
- */
-export interface ListTagsForResourceResponse {
+    knowledgeSource: KnowledgeSource | undefined;
     /**
-     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * <p>The filter configuration for content retrieval.</p>
      * @public
      */
-    tags?: Record<string, string> | undefined;
-}
-/**
- * @public
- */
-export interface TagResourceRequest {
+    filter?: RetrievalFilterConfiguration | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * <p>The number of results to retrieve.</p>
      * @public
      */
-    resourceArn: string | undefined;
+    numberOfResults?: number | undefined;
     /**
-     * <p>The tags used to organize, track, or control access for this resource.</p>
+     * <p>Override setting for the knowledge base search type during retrieval.</p>
      * @public
      */
-    tags: Record<string, string> | undefined;
+    overrideKnowledgeBaseSearchType?: KnowledgeBaseSearchType | undefined;
 }
 /**
  * @public
  */
-export interface TagResourceResponse {
-}
-/**
- * @public
- */
-export interface UntagResourceRequest {
+export interface RetrieveRequest {
     /**
-     * <p>The Amazon Resource Name (ARN) of the resource.</p>
+     * <p>The identifier of the Amazon Q in Connect assistant for content retrieval.</p>
      * @public
      */
-    resourceArn: string | undefined;
+    assistantId: string | undefined;
     /**
-     * <p>The tag keys.</p>
+     * <p>The configuration for the content retrieval operation.</p>
      * @public
      */
-    tagKeys: string[] | undefined;
-}
-/**
- * @public
- */
-export interface UntagResourceResponse {
+    retrievalConfiguration: RetrievalConfiguration | undefined;
+    /**
+     * <p>The query for content retrieval.</p>
+     * @public
+     */
+    retrievalQuery: string | undefined;
 }
 /**
  * <p>Details about the data.</p>
  * @public
  */
-export type DataDetails = DataDetails.ContentDataMember | DataDetails.EmailGenerativeAnswerChunkDataMember | DataDetails.EmailOverviewChunkDataMember | DataDetails.EmailResponseChunkDataMember | DataDetails.GenerativeChunkDataMember | DataDetails.GenerativeDataMember | DataDetails.IntentDetectedDataMember | DataDetails.SourceContentDataMember | DataDetails.$UnknownMember;
+export type DataDetails = DataDetails.CaseSummarizationChunkDataMember | DataDetails.ContentDataMember | DataDetails.EmailGenerativeAnswerChunkDataMember | DataDetails.EmailOverviewChunkDataMember | DataDetails.EmailResponseChunkDataMember | DataDetails.GenerativeChunkDataMember | DataDetails.GenerativeDataMember | DataDetails.IntentDetectedDataMember | DataDetails.NotesChunkDataMember | DataDetails.NotesDataMember | DataDetails.SourceContentDataMember | DataDetails.SuggestedMessageDataMember | DataDetails.$UnknownMember;
 /**
  * @public
  */
@@ -1028,6 +2175,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1043,6 +2194,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1058,6 +2213,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1073,6 +2232,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1088,6 +2251,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1103,6 +2270,10 @@ export declare namespace DataDetails {
         emailResponseChunkData: EmailResponseChunkDataDetails;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1118,6 +2289,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData: EmailOverviewChunkDataDetails;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown?: never;
     }
     /**
@@ -1133,6 +2308,86 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData: EmailGenerativeAnswerChunkDataDetails;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Details about case summarization chunk data.</p>
+     * @public
+     */
+    interface CaseSummarizationChunkDataMember {
+        contentData?: never;
+        generativeData?: never;
+        intentDetectedData?: never;
+        sourceContentData?: never;
+        generativeChunkData?: never;
+        emailResponseChunkData?: never;
+        emailOverviewChunkData?: never;
+        emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData: CaseSummarizationChunkDataDetails;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Details about suggested message data.</p>
+     * @public
+     */
+    interface SuggestedMessageDataMember {
+        contentData?: never;
+        generativeData?: never;
+        intentDetectedData?: never;
+        sourceContentData?: never;
+        generativeChunkData?: never;
+        emailResponseChunkData?: never;
+        emailOverviewChunkData?: never;
+        emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData: SuggestedMessageDataDetails;
+        notesData?: never;
+        notesChunkData?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Details about notes data.</p>
+     * @public
+     */
+    interface NotesDataMember {
+        contentData?: never;
+        generativeData?: never;
+        intentDetectedData?: never;
+        sourceContentData?: never;
+        generativeChunkData?: never;
+        emailResponseChunkData?: never;
+        emailOverviewChunkData?: never;
+        emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData: NotesDataDetails;
+        notesChunkData?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Details about notes chunk data.</p>
+     * @public
+     */
+    interface NotesChunkDataMember {
+        contentData?: never;
+        generativeData?: never;
+        intentDetectedData?: never;
+        sourceContentData?: never;
+        generativeChunkData?: never;
+        emailResponseChunkData?: never;
+        emailOverviewChunkData?: never;
+        emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData: NotesChunkDataDetails;
         $unknown?: never;
     }
     /**
@@ -1147,6 +2402,10 @@ export declare namespace DataDetails {
         emailResponseChunkData?: never;
         emailOverviewChunkData?: never;
         emailGenerativeAnswerChunkData?: never;
+        caseSummarizationChunkData?: never;
+        suggestedMessageData?: never;
+        notesData?: never;
+        notesChunkData?: never;
         $unknown: [string, any];
     }
     /**
@@ -1162,6 +2421,10 @@ export declare namespace DataDetails {
         emailResponseChunkData: (value: EmailResponseChunkDataDetails) => T;
         emailOverviewChunkData: (value: EmailOverviewChunkDataDetails) => T;
         emailGenerativeAnswerChunkData: (value: EmailGenerativeAnswerChunkDataDetails) => T;
+        caseSummarizationChunkData: (value: CaseSummarizationChunkDataDetails) => T;
+        suggestedMessageData: (value: SuggestedMessageDataDetails) => T;
+        notesData: (value: NotesDataDetails) => T;
+        notesChunkData: (value: NotesChunkDataDetails) => T;
         _: (name: string, value: any) => T;
     }
 }
@@ -1311,6 +2574,243 @@ export interface ResultData {
      */
     type?: QueryResultType | undefined;
 }
+/**
+ * <p>Contextual attributes capturing operation details, LLM configuration, usage metrics, and conversation data</p>
+ * @public
+ */
+export interface SpanAttributes {
+    /**
+     * <p>Action being performed</p>
+     * @public
+     */
+    operationName?: string | undefined;
+    /**
+     * <p>Model provider identifier (e.g., aws.bedrock)</p>
+     * @public
+     */
+    providerName?: string | undefined;
+    /**
+     * <p>Error classification if span failed (e.g., throttle, timeout)</p>
+     * @public
+     */
+    errorType?: string | undefined;
+    /**
+     * <p>Amazon Connect agent ID</p>
+     * @public
+     */
+    agentId?: string | undefined;
+    /**
+     * <p>Amazon Connect instance ARN</p>
+     * @public
+     */
+    instanceArn?: string | undefined;
+    /**
+     * <p>Amazon Connect contact identifier</p>
+     * @public
+     */
+    contactId?: string | undefined;
+    /**
+     * <p>Amazon Connect contact identifier</p>
+     * @public
+     */
+    initialContactId?: string | undefined;
+    /**
+     * <p>Session name</p>
+     * @public
+     */
+    sessionName?: string | undefined;
+    /**
+     * <p>AI agent ARN</p>
+     * @public
+     */
+    aiAgentArn?: string | undefined;
+    /**
+     * <p>AI agent type</p>
+     * @public
+     */
+    aiAgentType?: AIAgentType | undefined;
+    /**
+     * <p>AI agent name</p>
+     * @public
+     */
+    aiAgentName?: string | undefined;
+    /**
+     * <p>AI agent identifier</p>
+     * @public
+     */
+    aiAgentId?: string | undefined;
+    /**
+     * <p>AI agent version number</p>
+     * @public
+     */
+    aiAgentVersion?: number | undefined;
+    /**
+     * <p>Entity that invoked the AI agent</p>
+     * @public
+     */
+    aiAgentInvoker?: string | undefined;
+    /**
+     * <p>AI agent orchestrator use case</p>
+     * @public
+     */
+    aiAgentOrchestratorUseCase?: string | undefined;
+    /**
+     * <p>LLM model ID for request (e.g., anthropic.claude-3-sonnet)</p>
+     * @public
+     */
+    requestModel?: string | undefined;
+    /**
+     * <p>Maximum tokens configured for generation</p>
+     * @public
+     */
+    requestMaxTokens?: number | undefined;
+    /**
+     * <p>Sampling temperature for generation</p>
+     * @public
+     */
+    temperature?: number | undefined;
+    /**
+     * <p>Top-p sampling parameter for generation</p>
+     * @public
+     */
+    topP?: number | undefined;
+    /**
+     * <p>Actual model used for response (usually matches requestModel)</p>
+     * @public
+     */
+    responseModel?: string | undefined;
+    /**
+     * <p>Generation termination reasons (e.g., stop, max_tokens)</p>
+     * @public
+     */
+    responseFinishReasons?: string[] | undefined;
+    /**
+     * <p>Number of input tokens in prompt</p>
+     * @public
+     */
+    usageInputTokens?: number | undefined;
+    /**
+     * <p>Number of output tokens in response</p>
+     * @public
+     */
+    usageOutputTokens?: number | undefined;
+    /**
+     * <p>Total tokens consumed (input + output)</p>
+     * @public
+     */
+    usageTotalTokens?: number | undefined;
+    /**
+     * <p>Number of input tokens that were retrieved from cache</p>
+     * @public
+     */
+    cacheReadInputTokens?: number | undefined;
+    /**
+     * <p>Number of input tokens that were written to cache in this request</p>
+     * @public
+     */
+    cacheWriteInputTokens?: number | undefined;
+    /**
+     * <p>Input message collection sent to LLM</p>
+     * @public
+     */
+    inputMessages?: SpanMessage[] | undefined;
+    /**
+     * <p>Output message collection received from LLM</p>
+     * @public
+     */
+    outputMessages?: SpanMessage[] | undefined;
+    /**
+     * <p>System prompt instructions</p>
+     * @public
+     */
+    systemInstructions?: SpanMessageValue[] | undefined;
+    /**
+     * <p>AI prompt ARN</p>
+     * @public
+     */
+    promptArn?: string | undefined;
+    /**
+     * <p>AI prompt identifier</p>
+     * @public
+     */
+    promptId?: string | undefined;
+    /**
+     * <p>AI prompt type</p>
+     * @public
+     */
+    promptType?: AIPromptType | undefined;
+    /**
+     * <p>AI prompt name</p>
+     * @public
+     */
+    promptName?: string | undefined;
+    /**
+     * <p>AI prompt version number</p>
+     * @public
+     */
+    promptVersion?: number | undefined;
+}
+/**
+ * <p>A span represents a unit of work during AI agent execution, capturing timing, status, and contextual attributes.</p>
+ * @public
+ */
+export interface Span {
+    /**
+     * <p>Unique span identifier</p>
+     * @public
+     */
+    spanId: string | undefined;
+    /**
+     * <p>UUID of the Connect AI Assistant resource</p>
+     * @public
+     */
+    assistantId: string | undefined;
+    /**
+     * <p>UUID of the Connect AI Session resource</p>
+     * @public
+     */
+    sessionId: string | undefined;
+    /**
+     * <p>Parent span identifier for hierarchy. Null for root spans.</p>
+     * @public
+     */
+    parentSpanId?: string | undefined;
+    /**
+     * <p>Service-defined operation name</p>
+     * @public
+     */
+    spanName: string | undefined;
+    /**
+     * <p>Operation relationship type</p>
+     * @public
+     */
+    spanType: SpanType | undefined;
+    /**
+     * <p>Operation start time in milliseconds since epoch</p>
+     * @public
+     */
+    startTimestamp: Date | undefined;
+    /**
+     * <p>Operation end time in milliseconds since epoch</p>
+     * @public
+     */
+    endTimestamp: Date | undefined;
+    /**
+     * <p>Span completion status</p>
+     * @public
+     */
+    status: SpanStatus | undefined;
+    /**
+     * <p>The service request ID that initiated the operation</p>
+     * @public
+     */
+    requestId: string | undefined;
+    /**
+     * <p>Span-specific contextual attributes</p>
+     * @public
+     */
+    attributes: SpanAttributes | undefined;
+}
 /**
  * @public
  */
@@ -1341,3 +2841,18 @@ export interface QueryAssistantResponse {
      */
     nextToken?: string | undefined;
 }
+/**
+ * @public
+ */
+export interface ListSpansResponse {
+    /**
+     * <p>Array of span objects for the session</p>
+     * @public
+     */
+    spans: Span[] | undefined;
+    /**
+     * <p>Pagination token for retrieving additional results</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}