@cursor/july 0.1.107 → 0.1.109

package/AGENTS.md

@@ -5,7 +5,7 @@ Loop: edit files → inspect surface → run a turn → assert with filesystem
 evals. Prefer the CLI over ad-hoc curl.
 
 User-facing documentation lives in [`docs/`](./docs/README.md)
-(quickstart, concepts, guides, evals/live A/B metrics/hillclimbing, deployment,
+(quickstart, concepts, guides, evals/hillclimbing, deployment,
 troubleshooting, reference). This file is the terse loop reference;
 point humans at the docs.
 
@@ -44,12 +44,12 @@ which reads these files. Open them directly. There are no
 | `skills/framework-map/SKILL.md` | First contact: folder structure, runtimes, sessions, state, invariants |
 | `skills/create-agent/SKILL.md` | Scaffolding a new agent (interview → scaffold → verify) |
 | `skills/evals/SKILL.md` | Writing evals; fixture strategy; the regression ratchet |
-| `skills/ab/SKILL.md` | Live A/B metrics (`defineAB` under `agent/ab`); not a test runner |
 | `skills/otel/SKILL.md` | OpenTelemetry export (`defineOtel` / OTLP env / `ctx.host.otel`) |
 | `skills/hillclimb/SKILL.md` | Improving an existing agent measurably |
 | `skills/github/SKILL.md` | GitHub webhook agents; replay / forward / fixtures / cursor-events |
 | `skills/setup-slack/SKILL.md` | Slack wiring and Slack tool approvals |
 | `skills/mcp-auth/SKILL.md` | Host MCP OAuth (`mcp oauth`, `--store`, `advertiseTools`, `host-connections/`) |
+| `skills/deploy/SKILL.md` | Deploy or redeploy from a pushed Git ref with an attached service account |
 | `skills/debug/SKILL.md` | Something misbehaving locally (symptom → cause) |
 
 Hosted-platform debug (stopped / slow start / health-fail, Datadog
@@ -87,8 +87,6 @@ agent-sdk call get_weather --dir . --input '{"city":"NYC"}'
 agent-sdk eval --dir . --list
 agent-sdk eval --dir . --json
 agent-sdk eval --dir . weather/nyc
-
-# Live A/B metrics: author agent/ab.ts (defineAB) — runs under serve, no CLI
 ```
 
 ## Project layout
@@ -101,8 +99,6 @@ my-agent/
     tools/*.ts
     skills/*.md
     channels/
-    ab.ts                    # optional live A/B metrics (defineAB)
-    ab.config.ts             # optional: maxPlaygroundSessions (default 200)
     ...
   evals/
     smoke.eval.ts            # single datapoint → id: smoke

package/README.md

@@ -16,9 +16,9 @@ as the execution engine.
 **User-facing documentation lives in [`docs/`](./docs/README.md)**.
 Open it with `npx @cursor/july docs`, or at `/docs` on every running
 `agent-sdk serve` host. It covers getting started, concepts, guides (Slack,
-GitHub webhooks, approvals, agent-to-agent, cloud runtime), evals, live
-A/B metrics, hillclimbing, deployment, troubleshooting, and reference
-pages for each folder. This README is the compact package reference.
+GitHub webhooks, approvals, agent-to-agent, cloud runtime), evals,
+hillclimbing, deployment, troubleshooting, and reference pages for each
+folder. This README is the compact package reference.
 
 Instead of one large configuration object, each part of the agent gets a
 clear home. Instructions go in one file, tools in one folder, channels in
@@ -49,8 +49,6 @@ my-agent/
     ├── result.ts            # optional host commit on the final assistant text
     ├── otel.ts              # optional OpenTelemetry export
     ├── playground/          # optional custom playground tool chips
-    ├── ab.ts                # optional live A/B experiment
-    ├── ab/                  # optional: more experiments
     ├── schedules/
     │   └── heartbeat.md     # cron-driven runs
     ├── sandbox/workspace/   # files seeded into each session's workspace
@@ -694,7 +692,7 @@ name.
 
 Requirements and behavior:
 
-- The host must be signed in (`agent-sdk login` or `CURSOR_API_KEY`);
+- The host must be signed in (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`);
   `serve` fails fast at startup otherwise, and logs each connector's live
   status (`connected` / `needsAuth` / `error`) as it starts.
 - Local turns and host-side calls go through a loopback bridge route guarded
@@ -981,8 +979,10 @@ under `serve --dev`, which admits unsigned loopback deliveries so
 `{ auth }` to start a model turn as the actor, `{ task }` for host-side work
 (202 ACK, runs past GitHub's ~10s timeout), or `null` to skip.
 
-**Testing GitHub agents locally.** `cursorAccount` reuses `agent-sdk login`
-for both Cursor SCM events and a refreshing repo-scoped GitHub credential used
+**Testing GitHub agents locally.** `cursorAccount` uses the host Cursor
+credential (`agent-sdk login`, `CURSOR_API_KEY`, or
+`CURSOR_SERVICE_ACCOUNT_KEY`) for both Cursor SCM events and a refreshing
+repo-scoped GitHub credential used
 by `ctx.github`, `ctx.host.github`, and child `gh` commands. Default
 `permissions: "pr-write"` covers comments without `contents:write`; opt up to
 `"contents-write"` when the agent must push or post merge-box checks.
@@ -1066,7 +1066,7 @@ Cursor GitHub App is on the repo, `serve --cursor-events --repo owner/repo`
 long-polls `/v0/scm-events` with the host's Cursor account (no public URL /
 repo admin). Offset + consumer id live under `<state-root>/cursor-events/`.
 The stream is read as your Cursor user, so the flag **requires a signed-in
-host** (`agent-sdk login`, `CURSOR_API_KEY`, or `serve({ apiKey })`).
+host** (`agent-sdk login`, `CURSOR_API_KEY`, `CURSOR_SERVICE_ACCOUNT_KEY`, or `serve({ apiKey })`).
 Serve fails fast rather than starting with a relay that can never receive
 events.
 
@@ -1152,7 +1152,6 @@ The NDJSON stream vocabulary: one JSON object per line, each carrying
 | --------------------- | -------------------------------------------------------------- |
 | `session.started`     | A durable session was created.                                 |
 | `agent.bound`          | Cloud conversation URL.                                        |
-| `ab.assigned`         | Sticky A/B enrollment (`experiment`, `variant` or `null` skip). |
 | `message.received`    | An inbound user message was accepted.                          |
 | `turn.started`        | A turn began.                                                  |
 | `step.started` / `step.completed` | Model step boundaries (with duration).            |
@@ -1187,7 +1186,10 @@ console.log(`listening on ${handle.url}`);
 
 The Cursor credential resolves in one order everywhere (SDK turns, cloud
 runtime, Cursor account MCP connections): explicit `apiKey` option / `--api-key`
-→ `CURSOR_API_KEY` → the key stored by `agent-sdk login`. `whoami` shows
+→ `CURSOR_API_KEY` → `CURSOR_API_KEY_FILE` (hosted default
+`/run/cursor/secrets/CURSOR_API_KEY` when unset) → `CURSOR_SERVICE_ACCOUNT_KEY`
+→ the key stored by `agent-sdk login`. A bind file wins over
+`CURSOR_SERVICE_ACCOUNT_KEY`. `whoami` shows
 which one is active; `logout` removes the stored key (revoke it in the
 Cursor dashboard to kill it outright).
 

package/dist/bin/agent-serve.js

@@ -63,6 +63,7 @@ Usage:
   ${CLI} session     <sessionId> [--url <baseUrl> | --prod]
                           [--json | --text | --events] [--out <file.ndjson>]
                           [--slug <slug>] [--team <id>] [--dir <path>]
+                 or: --prod [<sessionId>] --slug <slug> --message "…" [--dry-run] [--as-of <instant>]
   ${CLI} cost        [sessionId] [--url <baseUrl> | --prod] [--json]
                           [--slug <slug>] [--team <id>] [--dir <path>]
   ${CLI} playground  [--url <baseUrl> | --prod] [--session <id>] [--print]
@@ -72,6 +73,7 @@ Usage:
                           [--session <id>] [--continuation-token <t>]
                           [--events <file.ndjson>] [--no-events] [--text]
                           [--timeout-ms <n>] [--no-stream] [--slug <slug>] [--team <id>]
+                          [--dry-run] [--as-of <instant>]
   ${CLI} trajectory  --events <file.ndjson> [--text]
   ${CLI} call        <tool> [--input <json>] [--dir <path> | --url <baseUrl> | --prod]
                           [--session <id>] [--slug <slug>] [--team <id>]
@@ -161,6 +163,10 @@ Commands:
               Writes a single events.ndjson trace (summarize with trajectory).
               Streams tool calls and reply text to stderr when stderr is a TTY.
               Pass --prod to hit the hosted deployment instead of a local server.
+              On an AgentSDK v2 slug, --prod starts a hosted session through
+              the control plane (Temporal, no resident engine); --session
+              ses_… resumes that exact session. A 404 falls back to the v1
+              engine alias.
   trajectory  Summarize an events.ndjson file into a trajectory.
   call        Call an authored server tool deterministically (no model turn)
               via POST /v1/tools/:toolName. --session runs it inside an
@@ -275,8 +281,11 @@ Options:
                      ALB/ECS checks; use single when one agent is the whole host.
   --dev              Dev mode: mounts POST /v1/dev/schedules/:scheduleId and
                      disables the cron runner (dispatch schedules by hand).
-  --api-key          Cursor API key (defaults to CURSOR_API_KEY, then the
-                     stored \`${CLI} login\` credential).
+  --api-key          Cursor API key (defaults to CURSOR_API_KEY, then
+                     CURSOR_API_KEY_FILE — hosted default
+                     /run/cursor/secrets/CURSOR_API_KEY when unset —
+                     then CURSOR_SERVICE_ACCOUNT_KEY, then the stored
+                     \`${CLI} login\` credential).
   --key-name         login: label for the minted API key (defaults to
                      "${CLI} (<hostname>)").
   --state-root       Durable state directory (default <dir>/.agent-serve). Put it
@@ -325,6 +334,9 @@ Options:
                      --dir basename. Mutually exclusive with --url. Requires
                      \`${CLI} login\`. For eval, this is how you opt into the
                      persisted server-side batch (default is local).
+  --dry-run          run/session --prod: mark the hosted v2 turn non-mutating.
+  --as-of            run/session --prod: freeze the session clock at this
+                     timezone-bearing ISO-8601 instant.
   --once             logs: print current progress / log buffer once and exit
                      (default is to follow).
   --print            playground/docs: print the URL only; do not open a
@@ -436,7 +448,7 @@ function writeStdout(text) {
 function main(argv) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        var _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+        var _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
         const [command, ...restIn] = argv;
         if (command === undefined ||
             command === "help" ||
@@ -531,6 +543,7 @@ function main(argv) {
                 context: { type: "string" },
                 comment: { type: "string" },
                 "dry-run": { type: "boolean", default: false },
+                "as-of": { type: "string" },
                 out: { type: "string" },
                 team: { type: "string" },
                 "no-wait": { type: "boolean", default: false },
@@ -817,6 +830,8 @@ function main(argv) {
                     stateRoot: values["state-root"],
                     timeoutMs: parseTimeoutMs(values["timeout-ms"]),
                     stream: values["no-stream"] ? false : undefined,
+                    dryRun: values["dry-run"],
+                    asOf: values["as-of"],
                 }));
             }
             case "call": {
@@ -963,6 +978,7 @@ function main(argv) {
                 }));
             }
             case "session": {
+                const messages = yield loadMessages(values.message, values["messages-file"]);
                 return cmdSession(positionals[0], axFromOptions({
                     dir,
                     url: values.url,
@@ -975,10 +991,14 @@ function main(argv) {
                     text: values.text,
                     rawEvents: values["raw-events"],
                     out: values.out,
+                    messages,
+                    sessionId: (_s = values["session-id"]) !== null && _s !== void 0 ? _s : values.session,
+                    dryRun: values["dry-run"],
+                    asOf: values["as-of"],
                 }));
             }
             case "cost": {
-                return cmdCost((_t = (_s = positionals[0]) !== null && _s !== void 0 ? _s : values["session-id"]) !== null && _t !== void 0 ? _t : values.session, axFromOptions({
+                return cmdCost((_u = (_t = positionals[0]) !== null && _t !== void 0 ? _t : values["session-id"]) !== null && _u !== void 0 ? _u : values.session, axFromOptions({
                     dir,
                     url: values.url,
                     prod: values.prod,
@@ -998,7 +1018,7 @@ function main(argv) {
                     apiKey: values["api-key"],
                     slug: values.slug,
                     bearerToken: values["bearer-token"],
-                    sessionId: (_u = values["session-id"]) !== null && _u !== void 0 ? _u : values.session,
+                    sessionId: (_v = values["session-id"]) !== null && _v !== void 0 ? _v : values.session,
                     print: values.print,
                 }));
             }
@@ -1067,8 +1087,8 @@ function main(argv) {
                     "(events only)"}`)));
                 lines.push(section("schedules", info.schedules.map((s) => `${s.name} (${s.cron}, ${s.kind})`)));
                 lines.push(section("hooks", info.hooks));
