spb/doc-api

1{2 "provider": "gemini",3 "domain": "tools + interactions + live + file-search",4 "generated_at": "2026-09-18",5 "runner": "tmp-live/gemini-tools/run_live.py + run_live_ws.py (raw sanitized responses tmp-live/gemini-tools/*.json, summary _summary.json); scripts below were executed directly on 2026-09-18 unless noted",6 "count": 26,7 "examples": [8  {"provider": "gemini", "area": "tools/function-calling", "file": "examples/gemini/tools/function-calling/function_calling.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed: forced call, functionResponse, parallel, parametersJsonSchema (4 × HTTP 200, gemini-3.5-flash-lite)"},9  {"provider": "gemini", "area": "tools/function-calling", "file": "examples/gemini/tools/function-calling/forced_call.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed (2 × 200)"},10  {"provider": "gemini", "area": "tools/function-calling", "file": "examples/gemini/tools/function-calling/function_calling.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed with @google/genai 2.23 (node --experimental-strip-types)"},11  {"provider": "gemini", "area": "tools/google-search", "file": "examples/gemini/tools/google-search/grounding.py", "language": "python", "status": "FAILED_VERIFICATION", "verified_at": "2026-09-18", "notes": "executed; HTTP 429 RESOURCE_EXHAUSTED on gemini-3.5-flash-lite and gemini-3.5-flash → ACCOUNT_RESTRICTED (Search grounding quota 0 on this key)"},12  {"provider": "gemini", "area": "tools/url-context", "file": "examples/gemini/tools/url-context/url_context.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; urlContextMetadata observed (URL_RETRIEVAL_STATUS_ERROR for example.com)"},13  {"provider": "gemini", "area": "tools/code-execution", "file": "examples/gemini/tools/code-execution/code_execution.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; executableCode + codeExecutionResult parts"},14  {"provider": "gemini", "area": "tools/code-execution", "file": "examples/gemini/tools/code-execution/code_execution.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed"},15  {"provider": "gemini", "area": "tools/google-maps", "file": "examples/gemini/tools/google-maps/maps_grounding.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; groundingChunks[].maps{uri,title,text,placeId}"},16  {"provider": "gemini", "area": "tools/computer-use", "file": "examples/gemini/tools/computer-use/computer_use_interactions.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "probe mode executed (Interactions computer_use tool accepted, 200 completed); --loop (Playwright) is DOCUMENTED only; legacy generateContent computerUse on the 2.5 model → 429 ACCOUNT_RESTRICTED"},17  {"provider": "gemini", "area": "file-search", "file": "examples/gemini/file-search/file_search_lifecycle.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed end-to-end incl. cleanup (store + document deleted with force=true)"},18  {"provider": "gemini", "area": "file-search", "file": "examples/gemini/file-search/file_search_lifecycle.sh", "language": "bash", "status": "UNVERIFIED", "verified_at": "2026-09-18", "notes": "NOT executed; identical raw requests ran via tmp-live/gemini-tools/run_live.py step g (all 200)"},19  {"provider": "gemini", "area": "file-search", "file": "examples/gemini/file-search/file_search.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; SDK uploadToFileSearchStore + operations.get polling + fileSearch query + delete(force)"},20  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/create.sh", "language": "bash", "status": "UNVERIFIED", "verified_at": "2026-09-18", "notes": "NOT executed; identical raw requests ran via run_live.py step h (create/stream/get/delete all 200)"},21  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/interactions_basic.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed after fixing the terminal 'data: [DONE]' SSE frame; create/stream/chain/get/store=false/delete"},22  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/interactions_tools.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; requires_action → function_result → completed"},23  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/deep_research_background.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "NOT re-executed as a script; identical requests ran via run_live.py step h8 (create in_progress → cancel cancelled → delete 200)"},24  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/environments.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; list/create/get/files/delete (files root → 200 {} here, 404 in the runner)"},25  {"provider": "gemini", "area": "interactions", "file": "examples/gemini/interactions/interactions.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed after two SDK-shape fixes (snake_case params; positional id for get/delete)"},26  {"provider": "gemini", "area": "live", "file": "examples/gemini/live/live_ws_audio.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; AUDIO turn on gemini-2.5-flash-native-audio-latest, transcript 'OK', 28800 bytes PCM 24 kHz"},27  {"provider": "gemini", "area": "live", "file": "examples/gemini/live/live_sdk.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; google-genai client.aio.live.connect"},28  {"provider": "gemini", "area": "live", "file": "examples/gemini/live/live_sdk.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; @google/genai ai.live.connect callbacks (no inlineData in that short run, transcript 'OK.')"},29  {"provider": "gemini", "area": "live", "file": "examples/gemini/live/ephemeral_token.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; POST /v1alpha/auth_tokens → 200 {name} (token not printed)"},30  {"provider": "gemini", "area": "live", "file": "examples/gemini/live/ephemeral_token.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; token → BidiGenerateContentConstrained (v1alpha, Authorization: Token) → setupComplete … turnComplete"},31  {"provider": "gemini", "area": "shared/tool-loop", "file": "examples/shared/tool-loop/gemini_tool_loop.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed; parallel get_weather+get_time round trip"},32  {"provider": "gemini", "area": "shared/tool-loop", "file": "examples/shared/tool-loop/gemini_tool_loop.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "executed"},33  {"provider": "gemini", "area": "tests", "file": "tests/gemini/test_tools.py + test_interactions.py + test_live.py + test_file_search.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "cheap tests pass (14 passed, 6 skipped gated); first run hit HTTP 429 too_many_requests on /v1beta/interactions after a burst, clean on retry"}34 ]35}36