Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
88 commits
Select commit Hold shift + click to select a range
e3eb9bd
fix: stop agents where group signals are denied
cv Nov 1, 2026
7bb12a1
fix: bound OpenClaw's whole start by one deadline
cv Nov 1, 2026
f638e44
feat: serve OpenClaw's Control UI from managed runtimes
cv Nov 1, 2026
7ed10ce
feat: serve Hermes's API server and dashboard from a runtime
cv Nov 1, 2026
3a5abc2
feat: keep an agent's state in one folder across its runtimes
cv Nov 1, 2026
fd471cf
feat: keep an agent's state in one folder across its runtimes
cv Nov 1, 2026
35658a6
feat: keep Hermes's home in the agent's state folder
cv Nov 1, 2026
dde1815
test: skip the OpenClaw tests that run the mock script where CI can't
cv Nov 1, 2026
76a81da
Merge branch 'pr/04-openclaw-control-ui' into pr/05-hermes-interfaces
cv Nov 1, 2026
a70d158
Merge branch 'pr/05-hermes-interfaces' into pr/09-hermes-keep-state
cv Nov 1, 2026
9bfb8e3
fix: let a service share an agent's kept state with one runtime
cv Nov 2, 2026
20118ba
fix: probe loopback ports exclusively on Windows
cv Nov 2, 2026
005aa7e
fix: keep Hermes interface start and stop within their limits
cv Nov 2, 2026
d2a63a6
fix: remove a stale Hermes API token from a kept home at start
cv Nov 2, 2026
075f8c4
docs: correct OpenClaw's dashboard port and token file claims
cv Nov 2, 2026
e9d3336
test: cover a disabled OpenClaw dashboard and token cleanup after fai…
cv Nov 2, 2026
427a3e3
fix: don't signal a child's PID after it exits
cv Nov 2, 2026
532424e
fix: end OpenClaw's readiness check at the startup deadline
cv Nov 2, 2026
4a6009a
docs: describe OpenClaw's startup deadline
cv Nov 2, 2026
0fcad06
Merge branch 'prop/04' into prop/05
cv Nov 2, 2026
4ad13a8
Merge branch 'prop/05' into prop/09
cv Nov 2, 2026
e9ffe44
fix: let a service share an agent's kept state with one runtime
cv Nov 2, 2026
1385540
fix: forget a service's connected runtime even when its stop fails
cv Nov 2, 2026
f231a6a
fix: forget a service's connected runtime even when its stop fails
cv Nov 2, 2026
b675e51
fix: keep agent state out of workspace patches and its lock beside it
cv Nov 3, 2026
ee5dc9d
fix: keep agent state out of workspace patches and its lock beside it
cv Nov 3, 2026
f48e793
fix: refuse Hermes interfaces on Windows before any child starts
cv Nov 3, 2026
7df0958
Merge branch 'fix/05' into fix/09
cv Nov 3, 2026
eb12912
Merge branch 'main' into pr/08-keep-state
cv Nov 4, 2026
e395dc9
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 4, 2026
00d8427
Merge branch 'main' into pr/05-hermes-interfaces
cv Nov 4, 2026
89fcb62
Merge branch 'main' into pr/09-hermes-keep-state
cv Nov 4, 2026
1b969f9
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 5, 2026
f232890
Merge branch 'pr/04-openclaw-control-ui' into pr/05-hermes-interfaces
cv Nov 5, 2026
96023ca
Merge branch 'main' into pr/08-keep-state
cv Nov 5, 2026
7e7961b
Merge branch 'pr/05-hermes-interfaces' into pr/09-hermes-keep-state
cv Nov 5, 2026
a3862de
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 5, 2026
ef3ce6c
test: release the service before removing the failed-stop test root
cv Nov 5, 2026
838f0bc
fix: retry removing the OpenClaw dashboard token after a failed stop
cv Nov 5, 2026
d9f57a6
fix: keep tracked agent state out of workspace patches
cv Nov 5, 2026
7b70972
test: check Hermes's Windows refusal never spawns an interface
cv Nov 5, 2026
9e867d8
fix: refuse Hermes interfaces on Windows before MCP discovery
cv Nov 5, 2026
45d5c3e
Merge branch 'pr/04-openclaw-control-ui' into pr/05-hermes-interfaces
cv Nov 5, 2026
c96c6b9
Merge branch 'pr/05-hermes-interfaces' into pr/09-hermes-keep-state
cv Nov 5, 2026
5adc5a8
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 5, 2026
7027d6c
Merge branch 'main' into pr/08-keep-state
cv Nov 6, 2026
e3b2537
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 6, 2026
12358b6
Merge branch 'main' into pr/08-keep-state
cv Nov 6, 2026
914a398
Merge branch 'pr/04-openclaw-control-ui' into pr/09-hermes-keep-state
cv Nov 6, 2026
989aa4c
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 6, 2026
fb91e92
test: verify native supplied-skill loading in Hermes and OpenClaw
jyaunches Nov 6, 2026
612da0f
test: document native skill loading assertions
jyaunches Nov 6, 2026
71b5039
test: check native Hermes discovery after skill removal
jyaunches Nov 6, 2026
72fabd4
feat: resolve skill folders in the adapter contract
cv Nov 6, 2026
ec77dcc
feat: accept a folder of skills in OpenClaw and Hermes
cv Nov 6, 2026
23f9553
fix: ignore unreadable folders and read skill names like YAML
cv Nov 7, 2026
c7851d6
docs: say that a skills.paths entry that is not a folder fails
cv Nov 7, 2026
14071d8
test: read and write skill test files as UTF-8
cv Nov 7, 2026
b06bd9c
feat: resolve skill folders in the TypeScript adapter contract
cv Nov 7, 2026
7370baf
docs: say which adapters load skill folders and how harnesses differ
cv Nov 7, 2026
1a6d4dd
fix: keep an agent's kept state private and inside its state folder
cv Nov 7, 2026
a037530
docs: name the public SDK methods for kept state
cv Nov 7, 2026
17f8372
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 7, 2026
1c94844
Merge branch 'pr/09-hermes-keep-state' into pr/10-skill-paths
cv Nov 7, 2026
7f362e0
test: run the TypeScript skills tests after the build
cv Nov 7, 2026
d92b880
feat: resolve skill folders in the TypeScript adapter host
cv Nov 7, 2026
cc8bbf9
feat: accept a folder of skills in the OpenHands, Codex, Claude, and …
cv Nov 7, 2026
e6e66a0
feat: accept a folder of skills in the TypeScript adapters
cv Nov 7, 2026
53ca031
docs: list the adapters that accept a folder of skills
cv Nov 7, 2026
0809e5f
fix: keep an agent's state locked while its adapter host runs
cv Nov 8, 2026
313dfa8
fix: compare skill folders by path when the file system has no inode
cv Nov 8, 2026
d1e9b68
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 8, 2026
353af9d
Merge branch 'pr/09-hermes-keep-state' into pr/10-skill-paths
cv Nov 8, 2026
9ddb44a
Merge branch 'pr/10-skill-paths' into pr/11-skill-paths-adapters
cv Nov 8, 2026
13b8724
test: share the OpenClaw dashboard tests' start payload
cv Nov 8, 2026
d183364
test: combine the kept-state path tests
cv Nov 8, 2026
a9d48bd
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 8, 2026
c61a452
Merge branch 'pr/04-openclaw-control-ui' into pr/09-hermes-keep-state
cv Nov 8, 2026
44e78c6
docs: point the Hermes README at the guide for kept state
cv Nov 8, 2026
8da3432
Merge branch 'pr/09-hermes-keep-state' into pr/10-skill-paths
cv Nov 8, 2026
316fbdf
refactor: trim the skill-folder change to what OpenClaw and Hermes need
cv Nov 8, 2026
ef73876
Merge branch 'pr/10-skill-paths' into pr/11-skill-paths-adapters
cv Nov 8, 2026
312f5d0
test: drop adapter tests that repeat the resolver's empty-folder case
cv Nov 8, 2026
a2fdcca
test: share fixtures across the TypeScript skill resolver tests
cv Nov 8, 2026
e89d6c7
docs: say how long the kept-state lock lasts
cv Nov 8, 2026
9ac19c7
Merge branch 'pr/08-keep-state' into pr/09-hermes-keep-state
cv Nov 8, 2026
efc9ac7
Merge branch 'pr/09-hermes-keep-state' into pr/10-skill-paths
cv Nov 8, 2026
c8003f8
Merge branch 'pr/10-skill-paths' into pr/11-skill-paths-adapters
cv Nov 8, 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
11 changes: 11 additions & 0 deletions .github/workflows/ci_python.yml
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,17 @@ jobs:
set -euo pipefail
just --set no_uv true test-python

