@synap-core/cli 1.11.0 → 1.12.2

package/dist/commands/mcp.js

@@ -1,32 +1,23 @@
 /**
- * `synap mcp` — the MCP front door.
+ * `synap mcp` — the MCP front door. Two lanes:
  *
- * The Synap pod exposes an MCP server at `${podUrl}/mcp` (Bearer-authed). This
- * command group is the turnkey funnel for pointing ANY MCP client at it:
+ *   1. Web AI (Cloud MCP / OAuth) — control plane `${cp}/mcp` (managed:
+ *      https://api.synap.live/mcp). claude.ai's connector UI is OAuth-only; use
+ *      `synap mcp connect-claude` to print the URL (no key mint, no file write).
+ *   2. IDE / file-configurable — pod `${podUrl}/mcp` (Bearer). Needs a pod +
+ *      key. `synap mcp connect <client>` writes client config; `synap mcp url`
+ *      prints URL + key for header-based UIs (ChatGPT, Raycast, …).
  *
- *   synap mcp url      — print a ready-to-paste connection (URL + key + snippets)
- *                        for UI-only clients that accept a custom header (e.g.
- *                        Raycast) and for clients that need the raw values to
- *                        wire up by hand. claude.ai's connector UI does NOT
- *                        currently accept a bearer token here — see the note
- *                        printed by this command.
- *   synap mcp verify   — health-check: is /mcp reachable and is the key valid?
- *   synap mcp connect  — alias of `synap connect` for file-configurable clients
- *                        (Claude Code, Cursor, Desktop, …) — writes the config.
- *   synap mcp connect-claude — print the claude.ai (web) OAuth connection
- *                        steps. claude.ai's connector UI is OAuth-only (no
- *                        header field), so this prints paste-ready values
- *                        instead of writing a file — claude.ai + the control
- *                        plane drive the actual OAuth handshake.
- *
- * For file-configurable clients, prefer `synap mcp connect <client>` (it mints a
- * dedicated agent key + writes the client's config). `synap mcp url` is the
- * escape hatch for clients you must configure by hand in a UI.
+ *   synap mcp url            — paste-ready pod MCP connection (URL + key)
+ *   synap mcp verify         — health-check pod /mcp + key
+ *   synap mcp connect        — write MCP config for IDE/desktop clients
+ *   synap mcp connect-claude — print Cloud MCP OAuth URL for claude.ai (web)
  */
 import chalk from "chalk";
 import { resolveHubConfig } from "../lib/hub-client.js";
 import { buildMcpUrl, provisionAgentKey, enrollAgentIfNeeded, } from "../lib/targets.js";
 import { log } from "../utils/logger.js";
