openpalm 0.3.4 → 0.4.0

package/dist/openpalm.js

@@ -7553,6 +7553,39 @@ env:
     required: false
 `;
 
+// packages/lib/assets/channels/mcp.yaml
+var mcp_default = `name: MCP
+description: Expose your assistant as an MCP tool server for AI clients and IDE integrations
+containerPort: 8187
+rewritePath: /mcp
+sharedSecretEnv: CHANNEL_MCP_SECRET
+env:
+  - name: MCP_BEARER_TOKEN
+    description: Optional bearer token for authenticating MCP clients
+    required: false
+  - name: CHANNEL_MCP_SECRET
+    description: HMAC signing key for gateway communication. Auto-generated if left blank.
+    required: false
+`;
+
+// packages/lib/assets/channels/a2a.yaml
+var a2a_default = `name: A2A
+description: Expose your assistant as an A2A agent for agent-to-agent communication
+containerPort: 8188
+rewritePath: /a2a
+sharedSecretEnv: CHANNEL_A2A_SECRET
+env:
+  - name: A2A_BEARER_TOKEN
+    description: Optional bearer token for authenticating A2A clients
+    required: false
+  - name: A2A_PUBLIC_URL
+    description: Public URL advertised in the Agent Card
+    required: false
+  - name: CHANNEL_A2A_SECRET
+    description: HMAC signing key for gateway communication. Auto-generated if left blank.
+    required: false
+`;
+
 // packages/lib/assets/channels/index.ts
 function parseBuiltInChannel(raw, source) {
   const parsed = parseYamlDocument(raw);
@@ -7584,7 +7617,9 @@ var BUILTIN_CHANNELS = Object.fromEntries([
   [chat_default, "chat.yaml"],
   [discord_default, "discord.yaml"],
   [voice_default, "voice.yaml"],
-  [telegram_default, "telegram.yaml"]
+  [telegram_default, "telegram.yaml"],
+  [mcp_default, "mcp.yaml"],
+  [a2a_default, "a2a.yaml"]
 ].map(([raw, source]) => {
   const def = parseBuiltInChannel(raw, source);
   return [def.name.toLowerCase(), def];
@@ -7618,9 +7653,9 @@ async function checkDiskSpace() {
   } catch {}
   return null;
 }
-async function checkPort80() {
+async function checkPort(port = 80) {
   try {
-    const lsof = Bun.spawn(["lsof", "-iTCP:80", "-sTCP:LISTEN", "-P", "-n"], {
+    const lsof = Bun.spawn(["lsof", `-iTCP:${port}`, "-sTCP:LISTEN", "-P", "-n"], {
       stdout: "pipe",
       stderr: "ignore"
     });
@@ -7631,8 +7666,8 @@ async function checkPort80() {
 `).slice(0, 3).join(`
 `);
       return {
-        message: "Port 80 is already in use by another process.",
-        detail: `OpenPalm needs port 80 for its web interface.
+        message: `Port ${port} is already in use by another process.`,
+        detail: `OpenPalm needs port ${port} for its web interface.
 ${lines}`
       };
     }
@@ -7644,10 +7679,10 @@ ${lines}`
       });
       await ss.exited;
       const output = await new Response(ss.stdout).text();
-      if (output.includes(":80 ")) {
+      if (output.includes(`:${port} `)) {
         return {
-          message: "Port 80 is already in use by another process.",
-          detail: "OpenPalm needs port 80 for its web interface."
+          message: `Port ${port} is already in use by another process.`,
+          detail: `OpenPalm needs port ${port} for its web interface.`
         };
       }
     } catch {}
@@ -7677,10 +7712,10 @@ async function checkDaemonRunning(bin, platform) {
   }
   return null;
 }
