[claude] Local mode: Client.local() + LocalRuntime (generated from sdk-codegen)

[cm2435-hcomp]

What

Adds local execution to the Python SDK (plan 002 of eng_plans/30-06-2026-agent-api-local-runtime):

from hai_agents import Client
client = Client.local()                      # installs/finds/spawns the runtime binary
session = client.run_session(agent=..., messages="...", tools=[...])

A new hai_agents.local package (LocalRuntime + Client.local/AsyncClient.local) manages the hai_agent_runtime binary — verified install, loopback spawn with a generated bearer token, health poll, cross-process attach/force-kill — then hands back a normal Client pointed at the local endpoint. Sessions, polling, custom tools, and answer schemas work unchanged.

Why

Local execution should be a first-class SDK target, not a HoloDesktop-private path. Base hai_agents stays lightweight — import hai_agents never loads hai_agents.local or touches the network; local mode is opt-in via the local extra.

How

This mirror's src/hai_agents/ is Fern-generated output; the hand-written local-mode code lives as .static overlays in agent_platform (companion PR #1452) and is copied in by generate.sh. This PR carries the generated result plus the mirror-owned pyproject.toml (the local extra) and tests.

Validation

• Mirror suite: 108 passed, 8 skipped (+28 tests)
• Regeneration survival proven — a real Docker/Fern regen reproduces this tree byte-for-byte (overlays survive)
• Live check passed against the real 0.1.8 binary via HAI_AGENT_LOCAL_BINARY_PATH (spawn, health, shutdown_if_idle through the generated client)

⛔ SHIP-GATE

The manifest's 3 literals (version + 2 sha256s) come from the overlay in #1452 and must repoint to the plan-005 release binary before merge.

Notes

Companion (required): agent_platform #1452 (the overlays). Consumer: holo-desktop-cli (plan 003) depends on the published hai-agents[local].

🤖 Generated with Claude Code