@better-openclaw/core 1.0.0

package/dist/generators/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/generators/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAavD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAAwB,EACxB,OAA4B;IAE5B,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC;IACpD,MAAM,KAAK,GAAkF,EAAE,CAAC;IAEhG,4EAA4E;IAE5E,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CAAC,4BAA4B,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC;QAClF,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,OAAO;KACpB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpF,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,mDAAmD,EACnD,eAAe,EACf,IAAI,EACJ,IAAI,CACJ;QACD,GAAG,EAAE,wBAAwB;QAC7B,YAAY,EAAE,yBAAyB;QACvC,WAAW,EAAE,YAAY;KACzB,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CAAC,sCAAsC,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC;QAC5F,GAAG,EAAE,uBAAuB;QAC5B,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,OAAO;KACpB,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,8CAA8C,EAC9C,eAAe,EACf,KAAK,EACL,KAAK,CACL;QACD,GAAG,EAAE,sBAAsB;QAC3B,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,OAAO;KACpB,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,gFAAgF,EAChF,eAAe,EACf,KAAK,EACL,KAAK,CACL;QACD,GAAG,EAAE,uBAAuB;QAC5B,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,+CAA+C,EAC/C,eAAe,EACf,IAAI,EACJ,KAAK,CACL;QACD,GAAG,EAAE,qBAAqB;QAC1B,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE,mBAAmB;KAChC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,2CAA2C,EAC3C,eAAe,EACf,IAAI,EACJ,KAAK,CACL;QACD,GAAG,EAAE,wBAAwB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE,sBAAsB;KACnC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,yEAAyE,EACzE,eAAe,EACf,KAAK,EACL,KAAK,CACL;QACD,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,EAAE;KACf,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,aAAa,CAAC,oCAAoC,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC;YAC3F,GAAG,EAAE,iBAAiB;YACtB,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,OAAO,CAAC,MAAM;SAC3B,CAAC,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EACN,0MAA0M;QAC3M,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,EAAE;KACf,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,uDAAuD,EACvD,eAAe,EACf,KAAK,EACL,IAAI,CACJ;QACD,GAAG,EAAE,uBAAuB;QAC5B,YAAY,EAAE,iCAAiC;QAC/C,WAAW,EAAE,EAAE;KACf,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,wDAAwD,EACxD,eAAe,EACf,KAAK,EACL,IAAI,CACJ;QACD,GAAG,EAAE,wBAAwB;QAC7B,YAAY,EAAE,kCAAkC;QAChD,WAAW,EAAE,EAAE;KACf,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,aAAa,CACrB,mDAAmD,EACnD,eAAe,EACf,KAAK,EACL,IAAI,CACJ;QACD,GAAG,EAAE,mBAAmB;QACxB,YAAY,EAAE,6BAA6B;QAC3C,WAAW,EAAE,EAAE;KACf,CAAC,CAAC;IAEH,2EAA2E;IAE3E,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC;YACV,OAAO,EACN,2QAA2Q;YAC5Q,GAAG,EAAE,EAAE;YACP,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;SACf,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEnF,KAAK,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,aAAa,CACrB,2BAA2B,GAAG,CAAC,WAAW,eAAe,GAAG,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,GAAG,EAC3F,GAAG,CAAC,WAAW,EACf,IAAI,EACJ,IAAI,CACJ;gBACD,GAAG,EAAE,GAAG,CAAC,cAAc;gBACvB,YAAY,EAAE,QAAQ,GAAG,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO;gBAC7D,WAAW,EAAE,WAAW;aACxB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,4EAA4E;IAE5E,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS;QAChC,kBAAkB;QAClB,wBAAwB;QACxB,uBAAuB;QACvB,sBAAsB;QACtB,uBAAuB;QACvB,qBAAqB;QACrB,wBAAwB;QACxB,gBAAgB;QAChB,iBAAiB;QACjB,uBAAuB;QACvB,wBAAwB;QACxB,mBAAmB;QACnB,GAAG,cAAc;KACjB,CAAC,CAAC;IAEH,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAE9E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEtC,qCAAqC;QACrC,KAAK,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,0FAA0F,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,qFAAqF;YAC1N,GAAG,EAAE,EAAE;YACP,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;SACf,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAE9D,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEzB,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEnF,+FAA+F;YAC/F,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;YAExE,MAAM,YAAY,GAAG,SAAS;gBAC7B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,MAAM;oBACd,CAAC,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO;oBACzC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;YAExB,IAAI,WAAmB,CAAC;YACxB,IAAI,SAAS,EAAE,CAAC;gBACf,WAAW,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC1B,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACP,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;YACnC,CAAC;YAED,KAAK,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC3F,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,YAAY;gBACZ,WAAW;aACX,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,2EAA2E;IAE3E,MAAM,MAAM,GAAG;QACd,mFAAmF;QACnF,sCAAsC;QACtC,kBAAkB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QAC5C,mFAAmF;QACnF,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,UAAU,GAAG,MAAM,CAAC;IACxB,IAAI,GAAG,GAAG,MAAM,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;YACrB,kBAAkB;YAClB,UAAU,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC;YAClC,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC;QAC5B,CAAC;aAAM,CAAC;YACP,UAAU,IAAI,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,MAAM,CAAC;YACtE,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,MAAM,CAAC;QAC/D,CAAC;IACF,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACrB,WAAmB,EACnB,WAAmB,EACnB,QAAiB,EACjB,MAAe;IAEf,OAAO;QACN,KAAK,WAAW,EAAE;QAClB,cAAc,WAAW,gBAAgB,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,cAAc,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACrG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAiBD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC5D,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,4EAA4E;IAC5E,MAAM,QAAQ,GAAwB;QACrC;YACC,GAAG,EAAE,kBAAkB;YACvB,WAAW,EAAE,4BAA4B;YACzC,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,QAAQ;SACtB;QACD;YACC,GAAG,EAAE,wBAAwB;YAC7B,WAAW,EAAE,mDAAmD;YAChE,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,EAAE;SAChB;QACD;YACC,GAAG,EAAE,uBAAuB;YAC5B,WAAW,EAAE,sCAAsC;YACnD,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,OAAO;SACrB;KACD,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC;QACX,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,eAAe;QAC1B,IAAI,EAAE,QAAQ;KACd,CAAC,CAAC;IAEH,4EAA4E;IAC5E,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAE9E,MAAM,IAAI,GAAwB,EAAE,CAAC;QAErC,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEzB,IAAI,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,YAAY,EAAE,MAAM,CAAC,YAAY;aACjC,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhC,MAAM,CAAC,IAAI,CAAC;YACX,WAAW,EAAE,UAAU,CAAC,IAAI;YAC5B,WAAW,EAAE,UAAU,CAAC,IAAI;YAC5B,SAAS,EAAE,UAAU,CAAC,EAAE;YACxB,IAAI;SACJ,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/generators/grafana.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+export 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.
+ */
+export declare function generateGrafanaDashboard(): string;
+//# sourceMappingURL=grafana.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grafana.d.ts","sourceRoot":"","sources":["../../src/generators/grafana.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqF9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAuJjD"}