- name: Test skill loading with pinned native OpenClaw
if: matrix.platform == 'linux-amd64' && matrix.python-version == '3.12'
run: |
set -euo pipefail
openclaw_root="$RUNNER_TEMP/fabric-openclaw-skills"
npm exec --yes --package=npm@11.16.0 -- npm install --global \
--prefix "$openclaw_root" --no-audit --no-fund \
--allow-scripts=openclaw openclaw@2026.9.34
export OPENCLAW_TEST_PACKAGE="$openclaw_root/lib/node_modules/openclaw"
uv run --no-sync pytest tests/e2e/test_openclaw_skills.py -q

- name: Test Kiro health with the pinned native CLI
if: matrix.platform == 'linux-amd64' && matrix.python-version == '3.12'
env:
Expand Down
31 changes: 31 additions & 0 deletions ATTRIBUTIONS-Node.md
Original file line number Diff line number Diff line change
Expand Up @@ -24608,6 +24608,37 @@ MIT License
SOFTWARE
```

## @types/node - 20.19.43

**Repository URL**: https://github.com/DefinitelyTyped/DefinitelyTyped
**License Type(s)**: MIT

### License: https://spdx.org/licenses/MIT.html

```
MIT License

Copyright (c) Microsoft Corporation.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE
```

## @types/node - 22.19.19

**Repository URL**: https://github.com/DefinitelyTyped/DefinitelyTyped
Expand Down
13 changes: 13 additions & 0 deletions adapter-contract/python/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,19 @@ Import `AgentConfig` from the contract models module:
from nemo_fabric_adapter_contract.models import AgentConfig
```

