개념
agbrowse는 브라우저 primitive, Web-AI, 검색, evidence 네 계층입니다.
published bin은 얇게 유지하고, browser/Web-AI/search/검증 표면은 ESM 모듈로 분리합니다.
계층
| 계층 | 담당 | 제외 |
|---|---|---|
| Browser primitives | CDP 연결, tab, ref, screenshot, click/type/wait, 6단계 escalation ladder를 갖춘 adaptive fetch (identity header HTTP, TLS/JA3 impersonation, third-party reader, Camoufox/isolated browser, user session, human-in-the-loop). | Provider prompt 계약. |
| Web-AI | ChatGPT/Gemini/Grok send/poll/query, session, code artifact, source audit, capability registry (선언적 vendor별 기능 조회). | Hosted model API. |
| Search | 독립 deep search 파이프라인: query rewrite, adaptive-fetch 기반 후보 발견, 증거 채점, 선택적 web-ai deep escalation. | 자체 검색 엔진 API 클라이언트. |
| Evidence | Trace, fixture eval, claim audit, structure docs, release gates. | 근거 없는 marketing claim. |
Adaptive-fetch escalation ladder
agbrowse fetch는 단일 URL을 다단계 escalation 순서로 읽습니다. 각 단계는 content scorer를 실행해 결과가 충분한지, 다음 단계를 올려야 하는지 결정합니다.
- Public endpoint + 직접 HTTP: 브라우저급 identity header(User-Agent, Sec-Fetch-*, Accept-Language)를 포함합니다.
- TLS/JA3 impersonation: 403/429/challenge 응답 시 curl-impersonate로 브라우저 실행 없이 재시도합니다.
- Third-party reader (opt-in, 예: Jina Reader).
- Isolated browser render: Camoufox 또는 headless Chrome으로 네트워크 API 탐색을 포함합니다.
- User session (opt-in: 인증된 브라우저 프로필 재사용).
- Human-in-the-loop (interactive: 수동 challenge 해결).
Capability registry
Web-AI 계층은 각 provider와 model alias의 지원 기능(code mode, image output, deep research, context package, follow-up)을 선언적으로 매핑하는 capability registry를 포함합니다. 명령은 dispatch 시점에 registry를 참조하며, 대상 vendor에 선언되지 않은 기능을 요청하면 fail closed합니다.
Runway command surface
agbrowse runway 서브 명령은 Runway를 prompt-response provider가 아닌 media task-runner surface로 다룹니다. Selector contract, 현재 tab 상태, read-only preflight를 제공하며 generation submit 버튼은 절대 클릭하지 않습니다. 명령: runway selectors, runway status, runway open, runway preflight, runway poll.
Source of truth
명령은 structure/commands.md, 지원 라벨은 structure/CAPABILITY_TRUTH_TABLE.md, 검증 의무는 structure/release_gates.md를 기준으로 봅니다.