-                lines.push(section("hosting egress domains", (_v = (_j = info.hosting) === null || _j === void 0 ? void 0 : _j.egressDomains) !== null && _v !== void 0 ? _v : []));
-                lines.push(section("hosting secret names", (_w = (_k = info.hosting) === null || _k === void 0 ? void 0 : _k.secretNames) !== null && _w !== void 0 ? _w : []));
+                lines.push(section("hosting egress domains", (_w = (_j = info.hosting) === null || _j === void 0 ? void 0 : _j.egressDomains) !== null && _w !== void 0 ? _w : []));
+                lines.push(section("hosting secret names", (_x = (_k = info.hosting) === null || _k === void 0 ? void 0 : _k.secretNames) !== null && _x !== void 0 ? _x : []));
                 if (info.diagnostics.length > 0) {
                     lines.push(`\ndiagnostics:\n${formatDiagnostics(info.diagnostics)}`);
                 }
@@ -1138,7 +1158,7 @@ function main(argv) {
                     publicUrl: values["public-url"],
                     cloudToolsUrl: values["cloud-tools-url"],
                     cursorEvents: values["cursor-events"] === true
-                        ? { repos: (_x = values.repo) !== null && _x !== void 0 ? _x : [] }
+                        ? { repos: (_y = values.repo) !== null && _y !== void 0 ? _y : [] }
                         : undefined,
                     // Soft boot logs stay secondary to the banner. `dim` is a no-op on
                     // already-styled lines (the MCP warning box).
@@ -1247,6 +1267,8 @@ function axFromOptions(partial) {
         sessionId: partial.sessionId,
         resume: partial.resume,
         continuationToken: partial.continuationToken,
+        dryRun: partial.dryRun,
+        asOf: partial.asOf,
         timeoutMs: partial.timeoutMs,
         events: partial.events,
         text: partial.text,

package/dist/channels/bitbucket/api.d.ts

@@ -136,6 +136,8 @@ export interface BitbucketApiPullRequest {
     title?: string;
     description?: string;
     state?: string;
+    draft?: boolean;
+    authorUsername?: string;
     sourceBranch?: string;
     targetBranch?: string;
     headSha?: string;
@@ -143,6 +145,18 @@ export interface BitbucketApiPullRequest {
     htmlUrl?: string;
     raw: unknown;
 }
+export interface BitbucketApiChangedFile {
+    path: string;
+    previousPath?: string;
+    status: "added" | "modified" | "removed" | "renamed";
+    patch?: string;
+}
+export interface BitbucketPullRequestDiffInput {
+    headSha?: string;
+    baseSha?: string;
+    mergeBaseSha?: string;
+    mergeBaseResolved?: boolean;
+}
 /**
  * The handful of operations review products need, implemented once per
  * dialect. `ctx.bitbucket.api` is the repo-bound instance.
@@ -159,6 +173,29 @@ export interface BitbucketApi {
     /** Raw file contents at `ref` (branch, tag, or SHA). */
     getFileAtRef(path: string, ref: string): Promise<string>;
 }
+export interface BitbucketPullRequestReadApi {
+    getPullRequest(id: number): Promise<BitbucketApiPullRequest>;
+    getMergeBaseSha(id: number, base: string, headSha: string): Promise<string | undefined>;
+    listChangedFiles(id: number, input?: BitbucketPullRequestDiffInput): Promise<BitbucketApiChangedFile[]>;
+}
+export interface BitbucketPullRequestReadClient {
+    readonly repository: BitbucketRepositoryRef;
+    readonly api: Pick<BitbucketApi, "getPullRequest" | "getPullRequestDiff">;
+    request<T = unknown>(input: BitbucketRequestInput): Promise<T>;
+}
+export type BitbucketPullRequestReadDiagnostic = {
+    kind: "commit-expansion-failed";
+    sha: string;
+    error: unknown;
+} | {
+    kind: "diff-fallback";
+    status: number;
+} | {
+    kind: "metadata-fallback";
+    status: number;
+};
+/** Split a Git-style unified diff into normalized changed files. */
+export declare function splitBitbucketUnifiedDiff(diff: string): BitbucketApiChangedFile[];
 /** `/repositories/{workspace}/{slug}` — Bitbucket Cloud 2.0. */
 export declare function bitbucketCloudRepoPath(repository: {
     owner: string;
@@ -169,6 +206,10 @@ export declare function bitbucketDataCenterRepoPath(repository: {
     owner: string;
     slug: string;
 }): string;
+export declare function expandBitbucketCloudCommitSha(bitbucket: Pick<BitbucketClient, "request">, repository: Pick<BitbucketRepositoryRef, "owner" | "slug">, sha: string | undefined, onError?: (error: unknown) => void): Promise<string | undefined>;
+export declare function createBitbucketPullRequestReadApi(bitbucket: BitbucketPullRequestReadClient, options?: {
+    onDiagnostic?: (diagnostic: BitbucketPullRequestReadDiagnostic) => void;
+}): BitbucketPullRequestReadApi;
 export declare function cloudBitbucketApi(client: BitbucketClient, repository: BitbucketRepositoryRef): BitbucketApi;
 export declare function dcBitbucketApi(client: BitbucketClient, repository: BitbucketRepositoryRef): BitbucketApi;
 /** Pick the dialect implementation for `repository.dialect`. */

package/dist/channels/bitbucket/api.d.ts.map

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

package/dist/channels/bitbucket/api.js

@@ -166,6 +166,102 @@ function num(value) {
         ? value
         : undefined;
 }
+function errorStatus(error) {
+    var _a;
+    return num((_a = asRecord(error)) === null || _a === void 0 ? void 0 : _a.status);
+}
+function bitbucketAuthorUsername(raw) {
+    var _a;
+    var _b, _c, _d, _e;
+    const author = asRecord((_a = asRecord(raw)) === null || _a === void 0 ? void 0 : _a.author);
+    const user = asRecord(author === null || author === void 0 ? void 0 : author.user);
+    return ((_e = (_d = (_c = (_b = str(author === null || author === void 0 ? void 0 : author.nickname)) !== null && _b !== void 0 ? _b : str(user === null || user === void 0 ? void 0 : user.name)) !== null && _c !== void 0 ? _c : str(user === null || user === void 0 ? void 0 : user.slug)) !== null && _d !== void 0 ? _d : str(author === null || author === void 0 ? void 0 : author.display_name)) !== null && _e !== void 0 ? _e : str(user === null || user === void 0 ? void 0 : user.displayName));
+}
+const GIT_PATH_ESCAPES = {
+    a: "\u0007",
+    b: "\b",
+    f: "\f",
+    n: "\n",
+    r: "\r",
+    t: "\t",
+    v: "\v",
+    "\\": "\\",
+    '"': '"',
+};
+function unescapeGitPath(path, quoted) {
+    var _a, _b;
+    if (!quoted) {
+        return path;
+    }
+    const bytes = [];
+    let output = "";
+    const flush = () => {
+        if (bytes.length > 0) {
+            output += Buffer.from(bytes).toString("utf8");
+            bytes.length = 0;
+        }
+    };
+    for (let index = 0; index < path.length; index += 1) {
+        const character = path[index];
+        if (character !== "\\") {
+            flush();
+            output += character;
+            continue;
+        }
+        const octal = /^[0-7]{1,3}/.exec(path.slice(index + 1));
+        if (octal !== null) {
+            bytes.push(Number.parseInt(octal[0], 8));
+            index += octal[0].length;
+            continue;
+        }
+        flush();
+        const next = (_a = path[index + 1]) !== null && _a !== void 0 ? _a : "";
+        output += (_b = GIT_PATH_ESCAPES[next]) !== null && _b !== void 0 ? _b : next;
+        index += 1;
+    }
+    flush();
+    return output;
+}
+/** Split a Git-style unified diff into normalized changed files. */
+export function splitBitbucketUnifiedDiff(diff) {
+    var _a, _b, _c, _d;
+    const files = [];
+    const sections = diff.split(/^(?=diff --git )/m).filter(Boolean);
+    for (const section of sections) {
+        const lines = section.replace(/\n$/, "").split("\n");
+        const header = /^diff --git ("?)a\/(.+?)\1 ("?)b\/(.+?)\3$/.exec((_a = lines[0]) !== null && _a !== void 0 ? _a : "");
+        if (header === null) {
+            continue;
+        }
+        const oldPath = unescapeGitPath((_b = header[2]) !== null && _b !== void 0 ? _b : "", header[1] !== "");
+        const newPath = unescapeGitPath((_c = header[4]) !== null && _c !== void 0 ? _c : "", header[3] !== "");
+        let status = "modified";
+        let bodyStart = 1;
+        for (; bodyStart < lines.length; bodyStart += 1) {
+            const line = (_d = lines[bodyStart]) !== null && _d !== void 0 ? _d : "";
+            if (line.startsWith("@@")) {
+                break;
+            }
+            if (line === "--- /dev/null") {
+                status = "added";
+            }
+            else if (line === "+++ /dev/null") {
+                status = "removed";
+            }
+        }
+        if (status === "modified" && oldPath !== newPath) {
+            status = "renamed";
+        }
+        const patch = lines.slice(bodyStart).join("\n");
+        files.push({
+            path: newPath,
+            previousPath: status === "renamed" ? oldPath : undefined,
+            status,
+            patch: patch === "" ? undefined : patch,
+        });
+    }
+    return files;
+}
 function encodePath(path) {
     return path
         .split("/")
@@ -187,6 +283,170 @@ export function bitbucketCloudRepoPath(repository) {
 export function bitbucketDataCenterRepoPath(repository) {
     return `/projects/${encodeURIComponent(repository.owner)}/repos/${encodeURIComponent(repository.slug)}`;
 }
+export function expandBitbucketCloudCommitSha(bitbucket, repository, sha, onError) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (sha === undefined || !/^[0-9a-f]{7,39}$/i.test(sha)) {
+            return sha;
+        }
+        try {
+            const commit = yield bitbucket.request({
+                method: "GET",
+                path: `${bitbucketCloudRepoPath(repository)}/commit/${encodeURIComponent(sha)}`,
+            });
+            return /^[0-9a-f]{40}$/i.test((_a = commit.hash) !== null && _a !== void 0 ? _a : "") ? commit.hash : sha;
+        }
+        catch (error) {
+            onError === null || onError === void 0 ? void 0 : onError(error);
+            return sha;
+        }
+    });
+}
+function bitbucketPullRequestFromRaw(raw, id, htmlUrl) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _j, _k, _l, _m;
+    const source = asRecord(raw.source);
+    const destination = asRecord(raw.destination);
+    return {
+        id,
+        title: str(raw.title),
+        description: str(raw.description),
+        state: str(raw.state),
+        draft: typeof raw.draft === "boolean" ? raw.draft : undefined,
+        authorUsername: bitbucketAuthorUsername(raw),
+        sourceBranch: (_j = str((_a = asRecord(source === null || source === void 0 ? void 0 : source.branch)) === null || _a === void 0 ? void 0 : _a.name)) !== null && _j !== void 0 ? _j : str((_b = asRecord(raw.fromRef)) === null || _b === void 0 ? void 0 : _b.displayId),
+        targetBranch: (_k = str((_c = asRecord(destination === null || destination === void 0 ? void 0 : destination.branch)) === null || _c === void 0 ? void 0 : _c.name)) !== null && _k !== void 0 ? _k : str((_d = asRecord(raw.toRef)) === null || _d === void 0 ? void 0 : _d.displayId),
+        headSha: (_l = str((_e = asRecord(source === null || source === void 0 ? void 0 : source.commit)) === null || _e === void 0 ? void 0 : _e.hash)) !== null && _l !== void 0 ? _l : str((_f = asRecord(raw.fromRef)) === null || _f === void 0 ? void 0 : _f.latestCommit),
+        baseSha: (_m = str((_g = asRecord(destination === null || destination === void 0 ? void 0 : destination.commit)) === null || _g === void 0 ? void 0 : _g.hash)) !== null && _m !== void 0 ? _m : str((_h = asRecord(raw.toRef)) === null || _h === void 0 ? void 0 : _h.latestCommit),
+        htmlUrl,
+        raw,
+    };
+}
+export function createBitbucketPullRequestReadApi(bitbucket, options = {}) {
+    const { repository } = bitbucket;
+    const repo = repository.dialect === "cloud"
+        ? bitbucketCloudRepoPath(repository)
+        : bitbucketDataCenterRepoPath(repository);
+    const cloudPullRequestFromActivity = (id) => __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        let path = `${repo}/pullrequests/${id}/activity`;
+        let query = { pagelen: 50 };
+        for (let page = 0; page < 20; page += 1) {
+            const response = yield bitbucket.request({
+                method: "GET",
+                path,
+                query,
+            });
+            for (const value of Array.isArray(response.values)
+                ? response.values
+                : []) {
+                const update = asRecord((_a = asRecord(value)) === null || _a === void 0 ? void 0 : _a.update);
+                if (update !== undefined) {
+                    return bitbucketPullRequestFromRaw(update, id);
+                }
+            }
+            const next = str(response.next);
+            if (next === undefined) {
+                return undefined;
+            }
+            const nextUrl = new URL(next);
+            const marker = nextUrl.pathname.indexOf("/repositories/");
+            path = marker === -1 ? nextUrl.pathname : nextUrl.pathname.slice(marker);
+            query = Object.fromEntries(nextUrl.searchParams.entries());
+        }
+        return undefined;
+    });
+    return {
+        getPullRequest(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                let pullRequest;
+                try {
+                    pullRequest = yield bitbucket.api.getPullRequest(id);
+                }
+                catch (error) {
+                    const status = errorStatus(error);
+                    if (repository.dialect !== "cloud" ||
+                        status === undefined ||
+                        status < 500) {
+                        throw error;
+                    }
+                    (_a = options.onDiagnostic) === null || _a === void 0 ? void 0 : _a.call(options, { kind: "metadata-fallback", status });
+                    const fallback = yield cloudPullRequestFromActivity(id);
+                    if (fallback === undefined) {
+                        throw error;
+                    }
+                    pullRequest = fallback;
+                }
+                const normalized = Object.assign(Object.assign({}, pullRequest), { draft: ((_b = asRecord(pullRequest.raw)) === null || _b === void 0 ? void 0 : _b.draft) === true, authorUsername: bitbucketAuthorUsername(pullRequest.raw) });
+                if (repository.dialect !== "cloud") {
+                    return normalized;
+                }
+                const [headSha, baseSha] = yield Promise.all([
+                    expandBitbucketCloudCommitSha(bitbucket, repository, pullRequest.headSha, (error) => { var _a; return pullRequest.headSha === undefined
+                        ? undefined
+                        : (_a = options.onDiagnostic) === null || _a === void 0 ? void 0 : _a.call(options, {
+                            kind: "commit-expansion-failed",
+                            sha: pullRequest.headSha,
+                            error,
+                        }); }),
+                    expandBitbucketCloudCommitSha(bitbucket, repository, pullRequest.baseSha, (error) => { var _a; return pullRequest.baseSha === undefined
+                        ? undefined
+                        : (_a = options.onDiagnostic) === null || _a === void 0 ? void 0 : _a.call(options, {
+                            kind: "commit-expansion-failed",
+                            sha: pullRequest.baseSha,
+                            error,
+                        }); }),
+                ]);
+                return Object.assign(Object.assign({}, normalized), { headSha, baseSha });
+            });
+        },
+        getMergeBaseSha(id, base, headSha) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (repository.dialect === "cloud") {
+                    const commit = yield bitbucket.request({
+                        method: "GET",
+                        path: `${repo}/merge-base/${encodeURIComponent(headSha)}..${encodeURIComponent(base)}`,
+                    });
+                    return str(commit.hash);
+                }
+                const commit = yield bitbucket.request({
+                    method: "GET",
+                    path: `${repo}/pull-requests/${id}/merge-base`,
+                });
+                return str(commit.id);
+            });
+        },
+        listChangedFiles(id, input) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                var _b;
+                try {
+                    return splitBitbucketUnifiedDiff(yield bitbucket.api.getPullRequestDiff(id));
+                }
+                catch (error) {
+                    const status = errorStatus(error);
+                    const comparisonBase = (_b = input === null || input === void 0 ? void 0 : input.mergeBaseSha) !== null && _b !== void 0 ? _b : input === null || input === void 0 ? void 0 : input.baseSha;
+                    if (repository.dialect !== "cloud" ||
+                        status === undefined ||
+                        status < 500 ||
+                        (input === null || input === void 0 ? void 0 : input.headSha) === undefined ||
+                        comparisonBase === undefined) {
+                        throw error;
+                    }
+                    (_a = options.onDiagnostic) === null || _a === void 0 ? void 0 : _a.call(options, { kind: "diff-fallback", status });
+                    const diff = yield bitbucket.request({
+                        method: "GET",
+                        path: `${repo}/diff/${encodeURIComponent(input.headSha)}..${encodeURIComponent(comparisonBase)}`,
+                        query: { topic: input.mergeBaseResolved === true ? "false" : "true" },
+                        accept: "text/plain",
+                    });
+                    return splitBitbucketUnifiedDiff(diff);
+                }
+            });
+        },
+    };
+}
 export function cloudBitbucketApi(client, repository) {
     const repo = bitbucketCloudRepoPath(repository);
     const mapComment = (raw) => {

package/dist/channels/bitbucket/binding.d.ts

@@ -59,6 +59,10 @@ export declare function bitbucketRepositoryFromPayload(payload: Record<string, u
 /** Cloud `{uuid, display_name, nickname}` or DC `{id, name, displayName}`. */
 export declare function bitbucketUser(value: unknown): BitbucketUser | undefined;
 export declare function bitbucketPullRequestUrl(repository: BitbucketRepositoryRef, id: number, explicit?: string): string;
+/** Absolute PR URL, or undefined when a Data Center payload has no repo URL. */
+export declare function bitbucketAbsolutePullRequestUrl(repository: BitbucketRepositoryRef, id: number, explicit?: string): string | undefined;
+/** Whether a Data Center `updated` payload publishes a draft pull request. */
+export declare function bitbucketDraftMarkedReady(payload: Record<string, unknown>, draft: boolean | undefined): boolean;
 /**
  * Normalize the pull request from either dialect. `action` is the suffix of
  * the Cloud-normalized event key (`pullrequest:created` → `created`).

package/dist/channels/bitbucket/binding.d.ts.map

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