@better-openclaw/core 1.0.22 → 1.0.24

package/src/schema.ts

@@ -34,6 +34,11 @@ export const ServiceCategorySchema = z.enum([
 	"collaboration",
 	"ai-observability",
 	"fine-tuning",
+	"project-management",
+	"business-intelligence",
+	"dns-networking",
+	"iot",
+	"saas-boilerplate",
 ]);
 
 export const MaturitySchema = z.enum(["stable", "beta", "experimental"]);
@@ -149,6 +154,30 @@ export const NativeRecipeSchema = z.object({
 	systemdUnit: z.string().optional(),
 });
 
+// ─── Git Source / Build Context (for repo-based services) ───────────────────
+
+export const GitSourceSchema = z.object({
+	/** Git clone URL, e.g. "https://github.com/wasp-lang/open-saas.git" */
+	repoUrl: z.string().url(),
+	/** Branch or tag to clone. Defaults to repo's default branch. */
+	branch: z.string().optional(),
+	/** Subdirectory within the cloned repo to use as build context root. */
+	subdirectory: z.string().optional(),
+	/** Commands to run after cloning (e.g. "cp .env.example .env"). */
+	postCloneCommands: z.array(z.string()).default([]),
+});
+
+export const BuildContextSchema = z.object({
+	/** Path to Dockerfile relative to the context root. Defaults to "Dockerfile". */
+	dockerfile: z.string().optional(),
+	/** Build context path relative to the subdirectory root. Defaults to ".". */
+	context: z.string().default("."),
+	/** Docker build args to pass at build time. */
+	args: z.record(z.string(), z.string()).optional(),
+	/** Target stage in a multi-stage Dockerfile. */
+	target: z.string().optional(),
+});
+
 // ─── Service Definition ─────────────────────────────────────────────────────
 
 export const ServiceDefinitionSchema = z.object({
@@ -162,9 +191,13 @@ export const ServiceDefinitionSchema = z.object({
 	category: ServiceCategorySchema,
 	icon: z.string(),
 
-	// Docker
-	image: z.string().min(1),
-	imageTag: z.string().min(1),
+	// Docker (required for image-based services, omitted for git-based)
+	image: z.string().min(1).optional(),
+	imageTag: z.string().min(1).optional(),
+
+	// Git source (for services built from cloned repositories)
+	gitSource: GitSourceSchema.optional(),
+	buildContext: BuildContextSchema.optional(),
 	ports: z.array(PortMappingSchema).default([]),
 	volumes: z.array(VolumeMappingSchema).default([]),
 	environment: z.array(EnvVariableSchema).default([]),
@@ -274,7 +307,7 @@ export const GenerationInputSchema = z.object({
 
 export const ResolvedServiceSchema = z.object({
 	definition: ServiceDefinitionSchema,
-	addedBy: z.enum(["user", "dependency", "skill-pack", "proxy", "monitoring"]).default("user"),
+	addedBy: z.enum(["user", "dependency", "skill-pack", "proxy", "monitoring", "mandatory"]).default("user"),
 });
 
 export const AddedDependencySchema = z.object({

package/src/services/definitions/adguard-home.ts

@@ -0,0 +1,79 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const adguardHomeDefinition: ServiceDefinition = {
+	id: "adguard-home",
+	name: "AdGuard Home",
+	description:
+		"Network-wide ad and tracker blocking DNS server with parental controls, DHCP, and encrypted DNS support.",
+	category: "dns-networking",
+	icon: "🛡️",
+
+	image: "adguard/adguardhome",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3100,
+			container: 3000,
+			description: "AdGuard web UI",
+			exposed: true,
+		},
+		{
+			host: 53,
+			container: 53,
+			description: "DNS server",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "adguard-work",
+			containerPath: "/opt/adguardhome/work",
+			description: "AdGuard working data",
+		},
+		{
+			name: "adguard-conf",
+			containerPath: "/opt/adguardhome/conf",
+			description: "AdGuard configuration",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -qO- http://localhost:3000 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "ADGUARD_HOST",
+			defaultValue: "adguard-home",
+			secret: false,
+			description: "AdGuard Home hostname",
+			required: false,
+		},
+		{
+			key: "ADGUARD_PORT",
+			defaultValue: "3000",
+			secret: false,
+			description: "AdGuard Home web port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://adguard.com/en/adguard-home/overview.html",
+	tags: ["dns", "ad-blocking", "privacy", "dhcp", "pihole-alternative"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["pihole"],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/apptension-saas.ts

@@ -0,0 +1,84 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const apptensionSaasDefinition: ServiceDefinition = {
+	id: "apptension-saas",
+	name: "SaaS Boilerplate (Apptension)",
+	description:
+		"Production-ready SaaS boilerplate with React frontend, Django backend, GraphQL API, PostgreSQL, async workers, email, Stripe payments, and Docker Compose support.",
+	category: "saas-boilerplate",
+	icon: "🚀",
+
+	gitSource: {
+		repoUrl: "https://github.com/apptension/saas-boilerplate.git",
+		branch: "master",
+		postCloneCommands: [],
+	},
+	buildContext: {
+		dockerfile: "Dockerfile",
+		context: ".",
+	},
+
+	ports: [
+		{
+			host: 3101,
+			container: 80,
+			description: "Apptension SaaS web application",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "APPTENSION_SAAS_DB_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Database password for Apptension SaaS",
+			required: true,
+		},
+		{
+			key: "DB_CONNECTION",
+			defaultValue: "postgresql://apptensionsaas:${APPTENSION_SAAS_DB_PASSWORD}@postgresql:5432/apptensionsaas",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+		{
+			key: "DJANGO_SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Django secret key",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://redis:6379/0",
+			secret: false,
+			description: "Redis connection URL for caching and async workers",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:80/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.demo.saas.apptension.com",
+	tags: ["saas", "boilerplate", "react", "django", "graphql", "stripe", "enterprise"],
+	maturity: "beta",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 768,
+	gpuRequired: false,
+};

package/src/services/definitions/audiobookshelf.ts

@@ -0,0 +1,83 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const audiobookshelfDefinition: ServiceDefinition = {
+	id: "audiobookshelf",
+	name: "Audiobookshelf",
+	description:
+		"Self-hosted audiobook and podcast server with progress tracking, chapter support, and multi-user library management.",
+	category: "media",
+	icon: "🎧",
+
+	image: "ghcr.io/advplyr/audiobookshelf",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 13378,
+			container: 80,
+			description: "Audiobookshelf web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "audiobookshelf-config",
+			containerPath: "/config",
+			description: "Audiobookshelf config",
+		},
+		{
+			name: "audiobookshelf-metadata",
+			containerPath: "/metadata",
+			description: "Audiobookshelf metadata",
+		},
+		{
+			name: "audiobookshelf-audiobooks",
+			containerPath: "/audiobooks",
+			description: "Audiobook files",
+		},
+		{
+			name: "audiobookshelf-podcasts",
+			containerPath: "/podcasts",
+			description: "Podcast files",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -qO- http://localhost:80/healthcheck || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "AUDIOBOOKSHELF_HOST",
+			defaultValue: "audiobookshelf",
+			secret: false,
+			description: "Audiobookshelf hostname",
+			required: false,
+		},
+		{
+			key: "AUDIOBOOKSHELF_PORT",
+			defaultValue: "80",
+			secret: false,
+			description: "Audiobookshelf port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://www.audiobookshelf.org/docs",
+	tags: ["audiobooks", "podcasts", "streaming", "library"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/baserow.ts

@@ -0,0 +1,118 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const baserowDefinition: ServiceDefinition = {
+	id: "baserow",
+	name: "Baserow",
+	description:
+		"Open-source no-code database platform providing spreadsheet-like interface with API access, automations, and real-time collaboration.",
+	category: "knowledge",
+	icon: "📊",
+
+	image: "baserow/baserow",
+	imageTag: "1.30",
+	ports: [
+		{
+			host: 8150,
+			container: 80,
+			description: "Baserow web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "baserow-data",
+			containerPath: "/baserow/data",
+			description: "Baserow persistent data",
+		},
+	],
+	environment: [
+		{
+			key: "BASEROW_PUBLIC_URL",
+			defaultValue: "http://localhost:8150",
+			secret: false,
+			description: "Public URL for Baserow",
+			required: true,
+		},
+		{
+			key: "DATABASE_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "DATABASE_NAME",
+			defaultValue: "baserow",
+			secret: false,
+			description: "Database name",
+			required: true,
+		},
+		{
+			key: "DATABASE_USER",
+			defaultValue: "baserow",
+			secret: false,
+			description: "Database user",
+			required: true,
+		},
+		{
+			key: "DATABASE_PASSWORD",
+			defaultValue: "${BASEROW_DB_PASSWORD}",
+			secret: true,
+			description: "Database password",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://redis:6379/0",
+			secret: false,
+			description: "Redis connection URL",
+			required: true,
+		},
+		{
+			key: "SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Django secret key",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:80/api/_health/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "BASEROW_HOST",
+			defaultValue: "baserow",
+			secret: false,
+			description: "Baserow hostname",
+			required: false,
+		},
+		{
+			key: "BASEROW_PORT",
+			defaultValue: "80",
+			secret: false,
+			description: "Baserow port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://baserow.io/docs",
+	tags: ["no-code", "database", "spreadsheet", "airtable-alternative", "api"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/boxyhq-saas.ts

@@ -0,0 +1,84 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const boxyhqSaasDefinition: ServiceDefinition = {
+	id: "boxyhq-saas",
+	name: "BoxyHQ Enterprise SaaS Starter",
+	description:
+		"Enterprise-grade Next.js SaaS starter kit with SSO (SAML/OIDC), directory sync, audit logs, team management, Prisma ORM, Stripe billing, and PostgreSQL.",
+	category: "saas-boilerplate",
+	icon: "🚀",
+
+	gitSource: {
+		repoUrl: "https://github.com/boxyhq/saas-starter-kit.git",
+		branch: "main",
+		postCloneCommands: ["cp .env.example .env"],
+	},
+	buildContext: {
+		dockerfile: "Dockerfile",
+		context: ".",
+	},
+
+	ports: [
+		{
+			host: 3102,
+			container: 3000,
+			description: "BoxyHQ SaaS web application",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "BOXYHQ_SAAS_DB_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Database password for BoxyHQ SaaS",
+			required: true,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://boxyhqsaas:${BOXYHQ_SAAS_DB_PASSWORD}@postgresql:5432/boxyhqsaas",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "NextAuth.js session encryption secret",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_URL",
+			defaultValue: "http://localhost:3102",
+			secret: false,
+			description: "NextAuth.js callback URL",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:3000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/boxyhq/saas-starter-kit#readme",
+	tags: ["saas", "boilerplate", "nextjs", "enterprise", "sso", "saml", "stripe", "prisma"],
+	maturity: "beta",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/calibre-web.ts

@@ -0,0 +1,95 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const calibreWebDefinition: ServiceDefinition = {
+	id: "calibre-web",
+	name: "Calibre-Web",
+	description:
+		"Web-based ebook management interface for browsing, reading, and downloading books from a Calibre library.",
+	category: "media",
+	icon: "📖",
+
+	image: "lscr.io/linuxserver/calibre-web",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8083,
+			container: 8083,
+			description: "Calibre-Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "calibreweb-config",
+			containerPath: "/config",
+			description: "Calibre-Web configuration",
+		},
+		{
+			name: "calibreweb-books",
+			containerPath: "/books",
+			description: "Book library",
+		},
+	],
+	environment: [
+		{
+			key: "PUID",
+			defaultValue: "1000",
+			secret: false,
+			description: "User ID",
+			required: false,
+		},
+		{
+			key: "PGID",
+			defaultValue: "1000",
+			secret: false,
+			description: "Group ID",
+			required: false,
+		},
+		{
+			key: "TZ",
+			defaultValue: "UTC",
+			secret: false,
+			description: "Timezone",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8083 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "CALIBREWEB_HOST",
+			defaultValue: "calibre-web",
+			secret: false,
+			description: "Calibre-Web hostname",
+			required: false,
+		},
+		{
+			key: "CALIBREWEB_PORT",
+			defaultValue: "8083",
+			secret: false,
+			description: "Calibre-Web port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://github.com/janeczku/calibre-web/wiki",
+	tags: ["ebooks", "reading", "library", "calibre", "kindle"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};