Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions bin/nemoclaw.js
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,10 @@
// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0

const invokedAs = require("node:path").basename(process.argv[1] || "");
if (invokedAs === "nemo-deepagents") {
process.env.NEMOCLAW_AGENT = "langchain-deepagents-code";
process.env.NEMOCLAW_INVOKED_AS = "nemo-deepagents";
}

require("../dist/nemoclaw");
2 changes: 1 addition & 1 deletion ci/platform-matrix.json
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@
"name": "LangChain Deep Agents Code",
"status": "experimental",
"default": false,
"notes": "Terminal-oriented coding harness (no in-sandbox gateway, no dashboard) built on the Deep Agents SDK; manifest at `agents/langchain-deepagents-code/manifest.yaml` with binary `dcode`. Onboard with `$$nemoclaw onboard --agent langchain-deepagents-code` and follow [the quickstart](../get-started/quickstart-langchain-deepagents-code). NemoClaw runs it as a managed harness: unmanaged sandbox/MCP/shell overrides are rejected and credential-bearing proxy URLs are dropped from persisted shell env. Inference routes through OpenShell's `inference.local` endpoint via Deep Agents Code's OpenAI-compatible provider. Live runtime acceptance, broader launch material, and terminal-agent diagnostics are tracked at open issue #4861."
"notes": "Terminal-oriented coding harness (no in-sandbox gateway, no dashboard) built on the Deep Agents SDK; manifest at `agents/langchain-deepagents-code/manifest.yaml` with binary `dcode`. Onboard with `$$nemo-deepagents onboard` or `$$nemoclaw onboard --agent langchain-deepagents-code`, and follow [the quickstart](../get-started/quickstart-langchain-deepagents-code). NemoClaw runs it as a managed harness: unmanaged sandbox/MCP/shell overrides are rejected and credential-bearing proxy URLs are dropped from persisted shell env. Inference routes through OpenShell's `inference.local` endpoint via Deep Agents Code's OpenAI-compatible provider. Live runtime acceptance, broader launch material, and terminal-agent diagnostics are tracked at open issue #4861."
}
],

Expand Down
24 changes: 15 additions & 9 deletions docs/get-started/quickstart-langchain-deepagents-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,16 @@ Use this guide to build an OpenShell sandbox with the `dcode` terminal coding ag

## Onboard

Run onboarding with the canonical agent ID.
Run onboarding with the Deep Agents alias, or use `nemoclaw --agent` with either the canonical agent ID or a short alias.

```bash
nemo-deepagents onboard
# Equivalent:
nemoclaw onboard --agent langchain-deepagents-code
# Also accepted:
nemoclaw onboard --agent dcode
nemoclaw onboard --agent deepagents
nemoclaw onboard --agent langchain
```

The image installs a hash-locked, pinned Deep Agents Code release with NVIDIA provider support.
Expand Down Expand Up @@ -71,9 +77,9 @@ To enable Tavily, apply the maintained `tavily` policy preset so the sandbox may

```bash
# Preview the endpoints the preset opens:
nemoclaw <sandbox-name> policy-add tavily --dry-run
nemo-deepagents <sandbox-name> policy-add tavily --dry-run
# Apply it:
nemoclaw <sandbox-name> policy-add tavily --yes
nemo-deepagents <sandbox-name> policy-add tavily --yes
```

The `tavily` preset only opens egress to `api.tavily.com:443`.
Expand All @@ -83,7 +89,7 @@ Because OpenShell attributes the harness's calls to the sandbox `python3` interp
Remove the access again when it is no longer needed.

```bash
nemoclaw <sandbox-name> policy-remove tavily --yes
nemo-deepagents <sandbox-name> policy-remove tavily --yes
```

### Optional Tracing (LangSmith)
Expand All @@ -95,13 +101,13 @@ Treat it as unsupported until NemoClaw ships a maintained `langsmith` preset.

## Troubleshooting

Use normal sandbox lifecycle commands.
Use normal sandbox lifecycle commands through either `nemo-deepagents` or `nemoclaw`:

```bash
nemoclaw <sandbox-name> status
nemoclaw <sandbox-name> logs --follow
nemoclaw <sandbox-name> rebuild
nemoclaw <sandbox-name> snapshot create --name before-change
nemo-deepagents <sandbox-name> status
nemo-deepagents <sandbox-name> logs --follow
nemo-deepagents <sandbox-name> rebuild
nemo-deepagents <sandbox-name> snapshot create --name before-change
```

