clawsql 0.2.3 → 0.2.6

package/README.md

@@ -13,6 +13,7 @@ MySQL High Availability Management Platform with automatic failover, read/write
 
 ## Prerequisites
 
+- **Node.js**: v22.22+ (for CLI)
 - **Container Runtime**: Docker or Podman
 - **Docker Compose**: docker-compose or podman-compose
 
@@ -120,7 +121,7 @@ After starting, access these services:
 | Orchestrator | http://localhost:3000 | MySQL topology manager |
 | Prometheus | http://localhost:9090 | Metrics collection |
 | Grafana | http://localhost:3001 | Dashboards (admin/admin) |
-| ProxySQL | localhost:6033 | MySQL traffic (read/write split) |
+| ProxySQL | localhost:6033+ | MySQL traffic (per-cluster ports) |
 | OpenClaw Gateway | ws://localhost:18789 | AI agent gateway |
 | OpenClaw UI | http://localhost:18790 | AI control panel |
 
@@ -204,16 +205,62 @@ Available configuration keys:
 
 ### Cluster Management
 
+ClawSQL uses a **provisioning-first approach** - create clusters from predefined templates for consistent, validated configurations.
+
+```bash
+# Primary: Template-based provisioning (recommended)
+/clusters provision                           # Interactive template selection
+/clusters provision --template <name> --cluster <name> --hosts <h:p,...>
+  # Provision cluster from template
+  # First host becomes primary, rest become replicas
+  # Auto-configures replication and ProxySQL with dedicated port
+
+/clusters quick <template> <cluster> <h:p,...>  # Fast provisioning (minimal args)
+/clusters deprovision <cluster> --force         # Remove provisioned cluster
+
+# View clusters and topology
+/clusters list                            # List all clusters
+/clusters topology [--name <cluster>]     # Show topology
+
+# Manual operations (for advanced use cases)
+/clusters manual create --name <name> --primary <h:p> [--replicas <h:p,...>]
+/clusters manual import --primary <h:p>   # Import existing topology
+/clusters manual sync [--name <cluster>]  # Sync to ProxySQL
+/clusters manual promote --name <cluster> --host <h:p>  # Promote replica
+```
+
+### Predefined Templates
+
+Templates are automatically initialized on platform startup. No need to create them manually:
+
+| Template | Nodes | Mode | Use Case |
+|----------|-------|------|----------|
+| `dev-single` | 1 | async | Development/testing, CI/CD |
+| `dev-replica` | 2 | async | Development with backup |
+| `standard` | 3 | async | General production workloads |
+| `ha-semisync` | 3 | semi-sync | Critical production, zero data loss |
+| `read-heavy` | 5 | async | Analytics, reporting, high read throughput |
+| `production-ha` | 4 | semi-sync | Mission-critical, enterprise databases |
+| `geo-distributed` | 6 | async | Multi-region, disaster recovery |
+
+Quick example:
+```bash
+# Provision a standard 3-node cluster
+> /clusters quick standard mycluster mysql1:3306,mysql2:3306,mysql3:3306
+Cluster "mycluster" ready at port 6033
+```
+
+### Template Management
+
 ```bash
-/clusters list                                    # List all clusters
-/clusters topology [--name <cluster>]             # Show topology
-/clusters import --primary <host:port>            # Import existing topology
-/clusters create --name <name> --primary <h:p>    # Create new cluster
-  --replicas <h:p,...>   Replica instances (optional)
-
-/clusters sync [--name <cluster>]                 # Sync to ProxySQL
-/clusters add-replica --name <cluster> --host <h:p>    # Add replica
-/clusters remove-replica --name <cluster> --host <h:p> # Remove replica
+/templates list                     # List available templates (includes predefined)
+/templates create --name <name>     # Create custom template
+  --replicas <n>          Number of replicas (default: 2)
+  --mode <mode>           Replication mode: async, semi-sync (default: async)
+  --description <desc>    Optional description
+
+/templates show <name>              # Show template details
+/templates delete <name> --force    # Delete custom template (predefined cannot be deleted)
 ```
 
 ### Failover Operations
