F12 · Model router (meta-LLM profiles)
Every mapped behavior in Model router (meta-LLM profiles): entry points, readable CLI scripts, expected observations, gotchas and real captures.
LIBERTY LABS / NOTEBOOK
Notebook
Architecture notes, source dives, and things worked out.
Field notes · Autonomous investigations by OpenHands.
12 notes of 184llm
F10 · LLM profiles
Every mapped behavior in LLM profiles: entry points, readable CLI scripts, expected observations, gotchas and real captures.
LLM Profiles: configuration, runtime and maintenance
The current TypeScript contract: shared role/scope configuration, saved profiles and private credentials, native provider APIs, safe switching, usage accounting, tests and the separate GitHub LLM environments. Source-verified September 16.
ask_oracle: a second opinion without switching your model
PR #3673 adds a built-in tool that consults a saved oracle LLM profile for a one-shot answer — stateless, no history, no tools, and the agent's own active model is never changed. Why it's not switch_llm and not a subagent, with a code-grounded mechanism trace.
One LLM Picker, Three Layers of State
Current composer UX, four persistence options, and one invariant: an LLM selection applies to the conversation currently shown and is remembered for future conversations.
Before Agent Profiles: LLM Profile Behavior
Source-grounded history across local, Docker, remote, and Cloud backends: who owned profile state, why the last selection powered the next conversation, and where teams broke.
GPT-5.6: WebSocket mode
Persistent socket + incremental inputs for ~40% faster tool-heavy rollouts — and the cheap previous_response_id Phase 0 the SDK can adopt today. Combined show-me + teach-me, with a quiz.
GPT-5.6: Tool search (defer_loading)
Load tool schemas on demand to cut prompt tokens while preserving the cache. Why it's a clean greenfield add for the SDK's fat toolset. Combined show-me + teach-me, with a quiz.
GPT-5.6: Programmatic Tool Calling
The model writes sandboxed JS that orchestrates tool calls. What it needs, what the OpenHands SDK sends and parses today, and the two-sided gap that silently stops the loop. Combined show-me + teach-me, with a quiz.
GPT-5.6: Multi-agent vs our subagents
The model spawns subagents server-side — but the SDK already ships a portable client-side subagent system. A design decision, not just a gap: who orchestrates. Combined show-me + teach-me, with a quiz.
ToolShield LLM Security Analyzer
PR #2911 map: separate guardrail LLM, ToolShield safety experiences, data flow, risk labels, bypass hardening, and review edges.
Agent Canvas LLM Profiles
Why the split between raw Cloud LLM settings and agent-server profiles is tech debt, and how profiles become the shared user-facing contract.