Amazon Q Connect: Added reasoning details, statusDescription, and timeToFirstTokenMs fields to the ListSpans response in Amazon Q in Connect to provide visibility into model thinking, error diagnostics, and inference latency metrics.

Author: aws-sdk-java-automation

.changes/next-release/feature-AmazonQConnect-223409d.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Q Connect",
+    "contributor": "",
+    "description": "Added reasoning details, statusDescription, and timeToFirstTokenMs fields to the ListSpans response in Amazon Q in Connect to provide visibility into model thinking, error diagnostics, and inference latency metrics."
+}

services/qconnect/src/main/resources/codegen-resources/service-2.json

@@ -10886,6 +10886,10 @@
           "shape":"SpanStatus",
           "documentation":"<p>Span completion status</p>"
         },
+        "statusDescription":{
+          "shape":"SpanStatusDescriptionString",
+          "documentation":"<p>Human-readable error description when status is ERROR or TIMEOUT</p>"
+        },
         "requestId":{
           "shape":"Uuid",
           "documentation":"<p>The service request ID that initiated the operation</p>"
@@ -11039,6 +11043,10 @@
         "promptVersion":{
           "shape":"Integer",
           "documentation":"<p>AI prompt version number</p>"
+        },
+        "timeToFirstTokenMs":{
+          "shape":"Integer",
+          "documentation":"<p>Time to first token in milliseconds, measured from when Amazon Bedrock was invoked to when the first token was returned</p>"
         }
       },
       "documentation":"<p>Contextual attributes capturing operation details, LLM configuration, usage metrics, and conversation data</p>"
@@ -11116,7 +11124,7 @@
         },
         "values":{
           "shape":"SpanMessageValueList",
-          "documentation":"<p>Message content values (text, tool use, tool result)</p>"
+          "documentation":"<p>Message content values (text, tool use, tool result, reasoning)</p>"
         }
       },
       "documentation":"<p>A message in the conversation history with participant role and content values</p>"
@@ -11141,9 +11149,10 @@
         "toolResult":{
           "shape":"SpanToolResultValue",
           "documentation":"<p>Tool result message content</p>"
-        }
+        },
+        "reasoning":{"shape":"SpanReasoningValue"}
       },
-      "documentation":"<p>Message content value - can be text, tool invocation, or tool result</p>",
+      "documentation":"<p>Message content value - can be text, tool invocation, tool result, or reasoning</p>",
       "union":true
     },
     "SpanMessageValueList":{
@@ -11157,6 +11166,17 @@
       "max":256,
       "min":1
     },
+    "SpanReasoningValue":{
+      "type":"structure",
+      "required":["value"],
+      "members":{
+        "value":{
+          "shape":"NonEmptySensitiveString",
+          "documentation":"<p>The reasoning text content</p>"
+        }
+      },
+      "documentation":"<p>Model reasoning and it's internal decision making process</p>"
+    },
     "SpanStatus":{
       "type":"string",
       "enum":[
@@ -11165,6 +11185,11 @@
         "TIMEOUT"
       ]
     },
+    "SpanStatusDescriptionString":{
+      "type":"string",
+      "max":1024,
+      "min":1
+    },
     "SpanTextValue":{
       "type":"structure",
       "required":["value"],