Skip to content
Merged
Show file tree
Hide file tree
Changes from 19 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
38329e8
feat(onboard): add managed startup profile schema
ericksoa Jul 30, 2026
7f3859a
docs(onboard): clarify startup profile transport encoding
ericksoa Jul 30, 2026
32561a9
fix(onboard): harden managed startup profile
ericksoa Jul 30, 2026
087a9a5
chore(stack): sync PR3.2 with current main
ericksoa Jul 30, 2026
e1845dd
fix(onboard): close startup profile contract gaps
ericksoa Jul 30, 2026
244e3e6
chore(stack): sync PR3.2 with current main
ericksoa Jul 30, 2026
2403316
chore(stack): sync PR3.2 with current main
ericksoa Jul 30, 2026
ea5bd8a
chore(stack): sync PR3.2 with current main
ericksoa Jul 31, 2026
357081a
feat(onboard): construct managed startup profiles
ericksoa Jul 31, 2026
25d32e0
feat(onboard): map and coordinate startup profiles
ericksoa Jul 31, 2026
094d177
feat(onboard): apply startup profiles in managed images
ericksoa Jul 31, 2026
2a048ae
chore(stack): restack PR3.3 on merged PR3.2
ericksoa Jul 31, 2026
498e521
chore(stack): restack PR3.4a on PR3.3
ericksoa Jul 31, 2026
3206926
chore(stack): restack PR3.4b on PR3.4a
ericksoa Jul 31, 2026
6da5eb2
test(onboard): keep managed startup tests branchless
ericksoa Jul 31, 2026
bb7a260
chore(stack): restack PR3.4a after PR3.3 merge
ericksoa Jul 31, 2026
fafdbd1
chore(stack): restack PR3.4b after PR3.3 merge
ericksoa Jul 31, 2026
b14013f
test(onboard): cover managed startup fixture CLI
ericksoa Jul 31, 2026
46fbe19
feat(onboard): apply startup profiles in managed images
ericksoa Jul 31, 2026
c95bdf7
fix(onboard): serialize managed startup transactions
ericksoa Jul 31, 2026
3f3bdbb
feat(onboard): apply startup profiles in managed images
ericksoa Jul 31, 2026
7d1668b
test(onboard): keep transaction races branchless
ericksoa Jul 31, 2026
540494c
chore(stack): inherit PR3.4a guardrail fix
ericksoa Jul 31, 2026
3a03eeb
merge: resolve conflicts with main
github-actions[bot] Jul 31, 2026
deb1581
chore(stack): refresh PR3.4b validation
ericksoa Jul 31, 2026
e41521b
chore(stack): refresh PR3.4b on current main
ericksoa Jul 31, 2026
13932b9
chore(stack): refresh PR3.4b on current main
ericksoa Jul 31, 2026
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
4 changes: 4 additions & 0 deletions ci/env-var-doc-allowlist.json
Original file line number Diff line number Diff line change
Expand Up @@ -90,5 +90,9 @@
{
"name": "NEMOCLAW_DOCKER_GPU_PATCH_NETWORK",
"reason": "Internal one-process handoff from Docker GPU patch preparation into sandbox creation. Rebuild scopes and restores it; users must not set it."
},
{
"name": "NEMOCLAW_MANAGED_HERMES_HASH_B64",
"reason": "Internal one-process transport from the root image applicator to its sandbox-owned Hermes compatibility-hash writer. The value is a bounded base64-encoded hash receipt that only the private internal writer consumes; users must not set it."
}
]
230 changes: 230 additions & 0 deletions scripts/checks/generate-managed-startup-profile-fixture.mts
Original file line number Diff line number Diff line change
@@ -0,0 +1,230 @@
#!/usr/bin/env -S node --experimental-strip-types

// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0

import { createHash } from "node:crypto";
import { resolve } from "node:path";
import { pathToFileURL } from "node:url";
import {
encodeManagedStartupProfile,
MANAGED_STARTUP_AGENTS,
MANAGED_STARTUP_PROFILE_SCHEMA_VERSION,
type ManagedStartupAgent,
type ManagedStartupProfile,
} from "../../src/lib/onboard/managed-startup/profile.ts";

const AGENTS = new Set<ManagedStartupAgent>(MANAGED_STARTUP_AGENTS);

export const MANAGED_STARTUP_E2E_HTTP_PROXY = "http://fixture-http-proxy.example.test:18080";
export const MANAGED_STARTUP_E2E_HTTPS_PROXY = "http://fixture-https-proxy.example.test:18443";
export const MANAGED_STARTUP_E2E_NO_PROXY = ["localhost", "127.0.0.1", ".example.test"] as const;

