@better-openclaw/core 1.0.5 → 1.0.7

package/dist/generators/caddy.d.mts

@@ -0,0 +1,17 @@
+import { ResolverOutput } from "../types.mjs";
+
+//#region src/generators/caddy.d.ts
+/**
+ * Generates a Caddyfile with reverse proxy entries for each exposed service.
+ *
+ * Each service with exposed ports gets a subdomain route under the provided domain.
+ * Services without exposed ports are skipped.
+ *
+ * @param resolved - The resolved service configuration
+ * @param domain - The main domain for routing (e.g. "example.com")
+ * @returns The Caddyfile content as a string
+ */
+declare function generateCaddyfile(resolved: ResolverOutput, domain: string): string;
+//#endregion
+export { generateCaddyfile };
+//# sourceMappingURL=caddy.d.mts.map

package/dist/generators/caddy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caddy.d.mts","names":[],"sources":["../../src/generators/caddy.ts"],"mappings":";;;;;AAYA;;;;;;;;iBAAgB,iBAAA,CAAkB,QAAA,EAAU,cAAA,EAAgB,MAAA"}

package/dist/generators/caddy.mjs

@@ -0,0 +1,77 @@
+//#region src/generators/caddy.ts
+/**
+* Generates a Caddyfile with reverse proxy entries for each exposed service.
+*
+* Each service with exposed ports gets a subdomain route under the provided domain.
+* Services without exposed ports are skipped.
+*
+* @param resolved - The resolved service configuration
+* @param domain - The main domain for routing (e.g. "example.com")
+* @returns The Caddyfile content as a string
+*/
+function generateCaddyfile(resolved, domain) {
+	const sections = [];
+	sections.push(`# ═══════════════════════════════════════════════════════════════════════════════
+# OpenClaw Caddyfile — Auto-generated reverse proxy configuration
+# Domain: ${domain}
+# ═══════════════════════════════════════════════════════════════════════════════
+
+{
+	# Global options
+	email admin@${domain}
+	acme_ca https://acme-v02.api.letsencrypt.org/directory
+}
+`);
+	for (const { definition } of resolved.services) {
+		if (definition.id === "caddy" || definition.id === "traefik") continue;
+		const exposedPorts = definition.ports.filter((p) => p.exposed);
+		if (exposedPorts.length === 0) continue;
+		const primaryPort = exposedPorts[0];
+		const subdomain = `${definition.id}.${domain}`;
+		const block = [
+			`# ${definition.icon} ${definition.name}`,
+			`# ${definition.description}`,
+			`${subdomain} {`,
+			`	reverse_proxy ${definition.id}:${primaryPort.container} {`,
+			`		header_up Host {host}`,
+			`		header_up X-Real-IP {remote_host}`,
+			`		header_up X-Forwarded-For {remote_host}`,
+			`		header_up X-Forwarded-Proto {scheme}`,
+			`	}`
+		];
+		if (definition.healthcheck) {
+			block.push("");
+			block.push(`	# Health check`);
+			block.push(`	handle /health {`);
+			block.push(`		reverse_proxy ${definition.id}:${primaryPort.container}`);
+			block.push(`	}`);
+		}
+		block.push(`}`);
+		block.push("");
+		for (let i = 1; i < exposedPorts.length; i++) {
+			const port = exposedPorts[i];
+			const portSubdomain = `${definition.id}-${port.description.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+$/, "")}.${domain}`;
+			block.push(`# ${definition.name} — ${port.description}`);
+			block.push(`${portSubdomain} {`);
+			block.push(`	reverse_proxy ${definition.id}:${port.container}`);
+			block.push(`}`);
+			block.push("");
+		}
+		sections.push(block.join("\n"));
+	}
+	sections.push(`# Root domain — serves the OpenClaw gateway
+${domain} {
+	reverse_proxy openclaw:18789 {
+		header_up Host {host}
+		header_up X-Real-IP {remote_host}
+		header_up X-Forwarded-For {remote_host}
+		header_up X-Forwarded-Proto {scheme}
+	}
+}
+`);
+	return sections.join("\n");
+}
+
+//#endregion
+export { generateCaddyfile };
+//# sourceMappingURL=caddy.mjs.map

