Skip to content

Document container config DB, on-wake restarts, and CLI scope#289

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/container-config-db-1778347989
Open

Document container config DB, on-wake restarts, and CLI scope#289
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/container-config-db-1778347989

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 9, 2026

Summary

Reflects three v2.0.46–v2.0.48 changes from qwibitai/nanoclaw:

  • Per-agent-group container runtime config moved from groups/<folder>/container.json to the new container_configs table in the central DB. The file is materialized at spawn time as a snapshot for the container runner. Existing filesystem configs are backfilled on startup.
  • Container restart is now explicit. Config CLI operations no longer auto-kill containers — use ncl groups restart --id <group-id> [--rebuild] [--message <text>]. The new on_wake flag on messages_in lets a fresh container's first poll claim the wake message, eliminating the race with a dying container in its SIGTERM grace period. Self-mod approval handlers (install_packages, add_mcp_server) use the same mechanism.
  • New cli_scope setting on container config (disabled / group / global, default group) controls what an agent can access via ncl from inside its container. Owner agent groups default to global. Escalation from group-scoped agents is blocked, and post-handler result filtering prevents cross-group data leaks.

Pages updated

  • concepts/containers.mdx — DB-backed config, MCP/package CLI commands, explicit restart + on-wake section
  • concepts/groups.mdx — agent group definition, additional_mounts source, new "CLI scope" section
  • api/configuration.mdx — per-group runtime config moved to central DB
  • api/group-management.mdxcontainer_configs row in schema table, new "Admin CLI (ncl groups)" section
  • advanced/container-runtime.mdx — spawn flow reads container_configs, killContainer onExit callback, "Explicit restart and on-wake messages" section
  • features/customization.mdx — mount config moved to additional_mounts column
  • changelog/index.mdx — added v2.0.45 and v2.0.48 release entries
  • changelog/docs-updates.mdx — documentation update entry for this PR

mint validate and mint broken-links both pass.

@mintlify mintlify Bot requested a review from glifocat as a code owner May 9, 2026 17:37
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 9, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
nanoclaw-docs 🟢 Ready View Preview May 9, 2026, 5:37 PM

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.

0 participants