+import { printMcpConnection, redactKey, writeMcpSnippetFiles, MCP_KEY_ENV } from "../lib/mcp-snippets.js";
 /** Resolve the scoped MCP URL + the lenses from flags.
  *
  * Default is POD-WIDE: a workspace is a lens, not a container, so we do NOT
@@ -93,35 +84,7 @@ export async function mcpUrl(opts) {
             }, null, 2));
             return;
         }
-        const mcpServers = {
-            mcpServers: {
-                synap: { url, headers: { Authorization: `Bearer ${hubApiKey}` } },
-            },
-        };
-        const mcpRemote = {
-            mcpServers: {
-                synap: {
-                    command: "npx",
-                    args: ["mcp-remote", url, "--header", `Authorization: Bearer ${hubApiKey}`],
-                },
-            },
-        };
-        log.heading("\nSynap MCP connection");
-        console.log(`  ${chalk.dim("URL")}      ${url}`);
-        console.log(`  ${chalk.dim("Header")}   Authorization: Bearer ${hubApiKey}`);
-        console.log(`  ${chalk.dim("Agent")}    ${agentUserId}${workspaceId ? chalk.dim(` · workspace ${workspaceId}`) : chalk.dim(" · pod-wide")}${projectId ? chalk.dim(` · project ${projectId}`) : ""}`);
-        console.log(chalk.bold("\nClaude Code"));
-        console.log(chalk.cyan(`  claude mcp add --transport http synap ${url} \\\n    --header "Authorization: Bearer ${hubApiKey}" --scope user`));
-        console.log(chalk.bold("\nCursor / VS Code / native-HTTP clients (mcp.json)"));
-        console.log(chalk.dim(JSON.stringify(mcpServers, null, 2)));
-        console.log(chalk.bold("\nClaude Desktop / stdio-only clients (mcp-remote bridge)"));
-        console.log(chalk.dim(JSON.stringify(mcpRemote, null, 2)));
-        console.log(chalk.bold("\nUI clients that accept an API key / custom header (ChatGPT, Raycast, …)"));
-        console.log(`  Paste the URL above and add the Authorization header.`);
-        console.log(chalk.dim("  Raycast: run “Install MCP Server” → transport HTTP → paste the URL + a “Authorization: Bearer …” header."));
-        console.log(chalk.dim("  ChatGPT: Settings → enable Developer mode → add a connector → paste the URL and choose API-key auth."));
-        console.log(chalk.yellow("\nclaude.ai (web/desktop/mobile connectors) can't take a custom header yet — its connector UI has no field for one. OAuth support is planned; until then, use Claude Code, Cursor, or another file-configurable client above."));
-        console.log(chalk.dim("\nTip: for file-configurable clients, `synap mcp connect <client>` writes the config for you."));
+        printMcpConnection({ url, hubApiKey, agentUserId, workspaceId, projectId });
     }
     catch (e) {
         log.error(`Could not build MCP connection: ${e.message}`);
@@ -200,7 +163,7 @@ export async function mcpVerify(opts) {
  * starts with `pod.` — anything else (localhost, a custom domain, …) can't be
  * derived confidently, so the caller falls back to a placeholder + `--cp-url`.
  */
