@synap-core/cli 1.2.0 → 1.5.0

package/dist/commands/infra.js

@@ -0,0 +1,262 @@
+/**
+ * synap infra
+ *
+ * Infrastructure management via Dokploy — view servers, trigger deploys,
+ * tail logs, and sync server state into Synap entities.
+ *
+ *   synap infra               — overview: servers + services status
+ *   synap infra status        — same as above
+ *   synap infra deploy <app>  — trigger a redeploy for a named app
+ *   synap infra logs <app>    — tail logs for a service
+ *   synap infra sync          — pull Dokploy state into Synap entities
+ *   synap infra open          — open Dokploy dashboard in browser
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { execSync } from "child_process";
+import { log, banner } from "../utils/logger.js";
+function getDokployConfig() {
+    const url = process.env.DOKPLOY_URL ?? process.env.DEPLOY_DOMAIN
+        ? `https://${process.env.DEPLOY_DOMAIN}`
+        : "https://deploy.synap.live";
+    const apiKey = process.env.DOKPLOY_API_KEY ?? "";
+    if (!apiKey)
+        return null;
+    return { url, apiKey };
+}
+async function dokployFetch(path, options = {}) {
+    const config = getDokployConfig();
+    if (!config) {
+        throw new Error("DOKPLOY_API_KEY not set. Get it from the Dokploy dashboard → Settings → API Keys,\n" +
+            "  then add it to your .env or export DOKPLOY_API_KEY=<key>");
+    }
+    const res = await fetch(`${config.url}${path}`, {
+        ...options,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": config.apiKey,
+            ...options.headers,
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => res.statusText);
+        throw new Error(`Dokploy ${path}: ${res.status} ${text}`);
+    }
+    return res.json();
+}
+// ─── Status overview ─────────────────────────────────────────────────────────
+export async function infraStatus() {
+    banner();
+    const config = getDokployConfig();
+    if (!config) {
+        log.warn("Dokploy API key not configured.");
+        log.blank();
+        log.dim("1. Open https://deploy.synap.live → Settings → API Keys → Create key");
+        log.dim("2. Add to your shell:  export DOKPLOY_API_KEY=<key>");
+        log.dim("3. Or add to .env:     DOKPLOY_API_KEY=<key>");
+        log.blank();
+        log.info(`Dashboard: ${chalk.cyan("https://deploy.synap.live")}`);
+        return;
+    }
+    const spinner = ora("Fetching infrastructure status...").start();
+    try {
+        // Dokploy API: GET /api/servers and GET /api/applications
+        const [servers, apps] = await Promise.all([
+            dokployFetch("/api/server.all").catch(() => []),
+            dokployFetch("/api/application.all").catch(() => []),
+        ]);
+        spinner.stop();
+        // ── Servers ──
+        log.heading("Servers");
+        if (servers.length === 0) {
+            log.dim("  No servers connected. Add one in the Dokploy dashboard.");
+        }
+        else {
+            for (const s of servers) {
+                const dot = s.status === "active"
+                    ? chalk.green("●")
+                    : s.status === "inactive"
+                        ? chalk.red("●")
+                        : chalk.yellow("●");
+                console.log(`  ${dot} ${chalk.bold(s.name)}  ${chalk.dim(s.ip)}`);
+            }
+        }
+        log.blank();
+        // ── Services ──
+        log.heading("Services");
+        if (apps.length === 0) {
+            log.dim("  No services deployed yet.");
+        }
+        else {
+            const byServer = new Map();
+            for (const app of apps) {
+                const key = app.serverId ?? "local";
+                if (!byServer.has(key))
+                    byServer.set(key, []);
+                byServer.get(key).push(app);
+            }
+            for (const [serverId, list] of byServer) {
+                const server = servers.find((s) => s.id === serverId);
+                if (server)
+                    log.dim(`  ── ${server.name} ──`);
+                for (const app of list) {
+                    const status = app.status === "running"
+                        ? chalk.green(app.status)
+                        : app.status === "error"
+                            ? chalk.red(app.status)
+                            : chalk.yellow(app.status);
+                    console.log(`  ${chalk.bold(app.name)}  ${status}  ${chalk.dim(app.env ?? "")}`);
+                }
+            }
+        }
+        log.blank();
+        log.dim(`Dashboard: ${chalk.cyan(config.url)}`);
+        log.dim("To deploy: synap infra deploy <app-name>");
+        log.dim("To tail logs: synap infra logs <app-name>");
+    }
+    catch (err) {
+        spinner.fail("Failed to reach Dokploy");
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(msg);
+    }
+}
+// ─── Deploy ──────────────────────────────────────────────────────────────────
+export async function infraDeploy(appName) {
+    const spinner = ora(`Triggering deploy for ${chalk.bold(appName)}...`).start();
+    try {
+        // List apps, find by name
+        const apps = await dokployFetch("/api/application.all");
+        const match = apps.find((a) => a.name.toLowerCase() === appName.toLowerCase() ||
+            a.appName?.toLowerCase() === appName.toLowerCase());
+        if (!match) {
+            spinner.fail(`App not found: ${appName}`);
+            log.blank();
+            log.dim("Available apps:");
+            for (const a of apps)
+                log.dim(`  • ${a.name}`);
+            return;
+        }
+        await dokployFetch(`/api/application.deploy`, {
+            method: "POST",
+            body: JSON.stringify({ applicationId: match.id }),
+        });
+        spinner.succeed(`Deploy triggered for ${chalk.bold(match.name)}`);
+        log.dim(`Watch progress: synap infra logs ${appName}`);
+    }
+    catch (err) {
+        spinner.fail("Deploy failed");
+        log.error(err instanceof Error ? err.message : String(err));
+    }
+}
+// ─── Logs ────────────────────────────────────────────────────────────────────
+export async function infraLogs(appName, opts) {
+    try {
+        const apps = await dokployFetch("/api/application.all");
+        const match = apps.find((a) => a.name.toLowerCase() === appName.toLowerCase() ||
+            a.appName?.toLowerCase() === appName.toLowerCase());
+        if (!match) {
+            log.error(`App not found: ${appName}`);
+            log.blank();
+            log.dim("Available apps:");
+            for (const a of apps)
+                log.dim(`  • ${a.name}`);
+            return;
+        }
+        // Use docker logs via container name (Dokploy uses appName as container name)
+        const containerName = match.appName ?? match.name;
+        const tail = opts.lines ?? 100;
+        const followFlag = opts.follow ? "-f" : "";
+        const cmd = `docker logs --tail ${tail} ${followFlag} ${containerName}`;
+        log.dim(`> ${cmd}`);
+        log.blank();
+        execSync(cmd, { stdio: "inherit" });
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : String(err));
+    }
+}
+// ─── Sync ─────────────────────────────────────────────────────────────────────
+export async function infraSync(podUrl, apiKey) {
+    const spinner = ora("Syncing Dokploy state into Synap entities...").start();
+    try {
+        const [servers, apps] = await Promise.all([
+            dokployFetch("/api/server.all"),
+            dokployFetch("/api/application.all"),
+        ]);
+        spinner.text = `Upserting ${servers.length} servers + ${apps.length} deployments...`;
+        // Push to Synap Hub Protocol
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        };
+        let created = 0;
+        let updated = 0;
+        for (const s of servers) {
+            const res = await fetch(`${podUrl}/api/hub/entities/upsert`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    profileSlug: "server",
+                    dedupeKey: `dokploy:server:${s.id}`,
+                    title: s.name,
+                    properties: {
+                        ip: s.ip,
+                        status: s.status === "active" ? "online" : "offline",
+                        region: s.region ?? "",
+                        dokployServerId: s.id,
+                    },
+                }),
+            });
+            if (res.ok) {
+                const { created: c } = await res.json();
+                c ? created++ : updated++;
+            }
+        }
+        for (const app of apps) {
+            const res = await fetch(`${podUrl}/api/hub/entities/upsert`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    profileSlug: "deployment",
+                    dedupeKey: `dokploy:app:${app.id}`,
+                    title: app.name,
+                    properties: {
+                        deployStatus: app.status,
+                        env: app.env ?? "production",
+                        url: app.domain ? `https://${app.domain}` : "",
+                        image: app.image ?? "",
+                        dokployAppId: app.id,
+                    },
+                }),
+            });
+            if (res.ok) {
+                const { created: c } = await res.json();
+                c ? created++ : updated++;
+            }
+        }
+        spinner.succeed(`Sync complete — ${chalk.green(created)} created, ${chalk.blue(updated)} updated`);
+    }
+    catch (err) {
+        spinner.fail("Sync failed");
+        log.error(err instanceof Error ? err.message : String(err));
+    }
+}
+// ─── Open dashboard ──────────────────────────────────────────────────────────
+export function infraOpen() {
+    const config = getDokployConfig();
+    const url = config?.url ?? "https://deploy.synap.live";
+    try {
+        const platform = process.platform;
+        const cmd = platform === "darwin"
+            ? "open"
+            : platform === "win32"
+                ? "start"
+                : "xdg-open";
+        execSync(`${cmd} ${url}`);
+        log.success(`Opening ${url}`);
+    }
+    catch {
+        log.info(`Dashboard: ${chalk.cyan(url)}`);
+    }
+}
+//# sourceMappingURL=infra.js.map

package/dist/commands/infra.js.map

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

package/dist/commands/init.js

@@ -19,6 +19,33 @@ import { seedAgentEntities } from "../lib/seed.js";
 import { login, isLoggedIn, listPods, getStoredToken, waitForPodCallback } from "../lib/auth.js";
 export async function init(opts) {
     banner();
+    // ── Pre-flight: "no pod anywhere" gate ──────────────────────────────────
+    // Keep this CLI laptop/agent-focused. If the user ran `synap init` without
+    // any signal of an existing pod, point them at the two supported ways to
+    // get one (self-host via ./synap install on a server, or a managed pod on
+    // synap.live) and exit. This replaces silent failure / interactive
+    // provisioning when there's nothing to connect to.
+    //
+    // A --pod-url flag that's explicitly unreachable is a separate diagnostic
+    // (handled below once checkPodHealth has confirmed).
+    if (!opts.podUrl) {
+        if (await hasAnyPodSignal()) {
+            // fall through into the normal flow
+        }
+        else {
+            printNoPodInstructions();
+            process.exit(2);
+        }
+    }
+    else {
+        // Explicit URL was passed — probe it before letting downstream assume
+        // reachability. Fail loud with a helpful hint instead of silent 500s.
+        const probe = await checkPodHealth(opts.podUrl);
+        if (!probe.healthy) {
+            printUnreachablePodInstructions(opts.podUrl);
+            process.exit(2);
+        }
+    }
     // ── Auto-detect environment ─────────────────────────────────────────────
     const oc = detectOpenClaw();
     const isServer = detectServer();
@@ -524,10 +551,36 @@ async function podInstallLocalStep(opts) {
     if (resources.ramFree < 1500) {
         log.warn(`Low RAM (${resources.ramFree}MB free). Synap needs ~1.5GB. Consider managed hosting.`);
     }
+    const { installDomain } = await prompts({
+        type: "text",
+        name: "installDomain",
+        message: "Domain for this pod (use localhost for local setup):",
+        initial: "localhost",
+    });
+    if (!installDomain)
+        return null;
+    let installEmail = "";
+    if (installDomain !== "localhost") {
+        const emailPrompt = await prompts({
+            type: "text",
+            name: "installEmail",
+            message: "Email for Let's Encrypt SSL certificates:",
+        });
+        installEmail = emailPrompt.installEmail ?? "";
+        if (!installEmail) {
+            log.error("Email is required for non-localhost domains.");
+            return null;
+        }
+    }
+    const escapedDomain = String(installDomain).replace(/'/g, "'\\''");
+    const escapedEmail = String(installEmail).replace(/'/g, "'\\''");
+    const installCmd = installDomain === "localhost"
+        ? `curl -fsSL https://raw.githubusercontent.com/Synap-core/backend/main/install.sh | bash -s -- --domain '${escapedDomain}'`
+        : `curl -fsSL https://raw.githubusercontent.com/Synap-core/backend/main/install.sh | bash -s -- --domain '${escapedDomain}' --email '${escapedEmail}'`;
     log.blank();
     log.info("Install Synap pod with:");
     log.blank();
-    console.log(chalk.cyan("  curl -fsSL https://raw.githubusercontent.com/Synap-core/backend/main/install.sh | bash"));
+    console.log(chalk.cyan(`  ${installCmd}`));
     log.blank();
     const { proceed } = await prompts({
         type: "confirm",
@@ -537,7 +590,7 @@ async function podInstallLocalStep(opts) {
     });
     if (proceed) {
         try {
-            execSync("curl -fsSL https://raw.githubusercontent.com/Synap-core/backend/main/install.sh | bash", { stdio: "inherit" });
+            execSync(installCmd, { stdio: "inherit" });
             return "http://localhost:4000";
         }
         catch {
@@ -816,8 +869,53 @@ export async function isStep(podUrl, apiKey, openclawFound) {
     // 3. Configure OpenClaw provider (if found and IS is active)
     if (openclawFound && isActive) {
         const ocRuntime = detectOpenClaw();
-        // Only write local config if OpenClaw has a local config file to write to
-        if (ocRuntime.runtime !== "docker") {
+        if (ocRuntime.runtime === "docker") {
+            // Docker path: write via openclaw config set
+            const containerName = ocRuntime.containerName ?? "openclaw";
+            const { configureOc } = await prompts({
+                type: "confirm",
+                name: "configureOc",
+                message: "Configure Synap IS as OpenClaw AI provider?",
+                initial: true,
+            });
+            if (configureOc) {
+                const synapProvider = {
+                    baseUrl: `${podUrl}/v1`,
+                    api: "openai-completions",
+                    apiKey,
+                    models: [
+                        { id: "synap/auto", name: "Synap Auto", contextWindow: 200000, maxTokens: 8192 },
+                        { id: "synap/balanced", name: "Synap Balanced", contextWindow: 131072, maxTokens: 8192 },
+                        { id: "synap/advanced", name: "Synap Advanced", contextWindow: 200000, maxTokens: 8192 },
+                    ],
+                };
+                const spinner = ora("Writing Synap IS provider to OpenClaw config...").start();
+                try {
+                    execSync(`docker exec ${containerName} openclaw config set models.providers.synap ${JSON.stringify(JSON.stringify(synapProvider))}`, { stdio: "pipe", timeout: 15000 });
+                    spinner.succeed("Synap IS registered as OpenClaw provider");
+                    log.dim("Available models: synap/auto, synap/balanced, synap/advanced");
+                    // Restart to apply (Docker has no hot reload)
+                    try {
+                        execSync(`docker restart ${containerName}`, { stdio: "pipe", timeout: 30000 });
+                        log.dim("Container restarted to pick up new config");
+                    }
+                    catch {
+                        log.warn("Restart failed — run manually: docker restart openclaw");
+                    }
+                }
+                catch (err) {
+                    const stderr = err.stderr?.toString().trim();
+                    spinner.fail("Failed to set Synap IS provider");
+                    if (stderr)
+                        log.dim(stderr);
+                    log.dim("Run manually:");
+                    log.dim(`  docker exec ${containerName} openclaw config set models.providers.synap.baseUrl ${podUrl}/v1`);
+                    log.dim(`  docker exec ${containerName} openclaw config set models.providers.synap.api openai-completions`);
+                }
+            }
+        }
+        else {
+            // Local install path: write to config file directly
             const { configureOc } = await prompts({
                 type: "confirm",
                 name: "configureOc",
@@ -840,11 +938,6 @@ export async function isStep(podUrl, apiKey, openclawFound) {
                 log.success("Synap IS configured as OpenClaw provider — restart OpenClaw to apply");
             }
         }
-        else {
-            // Docker runtime — can't write config from host, tell user the command
-            log.success("IS is active. To configure it as OpenClaw provider:");
-            log.dim(`  docker exec ${ocRuntime.containerName ?? "openclaw"} openclaw config set models.providers.synap.baseUrl ${podUrl}/v1`);
-        }
     }
 }
 function printSummary(podUrl, openclawConnected) {
@@ -880,7 +973,7 @@ async function loginAndSelectPod() {
     // Check if already logged in
     const authStatus = await isLoggedIn();
     if (!authStatus.valid) {
-        log.info("Opening browser to sign in...");
+        log.info("Opening browser to sign in and select your pod...");
         const spinner = ora("Waiting for browser authentication...").start();
         const creds = await login();
         if (!creds) {
@@ -889,6 +982,17 @@ async function loginAndSelectPod() {
             return null;
         }
         spinner.succeed(`Authenticated as ${creds.email}`);
+        // If the web flow already performed pod selection, use that result directly.
+        if (creds.podUrl && creds.podId) {
+            const healthSpinner = ora("Checking pod health...").start();
+            const status = await checkPodHealth(creds.podUrl);
+            if (status.healthy) {
+                healthSpinner.succeed(`Pod ready at ${creds.podUrl}`);
+                return { url: creds.podUrl, podId: creds.podId };
+            }
+            healthSpinner.warn(`Pod selected (${creds.podUrl}) but not yet reachable — may still be provisioning`);
+            return { url: creds.podUrl, podId: creds.podId };
+        }
     }
     else {
         log.success(`Already logged in as ${authStatus.email}`);
@@ -896,6 +1000,10 @@ async function loginAndSelectPod() {
     const token = getStoredToken();
     if (!token)
         return null;
+    // Short-circuit if credentials already carry a pod from a previous web-based selection.
+    if (token.podUrl && token.podId) {
+        return { url: token.podUrl, podId: token.podId };
+    }
     // List pods
     const podsSpinner = ora("Fetching your pods...").start();
     try {
@@ -974,6 +1082,76 @@ function detectServer() {
         return false;
     }
 }
+/**
+ * Does the environment carry ANY signal that a Synap pod exists somewhere?
+ * Used by `init` to decide whether to run the full flow or short-circuit
+ * with a "no pod detected" instruction message.
+ *
+ * Treat these as signals (in cheap-to-expensive order):
+ *   1. SYNAP_POD_URL env var
+ *   2. A stored ~/.synap/pod-config.json from a previous run
+ *   3. A running pod detected on this machine
+ *   4. An OpenClaw install that already has synap.podUrl configured
+ */
+async function hasAnyPodSignal() {
+    if (process.env.SYNAP_POD_URL)
+        return true;
+    if (getLocalPodConfig()?.podUrl)
+        return true;
+    // OpenClaw may already carry a pod URL in its config — respect that.
+    try {
+        const oc = detectOpenClaw();
+        const ocSynap = oc.config?.synap;
+        if (typeof ocSynap?.podUrl === "string" && ocSynap.podUrl.length > 0)
+            return true;
+    }
+    catch {
+        // ignore — detection is best-effort
+    }
+    // Last: probe the local machine. This is the expensive step.
+    const local = await detectLocalPod();
+    return Boolean(local);
+}
+function printNoPodInstructions() {
+    const line = "─".repeat(63);
+    console.log(`
+┌${line}┐
+│ No Synap pod detected.                                        │
+│                                                               │
+│ You need a running pod before using @synap/cli init.          │
+│                                                               │
+│ Options:                                                      │
+│                                                               │
+│   1. Self-host on a server (free):                            │
+│      On your server, run:                                     │
+│        curl -fsSL https://synap.live/install.sh | bash        │
+│      Then come back and run:                                  │
+│        npx @synap-core/cli init --pod-url https://your-pod... │
+│                                                               │
+│   2. Use a hosted pod ($):                                    │
+│      Sign up at https://synap.live                            │
+│      Then run:                                                │
+│        npx @synap-core/cli init --pod-url <your-pod-url>      │
+│                                                               │
+│   3. Already running locally? Pass --pod-url:                 │
+│        npx @synap-core/cli init --pod-url http://localhost:4000 │
+└${line}┘
+`);
+}
+function printUnreachablePodInstructions(podUrl) {
+    console.log("");
+    log.error(`Pod at ${podUrl} is not reachable.`);
+    log.blank();
+    log.info("Checklist:");
+    log.dim("  - Is the pod URL correct? (scheme + host + port)");
+    log.dim("  - Is the pod container running? On the server: ./synap health");
+    log.dim("  - Is there a firewall or reverse proxy in the way?");
+    log.dim("  - For localhost setups, did you start the stack? ./synap start");
+    log.blank();
+    log.info("Once the pod is reachable, re-run:");
+    log.dim(`  npx @synap-core/cli init --pod-url ${podUrl}`);
+    log.blank();
+}
 /**
  * Probe the local machine for a running Synap pod.
  * Returns the best URL candidate if found, null otherwise.