package/dist/generators/grafana.js

@@ -0,0 +1,247 @@
+/**
+ * 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.
+ */
+export function generateGrafanaConfig() {
+    const files = {};
+    // ── Datasource Provisioning ─────────────────────────────────────────────
+    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
+`;
+    // ── Dashboard Provisioning ───────────────────────────────────────────────
+    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
+`;
+    // ── Grafana Configuration (grafana.ini overrides) ────────────────────────
+    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.
+ */
+export function generateGrafanaDashboard() {
+    const dashboard = {
+        annotations: { list: [] },
+        editable: true,
+        fiscalYearStartMonth: 0,
+        graphTooltip: 1,
+        links: [],
+        panels: [
+            {
+                // ── Service Health (stat panel) ──
+                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",
+                },
+            },
+            {
+                // ── Memory Usage (gauge) ──
+                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,
+                },
+            },
+            {
+                // ── Request Rate (graph / timeseries) ──
+                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",
+    };
+    return JSON.stringify(dashboard, null, 2);
+}
+//# sourceMappingURL=grafana.js.map

package/dist/generators/grafana.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafana.js","sourceRoot":"","sources":["../../src/generators/grafana.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-workflows.d.ts","sourceRoot":"","sources":["../../src/generators/n8n-workflows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrF"}

package/dist/generators/n8n-workflows.js

@@ -0,0 +1,78 @@
+/**
+ * Generates n8n workflow template files.
+ * Returns a map of file paths to JSON content strings.
+ */
+export function generateN8nWorkflows(resolved) {
+    const files = {};
+    // Only generate if n8n is in the stack
+    const hasN8n = resolved.services.some((s) => s.definition.id === "n8n");
+    if (!hasN8n)
+        return files;
+    files["n8n/workflows/openclaw-webhook-handler.json"] = JSON.stringify(createWebhookHandlerWorkflow(resolved), null, 2);
+    return files;
+}
+function createWebhookHandlerWorkflow(resolved) {
+    // Create a basic n8n workflow JSON that:
+    // 1. Has a Webhook trigger node listening on /openclaw-webhook
+    // 2. Has a Function node that processes the payload
+    // 3. Outputs to a Respond to Webhook node
+    const serviceNames = resolved.services.map((s) => s.definition.name).join(", ");
+    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\n" +
+                        "const payload = $input.all()[0].json;\n" +
+                        "\n" +
+                        "// Available services in this stack:\n" +
+                        `// ${serviceNames}\n` +
+                        "\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" }],
+    };
+}
+//# sourceMappingURL=n8n-workflows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-workflows.js","sourceRoot":"","sources":["../../src/generators/n8n-workflows.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC5D,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,uCAAuC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,KAAK,CAAC,6CAA6C,CAAC,GAAG,IAAI,CAAC,SAAS,CACpE,4BAA4B,CAAC,QAAQ,CAAC,EACtC,IAAI,EACJ,CAAC,CACD,CAAC;IAEF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,4BAA4B,CAAC,QAAwB;IAC7D,yCAAyC;IACzC,+DAA+D;IAC/D,oDAAoD;IACpD,0CAA0C;IAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhF,OAAO;QACN,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE;YACN;gBACC,UAAU,EAAE;oBACX,UAAU,EAAE,MAAM;oBAClB,IAAI,EAAE,kBAAkB;oBACxB,YAAY,EAAE,cAAc;oBAC5B,OAAO,EAAE,EAAE;iBACX;gBACD,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,wBAAwB;gBAC9B,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;aACpB;YACD;gBACC,UAAU,EAAE;oBACX,MAAM,EACL,uCAAuC;wBACvC,yCAAyC;wBACzC,IAAI;wBACJ,wCAAwC;wBACxC,MAAM,YAAY,IAAI;wBACtB,IAAI;wBACJ,sFAAsF;iBACvF;gBACD,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;aACpB;YACD;gBACC,UAAU,EAAE;oBACX,WAAW,EAAE,MAAM;oBACnB,YAAY,EAAE,8BAA8B;oBAC5C,OAAO,EAAE,EAAE;iBACX;gBACD,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,iCAAiC;gBACvC,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;aACpB;SACD;QACD,WAAW,EAAE;YACZ,OAAO,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;aAC7D;YACD,iBAAiB,EAAE;gBAClB,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;aAChE;SACD;QACD,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;QAClC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;KAC5B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { NativePlatform, ResolvedService } from "../types.js";
+export 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.
+ */
+export declare function generateNativeInstallScripts(options: NativeServicesGeneratorOptions): Record<string, string>;
+//# sourceMappingURL=native-services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-services.d.ts","sourceRoot":"","sources":["../../src/generators/native-services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,8BAA8B;IAC9C,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,8BAA8B,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB"}

