@cursor/july 0.1.16 → 0.1.17

package/dist/internal/cli-mcp.d.ts

@@ -25,6 +25,7 @@
  * stdout is reserved for the MCP wire in serve mode; all logging goes to
  * stderr.
  */
+import { resolveDeployAuth } from "./cli-deploy.js";
 import { resolveProdTarget } from "./resolve-prod-target.js";
 export interface McpCliOptions {
     dir: string;
@@ -43,9 +44,16 @@ export interface McpCliOptions {
     print?: boolean;
     /** `install`: machine-readable output. */
     json?: boolean;
+    /**
+     * `install --prod`: write a REMOTE HTTP entry pointing at the stable Cursor
+     * MCP gateway (`<api>/…/mcp/<team>/<slug>`) instead of the local stdio
+     * proxy. For remote-only MCP hosts (Glass) that cannot spawn stdio.
+     */
+    remote?: boolean;
     /** Injected seams for tests. */
     fetchImpl?: typeof fetch;
     resolveProdTargetImpl?: typeof resolveProdTarget;
+    resolveDeployAuthImpl?: typeof resolveDeployAuth;
     stdin?: NodeJS.ReadableStream;
     stdout?: {
         write(chunk: string): unknown;

package/dist/internal/cli-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-mcp.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAGL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA0BlC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GAAG;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAMD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFzE;AAyRD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqG3E;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAqED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD"}
+{"version":3,"file":"cli-mcp.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAGL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA0BlC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GAAG;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAMD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFzE;AAwRD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3E;AAoGD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAqED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD"}

package/dist/internal/cli-mcp.js

@@ -37,6 +37,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { resolveDeployAuth } from "./cli-deploy.js";
+import { DeployApiError } from "./deploy-client.js";
 import { CLI_COMMAND_NAME as CLI, LOG_PREFIX } from "./distribution.js";
 import { ProdTargetError, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
 /** Mount path of the MCP surface relative to an agent base URL. */
@@ -388,6 +390,13 @@ export function cmdMcpInstall(options) {
             err("--prod and --url are mutually exclusive\n");
             return 1;
         }
+        if (options.remote === true) {
+            if (options.prod !== true) {
+                err("--remote requires --prod (the hosted deployment MCP gateway)\n");
+                return 1;
+            }
+            return cmdMcpInstallRemote(options);
+        }
         let name;
         let entry;
         if (options.prod === true) {
@@ -475,6 +484,95 @@ export function cmdMcpInstall(options) {
         return 0;
     });
 }
+/**
+ * `mcp install --prod --remote` — write a REMOTE HTTP entry pointing at the
+ * stable Cursor MCP gateway for the hosted deployment, for MCP hosts that
+ * cannot spawn the stdio proxy (Glass / Sand). The gateway mints/refreshes
+ * engineAccess server-side, so the entry never carries a pod hostname or a
+ * short-lived port token — only the durable, stable gateway URL.
+ *
+ * Auth: this headless/CLI entry sends the `agentkit login` API key as a
+ * bearer against the user-API-key gateway surface. That key is written to
+ * `mcp.json` in plain text (flagged below); a signed-in Cursor client
+ * (Glass) can instead use the session gateway surface with no header at all
+ * once first-party session attachment ships (see PR follow-ups).
+ */
+function cmdMcpInstallRemote(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        const err = (_a = options.err) !== null && _a !== void 0 ? _a : defaultErr;
+        const stdout = (_b = options.stdout) !== null && _b !== void 0 ? _b : process.stdout;
+        let slug;
+        try {
+            slug = resolveProdSlug({
+                dir: options.dir,
+                cwd: options.cwd,
+                slug: options.slug,
+            });
+        }
+        catch (error) {
+            err(`${describeError(error)}\n`);
+            return 1;
+        }
+        const resolveAuthImpl = (_c = options.resolveDeployAuthImpl) !== null && _c !== void 0 ? _c : resolveDeployAuth;
+        const auth = yield resolveAuthImpl({
+            team: options.team,
+            apiKey: options.apiKey,
+            fetchImpl: options.fetchImpl,
+            err,
+        });
+        if (typeof auth === "number") {
+            return auth;
+        }
+        // Verify the deployment resolves before writing config that cannot work.
+        // This read is admin-tier, but calling the gateway only needs team
+        // membership — so a 403 means "cannot verify", not "cannot use": warn and
+        // still write the entry rather than locking members out of their own agent.
+        try {
+            yield auth.client.getDeployment({ teamId: auth.teamId, slug });
+        }
+        catch (error) {
+            if (error instanceof DeployApiError && error.status === 403) {
+                err(`Could not verify deployment "${slug}" (reading deployments needs team-admin); writing the entry anyway.\n`);
+            }
+            else {
+                err(`${describeError(error)}\n`);
+                if (error instanceof DeployApiError && error.status === 404) {
+                    err(`Deploy it first: ${CLI} deploy --slug ${slug}\n`);
+                }
+                return 1;
+            }
+        }
+        const name = resolveServerName(options.name, slug);
+        const url = auth.client.mcpGatewayUrl(auth.teamId, slug);
+        const entry = {
+            url,
+            headers: { Authorization: `Bearer ${auth.apiKey}` },
+        };
+        if (options.print === true) {
+            stdout.write(`${JSON.stringify({ mcpServers: { [name]: entry } }, null, 2)}\n`);
+            return 0;
+        }
+        const path = cursorMcpJsonPath();
+        try {
+            yield upsertMcpJsonEntry(path, name, entry);
+        }
+        catch (error) {
+            err(`${describeError(error)}\n`);
+            return 1;
+        }
+        err("note: the API key is written to mcp.json in plain text; it is a durable " +
+            "credential for a remote MCP host that cannot spawn the stdio proxy.\n");
+        if (options.json === true) {
+            stdout.write(`${JSON.stringify({ ok: true, path, name, entry })}\n`);
+            return 0;
+        }
+        stdout.write(`Installed remote MCP server "${name}" in ${path}\n` +
+            `  ${url}\n` +
+            "Cursor watches this file; the server appears without a restart.\n");
+        return 0;
+    });
+}
 /** `~/.cursor/mcp.json` — the user-level Cursor MCP config. */
 export function cursorMcpJsonPath(home) {
     var _a;

package/dist/internal/cli-slack.d.ts

@@ -1,6 +1,9 @@
 /**
- * `agent-serve slack …` CLI — manifests, setup, doctor (Socket Mode).
+ * `agent-serve slack …` CLI — manifests, setup, doctor (Socket Mode), and
+ * managed provisioning (`create` / `destroy`) through Cursor's
+ * "Add to Slack" API (`slack-provision-client.ts`).
  */
+import { runSlackDoctor } from "../channels/slack/index.js";
 export interface SlackCliOptions {
     dir: string;
     name?: string;
@@ -13,6 +16,31 @@ export interface SlackCliOptions {
     noPrefix?: boolean;
     /** Subscribe manifests to channel-post events (opt-in channel watch). */
     channelPosts?: boolean;
+    /** create/destroy: target Slack workspace id (`T…`). */
+    slackTeam?: string;
+    /** create/destroy: target the prod app (default dev). */
+    prod?: boolean;
+    /** create/destroy: Cursor team id; resolved from the account when omitted. */
+    team?: string;
+    /** create/destroy: Cursor API key (defaults to the stored login / env). */
+    apiKey?: string;
+    /** create: app icon — an https image URL or a local png/jpg/gif ≤512KB. */
+    icon?: string;
+    /** create: overwrite manifest edits made in Slack (skip the drift check). */
+    force?: boolean;
+    /** `slack icon <source>` positional (same URL-or-file forms as --icon). */
+    iconSource?: string;
+    /** Test seams. */
+    fetchImpl?: typeof fetch;
+    openBrowserImpl?: (url: string) => void;
+    connectPollIntervalMs?: number;
+    connectPollTimeoutMs?: number;
+    doctorImpl?: typeof runSlackDoctor;
+    out?: (text: string) => void;
+    err?: (text: string) => void;
 }
 export declare function cmdSlack(subcommand: string | undefined, options: SlackCliOptions): Promise<number>;
+export declare function cmdSlackCreate(options: SlackCliOptions): Promise<number>;
+export declare function cmdSlackDestroy(options: SlackCliOptions): Promise<number>;
+export declare function cmdSlackIcon(options: SlackCliOptions): Promise<number>;
 //# sourceMappingURL=cli-slack.d.ts.map

package/dist/internal/cli-slack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-slack.d.ts","sourceRoot":"","sources":["../../src/internal/cli-slack.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAoBD,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"cli-slack.d.ts","sourceRoot":"","sources":["../../src/internal/cli-slack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAML,cAAc,EAGf,MAAM,4BAA4B,CAAC;AAoBpC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,cAAc,CAAC;IACnC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AA6CD,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAsaD,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA6NjB;AAiDD,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsD5E"}