@better-openclaw/core 1.0.5 → 1.0.7

package/dist/generators/grafana.mjs

@@ -0,0 +1,293 @@
+//#region src/generators/grafana.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.
+*/
+function generateGrafanaConfig() {
+	const files = {};
+	files["config/grafana/provisioning/datasources/prometheus.yml"] = `# ═══════════════════════════════════════════════════════════════════════════════
+# Grafana Datasource Provisioning — Auto-generated by OpenClaw
+# ═══════════════════════════════════════════════════════════════════════════════
+
+apiVersion: 1
+
+datasources:
+  # Prometheus — primary metrics datasource
+  - name: Prometheus
+    type: prometheus
+    access: proxy
+    url: http://prometheus:9090
+    isDefault: true
+    editable: true
+    jsonData:
+      httpMethod: POST
+      timeInterval: "15s"
+      exemplarTraceIdDestinations:
+        - name: traceID
+          datasourceUid: ""
+    version: 1
+`;
+	files["config/grafana/provisioning/dashboards/default.yml"] = `# ═══════════════════════════════════════════════════════════════════════════════
+# Grafana Dashboard Provisioning — Auto-generated by OpenClaw
+# ═══════════════════════════════════════════════════════════════════════════════
+
+apiVersion: 1
+
+providers:
+  - name: "OpenClaw Dashboards"
+    orgId: 1
+    folder: "OpenClaw"
+    type: file
+    disableDeletion: false
+    editable: true
+    updateIntervalSeconds: 30
+    allowUiUpdates: true
+    options:
+      path: /var/lib/grafana/dashboards
+      foldersFromFilesStructure: false
+`;
+	files["config/grafana/grafana.ini"] = `# ═══════════════════════════════════════════════════════════════════════════════
+# Grafana Configuration — Auto-generated by OpenClaw
+# ═══════════════════════════════════════════════════════════════════════════════
+
+[server]
+root_url = %(protocol)s://%(domain)s/
+
+[security]
+# Admin credentials are set via environment variables:
+#   GF_SECURITY_ADMIN_USER
+#   GF_SECURITY_ADMIN_PASSWORD
+
+[auth.anonymous]
+enabled = false
+
+[dashboards]
+default_home_dashboard_path = /var/lib/grafana/dashboards/home.json
+
+[alerting]
+enabled = true
+
+[unified_alerting]
+enabled = true
+
+[log]
+mode = console
+level = info
+`;
+	return files;
+}
+/**
+* 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.
+*/
+function generateGrafanaDashboard() {
+	return JSON.stringify({
+		annotations: { list: [] },
+		editable: true,
+		fiscalYearStartMonth: 0,
+		graphTooltip: 1,
+		links: [],
+		panels: [
+			{
+				id: 1,
+				title: "Service Health",
+				type: "stat",
+				gridPos: {
+					h: 8,
+					w: 8,
+					x: 0,
+					y: 0
+				},
+				datasource: {
+					type: "prometheus",
+					uid: "prometheus"
+				},
+				targets: [{
+					expr: "count(up{job=~\".+\"} == 1)",
+					legendFormat: "Healthy Services",
+					refId: "A"
+				}],
+				fieldConfig: {
+					defaults: {
+						thresholds: {
+							mode: "absolute",
+							steps: [
+								{
+									color: "red",
+									value: null
+								},
+								{
+									color: "yellow",
+									value: 1
+								},
+								{
+									color: "green",
+									value: 3
+								}
+							]
+						},
+						color: { mode: "thresholds" },
+						mappings: []
+					},
+					overrides: []
+				},
+				options: {
+					reduceOptions: {
+						values: false,
+						calcs: ["lastNotNull"],
+						fields: ""
+					},
+					orientation: "auto",
+					textMode: "auto",
+					colorMode: "background",
+					graphMode: "none",
+					justifyMode: "auto"
+				}
+			},
+			{
+				id: 2,
+				title: "Memory Usage",
+				type: "gauge",
+				gridPos: {
+					h: 8,
+					w: 8,
+					x: 8,
+					y: 0
+				},
+				datasource: {
+					type: "prometheus",
+					uid: "prometheus"
+				},
+				targets: [{
+					expr: "sum(container_memory_usage_bytes) / sum(machine_memory_bytes) * 100",
+					legendFormat: "Memory %",
+					refId: "A"
+				}],
+				fieldConfig: {
+					defaults: {
+						thresholds: {
+							mode: "absolute",
+							steps: [
+								{
+									color: "green",
+									value: null
+								},
+								{
+									color: "yellow",
+									value: 60
+								},
+								{
+									color: "red",
+									value: 85
+								}
+							]
+						},
+						color: { mode: "thresholds" },
+						min: 0,
+						max: 100,
+						unit: "percent",
+						mappings: []
+					},
+					overrides: []
+				},
+				options: {
+					reduceOptions: {
+						values: false,
+						calcs: ["lastNotNull"],
+						fields: ""
+					},
+					orientation: "auto",
+					showThresholdLabels: false,
+					showThresholdMarkers: true
+				}
+			},
+			{
+				id: 3,
+				title: "Request Rate",
+				type: "timeseries",
+				gridPos: {
+					h: 8,
+					w: 8,
+					x: 16,
+					y: 0
+				},
+				datasource: {
+					type: "prometheus",
+					uid: "prometheus"
+				},
+				targets: [{
+					expr: "sum(rate(http_requests_total{job=~\".+\"}[5m])) by (job)",
+					legendFormat: "{{job}}",
+					refId: "A"
+				}],
+				fieldConfig: {
+					defaults: {
+						color: { mode: "palette-classic" },
+						custom: {
+							axisBorderShow: false,
+							axisCenteredZero: false,
+							axisColorMode: "text",
+							axisLabel: "req/s",
+							drawStyle: "line",
+							fillOpacity: 10,
+							gradientMode: "none",
+							lineInterpolation: "smooth",
+							lineWidth: 2,
+							pointSize: 5,
+							showPoints: "auto",
+							spanNulls: false,
+							stacking: {
+								group: "A",
+								mode: "none"
+							}
+						},
+						mappings: [],
+						thresholds: {
+							mode: "absolute",
+							steps: [{
+								color: "green",
+								value: null
+							}]
+						},
+						unit: "reqps"
+					},
+					overrides: []
+				},
+				options: {
+					legend: {
+						calcs: [],
+						displayMode: "list",
+						placement: "bottom"
+					},
+					tooltip: {
+						mode: "multi",
+						sort: "desc"
+					}
+				}
+			}
+		],
+		schemaVersion: 39,
+		tags: ["openclaw"],
+		templating: { list: [] },
+		time: {
+			from: "now-1h",
+			to: "now"
+		},
+		timepicker: {},
+		timezone: "browser",
+		title: "OpenClaw Stack Overview",
+		uid: "openclaw-stack-overview"
+	}, null, 2);
+}
+
+//#endregion
+export { generateGrafanaConfig, generateGrafanaDashboard };
+//# sourceMappingURL=grafana.mjs.map