package/dist/generators/native-services.js

@@ -0,0 +1,85 @@
+/**
+ * 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.
+ */
+export 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 {
+        // macos: use bash script similar to linux
+        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");
+}
+//# sourceMappingURL=native-services.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-services.js","sourceRoot":"","sources":["../../src/generators/native-services.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+import type { ResolverOutput } from "../types.js";
+/**
+ * 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.
+ */
+export 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.
+ */
+export declare function generatePostgresInit(resolved: ResolverOutput): string | null;
+export {};
+//# sourceMappingURL=postgres-init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-init.d.ts","sourceRoot":"","sources":["../../src/generators/postgres-init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,UAAU,aAAa;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACvB;AA4BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,EAAE,CAa3E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAsE5E"}

package/dist/generators/postgres-init.js

@@ -0,0 +1,119 @@
+/**
+ * Known database requirements for services that need their own PostgreSQL database.
+ * Maps service ID to the DB name, user, and password env var they expect.
+ */
+const DB_REQUIREMENTS = {
+    n8n: { dbName: "n8n", dbUser: "n8n", passwordEnvVar: "N8N_DB_PASSWORD" },
+    postiz: { dbName: "postiz", dbUser: "postiz", passwordEnvVar: "POSTIZ_DB_PASSWORD" },
+    outline: { dbName: "outline", dbUser: "outline", passwordEnvVar: "OUTLINE_DB_PASSWORD" },
+    dify: { dbName: "dify", dbUser: "dify", passwordEnvVar: "DIFY_DB_PASSWORD" },
+    temporal: { dbName: "temporal", dbUser: "temporal", passwordEnvVar: "TEMPORAL_DB_PASSWORD" },
+    mattermost: {
+        dbName: "mattermost",
+        dbUser: "mattermost",
+        passwordEnvVar: "MATTERMOST_DB_PASSWORD",
+    },
+    "matrix-synapse": { dbName: "synapse", dbUser: "synapse", passwordEnvVar: "SYNAPSE_DB_PASSWORD" },
+    "paperless-ngx": {
+        dbName: "paperless",
+        dbUser: "paperless",
+        passwordEnvVar: "PAPERLESS_DB_PASSWORD",
+    },
+    umami: { dbName: "umami", dbUser: "umami", passwordEnvVar: "UMAMI_DB_PASSWORD" },
+    matomo: { dbName: "matomo", dbUser: "matomo", passwordEnvVar: "MATOMO_DB_PASSWORD" },
+    mixpost: { dbName: "mixpost", dbUser: "mixpost", passwordEnvVar: "MIXPOST_DB_PASSWORD" },
+};
+/**
+ * Get the list of database requirements for all resolved services.
+ * Exported so other generators (env, composer) can access the same data.
+ */
+export function getDbRequirements(resolved) {
+    const reqs = [];
+    for (const { definition } of resolved.services) {
+        const req = DB_REQUIREMENTS[definition.id];
+        if (req) {
+            reqs.push({
+                serviceId: definition.id,
+                serviceName: definition.name,
+                ...req,
+            });
+        }
+    }
+    return reqs;
+}
+/**
+ * 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.
+ */
+export function generatePostgresInit(resolved) {
+    const hasPostgres = resolved.services.some((s) => s.definition.id === "postgresql");
+    if (!hasPostgres)
+        return null;
+    const reqs = getDbRequirements(resolved);
+    if (reqs.length === 0)
+        return null;
+    const createCalls = reqs
+        .map((r) => `create_db_and_user "${r.dbName}" "${r.dbUser}" "\${${r.passwordEnvVar}:-$POSTGRES_PASSWORD}"`)
+        .join("\n");
+    return `#!/bin/bash
+set -e
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# PostgreSQL Initialization Script
+# Generated by better-openclaw
+#
+# This script runs automatically during PostgreSQL's first initialization.
+# It creates databases and users for all companion services in your stack.
+# ═══════════════════════════════════════════════════════════════════════════════
+
+create_db_and_user() {
+  local db="$1"
+  local user="$2"
+  local password="$3"
+
+  echo ">>> Creating database '$db' with user '$user'..."
+
+  psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    -- Create user if not exists
+    DO \\$\\$
+    BEGIN
+      IF NOT EXISTS (SELECT FROM pg_catalog.pg_roles WHERE rolname = '$user') THEN
+        CREATE ROLE "$user" WITH LOGIN PASSWORD '$password';
+        RAISE NOTICE 'Created user: $user';
+      ELSE
+        -- Update password in case it changed
+        ALTER ROLE "$user" WITH PASSWORD '$password';
+        RAISE NOTICE 'User already exists, updated password: $user';
+      END IF;
+    END
+    \\$\\$;
+
+    -- Create database if not exists
+    SELECT 'CREATE DATABASE "$db" OWNER "$user"'
+    WHERE NOT EXISTS (SELECT FROM pg_database WHERE datname = '$db')\\gexec
+
+    -- Grant privileges
+    GRANT ALL PRIVILEGES ON DATABASE "$db" TO "$user";
+EOSQL
+
+  echo ">>> Done: database '$db' with user '$user'"
+}
+
+echo "═══════════════════════════════════════════════════════════"
+echo " Initializing databases for companion services..."
+echo "═══════════════════════════════════════════════════════════"
+
+${createCalls}
+
+echo ""
+echo "═══════════════════════════════════════════════════════════"
+echo " All databases initialized successfully!"
+echo " Services: ${reqs.map((r) => r.serviceName).join(", ")}"
+echo "═══════════════════════════════════════════════════════════"
+`;
+}
+//# sourceMappingURL=postgres-init.js.map