Skip to content

Forward-merge release/0.2 into main#110

Merged
willkill07 merged 9 commits into
mainfrom
release/0.2
May 15, 2026
Merged

Forward-merge release/0.2 into main#110
willkill07 merged 9 commits into
mainfrom
release/0.2

Conversation

@rapids-bot
Copy link
Copy Markdown

@rapids-bot rapids-bot Bot commented May 14, 2026

Forward-merge triggered by push to release/0.2 that creates a PR to keep main up-to-date. If this PR is unable to be immediately merged due to conflicts, it will remain open for the team to manually merge. See forward-merger docs for more info.

#### Overview

Addresses the open Sonar maintainability findings reported on `release/0.2` by reducing Rust cognitive complexity and replacing duplicated Go test literals.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Split observability doctor and plugin editor control-flow into smaller helper functions.
- Split OpenAI Responses request encoding overlays into focused helper functions.
- Added constants for duplicated Go observability test literals.

#### Where should the reviewer start?

Start with `crates/core/src/codec/openai_responses.rs`, then review the smaller CLI refactors in `crates/cli/src/doctor.rs` and `crates/cli/src/plugins.rs`.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none




## Summary by CodeRabbit

* **Refactor**
  * Enhanced code organization in observability component checking, plugin configuration editing, and OpenAI response encoding for improved internal structure and maintainability.

* **Tests**
  * Standardized error message formatting in observability plugin tests for improved consistency and clearer diagnostic output during test failures.



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/104)