Resolve `skills.paths` in the task environment with the contract's skills
helper. Each entry is a skill folder or a folder of skills:

```python
from nemo_fabric_adapter_contract.skills import SkillPathError, resolve_skills

skills = resolve_skills(config.skills.paths if config.skills else [], base_dir)
```

The helper returns each skill's name and resolved folder. It raises
`SkillPathError` with the failing `skills.paths[N]` field when an entry cannot
be loaded or two skills share a name.

An adapter descriptor opts into the southbound configuration with
`config.input=agent_config`. Python adapters using the optional common
lifecycle host pass `AgentConfig.from_mapping` as the `config_loader`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -647,6 +647,7 @@ class RuntimeContext(ContractModel):
artifacts: ArtifactManifest
telemetry: RuntimeTelemetryContext | None = _optional()
deadline_millis: int | None = _optional()
state_dir: str | Path | None = _optional()

def _validate(self) -> None:
_nonblank(self.runtime_id, "runtime_id")
Expand Down
197 changes: 197 additions & 0 deletions adapter-contract/python/src/nemo_fabric_adapter_contract/skills.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,197 @@
# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

"""Resolve ``skills.paths`` entries in the task environment.

Each entry names one skill or a folder of skills:

1. An entry that contains ``SKILL.md`` is one skill.
2. Otherwise each folder directly inside the entry that contains ``SKILL.md``
is a skill. Other files and folders are ignored.
3. An entry that exists but holds no skills loads nothing.
4. An entry that does not exist, or is not a folder, fails.
5. Two skills with the same name fail.

A skill's name is the ``name`` field of its ``SKILL.md`` front matter, or its
folder name when the front matter has none.
"""

from __future__ import annotations

import os
import re
from collections.abc import Iterable
from dataclasses import dataclass
from pathlib import Path
from typing import Literal

SKILL_FILE = "SKILL.md"

SkillPathFailure = Literal["not_found", "invalid", "duplicate"]