// Real self-signed X.509 CA used by the no-network managed-image lifecycle
// gate. DCode additionally proves its hardened fetch transport selects the
// root-owned merged bundle containing these exact bytes.
export const MANAGED_STARTUP_E2E_CORPORATE_CA_PEM = `-----BEGIN CERTIFICATE-----
MIIDKzCCAhOgAwIBAgIUL3YNpyohvjOEzlwisLKfyiU3dRwwDQYJKoZIhvcNAQEL
BQAwJTEjMCEGA1UEAwwaTmVtb0NsYXcgVGVzdCBDb3Jwb3JhdGUgQ0EwHhcNMjYw
NzA2MDQwMjM2WhcNMzYwNzAzMDQwMjM2WjAlMSMwIQYDVQQDDBpOZW1vQ2xhdyBU
ZXN0IENvcnBvcmF0ZSBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
ALVbV5tyMc65jEH39ejvQvBk7dvI8rz8rSZl+5BWSK2a4TzKm3jD3U+qCDZPicrA
ETCDcO09bN6YIAgpB6rYg5BIURJWxFuljBIBMCZEdO6AVlbURPaGsw6RKLA3cmhx
ZekT0qMcoOKm3N+Hb5MHXsWZ8EUf0co2LsWwJgDZrdwY26gF6w+9wr3iGLE92ZbO
LHhjHUYR1oWXmkXS3YW8MN2h5I+oyL71jBiwLHUi59wogxA/LTAD97/GqwJ6DC4C
UERbIpGYhZfrbiKmT+ASJuKRXaUp/0My3IzH90RqqY70d1E/pkAsd5M8SQ332qAZ
OgW4GgO3n7gAlaN/ILwunZ8CAwEAAaNTMFEwHQYDVR0OBBYEFMa5M8bvDm85eFQi
1D5fNATE/rawMB8GA1UdIwQYMBaAFMa5M8bvDm85eFQi1D5fNATE/rawMA8GA1Ud
EwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAB8NR/0HBUH1WbbDOmGNDzge
o+4Pz0KWR5fPDSx9CrmvUk8ijKpJQcSjQcmrXuhCoRs6aExXLh+wImKkOyMIVXfd
YFWjCffSJzeBQfDlMVW+wiAjUh7xaIqpA6Z8EmpdfyoNWd30AuHjs9m8dAa8M/lP
0qhzCbjDiHNHfYSrAuBHlMJ5RsUrNVtSZGpg1dtaSBa+8XFWWNBeJrUANxb8i7Ax
MAhrfNQcxSkZH2lVY+TA2JO83v12nKXzaW1dC94SlsFf0tVSvM3QTeWVgijpr0q+
J0N7VBg2CdK6jRjKLQOSOPq3ySCicHhVRI8hxIWotif7mK3jj6D8NRalwmlHgNM=
-----END CERTIFICATE-----
`;

export function managedStartupE2eProfile(
agent: ManagedStartupAgent,
changed = false,
withCorporateCa = false,
withoutHostProxy = false,
): ManagedStartupProfile {
const model = changed ? "nvidia/nemotron-3-super-120b-a12b" : "nvidia/nemotron-3-ultra-550b-a55b";
const common = {
schemaVersion: MANAGED_STARTUP_PROFILE_SCHEMA_VERSION,
inference: {
routeProvider: "inference",
upstreamProvider: "nvidia",
model,
routedBaseUrl: "https://inference.local/v1",
upstreamEndpointUrl: null,
api: "openai-completions" as const,
},
proxy: {
managedHost: "10.200.0.1",
managedPort: 3128,
hostHttpUrl: withoutHostProxy ? null : MANAGED_STARTUP_E2E_HTTP_PROXY,
hostHttpsUrl: withoutHostProxy ? null : MANAGED_STARTUP_E2E_HTTPS_PROXY,
hostNoProxy: withoutHostProxy ? [] : MANAGED_STARTUP_E2E_NO_PROXY,
},
tools: {
disclosure: "progressive" as const,
enabledGateways: [],
},
messaging: { plan: null },
corporateCa: {
bundleSha256: withCorporateCa
? createHash("sha256").update(MANAGED_STARTUP_E2E_CORPORATE_CA_PEM).digest("hex")
: null,
},
};

switch (agent) {
case "openclaw":
return {
...common,
agent,
agentConfig: {
agent,
webSearch: { enabled: false, provider: "brave" },
otel: {
enabled: false,
endpointUrl: "http://host.openshell.internal:4318",
serviceName: "openclaw-gateway",
sampleRate: 1,
},
agentTimeoutSeconds: 600,
heartbeatEvery: null,
extraAgents: { agents: [], defaults: {}, main: {} },
deviceAuth: { disabled: true, optOutSource: "managed-onboard" },
minimalBootstrap: true,
},
inference: {
...common.inference,
primaryModelRef: `inference/${model}`,
compatibility: {},
inputModalities: ["text"],
},
dashboard: {
agent,
mode: "loopback",
url: "http://127.0.0.1:18789",
port: 18_789,
bindAddress: "127.0.0.1",
wslExposure: false,
},
tuning: {
contextWindow: 131_072,
maxTokens: 8192,
reasoning: false,
reasoningEffort: "default",
},
};
case "hermes":
return {
...common,
agent,
agentConfig: {
agent,
webSearch: { enabled: false, provider: "tavily" },
},
inference: {
...common.inference,
primaryModelRef: null,
compatibility: null,
inputModalities: null,
},
dashboard: {
agent,
mode: "disabled",
url: "http://127.0.0.1:18789",
publicPort: null,
internalPort: null,
tuiEnabled: false,
},
tuning: {
contextWindow: 131_072,
maxTokens: null,
reasoning: null,
reasoningEffort: null,
},
};
case "langchain-deepagents-code":
return {
...common,
agent,
agentConfig: {
agent,
autoApprovalMode: "disabled",
observabilityEnabled: false,
},
inference: {
...common.inference,
upstreamEndpointUrl: "https://integrate.api.nvidia.com/v1",
primaryModelRef: null,
compatibility: null,
inputModalities: null,
},
dashboard: {
agent,
mode: "disabled",
},
tuning: {
contextWindow: null,
maxTokens: null,
reasoning: null,
reasoningEffort: null,
},
};
}
}

