@swarmclawai/swarmclaw 1.5.3 → 1.5.33

package/README.md

@@ -13,48 +13,9 @@ SwarmClaw is a self-hosted AI runtime for OpenClaw and multi-agent work. It help
 GitHub: https://github.com/swarmclawai/swarmclaw  
 Docs: https://swarmclaw.ai/docs  
 Website: https://swarmclaw.ai  
+Discord: https://discord.gg/sbEavS8cPV  
 Extension tutorial: https://swarmclaw.ai/docs/extension-tutorial
 
-## Hosted Deploys
-
-SwarmClaw now ships provider-ready deploy files at the repo root:
-
-- `render.yaml` for Render Blueprint deploys from the public GHCR image
-- `fly.toml` for Fly.io image-backed deploys
-- `railway.json` for Railway-aligned health and restart defaults
-
-The published image is:
-
-```text
-ghcr.io/swarmclawai/swarmclaw:latest
-```
-
-Hosted deployments should:
-
-- mount persistent storage at `/app/data`
-- manage secrets through the provider dashboard
-- set `ACCESS_KEY` and `CREDENTIAL_SECRET`
-- point health checks at `/api/healthz`
-
-Full hosted deployment guides live at https://swarmclaw.ai/docs/deployment
-
-## OpenTelemetry OTLP Export
-
-SwarmClaw supports opt-in OTLP trace export for chat turns, direct model streams, tool execution, and structured-session runs.
-
-Minimal configuration:
-
-```bash
-OTEL_ENABLED=true
-OTEL_SERVICE_NAME=swarmclaw
-OTEL_EXPORTER_OTLP_ENDPOINT=https://your-collector:4318
-OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer your-token
-```
-
-If you need a trace-specific endpoint, set `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` directly instead.
-
-Operational docs: https://swarmclaw.ai/docs/observability
-
 ## Screenshots
 
 <table>
@@ -72,7 +33,7 @@ Operational docs: https://swarmclaw.ai/docs/observability
 <table>
  <tr>
   <td align="center"><strong>Works<br>with</strong></td>
- <td align="center"><img src="doc/assets/logos/openclaw.svg" width="32" alt="OpenClaw"><br><sub>OpenClaw</sub></td>
+  <td align="center"><img src="doc/assets/logos/openclaw.svg" width="32" alt="OpenClaw"><br><sub>OpenClaw</sub></td>
   <td align="center"><img src="public/provider-logos/hermes-agent.png" width="32" alt="Hermes Agent"><br><sub>Hermes</sub></td>
   <td align="center"><img src="doc/assets/logos/claude-code.svg" width="32" alt="Claude Code"><br><sub>Claude Code</sub></td>
   <td align="center"><img src="doc/assets/logos/codex.svg" width="32" alt="Codex"><br><sub>Codex</sub></td>
@@ -95,6 +56,131 @@ Operational docs: https://swarmclaw.ai/docs/observability
 </table>
 </div>
 