_NAME = re.compile(r"name:(?:[ \t]+(.*?))?[ \t]*")
_COMMENT = re.compile(r"[ \t]+#")


@dataclass(frozen=True)
class Skill:
"""One skill found through ``skills.paths``."""

name: str
"""Name from the skill's front matter, or its folder name."""
path: Path
"""Resolved folder that contains the skill's ``SKILL.md``."""
field: str
"""The ``skills.paths`` entry that supplied the skill, such as ``skills.paths[0]``."""


class SkillPathError(ValueError):
"""A ``skills.paths`` entry that cannot be loaded."""

def __init__(
self,
reason: SkillPathFailure,
message: str,
*,
field: str,
paths: tuple[Path, ...],
) -> None:
super().__init__(message)
self.reason: SkillPathFailure = reason
self.field = field
self.paths = paths


def resolve_skills(
paths: Iterable[str | os.PathLike[str]], base_dir: str | os.PathLike[str]
) -> list[Skill]:
"""Return the skills named by ``paths``, resolving relative entries against ``base_dir``.

A folder inside an entry that cannot be read is not a skill. The same
folder reached through several entries loads once.

Raises:
SkillPathError: If an entry does not exist, is not a folder, or cannot
be read, if a skill's ``SKILL.md`` cannot be read, or if two skills
share a name.
"""

skills: list[Skill] = []
by_name: dict[str, Skill] = {}
folders: set[tuple[int, int] | Path] = set()
for index, value in enumerate(paths):
field = f"skills.paths[{index}]"
configured = Path(base_dir) / value
try:
entry = configured.resolve(strict=True)
except (OSError, RuntimeError):
raise SkillPathError(
"not_found",
f"NeMo Fabric skill path {field} does not exist: {configured}",
field=field,
paths=(configured,),
) from None
if not entry.is_dir():
raise SkillPathError(
"invalid",
f"NeMo Fabric skill path {field} is not a folder: {configured}",
field=field,
paths=(configured,),
)
for directory in _skill_directories(entry, field, configured):
folder = _folder_identity(directory)
if folder in folders:
continue
folders.add(folder)
skill = Skill(
name=_skill_name(directory, field), path=directory, field=field
)
existing = by_name.get(skill.name)
if existing is not None:
raise SkillPathError(
"duplicate",
f"NeMo Fabric skill {skill.name!r} is configured twice: "
f"{existing.path} ({existing.field}) and {skill.path} ({field})",
field=field,
paths=(existing.path, skill.path),
)
by_name[skill.name] = skill
skills.append(skill)
return skills


def _skill_directories(entry: Path, field: str, configured: Path) -> list[Path]:
try:
if (entry / SKILL_FILE).is_file():
return [entry]
children = sorted(entry.iterdir(), key=lambda child: child.name)
except OSError:
raise SkillPathError(
"invalid",
f"NeMo Fabric skill path {field} cannot be read: {configured}",
field=field,
paths=(configured,),
) from None
return [child.resolve() for child in children if _is_skill(child)]


def _is_skill(child: Path) -> bool:
# A folder that cannot be read, such as a volume's lost+found, is not a skill.
try:
return child.is_dir() and (child / SKILL_FILE).is_file()
except OSError:
return False


def _folder_identity(directory: Path) -> tuple[int, int] | Path:
# Compare folders by identity so that spellings resolve() keeps apart, such
# as a different case on a case-insensitive file system, still match. An
# inode of 0 identifies nothing, so fall back to the resolved path.
stat = directory.stat()
return (stat.st_dev, stat.st_ino) if stat.st_ino else directory


def _skill_name(directory: Path, field: str) -> str:
skill_file = directory / SKILL_FILE
try:
with skill_file.open(encoding="utf-8-sig", errors="replace") as lines:
name = _front_matter_name(lines)
except OSError:
raise SkillPathError(
"invalid",
f"NeMo Fabric skill path {field} has a {SKILL_FILE} that cannot be "
f"read: {skill_file}",
field=field,
paths=(skill_file,),
) from None
return name or directory.name


