@cursor/july 0.1.101 → 0.1.103

package/src/bin/agent-serve.ts

@@ -2,18 +2,18 @@
 /**
  * agent-serve CLI.
  *
- *   agent-serve serve      [--dir .] [--port 3000] [--host 127.0.0.1] [--dev]
- *   agent-serve dev        [path] [--port 3000] [--host 127.0.0.1]
- *   agent-serve docs       [--port 0] [--host 127.0.0.1] [--print]
- *   agent-serve chat      [--url http://127.0.0.1:3000] [--message "..."] [--json]
- *   agent-serve resume    [sessionId] [--url | --prod] [--message "..."]
- *   agent-serve run       [--dir .] [--message "..."] [--json|--text]
- *   agent-serve trajectory --events <file.ndjson>
- *   agent-serve init      [dir] [--json]
- *   agent-serve convert-automation <url> [--dir <path>] [--json]
- *   agent-serve eval        [--dir .] [evalId...]
- *   agent-serve validate   [--dir .]
- *   agent-serve slack     <subcommand>
+ *   agent-sdk serve      [--dir .] [--port 3000] [--host 127.0.0.1] [--dev]
+ *   agent-sdk dev        [path] [--port 3000] [--host 127.0.0.1]
+ *   agent-sdk docs       [--port 0] [--host 127.0.0.1] [--print]
+ *   agent-sdk chat      [--url http://127.0.0.1:3000] [--message "..."] [--json]
+ *   agent-sdk resume    [sessionId] [--url | --prod] [--message "..."]
+ *   agent-sdk run       [--dir .] [--message "..."] [--json|--text]
+ *   agent-sdk trajectory --events <file.ndjson>
+ *   agent-sdk init      [dir] [--json]
+ *   agent-sdk convert-automation <url> [--dir <path>] [--json]
+ *   agent-sdk eval        [--dir .] [evalId...]
+ *   agent-sdk validate   [--dir .]
+ *   agent-sdk slack     <subcommand>
  */
 
 import { spawn } from "node:child_process";