-async function runPreflightChecks(bin, platform) {
+async function runPreflightChecks(bin, platform, port = 80) {
   const results = await Promise.all([
     checkDiskSpace(),
-    checkPort80(),
+    checkPort(port),
     checkDaemonRunning(bin, platform)
   ]);
   return results.filter((w) => w !== null);
@@ -7822,6 +7857,23 @@ async function confirm(prompt) {
 }
 
 // packages/cli/src/commands/install.ts
+function reportIssueUrl(context) {
+  const title = encodeURIComponent(`Install failure: ${context.error.slice(0, 80)}`);
+  const body = encodeURIComponent(`## Environment
+` + `- OS: ${context.os}
+` + `- Arch: ${context.arch}
+` + `- Runtime: ${context.runtime}
+
+` + `## Error
+\`\`\`
+${context.error}
+\`\`\`
+
+` + `## Steps to Reproduce
+1. Ran \`openpalm install\`
+`);
+  return `https://github.com/itlackey/openpalm/issues/new?title=${title}&body=${body}`;
+}
 async function install(options) {
   log(bold(`
 OpenPalm Installation
@@ -7835,10 +7887,14 @@ OpenPalm Installation
   const platform = options.runtime ?? await detectRuntime(os);
   if (!platform) {
     error(noRuntimeGuidance(os));
+    info("");
+    info("  If this keeps happening, report the issue:");
+    info(`    ${cyan(reportIssueUrl({ os, arch, runtime: "none", error: "No container runtime found" }))}`);
     process.exit(1);
   }
   const { bin, subcommand } = resolveComposeBin(platform);
-  const preflightWarnings = await runPreflightChecks(bin, platform);
+  const ingressPort = options.port ?? 80;
+  const preflightWarnings = await runPreflightChecks(bin, platform, ingressPort);
   for (const w of preflightWarnings) {
     warn(w.message);
     if (w.detail) {
@@ -7853,6 +7909,13 @@ OpenPalm Installation
   if (daemonWarning) {
     process.exit(1);
   }
+  const portWarning = preflightWarnings.find((w) => w.message.includes("already in use"));
+  if (portWarning) {
+    if (!options.port) {
+      error("Port 80 is required but already in use. Use --port to specify an alternative.");
+    }
+    process.exit(1);
+  }
   const isValid = await validateRuntime(bin, subcommand);
   if (!isValid) {
     error(noComposeGuidance(platform));
@@ -7939,12 +8002,9 @@ XDG paths:`));
   }
   if (generatedAdminToken) {
     log("");
-    log(bold(green("  YOUR ADMIN PASSWORD (save this!)")));
-    log("");
-    log(`  ${yellow(generatedAdminToken)}`);
-    log("");
-    info("  You will need this password to log in to the admin dashboard.");
-    info(`  It is also saved in: ${dim(stateEnvFile)}`);
+    info("  A temporary admin token has been generated.");
+    info("  You will choose your own password in the setup wizard.");
+    info(`  Temporary token saved in: ${dim(stateEnvFile)}`);
     log("");
   }
   const socketPath = resolveSocketPath(platform, os);
@@ -7966,7 +8026,8 @@ XDG paths:`));
     ["OPENPALM_WORK_HOME", normPath(resolveWorkHome())],
     ["OPENPALM_UID", String(process.getuid?.() ?? 1000)],
     ["OPENPALM_GID", String(process.getgid?.() ?? 1000)],
-    ["OPENPALM_ENABLED_CHANNELS", ""]
+    ["OPENPALM_ENABLED_CHANNELS", ""],
+    ["OPENPALM_INGRESS_PORT", String(ingressPort)]
   ]);
   await Bun.write(cwdEnvPath, Bun.file(stateEnvFile));
   const spin4 = spinner("Seeding configuration files...");
@@ -7992,7 +8053,7 @@ openpalm uninstall
       http: {
         servers: {
           main: {
-            listen: [":80"],
+            listen: [`:${ingressPort}`],
             routes: [
               {
                 match: [{ path: ["/api*"] }],
@@ -8024,11 +8085,6 @@ openpalm uninstall
 `;
   const caddyJsonPath = join4(xdg.state, "caddy.json");
   await writeFile(caddyJsonPath, minimalCaddyJson, "utf8");
-  const fallbackCaddyJsonPath = join4(xdg.state, "caddy-fallback.json");
-  const fallbackCaddyJsonExists = await Bun.file(fallbackCaddyJsonPath).exists();
-  if (!fallbackCaddyJsonExists) {
-    await writeFile(fallbackCaddyJsonPath, minimalCaddyJson, "utf8");
-  }
   log(bold(`
 Downloading OpenPalm services (this may take a few minutes on first install)...
 `));
@@ -8037,7 +8093,7 @@ Downloading OpenPalm services (this may take a few minutes on first install)...
     image: caddy:2-alpine
     restart: unless-stopped
     ports:
-      - "\${OPENPALM_INGRESS_BIND_ADDRESS:-127.0.0.1}:80:80"
+      - "\${OPENPALM_INGRESS_BIND_ADDRESS:-127.0.0.1}:\${OPENPALM_INGRESS_PORT:-80}:80"
       - "\${OPENPALM_INGRESS_BIND_ADDRESS:-127.0.0.1}:443:443"
     volumes:
       - \${OPENPALM_STATE_HOME}/caddy.json:/etc/caddy/caddy.json:ro
@@ -8049,6 +8105,8 @@ Downloading OpenPalm services (this may take a few minutes on first install)...
   admin:
     image: \${OPENPALM_IMAGE_NAMESPACE:-openpalm}/admin:\${OPENPALM_IMAGE_TAG:-latest}
     restart: unless-stopped
+    ports:
+      - "127.0.0.1:8100:8100"
     env_file:
       - \${OPENPALM_STATE_HOME}/system.env
     environment:
@@ -8076,15 +8134,9 @@ Downloading OpenPalm services (this may take a few minutes on first install)...
       start_period: 10s
 
 networks:
-  channel_net:
   assistant_net:
 `;
   await writeFile(stateComposeFile, minimalCompose, "utf8");
-  const fallbackComposePath = join4(xdg.state, "docker-compose-fallback.yml");
-  const fallbackComposeExists = await Bun.file(fallbackComposePath).exists();
-  if (!fallbackComposeExists) {
-    await writeFile(fallbackComposePath, minimalCompose, "utf8");
-  }
   const composeConfig = {
     bin,
     subcommand,
@@ -8106,14 +8158,19 @@ networks:
     info("  Or manually pull and then start:");
     info(`    ${cyan(`${bin} ${subcommand} --env-file ${stateEnvFile} -f ${stateComposeFile} pull`)}`);
     info(`    ${cyan(`${bin} ${subcommand} --env-file ${stateEnvFile} -f ${stateComposeFile} up -d`)}`);
+    info("");
+    info("  If this keeps happening, report the issue:");
+    info(`    ${cyan(reportIssueUrl({ os, arch, runtime: platform, error: String(pullErr) }))}`);
     log("");
     process.exit(1);
   }
   const spin7 = spinner("Starting core services...");
   await composeUp(composeConfig, coreServices, { detach: true });
   spin7.stop(green("Core services started"));
-  const adminUrl = "http://localhost";
+  let adminUrl = ingressPort === 80 ? "http://localhost" : `http://localhost:${ingressPort}`;
+  const adminDirectUrl = "http://localhost:8100";
   const healthUrl = `${adminUrl}/setup/status`;
+  const healthDirectUrl = `${adminDirectUrl}/setup/status`;
   const spin8 = spinner("Waiting for admin interface...");
   let healthy = false;
   let delay = 1000;
@@ -8126,7 +8183,16 @@ networks:
         healthy = true;
         break;
       }
-    } catch {}
+    } catch {
+      try {
+        const directResponse = await fetch(healthDirectUrl, { signal: AbortSignal.timeout(3000) });
+        if (directResponse.ok) {
+          healthy = true;
+          adminUrl = adminDirectUrl;
+          break;
+        }
+      } catch {}
+    }
     await Bun.sleep(delay);
     delay = Math.min(delay * 1.5, maxDelay);
   }