def _front_matter_name(lines: Iterable[str]) -> str | None:
"""Return the ``name`` scalar of a ``---`` front matter block, if any."""

lines = iter(lines)
if next(lines, "").rstrip() != "---":
return None
name: str | None = None
for line in lines:
line = line.rstrip()
if line == "---":
return name
match = _NAME.fullmatch(line)
if match and not name:
name = _scalar(match.group(1) or "")
# Without its closing line the block is not front matter.
return None


def _scalar(value: str) -> str:
if value[:1] in ("'", '"'):
end = value.find(value[0], 1)
rest = value[end + 1 :].strip() if end > 0 else ""
if end > 0 and (not rest or rest.startswith("#")):
return value[1:end]
return value
if value.startswith("#"):
return ""
return _COMMENT.split(value, maxsplit=1)[0]
19 changes: 19 additions & 0 deletions adapter-contract/typescript/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,25 @@ Use the maintained
for the implementation sequence and the bundled schemas for runtime
validation.

## Skill Paths

The `nemo-fabric-adapter-contract/skills` entry point resolves `skills.paths`
in the task environment with Node.js file system APIs. Each entry is a skill
folder or a folder of skills:

```typescript
import { resolveSkills, SkillPathError } from "nemo-fabric-adapter-contract/skills";

const skills = await resolveSkills(config.skills?.paths ?? [], baseDir);
```

The helper returns each skill's name, resolved folder, and `skills.paths[N]`
field. It rejects with `SkillPathError` when an entry does not exist or is not
a readable folder, when a skill's `SKILL.md` cannot be read, or when two skills
share a name. It applies the same rules as the Python contract's
`nemo_fabric_adapter_contract.skills.resolve_skills`; refer to the
[normalized configuration tutorial](https://github.com/NVIDIA/NeMo-Fabric/blob/main/docs/adapter-contract/tutorials/normalized-configuration.md).

## Invocation Types

The package root also exports the same request and result models as the Python
Expand Down
18 changes: 18 additions & 0 deletions adapter-contract/typescript/package-lock.json

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

8 changes: 7 additions & 1 deletion adapter-contract/typescript/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@
"types": "./dist/index.d.ts",
"import": "./dist/index.js"
},
"./skills": {
"types": "./dist/skills.d.ts",
"import": "./dist/skills.js"
},
"./schemas/*": "./schemas/*.schema.json",
"./package.json": "./package.json"
},
Expand All @@ -26,9 +30,10 @@
"build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
"test:generator": "node --test test/*.test.mjs",
"test:types": "tsc -p test/tsconfig.json --noEmit",
"test:skills": "npm run build && node --test test/skills/resolve-skills.test.mjs",
"test:dependencies": "node scripts/check-dependencies.mjs && npm ls --all && npm audit --audit-level=high",
"pack:check": "npm run build && node scripts/check-package.mjs",
"test": "npm run generate:check && npm run test:generator && npm run test:types && npm run test:dependencies && npm run pack:check",
"test": "npm run generate:check && npm run test:generator && npm run test:types && npm run test:skills && npm run test:dependencies && npm run pack:check",
"prepack": "npm run generate:check && npm run build"
},
"publishConfig": {
Expand All @@ -48,6 +53,7 @@
"node": ">=20.18.3"
},
"devDependencies": {
"@types/node": "20.19.43",
"json-schema-to-typescript": "15.0.4",
"typescript": "5.6.3"
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,11 @@
"description": "Per-invocation harness turn limit.",
"type": "string"
},
{
"const": "runtime.keep_state",
"description": "Agent-named state folder kept across runtimes.",
"type": "string"
},
{
"const": "tools.enabled",
"description": "Adapter-native tool names to expose.",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@
"type": "object"
},
"paths": {
"description": "Skill paths resolved for the task environment.",
"description": "Skill paths resolved for the task environment. An entry that contains\n`SKILL.md` is one skill; otherwise each folder directly inside it that\ncontains `SKILL.md` is a skill. The adapters that ship with NeMo Fabric\nfollow this rule, except Deep Agents, which passes each entry to Deep\nAgents as a skill source.",
"items": {
"type": "string"
},
Expand Down
Loading
Loading