@@ -286,6 +286,10 @@ Commands:
               doctor (see slack help).
   github      GitHub webhook pack: forward live deliveries, events, doctor
               (wraps \`gh webhook forward\`; see github help).
+  gitlab      GitLab webhook pack: replay a merge request, events, forward
+              recipe (see gitlab help).
+  bitbucket   Bitbucket webhook pack (Cloud + Data Center): replay a pull
+              request, events, forward recipe (see bitbucket help).
 
 Agent loop:
   ${CLI} validate --dir .
@@ -332,11 +336,14 @@ Options:
                      defineConnection({ cursorAccount: true }). Admitted callers
                      can drive the account's MCP connectors, so use only behind
                      a trusted boundary (e.g. an SSO proxy or hosted alias token).
+  --cursor-scm-proxy serve: route every SCM channel's cursorAccount API calls
+                     (githubChannel, gitlabChannel, bitbucketChannel) through
+                     the Cursor backend's per-forge forwarder instead of
+                     minting raw tokens into this process
+                     (AGENT_SERVE_<FORGE>_PROXY_URL overrides a base URL).
   --cursor-github-proxy
-                     serve: route githubChannel({ cursorAccount }) API calls
-                     through the Cursor backend's GitHub forwarder instead of
-                     minting raw installation tokens into this process
-                     (AGENT_SERVE_GITHUB_PROXY_URL overrides the base URL).
+                     serve: deprecated alias for --cursor-scm-proxy; removed
+                     one release after --cursor-scm-proxy ships.
   --public-url       serve: base URL where this host is reachable from outside
                      (e.g. https://agent-serve.example.com). Required for peer
                      connections (defineConnection({ agent })) on cloud-runtime
@@ -442,9 +449,10 @@ Options:
   --install          github: install the cli/gh-webhook extension if missing.
                      slack init --manual: require Slack CLI app install.
   --no-install       slack init --manual: skip Slack CLI app install.
-  --action           github replay: event action (e.g. opened, synchronize).
+  --action           github/gitlab replay: event action (e.g. opened, open).
   --conclusion       github replay: CI conclusion (check_run/suite/status).
-  --comment          github replay: comment body for comment events.
+                     gitlab replay: pipeline status (success, failed, …).
+  --comment          github/gitlab/bitbucket replay: comment / note body.
   --context          github replay: commit-status context.
   --dry-run          github replay: print synthesized payloads, don't POST.
   --out              eval / eval status <runId>: also write the full results
@@ -510,6 +518,7 @@ async function main(argv: string[]): Promise<number> {
       "allow-anonymous-cursor-github": { type: "boolean", default: false },
       "allow-anonymous-cursor-account-mcp": { type: "boolean", default: false },
       "allow-anonymous-grokbot": { type: "boolean", default: false },
+      "cursor-scm-proxy": { type: "boolean", default: false },
       "cursor-github-proxy": { type: "boolean", default: false },
       "no-schedules": { type: "boolean", default: false },
       "no-control-plane": { type: "boolean", default: false },
@@ -672,6 +681,66 @@ async function main(argv: string[]): Promise<number> {
         out: values.out,
       });
     }
+    case "gitlab": {
+      const port =
+        values.port === undefined
+          ? undefined
+          : Number.parseInt(values.port, 10);
+      if (
+        port !== undefined &&
+        (Number.isNaN(port) || port < 0 || port > 65535)
+      ) {
+        process.stderr.write(`invalid --port: ${values.port}\n`);
+        return 1;
+      }
+      const { cmdGitlab } = await import("../internal/cli-gitlab.js");
+      return cmdGitlab(positionals[0], {
+        dir,
+        slug: values.slug,
+        channel: values.channel?.at(-1),
+        host: values.host,
+        port,
+        url: values.url,
+        events: values.events,
+        secret: values.secret,
+        json: values.json,
+        mrUrl: positionals[1],
+        action: values.action,
+        conclusion: values.conclusion,
+        comment: values.comment,
+        dryRun: values["dry-run"],
+        out: values.out,
+      });
+    }
+    case "bitbucket": {
+      const port =
+        values.port === undefined
+          ? undefined
+          : Number.parseInt(values.port, 10);
+      if (
+        port !== undefined &&
+        (Number.isNaN(port) || port < 0 || port > 65535)
+      ) {
+        process.stderr.write(`invalid --port: ${values.port}\n`);
+        return 1;
+      }
+      const { cmdBitbucket } = await import("../internal/cli-bitbucket.js");
+      return cmdBitbucket(positionals[0], {
+        dir,
+        slug: values.slug,
+        channel: values.channel?.at(-1),
+        host: values.host,
+        port,
+        url: values.url,
+        events: values.events,
+        secret: values.secret,
+        json: values.json,
+        prUrl: positionals[1],
+        comment: values.comment,
+        dryRun: values["dry-run"],
+        out: values.out,
+      });
+    }
     case "init": {
       return cmdInit({
         dir,
@@ -1284,8 +1353,11 @@ async function main(argv: string[]): Promise<number> {
             : undefined,
         allowAnonymousGrokbot:
           values["allow-anonymous-grokbot"] === true ? true : undefined,
-        cursorGithubProxy:
-          values["cursor-github-proxy"] === true ? true : undefined,
+        cursorScmProxy:
+          values["cursor-scm-proxy"] === true ||
+          values["cursor-github-proxy"] === true
+            ? true
+            : undefined,
         schedules: values["no-schedules"] === true ? false : undefined,
         noControlPlane: values["no-control-plane"] === true ? true : undefined,
         playground: values["no-playground"] === true ? false : undefined,
@@ -1644,6 +1716,34 @@ function printServeBanner(
       )
     );
   }
+  if (
+    opts.dev &&
+    (process.env.GITLAB_WEBHOOK_SECRET === undefined ||
+      process.env.GITLAB_WEBHOOK_SECRET === "") &&
+    handle.agents.some((agent) =>
+      projectInfo(agent.project).channels.some((c) => c.kind === "gitlab")
+    )
+  ) {
+    process.stdout.write(
+      c.dim(
+        `  gitlab: dev accepts unsigned loopback deliveries (${CLI} gitlab replay works without a secret; set GITLAB_WEBHOOK_SECRET to verify X-Gitlab-Token)\n`
+      )
+    );
+  }
+  if (
+    opts.dev &&
+    (process.env.BITBUCKET_WEBHOOK_SECRET === undefined ||
+      process.env.BITBUCKET_WEBHOOK_SECRET === "") &&
+    handle.agents.some((agent) =>
+      projectInfo(agent.project).channels.some((c) => c.kind === "bitbucket")
+    )
+  ) {
+    process.stdout.write(
+      c.dim(
+        `  bitbucket: dev accepts unsigned loopback deliveries (${CLI} bitbucket replay works without a secret; set BITBUCKET_WEBHOOK_SECRET to verify X-Hub-Signature)\n`
+      )
+    );
+  }
 }
 
 /** Prefer the Vite playground URL in --dev; otherwise the static SPA path. */
@@ -1745,7 +1845,7 @@ installTransportErrorGuards();
 
 // Authored agent files are TypeScript imported at runtime; install the tsx
 // loader (and the framework import aliases on compiled runs) before any
-// command touches a project. In-repo CLI is `bin/agentsdk`.
+// command touches a project. In-repo CLI is `bin/agent-serve.ts`.
 registerAuthoredModuleLoaders()
   .then(() => main(process.argv.slice(2)))
   .then(