@@ -8151,17 +8217,15 @@ networks:
     log(bold(green("  OpenPalm setup wizard is ready!")));
     log("");
     info(`  Setup wizard: ${cyan(adminUrl)}`);
+    info(`  Direct admin: ${cyan("http://localhost:8100")} (if port 80 is blocked)`);
     log("");
-    if (generatedAdminToken) {
-      info(`  Admin password: ${yellow(generatedAdminToken)}`);
-      log("");
-    }
     log(bold("  What happens next:"));
     info("    1. The setup wizard opens in your browser");
-    info("    2. Enter your AI provider API key (e.g. from console.anthropic.com)");
-    info("    3. The wizard will download and start remaining services automatically");
-    info("    4. Pick which channels to enable (chat, Discord, etc.)");
-    info("    5. Done! Start chatting with your assistant");
+    info("    2. Create your admin password and profile");
+    info("    3. Enter your AI provider API key (e.g. from console.anthropic.com)");
+    info("    4. The wizard will download and start remaining services automatically");
+    info("    5. Pick which channels to enable (chat, Discord, etc.)");
+    info("    6. Done! Start chatting with your assistant");
     log("");
     if (!options.noOpen) {
       info("  Opening setup wizard in your browser...");
@@ -8186,6 +8250,12 @@ networks:
     info("     - Make sure port 80 is not used by another service");
     info("     - Restart Docker/Podman and try again");
     info("     - Check that you have internet access (images need to download)");
+    log("");
+    info("  5. If the browser doesn't open, try the direct admin URL:");
+    info(`     ${cyan("http://localhost:8100")}`);
+    log("");
+    info("  6. Still stuck? Report the issue:");
+    info(`     ${cyan(reportIssueUrl({ os, arch, runtime: platform, error: "Health check timeout after 3 minutes" }))}`);
   }
   log("");
   log(bold("  Useful commands:"));
