Skip to content

docs: document Omnigent host integration#93

Open
dgokeeffe wants to merge 3 commits into
mainfrom
docs/omnigent-host-integration
Open

docs: document Omnigent host integration#93
dgokeeffe wants to merge 3 commits into
mainfrom
docs/omnigent-host-integration

Conversation

@dgokeeffe

@dgokeeffe dgokeeffe commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

What does this PR do?

Documents the Omnigent host integration shipped in #92, including its opt-in deployment settings, required Apps and UC grants, runtime controls, and identity boundary.

The docs now match the final security design:

  • the app-SP client secret remains only in Flask process memory;
  • a loopback-only broker mints short-lived OAuth tokens;
  • [omnigents-host] stores only the workspace host;
  • agent helpers, the host tunnel, and spawned runners receive fresh tokens without a persisted client secret or static bearer.

Evidence

  • Documentation-only diff.
  • git diff --check.
  • Mojibake scan clean across the changed docs.
  • Commands and privilege names checked against Makefile and grant_omnigent_host.sh.
  • Deployed design evidence is recorded on fix(host): close Omnigent final-review gaps #100.

Add a README section explaining the Omnigent host integration merged in #92:
what it does, how to turn it on (with the app.yaml.lakemeter overlay), the
two-credential model (SP-OAuth host tunnel + AI-Gateway harness LLM), the
runtime control endpoints, and the ENABLE_SP_APIKEYHELPER pairing. Also add
the OMNIGENTS_* / ENABLE_SP_APIKEYHELPER rows to the env-var reference table.

The feature shipped in #92 with no user-facing docs (README had zero Omnigent
mentions); this closes that gap.
@dgokeeffe
dgokeeffe force-pushed the docs/omnigent-host-integration branch from 8185a6d to 557592b Compare July 18, 2026 13:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant