Skip to content

feat(inference): route DNS-backed HTTPS endpoints with scoped credentials - #7188

Merged
cv merged 32 commits into
mainfrom
codex/6141-route-scoped-credentials
Jul 26, 2026
Merged

feat(inference): route DNS-backed HTTPS endpoints with scoped credentials#7188
cv merged 32 commits into
mainfrom
codex/6141-route-scoped-credentials

Conversation

@apurvvkumaria

@apurvvkumaria apurvvkumaria commented Jul 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

Carries forward the original implementation from #6906 and closes its blocking cross-route credential-isolation gap. inference set --endpoint-url can now use DNS-backed HTTPS custom endpoints through a pinned host adapter while every sandbox-facing route receives its own credential and the real upstream secret remains host-only.

Related Issue

Fixes #6141

Changes

  • Add the HTTPS Pin Runtime adapter for DNS-backed HTTPS endpoints used by inference set on already-onboarded OpenClaw and Hermes sandboxes. Direct IP substitution cannot preserve TLS SNI/certificate validation, so the adapter resolves and validates the public peer on the host, connects to the pinned address with the original hostname, and exposes only an opaque host.openshell.internal route to OpenShell.
  • Derive a distinct data-plane credential for each route from a host-only control secret and a non-secret route generation. Route A's credential cannot authorize route B, upstream credentials are never persisted, and the control token is never sent in health probes or registered with OpenShell. Adversarial two-route, restart, token-revocation, and state-sanitization regressions protect these boundaries.
  • Apply provider credentials through invocation-local OpenShell environments, verify exact provider identity/version convergence, and serialize route registration, registry commits, replacement cleanup, and destroy cleanup under the shared gateway route lock.
  • Revoke unreferenced routes after successful switches and confirmed sandbox destruction, preserve referenced routes and shared-adapter state during scoped uninstall, and purge the adapter during full uninstall.
  • Harden the adapter's URL, path, source-network, HTTP-method, body-size, timeout, TLS, and process-recovery boundaries; keep logs and persisted recovery metadata free of endpoint URLs and credentials.
  • Restrict adapter data-plane requests to loopback and the exact IPAM subnets inspected from the openshell-docker network. Reject unrelated RFC1918, ULA, and link-local peers, fail closed when no valid bridge CIDR is available, and bind adapter reuse proofs to the source-policy digest.
  • Bound connection setup, TLS negotiation, and response streaming with one total upstream deadline; discard late responses, preserve /v1 for bare-origin OpenAI endpoints, recognize persisted routes across adapter-port changes, restrict health metadata to admitted sources, and register upstream route credentials only through the authenticated loopback control plane after spawn.
  • Update endpoint-security, command, and troubleshooting guidance, plus unit, integration, and live E2E coverage for the pinned HTTPS route.

Type of Change

  • Code change (feature, bug fix, or refactor)
  • Code change with doc updates
  • Doc only (prose changes, no code sample modifications)
  • Doc only (includes code sample changes)

Quality Gates

  • Tests added or updated for changed behavior
  • Existing tests cover changed behavior — justification:
  • Tests not applicable — justification:
  • Docs updated for user-facing behavior changes
  • Docs not applicable — justification:
  • Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
  • Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification: Independent exact-head security audit completed locally; human security review requested from senthilr-nv.
  • Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Documentation Writer Review

  • Documentation writer subagent reviewed the completed changes
  • Result: docs-updated
  • Evidence: docs/inference/custom-endpoint-security.mdx documents exact openshell-docker IPAM source restriction, rejection of unrelated private peers, fail-closed bridge discovery, source-policy-bound adapter reuse, bare-origin path preservation, the total upstream deadline, late-response disposal, health visibility, and loopback-only post-spawn credential registration. The exact-head E2E-only follow-up was re-reviewed as no-docs-needed because the canonical page already documents query/userinfo rejection and non-persistence.
  • Latest review: exact head 5d639519f; the rollback recovery paragraph remains accurate after the normal current-main sync, and npm run docs passes.
  • Agent: Codex Desktop

Verification

  • PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
  • Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run check:diff passed when hooks were skipped or unavailable
  • Targeted behavior tests pass for the current change set, or tests are marked not applicable above — exact head 5d639519f: all 18 inference-set files / 158 tests passed after current-main sync, including the provider-update rollback regression; Biome, CLI typecheck, test-title/source-shape checks, normal commit/pre-push hooks, and the docs build passed. Earlier exact head 54954d4b6 also passed the combined inference suite (68 files, 1,121 passed, 1 skipped) and credential-state E2E workflow contracts.
  • Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — command/result:
  • Quality Gates section completed with required justifications or waivers
  • No secrets, API keys, or credentials committed
  • npm run docs builds without warnings (doc changes only) — passed with zero errors; existing Node deprecation and two Fern warnings remain.
  • Doc pages follow the style guide (doc changes only)
  • New doc pages include SPDX header and frontmatter (new pages only)

Signed-off-by: Apurv Kumaria akumaria@nvidia.com

Summary by CodeRabbit

  • New Features
    • Enabled DNS-backed HTTPS inference endpoints via a locally pinned HTTPS adapter, including safe runtime endpoint switching and adapter route/provider token handling with recovery and revocation.
  • Documentation
    • Expanded onboarding/command guidance and updated troubleshooting for runtime switching adapter behavior.
  • Bug Fixes
    • Tightened endpoint URL validation (rejects userinfo, query, and fragments), improved DNS-backed HTTPS error messaging, and strengthened redirect/credential fail-closed behavior.
    • Added/validated reserved port handling for the HTTPS pin adapter.
  • Chores
    • Improved uninstall/destroy cleanup & preservation for the shared adapter and extended E2E/workflow coverage and checks.

Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria apurvvkumaria added area: inference Inference routing, serving, model selection, or outputs area: networking DNS, proxy, TLS, ports, host aliases, or connectivity area: sandbox OpenShell sandbox lifecycle, runtime, config, or recovery area: security Security controls, permissions, secrets, or hardening feature PR adds or expands user-visible functionality labels Jul 19, 2026
@apurvvkumaria apurvvkumaria self-assigned this Jul 19, 2026
@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds a runtime-aware HTTPS Pin Runtime adapter for DNS-backed inference endpoints, including pinned forwarding, credential isolation, route lifecycle management, port validation, uninstall cleanup, inference-set integration, and live test coverage.

Changes

HTTPS Pin Runtime Adapter

Layer / File(s) Summary
Adapter contracts and forwarding primitives
src/lib/inference/https-pin-runtime.ts, src/lib/inference/https-pin-runtime-adapter-forward.ts, src/lib/core/ports.ts, src/lib/subprocess-env.ts
Defines opaque route URLs, provider credential headers, pinned forwarding behavior, minimal adapter environments, and reserved port validation.
Adapter server and lifecycle
src/lib/inference/https-pin-runtime-adapter.ts, src/lib/inference/https-pin-runtime-adapter*.test.ts
Adds authenticated route registration, private-network forwarding, TLS SNI preservation, recovery metadata, lifecycle locking, process startup, and route revocation.
Inference route normalization and provider binding
src/lib/actions/inference-set-route-containment.ts, src/lib/actions/inference-set-https-pin-provider.ts, src/lib/actions/*https-pin*.test.ts
Routes eligible DNS-backed HTTPS endpoints through local adapter URLs and converges OpenShell providers without persisting upstream credentials or hostnames.
Inference-set commits and route cleanup
src/lib/actions/inference-set.ts, src/lib/actions/inference-set.test-support.ts, src/lib/actions/inference-set-https-pin-runtime.test.ts
Applies adapter provider bindings before inference selection, handles partial convergence, updates registry state, and revokes superseded routes after commits.
Destroy and uninstall integration
src/lib/actions/sandbox/destroy.ts, src/lib/actions/uninstall/*
Revokes unreferenced routes after confirmed deletion and preserves or stops shared adapter state according to uninstall scope.
Integration validation and documentation
test/e2e/live/*, docs/..., src/lib/onboard/..., src/lib/sandbox/config.ts
Adds live DNS-rebinding and redirect coverage, updates endpoint validation errors and configuration handling, and documents supported and unsupported DNS-backed HTTPS flows.

Estimated code review effort: 5 (Critical) | ~120 minutes

Possibly related PRs

  • NVIDIA/NemoClaw#6906: Directly overlaps the HTTPS Pin Runtime adapter integration across inference-set routing, adapter wiring, and tests.

Suggested labels: integration: openclaw, integration: hermes, area: e2e, area: docs, github_actions

Suggested reviewers: senthilr-nv, prekshivyas, cv

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 18.70% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed The PR implements runtime-aware HTTPS pinning, secure adapter boundaries, URL hardening, redirect fail-closed behavior, minimal env, and live E2E coverage.
Out of Scope Changes check ✅ Passed The added docs, tests, workflow pins, and cleanup changes all support the HTTPS pinning inference-routing work and stay within scope.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: routing DNS-backed HTTPS endpoints with scoped credentials.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/6141-route-scoped-credentials

Comment @coderabbitai help to get the list of available commands.

@github-code-quality

github-code-quality Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in commit 5d63951 in the codex/6141-route-sco... branch remains at 96%, unchanged from commit 9d4a5c6 in the main branch.

TypeScript / code-coverage/cli

The overall coverage in commit 5d63951 in the codex/6141-route-sco... branch is 80%. The coverage in commit 9d4a5c6 in the main branch is 81%.

Show a code coverage summary of the most impacted files.
File main 9d4a5c6 codex/6141-route-sco... 5d63951 +/-
src/lib/inferen...er-lifecycle.ts 71% 66% -5%
src/lib/actions...all/run-plan.ts 85% 84% -1%
src/lib/sandbox/config.ts 73% 74% +1%
src/lib/actions...-containment.ts 92% 95% +3%
src/lib/onboard...eway-cleanup.ts 55% 59% +4%
src/lib/actions...dbox/destroy.ts 87% 95% +8%
src/lib/inferen...time-adapter.ts 0% 62% +62%
src/lib/inferen...-pin-runtime.ts 0% 90% +90%
src/lib/inferen...pter-forward.ts 0% 92% +92%
src/lib/actions...pin-provider.ts 0% 96% +96%

Updated July 25, 2026 22:20 UTC

@github-actions

Copy link
Copy Markdown
Contributor

Comment thread src/lib/actions/inference-set-compatible-provider.test.ts Fixed
Comment thread src/lib/inference/https-pin-runtime-adapter.test.ts Fixed
@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

PR Review Advisor — No blocking findings reported

Advisor assessment: No blocking advisor findings reported
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions

Model lanes

  • GPT-5.6 Terra (primary): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
  • Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
  • Model comparison: normalized findings match; normalized E2E selections differ; severity counts match.

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: cloud-onboard, credential-sanitization, full-e2e, hermes-e2e, security-posture, inference-routing, network-policy, onboard-repair, onboard-resume

1 optional E2E recommendation
  • tunnel-lifecycle

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.

Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Comment thread src/lib/inference/https-pin-runtime-adapter-forward.ts Fixed
Comment thread src/lib/inference/https-pin-runtime-adapter.ts Dismissed
Comment thread src/lib/inference/https-pin-runtime-adapter.ts Dismissed
Comment thread src/lib/actions/inference-set-compatible-provider.test.ts Fixed
Comment thread src/lib/inference/https-pin-runtime-adapter.test.ts Fixed

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
src/lib/inference/https-pin-runtime-adapter-forward.ts (1)

239-243: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Use close with readableEnded for upstream truncation.
aborted is deprecated here, but close also fires on normal completion. If you switch this handler, gate it with !upstreamRes.readableEnded so a clean end doesn’t surface a 502.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/lib/inference/https-pin-runtime-adapter-forward.ts` around lines 239 -
243, Replace the upstreamRes “aborted” listener with a “close” listener in the
forwarding request flow, and only call failRequest with the existing 502
ForwardHttpError when !upstreamRes.readableEnded. Preserve clean completion
without surfacing an error.

Source: Learnings

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/lib/actions/inference-set-https-pin-runtime.test.ts`:
- Around line 44-52: The codebase-growth-guardrails scan rejects all seven newly
introduced conditionals across the two inference HTTPS pin test files. In
src/lib/actions/inference-set-https-pin-runtime.test.ts#L44-L52, rework the
provider get/update mock dispatch, inference-set override branch, and failure
=== "list" setup at the cited lines; in
src/lib/actions/inference-set-https-pin-provider.test.ts#L40-L48, rework the
captureSequence guard and makeCapture get dispatch, using ternaries or lookup
tables while preserving behavior. Alternatively, raise the guardrail baseline
only through the sanctioned repository process.

In `@src/lib/actions/sandbox/destroy-https-pin-route.test.ts`:
- Around line 42-62: Remove the failure-based if branch inside the parameterized
test for revokeDestroyedSandboxHttpsPinRoute. Replace the it.each case with two
dedicated it() tests, one simulating listSandboxes failure and one simulating
revokeRoute failure, while preserving the successful resolution and warning
assertions.

In `@src/lib/inference/https-pin-runtime-adapter.test.ts`:
- Around line 85-89: In the sendRawHttpMethod socket “end” handler, remove the
added if/else conditional while preserving rejection for an invalid response and
resolving the parsed status code for valid responses. Use an expression-based
control flow so the test-conditionals guardrail remains at zero.

---

Nitpick comments:
In `@src/lib/inference/https-pin-runtime-adapter-forward.ts`:
- Around line 239-243: Replace the upstreamRes “aborted” listener with a “close”
listener in the forwarding request flow, and only call failRequest with the
existing 502 ForwardHttpError when !upstreamRes.readableEnded. Preserve clean
completion without surfacing an error.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: ecf1cacc-2529-4897-9c7f-cd710b8b7721

📥 Commits

Reviewing files that changed from the base of the PR and between 78e0e4e and 7485a8d.

📒 Files selected for processing (41)
  • ci/env-var-doc-allowlist.json
  • docs/inference/custom-endpoint-security.mdx
  • docs/reference/commands.mdx
  • docs/reference/troubleshooting.mdx
  • nemoclaw/src/blueprint/ssrf.ts
  • src/lib/actions/inference-set-compatible-provider.test.ts
  • src/lib/actions/inference-set-endpoint-security.test.ts
  • src/lib/actions/inference-set-gateway-route-containment.test.ts
  • src/lib/actions/inference-set-https-pin-provider.test.ts
  • src/lib/actions/inference-set-https-pin-provider.ts
  • src/lib/actions/inference-set-https-pin-runtime.test.ts
  • src/lib/actions/inference-set-provider-alias.test.ts
  • src/lib/actions/inference-set-route-containment.ts
  • src/lib/actions/inference-set.test-support.ts
  • src/lib/actions/inference-set.ts
  • src/lib/actions/sandbox/destroy-flow.test.ts
  • src/lib/actions/sandbox/destroy-https-pin-route.test.ts
  • src/lib/actions/sandbox/destroy.ts
  • src/lib/actions/uninstall/openrouter-runtime-adapter-cleanup.test.ts
  • src/lib/actions/uninstall/openrouter-runtime-adapter-cleanup.ts
  • src/lib/actions/uninstall/run-plan-gateway-segregation.test.ts
  • src/lib/actions/uninstall/run-plan.test.ts
  • src/lib/actions/uninstall/run-plan.ts
  • src/lib/core/ports.test.ts
  • src/lib/core/ports.ts
  • src/lib/inference/https-pin-runtime-adapter-forward.test.ts
  • src/lib/inference/https-pin-runtime-adapter-forward.ts
  • src/lib/inference/https-pin-runtime-adapter.test.ts
  • src/lib/inference/https-pin-runtime-adapter.ts
  • src/lib/inference/https-pin-runtime.test.ts
  • src/lib/inference/https-pin-runtime.ts
  • src/lib/inference/openrouter-runtime-adapter-lifecycle.ts
  • src/lib/onboard/gateway-recovery.ts
  • src/lib/onboard/inference-providers/hermes.ts
  • src/lib/sandbox/config.ts
  • src/lib/subprocess-env.test.ts
  • src/lib/subprocess-env.ts
  • test/e2e/live/https-pin-compatible-server.ts
  • test/e2e/live/inference-routing.test.ts
  • test/e2e/live/mcp-bridge-servers.ts
  • test/helpers/destroy-flow-test-harness.ts

Comment thread src/lib/actions/inference-set-https-pin-runtime.test.ts
Comment thread src/lib/actions/sandbox/destroy-https-pin-route.test.ts Outdated
Comment thread src/lib/inference/https-pin-runtime-adapter.test.ts
apurvvkumaria and others added 2 commits July 19, 2026 00:35
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

E2E follow-up for exact head 67b6a25f6: the protected inference-routing lane failed before reaching NemoClaw behavior because the hosted runner could not spawn cloudflared (ENOENT). Commit 68a4b63a5 now provisions the same pinned, SHA256-verified package used by the MCP and tunnel-lifecycle lanes and extends the workflow boundary/update-pin contracts. Local verification: 44 focused tests passed, CLI typecheck passed, and targeted hooks passed. I will dispatch protected E2E once for this new exact revision after its ordinary exact-head gates are clean.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@test/e2e/support/e2e-workflow.test.ts`:
- Around line 254-263: Extend the test around validateE2eWorkflowBoundary to
mutate prerequisite.env.CLOUDFLARED_DEB_SHA256 to a mutable or invalid value,
then assert the resulting validation errors include the expected SHA256 pin
rejection. Keep this as a separate mutation from the existing
CLOUDFLARED_VERSION check so both security guards are independently covered.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: ed3f61ea-fbef-46ca-9e91-2aede7326c2d

📥 Commits

Reviewing files that changed from the base of the PR and between 67b6a25 and 68a4b63.

📒 Files selected for processing (5)
  • .github/workflows/e2e.yaml
  • scripts/checks/check-cloudflared-update.sh
  • test/cloudflared-update-check-workflow.test.ts
  • test/e2e/support/e2e-workflow.test.ts
  • tools/e2e/workflow-boundary.mts

Comment thread test/e2e/support/e2e-workflow.test.ts
apurvvkumaria and others added 3 commits July 19, 2026 03:47
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

Pushed exact-head E2E remediation in 1b137c526.

The inference-routing failure was in TC-INF-11's disposable onboarding fixture, not the HTTPS pinning transport: it advertised localhost (which onboarding correctly rewrites to host.openshell.internal) but only listened on host loopback. Gateway registration could probe it from the host, while the finished sandbox received HTTP 503 through the rewritten route.

The fixture now retains the localhost rewrite contract while listening on bridge-facing interfaces, matching TC-INF-09 and the shared mock adapter.

Validation:

  • e2e-workflow support tests: 39/39
  • CLI typecheck
  • test-title and source-shape gates
  • scoped prek/repository/security hooks
  • commit is signed, DCO-compliant, Verified, and retains original-author credit

Fresh ordinary CI/advisors are running. The failed protected E2E from the prior revision will not be retried; this revision will receive a fresh exact-head dispatch only after ordinary gates settle.

@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

Protected E2E has been dispatched exactly once for exact head 1b137c5264dc89580ac968673a192a2f408deef8 against base 78e0e4e17725e17b8fde315c3929b527dbc308ac: control-plane run 29687355814.

Pre-dispatch recheck: PR mergeable and non-draft, assignment and labels unchanged, commit Verified/DCO, canonical advisor clean, zero unresolved threads, and all ordinary checks green. The secondary advisor lane's red is a tool-protocol execution failure with an empty finding ledger, not a code finding.

Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

Protected E2E follow-up on exact head 1b137c526: TC-INF-11 failed deterministically because its disposable onboarding placeholder used an OS-assigned port, while the already-passing host-bridge fixture contract uses port 8000. The sibling full-e2e lane completed a successful agent turn before a transient inference.local status probe failure, so I classified that separately as runtime flakiness.

I pushed signed, DCO-compliant, GitHub-Verified commit 0eda93d7b (with the original author credited) to pin only the TC-INF-11 placeholder to bridge-visible port 8000. Validation: 59 focused E2E workflow/support tests, CLI typecheck, test-title and source-shape gates, repository hooks, and pre-push checks all pass. Fresh exact-head CI is running; I will not retry the obsolete 1b137c526 protected run.

apurvvkumaria and others added 3 commits July 19, 2026 06:50
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Co-authored-by: DisturbedSage <maruteymani31@gmail.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Comment thread src/lib/inference/https-pin-runtime-adapter.ts Outdated
Comment thread src/lib/inference/https-pin-runtime-adapter.test.ts
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
src/lib/actions/inference-set-https-pin-provider.test.ts (1)

51-51: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Use a behavioral suite title with the linked issue suffix.

Rename this suite to describe its observable contract and append (#6141); child titles do not need to repeat the suffix.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/lib/actions/inference-set-https-pin-provider.test.ts` at line 51, Rename
the suite in “HTTPS-pin provider binding” to a title describing the observable
behavior it verifies, and append the linked issue suffix “(`#6141`)”. Leave the
child test titles unchanged.

Source: Coding guidelines

.github/workflows/e2e.yaml (1)

2915-2923: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Duplicated unhardened swap provisioning bypasses the new trusted-hermes-e2e-swap anchor. Both rebuild jobs allocate swap at the same fixed /mnt/nemoclaw-hermes-rebuild.swap path with no already-sufficient check, runner-environment check, disk-reserve check, pre-existing-path rejection, or cleanup — the exact guards the anchored step added in this PR.

  • .github/workflows/e2e.yaml#L2915-L2923: replace the inline block in rebuild-hermes with the *trusted-hermes-e2e-swap alias (plus its env: and hardened shell:), or extract a shared anchor if the trust gating must differ.
  • .github/workflows/e2e.yaml#L3029-L3037: apply the same replacement in rebuild-hermes-stale-base so both lanes share one swap implementation.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/e2e.yaml around lines 2915 - 2923, Replace the inline swap
provisioning in rebuild-hermes at .github/workflows/e2e.yaml:2915-2923 with the
trusted-hermes-e2e-swap anchor, including its env and hardened shell
configuration. Apply the same replacement in rebuild-hermes-stale-base at
.github/workflows/e2e.yaml:3029-3037 so both jobs use the shared guarded swap
implementation.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @.github/workflows/e2e.yaml:
- Around line 2915-2923: Replace the inline swap provisioning in rebuild-hermes
at .github/workflows/e2e.yaml:2915-2923 with the trusted-hermes-e2e-swap anchor,
including its env and hardened shell configuration. Apply the same replacement
in rebuild-hermes-stale-base at .github/workflows/e2e.yaml:3029-3037 so both
jobs use the shared guarded swap implementation.

In `@src/lib/actions/inference-set-https-pin-provider.test.ts`:
- Line 51: Rename the suite in “HTTPS-pin provider binding” to a title
describing the observable behavior it verifies, and append the linked issue
suffix “(`#6141`)”. Leave the child test titles unchanged.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: ef4c53de-8f57-4b59-98fb-a39a8ac6504a

📥 Commits

Reviewing files that changed from the base of the PR and between 68a4b63 and fbbacd8.

📒 Files selected for processing (14)
  • .github/workflows/e2e.yaml
  • ci/env-var-doc-allowlist.json
  • docs/inference/custom-endpoint-security.mdx
  • docs/reference/commands.mdx
  • docs/reference/troubleshooting.mdx
  • src/lib/actions/inference-set-compatible-provider.test.ts
  • src/lib/actions/inference-set-degraded-state.test.ts
  • src/lib/actions/inference-set-gateway-route-containment.test.ts
  • src/lib/actions/inference-set-https-pin-provider.test.ts
  • src/lib/actions/inference-set-https-pin-provider.ts
  • src/lib/actions/inference-set-https-pin-runtime.test.ts
  • src/lib/actions/inference-set-provider-alias.test.ts
  • src/lib/actions/inference-set-route-containment.ts
  • src/lib/actions/inference-set.ts
🚧 Files skipped from review as they are similar to previous changes (7)
  • docs/reference/troubleshooting.mdx
  • src/lib/actions/inference-set-compatible-provider.test.ts
  • src/lib/actions/inference-set-https-pin-runtime.test.ts
  • src/lib/actions/inference-set-gateway-route-containment.test.ts
  • src/lib/actions/inference-set-provider-alias.test.ts
  • src/lib/actions/inference-set-route-containment.ts
  • src/lib/actions/inference-set.ts

@senthilr-nv

Copy link
Copy Markdown
Collaborator

Reviewed exact head 54954d4b6. One blocking correctness gap remains:

openshell inference set succeeds before the deferred provider update runs. If httpsPinProviderMutation.commit() then fails, the live selection changes while the provider remains old. The catch path reports this split but cannot restore the prior selection. Please make the selection/provider mutation atomic or restore the previous selection, and add a regression that forces provider-commit failure after successful selection.

Product scope, separately: #6141 remains open, In Progress, and labeled needs: design. Please record accepted design and ownership, lifecycle, compatibility, security, and validation expectations before treating this as canonical supported behavior.

@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

Addressed the deterministic correctness blocker at exact head 5d639519f (signed fix commit 821969bab). If the deferred HTTPS-pinned provider update fails after openshell inference set succeeds, NemoClaw now restores the recorded prior provider/model selection and exits nonzero with reconciliation guidance. The regression forces provider-update failure after the new selection succeeds and verifies the rollback command and unchanged registry state.\n\nValidation: all 18 inference-set test files / 158 tests pass on the synced exact head; Biome, CLI typecheck, test-title/source-shape checks, commit/pre-push hooks, and docs build pass. The required docs review updated the switch-provider recovery guidance.\n\nThe separate #6141 product/design/ownership/lifecycle/compatibility/security acceptance remains unresolved; this change does not claim or substitute for that maintainer/product sign-off.

@cv
cv merged commit b4ef301 into main Jul 26, 2026
75 of 78 checks passed
@cv
cv deleted the codex/6141-route-scoped-credentials branch July 26, 2026 01:51
@apurvvkumaria

Copy link
Copy Markdown
Collaborator Author

@cv @senthilr-nv#6141 was closed as completed by @cv at 2026-07-26 01:51 UTC, but the issue has no closure note and this PR has no subsequent product/security review. Does that closure constitute the requested design, ownership, lifecycle, compatibility, security, and validation acceptance for exact head 5d63951? I am keeping this gate fail-closed until one of you confirms explicitly.

@cv cv mentioned this pull request Jul 26, 2026
23 tasks
apurvvkumaria pushed a commit that referenced this pull request Jul 27, 2026
<!-- markdownlint-disable MD041 -->
## Summary

Add the canonical `docs/changelog/2026-07-25.mdx` release entry with the
exact `## v0.0.96` heading.
The entry reconciles all 90 first-parent commits since v0.0.95 with all
92 merged PRs in the live `v0.0.96` label ledger and groups the
user-visible changes by operator journey.

## Changes

- Add the parser-safe dated MDX changelog entry for v0.0.96 with
root-absolute links to the focused user guides.
- Source summary:
- [#7194](#7194) ->
`docs/changelog/2026-07-25.mdx`: Document persistent baseline network
policy exclusions and their inspection, rebuild, and snapshot behavior.
- [#7188](#7188),
[#7427](#7427), and
[#7546](#7546) ->
`docs/changelog/2026-07-25.mdx`: Document DNS-backed HTTPS inference
routing, keyless loopback endpoints, and provider-marker isolation.
- [#7238](#7238) ->
`docs/changelog/2026-07-25.mdx`: Document blueprint sandbox and provider
identifier validation before state writes or OpenShell calls, with
bounded terminal-safe rejection previews.
- [#7319](#7319),
[#7274](#7274),
[#7528](#7528),
[#7353](#7353), and
[#7560](#7560) ->
`docs/changelog/2026-07-25.mdx`: Document the managed default gateway
service, onboarding readiness, and container-runtime identity
safeguards.
- [#7349](#7349),
[#7498](#7498),
[#7406](#7406),
[#7196](#7196),
[#7559](#7559),
[#7421](#7421),
[#7510](#7510),
[#7295](#7295), and
[#7565](#7565) ->
`docs/changelog/2026-07-25.mdx`: Document gateway-scoped status,
lifecycle diagnostics, managed MCP recovery, delete-edge safeguards, and
fail-closed CLI prompt and command output.
- [#7591](#7591) ->
`docs/changelog/2026-07-25.mdx`: Document opt-in authenticated MCP
tool-name discovery, its bounded and names-only contract, probe
interaction, and rebuild requirement.
- [#7305](#7305),
[#7480](#7480),
[#7471](#7471),
[#7365](#7365), and
[#7541](#7541) ->
`docs/changelog/2026-07-25.mdx`: Document installer version checks,
version-tag reporting, license guidance, WSL Ollama selection, and DGX
Station vLLM detection.
- [#7482](#7482),
[#7466](#7466),
[#7208](#7208),
[#7434](#7434), and
[#7586](#7586) ->
`docs/changelog/2026-07-25.mdx`: Document Ollama resource details,
reasoning precedence, Hermes onboarding behavior, and preserved managed
Hermes BuildKit failures.

- [#6830](#6830),
[#7492](#7492),
[#7563](#7563), and
[#7582](#7582) ->
`docs/changelog/2026-07-25.mdx`: Document the authoritative OpenClaw
production lock, fixed managed-image dependencies, immutable Hermes base
adoption, and Hermes image-size reduction.
- [#7505](#7505),
[#7530](#7530),
[#7547](#7547),
[#7508](#7508),
[#7548](#7548),
[#7549](#7549),
[#7537](#7537),
[#7534](#7534),
[#7515](#7515),
[#7511](#7511),
[#7551](#7551),
[#7562](#7562),
[#7575](#7575),
[#7496](#7496),
[#7594](#7594),
[#7595](#7595), and
[#7599](#7599) ->
`docs/changelog/2026-07-25.mdx`: Summarize release validation, transient
and bounded dispatch reconciliation, exact pre-tag qualification,
identity revalidation, npm-audit retry, sharding, image reuse, timeout,
telemetry, and workflow-hardening changes.
- Reconciled without separate changelog prose:
- [#7539](#7539),
[#7526](#7526),
[#7507](#7507),
[#7506](#7506),
[#7519](#7519),
[#7516](#7516),
[#7396](#7396),
[#7254](#7254),
[#7583](#7583),
[#7596](#7596), and
[#7598](#7598): Test-harness or
fixture-only changes.
- [#7403](#7403),
[#7161](#7161),
[#6877](#6877),
[#7531](#7531),
[#7525](#7525),
[#7522](#7522),
[#7536](#7536),
[#7552](#7552),
[#7566](#7566),
[#7553](#7553),
[#7561](#7561),
[#7577](#7577),
[#7569](#7569),
[#7585](#7585),
[#7584](#7584),
[#7592](#7592),
[#7580](#7580),
[#7571](#7571),
[#7517](#7517),
[#7589](#7589),
[#7402](#7402),
[#7558](#7558),
[#7544](#7544), and
[#7601](#7601): Dependency,
internal recovery, validation, contributor-workflow, E2E optimization,
telemetry, or CI trust changes with no separate user-facing release
claim.
- [#7556](#7556),
[#7573](#7573),
[#7576](#7576), and
[#7578](#7578): Experimental
repository-maintainer conflict automation with no canonical user
documentation surface.

## Type of Change

- [ ] Code change (feature, bug fix, or refactor)
- [ ] Code change with doc updates
- [x] Doc only (prose changes, no code sample modifications)
- [ ] Doc only (includes code sample changes)

## Quality Gates

- [ ] Tests added or updated for changed behavior
- [x] Existing tests cover changed behavior — justification:
`test/changelog-docs.test.ts` validates dated changelog structure,
version headings, and published links.
- [ ] Tests not applicable — justification:
- [x] Docs updated for user-facing behavior changes
- [ ] Docs not applicable — justification:
- [ ] Sensitive paths changed (security, policy, credentials, preflight,
onboarding, inference, runner, sandbox, or messaging)
- [ ] Sensitive-path review completed or maintainer-approved waiver
recorded — reviewer/approval link/justification:
- [ ] Non-success, skipped, or missing CI check accepted by maintainer —
check name, approval link, and follow-up issue:

## Documentation Writer Review

- [x] Documentation writer subagent reviewed the completed changes
- Result: `docs-updated`
- Evidence: Reviewed `docs/changelog/2026-07-25.mdx` at exact head
`0f5dedb47` against 90 first-parent release commits and 92 merged PRs
labeled `v0.0.96`. Verified parser-safe MDX SPDX, the exact version
heading, literal CLI names, writing style, skip terms, all 20
root-absolute published links, and the accepted #7591 opt-in
authenticated discovery bounds. #7544, #7599, and #7601 remain internal
or CI-only release-ledger entries. Changelog tests passed 6/6, the docs
build passed with 0 errors and two pre-existing Fern warnings, and `npm
run check:diff` plus the final diff check passed.
- Agent: Codex Desktop documentation-writer subagent
<!-- docs-review-head-sha: 0f5dedb -->
<!-- docs-review-agents-blob-sha: be20a09 -->

## DGX Station Hardware Evidence

- [ ] Tested on DGX Station
- Tested commit:
- Station profile/scenario:
- Result:
- Supporting evidence:

## Verification

- [x] PR description includes a `Signed-off-by:` line and every commit
appears as `Verified` in GitHub
- [x] Normal `pre-commit`, `commit-msg`, and `pre-push` hooks passed, or
`npm run check:diff` passed when hooks were skipped or unavailable
- [x] Targeted behavior tests pass for the current change set, or tests
are marked not applicable above — `npx vitest run
test/changelog-docs.test.ts`: 6/6 passed.
- [ ] Applicable broad gate passed — `npm test` for broad
runtime/test-harness changes; `npm run check` for repo-wide
validation/coverage changes — command/result: Not applicable to this
prose-only changelog entry.
- [x] Quality Gates section completed with required justifications or
waivers
- [x] No secrets, API keys, or credentials committed
- [ ] `npm run docs` builds without warnings (doc changes only) — the
build passed with 0 errors and 2 existing Fern warnings; the
published-route check passed.
- [x] Doc pages follow the [style
guide](https://github.com/NVIDIA/NemoClaw/blob/main/docs/CONTRIBUTING.md)
(doc changes only)
- [ ] New doc pages include SPDX header and frontmatter (new pages only)
— native changelog files use the required parser-safe MDX SPDX comment
and no frontmatter.

---
Signed-off-by: Carlos Villela <cvillela@nvidia.com>


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Persistent network policy exclusions with consistent restore/exclusion
reporting across rebuilds/snapshots.
* Opt-in MCP tool discovery via `mcp status --tools` with bounded,
redacted authenticated traffic.
* Improved HTTPS inference switching for custom endpoints and refreshed
onboarding/model menu details.
* Refined OpenShell gateway defaults for port `8080`, including more
reliable readiness checks.
* **Bug Fixes**
* Prevent incorrect provider/model restoration after compatible-provider
update failures.
* Preserve managed MCP state after exec loss and tighten gateway/doctor
status scoping.
* **Tests**
* Stronger, fail-closed release validation with hardened
evidence/artifact handoff and bounded timeouts/retries.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Signed-off-by: Prekshi Vyas <prekshiv@nvidia.com>
Co-authored-by: Prekshi Vyas <prekshiv@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: inference Inference routing, serving, model selection, or outputs area: networking DNS, proxy, TLS, ports, host aliases, or connectivity area: sandbox OpenShell sandbox lifecycle, runtime, config, or recovery area: security Security controls, permissions, secrets, or hardening feature PR adds or expands user-visible functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Design runtime-aware HTTPS pinning transport for DNS-backed inference endpoints

6 participants