chore: librarian generate pull request: 20260325T142734Z

.librarian/state.yaml

@@ -1551,7 +1551,7 @@ libraries:
     tag_format: '{id}-v{version}'
   - id: google-cloud-dialogflow-cx
     version: 2.4.0
-    last_generated_commit: 256b575f6915282b20795c13414b21f2c0af65db
+    last_generated_commit: 59d5f2b46924714af627ac29ea6de78641a00835
     apis:
       - path: google/cloud/dialogflow/cx/v3
         service_config: dialogflow_v3.yaml

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx/__init__.py

@@ -408,13 +408,17 @@
     Action,
     AgentUtterance,
     FlowInvocation,
+    FlowTraceMetadata,
     FlowTransition,
     OutputState,
     PlaybookInput,
     PlaybookInvocation,
     PlaybookOutput,
+    PlaybookTraceMetadata,
     PlaybookTransition,
+    SpeechProcessingMetadata,
     ToolUse,
+    TraceBlock,
     UserUtterance,
 )
 from google.cloud.dialogflowcx_v3.types.transition_route_group import (
@@ -770,12 +774,16 @@
     "Action",
     "AgentUtterance",
     "FlowInvocation",
+    "FlowTraceMetadata",
     "FlowTransition",
     "PlaybookInput",
     "PlaybookInvocation",
     "PlaybookOutput",
+    "PlaybookTraceMetadata",
     "PlaybookTransition",
+    "SpeechProcessingMetadata",
     "ToolUse",
+    "TraceBlock",
     "UserUtterance",
     "OutputState",
     "CreateTransitionRouteGroupRequest",

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/__init__.py

@@ -367,13 +367,17 @@
     Action,
     AgentUtterance,
     FlowInvocation,
+    FlowTraceMetadata,
     FlowTransition,
     OutputState,
     PlaybookInput,
     PlaybookInvocation,
     PlaybookOutput,
+    PlaybookTraceMetadata,
     PlaybookTransition,
+    SpeechProcessingMetadata,
     ToolUse,
+    TraceBlock,
     UserUtterance,
 )
 from .types.transition_route_group import (
@@ -636,6 +640,7 @@ def _get_version(dependency_name):
     "Flow",
     "FlowImportStrategy",
     "FlowInvocation",
+    "FlowTraceMetadata",
     "FlowTransition",
     "FlowValidationResult",
     "FlowsClient",
@@ -765,6 +770,7 @@ def _get_version(dependency_name):
     "PlaybookInput",
     "PlaybookInvocation",
     "PlaybookOutput",
+    "PlaybookTraceMetadata",
     "PlaybookTransition",
     "PlaybookVersion",
     "PlaybooksClient",
@@ -796,6 +802,7 @@ def _get_version(dependency_name):
     "SessionInfo",
     "SessionsClient",
     "SpeechModelVariant",
+    "SpeechProcessingMetadata",
     "SpeechToTextSettings",
     "SpeechWordInfo",
     "SsmlVoiceGender",
@@ -822,6 +829,7 @@ def _get_version(dependency_name):
     "ToolUse",
     "ToolVersion",
     "ToolsClient",
+    "TraceBlock",
     "TrainFlowRequest",
     "TransitionCoverage",
     "TransitionRoute",

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/__init__.py

@@ -345,13 +345,17 @@
     Action,
     AgentUtterance,
     FlowInvocation,
+    FlowTraceMetadata,
     FlowTransition,
     OutputState,
     PlaybookInput,
     PlaybookInvocation,
     PlaybookOutput,
+    PlaybookTraceMetadata,
     PlaybookTransition,
+    SpeechProcessingMetadata,
     ToolUse,
+    TraceBlock,
     UserUtterance,
 )
 from .transition_route_group import (
@@ -667,12 +671,16 @@
     "Action",
     "AgentUtterance",
     "FlowInvocation",
+    "FlowTraceMetadata",
     "FlowTransition",
     "PlaybookInput",
     "PlaybookInvocation",
     "PlaybookOutput",
+    "PlaybookTraceMetadata",
     "PlaybookTransition",
+    "SpeechProcessingMetadata",
     "ToolUse",
+    "TraceBlock",
     "UserUtterance",
     "OutputState",
     "CreateTransitionRouteGroupRequest",

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/intent.py

@@ -127,6 +127,9 @@ class Intent(proto.Message):
             understanding an intent like its scope, content,
             result etc. Maximum character limit: 140
             characters.
+        dtmf_pattern (str):
+            Optional. Matching DTMF pattern for the
+            intent.
     """
 
     class TrainingPhrase(proto.Message):
@@ -286,6 +289,10 @@ class Parameter(proto.Message):
         proto.STRING,
         number=8,
     )
+    dtmf_pattern: str = proto.Field(
+        proto.STRING,
+        number=16,
+    )
 
 
 class ListIntentsRequest(proto.Message):

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/session.py

@@ -36,6 +36,7 @@
     response_message,
     session_entity_type,
     tool_call,
+    trace,
 )
 from google.cloud.dialogflowcx_v3.types import intent as gcdc_intent
 
@@ -1639,6 +1640,13 @@ class QueryResult(proto.Message):
             Optional. Data store connection feature
             output signals. Filled only when data stores are
             involved in serving the query.
+        trace_blocks (MutableSequence[google.cloud.dialogflowcx_v3.types.TraceBlock]):
+            Optional. Contains the sequence of trace
+            blocks from the current conversation turn. Trace
+            blocks are ordered chronologically and contain
+            detailed traces of runtime behavior such as tool
+            calls, LLM calls, flow and playbook invocations,
+            agent utterances and user utterances.
     """
 
     text: str = proto.Field(
@@ -1743,6 +1751,11 @@ class QueryResult(proto.Message):
             message=data_store_connection.DataStoreConnectionSignals,
         )
     )