`status` reports the selected harness as a terminal runtime and prints the interactive/headless command shape.
Expand Down
3 changes: 3 additions & 0 deletions docs/reference/commands-nemohermes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,9 @@ nemohermes onboard [options]
nemoclaw onboard --agent hermes [options]
```

`--agent` accepts the canonical manifest names from `nemohermes agents list` plus common aliases.
For example, `nemohermes` resolves to `hermes`, while `dcode`, `deepagents`, `deepagents-code`, and `langchain` resolve to `langchain-deepagents-code`.

#### `--resume` and `--fresh`

NemoClaw records onboarding progress so interrupted runs can continue.
Expand Down
3 changes: 3 additions & 0 deletions docs/reference/commands.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,9 @@ nemoclaw onboard --agent hermes [options]

</AgentOnly>

`--agent` accepts the canonical manifest names from `$$nemoclaw agents list` plus common aliases.
For example, `nemohermes` resolves to `hermes`, while `dcode`, `deepagents`, `deepagents-code`, and `langchain` resolve to `langchain-deepagents-code`.

#### `--resume` and `--fresh`

NemoClaw records onboarding progress so interrupted runs can continue.
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/platform-support.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Pick the matching onboarding entry point for each agent.
|-------|--------|---------|-------|
| OpenClaw | Tested | Yes | Default agent runtime. Onboard with `$$nemoclaw onboard` (no `--agent` flag required). |
| Hermes | Tested with limitations | No | First-class agent with dedicated CLI (`$$nemohermes`), Dockerfile, manifest, docs, and nightly E2E job coverage (`hermes-e2e` job in `.github/workflows/nightly-e2e.yaml` plus the `hermes-*-vitest` jobs in `e2e-vitest-scenarios.yaml`). Onboard with `$$nemohermes onboard` or pass `--agent hermes` to `$$nemoclaw onboard`. Unlocks the Hermes Provider inference route. Known structural gaps: model-provider compatibility registry is empty (backfilled after failures, see `nemoclaw-blueprint/model-specific-setup/hermes/README.md`); no Hermes-specific unit tests in `nemoclaw/src/`; macOS and WSL CI suites do not differentiate agents. Suitable for evaluation and the documented onboarding paths; production parity with OpenClaw is not yet asserted. |
| LangChain Deep Agents Code | Experimental | No | Terminal-oriented coding harness (no in-sandbox gateway, no dashboard) built on the Deep Agents SDK; manifest at `agents/langchain-deepagents-code/manifest.yaml` with binary `dcode`. Onboard with `$$nemoclaw onboard --agent langchain-deepagents-code` and follow [the quickstart](../get-started/quickstart-langchain-deepagents-code). NemoClaw runs it as a managed harness: unmanaged sandbox/MCP/shell overrides are rejected and credential-bearing proxy URLs are dropped from persisted shell env. Inference routes through OpenShell's `inference.local` endpoint via Deep Agents Code's OpenAI-compatible provider. Live runtime acceptance, broader launch material, and terminal-agent diagnostics are tracked at open issue #4861. |
| LangChain Deep Agents Code | Experimental | No | Terminal-oriented coding harness (no in-sandbox gateway, no dashboard) built on the Deep Agents SDK; manifest at `agents/langchain-deepagents-code/manifest.yaml` with binary `dcode`. Onboard with `$$nemo-deepagents onboard` or `$$nemoclaw onboard --agent langchain-deepagents-code`, and follow [the quickstart](../get-started/quickstart-langchain-deepagents-code). NemoClaw runs it as a managed harness: unmanaged sandbox/MCP/shell overrides are rejected and credential-bearing proxy URLs are dropped from persisted shell env. Inference routes through OpenShell's `inference.local` endpoint via Deep Agents Code's OpenAI-compatible provider. Live runtime acceptance, broader launch material, and terminal-agent diagnostics are tracked at open issue #4861. |
{/* agent-status:end */}

## Platforms
Expand Down
3 changes: 2 additions & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@
"license": "Apache-2.0",
"bin": {
"nemoclaw": "./bin/nemoclaw.js",
"nemohermes": "./bin/nemohermes.js"
"nemohermes": "./bin/nemohermes.js",
"nemo-deepagents": "./bin/nemoclaw.js"
},
"oclif": {
"bin": "nemoclaw",
Expand Down
44 changes: 39 additions & 5 deletions scripts/install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,7 @@ installer_version_for_display() {
agent_display_name() {
case "${1:-}" in
hermes) printf "Hermes" ;;
langchain-deepagents-code) printf "LangChain Deep Agents Code" ;;
openclaw | "") printf "OpenClaw" ;;
*)
local first rest
Expand All @@ -117,6 +118,25 @@ agent_display_name() {
esac
}

canonical_agent_name() {
local raw="${1:-}" normalized
normalized="$(printf "%s" "$raw" | tr '[:upper:]_ ' '[:lower:]--' | sed -E 's/-+/-/g; s/^-//; s/-$//')"
case "$normalized" in
nemoclaw | nemo-claw | openclaw)
printf "openclaw"
;;
nemohermes | nemo-hermes | hermes)
printf "hermes"
;;
nemo-deepagents | nemo-deepagent | nemodeepagents | nemodeepagent | dcode | deepagent | deepagents | deep-agent | deep-agents | deepagentcode | deepagentscode | deepagent-code | deepagents-code | deep-agent-code | deep-agents-code | langchain | langchain-code | langchaindeepagent | langchaindeepagents | langchain-deepagent | langchain-deepagents | langchaindeepagentcode | langchaindeepagentscode | langchain-deepagent-code | langchain-deepagents-code | langchain-deep-agent | langchain-deep-agents | langchain-deep-agent-code | langchain-deep-agents-code)
printf "langchain-deepagents-code"
;;
*)
printf "%s" "$raw"
;;
esac
}

# Resolve which Git ref to install from.
# Priority: NEMOCLAW_INSTALL_TAG env var > lkg tag.
resolve_release_tag() {
Expand Down Expand Up @@ -269,9 +289,14 @@ resolve_default_sandbox_name() {
fi

local fallback="my-assistant"
if [[ "${NEMOCLAW_AGENT:-}" == "hermes" ]]; then
fallback="hermes"
fi
case "${NEMOCLAW_AGENT:-}" in
hermes)
fallback="hermes"
;;
langchain-deepagents-code)
fallback="deepagents-code"
;;
esac
printf "%s" "${sandbox_name:-$fallback}"
}

Expand Down Expand Up @@ -846,12 +871,21 @@ MIN_NODE_VERSION="22.16.0"
MIN_NPM_MAJOR=10

# ── Agent branding — adapt user-visible names to the active agent ──
if [[ -n "${NEMOCLAW_AGENT:-}" ]]; then
NEMOCLAW_AGENT="$(canonical_agent_name "$NEMOCLAW_AGENT")"
export NEMOCLAW_AGENT
fi
case "${NEMOCLAW_AGENT:-openclaw}" in
hermes)
_CLI_DISPLAY="NemoHermes"
_AGENT_PRODUCT="Hermes"
_CLI_BIN="nemohermes"
;;
langchain-deepagents-code)
_CLI_DISPLAY="NemoDeepAgents"
_AGENT_PRODUCT="LangChain Deep Agents Code"
_CLI_BIN="nemo-deepagents"
;;
*)
_CLI_DISPLAY="NemoClaw"
_AGENT_PRODUCT="OpenClaw"
Expand Down Expand Up @@ -1536,8 +1570,8 @@ is_real_nemoclaw_cli() {
local expected_name="${2:-$_CLI_BIN}"
local version_output
version_output="$("$bin_path" --version 2>/dev/null)" || return 1
# Real CLI outputs: "nemoclaw v0.1.0" or "nemohermes v0.1.0"
# (or any semver, with optional pre-release/build metadata).
# Real CLI outputs: "nemoclaw v0.1.0", "nemohermes v0.1.0", or
# "nemo-deepagents v0.1.0" (or any semver, with optional pre-release/build metadata).
[[ "$version_output" =~ ^${expected_name}[[:space:]]+v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?([+][0-9A-Za-z.-]+)?$ ]]
}

Expand Down
66 changes: 66 additions & 0 deletions src/lib/actions/update.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,32 @@ describe("runUpdateAction", () => {
);
});

it("--check renders NemoDeepAgents branding and installer guidance when the Deep Agents alias is active", async () => {
const log = vi.fn();

const result = await runUpdateAction(
{ check: true },
{
currentVersion: () => "0.1.0",
env: { ...process.env, NEMOCLAW_AGENT: "dcode" },
getLatestVersion: () => "0.2.0",
isSourceCheckout: () => false,
log,
spawnSyncImpl: vi.fn(),
},
);

expect(result.status).toBe(0);
expect(log).toHaveBeenCalledWith(
expect.stringContaining("Current NemoDeepAgents version: 0.1.0"),
);
expect(log).toHaveBeenCalledWith(
expect.stringContaining(
"curl -fsSL https://www.nvidia.com/nemoclaw.sh | NEMOCLAW_AGENT=langchain-deepagents-code bash",
),
);
});

it("does not run the installer for developer source checkouts", async () => {
const error = vi.fn();
const spawnSyncImpl = vi.fn();
Expand Down Expand Up @@ -226,6 +252,46 @@ describe("runUpdateAction", () => {
expect(options?.env?.NEMOCLAW_INSTALL_TAG).toBeUndefined();
});

it("preserves the canonical Deep Agents agent selection while sanitizing installer env", async () => {
const spawnSyncImpl = vi.fn(
() => ({ status: 0, stdout: "", stderr: "", signal: null }) as never,
);
const log = vi.fn();

await runUpdateAction(
{ yes: true },
{
currentVersion: () => "0.1.0",
env: {
...process.env,
BASH_ENV: "/tmp/review-bash-env",
NEMOCLAW_AGENT: "langchain-deepagents-code",
NEMOCLAW_INSTALL_REF: "refs/heads/not-maintained",
},
getLatestVersion: () => "0.2.0",
isSourceCheckout: () => false,
log,
spawnSyncImpl,
},
);

const calls = spawnSyncImpl.mock.calls as unknown as Array<
[string, readonly string[], { env?: NodeJS.ProcessEnv }]
>;
const options = calls[0]?.[2];
expect(options?.env?.NEMOCLAW_AGENT).toBe("langchain-deepagents-code");
expect(options?.env?.BASH_ENV).toBeUndefined();
expect(options?.env?.NEMOCLAW_INSTALL_REF).toBeUndefined();
expect(log).toHaveBeenCalledWith(
expect.stringContaining("Running maintained NemoDeepAgents installer"),
);
expect(log).toHaveBeenCalledWith(
expect.stringContaining(
"Installer completed. Run `nemo-deepagents upgrade-sandboxes --check`",
),
);
});

it("preserves the Hermes agent selection while sanitizing installer env", async () => {
const spawnSyncImpl = vi.fn(
() => ({ status: 0, stdout: "", stderr: "", signal: null }) as never,
Expand Down
14 changes: 13 additions & 1 deletion src/lib/actions/update.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ import fs from "node:fs";
import os from "node:os";
import path from "node:path";

import { resolveAgentNameAlias } from "../agent/aliases";
import { versionGte } from "../domain/installer/version";

export const NEMOCLAW_INSTALLER_URL = "https://www.nvidia.com/nemoclaw.sh";
Expand Down Expand Up @@ -57,14 +58,25 @@ function trimOutput(value: string | Buffer | null | undefined): string {
return String(value ?? "").trim();
}

const UPDATE_BRANDING_AGENTS = ["openclaw", "hermes", "langchain-deepagents-code"] as const;

function updateBranding(env: NodeJS.ProcessEnv): UpdateBranding {
if (env.NEMOCLAW_AGENT === "hermes") {
const agent =
resolveAgentNameAlias(env.NEMOCLAW_AGENT, UPDATE_BRANDING_AGENTS) ?? env.NEMOCLAW_AGENT;
if (agent === "hermes") {
return {
cliName: "nemohermes",
displayName: "NemoHermes",
maintainedUpdateCommand: `curl -fsSL ${NEMOCLAW_INSTALLER_URL} | NEMOCLAW_AGENT=hermes bash`,
};
}
if (agent === "langchain-deepagents-code") {
return {
cliName: "nemo-deepagents",
displayName: "NemoDeepAgents",
maintainedUpdateCommand: `curl -fsSL ${NEMOCLAW_INSTALLER_URL} | NEMOCLAW_AGENT=langchain-deepagents-code bash`,
};
}
return {
cliName: "nemoclaw",
displayName: "NemoClaw",
Expand Down
Loading
Loading