function readAgent(value: string | undefined): ManagedStartupAgent {
if (value && AGENTS.has(value as ManagedStartupAgent)) {
return value as ManagedStartupAgent;
}
throw new Error("--agent must identify a shipped managed-image agent");
}

function main(argv: readonly string[]): void {
if (argv.length === 1 && argv[0] === "--corporate-ca-b64") {
process.stdout.write(
`${Buffer.from(MANAGED_STARTUP_E2E_CORPORATE_CA_PEM, "utf8").toString("base64")}\n`,
);
return;
}
const agentIndex = argv.indexOf("--agent");
if (agentIndex < 0) throw new Error("--agent is required");
const unexpected = argv.filter(
(value, index) =>
index !== agentIndex &&
index !== agentIndex + 1 &&
value !== "--changed" &&
value !== "--corporate-ca" &&
value !== "--without-host-proxy",
);
if (unexpected.length > 0) {
throw new Error(`unsupported arguments: ${unexpected.join(" ")}`);
}
const agent = readAgent(argv[agentIndex + 1]);
process.stdout.write(
`${encodeManagedStartupProfile(
managedStartupE2eProfile(
agent,
argv.includes("--changed"),
argv.includes("--corporate-ca"),
argv.includes("--without-host-proxy"),
),
)}\n`,
);
}

if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
try {
main(process.argv.slice(2));
} catch (error) {
console.error(error instanceof Error ? error.message : String(error));
process.exitCode = 1;
}
}
140 changes: 140 additions & 0 deletions scripts/lib/entrypoint-env-wrapper.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
#!/usr/bin/env bash
# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

# Normalize OpenShell's sandbox-create command when an OCI runtime invokes the
# image ENTRYPOINT with the literal argv:
#
# env NAME=value ... nemoclaw-start [agent command...]
#
# This runs before any managed-startup gate. Only environment names emitted by
# NemoClaw's launch renderer are promoted into the root entrypoint process;
# interpreter/loader variables such as NODE_OPTIONS, BASH_ENV, PATH, and
# LD_PRELOAD therefore cannot be smuggled into the trusted profile applicator.
#
# Result: NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGV contains the command tail.
nemoclaw_normalize_entrypoint_env_wrapper() {
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGV=("$@")
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGC="$#"
[ "$#" -gt 0 ] || return 0

case "$1" in
nemoclaw-start | /usr/local/bin/nemoclaw-start)
shift
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGV=("$@")
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGC="$#"
return 0
;;
env) ;;
*) return 0 ;;
esac

local -a _nemoclaw_original_argv=("$@")
local -a _nemoclaw_assignments=()
local _nemoclaw_self_index=-1
local _nemoclaw_index
local _nemoclaw_token
local _nemoclaw_name
local _nemoclaw_seen_names="|"

# Locate only the exact self-wrapper grammar. A normal explicit command such
# as `env FOO=bar printenv` remains a user command and is not interpreted by
# this root entrypoint normalization.
for ((_nemoclaw_index = 1; _nemoclaw_index < ${#_nemoclaw_original_argv[@]}; _nemoclaw_index += 1)); do
_nemoclaw_token="${_nemoclaw_original_argv[$_nemoclaw_index]}"
case "$_nemoclaw_token" in
nemoclaw-start | /usr/local/bin/nemoclaw-start)
_nemoclaw_self_index="$_nemoclaw_index"
break
;;
*=*) ;;
*) break ;;
esac
done

