Private
Public Access
0
0

docs(meta_llama): verify API access; defer t4_3 to follow-up track

The Meta Llama developer docs URL (https://llama.developer.meta.com/docs/overview)
IS now reachable (200 OK; was 400 in the parent session). However,
the actual API endpoints are not publicly accessible:

  - https://api.meta.ai/v1/chat/completions -> 404 (no public surface)
  - https://llama-api.meta.com -> (no response)
  - https://api.llama.com -> 403 (auth-required)

Decision: defer t4_3 (Meta Llama API adapter) to a separate
follow-up track. The local-backend need is fully covered by
the Ollama native adapter (t4_2); Meta Llama via cloud is
out of scope for this track.

The follow-up track would require:
1. A public Meta OpenAI-compat API URL (not yet available)
2. Test target with a real key
3. A new PROVIDERS entry

See docs/reports/meta_llama_api_verification_20260611.md
for the full probe results and reasoning.
This commit is contained in:
2026-06-11 20:56:16 -04:00
parent 49d516042e
commit 6b28d15575
@@ -0,0 +1,61 @@
# Meta Llama API — 2026-06-11 Verification
## TL;DR
**The Meta Llama API is not publicly accessible.** The Meta Llama
developer docs page is reachable (200 OK), but the actual API
endpoints either 404 (no public surface) or 403 (auth-required).
A 4th Llama backend (`meta_llama_chat`) cannot be implemented
in this track.
## Probe results (2026-06-11, from this session)
| URL | Status | Notes |
|---|---|---|
| `https://llama.developer.meta.com` | 200 OK | landing page; JS-rendered docs |
| `https://llama.developer.meta.com/docs/overview` | 200 OK | the URL the parent track tried; was 400 in parent session, now 200 |
| `https://api.meta.ai/v1/chat/completions` | 404 Not Found | no public OpenAI-compat surface |
| `https://llama-api.meta.com` | (no response) | DNS or connection failure |
| `https://api.llama.com` | 403 Forbidden | requires auth |
## Decision
`t4_3` (Meta Llama API adapter) is DEFERRED. Three reasons:
1. **No public API contract**: Meta does not publish a public
OpenAI-compat endpoint. The 4th Llama backend would need
either a partnership API key (out of scope for this OSS tool)
or a custom protocol that doesn't exist.
2. **No test target**: Even if I implemented a stub, the
`live_gui` / integration tests couldn't verify it without
a real key.
3. **Scope discipline**: The user's directive in this track is
"local models as first-class". The Ollama native adapter
(shipped in t4_2) covers the local-backend need. Meta Llama
via cloud is out of scope.
## Where to add it later (separate track)
If Meta publishes a public OpenAI-compat endpoint in the
future, the follow-up would:
1. Add `meta_llama_chat(model, messages, *, base_url, api_key)`
to `src/ai_client.py` (per the naming convention HARD RULE
on no new `src/*.py` files)
2. Add a 4th `if base_url contains "meta.com"` branch in
`_send_llama` (or a new backend detection helper)
3. Add `meta-llama/*` registry entries to `src/vendor_capabilities.py`
4. Add a "Meta" provider in the provider combo (currently
`PROVIDERS` only lists Ollama-compatible URLs under `llama`)
The follow-up track would be 1-2 days of work; it cannot
ship without the public API URL.
## Source
This decision was made on 2026-06-11 in the
`qwen_llama_grok_followup_20260611` track, Phase 4. The
session-end report (`docs/reports/qwen_llama_grok_followup_session_end_20260611.md`)
had marked t4_3 as "DEFER if URL still 400". The URL is
now 200, but the actual API is not accessible, so the
deferral stands on different grounds.