package/dist/generators/grafana.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafana.mjs","names":[],"sources":["../../src/generators/grafana.ts"],"sourcesContent":["/**\n * Generates Grafana provisioning configuration files.\n *\n * Returns a map of file paths (relative to project root) to file contents.\n * Includes datasource provisioning YAML for the Prometheus connection.\n */\nexport function generateGrafanaConfig(): Record<string, string> {\n\tconst files: Record<string, string> = {};\n\n\t// ── Datasource Provisioning ─────────────────────────────────────────────\n\n\tfiles[\"config/grafana/provisioning/datasources/prometheus.yml\"] =\n\t\t`# ═══════════════════════════════════════════════════════════════════════════════\n# Grafana Datasource Provisioning — Auto-generated by OpenClaw\n# ═══════════════════════════════════════════════════════════════════════════════\n\napiVersion: 1\n\ndatasources:\n  # Prometheus — primary metrics datasource\n  - name: Prometheus\n    type: prometheus\n    access: proxy\n    url: http://prometheus:9090\n    isDefault: true\n    editable: true\n    jsonData:\n      httpMethod: POST\n      timeInterval: \"15s\"\n      exemplarTraceIdDestinations:\n        - name: traceID\n          datasourceUid: \"\"\n    version: 1\n`;\n\n\t// ── Dashboard Provisioning ───────────────────────────────────────────────\n\n\tfiles[\"config/grafana/provisioning/dashboards/default.yml\"] =\n\t\t`# ═══════════════════════════════════════════════════════════════════════════════\n# Grafana Dashboard Provisioning — Auto-generated by OpenClaw\n# ═══════════════════════════════════════════════════════════════════════════════\n\napiVersion: 1\n\nproviders:\n  - name: \"OpenClaw Dashboards\"\n    orgId: 1\n    folder: \"OpenClaw\"\n    type: file\n    disableDeletion: false\n    editable: true\n    updateIntervalSeconds: 30\n    allowUiUpdates: true\n    options:\n      path: /var/lib/grafana/dashboards\n      foldersFromFilesStructure: false\n`;\n\n\t// ── Grafana Configuration (grafana.ini overrides) ────────────────────────\n\n\tfiles[\"config/grafana/grafana.ini\"] =\n\t\t`# ═══════════════════════════════════════════════════════════════════════════════\n# Grafana Configuration — Auto-generated by OpenClaw\n# ═══════════════════════════════════════════════════════════════════════════════\n\n[server]\nroot_url = %(protocol)s://%(domain)s/\n\n[security]\n# Admin credentials are set via environment variables:\n#   GF_SECURITY_ADMIN_USER\n#   GF_SECURITY_ADMIN_PASSWORD\n\n[auth.anonymous]\nenabled = false\n\n[dashboards]\ndefault_home_dashboard_path = /var/lib/grafana/dashboards/home.json\n\n[alerting]\nenabled = true\n\n[unified_alerting]\nenabled = true\n\n[log]\nmode = console\nlevel = info\n`;\n\n\treturn files;\n}\n\n/**\n * Generates a Grafana dashboard JSON for the OpenClaw stack overview.\n *\n * The dashboard includes:\n * - Service Health (stat panel)\n * - Memory Usage (gauge)\n * - Request Rate (graph)\n *\n * Uses Prometheus as the datasource.\n */\nexport function generateGrafanaDashboard(): string {\n\tconst dashboard = {\n\t\tannotations: { list: [] },\n\t\teditable: true,\n\t\tfiscalYearStartMonth: 0,\n\t\tgraphTooltip: 1,\n\t\tlinks: [],\n\t\tpanels: [\n\t\t\t{\n\t\t\t\t// ── Service Health (stat panel) ──\n\t\t\t\tid: 1,\n\t\t\t\ttitle: \"Service Health\",\n\t\t\t\ttype: \"stat\",\n\t\t\t\tgridPos: { h: 8, w: 8, x: 0, y: 0 },\n\t\t\t\tdatasource: { type: \"prometheus\", uid: \"prometheus\" },\n\t\t\t\ttargets: [\n\t\t\t\t\t{\n\t\t\t\t\t\texpr: 'count(up{job=~\".+\"} == 1)',\n\t\t\t\t\t\tlegendFormat: \"Healthy Services\",\n\t\t\t\t\t\trefId: \"A\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tfieldConfig: {\n\t\t\t\t\tdefaults: {\n\t\t\t\t\t\tthresholds: {\n\t\t\t\t\t\t\tmode: \"absolute\",\n\t\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t\t{ color: \"red\", value: null },\n\t\t\t\t\t\t\t\t{ color: \"yellow\", value: 1 },\n\t\t\t\t\t\t\t\t{ color: \"green\", value: 3 },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tcolor: { mode: \"thresholds\" },\n\t\t\t\t\t\tmappings: [],\n\t\t\t\t\t},\n\t\t\t\t\toverrides: [],\n\t\t\t\t},\n\t\t\t\toptions: {\n\t\t\t\t\treduceOptions: {\n\t\t\t\t\t\tvalues: false,\n\t\t\t\t\t\tcalcs: [\"lastNotNull\"],\n\t\t\t\t\t\tfields: \"\",\n\t\t\t\t\t},\n\t\t\t\t\torientation: \"auto\",\n\t\t\t\t\ttextMode: \"auto\",\n\t\t\t\t\tcolorMode: \"background\",\n\t\t\t\t\tgraphMode: \"none\",\n\t\t\t\t\tjustifyMode: \"auto\",\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\t// ── Memory Usage (gauge) ──\n\t\t\t\tid: 2,\n\t\t\t\ttitle: \"Memory Usage\",\n\t\t\t\ttype: \"gauge\",\n\t\t\t\tgridPos: { h: 8, w: 8, x: 8, y: 0 },\n\t\t\t\tdatasource: { type: \"prometheus\", uid: \"prometheus\" },\n\t\t\t\ttargets: [\n\t\t\t\t\t{\n\t\t\t\t\t\texpr: \"sum(container_memory_usage_bytes) / sum(machine_memory_bytes) * 100\",\n\t\t\t\t\t\tlegendFormat: \"Memory %\",\n\t\t\t\t\t\trefId: \"A\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tfieldConfig: {\n\t\t\t\t\tdefaults: {\n\t\t\t\t\t\tthresholds: {\n\t\t\t\t\t\t\tmode: \"absolute\",\n\t\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t\t{ color: \"green\", value: null },\n\t\t\t\t\t\t\t\t{ color: \"yellow\", value: 60 },\n\t\t\t\t\t\t\t\t{ color: \"red\", value: 85 },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tcolor: { mode: \"thresholds\" },\n\t\t\t\t\t\tmin: 0,\n\t\t\t\t\t\tmax: 100,\n\t\t\t\t\t\tunit: \"percent\",\n\t\t\t\t\t\tmappings: [],\n\t\t\t\t\t},\n\t\t\t\t\toverrides: [],\n\t\t\t\t},\n\t\t\t\toptions: {\n\t\t\t\t\treduceOptions: {\n\t\t\t\t\t\tvalues: false,\n\t\t\t\t\t\tcalcs: [\"lastNotNull\"],\n\t\t\t\t\t\tfields: \"\",\n\t\t\t\t\t},\n\t\t\t\t\torientation: \"auto\",\n\t\t\t\t\tshowThresholdLabels: false,\n\t\t\t\t\tshowThresholdMarkers: true,\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\t// ── Request Rate (graph / timeseries) ──\n\t\t\t\tid: 3,\n\t\t\t\ttitle: \"Request Rate\",\n\t\t\t\ttype: \"timeseries\",\n\t\t\t\tgridPos: { h: 8, w: 8, x: 16, y: 0 },\n\t\t\t\tdatasource: { type: \"prometheus\", uid: \"prometheus\" },\n\t\t\t\ttargets: [\n\t\t\t\t\t{\n\t\t\t\t\t\texpr: 'sum(rate(http_requests_total{job=~\".+\"}[5m])) by (job)',\n\t\t\t\t\t\tlegendFormat: \"{{job}}\",\n\t\t\t\t\t\trefId: \"A\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tfieldConfig: {\n\t\t\t\t\tdefaults: {\n\t\t\t\t\t\tcolor: { mode: \"palette-classic\" },\n\t\t\t\t\t\tcustom: {\n\t\t\t\t\t\t\taxisBorderShow: false,\n\t\t\t\t\t\t\taxisCenteredZero: false,\n\t\t\t\t\t\t\taxisColorMode: \"text\",\n\t\t\t\t\t\t\taxisLabel: \"req/s\",\n\t\t\t\t\t\t\tdrawStyle: \"line\",\n\t\t\t\t\t\t\tfillOpacity: 10,\n\t\t\t\t\t\t\tgradientMode: \"none\",\n\t\t\t\t\t\t\tlineInterpolation: \"smooth\",\n\t\t\t\t\t\t\tlineWidth: 2,\n\t\t\t\t\t\t\tpointSize: 5,\n\t\t\t\t\t\t\tshowPoints: \"auto\",\n\t\t\t\t\t\t\tspanNulls: false,\n\t\t\t\t\t\t\tstacking: { group: \"A\", mode: \"none\" },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tmappings: [],\n\t\t\t\t\t\tthresholds: {\n\t\t\t\t\t\t\tmode: \"absolute\",\n\t\t\t\t\t\t\tsteps: [{ color: \"green\", value: null }],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tunit: \"reqps\",\n\t\t\t\t\t},\n\t\t\t\t\toverrides: [],\n\t\t\t\t},\n\t\t\t\toptions: {\n\t\t\t\t\tlegend: { calcs: [], displayMode: \"list\", placement: \"bottom\" },\n\t\t\t\t\ttooltip: { mode: \"multi\", sort: \"desc\" },\n\t\t\t\t},\n\t\t\t},\n\t\t],\n\t\tschemaVersion: 39,\n\t\ttags: [\"openclaw\"],\n\t\ttemplating: { list: [] },\n\t\ttime: { from: \"now-1h\", to: \"now\" },\n\t\ttimepicker: {},\n\t\ttimezone: \"browser\",\n\t\ttitle: \"OpenClaw Stack Overview\",\n\t\tuid: \"openclaw-stack-overview\",\n\t};\n\n\treturn JSON.stringify(dashboard, null, 2);\n}\n"],"mappings":"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"}

package/dist/generators/n8n-workflows.d.mts

@@ -0,0 +1,11 @@
+import { ResolverOutput } from "../types.mjs";
+
+//#region src/generators/n8n-workflows.d.ts
+/**
+ * Generates n8n workflow template files.
+ * Returns a map of file paths to JSON content strings.
+ */
+declare function generateN8nWorkflows(resolved: ResolverOutput): Record<string, string>;
+//#endregion
+export { generateN8nWorkflows };
+//# sourceMappingURL=n8n-workflows.d.mts.map

package/dist/generators/n8n-workflows.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-workflows.d.mts","names":[],"sources":["../../src/generators/n8n-workflows.ts"],"mappings":";;;;;AAMA;;iBAAgB,oBAAA,CAAqB,QAAA,EAAU,cAAA,GAAiB,MAAA"}

package/dist/generators/n8n-workflows.mjs

@@ -0,0 +1,75 @@
+//#region src/generators/n8n-workflows.ts
+/**
+* Generates n8n workflow template files.
+* Returns a map of file paths to JSON content strings.
+*/
+function generateN8nWorkflows(resolved) {
+	const files = {};
+	if (!resolved.services.some((s) => s.definition.id === "n8n")) return files;
+	files["n8n/workflows/openclaw-webhook-handler.json"] = JSON.stringify(createWebhookHandlerWorkflow(resolved), null, 2);
+	return files;
+}
+function createWebhookHandlerWorkflow(resolved) {
+	return {
+		name: "OpenClaw Webhook Handler",
+		nodes: [
+			{
+				parameters: {
+					httpMethod: "POST",
+					path: "openclaw-webhook",
+					responseMode: "responseNode",
+					options: {}
+				},
+				id: "webhook-trigger",
+				name: "Webhook",
+				type: "n8n-nodes-base.webhook",
+				typeVersion: 2,
+				position: [250, 300]
+			},
+			{
+				parameters: { jsCode: `// Process OpenClaw webhook payload
+const payload = \$input.all()[0].json;
+
+// Available services in this stack:
+// ${resolved.services.map((s) => s.definition.name).join(", ")}\n
+return [{ json: { received: true, timestamp: new Date().toISOString(), payload } }];` },
+				id: "process-payload",
+				name: "Process Payload",
+				type: "n8n-nodes-base.code",
+				typeVersion: 2,
+				position: [470, 300]
+			},
+			{
+				parameters: {
+					respondWith: "json",
+					responseBody: "={{ JSON.stringify($json) }}",
+					options: {}
+				},
+				id: "respond",
+				name: "Respond to Webhook",
+				type: "n8n-nodes-base.respondToWebhook",
+				typeVersion: 1,
+				position: [690, 300]
+			}
+		],
+		connections: {
+			Webhook: { main: [[{
+				node: "Process Payload",
+				type: "main",
+				index: 0
+			}]] },
+			"Process Payload": { main: [[{
+				node: "Respond to Webhook",
+				type: "main",
+				index: 0
+			}]] }
+		},
+		active: false,
+		settings: { executionOrder: "v1" },
+		tags: [{ name: "openclaw" }]
+	};
+}
+
+//#endregion
+export { generateN8nWorkflows };
+//# sourceMappingURL=n8n-workflows.mjs.map

package/dist/generators/n8n-workflows.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-workflows.mjs","names":[],"sources":["../../src/generators/n8n-workflows.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\n\n/**\n * Generates n8n workflow template files.\n * Returns a map of file paths to JSON content strings.\n */\nexport function generateN8nWorkflows(resolved: ResolverOutput): Record<string, string> {\n\tconst files: Record<string, string> = {};\n\n\t// Only generate if n8n is in the stack\n\tconst hasN8n = resolved.services.some((s) => s.definition.id === \"n8n\");\n\tif (!hasN8n) return files;\n\n\tfiles[\"n8n/workflows/openclaw-webhook-handler.json\"] = JSON.stringify(\n\t\tcreateWebhookHandlerWorkflow(resolved),\n\t\tnull,\n\t\t2,\n\t);\n\n\treturn files;\n}\n\nfunction createWebhookHandlerWorkflow(resolved: ResolverOutput) {\n\t// Create a basic n8n workflow JSON that:\n\t// 1. Has a Webhook trigger node listening on /openclaw-webhook\n\t// 2. Has a Function node that processes the payload\n\t// 3. Outputs to a Respond to Webhook node\n\tconst serviceNames = resolved.services.map((s) => s.definition.name).join(\", \");\n\n\treturn {\n\t\tname: \"OpenClaw Webhook Handler\",\n\t\tnodes: [\n\t\t\t{\n\t\t\t\tparameters: {\n\t\t\t\t\thttpMethod: \"POST\",\n\t\t\t\t\tpath: \"openclaw-webhook\",\n\t\t\t\t\tresponseMode: \"responseNode\",\n\t\t\t\t\toptions: {},\n\t\t\t\t},\n\t\t\t\tid: \"webhook-trigger\",\n\t\t\t\tname: \"Webhook\",\n\t\t\t\ttype: \"n8n-nodes-base.webhook\",\n\t\t\t\ttypeVersion: 2,\n\t\t\t\tposition: [250, 300],\n\t\t\t},\n\t\t\t{\n\t\t\t\tparameters: {\n\t\t\t\t\tjsCode:\n\t\t\t\t\t\t\"// Process OpenClaw webhook payload\\n\" +\n\t\t\t\t\t\t\"const payload = $input.all()[0].json;\\n\" +\n\t\t\t\t\t\t\"\\n\" +\n\t\t\t\t\t\t\"// Available services in this stack:\\n\" +\n\t\t\t\t\t\t`// ${serviceNames}\\n` +\n\t\t\t\t\t\t\"\\n\" +\n\t\t\t\t\t\t\"return [{ json: { received: true, timestamp: new Date().toISOString(), payload } }];\",\n\t\t\t\t},\n\t\t\t\tid: \"process-payload\",\n\t\t\t\tname: \"Process Payload\",\n\t\t\t\ttype: \"n8n-nodes-base.code\",\n\t\t\t\ttypeVersion: 2,\n\t\t\t\tposition: [470, 300],\n\t\t\t},\n\t\t\t{\n\t\t\t\tparameters: {\n\t\t\t\t\trespondWith: \"json\",\n\t\t\t\t\tresponseBody: \"={{ JSON.stringify($json) }}\",\n\t\t\t\t\toptions: {},\n\t\t\t\t},\n\t\t\t\tid: \"respond\",\n\t\t\t\tname: \"Respond to Webhook\",\n\t\t\t\ttype: \"n8n-nodes-base.respondToWebhook\",\n\t\t\t\ttypeVersion: 1,\n\t\t\t\tposition: [690, 300],\n\t\t\t},\n\t\t],\n\t\tconnections: {\n\t\t\tWebhook: {\n\t\t\t\tmain: [[{ node: \"Process Payload\", type: \"main\", index: 0 }]],\n\t\t\t},\n\t\t\t\"Process Payload\": {\n\t\t\t\tmain: [[{ node: \"Respond to Webhook\", type: \"main\", index: 0 }]],\n\t\t\t},\n\t\t},\n\t\tactive: false,\n\t\tsettings: { executionOrder: \"v1\" },\n\t\ttags: [{ name: \"openclaw\" }],\n\t};\n}\n"],"mappings":";;;;;AAMA,SAAgB,qBAAqB,UAAkD;CACtF,MAAM,QAAgC,EAAE;AAIxC,KAAI,CADW,SAAS,SAAS,MAAM,MAAM,EAAE,WAAW,OAAO,MAAM,CAC1D,QAAO;AAEpB,OAAM,iDAAiD,KAAK,UAC3D,6BAA6B,SAAS,EACtC,MACA,EACA;AAED,QAAO;;AAGR,SAAS,6BAA6B,UAA0B;AAO/D,QAAO;EACN,MAAM;EACN,OAAO;GACN;IACC,YAAY;KACX,YAAY;KACZ,MAAM;KACN,cAAc;KACd,SAAS,EAAE;KACX;IACD,IAAI;IACJ,MAAM;IACN,MAAM;IACN,aAAa;IACb,UAAU,CAAC,KAAK,IAAI;IACpB;GACD;IACC,YAAY,EACX,QACC;;;;KArBgB,SAAS,SAAS,KAAK,MAAM,EAAE,WAAW,KAAK,CAAC,KAAK,KAAK,CAyBvD;uFAGpB;IACD,IAAI;IACJ,MAAM;IACN,MAAM;IACN,aAAa;IACb,UAAU,CAAC,KAAK,IAAI;IACpB;GACD;IACC,YAAY;KACX,aAAa;KACb,cAAc;KACd,SAAS,EAAE;KACX;IACD,IAAI;IACJ,MAAM;IACN,MAAM;IACN,aAAa;IACb,UAAU,CAAC,KAAK,IAAI;IACpB;GACD;EACD,aAAa;GACZ,SAAS,EACR,MAAM,CAAC,CAAC;IAAE,MAAM;IAAmB,MAAM;IAAQ,OAAO;IAAG,CAAC,CAAC,EAC7D;GACD,mBAAmB,EAClB,MAAM,CAAC,CAAC;IAAE,MAAM;IAAsB,MAAM;IAAQ,OAAO;IAAG,CAAC,CAAC,EAChE;GACD;EACD,QAAQ;EACR,UAAU,EAAE,gBAAgB,MAAM;EAClC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;EAC5B"}

package/dist/generators/native-services.d.mts

@@ -0,0 +1,17 @@
+import { NativePlatform, ResolvedService } from "../types.mjs";
+
+//#region src/generators/native-services.d.ts
+interface NativeServicesGeneratorOptions {
+  nativeServices: ResolvedService[];
+  platform: NativePlatform;
+  projectName: string;
+}
+/**
+ * Generates native install/run scripts for services that have a native recipe.
+ * Returns e.g. native/install-linux.sh (or native/install.ps1 for Windows).
+ * Scripts source .env and run install steps then start commands in dependency order.
+ */
+declare function generateNativeInstallScripts(options: NativeServicesGeneratorOptions): Record<string, string>;
+//#endregion
+export { NativeServicesGeneratorOptions, generateNativeInstallScripts };
+//# sourceMappingURL=native-services.d.mts.map

package/dist/generators/native-services.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-services.d.mts","names":[],"sources":["../../src/generators/native-services.ts"],"mappings":";;;UAEiB,8BAAA;EAChB,cAAA,EAAgB,eAAA;EAChB,QAAA,EAAU,cAAA;EACV,WAAA;AAAA;;;;;;iBAQe,4BAAA,CACf,OAAA,EAAS,8BAAA,GACP,MAAA"}

package/dist/generators/native-services.mjs

@@ -0,0 +1,78 @@
+//#region src/generators/native-services.ts
+/**
+* Generates native install/run scripts for services that have a native recipe.
+* Returns e.g. native/install-linux.sh (or native/install.ps1 for Windows).
+* Scripts source .env and run install steps then start commands in dependency order.
+*/
+function generateNativeInstallScripts(options) {
+	const { nativeServices, platform } = options;
+	const files = {};
+	if (platform === "linux") files["native/install-linux.sh"] = buildLinuxNativeScript(nativeServices);
+	else if (platform === "windows") files["native/install-windows.ps1"] = buildWindowsNativeScript(nativeServices);
+	else files["native/install-macos.sh"] = buildLinuxNativeScript(nativeServices);
+	return files;
+}
+function buildLinuxNativeScript(nativeServices) {
+	const lines = [
+		"#!/usr/bin/env bash",
+		"set -euo pipefail",
+		"# OpenClaw native services — install and start (Linux). Run from project root. Source .env first.",
+		"",
+		"SCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"",
+		"PROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"",
+		"cd \"$PROJECT_DIR\"",
+		"",
+		"if [ -f .env ]; then set -a; source .env; set +a; fi",
+		""
+	];
+	for (const { definition: def } of nativeServices) {
+		const recipe = def.nativeRecipes?.find((r) => r.platform === "linux");
+		if (!recipe) continue;
+		lines.push(`# ─── ${def.icon} ${def.name} ─────────────────────────────────────────`);
+		lines.push("");
+		if (recipe.configPath && recipe.configTemplate) {
+			const delim = `ENDOF_${def.id.toUpperCase().replace(/-/g, "_")}_CONF`;
+			lines.push(`# Write config for ${def.id}`);
+			lines.push(`sudo mkdir -p "$(dirname "${recipe.configPath}")" 2>/dev/null || true`);
+			lines.push(`sudo tee "${recipe.configPath}" > /dev/null << ${delim}`);
+			lines.push(recipe.configTemplate.trim());
+			lines.push(delim);
+			lines.push("");
+		}
+		for (const step of recipe.installSteps) {
+			lines.push(`# Install: ${def.id}`);
+			lines.push(step);
+			lines.push("");
+		}
+		lines.push(`# Start: ${def.id}`);
+		lines.push(recipe.startCommand);
+		lines.push("");
+	}
+	lines.push("echo 'Native services started.'");
+	return lines.join("\n");
+}
+function buildWindowsNativeScript(nativeServices) {
+	const lines = [
+		"# OpenClaw native services — install and start (Windows). Run from project root.",
+		"$ErrorActionPreference = 'Stop'",
+		"$ProjectDir = (Get-Item $PSScriptRoot).Parent.FullName",
+		"Set-Location $ProjectDir",
+		"",
+		"if (Test-Path .env) { Get-Content .env | ForEach-Object { if ($_ -match '^([^#=]+)=(.*)$') { [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), 'Process') } } }",
+		""
+	];
+	for (const { definition: def } of nativeServices) {
+		const recipe = def.nativeRecipes?.find((r) => r.platform === "windows");
+		if (!recipe) continue;
+		lines.push(`# ${def.name}`);
+		for (const step of recipe.installSteps) lines.push(`Invoke-Expression "${step.replace(/"/g, "`\"")}"`);
+		lines.push(recipe.startCommand);
+		lines.push("");
+	}
+	lines.push("Write-Host 'Native services started.'");
+	return lines.join("\n");
+}
+
+//#endregion
+export { generateNativeInstallScripts };
+//# sourceMappingURL=native-services.mjs.map

package/dist/generators/native-services.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-services.mjs","names":[],"sources":["../../src/generators/native-services.ts"],"sourcesContent":["import type { NativePlatform, ResolvedService } from \"../types.js\";\n\nexport interface NativeServicesGeneratorOptions {\n\tnativeServices: ResolvedService[];\n\tplatform: NativePlatform;\n\tprojectName: string;\n}\n\n/**\n * Generates native install/run scripts for services that have a native recipe.\n * Returns e.g. native/install-linux.sh (or native/install.ps1 for Windows).\n * Scripts source .env and run install steps then start commands in dependency order.\n */\nexport function generateNativeInstallScripts(\n\toptions: NativeServicesGeneratorOptions,\n): Record<string, string> {\n\tconst { nativeServices, platform } = options;\n\tconst files: Record<string, string> = {};\n\n\tif (platform === \"linux\") {\n\t\tfiles[\"native/install-linux.sh\"] = buildLinuxNativeScript(nativeServices);\n\t} else if (platform === \"windows\") {\n\t\tfiles[\"native/install-windows.ps1\"] = buildWindowsNativeScript(nativeServices);\n\t} else {\n\t\t// macos: use bash script similar to linux\n\t\tfiles[\"native/install-macos.sh\"] = buildLinuxNativeScript(nativeServices);\n\t}\n\n\treturn files;\n}\n\nfunction buildLinuxNativeScript(nativeServices: ResolvedService[]): string {\n\tconst lines: string[] = [\n\t\t\"#!/usr/bin/env bash\",\n\t\t\"set -euo pipefail\",\n\t\t\"# OpenClaw native services — install and start (Linux). Run from project root. Source .env first.\",\n\t\t\"\",\n\t\t'SCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"',\n\t\t'PROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"',\n\t\t'cd \"$PROJECT_DIR\"',\n\t\t\"\",\n\t\t\"if [ -f .env ]; then set -a; source .env; set +a; fi\",\n\t\t\"\",\n\t];\n\n\tfor (const { definition: def } of nativeServices) {\n\t\tconst recipe = def.nativeRecipes?.find((r) => r.platform === \"linux\");\n\t\tif (!recipe) continue;\n\n\t\tlines.push(`# ─── ${def.icon} ${def.name} ─────────────────────────────────────────`);\n\t\tlines.push(\"\");\n\n\t\tif (recipe.configPath && recipe.configTemplate) {\n\t\t\tconst delim = `ENDOF_${def.id.toUpperCase().replace(/-/g, \"_\")}_CONF`;\n\t\t\tlines.push(`# Write config for ${def.id}`);\n\t\t\tlines.push(`sudo mkdir -p \"$(dirname \"${recipe.configPath}\")\" 2>/dev/null || true`);\n\t\t\tlines.push(`sudo tee \"${recipe.configPath}\" > /dev/null << ${delim}`);\n\t\t\tlines.push(recipe.configTemplate.trim());\n\t\t\tlines.push(delim);\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tfor (const step of recipe.installSteps) {\n\t\t\tlines.push(`# Install: ${def.id}`);\n\t\t\tlines.push(step);\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tlines.push(`# Start: ${def.id}`);\n\t\tlines.push(recipe.startCommand);\n\t\tlines.push(\"\");\n\t}\n\n\tlines.push(\"echo 'Native services started.'\");\n\treturn lines.join(\"\\n\");\n}\n\nfunction buildWindowsNativeScript(nativeServices: ResolvedService[]): string {\n\tconst lines: string[] = [\n\t\t\"# OpenClaw native services — install and start (Windows). Run from project root.\",\n\t\t\"$ErrorActionPreference = 'Stop'\",\n\t\t\"$ProjectDir = (Get-Item $PSScriptRoot).Parent.FullName\",\n\t\t\"Set-Location $ProjectDir\",\n\t\t\"\",\n\t\t\"if (Test-Path .env) { Get-Content .env | ForEach-Object { if ($_ -match '^([^#=]+)=(.*)$') { [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), 'Process') } } }\",\n\t\t\"\",\n\t];\n\n\tfor (const { definition: def } of nativeServices) {\n\t\tconst recipe = def.nativeRecipes?.find((r) => r.platform === \"windows\");\n\t\tif (!recipe) continue;\n\n\t\tlines.push(`# ${def.name}`);\n\t\tfor (const step of recipe.installSteps) {\n\t\t\tlines.push(`Invoke-Expression \"${step.replace(/\"/g, '`\"')}\"`);\n\t\t}\n\t\tlines.push(recipe.startCommand);\n\t\tlines.push(\"\");\n\t}\n\n\tlines.push(\"Write-Host 'Native services started.'\");\n\treturn lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;AAaA,SAAgB,6BACf,SACyB;CACzB,MAAM,EAAE,gBAAgB,aAAa;CACrC,MAAM,QAAgC,EAAE;AAExC,KAAI,aAAa,QAChB,OAAM,6BAA6B,uBAAuB,eAAe;UAC/D,aAAa,UACvB,OAAM,gCAAgC,yBAAyB,eAAe;KAG9E,OAAM,6BAA6B,uBAAuB,eAAe;AAG1E,QAAO;;AAGR,SAAS,uBAAuB,gBAA2C;CAC1E,MAAM,QAAkB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;AAED,MAAK,MAAM,EAAE,YAAY,SAAS,gBAAgB;EACjD,MAAM,SAAS,IAAI,eAAe,MAAM,MAAM,EAAE,aAAa,QAAQ;AACrE,MAAI,CAAC,OAAQ;AAEb,QAAM,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,KAAK,4CAA4C;AACrF,QAAM,KAAK,GAAG;AAEd,MAAI,OAAO,cAAc,OAAO,gBAAgB;GAC/C,MAAM,QAAQ,SAAS,IAAI,GAAG,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC;AAC/D,SAAM,KAAK,sBAAsB,IAAI,KAAK;AAC1C,SAAM,KAAK,6BAA6B,OAAO,WAAW,yBAAyB;AACnF,SAAM,KAAK,aAAa,OAAO,WAAW,mBAAmB,QAAQ;AACrE,SAAM,KAAK,OAAO,eAAe,MAAM,CAAC;AACxC,SAAM,KAAK,MAAM;AACjB,SAAM,KAAK,GAAG;;AAGf,OAAK,MAAM,QAAQ,OAAO,cAAc;AACvC,SAAM,KAAK,cAAc,IAAI,KAAK;AAClC,SAAM,KAAK,KAAK;AAChB,SAAM,KAAK,GAAG;;AAGf,QAAM,KAAK,YAAY,IAAI,KAAK;AAChC,QAAM,KAAK,OAAO,aAAa;AAC/B,QAAM,KAAK,GAAG;;AAGf,OAAM,KAAK,kCAAkC;AAC7C,QAAO,MAAM,KAAK,KAAK;;AAGxB,SAAS,yBAAyB,gBAA2C;CAC5E,MAAM,QAAkB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;AAED,MAAK,MAAM,EAAE,YAAY,SAAS,gBAAgB;EACjD,MAAM,SAAS,IAAI,eAAe,MAAM,MAAM,EAAE,aAAa,UAAU;AACvE,MAAI,CAAC,OAAQ;AAEb,QAAM,KAAK,KAAK,IAAI,OAAO;AAC3B,OAAK,MAAM,QAAQ,OAAO,aACzB,OAAM,KAAK,sBAAsB,KAAK,QAAQ,MAAM,MAAK,CAAC,GAAG;AAE9D,QAAM,KAAK,OAAO,aAAa;AAC/B,QAAM,KAAK,GAAG;;AAGf,OAAM,KAAK,wCAAwC;AACnD,QAAO,MAAM,KAAK,KAAK"}

