types-boto3-bedrock-runtime 1.40.61__py3-none-any.whl → 1.40.76__py3-none-any.whl

types_boto3_bedrock_runtime/type_defs.py

@@ -17,6 +17,7 @@ Usage::
 from __future__ import annotations
 
 import sys
+from collections.abc import Mapping, Sequence
 from datetime import datetime
 from typing import IO, Any, Union
 
@@ -49,19 +50,15 @@ from .literals import (
     GuardrailWordPolicyActionType,
     ImageFormatType,
     PerformanceConfigLatencyType,
+    ServiceTierTypeType,
     SortOrderType,
     StopReasonType,
     ToolResultStatusType,
+    ToolUseTypeType,
     TraceType,
     VideoFormatType,
 )
 
-if sys.version_info >= (3, 9):
-    from builtins import dict as Dict
-    from builtins import list as List
-    from collections.abc import Mapping, Sequence
-else:
-    from typing import Dict, List, Mapping, Sequence
 if sys.version_info >= (3, 12):
     from typing import Literal, NotRequired, TypedDict
 else:
@@ -217,11 +214,13 @@ __all__ = (
     "ResponseMetadataTypeDef",
     "ResponseStreamTypeDef",
     "S3LocationTypeDef",
+    "ServiceTierTypeDef",
     "ServiceUnavailableExceptionTypeDef",
     "SpecificToolChoiceTypeDef",
     "StartAsyncInvokeRequestTypeDef",
     "StartAsyncInvokeResponseTypeDef",
     "SystemContentBlockTypeDef",
+    "SystemToolTypeDef",
     "TagTypeDef",
     "ThrottlingExceptionTypeDef",
     "TimestampTypeDef",
@@ -229,7 +228,9 @@ __all__ = (
     "ToolChoiceTypeDef",
     "ToolConfigurationTypeDef",
     "ToolInputSchemaTypeDef",
+    "ToolResultBlockDeltaTypeDef",
     "ToolResultBlockOutputTypeDef",
+    "ToolResultBlockStartTypeDef",
     "ToolResultBlockTypeDef",
     "ToolResultBlockUnionTypeDef",
     "ToolResultContentBlockOutputTypeDef",
@@ -249,6 +250,7 @@ __all__ = (
     "VideoSourceOutputTypeDef",
     "VideoSourceTypeDef",
     "VideoSourceUnionTypeDef",
+    "WebLocationTypeDef",
 )
 
 
@@ -271,7 +273,7 @@ class GuardrailUsageTypeDef(TypedDict):
 class ResponseMetadataTypeDef(TypedDict):
     RequestId: str
     HTTPStatusCode: int
-    HTTPHeaders: Dict[str, str]
+    HTTPHeaders: dict[str, str]
     RetryAttempts: int
     HostId: NotRequired[str]
 
@@ -319,6 +321,11 @@ class DocumentPageLocationTypeDef(TypedDict):
     end: NotRequired[int]
 
 
+class WebLocationTypeDef(TypedDict):
+    url: NotRequired[str]
+    domain: NotRequired[str]
+
+
 class CitationSourceContentTypeDef(TypedDict):
     text: NotRequired[str]
 
@@ -337,6 +344,10 @@ class ReasoningContentBlockDeltaTypeDef(TypedDict):
     signature: NotRequired[str]
 
 
+class ToolResultBlockDeltaTypeDef(TypedDict):
+    text: NotRequired[str]
+
+
 ToolUseBlockDeltaTypeDef = TypedDict(
     "ToolUseBlockDeltaTypeDef",
     {
@@ -348,14 +359,26 @@ ToolUseBlockOutputTypeDef = TypedDict(
     {
         "toolUseId": str,
         "name": str,
-        "input": Dict[str, Any],
+        "input": dict[str, Any],
+        "type": NotRequired[ToolUseTypeType],
+    },
+)
+ToolResultBlockStartTypeDef = TypedDict(
+    "ToolResultBlockStartTypeDef",
+    {
+        "toolUseId": str,
+        "type": NotRequired[str],
+        "status": NotRequired[ToolResultStatusType],
+    },
+)
+ToolUseBlockStartTypeDef = TypedDict(
+    "ToolUseBlockStartTypeDef",
+    {
+        "toolUseId": str,
+        "name": str,
+        "type": NotRequired[ToolUseTypeType],
     },
 )
-
-
-class ToolUseBlockStartTypeDef(TypedDict):
-    toolUseId: str
-    name: str
 
 
 class ContentBlockStopEventTypeDef(TypedDict):
@@ -387,6 +410,14 @@ class PromptVariableValuesTypeDef(TypedDict):
     text: NotRequired[str]
 
 
+ServiceTierTypeDef = TypedDict(
+    "ServiceTierTypeDef",
+    {
+        "type": ServiceTierTypeType,
+    },
+)
+
+
 class TokenUsageTypeDef(TypedDict):
     inputTokens: int
     outputTokens: int
@@ -409,7 +440,7 @@ class MessageStartEventTypeDef(TypedDict):
 
 class MessageStopEventTypeDef(TypedDict):
     stopReason: StopReasonType
-    additionalModelResponseFields: NotRequired[Dict[str, Any]]
+    additionalModelResponseFields: NotRequired[dict[str, Any]]
 
 
 class ModelStreamErrorExceptionTypeDef(TypedDict):
@@ -497,7 +528,7 @@ GuardrailContextualGroundingFilterTypeDef = TypedDict(
 
 class GuardrailConverseTextBlockOutputTypeDef(TypedDict):
     text: str
-    qualifiers: NotRequired[List[GuardrailConverseContentQualifierType]]
+    qualifiers: NotRequired[list[GuardrailConverseContentQualifierType]]
 
 
 GuardrailConverseImageSourceOutputTypeDef = TypedDict(
@@ -601,6 +632,10 @@ class TagTypeDef(TypedDict):
     value: str
 
 
+class SystemToolTypeDef(TypedDict):
+    name: str
+
+
 class ToolInputSchemaTypeDef(TypedDict):
     json: NotRequired[Mapping[str, Any]]
 
@@ -611,6 +646,7 @@ ToolUseBlockTypeDef = TypedDict(
         "toolUseId": str,
         "name": str,
         "input": Mapping[str, Any],
+        "type": NotRequired[ToolUseTypeType],
     },
 )
 
@@ -624,6 +660,7 @@ class InvokeModelResponseTypeDef(TypedDict):
     body: StreamingBody
     contentType: str
     performanceConfigLatency: PerformanceConfigLatencyType
+    serviceTier: ServiceTierTypeType
     ResponseMetadata: ResponseMetadataTypeDef
 
 
@@ -665,6 +702,7 @@ class InvokeModelRequestTypeDef(TypedDict):
     guardrailIdentifier: NotRequired[str]
     guardrailVersion: NotRequired[str]
     performanceConfigLatency: NotRequired[PerformanceConfigLatencyType]
+    serviceTier: NotRequired[ServiceTierTypeType]
 
 
 class InvokeModelTokensRequestTypeDef(TypedDict):
@@ -680,9 +718,11 @@ class InvokeModelWithResponseStreamRequestTypeDef(TypedDict):
     guardrailIdentifier: NotRequired[str]
     guardrailVersion: NotRequired[str]
     performanceConfigLatency: NotRequired[PerformanceConfigLatencyType]
+    serviceTier: NotRequired[ServiceTierTypeType]
 
 
 class CitationLocationTypeDef(TypedDict):
+    web: NotRequired[WebLocationTypeDef]
     documentChar: NotRequired[DocumentCharLocationTypeDef]
     documentPage: NotRequired[DocumentPageLocationTypeDef]
     documentChunk: NotRequired[DocumentChunkLocationTypeDef]
@@ -690,6 +730,7 @@ class CitationLocationTypeDef(TypedDict):
 
 class ContentBlockStartTypeDef(TypedDict):
     toolUse: NotRequired[ToolUseBlockStartTypeDef]
+    toolResult: NotRequired[ToolResultBlockStartTypeDef]
 
 
 DocumentSourceOutputTypeDef = TypedDict(
@@ -698,7 +739,7 @@ DocumentSourceOutputTypeDef = TypedDict(
         "bytes": NotRequired[bytes],
         "s3Location": NotRequired[S3LocationTypeDef],
         "text": NotRequired[str],
-        "content": NotRequired[List[DocumentContentBlockTypeDef]],
+        "content": NotRequired[list[DocumentContentBlockTypeDef]],
     },
 )
 DocumentSourceTypeDef = TypedDict(
@@ -742,30 +783,30 @@ GuardrailAutomatedReasoningLogicWarningTypeDef = TypedDict(
     "GuardrailAutomatedReasoningLogicWarningTypeDef",
     {
         "type": NotRequired[GuardrailAutomatedReasoningLogicWarningTypeType],
-        "premises": NotRequired[List[GuardrailAutomatedReasoningStatementTypeDef]],
-        "claims": NotRequired[List[GuardrailAutomatedReasoningStatementTypeDef]],
+        "premises": NotRequired[list[GuardrailAutomatedReasoningStatementTypeDef]],
+        "claims": NotRequired[list[GuardrailAutomatedReasoningStatementTypeDef]],
     },
 )
 
 
 class GuardrailAutomatedReasoningScenarioTypeDef(TypedDict):
-    statements: NotRequired[List[GuardrailAutomatedReasoningStatementTypeDef]]
+    statements: NotRequired[list[GuardrailAutomatedReasoningStatementTypeDef]]
 
 
 class GuardrailAutomatedReasoningTranslationTypeDef(TypedDict):
-    premises: NotRequired[List[GuardrailAutomatedReasoningStatementTypeDef]]
-    claims: NotRequired[List[GuardrailAutomatedReasoningStatementTypeDef]]
-    untranslatedPremises: NotRequired[List[GuardrailAutomatedReasoningInputTextReferenceTypeDef]]
-    untranslatedClaims: NotRequired[List[GuardrailAutomatedReasoningInputTextReferenceTypeDef]]
+    premises: NotRequired[list[GuardrailAutomatedReasoningStatementTypeDef]]
+    claims: NotRequired[list[GuardrailAutomatedReasoningStatementTypeDef]]
+    untranslatedPremises: NotRequired[list[GuardrailAutomatedReasoningInputTextReferenceTypeDef]]
+    untranslatedClaims: NotRequired[list[GuardrailAutomatedReasoningInputTextReferenceTypeDef]]
     confidence: NotRequired[float]
 
 
 class GuardrailContentPolicyAssessmentTypeDef(TypedDict):
-    filters: List[GuardrailContentFilterTypeDef]
+    filters: list[GuardrailContentFilterTypeDef]
 
 
 class GuardrailContextualGroundingPolicyAssessmentTypeDef(TypedDict):
-    filters: NotRequired[List[GuardrailContextualGroundingFilterTypeDef]]
+    filters: NotRequired[list[GuardrailContextualGroundingFilterTypeDef]]
 
 
 GuardrailConverseImageBlockOutputTypeDef = TypedDict(
@@ -786,17 +827,17 @@ class GuardrailCoverageTypeDef(TypedDict):
 
 
 class GuardrailWordPolicyAssessmentTypeDef(TypedDict):
-    customWords: List[GuardrailCustomWordTypeDef]
-    managedWordLists: List[GuardrailManagedWordTypeDef]
+    customWords: list[GuardrailCustomWordTypeDef]
+    managedWordLists: list[GuardrailManagedWordTypeDef]
 
 
 class GuardrailSensitiveInformationPolicyAssessmentTypeDef(TypedDict):
-    piiEntities: List[GuardrailPiiEntityFilterTypeDef]
-    regexes: List[GuardrailRegexFilterTypeDef]
+    piiEntities: list[GuardrailPiiEntityFilterTypeDef]
+    regexes: list[GuardrailRegexFilterTypeDef]
 
 
 class GuardrailTopicPolicyAssessmentTypeDef(TypedDict):
-    topics: List[GuardrailTopicTypeDef]
+    topics: list[GuardrailTopicTypeDef]
 
 
 class InvokeModelWithBidirectionalStreamOutputTypeDef(TypedDict):
@@ -918,7 +959,7 @@ GuardrailImageBlockTypeDef = TypedDict(
 
 class CitationOutputTypeDef(TypedDict):
     title: NotRequired[str]
-    sourceContent: NotRequired[List[CitationSourceContentTypeDef]]
+    sourceContent: NotRequired[list[CitationSourceContentTypeDef]]
     location: NotRequired[CitationLocationTypeDef]
 
 
@@ -930,7 +971,7 @@ class CitationTypeDef(TypedDict):
 
 class CitationsDeltaTypeDef(TypedDict):
     title: NotRequired[str]
-    sourceContent: NotRequired[List[CitationSourceContentDeltaTypeDef]]
+    sourceContent: NotRequired[list[CitationSourceContentDeltaTypeDef]]
     location: NotRequired[CitationLocationTypeDef]
 
 
@@ -970,13 +1011,13 @@ VideoSourceUnionTypeDef = Union[VideoSourceTypeDef, VideoSourceOutputTypeDef]
 
 class GuardrailAutomatedReasoningImpossibleFindingTypeDef(TypedDict):
     translation: NotRequired[GuardrailAutomatedReasoningTranslationTypeDef]
-    contradictingRules: NotRequired[List[GuardrailAutomatedReasoningRuleTypeDef]]
+    contradictingRules: NotRequired[list[GuardrailAutomatedReasoningRuleTypeDef]]
     logicWarning: NotRequired[GuardrailAutomatedReasoningLogicWarningTypeDef]
 
 
 class GuardrailAutomatedReasoningInvalidFindingTypeDef(TypedDict):
     translation: NotRequired[GuardrailAutomatedReasoningTranslationTypeDef]
-    contradictingRules: NotRequired[List[GuardrailAutomatedReasoningRuleTypeDef]]
+    contradictingRules: NotRequired[list[GuardrailAutomatedReasoningRuleTypeDef]]
     logicWarning: NotRequired[GuardrailAutomatedReasoningLogicWarningTypeDef]
 
 
@@ -988,13 +1029,13 @@ class GuardrailAutomatedReasoningSatisfiableFindingTypeDef(TypedDict):
 
 
 class GuardrailAutomatedReasoningTranslationOptionTypeDef(TypedDict):
-    translations: NotRequired[List[GuardrailAutomatedReasoningTranslationTypeDef]]
+    translations: NotRequired[list[GuardrailAutomatedReasoningTranslationTypeDef]]
 
 
 class GuardrailAutomatedReasoningValidFindingTypeDef(TypedDict):
     translation: NotRequired[GuardrailAutomatedReasoningTranslationTypeDef]
     claimsTrueScenario: NotRequired[GuardrailAutomatedReasoningScenarioTypeDef]
-    supportingRules: NotRequired[List[GuardrailAutomatedReasoningRuleTypeDef]]
+    supportingRules: NotRequired[list[GuardrailAutomatedReasoningRuleTypeDef]]
     logicWarning: NotRequired[GuardrailAutomatedReasoningLogicWarningTypeDef]
 
 
@@ -1018,6 +1059,7 @@ class InvokeModelWithResponseStreamResponseTypeDef(TypedDict):
     body: EventStream[ResponseStreamTypeDef]
     contentType: str
     performanceConfigLatency: PerformanceConfigLatencyType
+    serviceTier: ServiceTierTypeType
     ResponseMetadata: ResponseMetadataTypeDef
 
 
@@ -1028,11 +1070,12 @@ ReasoningContentBlockUnionTypeDef = Union[
 
 class ToolTypeDef(TypedDict):
     toolSpec: NotRequired[ToolSpecificationTypeDef]
+    systemTool: NotRequired[SystemToolTypeDef]
     cachePoint: NotRequired[CachePointBlockTypeDef]
 
 
 class ListAsyncInvokesResponseTypeDef(TypedDict):
-    asyncInvokeSummaries: List[AsyncInvokeSummaryTypeDef]
+    asyncInvokeSummaries: list[AsyncInvokeSummaryTypeDef]
     ResponseMetadata: ResponseMetadataTypeDef
     nextToken: NotRequired[str]
 
@@ -1057,8 +1100,8 @@ class GuardrailContentBlockTypeDef(TypedDict):
 
 
 class CitationsContentBlockOutputTypeDef(TypedDict):
-    content: NotRequired[List[CitationGeneratedContentTypeDef]]
-    citations: NotRequired[List[CitationOutputTypeDef]]
+    content: NotRequired[list[CitationGeneratedContentTypeDef]]
+    citations: NotRequired[list[CitationOutputTypeDef]]
 
 
 CitationUnionTypeDef = Union[CitationTypeDef, CitationOutputTypeDef]
@@ -1067,6 +1110,7 @@ CitationUnionTypeDef = Union[CitationTypeDef, CitationOutputTypeDef]
 class ContentBlockDeltaTypeDef(TypedDict):
     text: NotRequired[str]
     toolUse: NotRequired[ToolUseBlockDeltaTypeDef]
+    toolResult: NotRequired[list[ToolResultBlockDeltaTypeDef]]
     reasoningContent: NotRequired[ReasoningContentBlockDeltaTypeDef]
     citation: NotRequired[CitationsDeltaTypeDef]
 
@@ -1091,7 +1135,7 @@ ImageBlockTypeDef = TypedDict(
 
 
 class ToolResultContentBlockOutputTypeDef(TypedDict):
-    json: NotRequired[Dict[str, Any]]
+    json: NotRequired[dict[str, Any]]
     text: NotRequired[str]
     image: NotRequired[ImageBlockOutputTypeDef]
     document: NotRequired[DocumentBlockOutputTypeDef]
@@ -1108,8 +1152,8 @@ VideoBlockTypeDef = TypedDict(
 
 
 class GuardrailAutomatedReasoningTranslationAmbiguousFindingTypeDef(TypedDict):
-    options: NotRequired[List[GuardrailAutomatedReasoningTranslationOptionTypeDef]]
-    differenceScenarios: NotRequired[List[GuardrailAutomatedReasoningScenarioTypeDef]]
+    options: NotRequired[list[GuardrailAutomatedReasoningTranslationOptionTypeDef]]
+    differenceScenarios: NotRequired[list[GuardrailAutomatedReasoningScenarioTypeDef]]
 
 
 class ToolConfigurationTypeDef(TypedDict):
@@ -1142,14 +1186,15 @@ class ContentBlockDeltaEventTypeDef(TypedDict):
 
 DocumentBlockUnionTypeDef = Union[DocumentBlockTypeDef, DocumentBlockOutputTypeDef]
 ImageBlockUnionTypeDef = Union[ImageBlockTypeDef, ImageBlockOutputTypeDef]
-
-
-class ToolResultBlockOutputTypeDef(TypedDict):
-    toolUseId: str
-    content: List[ToolResultContentBlockOutputTypeDef]
-    status: NotRequired[ToolResultStatusType]
-
-
+ToolResultBlockOutputTypeDef = TypedDict(
+    "ToolResultBlockOutputTypeDef",
+    {
+        "toolUseId": str,
+        "content": list[ToolResultContentBlockOutputTypeDef],
+        "status": NotRequired[ToolResultStatusType],
+        "type": NotRequired[str],
+    },
+)
 VideoBlockUnionTypeDef = Union[VideoBlockTypeDef, VideoBlockOutputTypeDef]
 
 
@@ -1159,8 +1204,8 @@ class GuardrailAutomatedReasoningFindingTypeDef(TypedDict):
     satisfiable: NotRequired[GuardrailAutomatedReasoningSatisfiableFindingTypeDef]
     impossible: NotRequired[GuardrailAutomatedReasoningImpossibleFindingTypeDef]
     translationAmbiguous: NotRequired[GuardrailAutomatedReasoningTranslationAmbiguousFindingTypeDef]
-    tooComplex: NotRequired[Dict[str, Any]]
-    noTranslations: NotRequired[Dict[str, Any]]
+    tooComplex: NotRequired[dict[str, Any]]
+    noTranslations: NotRequired[dict[str, Any]]
 
 
 class GuardrailConverseContentBlockTypeDef(TypedDict):
@@ -1195,7 +1240,7 @@ class ToolResultContentBlockTypeDef(TypedDict):
 
 
 class GuardrailAutomatedReasoningPolicyAssessmentTypeDef(TypedDict):
-    findings: NotRequired[List[GuardrailAutomatedReasoningFindingTypeDef]]
+    findings: NotRequired[list[GuardrailAutomatedReasoningFindingTypeDef]]
 
 
 GuardrailConverseContentBlockUnionTypeDef = Union[
@@ -1205,7 +1250,7 @@ GuardrailConverseContentBlockUnionTypeDef = Union[
 
 class MessageOutputTypeDef(TypedDict):
     role: ConversationRoleType
-    content: List[ContentBlockOutputTypeDef]
+    content: list[ContentBlockOutputTypeDef]
 
 
 ToolResultContentBlockUnionTypeDef = Union[
@@ -1233,26 +1278,31 @@ class ConverseOutputTypeDef(TypedDict):
     message: NotRequired[MessageOutputTypeDef]
 
 
-class ToolResultBlockTypeDef(TypedDict):
-    toolUseId: str
-    content: Sequence[ToolResultContentBlockUnionTypeDef]
-    status: NotRequired[ToolResultStatusType]
+ToolResultBlockTypeDef = TypedDict(
+    "ToolResultBlockTypeDef",
+    {
+        "toolUseId": str,
+        "content": Sequence[ToolResultContentBlockUnionTypeDef],
+        "status": NotRequired[ToolResultStatusType],
+        "type": NotRequired[str],
+    },
+)
 
 
 class ApplyGuardrailResponseTypeDef(TypedDict):
     usage: GuardrailUsageTypeDef
     action: GuardrailActionType
     actionReason: str
-    outputs: List[GuardrailOutputContentTypeDef]
-    assessments: List[GuardrailAssessmentTypeDef]
+    outputs: list[GuardrailOutputContentTypeDef]
+    assessments: list[GuardrailAssessmentTypeDef]
     guardrailCoverage: GuardrailCoverageTypeDef
     ResponseMetadata: ResponseMetadataTypeDef
 
 
 class GuardrailTraceAssessmentTypeDef(TypedDict):
-    modelOutput: NotRequired[List[str]]
-    inputAssessment: NotRequired[Dict[str, GuardrailAssessmentTypeDef]]
-    outputAssessments: NotRequired[Dict[str, List[GuardrailAssessmentTypeDef]]]
+    modelOutput: NotRequired[list[str]]
+    inputAssessment: NotRequired[dict[str, GuardrailAssessmentTypeDef]]
+    outputAssessments: NotRequired[dict[str, list[GuardrailAssessmentTypeDef]]]
     actionReason: NotRequired[str]
 
 
@@ -1287,6 +1337,7 @@ class ConverseStreamMetadataEventTypeDef(TypedDict):
     metrics: ConverseStreamMetricsTypeDef
     trace: NotRequired[ConverseStreamTraceTypeDef]
     performanceConfig: NotRequired[PerformanceConfigurationTypeDef]
+    serviceTier: NotRequired[ServiceTierTypeDef]
 
 
 class ConverseResponseTypeDef(TypedDict):
@@ -1294,9 +1345,10 @@ class ConverseResponseTypeDef(TypedDict):
     stopReason: StopReasonType
     usage: TokenUsageTypeDef
     metrics: ConverseMetricsTypeDef
-    additionalModelResponseFields: Dict[str, Any]
+    additionalModelResponseFields: dict[str, Any]
     trace: ConverseTraceTypeDef
     performanceConfig: PerformanceConfigurationTypeDef
+    serviceTier: ServiceTierTypeDef
     ResponseMetadata: ResponseMetadataTypeDef
 
 
@@ -1342,6 +1394,7 @@ class ConverseRequestTypeDef(TypedDict):
     additionalModelResponseFieldPaths: NotRequired[Sequence[str]]
     requestMetadata: NotRequired[Mapping[str, str]]
     performanceConfig: NotRequired[PerformanceConfigurationTypeDef]
+    serviceTier: NotRequired[ServiceTierTypeDef]
 
 
 class ConverseStreamRequestTypeDef(TypedDict):
@@ -1356,11 +1409,14 @@ class ConverseStreamRequestTypeDef(TypedDict):
     additionalModelResponseFieldPaths: NotRequired[Sequence[str]]
     requestMetadata: NotRequired[Mapping[str, str]]
     performanceConfig: NotRequired[PerformanceConfigurationTypeDef]
+    serviceTier: NotRequired[ServiceTierTypeDef]
 
 
 class ConverseTokensRequestTypeDef(TypedDict):
     messages: NotRequired[Sequence[MessageUnionTypeDef]]
     system: NotRequired[Sequence[SystemContentBlockTypeDef]]
+    toolConfig: NotRequired[ToolConfigurationTypeDef]
+    additionalModelRequestFields: NotRequired[Mapping[str, Any]]
 
 
 class CountTokensInputTypeDef(TypedDict):