@@ -307,13 +354,15 @@ Key settings:
 ┌─────────────────────────────────────────────────────────────────┐
 │                          ProxySQL                                │
 │                    (Read/Write Splitting)                        │
-│         Port 6033 - MySQL Traffic | Port 6032 - Admin           │
+│    Per-Cluster Ports: 6033 (cluster1), 6034 (cluster2), ...     │
+│                    Port 6032 - Admin Interface                   │
 └───────────────┬─────────────────────────────┬───────────────────┘
                 │                             │
         ┌───────▼───────┐             ┌───────▼───────┐
         │    Primary    │             │    Replica    │
         │   (Writer)    │────────────▶│   (Reader)    │
-        │   Port 3306   │   Repl      │   Port 3306   │
+        │   Hostgroup N │   Repl      │ Hostgroup N+10│
+        │   Port 3306   │             │   Port 3306   │
         └───────────────┘             └───────────────┘
                 │                             │
                 └──────────────┬──────────────┘
@@ -324,10 +373,11 @@ Key settings:
 │  │ Orchestrator│  │  Failover   │  │  Monitoring │              │
 │  │   Client    │  │   Engine    │  │   Service   │              │
 │  └─────────────┘  └─────────────┘  └─────────────┘              │
-│  ┌─────────────────────────────────────────────────┐            │
-│  │              OpenClaw AI Gateway                 │            │
-│  │         Port 18789 - Gateway | Port 18790 - UI  │            │
-│  └─────────────────────────────────────────────────┘            │
+│  ┌─────────────┐  ┌─────────────────────────────────────────────┐│
+│  │ Provisioning│  │              OpenClaw AI Gateway             ││
+│  │   Engine    │  │         Port 18789 - Gateway | Port 18790   ││
+│  │ (Templates) │  └─────────────────────────────────────────────┘│
+│  └─────────────┘                                                 │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
@@ -375,9 +425,11 @@ clawsql/
 │   │   ├── discovery/     # Instance discovery and topology
 │   │   ├── monitoring/    # Metrics and health checks
 │   │   ├── failover/      # Failover operations
+│   │   ├── provisioning/  # Template-based cluster provisioning
 │   │   └── routing/       # ProxySQL integration
 │   ├── api/               # REST API routes
 │   ├── cli/               # CLI commands
+│   │   └── utils/         # CLI utilities (arg parsing, etc.)
 │   ├── utils/             # Utilities
 │   └── __tests__/         # Test files
 ├── docker/                # Docker configurations

package/dist/api/schemas/index.d.ts