+## Requirements
+
+- Node.js 22.6+ (`nvm use` will pick up the repo's `.nvmrc`, which matches CI)
+- npm 10+ or another supported package manager
+- Docker Desktop is recommended for sandbox browser execution
+- Optional provider CLIs if you want delegated CLI backends such as Claude Code, Codex, OpenCode, or Gemini
+
+## Quick Start
+
+### Global install
+
+```bash
+npm i -g @swarmclawai/swarmclaw
+swarmclaw
+```
+
+```bash
+yarn global add @swarmclawai/swarmclaw
+swarmclaw
+```
+
+```bash
+pnpm add -g @swarmclawai/swarmclaw
+swarmclaw
+```
+
+```bash
+bun add -g @swarmclawai/swarmclaw
+swarmclaw
+```
+
+Running `swarmclaw` starts the server on `http://localhost:3456`.
+
+### From the repo
+
+```bash
+git clone https://github.com/swarmclawai/swarmclaw.git
+cd swarmclaw
+nvm use
+npm run quickstart
+```
+
+`npm run quickstart` installs dependencies, prepares local config and runtime state, and starts SwarmClaw.
+
+### Docker
+
+```bash
+git clone https://github.com/swarmclawai/swarmclaw.git
+cd swarmclaw
+mkdir -p data
+touch .env.local
+docker compose up -d --build
+```
+
+Then open `http://localhost:3456`.
+
+## ClawHub Skill
+
+Install the SwarmClaw skill for your [OpenClaw](https://openclaw.ai) agents:
+
+```bash
+clawhub install swarmclaw
+```
+
+[Browse on ClawHub](https://clawhub.ai/skills/swarmclaw)
+
+## Hosted Deploys
+
+SwarmClaw now ships provider-ready deploy files at the repo root:
+
+- `render.yaml` for Render Blueprint deploys from the public GHCR image
+- `fly.toml` for Fly.io image-backed deploys
+- `railway.json` for Railway-aligned health and restart defaults
+
+The published image is:
+
+```text
+ghcr.io/swarmclawai/swarmclaw:latest
+```
+
+Hosted deployments should:
+
+- mount persistent storage at `/app/data`
+- manage secrets through the provider dashboard
+- set `ACCESS_KEY` and `CREDENTIAL_SECRET`
+- point health checks at `/api/healthz`
+
+Full hosted deployment guides live at https://swarmclaw.ai/docs/deployment
+
+## Core Capabilities
+
+- **Providers**: OpenClaw, OpenAI, OpenRouter, Anthropic, Ollama, Hermes Agent, Google, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, Nebius, DeepInfra, plus compatible custom endpoints.
+- **OpenRouter**: <img src="public/provider-logos/openrouter.png" alt="OpenRouter logo" width="20" height="20" /> Use OpenRouter as a first-class built-in provider with its standard OpenAI-compatible endpoint and routed model IDs such as `openai/gpt-4.1-mini`.
+- **Hermes Agent**: <img src="public/provider-logos/hermes-agent.png" alt="Hermes Agent logo" width="20" height="20" /> Connect Hermes through its OpenAI-compatible API server, locally or through a reachable remote `/v1` endpoint.
+- **Delegation**: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, and native SwarmClaw subagents.
+- **Autonomy**: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
+- **Orchestration**: durable structured execution with branching, repeat loops, parallel branches, explicit joins, restart-safe run state, and contextual launch from chats, chatrooms, tasks, schedules, and API flows.
+- **Structured Sessions**: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom `/breakout`, durable transcripts, outputs, operator controls, and a visible protocols template gallery plus visual builder.
+- **Memory**: hybrid recall, graph traversal, journaling, durable documents, project-scoped context, automatic reflection memory, communication preferences, profile and boundary memory, significant events, and open follow-up loops.
+- **Wallets**: linked Base wallet generation, address management, approval-oriented limits, and agent payout identity.
+- **Connectors**: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, SwarmDock, SwarmFeed, and more.
+- **Extensions**: external tool extensions, UI modules, hooks, and install/update flows.
+
+## What SwarmClaw Focuses On
+
+- **Delegation, orchestrators, and background execution**: delegated work, orchestrator agents, subagents, durable jobs, checkpointing, and background task execution.
+- **Structured Sessions and orchestration**: temporary bounded runs for one agent or many, launched from context and backed by durable templates, branching, loops, parallel joins, transcripts, outputs, operator controls, and chatroom breakout flows.
+- **Autonomy and memory**: heartbeats, orchestrator wake cycles, schedules, long-running execution, durable memory, reflection memory, human-context learning, document recall, and project-aware context.
+- **OpenClaw integration**: named gateway profiles, external runtimes, deploy helpers, config sync, approval handling, and OpenClaw agent file editing.
+- **Runtime skills**: pinned skills, OpenClaw-compatible `SKILL.md` import, on-demand skill execution, and configurable keyword or embedding-based recommendation.
+- **Conversation-to-skill drafts**: draft a reusable skill from a real chat, review it, then approve it into the skill library.
+- **Crypto wallets**: agent-linked Solana and Ethereum wallets for balances, approvals, signing, simulation, and execution.
+- **Operator tooling**: connectors, extensions, browser automation, shell/files/git tooling, and runtime guardrails.
+
+## OpenClaw
+
+SwarmClaw is built for OpenClaw operators who need more than one agent or one gateway.
+
+- Bundle and use the official `openclaw` CLI directly from SwarmClaw.
+- Connect each SwarmClaw agent to a different OpenClaw gateway profile.
+- Discover, verify, and manage multiple gateways from one control plane.
+- Deploy official-image OpenClaw runtimes locally, via VPS bundles, or over SSH.
+- Edit OpenClaw agent files such as `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, and `AGENTS.md`.
+- Import OpenClaw `SKILL.md` files and use them in SwarmClaw's runtime skill system.
+
 ## Use Cases
 
 SwarmClaw is a general-purpose agent runtime. Here are some of the ways people use it.
@@ -230,6 +316,17 @@ These aren't exclusive templates — they're patterns you combine. A virtual com
 
 The building blocks are the same: **agents, tools, memory, delegation, schedules, connectors, and skills**. SwarmClaw just gives you the control plane to wire them together.
 
+## Skill Drafts From Conversations
+
+- From any active chat, use **Draft Skill** in the chat header.
+- Or open **Skills** and use **Draft From Current Chat**.
+- New agents keep **Conversation Skill Drafting** enabled by default, and you can switch it off per agent.
+- SwarmClaw turns useful work into a **draft suggestion**, not a live self-modifying skill.
+- Learned skills stay **user/agent scoped** by default. They can harden repeated workflows and self-heal repeated external capability failures, but they do not auto-promote into the shared reviewed skill library.
+- Review the suggested name, rationale, summary, and transcript snippet.
+- Approve it to save it into the normal skill library, or dismiss it.
+- Runtime skill recommendations can use **keyword** or **embedding** ranking from **Settings → Memory & AI → Skills**.
+
 ## SwarmDock Marketplace
 
 SwarmClaw agents can register on [SwarmDock](https://swarmdock.ai) — a peer-to-peer marketplace where autonomous AI agents discover tasks, bid competitively, complete work, and earn USDC payments on Base L2. SwarmDock is the marketplace; SwarmClaw is the control plane.
@@ -255,6 +352,34 @@ SwarmClaw agents can join [SwarmFeed](https://swarmfeed.ai) — a social network
 
 Read the docs at [swarmclaw.ai/docs/swarmfeed](https://swarmclaw.ai/docs/swarmfeed) and visit [swarmfeed.ai](https://swarmfeed.ai) for the platform itself.
 
+## OpenTelemetry OTLP Export
+
+SwarmClaw supports opt-in OTLP trace export for chat turns, direct model streams, tool execution, and structured-session runs.
+
+Minimal configuration:
+
+```bash
+OTEL_ENABLED=true
+OTEL_SERVICE_NAME=swarmclaw
+OTEL_EXPORTER_OTLP_ENDPOINT=https://your-collector:4318
+OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer your-token
+```
+
+If you need a trace-specific endpoint, set `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` directly instead.
+
+Operational docs: https://swarmclaw.ai/docs/observability
+
+## Releases
+
+### v1.5.33 Highlights
+
+- **CLI global flag compatibility**: legacy-routed commands now honor the documented `--access-key` and `--base-url` aliases even when they appear after the subcommand, so authenticated CLI automation works the same across binary entry points.
+- **Docker build memory hardening**: production Next.js builds now size `--max-old-space-size` from the detected container/cgroup memory limit, with `SWARMCLAW_BUILD_MAX_OLD_SPACE_SIZE_MB` available as an explicit override for constrained Docker Desktop and CI environments.
+
+### v1.5.31 Highlights
+
+- **Fix Docker first-run crash**: resolved `EISDIR: illegal operation on a directory, read` error when running `docker compose up` without a pre-existing `.env.local` file. Docker was creating a directory mount instead of a file, which crashed Next.js on startup. Replaced the file bind mount with `env_file` directive using `required: false`.
+
 ### v1.5.3 Highlights
 
 - **Copilot CLI v1.x compatibility**: the `copilot-cli` provider now handles the current event format (`assistant.message_delta`, `assistant.message`, updated `result` payload) while keeping backward compatibility with the legacy format. Also fixes `--resume` flag syntax. (Community contribution by [@borislavnnikolov](https://github.com/borislavnnikolov) -- PR #36)
@@ -319,116 +444,10 @@ Read the docs at [swarmclaw.ai/docs/swarmfeed](https://swarmclaw.ai/docs/swarmfe
 - **Following tab fix**: SwarmFeed Following tab gracefully handles unregistered agents instead of showing a 401 error
 - **Compose removal**: Removed manual compose UI from Feed page — agents post autonomously through their tools
 
-## Releases
-
 - GitHub releases: https://github.com/swarmclawai/swarmclaw/releases
 - npm package: https://www.npmjs.com/package/@swarmclawai/swarmclaw
 - Historical release notes: https://swarmclaw.ai/docs/release-notes
 
-
-## What SwarmClaw Focuses On
-
-- **Delegation, orchestrators, and background execution**: delegated work, orchestrator agents, subagents, durable jobs, checkpointing, and background task execution.
-- **Structured Sessions and orchestration**: temporary bounded runs for one agent or many, launched from context and backed by durable templates, branching, loops, parallel joins, transcripts, outputs, operator controls, and chatroom breakout flows.
-- **Autonomy and memory**: heartbeats, orchestrator wake cycles, schedules, long-running execution, durable memory, reflection memory, human-context learning, document recall, and project-aware context.
-- **OpenClaw integration**: named gateway profiles, external runtimes, deploy helpers, config sync, approval handling, and OpenClaw agent file editing.
-- **Runtime skills**: pinned skills, OpenClaw-compatible `SKILL.md` import, on-demand skill execution, and configurable keyword or embedding-based recommendation.
-- **Conversation-to-skill drafts**: draft a reusable skill from a real chat, review it, then approve it into the skill library.
-- **Crypto wallets**: agent-linked Solana and Ethereum wallets for balances, approvals, signing, simulation, and execution.
-- **Operator tooling**: connectors, extensions, browser automation, shell/files/git tooling, and runtime guardrails.
-
-## OpenClaw
-
-SwarmClaw is built for OpenClaw operators who need more than one agent or one gateway.
-
-- Bundle and use the official `openclaw` CLI directly from SwarmClaw.
-- Connect each SwarmClaw agent to a different OpenClaw gateway profile.
-- Discover, verify, and manage multiple gateways from one control plane.
-- Deploy official-image OpenClaw runtimes locally, via VPS bundles, or over SSH.
-- Edit OpenClaw agent files such as `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, and `AGENTS.md`.
-- Import OpenClaw `SKILL.md` files and use them in SwarmClaw’s runtime skill system.
-
-## Quick Start
-
-### Global install
-
-```bash
-npm i -g @swarmclawai/swarmclaw
-swarmclaw
-```
-
-```bash
-yarn global add @swarmclawai/swarmclaw
-swarmclaw
-```
-
-```bash
-pnpm add -g @swarmclawai/swarmclaw
-swarmclaw
-```
-
-```bash
-bun add -g @swarmclawai/swarmclaw
-swarmclaw
-```
-
-Running `swarmclaw` starts the server on `http://localhost:3456`.
-
-### From the repo
-
-```bash
-git clone https://github.com/swarmclawai/swarmclaw.git
-cd swarmclaw
-nvm use
-npm run quickstart
-```
-
-`npm run quickstart` installs dependencies, prepares local config and runtime state, and starts SwarmClaw.
-
-### Docker
-
-```bash
-git clone https://github.com/swarmclawai/swarmclaw.git
-cd swarmclaw
-mkdir -p data
-touch .env.local
-docker compose up -d --build
-```
-
-Then open `http://localhost:3456`.
-
-## Skill Drafts From Conversations
-
-- From any active chat, use **Draft Skill** in the chat header.
-- Or open **Skills** and use **Draft From Current Chat**.
-- New agents keep **Conversation Skill Drafting** enabled by default, and you can switch it off per agent.
-- SwarmClaw turns useful work into a **draft suggestion**, not a live self-modifying skill.
-- Learned skills stay **user/agent scoped** by default. They can harden repeated workflows and self-heal repeated external capability failures, but they do not auto-promote into the shared reviewed skill library.
-- Review the suggested name, rationale, summary, and transcript snippet.
-- Approve it to save it into the normal skill library, or dismiss it.
-- Runtime skill recommendations can use **keyword** or **embedding** ranking from **Settings → Memory & AI → Skills**.
-
-## Core Capabilities
-
-- **Providers**: OpenClaw, OpenAI, OpenRouter, Anthropic, Ollama, Hermes Agent, Google, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, Nebius, DeepInfra, plus compatible custom endpoints.
-- **OpenRouter**: <img src="public/provider-logos/openrouter.png" alt="OpenRouter logo" width="20" height="20" /> Use OpenRouter as a first-class built-in provider with its standard OpenAI-compatible endpoint and routed model IDs such as `openai/gpt-4.1-mini`.
-- **Hermes Agent**: <img src="public/provider-logos/hermes-agent.png" alt="Hermes Agent logo" width="20" height="20" /> Connect Hermes through its OpenAI-compatible API server, locally or through a reachable remote `/v1` endpoint.
-- **Delegation**: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, and native SwarmClaw subagents.
-- **Autonomy**: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
-- **Orchestration**: durable structured execution with branching, repeat loops, parallel branches, explicit joins, restart-safe run state, and contextual launch from chats, chatrooms, tasks, schedules, and API flows.
-- **Structured Sessions**: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom `/breakout`, durable transcripts, outputs, operator controls, and a visible protocols template gallery plus visual builder.
-- **Memory**: hybrid recall, graph traversal, journaling, durable documents, project-scoped context, automatic reflection memory, communication preferences, profile and boundary memory, significant events, and open follow-up loops.
-- **Wallets**: linked Base wallet generation, address management, approval-oriented limits, and agent payout identity.
-- **Connectors**: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, SwarmDock, SwarmFeed, and more.
-- **Extensions**: external tool extensions, UI modules, hooks, and install/update flows.
-
-## Requirements
-
-- Node.js 22.6+ (`nvm use` will pick up the repo's `.nvmrc`, which matches CI)
-- npm 10+ or another supported package manager
-- Docker Desktop is recommended for sandbox browser execution
-- Optional provider CLIs if you want delegated CLI backends such as Claude Code, Codex, OpenCode, or Gemini
-
 ## Security Notes
 
 - First run creates an access key; keep it private.
@@ -446,5 +465,6 @@ Then open `http://localhost:3456`.
 - SwarmDock marketplace: https://swarmdock.ai
 - SwarmFeed: https://swarmclaw.ai/docs/swarmfeed
 - SwarmFeed platform: https://swarmfeed.ai
+- SwarmVault: https://swarmvault.ai
 - Extensions: https://swarmclaw.ai/docs/extensions
 - CLI reference: https://swarmclaw.ai/docs/cli

package/bin/swarmclaw.js

@@ -19,6 +19,11 @@ const TS_CLI_ACTIONS = Object.freeze({
   webhooks: new Set(['list', 'get', 'create', 'update', 'delete', 'trigger']),
 })
 
+const LEGACY_TS_CLI_ALIAS_MAP = Object.freeze({
+  '--base-url': '--url',
+  '--access-key': '--key',
+})
+
 function shouldUseLegacyTsCli(argv) {
   const group = argv[0]
   const action = argv[1]
@@ -62,9 +67,37 @@ function buildLegacyTsCliArgs(cliPath, argv, options = {}) {
   return null
 }
 
+function normalizeLegacyTsCliArgv(argv) {
+  const normalized = []
+
+  for (const token of argv) {
+    if (!token.startsWith('--')) {
+      normalized.push(token)
+      continue
+    }
+
+    const eqIndex = token.indexOf('=')
+    const flag = eqIndex > -1 ? token.slice(0, eqIndex) : token
+    const mappedFlag = LEGACY_TS_CLI_ALIAS_MAP[flag]
+
+    if (!mappedFlag) {
+      normalized.push(token)
+      continue
+    }
+
+    if (eqIndex > -1) {
+      normalized.push(`${mappedFlag}=${token.slice(eqIndex + 1)}`)
+    } else {
+      normalized.push(mappedFlag)
+    }
+  }
+
+  return normalized
+}
+
 function runLegacyTsCli(argv) {
   const cliPath = path.join(__dirname, '..', 'src', 'cli', 'index.ts')
-  const args = buildLegacyTsCliArgs(cliPath, argv)
+  const args = buildLegacyTsCliArgs(cliPath, normalizeLegacyTsCliArgv(argv))
   const env = normalizeLegacyCliEnv(process.env)
   if (!args) {
     process.stderr.write('Legacy CLI commands require Node 22.6+ or an available local tsx runtime.\n')
@@ -237,6 +270,7 @@ if (require.main === module) {
 module.exports = {
   buildLegacyTsCliArgs,
   hasTsxRuntime,
+  normalizeLegacyTsCliArgv,
   TS_CLI_ACTIONS,
   normalizeLegacyCliEnv,
   printPackageVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.3",
+  "version": "1.5.33",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "license": "MIT",
   "publishConfig": {
@@ -72,7 +72,7 @@
     "lint:baseline:update": "node ./scripts/lint-baseline.mjs update",
     "cli": "node ./bin/swarmclaw.js",
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
-    "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts",
+    "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
     "test:runtime": "tsx --test src/lib/server/knowledge-sources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/app/api/approvals/route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",

package/scripts/run-next-build.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import fs from 'node:fs'
+import os from 'node:os'
 import path from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { createRequire } from 'node:module'
@@ -11,6 +12,17 @@ import { ensureBuildBootstrapPaths } from './build-bootstrap-env.mjs'
 const require = createRequire(import.meta.url)
 
 export const DEFAULT_MAX_OLD_SPACE_SIZE_MB = '8192'
+export const MIN_MAX_OLD_SPACE_SIZE_MB = 1024
+export const FALLBACK_MIN_MAX_OLD_SPACE_SIZE_MB = 512
+export const RESERVED_BUILD_MEMORY_MB = 768
+export const MAX_OLD_SPACE_RATIO = 0.75
+export const LOW_MEMORY_RATIO = 0.6
+export const BUILD_MAX_OLD_SPACE_SIZE_ENV = 'SWARMCLAW_BUILD_MAX_OLD_SPACE_SIZE_MB'
+export const CGROUP_MEMORY_LIMIT_PATHS = [
+  '/sys/fs/cgroup/memory.max',
+  '/sys/fs/cgroup/memory/memory.limit_in_bytes',
+]
+export const UNBOUNDED_MEMORY_LIMIT_BYTES = 1n << 60n
 export const TRACE_COPY_WARNING = 'Failed to copy traced files'
 export const NEXT_STANDALONE_METADATA_RELATIVE_DIR = path.join(
   'node_modules',
@@ -24,6 +36,74 @@ export const REQUIRED_NEXT_METADATA_FILES = [
   'is-metadata-route.js',
 ]
 
+function parsePositiveInteger(value) {
+  const parsed = Number.parseInt(String(value ?? '').trim(), 10)
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : null
+}
+
+export function readCgroupMemoryLimitBytes(
+  paths = CGROUP_MEMORY_LIMIT_PATHS,
+  existsSync = fs.existsSync,
+  readFileSync = fs.readFileSync,
+) {
+  for (const filePath of paths) {
+    if (!existsSync(filePath)) continue
+
+    let raw = ''
+    try {
+      raw = String(readFileSync(filePath, 'utf8')).trim()
+    } catch {
+      continue
+    }
+
+    if (!raw || raw === 'max') continue
+
+    try {
+      const bytes = BigInt(raw)
+      if (bytes <= 0n || bytes >= UNBOUNDED_MEMORY_LIMIT_BYTES) continue
+      return Number(bytes)
+    } catch {
+      continue
+    }
+  }
+
+  return null
+}
+
+export function deriveMaxOldSpaceSizeMb(memoryLimitBytes, defaultMaxOldSpaceSizeMb = DEFAULT_MAX_OLD_SPACE_SIZE_MB) {
+  const defaultMb = parsePositiveInteger(defaultMaxOldSpaceSizeMb) ?? Number.parseInt(DEFAULT_MAX_OLD_SPACE_SIZE_MB, 10)
+  const limitMb = Math.floor(Number(memoryLimitBytes) / (1024 * 1024))
+  if (!Number.isFinite(limitMb) || limitMb <= 0) return String(defaultMb)
+
+  const constrainedCandidate = Math.min(
+    defaultMb,
+    limitMb - RESERVED_BUILD_MEMORY_MB,
+    Math.floor(limitMb * MAX_OLD_SPACE_RATIO),
+  )
+  if (constrainedCandidate >= MIN_MAX_OLD_SPACE_SIZE_MB) {
+    return String(constrainedCandidate)
+  }
+
+  return String(Math.max(
+    FALLBACK_MIN_MAX_OLD_SPACE_SIZE_MB,
+    Math.min(defaultMb, Math.floor(limitMb * LOW_MEMORY_RATIO)),
+  ))
+}
+
+export function resolveNextBuildMaxOldSpaceSizeMb(
+  env = process.env,
+  options = {},
+) {
+  const explicit = parsePositiveInteger(env[BUILD_MAX_OLD_SPACE_SIZE_ENV])
+  if (explicit) return String(explicit)
+
+  const readLimitBytes = options.readCgroupMemoryLimitBytes ?? readCgroupMemoryLimitBytes
+  const totalMemFn = options.totalMem ?? os.totalmem
+  const memoryLimitBytes = readLimitBytes() ?? totalMemFn()
+
+  return deriveMaxOldSpaceSizeMb(memoryLimitBytes, DEFAULT_MAX_OLD_SPACE_SIZE_MB)
+}
+
 export function mergeNodeOptions(nodeOptions = '', maxOldSpaceSizeMb = DEFAULT_MAX_OLD_SPACE_SIZE_MB) {
   const trimmed = nodeOptions.trim()
   if (/(^|\s)--max-old-space-size(?:=|\s|$)/.test(trimmed)) return trimmed
@@ -120,12 +200,17 @@ export function repairStandaloneNextMetadata(cwd = process.cwd()) {
   return true
 }
 
-export function runNextBuild(args = process.argv.slice(2), env = process.env, cwd = process.cwd()) {
+export function runNextBuild(
+  args = process.argv.slice(2),
+  env = process.env,
+  cwd = process.cwd(),
+  maxOldSpaceSizeMb = resolveNextBuildMaxOldSpaceSizeMb(env),
+) {
   const nextBin = require.resolve('next/dist/bin/next')
   return spawnSync(process.execPath, [nextBin, 'build', '--webpack', ...args], {
     stdio: 'pipe',
     encoding: 'utf-8',
-    env: buildNextBuildEnv(env, DEFAULT_MAX_OLD_SPACE_SIZE_MB, cwd),
+    env: buildNextBuildEnv(env, maxOldSpaceSizeMb, cwd),
     cwd,
   })
 }