package/dist/generators/caddy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caddy.mjs","names":[],"sources":["../../src/generators/caddy.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\n\n/**\n * Generates a Caddyfile with reverse proxy entries for each exposed service.\n *\n * Each service with exposed ports gets a subdomain route under the provided domain.\n * Services without exposed ports are skipped.\n *\n * @param resolved - The resolved service configuration\n * @param domain - The main domain for routing (e.g. \"example.com\")\n * @returns The Caddyfile content as a string\n */\nexport function generateCaddyfile(resolved: ResolverOutput, domain: string): string {\n\tconst sections: string[] = [];\n\n\t// ── Global Options ──────────────────────────────────────────────────────\n\n\tsections.push(`# ═══════════════════════════════════════════════════════════════════════════════\n# OpenClaw Caddyfile — Auto-generated reverse proxy configuration\n# Domain: ${domain}\n# ═══════════════════════════════════════════════════════════════════════════════\n\n{\n\t# Global options\n\temail admin@${domain}\n\tacme_ca https://acme-v02.api.letsencrypt.org/directory\n}\n`);\n\n\t// ── Per-Service Reverse Proxy Blocks ─────────────────────────────────────\n\n\tfor (const { definition } of resolved.services) {\n\t\t// Skip the proxy service itself\n\t\tif (definition.id === \"caddy\" || definition.id === \"traefik\") continue;\n\n\t\tconst exposedPorts = definition.ports.filter((p) => p.exposed);\n\t\tif (exposedPorts.length === 0) continue;\n\n\t\t// Use the first exposed port as the primary route target\n\t\tconst primaryPort = exposedPorts[0]!;\n\t\tconst subdomain = `${definition.id}.${domain}`;\n\n\t\tconst block = [\n\t\t\t`# ${definition.icon} ${definition.name}`,\n\t\t\t`# ${definition.description}`,\n\t\t\t`${subdomain} {`,\n\t\t\t`\treverse_proxy ${definition.id}:${primaryPort.container} {`,\n\t\t\t`\t\theader_up Host {host}`,\n\t\t\t`\t\theader_up X-Real-IP {remote_host}`,\n\t\t\t`\t\theader_up X-Forwarded-For {remote_host}`,\n\t\t\t`\t\theader_up X-Forwarded-Proto {scheme}`,\n\t\t\t`\t}`,\n\t\t];\n\n\t\t// Add health check if service has one\n\t\tif (definition.healthcheck) {\n\t\t\tblock.push(\"\");\n\t\t\tblock.push(`\t# Health check`);\n\t\t\tblock.push(`\thandle /health {`);\n\t\t\tblock.push(`\t\treverse_proxy ${definition.id}:${primaryPort.container}`);\n\t\t\tblock.push(`\t}`);\n\t\t}\n\n\t\tblock.push(`}`);\n\t\tblock.push(\"\");\n\n\t\t// If there are additional exposed ports, add them as separate entries\n\t\tfor (let i = 1; i < exposedPorts.length; i++) {\n\t\t\tconst port = exposedPorts[i]!;\n\t\t\tconst portSubdomain = `${definition.id}-${port.description\n\t\t\t\t.toLowerCase()\n\t\t\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t\t\t.replace(/-+$/, \"\")}.${domain}`;\n\n\t\t\tblock.push(`# ${definition.name} — ${port.description}`);\n\t\t\tblock.push(`${portSubdomain} {`);\n\t\t\tblock.push(`\treverse_proxy ${definition.id}:${port.container}`);\n\t\t\tblock.push(`}`);\n\t\t\tblock.push(\"\");\n\t\t}\n\n\t\tsections.push(block.join(\"\\n\"));\n\t}\n\n\t// ── Fallback / Root Domain ──────────────────────────────────────────────\n\n\tsections.push(`# Root domain — serves the OpenClaw gateway\n${domain} {\n\treverse_proxy openclaw:18789 {\n\t\theader_up Host {host}\n\t\theader_up X-Real-IP {remote_host}\n\t\theader_up X-Forwarded-For {remote_host}\n\t\theader_up X-Forwarded-Proto {scheme}\n\t}\n}\n`);\n\n\treturn sections.join(\"\\n\");\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,kBAAkB,UAA0B,QAAwB;CACnF,MAAM,WAAqB,EAAE;AAI7B,UAAS,KAAK;;YAEH,OAAO;;;;;eAKJ,OAAO;;;EAGpB;AAID,MAAK,MAAM,EAAE,gBAAgB,SAAS,UAAU;AAE/C,MAAI,WAAW,OAAO,WAAW,WAAW,OAAO,UAAW;EAE9D,MAAM,eAAe,WAAW,MAAM,QAAQ,MAAM,EAAE,QAAQ;AAC9D,MAAI,aAAa,WAAW,EAAG;EAG/B,MAAM,cAAc,aAAa;EACjC,MAAM,YAAY,GAAG,WAAW,GAAG,GAAG;EAEtC,MAAM,QAAQ;GACb,KAAK,WAAW,KAAK,GAAG,WAAW;GACnC,KAAK,WAAW;GAChB,GAAG,UAAU;GACb,kBAAkB,WAAW,GAAG,GAAG,YAAY,UAAU;GACzD;GACA;GACA;GACA;GACA;GACA;AAGD,MAAI,WAAW,aAAa;AAC3B,SAAM,KAAK,GAAG;AACd,SAAM,KAAK,kBAAkB;AAC7B,SAAM,KAAK,oBAAoB;AAC/B,SAAM,KAAK,mBAAmB,WAAW,GAAG,GAAG,YAAY,YAAY;AACvE,SAAM,KAAK,KAAK;;AAGjB,QAAM,KAAK,IAAI;AACf,QAAM,KAAK,GAAG;AAGd,OAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;GAC7C,MAAM,OAAO,aAAa;GAC1B,MAAM,gBAAgB,GAAG,WAAW,GAAG,GAAG,KAAK,YAC7C,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,OAAO,GAAG,CAAC,GAAG;AAExB,SAAM,KAAK,KAAK,WAAW,KAAK,KAAK,KAAK,cAAc;AACxD,SAAM,KAAK,GAAG,cAAc,IAAI;AAChC,SAAM,KAAK,kBAAkB,WAAW,GAAG,GAAG,KAAK,YAAY;AAC/D,SAAM,KAAK,IAAI;AACf,SAAM,KAAK,GAAG;;AAGf,WAAS,KAAK,MAAM,KAAK,KAAK,CAAC;;AAKhC,UAAS,KAAK;EACb,OAAO;;;;;;;;EAQP;AAED,QAAO,SAAS,KAAK,KAAK"}

package/dist/generators/env.d.mts

@@ -0,0 +1,46 @@
+import { ResolverOutput } from "../types.mjs";
+
+//#region src/generators/env.d.ts
+/**
+ * Options for environment file generation.
+ */
+interface EnvGeneratorOptions {
+  generateSecrets: boolean;
+  domain?: string;
+  openclawVersion?: string;
+  /** When set, host-like vars (e.g. REDIS_HOST) for these services use host.docker.internal so gateway in Docker can reach native services on host. */
+  nativeServiceIds?: Set<string>;
+}
+/**
+ * Generates `.env.example` and `.env` file contents from resolved services.
+ *
+ * - `.env.example`: every env var with descriptive comments, placeholders for secrets
+ * - `.env`: same vars but secrets filled with cryptographically random values when generateSecrets is true
+ */
+declare function generateEnvFiles(resolved: ResolverOutput, options: EnvGeneratorOptions): {
+  envExample: string;
+  env: string;
+};
+interface EnvVarGroup {
+  serviceName: string;
+  serviceIcon: string;
+  serviceId: string;
+  vars: {
+    key: string;
+    description: string;
+    secret: boolean;
+    required: boolean;
+    defaultValue: string;
+  }[];
+}
+/**
+ * Returns environment variables grouped by service, suitable for UI rendering.
+ *
+ * - First group is always "OpenClaw Core" with base variables.
+ * - Subsequent groups correspond to each resolved service.
+ * - Variables are deduplicated across groups (first occurrence wins).
+ */
+declare function getStructuredEnvVars(resolved: ResolverOutput): EnvVarGroup[];
+//#endregion
+export { EnvGeneratorOptions, EnvVarGroup, generateEnvFiles, getStructuredEnvVars };
+//# sourceMappingURL=env.d.mts.map

package/dist/generators/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/generators/env.ts"],"mappings":";;;;;AAOA;UAAiB,mBAAA;EAChB,eAAA;EACA,MAAA;EACA,eAAA;EADA;EAGA,gBAAA,GAAmB,GAAA;AAAA;;;;AASpB;;;iBAAgB,gBAAA,CACf,QAAA,EAAU,cAAA,EACV,OAAA,EAAS,mBAAA;EACL,UAAA;EAAoB,GAAA;AAAA;AAAA,UAkSR,WAAA;EAChB,WAAA;EACA,WAAA;EACA,SAAA;EACA,IAAA;IACC,GAAA;IACA,WAAA;IACA,MAAA;IACA,QAAA;IACA,YAAA;EAAA;AAAA;;;;;;;;iBAWc,oBAAA,CAAqB,QAAA,EAAU,cAAA,GAAiB,WAAA"}

package/dist/generators/env.mjs

@@ -0,0 +1,250 @@
+import { getDbRequirements } from "./postgres-init.mjs";
+import { randomBytes } from "node:crypto";
+
+//#region src/generators/env.ts
+/**
+* Generates `.env.example` and `.env` file contents from resolved services.
+*
+* - `.env.example`: every env var with descriptive comments, placeholders for secrets
+* - `.env`: same vars but secrets filled with cryptographically random values when generateSecrets is true
+*/
+function generateEnvFiles(resolved, options) {
+	const version = options.openclawVersion ?? "latest";
+	const lines = [];
+	lines.push({
+		comment: formatComment("OpenClaw version to deploy", "OpenClaw Core", true, false),
+		key: "OPENCLAW_VERSION",
+		exampleValue: version,
+		actualValue: version
+	});
+	const gatewayToken = options.generateSecrets ? randomBytes(24).toString("hex") : "";
+	lines.push({
+		comment: formatComment("Authentication token for the OpenClaw gateway API", "OpenClaw Core", true, true),
+		key: "OPENCLAW_GATEWAY_TOKEN",
+		exampleValue: "your_gateway_token_here",
+		actualValue: gatewayToken
+	});
+	lines.push({
+		comment: formatComment("Port the OpenClaw gateway listens on", "OpenClaw Core", true, false),
+		key: "OPENCLAW_GATEWAY_PORT",
+		exampleValue: "18789",
+		actualValue: "18789"
+	});
+	lines.push({
+		comment: formatComment("Port for the OpenClaw ACP bridge (WebSocket)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_BRIDGE_PORT",
+		exampleValue: "18790",
+		actualValue: "18790"
+	});
+	lines.push({
+		comment: formatComment("Gateway network bind mode (lan for Docker networking, loopback for local-only)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_GATEWAY_BIND",
+		exampleValue: "lan",
+		actualValue: "lan"
+	});
+	lines.push({
+		comment: formatComment("Host path to OpenClaw configuration directory", "OpenClaw Core", true, false),
+		key: "OPENCLAW_CONFIG_DIR",
+		exampleValue: "./openclaw/config",
+		actualValue: "./openclaw/config"
+	});
+	lines.push({
+		comment: formatComment("Host path to OpenClaw workspace directory", "OpenClaw Core", true, false),
+		key: "OPENCLAW_WORKSPACE_DIR",
+		exampleValue: "./openclaw/workspace",
+		actualValue: "./openclaw/workspace"
+	});
+	lines.push({
+		comment: formatComment("OpenClaw Docker image override (default uses ghcr.io/openclaw/openclaw)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_IMAGE",
+		exampleValue: "",
+		actualValue: ""
+	});
+	if (options.domain) lines.push({
+		comment: formatComment("Primary domain for service routing", "OpenClaw Core", false, false),
+		key: "OPENCLAW_DOMAIN",
+		exampleValue: "example.com",
+		actualValue: options.domain
+	});
+	lines.push({
+		comment: "\n# ═══════════════════════════════════════════════════════════════════════════════\n# Claude Web Provider (optional)\n# ═══════════════════════════════════════════════════════════════════════════════",
+		key: "",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Claude AI session key for web provider authentication", "OpenClaw Core", false, true),
+		key: "CLAUDE_AI_SESSION_KEY",
+		exampleValue: "your_claude_ai_session_key_here",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Claude web session key for web provider authentication", "OpenClaw Core", false, true),
+		key: "CLAUDE_WEB_SESSION_KEY",
+		exampleValue: "your_claude_web_session_key_here",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Claude web cookie for web provider authentication", "OpenClaw Core", false, true),
+		key: "CLAUDE_WEB_COOKIE",
+		exampleValue: "your_claude_web_cookie_here",
+		actualValue: ""
+	});
+	const dbReqs = getDbRequirements(resolved);
+	if (dbReqs.length > 0) {
+		lines.push({
+			comment: "\n# ═══════════════════════════════════════════════════════════════════════════════\n# Per-Service Database Passwords\n# Each service gets its own PostgreSQL database and credentials\n# ═══════════════════════════════════════════════════════════════════════════════",
+			key: "",
+			exampleValue: "",
+			actualValue: ""
+		});
+		for (const req of dbReqs) {
+			const secretValue = options.generateSecrets ? randomBytes(24).toString("hex") : "";
+			lines.push({
+				comment: formatComment(`PostgreSQL password for ${req.serviceName} (database: ${req.dbName}, user: ${req.dbUser})`, req.serviceName, true, true),
+				key: req.passwordEnvVar,
+				exampleValue: `your_${req.passwordEnvVar.toLowerCase()}_here`,
+				actualValue: secretValue
+			});
+		}
+	}
+	const dbPasswordKeys = dbReqs.map((r) => r.passwordEnvVar);
+	const seenKeys = new Set([
+		"OPENCLAW_VERSION",
+		"OPENCLAW_GATEWAY_TOKEN",
+		"OPENCLAW_GATEWAY_PORT",
+		"OPENCLAW_BRIDGE_PORT",
+		"OPENCLAW_GATEWAY_BIND",
+		"OPENCLAW_CONFIG_DIR",
+		"OPENCLAW_WORKSPACE_DIR",
+		"OPENCLAW_IMAGE",
+		"OPENCLAW_DOMAIN",
+		"CLAUDE_AI_SESSION_KEY",
+		"CLAUDE_WEB_SESSION_KEY",
+		"CLAUDE_WEB_COOKIE",
+		...dbPasswordKeys
+	]);
+	for (const { definition } of resolved.services) {
+		const allEnvVars = [...definition.environment, ...definition.openclawEnvVars];
+		if (allEnvVars.length === 0) continue;
+		lines.push({
+			comment: `\n# ═══════════════════════════════════════════════════════════════════════════════\n# ${definition.icon} ${definition.name}\n# ═══════════════════════════════════════════════════════════════════════════════`,
+			key: "",
+			exampleValue: "",
+			actualValue: ""
+		});
+		const isNative = options.nativeServiceIds?.has(definition.id);
+		for (const envVar of allEnvVars) {
+			if (seenKeys.has(envVar.key)) continue;
+			seenKeys.add(envVar.key);
+			const secretValue = options.generateSecrets ? randomBytes(24).toString("hex") : "";
+			const isHostVar = envVar.key.endsWith("_HOST");
+			const hostValue = isNative && isHostVar ? "host.docker.internal" : null;
+			const exampleValue = hostValue ? hostValue : envVar.secret ? `your_${envVar.key.toLowerCase()}_here` : envVar.defaultValue;
+			let actualValue;
+			if (hostValue) actualValue = hostValue;
+			else if (envVar.secret) actualValue = envVar.defaultValue.startsWith("${") ? envVar.defaultValue : secretValue;
+			else actualValue = envVar.defaultValue;
+			lines.push({
+				comment: formatComment(envVar.description, definition.name, envVar.required, envVar.secret),
+				key: envVar.key,
+				exampleValue,
+				actualValue
+			});
+		}
+	}
+	const header = [
+		"# ═══════════════════════════════════════════════════════════════════════════════",
+		"# OpenClaw Environment Configuration",
+		`# Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
+		"# ═══════════════════════════════════════════════════════════════════════════════",
+		""
+	].join("\n");
+	let envExample = header;
+	let env = header;
+	for (const line of lines) if (line.key === "") {
+		envExample += `${line.comment}\n`;
+		env += `${line.comment}\n`;
+	} else {
+		envExample += `${line.comment}\n${line.key}=${line.exampleValue}\n\n`;
+		env += `${line.comment}\n${line.key}=${line.actualValue}\n\n`;
+	}
+	return {
+		envExample,
+		env
+	};
+}
+/**
+* Format a descriptive comment block for an environment variable.
+*/
+function formatComment(description, serviceName, required, secret) {
+	return [`# ${description}`, `# Service: ${serviceName} | Required: ${required ? "Yes" : "No"} | Secret: ${secret ? "Yes" : "No"}`].join("\n");
+}
+/**
+* Returns environment variables grouped by service, suitable for UI rendering.
+*
+* - First group is always "OpenClaw Core" with base variables.
+* - Subsequent groups correspond to each resolved service.
+* - Variables are deduplicated across groups (first occurrence wins).
+*/
+function getStructuredEnvVars(resolved) {
+	const groups = [];
+	const seenKeys = /* @__PURE__ */ new Set();
+	const coreVars = [
+		{
+			key: "OPENCLAW_VERSION",
+			description: "OpenClaw version to deploy",
+			secret: false,
+			required: true,
+			defaultValue: "latest"
+		},
+		{
+			key: "OPENCLAW_GATEWAY_TOKEN",
+			description: "Authentication token for the OpenClaw gateway API",
+			secret: true,
+			required: true,
+			defaultValue: ""
+		},
+		{
+			key: "OPENCLAW_GATEWAY_PORT",
+			description: "Port the OpenClaw gateway listens on",
+			secret: false,
+			required: true,
+			defaultValue: "18789"
+		}
+	];
+	for (const v of coreVars) seenKeys.add(v.key);
+	groups.push({
+		serviceName: "OpenClaw Core",
+		serviceIcon: "⚙️",
+		serviceId: "openclaw-core",
+		vars: coreVars
+	});
+	for (const { definition } of resolved.services) {
+		const allEnvVars = [...definition.environment, ...definition.openclawEnvVars];
+		const vars = [];
+		for (const envVar of allEnvVars) {
+			if (seenKeys.has(envVar.key)) continue;
+			seenKeys.add(envVar.key);
+			vars.push({
+				key: envVar.key,
+				description: envVar.description,
+				secret: envVar.secret,
+				required: envVar.required,
+				defaultValue: envVar.defaultValue
+			});
+		}
+		if (vars.length === 0) continue;
+		groups.push({
+			serviceName: definition.name,
+			serviceIcon: definition.icon,
+			serviceId: definition.id,
+			vars
+		});
+	}
+	return groups;
+}
+
+//#endregion
+export { generateEnvFiles, getStructuredEnvVars };
+//# sourceMappingURL=env.mjs.map

package/dist/generators/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/generators/env.ts"],"sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport type { ResolverOutput } from \"../types.js\";\nimport { getDbRequirements } from \"./postgres-init.js\";\n\n/**\n * Options for environment file generation.\n */\nexport interface EnvGeneratorOptions {\n\tgenerateSecrets: boolean;\n\tdomain?: string;\n\topenclawVersion?: string;\n\t/** When set, host-like vars (e.g. REDIS_HOST) for these services use host.docker.internal so gateway in Docker can reach native services on host. */\n\tnativeServiceIds?: Set<string>;\n}\n\n/**\n * Generates `.env.example` and `.env` file contents from resolved services.\n *\n * - `.env.example`: every env var with descriptive comments, placeholders for secrets\n * - `.env`: same vars but secrets filled with cryptographically random values when generateSecrets is true\n */\nexport function generateEnvFiles(\n\tresolved: ResolverOutput,\n\toptions: EnvGeneratorOptions,\n): { envExample: string; env: string } {\n\tconst version = options.openclawVersion ?? \"latest\";\n\tconst lines: { comment: string; key: string; exampleValue: string; actualValue: string }[] = [];\n\n\t// ── Base OpenClaw Variables ──────────────────────────────────────────────\n\n\tlines.push({\n\t\tcomment: formatComment(\"OpenClaw version to deploy\", \"OpenClaw Core\", true, false),\n\t\tkey: \"OPENCLAW_VERSION\",\n\t\texampleValue: version,\n\t\tactualValue: version,\n\t});\n\n\tconst gatewayToken = options.generateSecrets ? randomBytes(24).toString(\"hex\") : \"\";\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Authentication token for the OpenClaw gateway API\",\n\t\t\t\"OpenClaw Core\",\n\t\t\ttrue,\n\t\t\ttrue,\n\t\t),\n\t\tkey: \"OPENCLAW_GATEWAY_TOKEN\",\n\t\texampleValue: \"your_gateway_token_here\",\n\t\tactualValue: gatewayToken,\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\"Port the OpenClaw gateway listens on\", \"OpenClaw Core\", true, false),\n\t\tkey: \"OPENCLAW_GATEWAY_PORT\",\n\t\texampleValue: \"18789\",\n\t\tactualValue: \"18789\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Port for the OpenClaw ACP bridge (WebSocket)\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\tfalse,\n\t\t),\n\t\tkey: \"OPENCLAW_BRIDGE_PORT\",\n\t\texampleValue: \"18790\",\n\t\tactualValue: \"18790\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Gateway network bind mode (lan for Docker networking, loopback for local-only)\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\tfalse,\n\t\t),\n\t\tkey: \"OPENCLAW_GATEWAY_BIND\",\n\t\texampleValue: \"lan\",\n\t\tactualValue: \"lan\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Host path to OpenClaw configuration directory\",\n\t\t\t\"OpenClaw Core\",\n\t\t\ttrue,\n\t\t\tfalse,\n\t\t),\n\t\tkey: \"OPENCLAW_CONFIG_DIR\",\n\t\texampleValue: \"./openclaw/config\",\n\t\tactualValue: \"./openclaw/config\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Host path to OpenClaw workspace directory\",\n\t\t\t\"OpenClaw Core\",\n\t\t\ttrue,\n\t\t\tfalse,\n\t\t),\n\t\tkey: \"OPENCLAW_WORKSPACE_DIR\",\n\t\texampleValue: \"./openclaw/workspace\",\n\t\tactualValue: \"./openclaw/workspace\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"OpenClaw Docker image override (default uses ghcr.io/openclaw/openclaw)\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\tfalse,\n\t\t),\n\t\tkey: \"OPENCLAW_IMAGE\",\n\t\texampleValue: \"\",\n\t\tactualValue: \"\",\n\t});\n\n\tif (options.domain) {\n\t\tlines.push({\n\t\t\tcomment: formatComment(\"Primary domain for service routing\", \"OpenClaw Core\", false, false),\n\t\t\tkey: \"OPENCLAW_DOMAIN\",\n\t\t\texampleValue: \"example.com\",\n\t\t\tactualValue: options.domain,\n\t\t});\n\t}\n\n\t// Claude web-provider session variables (optional)\n\tlines.push({\n\t\tcomment:\n\t\t\t\"\\n# ═══════════════════════════════════════════════════════════════════════════════\\n# Claude Web Provider (optional)\\n# ═══════════════════════════════════════════════════════════════════════════════\",\n\t\tkey: \"\",\n\t\texampleValue: \"\",\n\t\tactualValue: \"\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Claude AI session key for web provider authentication\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\ttrue,\n\t\t),\n\t\tkey: \"CLAUDE_AI_SESSION_KEY\",\n\t\texampleValue: \"your_claude_ai_session_key_here\",\n\t\tactualValue: \"\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Claude web session key for web provider authentication\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\ttrue,\n\t\t),\n\t\tkey: \"CLAUDE_WEB_SESSION_KEY\",\n\t\texampleValue: \"your_claude_web_session_key_here\",\n\t\tactualValue: \"\",\n\t});\n\n\tlines.push({\n\t\tcomment: formatComment(\n\t\t\t\"Claude web cookie for web provider authentication\",\n\t\t\t\"OpenClaw Core\",\n\t\t\tfalse,\n\t\t\ttrue,\n\t\t),\n\t\tkey: \"CLAUDE_WEB_COOKIE\",\n\t\texampleValue: \"your_claude_web_cookie_here\",\n\t\tactualValue: \"\",\n\t});\n\n\t// ── Per-Service Database Passwords ──────────────────────────────────────\n\n\tconst dbReqs = getDbRequirements(resolved);\n\n\tif (dbReqs.length > 0) {\n\t\tlines.push({\n\t\t\tcomment:\n\t\t\t\t\"\\n# ═══════════════════════════════════════════════════════════════════════════════\\n# Per-Service Database Passwords\\n# Each service gets its own PostgreSQL database and credentials\\n# ═══════════════════════════════════════════════════════════════════════════════\",\n\t\t\tkey: \"\",\n\t\t\texampleValue: \"\",\n\t\t\tactualValue: \"\",\n\t\t});\n\n\t\tfor (const req of dbReqs) {\n\t\t\tconst secretValue = options.generateSecrets ? randomBytes(24).toString(\"hex\") : \"\";\n\n\t\t\tlines.push({\n\t\t\t\tcomment: formatComment(\n\t\t\t\t\t`PostgreSQL password for ${req.serviceName} (database: ${req.dbName}, user: ${req.dbUser})`,\n\t\t\t\t\treq.serviceName,\n\t\t\t\t\ttrue,\n\t\t\t\t\ttrue,\n\t\t\t\t),\n\t\t\t\tkey: req.passwordEnvVar,\n\t\t\t\texampleValue: `your_${req.passwordEnvVar.toLowerCase()}_here`,\n\t\t\t\tactualValue: secretValue,\n\t\t\t});\n\t\t}\n\t}\n\n\t// ── Service-Specific Variables ───────────────────────────────────────────\n\n\tconst dbPasswordKeys = dbReqs.map((r) => r.passwordEnvVar);\n\tconst seenKeys = new Set<string>([\n\t\t\"OPENCLAW_VERSION\",\n\t\t\"OPENCLAW_GATEWAY_TOKEN\",\n\t\t\"OPENCLAW_GATEWAY_PORT\",\n\t\t\"OPENCLAW_BRIDGE_PORT\",\n\t\t\"OPENCLAW_GATEWAY_BIND\",\n\t\t\"OPENCLAW_CONFIG_DIR\",\n\t\t\"OPENCLAW_WORKSPACE_DIR\",\n\t\t\"OPENCLAW_IMAGE\",\n\t\t\"OPENCLAW_DOMAIN\",\n\t\t\"CLAUDE_AI_SESSION_KEY\",\n\t\t\"CLAUDE_WEB_SESSION_KEY\",\n\t\t\"CLAUDE_WEB_COOKIE\",\n\t\t...dbPasswordKeys,\n\t]);\n\n\tfor (const { definition } of resolved.services) {\n\t\tconst allEnvVars = [...definition.environment, ...definition.openclawEnvVars];\n\n\t\tif (allEnvVars.length === 0) continue;\n\n\t\t// Section separator for this service\n\t\tlines.push({\n\t\t\tcomment: `\\n# ═══════════════════════════════════════════════════════════════════════════════\\n# ${definition.icon} ${definition.name}\\n# ═══════════════════════════════════════════════════════════════════════════════`,\n\t\t\tkey: \"\",\n\t\t\texampleValue: \"\",\n\t\t\tactualValue: \"\",\n\t\t});\n\n\t\tconst isNative = options.nativeServiceIds?.has(definition.id);\n\n\t\tfor (const envVar of allEnvVars) {\n\t\t\tif (seenKeys.has(envVar.key)) continue;\n\t\t\tseenKeys.add(envVar.key);\n\n\t\t\tconst secretValue = options.generateSecrets ? randomBytes(24).toString(\"hex\") : \"\";\n\n\t\t\t// For native services, host-like vars must point to host so gateway (in Docker) can reach them\n\t\t\tconst isHostVar = envVar.key.endsWith(\"_HOST\");\n\t\t\tconst hostValue = isNative && isHostVar ? \"host.docker.internal\" : null;\n\n\t\t\tconst exampleValue = hostValue\n\t\t\t\t? hostValue\n\t\t\t\t: envVar.secret\n\t\t\t\t\t? `your_${envVar.key.toLowerCase()}_here`\n\t\t\t\t\t: envVar.defaultValue;\n\n\t\t\tlet actualValue: string;\n\t\t\tif (hostValue) {\n\t\t\t\tactualValue = hostValue;\n\t\t\t} else if (envVar.secret) {\n\t\t\t\tactualValue = envVar.defaultValue.startsWith(\"${\") ? envVar.defaultValue : secretValue;\n\t\t\t} else {\n\t\t\t\tactualValue = envVar.defaultValue;\n\t\t\t}\n\n\t\t\tlines.push({\n\t\t\t\tcomment: formatComment(envVar.description, definition.name, envVar.required, envVar.secret),\n\t\t\t\tkey: envVar.key,\n\t\t\t\texampleValue,\n\t\t\t\tactualValue,\n\t\t\t});\n\t\t}\n\t}\n\n\t// ── Build output strings ────────────────────────────────────────────────\n\n\tconst header = [\n\t\t\"# ═══════════════════════════════════════════════════════════════════════════════\",\n\t\t\"# OpenClaw Environment Configuration\",\n\t\t`# Generated at ${new Date().toISOString()}`,\n\t\t\"# ═══════════════════════════════════════════════════════════════════════════════\",\n\t\t\"\",\n\t].join(\"\\n\");\n\n\tlet envExample = header;\n\tlet env = header;\n\n\tfor (const line of lines) {\n\t\tif (line.key === \"\") {\n\t\t\t// Section comment\n\t\t\tenvExample += `${line.comment}\\n`;\n\t\t\tenv += `${line.comment}\\n`;\n\t\t} else {\n\t\t\tenvExample += `${line.comment}\\n${line.key}=${line.exampleValue}\\n\\n`;\n\t\t\tenv += `${line.comment}\\n${line.key}=${line.actualValue}\\n\\n`;\n\t\t}\n\t}\n\n\treturn { envExample, env };\n}\n\n/**\n * Format a descriptive comment block for an environment variable.\n */\nfunction formatComment(\n\tdescription: string,\n\tserviceName: string,\n\trequired: boolean,\n\tsecret: boolean,\n): string {\n\treturn [\n\t\t`# ${description}`,\n\t\t`# Service: ${serviceName} | Required: ${required ? \"Yes\" : \"No\"} | Secret: ${secret ? \"Yes\" : \"No\"}`,\n\t].join(\"\\n\");\n}\n\n// ── Structured Env Vars ─────────────────────────────────────────────────────\n\nexport interface EnvVarGroup {\n\tserviceName: string;\n\tserviceIcon: string;\n\tserviceId: string;\n\tvars: {\n\t\tkey: string;\n\t\tdescription: string;\n\t\tsecret: boolean;\n\t\trequired: boolean;\n\t\tdefaultValue: string;\n\t}[];\n}\n\n/**\n * Returns environment variables grouped by service, suitable for UI rendering.\n *\n * - First group is always \"OpenClaw Core\" with base variables.\n * - Subsequent groups correspond to each resolved service.\n * - Variables are deduplicated across groups (first occurrence wins).\n */\nexport function getStructuredEnvVars(resolved: ResolverOutput): EnvVarGroup[] {\n\tconst groups: EnvVarGroup[] = [];\n\tconst seenKeys = new Set<string>();\n\n\t// ── OpenClaw Core group ──────────────────────────────────────────────────\n\tconst coreVars: EnvVarGroup[\"vars\"] = [\n\t\t{\n\t\t\tkey: \"OPENCLAW_VERSION\",\n\t\t\tdescription: \"OpenClaw version to deploy\",\n\t\t\tsecret: false,\n\t\t\trequired: true,\n\t\t\tdefaultValue: \"latest\",\n\t\t},\n\t\t{\n\t\t\tkey: \"OPENCLAW_GATEWAY_TOKEN\",\n\t\t\tdescription: \"Authentication token for the OpenClaw gateway API\",\n\t\t\tsecret: true,\n\t\t\trequired: true,\n\t\t\tdefaultValue: \"\",\n\t\t},\n\t\t{\n\t\t\tkey: \"OPENCLAW_GATEWAY_PORT\",\n\t\t\tdescription: \"Port the OpenClaw gateway listens on\",\n\t\t\tsecret: false,\n\t\t\trequired: true,\n\t\t\tdefaultValue: \"18789\",\n\t\t},\n\t];\n\n\tfor (const v of coreVars) {\n\t\tseenKeys.add(v.key);\n\t}\n\n\tgroups.push({\n\t\tserviceName: \"OpenClaw Core\",\n\t\tserviceIcon: \"⚙️\",\n\t\tserviceId: \"openclaw-core\",\n\t\tvars: coreVars,\n\t});\n\n\t// ── Per-service groups ───────────────────────────────────────────────────\n\tfor (const { definition } of resolved.services) {\n\t\tconst allEnvVars = [...definition.environment, ...definition.openclawEnvVars];\n\n\t\tconst vars: EnvVarGroup[\"vars\"] = [];\n\n\t\tfor (const envVar of allEnvVars) {\n\t\t\tif (seenKeys.has(envVar.key)) continue;\n\t\t\tseenKeys.add(envVar.key);\n\n\t\t\tvars.push({\n\t\t\t\tkey: envVar.key,\n\t\t\t\tdescription: envVar.description,\n\t\t\t\tsecret: envVar.secret,\n\t\t\t\trequired: envVar.required,\n\t\t\t\tdefaultValue: envVar.defaultValue,\n\t\t\t});\n\t\t}\n\n\t\tif (vars.length === 0) continue;\n\n\t\tgroups.push({\n\t\t\tserviceName: definition.name,\n\t\t\tserviceIcon: definition.icon,\n\t\t\tserviceId: definition.id,\n\t\t\tvars,\n\t\t});\n\t}\n\n\treturn groups;\n}\n"],"mappings":"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"}

package/dist/generators/grafana.d.mts

@@ -0,0 +1,22 @@
+//#region src/generators/grafana.d.ts
+/**
+ * Generates Grafana provisioning configuration files.
+ *
+ * Returns a map of file paths (relative to project root) to file contents.
+ * Includes datasource provisioning YAML for the Prometheus connection.
+ */
+declare function generateGrafanaConfig(): Record<string, string>;
+/**
+ * Generates a Grafana dashboard JSON for the OpenClaw stack overview.
+ *
+ * The dashboard includes:
+ * - Service Health (stat panel)
+ * - Memory Usage (gauge)
+ * - Request Rate (graph)
+ *
+ * Uses Prometheus as the datasource.
+ */
+declare function generateGrafanaDashboard(): string;
+//#endregion
+export { generateGrafanaConfig, generateGrafanaDashboard };
+//# sourceMappingURL=grafana.d.mts.map

package/dist/generators/grafana.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafana.d.mts","names":[],"sources":["../../src/generators/grafana.ts"],"mappings":";;AAMA;;;;;iBAAgB,qBAAA,CAAA,GAAyB,MAAA;;;;;;;;;;;iBAiGzB,wBAAA,CAAA"}