somew1nd
a45daf23f8
Report device actions as dispatched and preserve full failure details. Route Flash through McpActionExecutor and use ToolFailure across helper tools and agent loops instead of inferring failure from response text. Require model-provided descriptions for coordinate targets. Keep observed element metadata separate from those descriptions in safety checks, visual summaries, history, and frontend labels. Add Gemini Interactions API video analysis with configurable processing mode, chunk size, and timeouts. Centralize Google provider capabilities and token usage normalization, and update google-genai to 2.22.0. Preserve system instructions on follow-up interactions, replan pending chunks when falling back to static processing, and reject unanswered native video and audio segments instead of caching placeholder results. Keep helper-tool failure status intact through history tools and committee calls. Validation: 1,762 Python unit tests passed (3 skipped), 40 frontend formatter tests passed, and the production UI build completed. Ruff lint, formatting, the quality ratchet, and git diff checks passed.
129 lines
4.7 KiB
Python
129 lines
4.7 KiB
Python
# Copyright 2026 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
"""Failure classification and circuit breaking for video model calls.
|
|
|
|
Thin media-aware extension of :mod:`artemis.llm.reliability`, which owns the
|
|
generic taxonomy and circuit breaker. This module adds the media-processing
|
|
category and the ``should_split`` recovery decision (bisecting long clips).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from enum import StrEnum
|
|
|
|
from artemis.llm.reliability import (
|
|
CircuitBreaker,
|
|
FailureCategory,
|
|
classify_failure,
|
|
extract_status_code,
|
|
)
|
|
|
|
|
|
class VideoFailureCategory(StrEnum):
|
|
RATE_LIMIT = "rate_limit"
|
|
PROVIDER_UNAVAILABLE = "provider_unavailable"
|
|
TIMEOUT = "timeout"
|
|
CONNECTION = "connection"
|
|
AUTHENTICATION = "authentication"
|
|
BAD_REQUEST = "bad_request"
|
|
MEDIA_PROCESSING = "media_processing"
|
|
CANCELLED = "cancelled"
|
|
UNKNOWN = "unknown"
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class VideoFailure:
|
|
category: VideoFailureCategory
|
|
retryable: bool
|
|
should_split: bool
|
|
should_fallback: bool
|
|
|
|
|
|
_MEDIA_MARKERS = ("ffmpeg", "codec", "corrupt", "invalid video", "invalid audio", "media")
|
|
_AGENTIC_REJECTION_MARKERS = ("processing", "agentic")
|
|
|
|
|
|
class SubAgentAnswerExhausted(RuntimeError):
|
|
"""The sub-agent exhausted its turns without a valid submit_answer.
|
|
|
|
The caller records a failed segment so a later claim can retry it. The shared
|
|
classifier permits retries, splitting, and fallback for this failure.
|
|
"""
|
|
|
|
def __init__(self, turns: int, reason: str):
|
|
self.turns = turns
|
|
self.reason = reason
|
|
super().__init__(
|
|
f"submit_answer was not accepted within {turns} turn(s); last rejection: {reason}"
|
|
)
|
|
|
|
|
|
class AgenticVideoDegraded(RuntimeError):
|
|
"""Return an interval to the coordinator after switching to static mode.
|
|
|
|
The coordinator splits oversized clips and retries smaller clips as-is.
|
|
"""
|
|
|
|
|
|
def is_agentic_rejection(failure: VideoFailure, error: BaseException) -> bool:
|
|
"""True when a bad request is the API refusing agentic video processing.
|
|
|
|
Only an HTTP 400 whose message mentions ``processing`` / ``agentic``
|
|
qualifies; other bad requests (413 payload too large, 404, ...) keep the
|
|
shared handling.
|
|
"""
|
|
if failure.category is not VideoFailureCategory.BAD_REQUEST:
|
|
return False
|
|
if extract_status_code(error) != 400:
|
|
return False
|
|
message = str(error).lower()
|
|
return any(marker in message for marker in _AGENTIC_REJECTION_MARKERS)
|
|
|
|
|
|
def classify_video_failure(error: BaseException) -> VideoFailure:
|
|
"""Convert provider/transport/media exceptions into recovery decisions."""
|
|
if isinstance(error, AgenticVideoDegraded):
|
|
return VideoFailure(VideoFailureCategory.BAD_REQUEST, False, True, False)
|
|
generic = classify_failure(error)
|
|
message = str(error).lower()
|
|
has_media_marker = any(marker in message for marker in _MEDIA_MARKERS)
|
|
|
|
# Media markers take precedence over generic connection / bad-request /
|
|
# unknown classification (rate-limit, unavailable, timeout, and auth
|
|
# signals still win, matching the original ordering of checks).
|
|
if has_media_marker and generic.category in {
|
|
FailureCategory.CONNECTION,
|
|
FailureCategory.BAD_REQUEST,
|
|
FailureCategory.UNKNOWN,
|
|
}:
|
|
return VideoFailure(VideoFailureCategory.MEDIA_PROCESSING, False, True, True)
|
|
|
|
category = VideoFailureCategory(generic.category.value)
|
|
should_split = category in {VideoFailureCategory.TIMEOUT, VideoFailureCategory.UNKNOWN} or (
|
|
category is VideoFailureCategory.BAD_REQUEST and extract_status_code(error) == 413
|
|
)
|
|
# The video pipeline keeps its historical behavior of falling back to the
|
|
# universal analyzer even for bad requests (a different provider may accept
|
|
# the same media payload).
|
|
should_fallback = generic.should_fallback or category is VideoFailureCategory.BAD_REQUEST
|
|
if category is VideoFailureCategory.CANCELLED:
|
|
should_fallback = False
|
|
return VideoFailure(category, generic.retryable, should_split, should_fallback)
|
|
|
|
|
|
class VideoCircuitBreaker(CircuitBreaker):
|
|
"""Context-scoped circuit breaker keyed by provider/model identity."""
|