+    trace_blocks: MutableSequence[trace.TraceBlock] = proto.RepeatedField(
+        proto.MESSAGE,
+        number=37,
+        message=trace.TraceBlock,
+    )
 
 
 class TextInput(proto.Message):

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/trace.py

@@ -18,12 +18,17 @@
 from typing import MutableMapping, MutableSequence
 
 import google.protobuf.struct_pb2 as struct_pb2  # type: ignore
+import google.protobuf.timestamp_pb2 as timestamp_pb2  # type: ignore
 import proto  # type: ignore
 
 __protobuf__ = proto.module(
     package="google.cloud.dialogflow.cx.v3",
     manifest={
         "OutputState",
+        "TraceBlock",
+        "SpeechProcessingMetadata",
+        "PlaybookTraceMetadata",
+        "FlowTraceMetadata",
         "PlaybookInput",
         "PlaybookOutput",
         "Action",
@@ -64,6 +69,159 @@ class OutputState(proto.Enum):
     OUTPUT_STATE_PENDING = 5
 
 
+class TraceBlock(proto.Message):
+    r"""The trace block tracks a sequence of actions taken by the
+    agent in a flow or a playbook.
+
+    This message has `oneof`_ fields (mutually exclusive fields).
+    For each oneof, at most one member field can be set at the same time.
+    Setting any member of the oneof automatically clears all other
+    members.
+
+    .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+    Attributes:
+        playbook_trace_metadata (google.cloud.dialogflowcx_v3.types.PlaybookTraceMetadata):
+            Metadata of the playbook trace.
+
+            This field is a member of `oneof`_ ``trace_metadata``.
+        flow_trace_metadata (google.cloud.dialogflowcx_v3.types.FlowTraceMetadata):
+            Metadata of the flow trace.
+
+            This field is a member of `oneof`_ ``trace_metadata``.
+        speech_processing_metadata (google.cloud.dialogflowcx_v3.types.SpeechProcessingMetadata):
+            Metadata of the speech-to-text and
+            speech-to-text processing.
+
+            This field is a member of `oneof`_ ``trace_metadata``.
+        actions (MutableSequence[google.cloud.dialogflowcx_v3.types.Action]):
+            The actions performed by the agent and the
+            user during this session.
+        start_time (google.protobuf.timestamp_pb2.Timestamp):
+            Output only. Timestamp of the start of the
+            trace block.
+        complete_time (google.protobuf.timestamp_pb2.Timestamp):
+            Output only. Timestamp of the end of the
+            trace block.
+        input_parameters (google.protobuf.struct_pb2.Struct):
+            Optional. A list of input parameters of the
+            trace block.
+        output_parameters (google.protobuf.struct_pb2.Struct):
+            Optional. A list of output parameters of the
+            trace block.
+        end_state (google.cloud.dialogflowcx_v3.types.OutputState):
+            Optional. Output only. The end state of the
+            trace block.
+    """
+
+    playbook_trace_metadata: "PlaybookTraceMetadata" = proto.Field(
+        proto.MESSAGE,
+        number=1,
+        oneof="trace_metadata",
+        message="PlaybookTraceMetadata",
+    )
+    flow_trace_metadata: "FlowTraceMetadata" = proto.Field(
+        proto.MESSAGE,
+        number=2,
+        oneof="trace_metadata",
+        message="FlowTraceMetadata",
+    )
+    speech_processing_metadata: "SpeechProcessingMetadata" = proto.Field(
+        proto.MESSAGE,
+        number=8,
+        oneof="trace_metadata",
+        message="SpeechProcessingMetadata",
+    )
+    actions: MutableSequence["Action"] = proto.RepeatedField(
+        proto.MESSAGE,
+        number=3,
+        message="Action",
+    )
+    start_time: timestamp_pb2.Timestamp = proto.Field(
+        proto.MESSAGE,
+        number=4,
+        message=timestamp_pb2.Timestamp,
+    )
+    complete_time: timestamp_pb2.Timestamp = proto.Field(
+        proto.MESSAGE,
+        number=5,
+        message=timestamp_pb2.Timestamp,
+    )
+    input_parameters: struct_pb2.Struct = proto.Field(
+        proto.MESSAGE,
+        number=9,
+        message=struct_pb2.Struct,
+    )
+    output_parameters: struct_pb2.Struct = proto.Field(
+        proto.MESSAGE,
+        number=6,
+        message=struct_pb2.Struct,
+    )
+    end_state: "OutputState" = proto.Field(
+        proto.ENUM,
+        number=7,
+        enum="OutputState",
+    )
+
+
+class SpeechProcessingMetadata(proto.Message):
+    r"""Metadata of the speech-to-text and text-to-speech processing.
+
+    Attributes:
+        display_name (str):
+            Output only. The display name of the speech
+            processing.
+    """
+
+    display_name: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+
+
+class PlaybookTraceMetadata(proto.Message):
+    r"""Metadata of the playbook trace.
+
+    Attributes:
+        playbook (str):
+            Required. The unique identifier of the playbook. Format:
+            ``projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>``.
+        display_name (str):
+            Output only. The display name of the
+            playbook.
+    """
+
+    playbook: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+    display_name: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
+
+
+class FlowTraceMetadata(proto.Message):
+    r"""Metadata of the flow trace.
+
+    Attributes:
+        flow (str):
+            Required. The unique identifier of the flow. Format:
+            ``projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>``.
+        display_name (str):
+            Output only. The display name of the flow.
+    """
+
+    flow: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+    display_name: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
+
+
 class PlaybookInput(proto.Message):
     r"""Input of the playbook.