@better-openclaw/core 1.0.16 → 1.0.18

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@better-openclaw/core",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "private": false,
-  "description": "Core logic for better-openclaw: schemas, service registry, resolver, composer, validators and more",
+  "description": "Core logic for better-openclaw: schemas, service registry, resolver, composer, validators and generators",
+  "author": "bidew.io <bachir@bidew.io>",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bidewio/better-openclaw.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://better-openclaw.dev",
   "packageManager": "pnpm@9.15.4",
   "sideEffects": false,
   "main": "dist/index.mjs",
@@ -12,11 +20,13 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
       "default": "./dist/index.mjs"
     },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.mjs",
+      "require": "./dist/*.cjs",
       "default": "./dist/*.mjs"
     }
   },
@@ -43,5 +53,16 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
-  }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "openclaw",
+    "docker-compose",
+    "service-registry",
+    "resolver",
+    "composer",
+    "ai-agent"
+  ]
 }

package/src/__snapshots__/composer.snapshot.test.ts.snap

@@ -46,7 +46,7 @@ exports[`compose snapshot tests > creator preset (ffmpeg + remotion + minio + re
       redis:
         condition: service_healthy
   minio:
-    image: minio/minio:latest
+    image: minio/minio:RELEASE.2025-04-22T22-12-26Z
     environment:
       MINIO_ROOT_USER: minioadmin
       MINIO_ROOT_PASSWORD: \${MINIO_ROOT_PASSWORD}
@@ -68,7 +68,7 @@ exports[`compose snapshot tests > creator preset (ffmpeg + remotion + minio + re
       - openclaw-network
     command: server /data --console-address ':9001'
   redis:
-    image: redis:7-alpine
+    image: redis:8-alpine
     environment:
       REDIS_PASSWORD: \${REDIS_PASSWORD}
     ports:
@@ -119,7 +119,7 @@ networks:
 exports[`compose snapshot tests > creator preset (ffmpeg + remotion + minio + redis) 2`] = `
 "services:
   ffmpeg:
-    image: linuxserver/ffmpeg:latest
+    image: linuxserver/ffmpeg:8.0.1-cli-ls58
     environment:
       PUID: "1000"
       PGID: "1000"
@@ -132,7 +132,7 @@ exports[`compose snapshot tests > creator preset (ffmpeg + remotion + minio + re
     profiles:
       - media
   remotion:
-    image: remotion-dev/studio:latest
+    image: remotion-dev/studio:4
     ports:
       - \${REMOTION_PORT:-3020}:3000
     restart: unless-stopped
@@ -192,7 +192,7 @@ exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + moni
       n8n:
         condition: service_healthy
   postgresql:
-    image: postgres:16-alpine
+    image: postgres:17-alpine
     environment:
       POSTGRES_USER: openclaw
       POSTGRES_PASSWORD: \${POSTGRES_PASSWORD}
@@ -214,7 +214,7 @@ exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + moni
     networks:
       - openclaw-network
   redis:
-    image: redis:7-alpine
+    image: redis:8-alpine
     environment:
       REDIS_PASSWORD: \${REDIS_PASSWORD}
     ports:
@@ -232,7 +232,7 @@ exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + moni
     networks:
       - openclaw-network
   n8n:
-    image: docker.n8n.io/n8nio/n8n:latest
+    image: docker.n8n.io/n8nio/n8n:1.123.21
     environment:
       N8N_BASIC_AUTH_ACTIVE: "true"
       N8N_BASIC_AUTH_USER: admin
@@ -300,7 +300,7 @@ networks:
 exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + monitoring) 2`] = `
 "services:
   prometheus:
-    image: prom/prometheus:latest
+    image: prom/prometheus:v3.9.1
     ports:
       - \${PROMETHEUS_PORT:-9090}:9090
     volumes:
@@ -320,7 +320,7 @@ exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + moni
     profiles:
       - monitoring
   uptime-kuma:
-    image: louislam/uptime-kuma:1
+    image: louislam/uptime-kuma:2
     ports:
       - \${UPTIME_KUMA_PORT:-3001}:3001
     volumes:
@@ -339,7 +339,7 @@ exports[`compose snapshot tests > devops preset (n8n + postgresql + redis + moni
     profiles:
       - monitoring
   grafana:
-    image: grafana/grafana:latest
+    image: grafana/grafana:12.4.0
     environment:
       GF_SECURITY_ADMIN_USER: admin
       GF_SECURITY_ADMIN_PASSWORD: \${GF_SECURITY_ADMIN_PASSWORD}
@@ -473,7 +473,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   caddy:
-    image: caddy:2-alpine
+    image: caddy:2.11.1
     ports:
       - \${CADDY_PORT_0:-80}:80
       - \${CADDY_PORT_1:-443}:443
@@ -492,7 +492,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   meilisearch:
-    image: getmeili/meilisearch:latest
+    image: getmeili/meilisearch:v1.35.1
     environment:
       MEILI_MASTER_KEY: \${MEILI_MASTER_KEY}
     ports:
@@ -511,7 +511,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   minio:
-    image: minio/minio:latest
+    image: minio/minio:RELEASE.2025-04-22T22-12-26Z
     environment:
       MINIO_ROOT_USER: minioadmin
       MINIO_ROOT_PASSWORD: \${MINIO_ROOT_PASSWORD}
@@ -533,7 +533,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
       - openclaw-network
     command: server /data --console-address ':9001'
   postgresql:
-    image: postgres:16-alpine
+    image: postgres:17-alpine
     environment:
       POSTGRES_USER: openclaw
       POSTGRES_PASSWORD: \${POSTGRES_PASSWORD}
@@ -574,7 +574,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   redis:
-    image: redis:7-alpine
+    image: redis:8-alpine
     environment:
       REDIS_PASSWORD: \${REDIS_PASSWORD}
     ports:
@@ -592,7 +592,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   searxng:
-    image: searxng/searxng:latest
+    image: searxng/searxng:2026.2.23-4964d664f
     ports:
       - \${SEARXNG_PORT:-8080}:8080
     volumes:
@@ -609,7 +609,7 @@ exports[`compose snapshot tests > full preset (many services) 1`] = `
     networks:
       - openclaw-network
   n8n:
-    image: docker.n8n.io/n8nio/n8n:latest
+    image: docker.n8n.io/n8nio/n8n:1.123.21
     environment:
       N8N_BASIC_AUTH_ACTIVE: "true"
       N8N_BASIC_AUTH_USER: admin
@@ -719,7 +719,7 @@ exports[`compose snapshot tests > minimal preset (redis only) 1`] = `
       redis:
         condition: service_healthy
   redis:
-    image: redis:7-alpine
+    image: redis:8-alpine
     environment:
       REDIS_PASSWORD: \${REDIS_PASSWORD}
     ports:
@@ -851,7 +851,7 @@ exports[`compose snapshot tests > researcher preset (qdrant + searxng + browserl
     networks:
       - openclaw-network
   redis:
-    image: redis:7-alpine
+    image: redis:8-alpine
     environment:
       REDIS_PASSWORD: \${REDIS_PASSWORD}
     ports:
@@ -869,7 +869,7 @@ exports[`compose snapshot tests > researcher preset (qdrant + searxng + browserl
     networks:
       - openclaw-network
   searxng:
-    image: searxng/searxng:latest
+    image: searxng/searxng:2026.2.23-4964d664f
     ports:
       - \${SEARXNG_PORT:-8080}:8080
     volumes:

package/src/compose-validation.test.ts

@@ -0,0 +1,102 @@
+import * as yaml from "yaml";
+import { generate } from "./generate.js";
+import { getAllPresets } from "./presets/registry.js";
+
+const allPresets = getAllPresets();
+
+describe("docker compose config integration tests", () => {
+	for (const preset of allPresets) {
+		describe(`preset "${preset.id}"`, () => {
+			const result = generate({
+				projectName: "test-project",
+				services: preset.services,
+				skillPacks: preset.skillPacks,
+				aiProviders: [],
+				gsdRuntimes: [],
+				proxy: "none",
+				gpu: false,
+				platform: "linux/amd64",
+				deployment: "local",
+				deploymentType: "docker",
+				generateSecrets: false,
+				openclawVersion: "latest",
+				monitoring: false,
+			});
+
+			const composeContent = result.files["docker-compose.yml"]!;
+			const parsed = yaml.parse(composeContent);
+
+			it("parses as valid YAML", () => {
+				expect(parsed).toBeDefined();
+				expect(typeof parsed).toBe("object");
+			});
+
+			it("every service has an image field", () => {
+				expect(parsed.services).toBeDefined();
+				for (const [name, service] of Object.entries(parsed.services)) {
+					expect(
+						(service as Record<string, unknown>).image,
+						`service "${name}" is missing an image field`,
+					).toBeDefined();
+				}
+			});
+
+			it("every service has restart or uses default", () => {
+				for (const [name, service] of Object.entries(parsed.services)) {
+					const svc = service as Record<string, unknown>;
+					// A service should either have an explicit restart policy
+					// or rely on the default (which means the field can be absent).
+					// We just verify that if restart is set, it is a valid value.
+					if (svc.restart !== undefined) {
+						expect(
+							["always", "unless-stopped", "on-failure", "no"].includes(svc.restart as string),
+							`service "${name}" has invalid restart policy: ${svc.restart}`,
+						).toBe(true);
+					}
+				}
+			});
+
+			it("has networks defined", () => {
+				expect(parsed.networks).toBeDefined();
+				expect(typeof parsed.networks).toBe("object");
+			});
+
+			it("named volumes referenced by services are declared in top-level volumes", () => {
+				const topLevelVolumes = parsed.volumes
+					? new Set(Object.keys(parsed.volumes))
+					: new Set<string>();
+
+				for (const [serviceName, service] of Object.entries(parsed.services)) {
+					const svc = service as Record<string, unknown>;
+					const volumes = svc.volumes as string[] | undefined;
+					if (!volumes) continue;
+
+					for (const vol of volumes) {
+						const volStr = typeof vol === "string" ? vol : (vol as { source?: string })?.source;
+						if (typeof volStr !== "string") continue;
+
+						// Named volumes follow the pattern "name:path" (no leading . or /)
+						// Bind mounts start with . or / or use an absolute path
+						const parts = volStr.split(":");
+						const source = parts[0]!;
+						const isNamedVolume =
+							source.length > 0 &&
+							!source.startsWith(".") &&
+							!source.startsWith("/") &&
+							!source.startsWith("~") &&
+							!source.includes("\\") &&
+							!source.startsWith("$") &&
+							!source.includes("${");
+
+						if (isNamedVolume) {
+							expect(
+								topLevelVolumes.has(source),
+								`service "${serviceName}" references named volume "${source}" which is not declared in top-level volumes`,
+							).toBe(true);
+						}
+					}
+				}
+			});
+		});
+	}
+});

package/src/composer.test.ts

@@ -55,7 +55,7 @@ describe("compose", () => {
 		expect(parsed.services).toHaveProperty("redis");
 
 		// Redis service should have correct image
-		expect(parsed.services.redis.image).toBe("redis:7-alpine");
+		expect(parsed.services.redis.image).toBe("redis:8-alpine");
 
 		// Gateway depends_on should include redis with service_healthy (redis has healthcheck)
 		expect(parsed.services["openclaw-gateway"].depends_on).toHaveProperty("redis");