-function deriveCpOrigin(podUrl) {
+export function deriveCpOrigin(podUrl) {
     try {
         const host = new URL(podUrl).hostname;
         const labels = host.split(".");
@@ -223,43 +186,267 @@ function deriveCpOrigin(podUrl) {
  * claude.ai's "Add custom connector" UI is OAuth-only (Dynamic Client
  * Registration) — it has no field for a bearer header, so the file/header
  * based flows (`mcp connect`, `mcp url`) don't apply. The control plane's
- * `/mcp` endpoint now speaks OAuth, so connecting is: paste a URL, approve in
- * the browser. This command can't drive that click-through itself — claude.ai
- * and the control plane own the OAuth handshake — it only prints the exact
- * values so there's no guesswork.
+ * `/mcp` endpoint speaks OAuth: paste a URL, approve in the browser. This
+ * command does not mint keys or write client config — it only prints the URL.
+ *
+ * Stranger-safe: if no pod is configured, falls back to `--cp-url` or the
+ * managed control plane `https://api.synap.live`.
  */
 export async function mcpConnectClaudeWeb(opts) {
     try {
-        const cfg = await resolveHubConfig(opts);
-        const { cpOrigin, derived } = deriveCpOrigin(cfg.podUrl);
-        const finalCpOrigin = (opts.cpUrl ?? cpOrigin).replace(/\/$/, "");
+        const MANAGED_CP = "https://api.synap.live";
+        /** How we chose the CP origin — for --json + user-facing notes. */
+        let source = "managed-fallback";
+        let cpOrigin = MANAGED_CP;
+        if (opts.cpUrl) {
+            cpOrigin = opts.cpUrl.replace(/\/$/, "");
+            source = "override";
+        }
+        else {
+            try {
+                const cfg = await resolveHubConfig(opts);
+                const fromPod = deriveCpOrigin(cfg.podUrl);
+                if (fromPod.derived) {
+                    cpOrigin = fromPod.cpOrigin;
+                    source = "derived";
+                }
+                else {
+                    // Non-pod.* host — can't derive confidently; managed + tip to --cp-url.
+                    cpOrigin = MANAGED_CP;
+                    source = "managed-fallback";
+                }
+            }
+            catch {
+                // No pod config — stranger path: print managed Cloud MCP (no key mint).
+                cpOrigin = MANAGED_CP;
+                source = "managed-fallback";
+            }
+        }
+        const finalCpOrigin = cpOrigin.replace(/\/$/, "");
         const url = `${finalCpOrigin}/mcp`;
-        const wasDerived = opts.cpUrl ? "override" : derived;
         const steps = [
             "Open claude.ai → Settings → Connectors → Add custom connector",
             "Name: Synap",
             `URL: ${url}`,
             "Leave Advanced settings (OAuth Client ID/Secret) blank",
             "Click Add → you'll be redirected to sign in to Synap Cloud and approve → done",
-            'Then ask Claude to "list my Synap pods" to confirm',
+            'Then ask Claude to "list my Synap pods" (list_pods) and connect one (connect_pod)',
         ];
         if (opts.json) {
-            console.log(JSON.stringify({ url, cpOrigin: finalCpOrigin, derived: wasDerived, steps }, null, 2));
+            console.log(JSON.stringify({ url, cpOrigin: finalCpOrigin, derived: source, steps }, null, 2));
             return;
         }
         log.heading("\nConnect claude.ai (web) to Synap");
-        if (!derived && !opts.cpUrl) {
-            log.warn("Could not derive the control-plane URL from your pod host — pass --cp-url <url> (e.g. https://api.yourdomain.com).");
+        if (source === "managed-fallback" && !opts.cpUrl) {
+            console.log(chalk.dim("  Using managed Cloud MCP (https://api.synap.live). Pass --cp-url for a self-hosted control plane. No key minted."));
         }
         console.log(`  ${chalk.dim("URL")}   ${url}`);
         console.log();
         steps.forEach((step, i) => console.log(`  ${chalk.bold(`${i + 1}.`)} ${step}`));
         console.log();
-        console.log(chalk.dim("This connects via the Synap control plane. A direct pod connection (no control plane) is coming."));
+        console.log(chalk.dim("Cloud MCP does not store your data. After OAuth, list_pods then connect_pod (you still need a pod for useful work)."));
     }
     catch (e) {
         log.error(`Could not build the claude.ai connection: ${e.message}`);
         process.exit(1);
     }
 }
+/**
+ * `synap mcp ui-setup <client>` — print the exact form fields to fill in a
+ * client's MCP/Connector UI. Supports ChatGPT (API key), Codex, Cursor,
+ * VS Code, Claude Desktop, and generic clients.
+ */
+export async function mcpUiSetup(client, opts) {
+    try {
+        const hubCfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+        const { url, workspaceId, projectId } = resolveMcpTarget(hubCfg, { workspace: opts.workspace, project: opts.project });
+        const { hubApiKey, agentUserId } = await provisionAgentKey(hubCfg.podUrl, hubCfg.apiKey, "generic", { requireApproval: false });
+        const normalizedClient = client.toLowerCase().replace(/-/g, "");
+        let output = "";
+        // The key never reaches stdout or argv: fields show it redacted; the full
+        // material is written 0600 and clients reference it through an env var.
+        const keyShown = redactKey(hubApiKey);
+        const snippetFiles = writeMcpSnippetFiles(url, hubApiKey, agentUserId);
+        const clientConfigs = {
+            chatgpt: {
+                name: "ChatGPT (API key)",
+                format: "http",
+                fields: {
+                    "Connector Name": "Synap",
+                    "URL": url,
+                    "Auth Type": "API Key",
+                    "API Key": `${keyShown} (full key: ${snippetFiles.envFile})`,
+                },
+                notes: [
+                    "ChatGPT → Settings → Connectors → Add custom connector",
+                    "Paste the URL and API Key exactly as shown above",
+                    `If your build shows a Header field instead: Authorization: Bearer <key> (full key in ${snippetFiles.envFile}, 0600)`,
+                ],
+            },
+            chatgptoauth: {
+                name: "ChatGPT (OAuth via Control Plane)",
+                format: "http",
+                fields: {
+                    "Connector Name": "Synap (Control Plane)",
+                    "URL": "https://api.synap.live/mcp",
+                    "Auth Type": "OAuth",
+                    "API Key": "(leave blank — OAuth flow)",
+                },
+                notes: [
+                    "ChatGPT → Settings → Connectors → Add custom connector",
+                    "Use the Control Plane OAuth URL (multi-pod support)",
+                    "After connecting, ask ChatGPT: 'list my Synap pods' then 'connect pod <name>'",
+                ],
+            },
+            codex: {
+                name: "OpenAI Codex (config.toml)",
+                format: "file",
+                fields: {
+                    "Config file": "~/.codex/config.toml",
+                    "Section to add": `[mcp_servers.synap]`,
+                    "url": url,
+                    "http_headers": `{ Authorization = "Bearer ${keyShown}" }`,
+                    "startup_timeout_sec": "30",
+                    "enabled": "true",
+                },
+                notes: [
+                    `Open ~/.codex/config.toml and add the [mcp_servers.synap] section (replace ${keyShown} with the full key from ${snippetFiles.envFile}, 0600)`,
+                    "Restart Codex CLI to pick up the new MCP server",
+                    "The synap tool set will appear in agent mode",
+                ],
+            },
+            cursor: {
+                name: "Cursor (mcp.json)",
+                format: "http",
+                fields: {
+                    "Config file": "~/.cursor/mcp.json",
+                    "mcpServers.synap.url": url,
+                    "mcpServers.synap.headers.Authorization": `Bearer \${env:${MCP_KEY_ENV}}`,
+                },
+                notes: [
+                    "Cursor reads native HTTP MCP format from ~/.cursor/mcp.json",
+                    "Restart Cursor. The synap tool set will appear in agent mode.",
+                ],
+            },
+            vscode: {
+                name: "VS Code (Kilo Code / Cline / Continue / Copilot)",
+                format: "http",
+                fields: {
+                    "Config file": "~/Library/Application Support/Code/User/mcp.json (macOS)",
+                    "servers.synap.type": "http",
+                    "servers.synap.url": url,
+                    "servers.synap.headers.Authorization": `Bearer \${env:${MCP_KEY_ENV}}`,
+                },
+                notes: [
+                    "VS Code 1.99+ uses 'servers' format (not mcpServers)",
+                    "Picked up automatically by Kilo Code, Cline, Continue, and GitHub Copilot",
+                    "Reload VS Code (or open the MCP panel) to activate",
+                ],
+            },
+            "claude-desktop": {
+                name: "Claude Desktop (stdio bridge)",
+                format: "stdio",
+                fields: {
+                    "Config file": "~/Library/Application Support/Claude/claude_desktop_config.json (macOS)",
+                    "mcpServers.synap.command": "npx",
+                    "mcpServers.synap.args": `-y mcp-remote ${url} --header "Authorization:\${SYNAP_AUTH}"`,
+                    "mcpServers.synap.env.SYNAP_AUTH": `Bearer ${keyShown} (real value: "mcpRemote" block in ${snippetFiles.jsonFile})`,
+                },
+                notes: [
+                    "Claude Desktop only supports stdio MCP — uses mcp-remote bridge",
+                    "Fully quit Claude Desktop (Cmd+Q), then relaunch",
+                    "Look for the MCP tools icon under the input box — 'synap' should appear",
+                ],
+            },
+            "claude-code": {
+                name: "Claude Code (native HTTP MCP)",
+                format: "http",
+                fields: {
+                    "Command": `source ${snippetFiles.envFile} && claude mcp add --transport http synap-${new URL(hubCfg.podUrl).hostname.split(".")[1] || "pod"} ${url} --header 'Authorization: Bearer \${${MCP_KEY_ENV}}' --scope user`,
+                },
+                notes: [
+                    `The key stays out of the command: it is read from $${MCP_KEY_ENV} when Claude Code starts — launch it from a shell that sourced ${snippetFiles.envFile}`,
+                    "Relaunch Claude Code to load the tools",
+                ],
+            },
+            generic: {
+                name: "Generic MCP Client (HTTP)",
+                format: "http",
+                fields: {
+                    "URL": url,
+                    "Headers": `Authorization: Bearer ${keyShown}`,
+                },
+                notes: [
+                    "Paste URL and add Authorization header in your client's MCP config",
+                    "Supports any MCP-compatible client with HTTP transport",
+                ],
+            },
+        };
+        const clientConfig = clientConfigs[normalizedClient] || clientConfigs.generic;
+        if (opts.json) {
+            console.log(JSON.stringify({ client: clientConfig.name, format: clientConfig.format, fields: clientConfig.fields, notes: clientConfig.notes }, null, 2));
+            return;
+        }
+        log.heading(`MCP UI Setup — ${clientConfig.name}`);
+        log.blank();
+        log.info("Form fields to fill in your client's MCP/Connector settings:");
+        log.blank();
+        for (const [key, value] of Object.entries(clientConfig.fields)) {
+            console.log(`  ${chalk.bold(key)}: ${chalk.cyan(value)}`);
+        }
+        log.blank();
+        log.info("Notes:");
+        for (const note of clientConfig.notes) {
+            console.log(`  • ${note}`);
+        }
+        log.blank();
+        log.dim("Agent key provisioned for this session. Re-run with --name to target another pod.");
+    }
+    catch (e) {
+        log.error(`Could not build UI setup: ${e.message}`);
+        process.exit(1);
+    }
+}
+/**
+ * `synap mcp bridge` — the stdio MCP server Claude Code spawns when it is
+ * connected through the bridge (`synap mcp use-bridge`). Forwards every
+ * message to the pod's /mcp and names the Claude Code conversation it runs in,
+ * so the work it does can be reopened there. See lib/mcp-bridge.ts.
+ *
+ * stdout IS the protocol — nothing but JSON-RPC may be written to it.
+ */
+export async function mcpBridge(opts) {
+    const { runMcpBridge } = await import("../lib/mcp-bridge.js");
+    const { conversationHeaders } = await import("../lib/conversation-headers.js");
+    const fromEnv = process.env.SYNAP_MCP_API_KEY || process.env.SYNAP_HUB_API_KEY;
+    const cfg = fromEnv && opts.url ? null : await resolveHubConfig();
+    const apiKey = fromEnv || cfg?.apiKey;
+    const url = opts.url || (cfg ? buildMcpUrl(cfg.podUrl) : undefined);
+    if (!apiKey || !url) {
+        process.stderr.write("[synap mcp bridge] no pod key or URL — run `synap init`\n");
+        process.exit(1);
+    }
+    // The spawn-time id (a stdio server's env), never a lens fallback.
+    await runMcpBridge({
+        url,
+        apiKey,
+        headers: conversationHeaders(process.env.CLAUDE_CODE_SESSION_ID),
+    });
+}
+/**
+ * `synap mcp use-bridge [--off]` — switch Claude Code's MCP connection to the
+ * stdio bridge (or back to direct http), re-using the key `synap init` stored.
+ */
+export async function mcpUseBridge(opts) {
+    const { setClaudeCodeMcpTransport } = await import("../lib/targets.js");
+    const name = setClaudeCodeMcpTransport(opts.off ? "http" : "bridge");
+    if (!name) {
+        log.error("Claude Code is not connected to a pod yet — run `synap init` first.");
+        process.exitCode = 1;
+        return;
+    }
+    log.dim(opts.off
+        ? "Claude Code talks to the pod directly again; conversations are no longer named on MCP calls."
+        : "Each Claude Code conversation is now named on its MCP calls, so its work can be reopened with `claude --resume <id>`.");
+}
 //# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/open.d.ts

@@ -6,27 +6,57 @@
  * synap open document <id>
  * synap open <id>                            ← resolves type automatically
  *
- * Sends a synap:// deep link to the Electron browser app, which opens the
- * entity, view, proposal, cell, or document in the UI. The bare-ID form calls
- * GET /api/hub/resolve/:id to determine the type before dispatching.
- *
- * Works from any terminal — the OS routes the URL to the registered synap://
- * protocol handler. Requires the Synap desktop app to be running.
+ * Sends a synap:// deep link to the Electron browser app. The OS routes the
+ * URL to the registered handler. On macOS we target the installed Synap.app
+ * by bundle id / path so leftover electron-vite (`com.github.electron`)
+ * cannot steal the click.
+ */
+/**
+ * Object kind, as a free string. The browser's `object-nav.ts` is the ONE
+ * route table for what's openable (21 kinds and growing) — the CLI does not
+ * duplicate it. An unroutable kind still opens the app; `objectNavTarget`
+ * decides there and returns `null` silently, so this command always prints
+ * the emitted link so the user can see what was sent.
  */
-export type OpenKind = "entity" | "view" | "cell" | "document" | "proposal";
+export type OpenKind = string;
 export interface OpenOpts {
     kind: OpenKind;
     id: string;
+    /** Address parameters the kind needs to be resolvable (a run's flowType). */
+    params?: Record<string, string>;
 }
 export interface ResolveResult {
-    type: "proposal" | "entity" | "view" | "document" | "unknown";
+    /**
+     * A browser-routable label, or "unknown". FREE STRING on purpose: the pod's
+     * `/resolve/:id` projects onto `object-nav.ts`'s route table (~21 kinds) and
+     * pins that with a tripwire. A hand-written union here was a second, smaller
+     * table — it listed four kinds, so every capability-substrate object the pod
+     * could resolve was still unopenable on this side.
+     */
+    type: string;
+    /** The id to OPEN — not always the id queried (a correlationId resolves to
+     *  the proposal/skill row it belongs to, and THAT is what opens). */
     id: string;
     displayName: string | null;
     workspaceId: string | null;
     profileSlug?: string | null;
+    /** False when the thing resolved but has no browser surface at all. */
+    openable?: boolean;
+    /** Address params the deep link must carry (only runs use one today). */
+    params?: Record<string, string>;
 }
+/** Lock-step with browser/electron-builder.yml `appId`. */
+export declare const DESKTOP_BUNDLE_ID = "live.synap.browser";
+export declare function desktopAppPaths(home?: string): string[];
+export declare function buildDeepLink(kind: OpenKind, id: string, params?: Record<string, string>): string;
+/**
+ * Ordered `open` argv lists for macOS. Prefer the installed .app so we do
+ * not depend on Launch Services still pointing at electron-vite.
+ */
+export declare function darwinOpenArgvCandidates(url: string, exists?: (path: string) => boolean): string[][];
+export declare function openUrl(url: string): void;
 export declare function openInBrowser(opts: OpenOpts): Promise<void>;
 /**
- * Resolve a bare ID then open in browser.
+ * Resolve a bare ID then open in the desktop app.
  */
 export declare function resolveAndOpen(id: string): Promise<void>;

package/dist/commands/open.js

@@ -6,33 +6,67 @@
  * synap open document <id>
  * synap open <id>                            ← resolves type automatically
  *
- * Sends a synap:// deep link to the Electron browser app, which opens the
- * entity, view, proposal, cell, or document in the UI. The bare-ID form calls
- * GET /api/hub/resolve/:id to determine the type before dispatching.
- *
- * Works from any terminal — the OS routes the URL to the registered synap://
- * protocol handler. Requires the Synap desktop app to be running.
+ * Sends a synap:// deep link to the Electron browser app. The OS routes the
+ * URL to the registered handler. On macOS we target the installed Synap.app
+ * by bundle id / path so leftover electron-vite (`com.github.electron`)
+ * cannot steal the click.
  */
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { openAppUrl } from "@synap-core/hub-rest-client";
 import { resolveHubConfig } from "../lib/hub-client.js";
 import { log } from "../utils/logger.js";
-function buildDeepLink(kind, id) {
-    return `synap://open/${kind}/${encodeURIComponent(id)}`;
+/** Lock-step with browser/electron-builder.yml `appId`. */
+export const DESKTOP_BUNDLE_ID = "live.synap.browser";
+export function desktopAppPaths(home = homedir()) {
+    return [
+        "/Applications/Synap.app",
+        join(home, "Applications", "Synap.app"),
+    ];
+}
+export function buildDeepLink(kind, id, params) {
+    return openAppUrl(kind, id, params);
+}
+/**
+ * Ordered `open` argv lists for macOS. Prefer the installed .app so we do
+ * not depend on Launch Services still pointing at electron-vite.
+ */
+export function darwinOpenArgvCandidates(url, exists = existsSync) {
+    const candidates = [];
+    const installed = desktopAppPaths().find(exists);
+    if (installed)
+        candidates.push(["-a", installed, url]);
+    candidates.push(["-b", DESKTOP_BUNDLE_ID, url]);
+    candidates.push([url]);
+    return candidates;
 }
-function openUrl(url) {
+export function openUrl(url) {
     const platform = process.platform;
     if (platform === "darwin") {
-        execSync(`open "${url}"`);
-    }
-    else if (platform === "linux") {
-        execSync(`xdg-open "${url}"`);
+        let lastErr;
+        for (const args of darwinOpenArgvCandidates(url)) {
+            try {
+                execFileSync("open", args, { stdio: "pipe" });
+                return;
+            }
+            catch (e) {
+                lastErr = e;
+            }
+        }
+        throw lastErr instanceof Error ? lastErr : new Error("open failed");
     }
-    else if (platform === "win32") {
-        execSync(`start "" "${url}"`);
+    if (platform === "linux") {
+        execFileSync("xdg-open", [url], { stdio: "pipe" });
+        return;
     }
-    else {
-        throw new Error(`Unsupported platform: ${platform}`);
+    if (platform === "win32") {
+        // argv only: `start "" "<url>"` went through cmd.exe, where `&` in a link runs a command.
+        execFileSync("rundll32", ["url.dll,FileProtocolHandler", url], { stdio: "pipe" });
+        return;
     }
+    throw new Error(`Unsupported platform: ${platform}`);
 }
 /**
  * Resolve a bare ID by calling the pod's /resolve endpoint.
@@ -51,22 +85,26 @@ async function resolveId(id) {
     return res.json();
 }
 export async function openInBrowser(opts) {
-    const url = buildDeepLink(opts.kind, opts.id);
+    const url = buildDeepLink(opts.kind, opts.id, opts.params);
     try {
         openUrl(url);
-        log.success(`Opened ${opts.kind} in browser: ${opts.id.slice(0, 8)}…`);
+        log.success(`Opened ${opts.kind} in the Synap app: ${opts.id.slice(0, 8)}…`);
         log.dim(`  (${url})`);
     }
     catch (e) {
-        log.error(`Could not open browser: ${e.message}\n` +
-            `  Make sure the Synap desktop app is running.`);
+        log.error(`Could not open the Synap desktop app: ${e.message}\n` +
+            `  Install Synap.app (or run the desktop app once) so it can claim synap://.`);
         process.exit(1);
     }
 }
 /**
- * Resolve a bare ID then open in browser.
+ * Resolve a bare ID then open in the desktop app.
  */
 export async function resolveAndOpen(id) {
+    if (id.startsWith("generated:")) {
+        await openInBrowser({ kind: "cell", id });
+        return;
+    }
     try {
         const resolved = await resolveId(id);
         if (resolved.type === "unknown") {
@@ -74,11 +112,28 @@ export async function resolveAndOpen(id) {
             return;
         }
         log.info(`Resolved: ${resolved.type} — ${resolved.displayName ?? id.slice(0, 8)}`);
-        await openInBrowser({ kind: resolved.type, id });
+        // RESOLVED BUT NOT OPENABLE. Some things the pod can identify have no
+        // browser surface at all (an external send is a correlationId-keyed audit
+        // event: no row, no page). Say what it is and stop — minting
+        // `synap://open/<kind>/<id>` for a kind the route table has no arm for
+        // opens the app onto nothing, which is worse than an honest refusal.
+        if (resolved.openable === false) {
+            log.warn(`A ${resolved.type} has no page in the Synap app — nothing to open.\n` +
+                `  Inspect it instead: synap diagnose ${id}`);
+            return;
+        }
+        // `resolved.id`, not `id`: a correlationId handed back by a capability run
+        // resolves to the proposal (or skill) row it belongs to, and that ROW id is
+        // what the deep link must carry. For every direct row-id hit they are equal.
+        await openInBrowser({
+            kind: resolved.type,
+            id: resolved.id ?? id,
+            ...(resolved.params ? { params: resolved.params } : {}),
+        });
     }
     catch (e) {
         log.error(`Could not resolve/open: ${e.message}\n` +
-            `  Make sure the Synap desktop app is running and your pod is reachable.`);
+            `  Make sure the Synap desktop app is installed and your pod is reachable.`);
         process.exit(1);
     }
 }