package/dist/generators/postgres-init.d.mts

@@ -0,0 +1,30 @@
+import { ResolverOutput } from "../types.mjs";
+
+//#region src/generators/postgres-init.d.ts
+/**
+ * Database requirement descriptor for a service.
+ */
+interface DbRequirement {
+  serviceId: string;
+  serviceName: string;
+  dbName: string;
+  dbUser: string;
+  passwordEnvVar: string;
+}
+/**
+ * Get the list of database requirements for all resolved services.
+ * Exported so other generators (env, composer) can access the same data.
+ */
+declare function getDbRequirements(resolved: ResolverOutput): DbRequirement[];
+/**
+ * Generates a PostgreSQL initialization script that creates databases and users
+ * for all companion services that need their own DB.
+ *
+ * Returns null if PostgreSQL is not in the resolved stack or no services need extra DBs.
+ * The script is designed to be mounted at /docker-entrypoint-initdb.d/init-databases.sh
+ * and runs automatically during PostgreSQL's first initialization.
+ */
+declare function generatePostgresInit(resolved: ResolverOutput): string | null;
+//#endregion
+export { generatePostgresInit, getDbRequirements };
+//# sourceMappingURL=postgres-init.d.mts.map

package/dist/generators/postgres-init.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-init.d.mts","names":[],"sources":["../../src/generators/postgres-init.ts"],"mappings":";;;;;AAAkD;UAKxC,aAAA;EACT,SAAA;EACA,WAAA;EACA,MAAA;EACA,MAAA;EACA,cAAA;AAAA;;;;AAiCD;iBAAgB,iBAAA,CAAkB,QAAA,EAAU,cAAA,GAAiB,aAAA;;;;;;;;AAuB7D;iBAAgB,oBAAA,CAAqB,QAAA,EAAU,cAAA"}