@@ -8622,7 +8692,7 @@ function createChannel(args) {
   }
   if (name.length > 32)
     throw new Error("Error: channel name must be 32 characters or fewer");
-  const reserved = new Set(["chat", "discord", "voice", "telegram", "webhook"]);
+  const reserved = new Set(["chat", "discord", "voice", "telegram", "webhook", "api", "mcp", "a2a"]);
   if (reserved.has(name)) {
     throw new Error(`Error: "${name}" is an existing built-in channel. Choose a different name.`);
   }
@@ -9131,7 +9201,7 @@ async function automation(subcommand, args) {
 // packages/cli/package.json
 var package_default = {
   name: "openpalm",
-  version: "0.3.4",
+  version: "0.4.0",
   description: "CLI tool for installing and managing an OpenPalm stack",
   type: "module",
   license: "MIT",
@@ -9203,6 +9273,7 @@ function printHelp() {
   log("  --no-open                           Don't auto-open browser");
   log("  --ref <branch|tag>                  Git ref for asset download");
   log("  --force                             Overwrite existing installation");
+  log("  --port <number>                     Use alternative port (default: 80)");
   log("");
   log(bold("Uninstall options:"));
   log("  --runtime <docker|podman|orbstack>  Force container runtime");
@@ -9243,7 +9314,7 @@ function getPositionalArgs(args) {
   while (i < args.length) {
     if (args[i].startsWith("--")) {
       const flagName = args[i].slice(2);
-      if (["runtime", "ref", "plugin"].includes(flagName)) {
+      if (["runtime", "ref", "plugin", "port"].includes(flagName)) {
         i += 2;
       } else {
         i += 1;
@@ -9274,11 +9345,18 @@ async function main() {
           error(`Invalid runtime "${runtimeArg}". Must be one of: ${VALID_RUNTIMES.join(", ")}`);
           process.exit(1);
         }
+        const portArg = parseArg(args, "port");
+        const port = portArg ? Number(portArg) : undefined;
+        if (portArg && (!port || port < 1 || port > 65535)) {
+          error(`Invalid port "${portArg}". Must be a number between 1 and 65535.`);
+          process.exit(1);
+        }
         const options = {
           runtime: runtimeArg,
           noOpen: hasFlag(args, "no-open"),
           ref: parseArg(args, "ref"),
-          force: hasFlag(args, "force")
+          force: hasFlag(args, "force"),
+          port
         };
         await install(options);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpalm",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "CLI tool for installing and managing an OpenPalm stack",
   "type": "module",
   "license": "MIT",