Authors:
  - Will Killian (https://github.com/willkill07)

Approvers:
  - Ajay Thorve (https://github.com/AjayThorve)

URL: #104
@rapids-bot rapids-bot Bot requested a review from a team as a code owner May 14, 2026 18:31
@rapids-bot
Copy link
Copy Markdown
Author

rapids-bot Bot commented May 14, 2026

FAILURE - Unable to forward-merge due to an error, manual merge is necessary. Do not use the Resolve conflicts option in this PR, follow these instructions https://docs.rapids.ai/maintainers/forward-merger/

IMPORTANT: When merging this PR, do not use the auto-merger (i.e. the /merge comment). Instead, an admin must manually merge by changing the merging strategy to Create a Merge Commit. Otherwise, history will be lost and the branches become incompatible.

@github-actions github-actions Bot added size:M PR is medium lang:go PR changes/introduces Go code lang:rust PR changes/introduces Rust code labels May 14, 2026
#### Overview

Isolates CLI config override unit tests from developer-level NeMo Flow configuration discovered through the normal user config path.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Adds a temp-scoped explicit config path helper for config tests that require no implicit user or project config discovery.
- Updates the affected override tests to use that explicit path instead of relying on ambient process configuration.

#### Where should the reviewer start?

Start with `crates/cli/tests/coverage/config_tests.rs`, especially the tests around CLI plugin config overrides.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none




## Summary by CodeRabbit

* **Tests**
  * Enhanced test infrastructure for configuration resolution by improving test isolation and setup processes.



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/105)

Authors:
  - Will Killian (https://github.com/willkill07)

Approvers:
  - Ajay Thorve (https://github.com/AjayThorve)

URL: #105
#### Overview

Keep the OpenClaw plugin package dependency on `nemo-flow-node` aligned with the package version emitted by repository versioning and packaging workflows.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Change `nemo-flow-openclaw` to depend on the exact checked-in `nemo-flow-node` version.
- Add a `justfile` helper that updates package dependency versions in both `package.json` and `package-lock.json`.
- Wire the dependency update into `set-version`, `package-node`, and `package-openclaw` so prerelease package builds keep the Node and OpenClaw versions together.
- Align OpenClaw non-tag CI package version suffixing with the Node package workflow.

Validation run:

- `just set-version 0.2.0-alpha.20260514`, verified OpenClaw's `nemo-flow-node` dependency updated without dependency success logs, then restored with `just set-version 0.2.0`.
- `npm install --workspace=nemo-flow-node --ignore-scripts`
- `npm install --workspace=nemo-flow-openclaw --ignore-scripts`
- `npm run typecheck --workspace=nemo-flow-openclaw`
- `npm run pack:check --workspace=nemo-flow-openclaw`
- `just --list`
- `git diff --check`
- Commit-time pre-commit hooks passed for the staged files.

#### Where should the reviewer start?

Start with `justfile`, especially the new package dependency version helper and its calls from `set_node_package_versions`, `package-node`, and `package-openclaw`.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none




## Summary by CodeRabbit

## Release Notes

* **Chores**
  * Refined OpenClaw package versioning format for improved clarity
  * Pinned nemo-flow-node dependency to a stable version for enhanced reliability
  * Improved build and packaging tooling to ensure consistent dependency alignment



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/107)

Authors:
  - Will Killian (https://github.com/willkill07)

Approvers:
  - https://github.com/Salonijain27

URL: #107
@rapids-bot rapids-bot Bot requested a review from a team as a code owner May 14, 2026 18:35
@github-actions github-actions Bot added size:L PR is large and removed size:M PR is medium labels May 14, 2026
@codecov
Copy link
Copy Markdown

codecov Bot commented May 14, 2026

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

#### Overview

Refactors the CLI coverage-heavy interactive setup/plugin editors so testable logic lives in focused helper modules, then adds coverage around the extracted behavior and related CLI paths.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Split plugin config file handling and Observability editor state helpers out of `plugins.rs` into testable modules.
- Split setup config/model/file helper logic out of `setup.rs` into `setup/model.rs`.
- Added focused coverage for CLI setup, plugin editing models, doctor formatting/check helpers, completion install helpers, server gateway forwarding paths, and CLI smoke behavior.
- Updated Codecov component reporting from Gateway Runtime to CLI, set the CLI target to 88%, and excluded only the remaining TTY prompt shells.
- Added module guidance so future testable logic does not go back into the interactive prompt files.

#### Where should the reviewer start?

Start with `crates/cli/src/plugins.rs` and `crates/cli/src/setup.rs` to see the orchestration-only boundary, then review `crates/cli/src/plugins/editor_model.rs`, `crates/cli/src/plugins/config_io.rs`, and `crates/cli/src/setup/model.rs` for the extracted testable logic.

Validation run locally:

- `cargo fmt --all`
- `cargo test -p nemo-flow-cli` with isolated `XDG_CONFIG_HOME`
- `cargo clippy --workspace --all-targets -- -D warnings`
- `just test-rust` with isolated `XDG_CONFIG_HOME`
- `cargo llvm-cov --package nemo-flow-cli --summary-only ...`
- commit hook pre-commit checks, including cargo fmt, cargo clippy, and cargo check

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none


## Summary by CodeRabbit

* **New Features**
  * Plugin config preview, validation, and safer save/merge behavior; clearer scope selection and Hermes hook handling in setup.

* **Chores / Refactor**
  * Reorganized CLI internals into smaller, testable modules to make interactive editors and the setup wizard more reliable.

* **Tests**
  * Added extensive CLI unit and integration tests covering agents, doctor, completions, plugin editor TTY behavior, setup flows, and gateway/server forwarding.

* **Chores**
  * Updated Codecov to include CLI coverage and exclude interactive prompt loops.

Signed-off-by: Will Killian <wkillian@nvidia.com>
@github-actions github-actions Bot added size:XL PR is extra large and removed size:L PR is large labels May 14, 2026
#### Overview

Fold OpenClaw validation into the existing Node.js CI workflow as a conditional step, and make `just test-openclaw` run the live smoke coverage path.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Add a `run_openclaw` input to the reusable Node.js workflow.
- Run OpenClaw integration checks as a conditional step across the full Node test matrix.
- Remove the separate OpenClaw workflow call and workflow file.
- Keep OpenClaw package artifact creation inside the existing Node package job while leaving Node package steps gated by `run_package`.
- Add the live smoke test path to `just test-openclaw` and document the target in contributor testing guidance.

#### Where should the reviewer start?

Start with `.github/workflows/ci_node.yml`, especially the conditional OpenClaw test step in the Node test job and the package-job gating.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none


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

* **Tests**
  * Added live-run OpenClaw smoke tests and a helper script to run them.
  * OpenClaw integration checks now run conditionally inside the Node.js test flow.
  * Test suites updated to use compiled test artifacts and adjusted import paths.

* **Chores**
  * Removed standalone OpenClaw CI job; its checks and optional packaging were folded into the Node.js workflow and gated by inputs.
  * OpenClaw packaging and artifact upload are now conditional.

* **Documentation**
  * Testing guide and integration README updated with live-test target and artifact locations.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
@github-actions github-actions Bot added the lang:js PR changes/introduces Javascript/Typescript code label May 14, 2026
#### Overview

This PR updates the OpenClaw patch to be aligned with `main`

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

<!-- Describe the changes made in this PR. -->

#### Where should the reviewer start?

<!-- Point to the most important file, test, or design decision. -->

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Closes #
@github-actions github-actions Bot added size:XXL PR is very large and removed size:XL PR is extra large labels May 14, 2026
#### Overview
* Primary entry point for end-users is the `add_nemo_flow_integration` method, which adds NeMo Flow middleware to the agent and subagents (if any).
* Emit a mark when skills are loaded and HITL events
* `langgraph` is promoted from a transitive dep to a direct-dep in the `langchain` extra since `python/nemo_flow/integrations/langchain/_serialization.py` now imports from `langgraph`
* Adds work-around for installing OpenSSL on Windows-Arm CI runners

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details



#### Where should the reviewer start?



#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Closes #



## Summary by CodeRabbit

* **New Features**
  * Deep Agents integration: observability for agent runs, tool calls, filesystem/sandbox operations, human-in-the-loop events, backend instrumentation, and middleware marks.

* **Documentation**
  * Added Deep Agents integration README with setup, usage, and observed-event examples.

* **Tests**
  * New integration and end-to-end tests covering middleware, backend instrumentation, sandbox behavior, and HITL flows; added shared test fixture.

* **Chores**
  * Added optional Deep Agents dependency group and regenerated third‑party attributions/licenses.

* **CI**
  * Updated CI and dev sync steps to include Deep Agents extras and platform-specific setup.



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/90)

Authors:
  - David Gardner (https://github.com/dagardner-nv)

Approvers:
  - Will Killian (https://github.com/willkill07)
  - https://github.com/Salonijain27

URL: #90
@github-actions github-actions Bot added the lang:python PR changes/introduces Python code label May 14, 2026
willkill07 and others added 2 commits May 15, 2026 00:03
#### Overview

Refresh dependency locks and runtime compatibility wiring for the `release/0.2` branch.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Updates Python optional integration constraints and lockfile entries for the release branch.
- Updates OpenClaw peer compatibility to `2026.5.12` and syncs the local hook type mirror with the current session end reasons.
- Adjusts Rust reqwest/rustls provider configuration and OTLP HTTP client selection so TLS and exporter initialization remain stable while unused optional transport packages stay out of the lockfile.
- Makes Node attribution generation lockfile-driven so platform-gated optional packages are listed consistently across CI and local machines.
- Pulls Node license text from integrity-checked locked npm artifacts when packages are not installed on the current platform.
- Regenerates Python and Node attribution files from the refreshed lockfiles.

Validation run:
- `cargo test -p nemo-flow-cli`
- `cargo check -p nemo-flow --features otel`
- `cargo check -p nemo-flow --features otel,openinference`
- `cargo test -p nemo-flow http_config_exports_scope_push_pop_and_marks_without_tokio_runtime -- --nocapture`
- `npm test --workspace integrations/openclaw`
- `uv run --extra langgraph --extra langchain-nvidia pytest python/tests/integrations/langchain python/tests/integrations/langgraph third_party/langgraph_tests`
- `npm audit --ignore-scripts`
- `cargo fmt --all --check`
- `pre-commit run --files scripts/licensing/attributions_lockfile_md.py ATTRIBUTIONS-Node.md package-lock.json`
- signed commit pre-commit suite

#### Where should the reviewer start?

Start with `scripts/licensing/attributions_lockfile_md.py`, `crates/cli/src/tls.rs`, `crates/core/Cargo.toml`, and `integrations/openclaw/package.json` to review the generator, runtime, and integration compatibility changes before the regenerated lockfile and attribution diffs.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Relates to: none


## Summary by CodeRabbit

* **Dependencies**
  * Bumped several Python packages (langchain, langchain-core, langgraph, langgraph-*, urllib3) and raised OpenClaw compatibility to 2026.5.12.
* **New Features**
  * Added "shutdown" and "restart" as session termination reasons.
* **Chores**
  * Ensure TLS/crypto provider is initialized before network operations across CLI and services.
* **Documentation**
  * Refreshed third‑party attributions and improved license extraction for Node/Python packages.



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/112)

Authors:
  - Will Killian (https://github.com/willkill07)

Approvers:
  - David Gardner (https://github.com/dagardner-nv)
  - https://github.com/Salonijain27

URL: #112
#### Overview

Fix Cursor CLI hook configuration so current `cursor-agent` builds can execute NeMo Flow hook commands, and document the remaining Cursor CLI hook coverage limits.

- [x] I confirm this contribution is my own work, or I have the right to submit it under this project's license.
- [x] I searched existing issues and open pull requests, and this does not duplicate existing work.

#### Details

- Generate Cursor `.cursor/hooks.json` entries as direct command entries with top-level `"version": 1`.
- Preserve that Cursor-compatible shape when `nemo-flow run -- cursor-agent` temporarily patches project hooks.
- Update `nemo-flow doctor cursor` to reject nested Cursor hook groups and missing or non-`1` top-level version fields.
- Trim nullable fields from Cursor permission responses.
- Update Cursor integration docs and packaged hooks to state the CLI limitation plainly: current Cursor CLI hook coverage is narrower than Cursor IDE hook coverage.

#### Where should the reviewer start?

Start with `crates/cli/src/installer.rs` for the hook-shape change, then `crates/cli/src/doctor.rs` for validation of user-managed Cursor hook files.

#### Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

- Closes https://linear.app/nvidia/issue/NMF-122/fix-cursor-cli-hook-config-and-document-stream-json-limitation



## Summary by CodeRabbit

* **Refactor**
  * Standardized Cursor hook JSON to require a top-level version (1) and direct command entries; merged/generated hook files now enforce this shape.

* **New Features**
  * Added stricter validation for Cursor hook files with clear, actionable status messages and test coverage.

* **Bug Fixes**
  * Cursor hook responses/endpoints no longer include legacy message fields.

* **Documentation**
  * Expanded Cursor integration and troubleshooting guidance, plus CLI verification steps.



[![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NeMo-Flow/pull/109)

Authors:
  - Ajay Thorve (https://github.com/AjayThorve)

Approvers:
  - Will Killian (https://github.com/willkill07)

URL: #109
@willkill07 willkill07 removed lang:rust PR changes/introduces Rust code lang:python PR changes/introduces Python code lang:js PR changes/introduces Javascript/Typescript code lang:go PR changes/introduces Go code size:XXL PR is very large labels May 15, 2026
@willkill07 willkill07 merged commit 525eb5e into main May 15, 2026
5 of 6 checks passed
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.

3 participants