@@ -137,6 +137,7 @@ export declare const InstanceListResponse: z.ZodObject<{
     page: z.ZodNumber;
     page_size: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    total: number;
     page: number;
     page_size: number;
     items: {
@@ -153,8 +154,8 @@ export declare const InstanceListResponse: z.ZodObject<{
         last_seen: Date;
         created_at: Date;
     }[];
-    total: number;
 }, {
+    total: number;
     page: number;
     page_size: number;
     items: {
@@ -171,7 +172,6 @@ export declare const InstanceListResponse: z.ZodObject<{
         last_seen: Date;
         created_at: Date;
     }[];
-    total: number;
 }>;
 export declare const InstanceMetricsResponse: z.ZodObject<{
     instance_id: z.ZodString;
@@ -294,7 +294,7 @@ export declare const DiscoveryResponse: z.ZodObject<{
     started_at: z.ZodOptional<z.ZodDate>;
     completed_at: z.ZodOptional<z.ZodDate>;
 }, "strip", z.ZodTypeAny, {
-    status: "failed" | "completed" | "running" | "pending";
+    status: "failed" | "completed" | "pending" | "running";
     network_segments: string[];
     task_id: string;
     instances_found: number;
@@ -316,7 +316,7 @@ export declare const DiscoveryResponse: z.ZodObject<{
     started_at?: Date | undefined;
     completed_at?: Date | undefined;
 }, {
-    status: "failed" | "completed" | "running" | "pending";
+    status: "failed" | "completed" | "pending" | "running";
     network_segments: string[];
     task_id: string;
     instances_found: number;
@@ -675,6 +675,7 @@ export declare const ClusterListResponse: z.ZodObject<{
     page: z.ZodNumber;
     page_size: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    total: number;
     page: number;
     page_size: number;
     items: {
@@ -714,8 +715,8 @@ export declare const ClusterListResponse: z.ZodObject<{
         health_status: "unknown" | "healthy" | "degraded" | "unhealthy";
         updated_at: Date;
     }[];
-    total: number;
 }, {
+    total: number;
     page: number;
     page_size: number;
     items: {
@@ -755,7 +756,6 @@ export declare const ClusterListResponse: z.ZodObject<{
         health_status: "unknown" | "healthy" | "degraded" | "unhealthy";
         updated_at: Date;
     }[];
-    total: number;
 }>;
 export declare const FailoverStateSchema: z.ZodEnum<["idle", "detecting", "candidate_selection", "promoting", "reconfiguring", "completed", "failed"]>;
 export declare const FailoverRequest: z.ZodObject<{
@@ -785,10 +785,10 @@ export declare const FailoverOperationResponse: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     error: string | null;
     state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-    reason: string | null;
-    cluster_id: string;
     steps: string[];
     manual: boolean;
+    reason: string | null;
+    cluster_id: string;
     operation_id: string;
     started_at: string | null;
     completed_at: string | null;
@@ -799,10 +799,10 @@ export declare const FailoverOperationResponse: z.ZodObject<{
 }, {
     error: string | null;
     state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-    reason: string | null;
-    cluster_id: string;
     steps: string[];
     manual: boolean;
+    reason: string | null;
+    cluster_id: string;
     operation_id: string;
     started_at: string | null;
     completed_at: string | null;
@@ -829,10 +829,10 @@ export declare const FailoverListResponse: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         error: string | null;
         state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-        reason: string | null;
-        cluster_id: string;
         steps: string[];
         manual: boolean;
+        reason: string | null;
+        cluster_id: string;
         operation_id: string;
         started_at: string | null;
         completed_at: string | null;
@@ -843,10 +843,10 @@ export declare const FailoverListResponse: z.ZodObject<{
     }, {
         error: string | null;
         state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-        reason: string | null;
-        cluster_id: string;
         steps: string[];
         manual: boolean;
+        reason: string | null;
+        cluster_id: string;
         operation_id: string;
         started_at: string | null;
         completed_at: string | null;
@@ -857,13 +857,14 @@ export declare const FailoverListResponse: z.ZodObject<{
     }>, "many">;
     total: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    total: number;
     items: {
         error: string | null;
         state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-        reason: string | null;
-        cluster_id: string;
         steps: string[];
         manual: boolean;
+        reason: string | null;
+        cluster_id: string;
         operation_id: string;
         started_at: string | null;
         completed_at: string | null;
@@ -872,15 +873,15 @@ export declare const FailoverListResponse: z.ZodObject<{
         duration_seconds: number | null;
         triggered_by: string | null;
     }[];
-    total: number;
 }, {
+    total: number;
     items: {
         error: string | null;
         state: "failed" | "idle" | "detecting" | "candidate_selection" | "promoting" | "reconfiguring" | "completed";
-        reason: string | null;
-        cluster_id: string;
         steps: string[];
         manual: boolean;
+        reason: string | null;
+        cluster_id: string;
         operation_id: string;
         started_at: string | null;
         completed_at: string | null;
@@ -889,7 +890,6 @@ export declare const FailoverListResponse: z.ZodObject<{
         duration_seconds: number | null;
         triggered_by: string | null;
     }[];
-    total: number;
 }>;
 export declare const HealthStatusResponse: z.ZodObject<{
     status: z.ZodEnum<["healthy", "unhealthy"]>;

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAiBnC;;GAEG;AACH,wBAAsB,SAAS,wSAsI9B;AAED;;GAEG;AACH,wBAAsB,WAAW,wSA6ChC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAkBnC;;GAEG;AACH,wBAAsB,SAAS,wSAsI9B;AAED;;GAEG;AACH,wBAAsB,WAAW,wSAwDhC"}

package/dist/app.js

@@ -18,6 +18,7 @@ const settings_js_1 = require("./config/settings.js");
 const logger_js_1 = require("./utils/logger.js");
 const database_js_1 = require("./utils/database.js");
 const exceptions_js_1 = require("./utils/exceptions.js");
+const index_js_1 = require("./core/provisioning/index.js");
 // Import routes
 const instances_js_1 = __importDefault(require("./api/routes/instances.js"));
 const clusters_js_1 = __importDefault(require("./api/routes/clusters.js"));
@@ -161,6 +162,17 @@ async function startServer() {
     // Initialize database
     try {
         await (0, database_js_1.initDatabase)();
+        // Initialize predefined templates for cluster provisioning
+        try {
+            const templateManager = (0, index_js_1.getTemplateManager)();
+            const templatesCreated = await templateManager.initializePredefinedTemplates();
+            if (templatesCreated > 0) {
+                fastify.log.info(`Initialized ${templatesCreated} predefined templates`);
+            }
+        }
+        catch (error) {
+            fastify.log.warn({ error }, 'Failed to initialize predefined templates, continuing with existing templates');
+        }
     }
     catch (error) {
         fastify.log.warn({ error }, 'Failed to initialize database, continuing without persistence');

package/dist/app.js.map

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

package/dist/cli/agent/index.d.ts

@@ -10,6 +10,6 @@ export { loadAIConfig } from './providers/base.js';
 export { AnthropicProvider, getAnthropicProvider } from './providers/anthropic.js';
 export { OpenAIProvider, getOpenAIProvider } from './providers/openai.js';
 export { createAgentTools } from './tools/index.js';
-export { OpenClawAgent, createOpenClawAgent, isOpenClawAvailable, isDockerOpenClawAvailable, isLocalOpenClawAvailable, isGatewayHealthy, getOpenClawStatus, ensureOpenClawRunning, sendToOpenClaw, sendToOpenClawStream, scheduleCron, sendNotification, writeToMemory, getModelProviderInfo, configureModelProvider, testOpenClawConnection, getDetailedOpenClawStatus, SUPPORTED_PROVIDERS, } from './openclaw-integration.js';
+export { OpenClawAgent, createOpenClawAgent, isOpenClawAvailable, isDockerOpenClawAvailable, isLocalOpenClawAvailable, isGatewayHealthy, getOpenClawStatus, ensureOpenClawRunning, sendToOpenClaw, sendToOpenClawStream, scheduleCron, sendNotification, writeToMemory, getModelProviderInfo, configureModelProvider, testOpenClawConnection, getDetailedOpenClawStatus, printUnknownGatewayGuidance, INTERNAL_CLUSTER_PREFIXES, INTERNAL_CLUSTER_NAMES, SUPPORTED_PROVIDERS, } from './openclaw-integration.js';
 export type { ModelProviderInfo, OpenClawOptions, OpenClawStatus } from './openclaw-integration.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/cli/agent/index.js

@@ -5,7 +5,7 @@
  * Exports for the AI agent system.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_PROVIDERS = exports.getDetailedOpenClawStatus = exports.testOpenClawConnection = exports.configureModelProvider = exports.getModelProviderInfo = exports.writeToMemory = exports.sendNotification = exports.scheduleCron = exports.sendToOpenClawStream = exports.sendToOpenClaw = exports.ensureOpenClawRunning = exports.getOpenClawStatus = exports.isGatewayHealthy = exports.isLocalOpenClawAvailable = exports.isDockerOpenClawAvailable = exports.isOpenClawAvailable = exports.createOpenClawAgent = exports.OpenClawAgent = exports.createAgentTools = exports.getOpenAIProvider = exports.OpenAIProvider = exports.getAnthropicProvider = exports.AnthropicProvider = exports.loadAIConfig = exports.createAIAgent = exports.AIAgent = void 0;
+exports.SUPPORTED_PROVIDERS = exports.INTERNAL_CLUSTER_NAMES = exports.INTERNAL_CLUSTER_PREFIXES = exports.printUnknownGatewayGuidance = exports.getDetailedOpenClawStatus = exports.testOpenClawConnection = exports.configureModelProvider = exports.getModelProviderInfo = exports.writeToMemory = exports.sendNotification = exports.scheduleCron = exports.sendToOpenClawStream = exports.sendToOpenClaw = exports.ensureOpenClawRunning = exports.getOpenClawStatus = exports.isGatewayHealthy = exports.isLocalOpenClawAvailable = exports.isDockerOpenClawAvailable = exports.isOpenClawAvailable = exports.createOpenClawAgent = exports.OpenClawAgent = exports.createAgentTools = exports.getOpenAIProvider = exports.OpenAIProvider = exports.getAnthropicProvider = exports.AnthropicProvider = exports.loadAIConfig = exports.createAIAgent = exports.AIAgent = void 0;
 var handler_js_1 = require("./handler.js");
 Object.defineProperty(exports, "AIAgent", { enumerable: true, get: function () { return handler_js_1.AIAgent; } });
 Object.defineProperty(exports, "createAIAgent", { enumerable: true, get: function () { return handler_js_1.createAIAgent; } });
@@ -37,5 +37,8 @@ Object.defineProperty(exports, "getModelProviderInfo", { enumerable: true, get:
 Object.defineProperty(exports, "configureModelProvider", { enumerable: true, get: function () { return openclaw_integration_js_1.configureModelProvider; } });
 Object.defineProperty(exports, "testOpenClawConnection", { enumerable: true, get: function () { return openclaw_integration_js_1.testOpenClawConnection; } });
 Object.defineProperty(exports, "getDetailedOpenClawStatus", { enumerable: true, get: function () { return openclaw_integration_js_1.getDetailedOpenClawStatus; } });
+Object.defineProperty(exports, "printUnknownGatewayGuidance", { enumerable: true, get: function () { return openclaw_integration_js_1.printUnknownGatewayGuidance; } });
+Object.defineProperty(exports, "INTERNAL_CLUSTER_PREFIXES", { enumerable: true, get: function () { return openclaw_integration_js_1.INTERNAL_CLUSTER_PREFIXES; } });
+Object.defineProperty(exports, "INTERNAL_CLUSTER_NAMES", { enumerable: true, get: function () { return openclaw_integration_js_1.INTERNAL_CLUSTER_NAMES; } });
 Object.defineProperty(exports, "SUPPORTED_PROVIDERS", { enumerable: true, get: function () { return openclaw_integration_js_1.SUPPORTED_PROVIDERS; } });
 //# sourceMappingURL=index.js.map

package/dist/cli/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/agent/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAsD;AAA7C,qGAAA,OAAO,OAAA;AAAE,2GAAA,aAAa,OAAA;AAG/B,+CAAmD;AAA1C,uGAAA,YAAY,OAAA;AACrB,yDAAmF;AAA1E,iHAAA,iBAAiB,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAChD,mDAA0E;AAAjE,2GAAA,cAAc,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAC1C,6CAAoD;AAA3C,4GAAA,gBAAgB,OAAA;AACzB,qEAmBmC;AAlBjC,wHAAA,aAAa,OAAA;AACb,8HAAA,mBAAmB,OAAA;AACnB,8HAAA,mBAAmB,OAAA;AACnB,oIAAA,yBAAyB,OAAA;AACzB,mIAAA,wBAAwB,OAAA;AACxB,2HAAA,gBAAgB,OAAA;AAChB,4HAAA,iBAAiB,OAAA;AACjB,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,+HAAA,oBAAoB,OAAA;AACpB,uHAAA,YAAY,OAAA;AACZ,2HAAA,gBAAgB,OAAA;AAChB,wHAAA,aAAa,OAAA;AACb,+HAAA,oBAAoB,OAAA;AACpB,iIAAA,sBAAsB,OAAA;AACtB,iIAAA,sBAAsB,OAAA;AACtB,oIAAA,yBAAyB,OAAA;AACzB,8HAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/agent/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAsD;AAA7C,qGAAA,OAAO,OAAA;AAAE,2GAAA,aAAa,OAAA;AAG/B,+CAAmD;AAA1C,uGAAA,YAAY,OAAA;AACrB,yDAAmF;AAA1E,iHAAA,iBAAiB,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAChD,mDAA0E;AAAjE,2GAAA,cAAc,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAC1C,6CAAoD;AAA3C,4GAAA,gBAAgB,OAAA;AACzB,qEAsBmC;AArBjC,wHAAA,aAAa,OAAA;AACb,8HAAA,mBAAmB,OAAA;AACnB,8HAAA,mBAAmB,OAAA;AACnB,oIAAA,yBAAyB,OAAA;AACzB,mIAAA,wBAAwB,OAAA;AACxB,2HAAA,gBAAgB,OAAA;AAChB,4HAAA,iBAAiB,OAAA;AACjB,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,+HAAA,oBAAoB,OAAA;AACpB,uHAAA,YAAY,OAAA;AACZ,2HAAA,gBAAgB,OAAA;AAChB,wHAAA,aAAa,OAAA;AACb,+HAAA,oBAAoB,OAAA;AACpB,iIAAA,sBAAsB,OAAA;AACtB,iIAAA,sBAAsB,OAAA;AACtB,oIAAA,yBAAyB,OAAA;AACzB,sIAAA,2BAA2B,OAAA;AAC3B,oIAAA,yBAAyB,OAAA;AACzB,iIAAA,sBAAsB,OAAA;AACtB,8HAAA,mBAAmB,OAAA"}

package/dist/cli/agent/openclaw-integration.d.ts

@@ -13,6 +13,11 @@ export declare const CONFIG: {
     healthCheckTimeout: number;
     containerName: string;
 };
+/**
+ * Internal cluster names to filter out from topology
+ */
+export declare const INTERNAL_CLUSTER_PREFIXES: string[];
+export declare const INTERNAL_CLUSTER_NAMES: string[];
 export interface OpenClawOptions {
     gatewayUrl?: string;
     gatewayToken?: string;
@@ -23,6 +28,10 @@ export interface OpenClawStatus {
     available: boolean;
     isLocal: boolean;
     isDocker: boolean;
+    /** Gateway is healthy but source is unknown (no CLI, no Docker container) */
+    isUnknown: boolean;
+    /** Error message explaining why available=false */
+    error?: string;
 }
 export interface ModelProviderInfo {
     provider: string | null;
@@ -39,6 +48,8 @@ export declare function isDockerOpenClawAvailable(): Promise<boolean>;
 export declare function isGatewayHealthy(): Promise<boolean>;
 /**
  * Check if local OpenClaw CLI is running (not in container)
+ * This checks if the gateway is healthy AND the openclaw CLI reports local mode.
+ * Note: This does NOT check for Docker - Docker and local can coexist.
  */
 export declare function isLocalOpenClawAvailable(): Promise<boolean>;
 /**
@@ -48,6 +59,8 @@ export declare function isLocalOpenClawAvailable(): Promise<boolean>;
 export declare function isOpenClawAvailable(): Promise<boolean>;
 /**
  * Get OpenClaw status summary
+ * Prioritizes local installation over Docker container.
+ * Returns error if gateway is healthy but source is unknown (no CLI, no Docker).
  */
 export declare function getOpenClawStatus(): Promise<OpenClawStatus>;
 /**
@@ -137,11 +150,12 @@ export declare function testOpenClawConnection(query?: string): Promise<{
  */
 export declare function getDetailedOpenClawStatus(): Promise<{
     available: boolean;
-    mode: 'docker' | 'local' | 'unavailable';
+    mode: 'docker' | 'local' | 'unknown' | 'unavailable';
     gatewayHealthy: boolean;
     modelInfo: ModelProviderInfo;
     controlUI: string;
     gatewayUrl: string;
+    error?: string;
 }>;
 /** @deprecated Use isDockerOpenClawAvailable */
 export declare const isDockerOpenClawContainerRunning: typeof isDockerOpenClawAvailable;
@@ -149,4 +163,9 @@ export declare const isDockerOpenClawContainerRunning: typeof isDockerOpenClawAv
 export declare const isOpenClawGatewayReachable: typeof isGatewayHealthy;
 /** @deprecated Use isGatewayHealthy() in a loop */
 export declare function ensureOpenClawRunning(timeoutSeconds?: number): Promise<boolean>;
+/**
+ * Print guidance for unknown gateway status
+ * Used by both /start and /openclaw status commands
+ */
+export declare function printUnknownGatewayGuidance(error: string | undefined, log: (msg: string) => void): void;
 //# sourceMappingURL=openclaw-integration.d.ts.map

package/dist/cli/agent/openclaw-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-integration.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/openclaw-integration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openclaw-integration.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/openclaw-integration.ts"],"names":[],"mappings":"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"}

package/dist/cli/agent/openclaw-integration.js

@@ -39,7 +39,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isOpenClawGatewayReachable = exports.isDockerOpenClawContainerRunning = exports.SUPPORTED_PROVIDERS = exports.OpenClawAgent = exports.CONFIG = void 0;
+exports.isOpenClawGatewayReachable = exports.isDockerOpenClawContainerRunning = exports.SUPPORTED_PROVIDERS = exports.OpenClawAgent = exports.INTERNAL_CLUSTER_NAMES = exports.INTERNAL_CLUSTER_PREFIXES = exports.CONFIG = void 0;
 exports.isDockerOpenClawAvailable = isDockerOpenClawAvailable;
 exports.isGatewayHealthy = isGatewayHealthy;
 exports.isLocalOpenClawAvailable = isLocalOpenClawAvailable;
@@ -56,6 +56,7 @@ exports.configureModelProvider = configureModelProvider;
 exports.testOpenClawConnection = testOpenClawConnection;
 exports.getDetailedOpenClawStatus = getDetailedOpenClawStatus;
 exports.ensureOpenClawRunning = ensureOpenClawRunning;
+exports.printUnknownGatewayGuidance = printUnknownGatewayGuidance;
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -72,6 +73,11 @@ exports.CONFIG = {
     healthCheckTimeout: 5000,
     containerName: 'openclaw',
 };
+/**
+ * Internal cluster names to filter out from topology
+ */
+exports.INTERNAL_CLUSTER_PREFIXES = ['metadata-mysql', 'metadata_mysql'];
+exports.INTERNAL_CLUSTER_NAMES = ['mysql'];
 // Cached runtime detection
 let cachedRuntime;
 async function getContainerRuntime() {
@@ -255,18 +261,22 @@ async function isGatewayHealthy() {
 }
 /**
  * Check if local OpenClaw CLI is running (not in container)
+ * This checks if the gateway is healthy AND the openclaw CLI reports local mode.
+ * Note: This does NOT check for Docker - Docker and local can coexist.
  */
 async function isLocalOpenClawAvailable() {
-    if (await isDockerOpenClawAvailable())
-        return false;
-    if (!(await isGatewayHealthy()))
+    // First check if gateway is healthy (fast HTTP check)
+    if (!(await isGatewayHealthy())) {
         return false;
+    }
+    // Then check if openclaw CLI reports local mode
     const result = await execCommand('openclaw', ['status', '--json'], { timeout: exports.CONFIG.healthCheckTimeout });
     if (!result.success)
         return false;
     try {
         const status = JSON.parse(result.stdout);
-        return status.gateway?.mode === 'local' && !!status.gateway?.url;
+        // Local mode can be 'local' or the gateway might just be running locally
+        return (status.gateway?.mode === 'local' || status.gateway?.mode === 'standalone') && !!status.gateway?.url;
     }
     catch {
         return false;
@@ -284,15 +294,57 @@ async function isOpenClawAvailable() {
     // Fallback: check if container is running (slower, spawns subprocess)
     return isDockerOpenClawAvailable();
 }
+/**
+ * Check if openclaw CLI binary exists
+ */
+async function isOpenClawCLIInstalled() {
+    const result = await execCommand('which', ['openclaw'], { timeout: 2000 });
+    return result.success && result.stdout.trim().length > 0;
+}
 /**
  * Get OpenClaw status summary
+ * Prioritizes local installation over Docker container.
+ * Returns error if gateway is healthy but source is unknown (no CLI, no Docker).
  */
 async function getOpenClawStatus() {
-    const [isDocker, isLocal] = await Promise.all([
-        isDockerOpenClawAvailable(),
-        isLocalOpenClawAvailable(),
-    ]);
-    return { available: isDocker || isLocal, isDocker, isLocal };
+    // Check gateway health first (fast HTTP check)
+    const gatewayHealthy = await isGatewayHealthy();
+    if (!gatewayHealthy) {
+        // Gateway not healthy - check if Docker container exists at all
+        const isDocker = await isDockerOpenClawAvailable();
+        return { available: isDocker, isDocker, isLocal: false, isUnknown: false };
+    }
+    // Gateway is healthy - determine if it's local or Docker
+    // Check for local OpenClaw CLI first (prioritize local over Docker)
+    const isLocal = await isLocalOpenClawAvailable();
+    if (isLocal) {
+        return { available: true, isDocker: false, isLocal: true, isUnknown: false };
+    }
+    // Gateway is healthy but not local - check if Docker container is running
+    const isDocker = await isDockerOpenClawAvailable();
+    if (isDocker) {
+        return { available: true, isDocker: true, isLocal: false, isUnknown: false };
+    }
+    // Gateway is healthy but we can't determine source - this is problematic
+    // Either a local gateway is running without CLI, or something else is using port 18789
+    const cliInstalled = await isOpenClawCLIInstalled();
+    if (!cliInstalled) {
+        return {
+            available: false,
+            isDocker: false,
+            isLocal: false,
+            isUnknown: true,
+            error: 'Gateway is running on port 18789 but openclaw CLI is not installed. Install the CLI or stop the gateway to use Docker.',
+        };
+    }
+    // CLI exists but couldn't get status - still problematic
+    return {
+        available: false,
+        isDocker: false,
+        isLocal: false,
+        isUnknown: true,
+        error: 'Gateway is running but unable to determine its source. Check OpenClaw installation.',
+    };
 }
 // ============================================================================
 // Agent Functions
@@ -498,15 +550,18 @@ async function testOpenClawConnection(query = 'Hello') {
  */
 async function getDetailedOpenClawStatus() {
     const status = await getOpenClawStatus();
-    const gatewayHealthy = status.available && await isGatewayHealthy();
+    // For unknown status, gateway is healthy (that's why we detected it)
+    // For unavailable, gateway is not healthy
+    const gatewayHealthy = status.isUnknown || (status.available && await isGatewayHealthy());
     const modelInfo = status.available ? await getModelProviderInfo() : { provider: null, model: null, configured: false };
     return {
         available: status.available,
-        mode: status.isDocker ? 'docker' : status.isLocal ? 'local' : 'unavailable',
+        mode: status.isUnknown ? 'unknown' : status.isDocker ? 'docker' : status.isLocal ? 'local' : 'unavailable',
         gatewayHealthy,
         modelInfo,
         controlUI: 'http://localhost:18790',
         gatewayUrl: exports.CONFIG.gatewayUrl,
+        error: status.error,
     };
 }
 // ============================================================================
@@ -522,8 +577,24 @@ async function ensureOpenClawRunning(timeoutSeconds = 30) {
     while (Date.now() < deadline) {
         if (await isGatewayHealthy())
             return true;
-        await new Promise(r => setTimeout(r, 2000));
+        await new Promise(r => setTimeout(r, 1000));
     }
     return false;
 }
+/**
+ * Print guidance for unknown gateway status
+ * Used by both /start and /openclaw status commands
+ */
+function printUnknownGatewayGuidance(error, log) {
+    log(`  Gateway detected but source is unclear.`);
+    if (error) {
+        log(`  ${error}`);
+    }
+    log('');
+    log('  Options:');
+    log('    1. Install openclaw CLI to use local gateway');
+    log('    2. Stop the gateway process to use Docker');
+    log('       Find process: ss -tlnp | grep 18789');
+    log('       Kill process: kill <PID>');
+}
 //# sourceMappingURL=openclaw-integration.js.map