SPB Git forge

spb/doc-api

Public
2commits 1branches 0releases
15.7 MBsize
maindefault branch
13 days agolast push
Python 88.3% TypeScript 7.6% Shell 4.1%
8.8 KB · 39 lines json
Raw Blame History
1{2  "domain": "anthropic-advanced",3  "generated_at": "2026-09-18T00:00:00Z",4  "run_instructions": {5    "sh": "bash examples/anthropic/<area>/<file>.sh   (sources scripts/lib.sh; needs .env; jq + python3 for fillers)",6    "py": ".venv/bin/python examples/anthropic/<area>/<file>.py   (anthropic SDK 1.7; logs via scripts/live.py)",7    "ts": "node --env-file=.env --experimental-strip-types examples/anthropic/<area>/<file>.ts   (@anthropic-ai/sdk 0.126, Node >= 22.6)",8    "env": "ANTHROPIC_API_KEY in .env; optional ANTHROPIC_MODEL override (defaults: claude-haiku-4-5-20251001; claude-sonnet-5 for adaptive thinking / effort / compaction)"9  },10  "records": [11    {"provider": "anthropic", "area": "prompt-caching", "file": "examples/anthropic/prompt-caching/cache_system_prompt.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "Explicit breakpoint on a ~5.3k-token system block, two calls. Cold probe: write 5809 then read 5809; example run hit a warm cache (read 5251 both calls). ~$0.004."},12    {"provider": "anthropic", "area": "prompt-caching", "file": "examples/anthropic/prompt-caching/cache_system_prompt.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "SDK: explicit write/read, top-level automatic cache_control (read 5251 + creation 7), 1h TTL on a fresh prefix (cache_creation.ephemeral_1h_input_tokens 5251). ~$0.015."},13    {"provider": "anthropic", "area": "prompt-caching", "file": "examples/anthropic/prompt-caching/cache_tools.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "cache_control on the last of 6 tools: creation 6902 then read 6902. ~$0.011."},14    {"provider": "anthropic", "area": "thinking", "file": "examples/anthropic/thinking/extended_thinking.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "thinking enabled budget 1024 on Haiku: [thinking(signature), text '4'], output_tokens_details.thinking_tokens 41. ~$0.0003."},15    {"provider": "anthropic", "area": "thinking", "file": "examples/anthropic/thinking/thinking_tool_roundtrip.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "Turn 1 [thinking, tool_use] (37 thinking tokens); turn 2 passes thinking block back with tool_result -> text; stream shows 6 thinking_delta + 1 signature_delta then text_delta. ~$0.002."},16    {"provider": "anthropic", "area": "thinking", "file": "examples/anthropic/thinking/adaptive_effort.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "claude-sonnet-5 adaptive thinking: effort low -> no thinking block; effort max -> thinking block (49 tokens). Answer '4' both times. ~$0.0007."},17    {"provider": "anthropic", "area": "structured-output", "file": "examples/anthropic/structured-output/json_schema.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "output_config.format json_schema -> {\"name\":\"Ada\",\"age\":36,\"city\":\"Lyon\"} (re-parsed by jq). ~$0.0003."},18    {"provider": "anthropic", "area": "structured-output", "file": "examples/anthropic/structured-output/json_schema_pydantic.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "messages.parse() with a Pydantic model -> parsed_output Person; raw output_config call; `minimum` keyword -> 400 'property minimum is not supported'. ~$0.0006."},19    {"provider": "anthropic", "area": "structured-output", "file": "examples/anthropic/structured-output/json_schema_stream.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "Streaming JSON output (3 text_delta chunks) parsed after finalMessage(); count_tokens with output_config.format = 205. ~$0.0003."},20    {"provider": "anthropic", "area": "files", "file": "examples/anthropic/files/files_lifecycle.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "Upload text (expires_in_seconds 3600) 200, list 200 {data,next_page}, retrieve 200, document file_id in Messages -> 'Green.' (66 tokens), /content 400 not downloadable, delete 200. Free except ~$0.0001."},21    {"provider": "anthropic", "area": "files", "file": "examples/anthropic/files/files_pdf_reference.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "client.files.upload of a generated 1-page PDF (607 B), document file_id with citations -> page_location citation carrying file_id (2128 input tokens), list ids filter, delete. ~$0.002."},22    {"provider": "anthropic", "area": "files", "file": "examples/anthropic/files/files_image_reference.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "toFile upload of a 1x1 PNG (69 B, image/png), image file_id -> 'Red' (21 input tokens), retrieveMetadata, delete. ~$0.0001."},23    {"provider": "anthropic", "area": "citations", "file": "examples/anthropic/citations/citations_text_document.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "text document + citations.enabled -> char_location 17-32 'Grass is green.'. ~$0.0007."},24    {"provider": "anthropic", "area": "citations", "file": "examples/anthropic/citations/citations_search_results.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "search_result block -> search_result_location (index 0, blocks 1-2); custom content document -> content_block_location (SDK model also exposes file_id: None). ~$0.0015."},25    {"provider": "anthropic", "area": "citations", "file": "examples/anthropic/citations/citations_stream.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "1 citations_delta event (char_location) captured via streamEvent; finalMessage text block has 1 citation. ~$0.0007."},26    {"provider": "anthropic", "area": "context-management", "file": "examples/anthropic/context-management/context_editing.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "beta context-management-2025-06-27, clear_tool_uses_20250919 trigger 1 keep 1: applied_edits cleared_tool_uses 2 / cleared_input_tokens 174; count_tokens 840 vs original_input_tokens 930. ~$0.001."},27    {"provider": "anthropic", "area": "context-management", "file": "examples/anthropic/context-management/compaction_config.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "beta compact-2026-01-12 compact_20260112 on claude-sonnet-5: accepted, usage.iterations [message], applied_edits []; Haiku -> 400 does not support compact_20260112. ~$0.0002. Threshold never reached (needs >= 50k tokens)."},28    {"provider": "anthropic", "area": "context-management", "file": "examples/anthropic/context-management/compaction_on_demand.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "beta compact-2026-09-04 compaction {type: summarize} on claude-sonnet-5: signed compaction block, stop_reason compaction, iterations [{type: compaction, out 69}]; continuation with the block first -> 'Ada, your favorite color: teal.' ~$0.002."},29    {"provider": "anthropic", "area": "vision", "file": "examples/anthropic/vision/image_base64.sh", "language": "bash", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "1x1 red PNG base64 -> 'Red', 21 input tokens. ~$0.00004."},30    {"provider": "anthropic", "area": "vision", "file": "examples/anthropic/vision/pdf_and_text_document.py", "language": "python", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "base64 1-page PDF -> 'Green.' 1611 tokens; text/plain document 56 tokens; count_tokens(1x1 PNG + text) 15; transformations.oversized_image accepted. ~$0.002."},31    {"provider": "anthropic", "area": "vision", "file": "examples/anthropic/vision/image_url.ts", "language": "typescript", "status": "LIVE_VERIFIED", "verified_at": "2026-09-18", "notes": "URL image (httpbin.org/image/png) + base64 PNG in one request: 'Pink cartoon pig face…' / 'Red', 59 input tokens. Wikimedia thumbnail URLs fail with 400 'Unable to download the file'. ~$0.0003."}32  ],33  "not_provided": {34    "fast-mode": "ACCOUNT_RESTRICTED: speed:'fast' on claude-opus-5 with fast-mode-2026-02-01 returns 429 'rate limit of 0 fast mode input tokens per minute' for this organization; request shape documented in docs/anthropic/fast-mode.md and the parameters fragment.",35    "effort-per-message": "Beta mid-conversation-output-config-2026-07-01 requires Fable 5.1 / Mythos 5.1 / Opus 5 (Sonnet 5 -> 400); not exercised on a supported model to keep cost minimal (Opus 5 tiny call would be ~$0.0002 — probe recorded in tmp-live as 400 on Sonnet 5 only)."36  },37  "live_probe_log": "tmp-live/anthropic-advanced/*.json (100 sanitized responses, ~$0.052) + reports/live-requests.jsonl notes prefixed 'atlas-anthropic-advanced' / 'example ' / 'test_'"38}39