@showly/mcp-server 0.4.4 → 0.4.6

package/dist/cli.d.ts

@@ -130,6 +130,17 @@ export declare function buildLoginPrompt(input: {
     userCode: string;
     expiresAt: Date;
 }): string;
+/**
+ * Extra control-plane instructions for agents that launched the device flow.
+ *
+ * The human-facing approval block is intentionally host-neutral and is often
+ * relayed verbatim. Remote agent hosts need one additional instruction that is
+ * meant for the executor, not the human: keep ownership of the foreground
+ * process and poll it until it exits. Without this, an agent can accurately
+ * relay the code, end its turn, and strand the post-approval work even though
+ * the CLI itself later receives and stores the credential successfully.
+ */
+export declare function buildRemoteAgentWaitInstruction(target: LoginTarget): string | null;
 /** Claude Code reads a `headers` map on an http MCP server entry. */
 export declare function buildClaudeCodeAuthSnippet(opts: {
     url: string;

package/dist/cli.js

@@ -454,6 +454,29 @@ export function buildLoginPrompt(input) {
         "connected until you approve, and the command can be run again.",
     ].join("\n");
 }
+/**
+ * Extra control-plane instructions for agents that launched the device flow.
+ *
+ * The human-facing approval block is intentionally host-neutral and is often
+ * relayed verbatim. Remote agent hosts need one additional instruction that is
+ * meant for the executor, not the human: keep ownership of the foreground
+ * process and poll it until it exits. Without this, an agent can accurately
+ * relay the code, end its turn, and strand the post-approval work even though
+ * the CLI itself later receives and stores the credential successfully.
+ */
+export function buildRemoteAgentWaitInstruction(target) {
+    if (target !== "openclaw" && target !== "hermes")
+        return null;
+    return [
+        "[AGENT EXECUTOR - REQUIRED]",
+        "The approval block above is an intermediate update, never the final response.",
+        "Keep this exact foreground process/session handle alive and repeatedly use your host's wait/poll action until the command exits. No new output means it is still waiting.",
+        "Do not append shell `&`, use nohup/disown, redirect this command into a detached job, or close the task that owns its session handle.",
+        "After relaying the approval URL and code, your next action in the same turn MUST be another wait/poll call on this handle. A text-only response such as `I'll keep an eye on it` ends the workflow and is a failure.",
+        "Do not ask the human to message you after approval, and do not start another login while this process is alive.",
+        "Only a terminal exit from this login command permits a final response.",
+    ].join("\n");
+}
 /** Claude Code reads a `headers` map on an http MCP server entry. */
 export function buildClaudeCodeAuthSnippet(opts) {
     return {
@@ -914,6 +937,9 @@ export async function performLogin(opts, deps = {}) {
         userCode: started.user_code,
         expiresAt,
     }));
+    const remoteAgentWaitInstruction = buildRemoteAgentWaitInstruction(opts.target);
+    if (remoteAgentWaitInstruction)
+        log(remoteAgentWaitInstruction);
     const token = await pollForDeviceToken({
         apiUrl,
         deviceCode: started.device_code,
@@ -1143,6 +1169,27 @@ export function buildLoginOutput(result, opts = {}) {
             line: "That line is the credential itself. It is printed here once, and kept out of the config file so the file stays safe to commit.",
         });
     }
+    if (result.target === "openclaw") {
+        lines.push({
+            stream: "err",
+            line: [
+                "[AGENT EXECUTOR - REQUIRED] Stay in this task: run `openclaw mcp reload`, rediscover Showly's native tools, then make real `list_projects` and `list_sites` calls.",
+                "Do not stop at Connected or tell the human to start a new task while this task can still run. A saved config or successful doctor/probe is not completion.",
+                "If the host already ended the task while approval was pending, use one fresh task as a fallback; do not repeat login.",
+            ].join("\n"),
+        });
+    }
+    if (result.target === "hermes") {
+        lines.push({
+            stream: "err",
+            line: [
+                "[AGENT EXECUTOR - REQUIRED] Activate the live Hermes MCP inventory, then verify with native `mcp__showly__list_projects` and `mcp__showly__list_sites` calls.",
+                "Use `/reload-mcp` only when the host exposes it as a real control command. Do not tell the human to run it and do not send `/reload-mcp` as an ordinary chat/model prompt.",
+                "On managed MyClaw, restart the Hermes instance/container once with the host control, open a fresh task, and make the native calls there. A new task before that restart can reuse the stale worker. Do not repeat login.",
+                "`hermes mcp test` or raw JSON-RPC proves the credential and server, not that the running agent loaded the tools.",
+            ].join("\n"),
+        });
+    }
     if (result.expiresAt) {
         lines.push({
             stream: "err",

package/manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://showly.ai/schemas/skill-manifest-v1.json",
   "name": "showly",
   "displayName": "Showly",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Deploy and manage Showly sites from inside Claude Code / Codex.",
   "homepage": "https://showly.ai/docs/mcp/overview",
   "publisher": "Showly",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@showly/mcp-server",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Connect Claude Code / Codex to the Showly MCP server — preview and deploy sites from your agent.",
   "license": "UNLICENSED",
   "type": "module",
@@ -52,7 +52,7 @@
   },
   "claude-code-skill": {
     "name": "showly",
-    "version": "0.4.4",
+    "version": "0.4.6",
     "description": "Deploy and manage Showly sites from inside Claude Code.",
     "mcp-server": {
       "url-env": "SHOWLY_MCP_URL",
@@ -65,7 +65,7 @@
   },
   "codex-plugin": {
     "name": "showly",
-    "version": "0.4.4",
+    "version": "0.4.6",
     "type": "mcp-server",
     "manifest": "manifest.json"
   },