Recommended action: Upgrade @openai/agents-realtime to >= 0.4.8; if the new error appears, check for early disconnects (auth/ephemeral key, network) and retry connect(). Fix: Upgrade to >= 0.4.8 [evidence: released_fix] Steps: 1. Do not start audio until connect() resolves 2. Han
Recommended action: Upgrade Claude Code; run /compact (or /clear); resolve the underlying error named after 'automatic compaction failed:' first. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Use client.models.count_tokens (server-side) for unlisted models or multimodal content; run local tokenization in Node.js/Python only. Option: Use server count_tokens [evidence: documented_workaround] Steps: 1. client.models.count_tokens(model=..., contents=..
Recommended action: Pass poll: { timeoutMs, intervalMs } sized for the model, or use startVideo/getVideoStatus (or webhooks) to persist the operation and resume polling outside a single request. Option: Set poll.timeoutMs higher [evidence: official_recommended_action] Steps: 1. O
Recommended action: Use channel 'chromium' (bundled) unless you need branded Chrome; or preinstall Google Chrome in the image. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: kubectl describe pod to read the exact missing key/object; create it in the Pod's namespace with the exact key name (keys are case-sensitive), or mark the reference optional: true if absence is acceptable. The Pod retries once the
Recommended action: Fetch the image yourself and pass bytes/base64 (Uint8Array or data) instead of a URL. Option: Download the image [evidence: official_recommended_action] Steps: 1. Pass bytes/base64 to prompt.images Expected: The call succeeds or the failure is handled delibera
Recommended action: Use speech_config.voice_config with a single prebuilt voice in Live; use generate_content TTS models for multi-speaker audio. Option: Use single voice in Live [evidence: documented_workaround] Steps: 1. speech_config={'voice_config':{'prebuilt_voice_config':{'
Recommended action: Install with aider-install, uv, or pipx into an isolated environment; avoid upgrading pinned deps (esp. litellm). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Map a shorter claim to google.subject (or shorten repo/branch names); the auth action docs say the only mitigation is shorter repo or branch names. Option: Shorten the mapped value [evidence: documented_workaround] Applies when: Long branch/repo names Steps: 1
Recommended action: Pass the image as bytes/base64 (or a gs:// URI on Vertex) and check result.warnings in tests. Option: Download the image and pass bytes [evidence: official_recommended_action] Steps: 1. Or use a gs:// URI 2. Assert no warnings Expected: The
Recommended action: Create the client with genai.Client(http_options={'api_version': 'v1alpha', ...}) (or new GoogleGenAI({httpOptions})) and remove http_options from LiveConnectConfig. Option: Move http options to the client [evidence: official_recommended_action] Steps: 1. clie
Recommended action: Check 'Did you mean' suggestions for typos; set listed env vars (restart terminal after setx on Windows); add model metadata via advanced model settings. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Use the error text to pick the layer; verify workload_identity_provider is the full provider path with the project NUMBER (not ID, not pool); set permissions id-token: write; map every attribute used in conditions/principals and match GitHub claim capitalizati
Recommended action: Configure ADC / service-account credentials (googleAuthOptions) instead of apiKey for these model types; keep Express Mode only for supported Gemini calls. Option: Drop apiKey for these models [evidence: official_recommended_action] Steps: 1. Authenticate with
Recommended action: Use session.send_client_content(turns=..., turn_complete=True) for text turns, session.send_realtime_input(audio=/video=/text=) for streaming media, and session.send_tool_response(function_responses=...) for tool results. Option: Use specific send methods [evi
Recommended action: Ask for smaller changes, drop files, use a diff-capable stronger model or infinite-output model; test without an API proxy. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Describe the edit region in the prompt and pass the source image as a reference image; use a provider that supports masks if pixel-precise inpainting is required. Option: Remove mask [evidence: official_recommended_action] Steps: 1. Describe the edit in
Recommended action: Keep your own copy of uploaded content; only download files whose download_uri is set (source GENERATED). Option: Check download_uri [evidence: documented_workaround] Steps: 1. if f.download_uri: client.files.download(file=f) 2. else use your original copy Exp