if [ "$_nemoclaw_self_index" -lt 0 ]; then
# A managed handoff must never silently degrade into an unmanaged command
# because the self-wrapper was absent or malformed.
for _nemoclaw_token in "${_nemoclaw_original_argv[@]:1}"; do
case "$_nemoclaw_token" in
NEMOCLAW_STARTUP_PROFILE_B64=* | NEMOCLAW_CORPORATE_CA_B64=*)
printf '%s\n' \
'[SECURITY] Malformed managed startup env wrapper; expected nemoclaw-start after assignments.' >&2
return 1
;;
esac
done
return 0
fi

if [ "$_nemoclaw_self_index" -gt 65 ]; then
printf '%s\n' '[SECURITY] Managed startup env wrapper has too many assignments.' >&2
return 1
fi

for ((_nemoclaw_index = 1; _nemoclaw_index < _nemoclaw_self_index; _nemoclaw_index += 1)); do
_nemoclaw_token="${_nemoclaw_original_argv[$_nemoclaw_index]}"
_nemoclaw_name="${_nemoclaw_token%%=*}"
if [ "${#_nemoclaw_token}" -gt 122880 ] \
|| [[ ! "$_nemoclaw_name" =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] \
|| [[ "$_nemoclaw_token" == *$'\n'* ]] \
|| [[ "$_nemoclaw_token" == *$'\r'* ]]; then
printf '%s\n' '[SECURITY] Managed startup env wrapper contains a malformed assignment.' >&2
return 1
fi
case "$_nemoclaw_name" in
AWS_EC2_METADATA_DISABLED | \
CHAT_UI_URL | \
HTTP_PROXY | HTTPS_PROXY | NO_PROXY | \
http_proxy | https_proxy | no_proxy | \
OPENCLAW_HOME | OPENCLAW_STATE_DIR | OPENCLAW_WORKSPACE_DIR | \
NEMOCLAW_AUTO_PAIR_DEADLINE_SECS | \
NEMOCLAW_AUTO_PAIR_FAST_DEADLINE_SECS | \
NEMOCLAW_AUTO_PAIR_FAST_REENTRY_INTERVAL_SECS | \
NEMOCLAW_AUTO_PAIR_FAST_REENTRY_POLLS | \
NEMOCLAW_AUTO_PAIR_RUN_TIMEOUT_SECS | \
NEMOCLAW_AUTO_PAIR_SLOW_INTERVAL_SECS | \
NEMOCLAW_CORPORATE_CA_B64 | \
NEMOCLAW_DASHBOARD_BIND | NEMOCLAW_DASHBOARD_PORT | \
NEMOCLAW_EXTRA_PLACEHOLDER_KEYS | \
NEMOCLAW_HERMES_DASHBOARD | \
NEMOCLAW_HERMES_DASHBOARD_INTERNAL_PORT | \
NEMOCLAW_HERMES_DASHBOARD_PORT | \
NEMOCLAW_HERMES_DASHBOARD_TUI | \
NEMOCLAW_MINIMAL_BOOTSTRAP | \
NEMOCLAW_OBSERVABILITY | \
NEMOCLAW_PROXY_HOST | NEMOCLAW_PROXY_PORT | \
NEMOCLAW_SANDBOX_NAME | \
NEMOCLAW_STARTUP_PROFILE_B64) ;;
*)
printf '%s\n' \
"[SECURITY] Managed startup env wrapper contains unsupported variable '${_nemoclaw_name}'." >&2
return 1
;;
esac
case "$_nemoclaw_seen_names" in
*"|${_nemoclaw_name}|"*)
printf '%s\n' \
"[SECURITY] Managed startup env wrapper repeats variable '${_nemoclaw_name}'." >&2
return 1
;;
esac
_nemoclaw_assignments+=("$_nemoclaw_token")
_nemoclaw_seen_names="${_nemoclaw_seen_names}${_nemoclaw_name}|"
done

# Export only after the complete vector has passed validation so malformed
# input cannot leave a partially mutated root process.
if [ "$_nemoclaw_self_index" -gt 1 ]; then
for _nemoclaw_token in "${_nemoclaw_assignments[@]}"; do
export "${_nemoclaw_token?}"
done
fi
# shellcheck disable=SC2034 # output array is consumed by the sourcing entrypoint
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGV=(
"${_nemoclaw_original_argv[@]:$((_nemoclaw_self_index + 1))}"
)
# shellcheck disable=SC2034 # output count is consumed by the sourcing entrypoint
NEMOCLAW_ENTRYPOINT_NORMALIZED_ARGC=$((\
${#_nemoclaw_original_argv[@]} - _nemoclaw_self_index - 1))
}
Loading
Loading