@better-openclaw/core 1.0.5 → 1.0.7

package/package.json

@@ -1,27 +1,26 @@
 {
   "name": "@better-openclaw/core",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "private": false,
   "description": "Core logic for better-openclaw: schemas, service registry, resolver, composer, validators and more",
-  "type": "module",
   "packageManager": "pnpm@9.15.4",
   "sideEffects": false,
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "type": "module",
   "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.mjs",
-            "default": "./dist/index.mjs"
-        },
-        "./*": {
-            "types": "./dist/*.d.ts",
-            "import": "./dist/*.mjs",
-            "default": "./dist/*.mjs"
-        }
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.mjs",
+      "default": "./dist/*.mjs"
+    }
+  },
   "scripts": {
-    "prepublishOnly": "npm run build",
     "build": "tsdown",
     "build:tsc": "tsc",
     "dev": "tsc --watch",
@@ -39,9 +38,10 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
     "@types/node": "^25.2.2",
-    "tsdown": "^0.19.0",
+    "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   }
-}
+}

package/src/schema.ts

@@ -41,7 +41,7 @@ export const RestartPolicySchema = z.enum(["unless-stopped", "always", "on-failu
 
 export const ProxyTypeSchema = z.enum(["none", "caddy", "traefik"]);
 
-export const DeploymentTargetSchema = z.enum(["local", "vps", "homelab"]);
+export const DeploymentTargetSchema = z.enum(["local", "vps", "homelab", "clawexa"]);
 
 export const OutputFormatSchema = z.enum(["directory", "tar", "zip"]);
 
@@ -155,6 +155,7 @@ export const ServiceDefinitionSchema = z.object({
 	recommends: z.array(z.string()).default([]),
 	conflictsWith: z.array(z.string()).default([]),
 	mandatory: z.boolean().default(false).optional(),
+	removalWarning: z.string().optional(),
 
 	// Platform Constraints
 	platforms: z.array(PlatformSchema).optional(),

package/src/services/definitions/convex-dashboard.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const convexDashboardDefinition: ServiceDefinition = {
+	id: "convex-dashboard",
+	name: "Convex Dashboard",
+	description:
+		"Web dashboard for the self-hosted Convex backend. Browse data, run functions, view logs, and manage your deployment.",
+	category: "dev-tools",
+	icon: "📊",
+
+	image: "ghcr.io/get-convex/convex-dashboard",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 6791,
+			container: 6791,
+			description: "Convex Dashboard Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "NEXT_PUBLIC_DEPLOYMENT_URL",
+			defaultValue: "http://convex:3210",
+			secret: false,
+			description: "URL of the Convex backend (use Docker service name)",
+			required: true,
+		},
+	],
+	dependsOn: ["convex"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/get-convex/convex-backend",
+	tags: ["convex", "dashboard", "admin", "database-ui"],
+	maturity: "stable",
+
+	requires: ["convex"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/convex.ts

@@ -0,0 +1,123 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const convexDefinition: ServiceDefinition = {
+	id: "convex",
+	name: "Convex",
+	description:
+		"Self-hosted Convex reactive backend. Real-time database, server functions, and file storage in a single service. Required by Mission Control.",
+	category: "database",
+	icon: "⚡",
+
+	image: "ghcr.io/get-convex/convex-backend",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3210,
+			container: 3210,
+			description: "Convex API (client connections & CLI)",
+			exposed: true,
+		},
+		{
+			host: 3211,
+			container: 3211,
+			description: "Convex HTTP actions / site proxy",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "convex-data",
+			containerPath: "/convex/data",
+			description: "Convex data directory (SQLite by default)",
+		},
+	],
+	environment: [
+		{
+			key: "CONVEX_CLOUD_ORIGIN",
+			defaultValue: "http://127.0.0.1:3210",
+			secret: false,
+			description: "Public URL for the Convex API endpoint",
+			required: true,
+		},
+		{
+			key: "CONVEX_SITE_ORIGIN",
+			defaultValue: "http://127.0.0.1:3211",
+			secret: false,
+			description: "Public URL for Convex HTTP actions",
+			required: true,
+		},
+		{
+			key: "INSTANCE_NAME",
+			defaultValue: "openclaw-convex",
+			secret: false,
+			description: "Instance name for this Convex deployment",
+			required: false,
+		},
+		{
+			key: "INSTANCE_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "Instance secret (generate a random value for production)",
+			required: false,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "",
+			secret: true,
+			description:
+				"Optional Postgres connection string for production (leave empty to use SQLite)",
+			required: false,
+		},
+		{
+			key: "RUST_LOG",
+			defaultValue: "info",
+			secret: false,
+			description: "Log level for the Convex backend (debug, info, warn, error)",
+			required: false,
+		},
+		{
+			key: "DISABLE_BEACON",
+			defaultValue: "",
+			secret: false,
+			description: "Set to any value to disable anonymous usage telemetry",
+			required: false,
+		},
+		{
+			key: "CONVEX_SELF_HOSTED_ADMIN_KEY",
+			defaultValue: "",
+			secret: true,
+			description:
+				"Admin key for CLI access. Generate with: docker compose exec convex ./generate_admin_key.sh",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -f http://localhost:3210/version",
+		interval: "5s",
+		timeout: "5s",
+		retries: 5,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/get-convex/convex-backend",
+	selfHostedDocsUrl:
+		"https://github.com/get-convex/convex-backend/blob/main/self-hosted/README.md",
+	tags: ["convex", "database", "reactive", "real-time", "backend", "self-hosted"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["convex-dashboard"],
+	conflictsWith: [],
+	mandatory: true,
+	removalWarning:
+		"Convex is the backend for Mission Control. Without it, Mission Control will not be able to store or retrieve any data and will be completely non-functional.",
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/index.ts

@@ -6,6 +6,8 @@ export { caddyDefinition } from "./caddy.js";
 export { chromadbDefinition } from "./chromadb.js";
 export { claudeCodeDefinition } from "./claude-code.js";
 export { codeServerDefinition } from "./code-server.js";
+export { convexDefinition } from "./convex.js";
+export { convexDashboardDefinition } from "./convex-dashboard.js";
 export { codexDefinition } from "./codex.js";
 export { coolifyDefinition } from "./coolify.js";
 export { difyDefinition } from "./dify.js";
@@ -30,6 +32,7 @@ export { matomoDefinition } from "./matomo.js";
 export { matrixSynapseDefinition } from "./matrix-synapse.js";
 export { mattermostDefinition } from "./mattermost.js";
 export { meilisearchDefinition } from "./meilisearch.js";
+export { missionControlDefinition } from "./mission-control.js";
 export { minioDefinition } from "./minio.js";
 export { mixpostDefinition } from "./mixpost.js";
 export { motionCanvasDefinition } from "./motion-canvas.js";
@@ -58,6 +61,7 @@ export { tailscaleDefinition } from "./tailscale.js";
 export { temporalDefinition } from "./temporal.js";
 export { traefikDefinition } from "./traefik.js";
 export { umamiDefinition } from "./umami.js";
+export { usesendDefinition } from "./usesend.js";
 export { uptimeKumaDefinition } from "./uptime-kuma.js";
 export { valkeyDefinition } from "./valkey.js";
 export { watchtowerDefinition } from "./watchtower.js";
@@ -73,6 +77,8 @@ import { caddyDefinition } from "./caddy.js";
 import { chromadbDefinition } from "./chromadb.js";
 import { claudeCodeDefinition } from "./claude-code.js";
 import { codeServerDefinition } from "./code-server.js";
+import { convexDefinition } from "./convex.js";
+import { convexDashboardDefinition } from "./convex-dashboard.js";
 import { codexDefinition } from "./codex.js";
 import { coolifyDefinition } from "./coolify.js";
 import { difyDefinition } from "./dify.js";
@@ -97,6 +103,7 @@ import { matomoDefinition } from "./matomo.js";
 import { matrixSynapseDefinition } from "./matrix-synapse.js";
 import { mattermostDefinition } from "./mattermost.js";
 import { meilisearchDefinition } from "./meilisearch.js";
+import { missionControlDefinition } from "./mission-control.js";
 import { minioDefinition } from "./minio.js";
 import { mixpostDefinition } from "./mixpost.js";
 import { motionCanvasDefinition } from "./motion-canvas.js";
@@ -125,6 +132,7 @@ import { tailscaleDefinition } from "./tailscale.js";
 import { temporalDefinition } from "./temporal.js";
 import { traefikDefinition } from "./traefik.js";
 import { umamiDefinition } from "./umami.js";
+import { usesendDefinition } from "./usesend.js";
 import { uptimeKumaDefinition } from "./uptime-kuma.js";
 import { valkeyDefinition } from "./valkey.js";
 import { watchtowerDefinition } from "./watchtower.js";
@@ -178,6 +186,8 @@ export const allServiceDefinitions: ServiceDefinition[] = [
 	watchtowerDefinition,
 	dozzleDefinition,
 	beszelDefinition,
+	convexDefinition,
+	convexDashboardDefinition,
 	claudeCodeDefinition,
 	opencodeDefinition,
 	codexDefinition,
@@ -187,6 +197,8 @@ export const allServiceDefinitions: ServiceDefinition[] = [
 	mixpostDefinition,
 	matomoDefinition,
 	umamiDefinition,
+	usesendDefinition,
+	missionControlDefinition,
 	openpanelDefinition,
 	lightpandaDefinition,
 	steelBrowserDefinition,

package/src/services/definitions/mission-control.ts

@@ -0,0 +1,71 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const missionControlDefinition: ServiceDefinition = {
+	id: "mission-control",
+	name: "Mission Control",
+	description:
+		"Real-time agent oversight dashboard for OpenClaw. Kanban task board, live activity feed, document browser, and message threads — powered by Convex.",
+	category: "dev-tools",
+	icon: "🛸",
+
+	image: "ghcr.io/bidewio/mission-control",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3660,
+			container: 3660,
+			description: "Mission Control Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "VITE_CONVEX_URL",
+			defaultValue: "http://127.0.0.1:3210",
+			secret: false,
+			description:
+				"Convex backend URL as seen from the browser (build-time, embedded in JS bundle)",
+			required: true,
+		},
+		{
+			key: "CONVEX_SELF_HOSTED_URL",
+			defaultValue: "http://convex:3210",
+			secret: false,
+			description:
+				"Internal Docker URL for pushing Convex functions during build",
+			required: true,
+		},
+		{
+			key: "CONVEX_SELF_HOSTED_ADMIN_KEY",
+			defaultValue: "",
+			secret: true,
+			description:
+				"Admin key for the self-hosted Convex backend. Generate with: docker compose exec convex ./generate_admin_key.sh",
+			required: true,
+		},
+	],
+	dependsOn: ["convex"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl:
+		"https://github.com/bidewio/better-openclaw/tree/main/packages/mission-control",
+	selfHostedDocsUrl:
+		"https://github.com/bidewio/better-openclaw/tree/main/packages/mission-control",
+	tags: ["openclaw", "dashboard", "monitoring", "agents", "analytics", "convex"],
+	maturity: "stable",
+
+	requires: ["convex"],
+	recommends: ["convex-dashboard"],
+	conflictsWith: [],
+	mandatory: true,
+	removalWarning:
+		"Mission Control is the primary dashboard for monitoring your OpenClaw agents. Removing it will eliminate real-time agent oversight, task management, and activity tracking.",
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/tailscale.ts

@@ -63,6 +63,8 @@ export const tailscaleDefinition: ServiceDefinition = {
 	recommends: [],
 	conflictsWith: [],
 	mandatory: true,
+	removalWarning:
+		"Tailscale provides secure VPN access to your stack via WireGuard. Without it, services will be directly exposed to the network and accessible without authentication.",
 
 	minMemoryMB: 64,
 	gpuRequired: false,

package/src/services/definitions/usesend.ts

@@ -0,0 +1,98 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const usesendDefinition: ServiceDefinition = {
+	id: "usesend",
+	name: "useSend",
+	description:
+		"Self-hosted sending infrastructure for developers. Email via AWS SES/SNS, GitHub auth, Postgres and Redis. Open-source alternative for transactional and status emails.",
+	category: "communication",
+	icon: "📧",
+
+	image: "usesend/usesend",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3000,
+			container: 3000,
+			description: "useSend web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgres://user:password@postgresql:5432/usesend",
+			secret: true,
+			description: "PostgreSQL connection URL",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://:password@redis:6379",
+			secret: true,
+			description: "Redis connection URL",
+			required: true,
+		},
+		{
+			key: "AWS_ACCESS_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "AWS access key for SES/SNS",
+			required: true,
+		},
+		{
+			key: "AWS_SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "AWS secret key for SES/SNS",
+			required: true,
+		},
+		{
+			key: "GITHUB_ID",
+			defaultValue: "",
+			secret: false,
+			description: "GitHub OAuth app client ID",
+			required: true,
+		},
+		{
+			key: "GITHUB_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "GitHub OAuth app client secret",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_URL",
+			defaultValue: "https://your-usesend-instance",
+			secret: false,
+			description: "Public URL of your useSend instance",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "Random secret for NextAuth (e.g. openssl rand -base64 32)",
+			required: true,
+		},
+	],
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.usesend.com/self-hosting/overview",
+	selfHostedDocsUrl: "https://docs.usesend.com/self-hosting/overview",
+	tags: ["email", "ses", "smtp", "transactional", "self-hosted"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/tsdown.config.ts

@@ -6,4 +6,5 @@ export default defineConfig({
   sourcemap: true,
   clean: true,
   dts: true, // Turn off dts generation if not needed for an app, speeds up build
+  inlineOnly: false,
 });