@cursor/july 0.1.75 → 0.1.76

package/dist/internal/authored-alias-hooks.d.ts

@@ -14,10 +14,22 @@
  *   project's own node_modules; `fallbackAliases` only apply when that
  *   fails (npx/global installs, projects without a local dependency), so a
  *   real install in the user's project keeps precedence.
+ *
+ * A third case is first-party factory agents that relative-import this
+ * package's `src/` from a monorepo checkout. Hosted engines `npm install`
+ * only the agent directory, so files under `packages/agent-serve/src` have
+ * no `node_modules`. Bare specifiers from that tree (`zod`, octokit, …)
+ * retry against the running `@cursor/july` package.json, which does.
  */
 export interface AuthoredAliasHookData {
     directAliases: Record<string, string>;
     fallbackAliases: Record<string, string>;
+    /**
+     * `file:` URL of the running `@cursor/july` package.json. Bare imports
+     * from monorepo `packages/agent-serve/` source retry against this parent
+     * when the source tree has no `node_modules` (hosted factory engines).
+     */
+    sourceTreeFallbackParentURL?: string;
 }
 export declare function initialize(data: AuthoredAliasHookData): void;
 interface ResolveResult {

package/dist/internal/authored-alias-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authored-alias-hooks.d.ts","sourceRoot":"","sources":["../../src/internal/authored-alias-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAQD,wBAAgB,UAAU,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAG5D;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,KAAK,WAAW,GAAG,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,KACb,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,GACvB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxC"}
+{"version":3,"file":"authored-alias-hooks.d.ts","sourceRoot":"","sources":["../../src/internal/authored-alias-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAQD,wBAAgB,UAAU,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAM5D;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,KAAK,WAAW,GAAG,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,KACb,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,GACvB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBxC"}

package/dist/internal/authored-alias-hooks.js

@@ -14,17 +14,27 @@
  *   project's own node_modules; `fallbackAliases` only apply when that
  *   fails (npx/global installs, projects without a local dependency), so a
  *   real install in the user's project keeps precedence.
+ *
+ * A third case is first-party factory agents that relative-import this
+ * package's `src/` from a monorepo checkout. Hosted engines `npm install`
+ * only the agent directory, so files under `packages/agent-serve/src` have
+ * no `node_modules`. Bare specifiers from that tree (`zod`, octokit, …)
+ * retry against the running `@cursor/july` package.json, which does.
  */
 // Null-prototype copies so specifiers like "constructor" or "__proto__"
 // can never resolve to inherited Object.prototype members.
 let directAliases = toNullProtoMap({});
 let fallbackAliases = toNullProtoMap({});
+let sourceTreeFallbackParentURL;
 function toNullProtoMap(source) {
     return Object.assign(Object.create(null), source);
 }
 export function initialize(data) {
     directAliases = toNullProtoMap(data.directAliases);
     fallbackAliases = toNullProtoMap(data.fallbackAliases);
+    const parent = data.sourceTreeFallbackParentURL;
+    sourceTreeFallbackParentURL =
+        typeof parent === "string" && parent !== "" ? parent : undefined;
 }
 export function resolve(specifier, context, nextResolve) {
     const direct = directAliases[specifier];
@@ -32,12 +42,54 @@ export function resolve(specifier, context, nextResolve) {
         return { url: direct, shortCircuit: true };
     }
     const fallback = fallbackAliases[specifier];
-    if (fallback === undefined) {
-        // Not ours: pass through with no promise/try-catch overhead. This hook
-        // runs on every module resolution in the process.
-        return nextResolve(specifier, context);
-    }
-    return Promise.resolve()
-        .then(() => nextResolve(specifier, context))
-        .catch(() => ({ url: fallback, shortCircuit: true }));
+    if (fallback !== undefined) {
+        return Promise.resolve()
+            .then(() => nextResolve(specifier, context))
+            .catch(() => ({ url: fallback, shortCircuit: true }));
+    }
+    if (sourceTreeFallbackParentURL !== undefined &&
+        isBarePackageSpecifier(specifier) &&
+        isMonorepoAgentServeSource(parentURLOf(context))) {
+        const retryParent = sourceTreeFallbackParentURL;
+        return Promise.resolve()
+            .then(() => nextResolve(specifier, context))
+            .catch(() => nextResolve(specifier, withParentURL(context, retryParent)));
+    }
+    // Not ours: pass through with no promise/try-catch overhead. This hook
+    // runs on every module resolution in the process.
+    return nextResolve(specifier, context);
+}
+function parentURLOf(context) {
+    if (context === null || typeof context !== "object") {
+        return undefined;
+    }
+    const parentURL = context.parentURL;
+    return typeof parentURL === "string" ? parentURL : undefined;
+}
+function withParentURL(context, parentURL) {
+    if (context !== null && typeof context === "object") {
+        return Object.assign(Object.assign({}, context), { parentURL });
+    }
+    return { parentURL };
+}
+function isBarePackageSpecifier(specifier) {
+    if (specifier.length === 0) {
+        return false;
+    }
+    const first = specifier[0];
+    if (first === "." || first === "/" || first === "\\") {
+        return false;
+    }
+    return !(specifier.startsWith("node:") ||
+        specifier.startsWith("file:") ||
+        specifier.startsWith("data:") ||
+        specifier.startsWith("http:") ||
+        specifier.startsWith("https:"));
+}
+function isMonorepoAgentServeSource(parentURL) {
+    if (parentURL === undefined) {
+        return false;
+    }
+    return (parentURL.includes("/packages/agent-serve/") &&
+        !parentURL.includes("/node_modules/"));
 }

package/dist/internal/authored-loaders.d.ts

@@ -11,9 +11,11 @@
  * imports of the framework resolve against the running package: the
  * historical `@anysphere/agent-serve[/x]` name always, and
  * `@cursor/july[/x]` / `@cursor/agentkit[/x]` as fallbacks when the user's
- * project has no local install (npx / global). Source runs (tsx from the
- * monorepo) skip both — the host loader and tsconfig paths already cover
- * them.
+ * project has no local install (npx / global). The same hooks retry bare
+ * npm specifiers from monorepo `packages/agent-serve/` source against this
+ * package (hosted factory engines install only the agent directory).
+ * Source runs (tsx from the monorepo) skip both — the host loader and
+ * tsconfig paths already cover them.
  */
 /**
  * ESM specifier for an authored agent/eval file.

package/dist/internal/authored-loaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authored-loaders.d.ts","sourceRoot":"","sources":["../../src/internal/authored-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC;AAID;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAS7D"}
+{"version":3,"file":"authored-loaders.d.ts","sourceRoot":"","sources":["../../src/internal/authored-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAyBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC;AAID;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAS7D"}

package/dist/internal/authored-loaders.js

@@ -11,9 +11,11 @@
  * imports of the framework resolve against the running package: the
  * historical `@anysphere/agent-serve[/x]` name always, and
  * `@cursor/july[/x]` / `@cursor/agentkit[/x]` as fallbacks when the user's
- * project has no local install (npx / global). Source runs (tsx from the
- * monorepo) skip both — the host loader and tsconfig paths already cover
- * them.
+ * project has no local install (npx / global). The same hooks retry bare
+ * npm specifiers from monorepo `packages/agent-serve/` source against this
+ * package (hosted factory engines install only the agent directory).
+ * Source runs (tsx from the monorepo) skip both — the host loader and
+ * tsconfig paths already cover them.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -160,7 +162,14 @@ function registerFrameworkAliases() {
         fallbackAliases[`${AGENTKIT_PACKAGE_NAME}${suffix}`] = target;
     }
     const hooksUrl = new URL("./authored-alias-hooks.js", import.meta.url);
-    const data = { directAliases, fallbackAliases };
+    const data = {
+        directAliases,
+        fallbackAliases,
+        // Hosted factory agents relative-import this package's src/ from a
+        // monorepo checkout while npm install ran only in the agent directory.
+        // Bare specifiers from that tree retry against this package.json.
+        sourceTreeFallbackParentURL: pathToFileURL(join(packageRootDir(), "package.json")).href,
+    };
     // `node:module`'s register() is synchronous: it blocks until the hooks
     // thread has initialized, so the aliases are active when it returns.
     registerModuleHooks(hooksUrl, { data });

package/dist/internal/deployment-scm-event-stream.js

@@ -42,10 +42,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-// Node builtins only: hosted engines install the consuming agent's directory
-// alone and load this file as raw TypeScript source, so third-party imports
-// (even zod) do not resolve from here. See the tenant-mcp internals for the
-// same constraint.
+// Hosted engines install the consuming agent's directory alone and load this
+// file as raw TypeScript source. Relative and `node:` imports resolve here;
+// this package's own npm dependencies retry against the running `@cursor/july`
+// install (authored-alias-hooks). Do not add deps that package does not have.
 import { createHmac } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { join } from "node:path";

package/dist/internal/review-comments.d.ts

@@ -94,6 +94,38 @@ export type GetReviewCommentsArgs = {
 export type ReviewCommentReaderImplementation = {
     getReviewComments: (args: GetReviewCommentsArgs) => Promise<ExistingReviewComment[]>;
 };
+export type ResolveReviewThreadsArgs = {
+    target: ScmReviewTarget;
+    /** REST comment ids whose threads should be resolved. */
+    commentIds: readonly number[];
+    signal?: AbortSignal;
+};
+/**
+ * Outcome of resolving review threads for a set of comment ids. Callers
+ * treat this as best-effort actuation: a failed resolve must not fail the
+ * review that already posted.
+ */
+export type ResolveReviewThreadsResult = {
+    requested: number;
+    resolved: number;
+    alreadyResolved: number;
+    notFound: number;
+    failed: number;
+    detail: string;
+};
+/**
+ * Write side of thread resolution, the counterpart of
+ * {@link ReviewCommentReaderImplementation}. Bugbot's equivalent is
+ * `IGitProvider.resolveReviewThreadForComment` / `resolveThreads`.
+ *
+ * GitHub only exposes resolve via GraphQL (`resolveReviewThread`). REST
+ * has no equivalent. The mutation runs as whatever identity minted the
+ * bound GitHub client — for `githubChannel({ cursorAccount })` that is
+ * the Cursor installation, the same identity that posted the comments.
+ */
+export type ReviewThreadResolverImplementation = {
+    resolveReviewThreadsForComments: (args: ResolveReviewThreadsArgs) => Promise<ResolveReviewThreadsResult>;
+};
 /** Parse a PR URL into the SCM target to read comments from. */
 export declare function resolveScmReviewTarget(prUrl: string): ScmReviewTarget | undefined;
 /**
@@ -105,11 +137,41 @@ export declare function createReviewCommentReader(args: {
     target: ScmReviewTarget;
     github?: HostGitHubClient;
 }): ReviewCommentReaderImplementation | undefined;
+/**
+ * Resolver for a resolved target. Returns undefined when the host cannot
+ * serve that provider, so callers degrade instead of throwing.
+ */
+export declare function createReviewThreadResolver(args: {
+    target: ScmReviewTarget;
+    github?: HostGitHubClient;
+}): ReviewThreadResolverImplementation | undefined;
+/**
+ * Resolve the review threads that own `commentIds` on `prUrl`.
+ *
+ * No-ops (never throws) when the PR is on an SCM this host cannot write,
+ * no client is bound, or `commentIds` is empty. Same degrade-don't-fail
+ * posture as {@link createReviewCommentReader}.
+ */
+export declare function resolveReviewThreadsForComments(args: {
+    prUrl: string;
+    commentIds: readonly number[];
+    github?: HostGitHubClient;
+    resolver?: ReviewThreadResolverImplementation;
+    signal?: AbortSignal;
+}): Promise<ResolveReviewThreadsResult>;
 /**
  * Reads inline review comments through the host GitHub client (Cursor
  * account lease, App installation token, or PAT).
  */
 export declare function createHostGithubReviewCommentReader(github: HostGitHubClient): ReviewCommentReaderImplementation;
+/**
+ * Resolves inline review threads through the host GitHub client (Cursor
+ * account lease, App installation token, or PAT). GitHub GraphQL has no
+ * comment→thread field, so this pages the PR's review threads and matches
+ * each REST comment id by `databaseId` — the same approach as Bugbot's
+ * `resolveReviewThreadForComment`.
+ */
+export declare function createHostGithubReviewThreadResolver(github: HostGitHubClient): ReviewThreadResolverImplementation;
 type GithubReviewCommentLike = {
     id: number;
     path: string;

package/dist/internal/review-comments.d.ts.map

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

package/dist/internal/review-comments.js

@@ -32,9 +32,55 @@ export function createReviewCommentReader(args) {
                 : createHostGithubReviewCommentReader(args.github);
     }
 }
+/**
+ * Resolver for a resolved target. Returns undefined when the host cannot
+ * serve that provider, so callers degrade instead of throwing.
+ */
+export function createReviewThreadResolver(args) {
+    switch (args.target.provider) {
+        case "github":
+            return args.github === undefined
+                ? undefined
+                : createHostGithubReviewThreadResolver(args.github);
+    }
+}
+/**
+ * Resolve the review threads that own `commentIds` on `prUrl`.
+ *
+ * No-ops (never throws) when the PR is on an SCM this host cannot write,
+ * no client is bound, or `commentIds` is empty. Same degrade-don't-fail
+ * posture as {@link createReviewCommentReader}.
+ */
+export function resolveReviewThreadsForComments(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (args.commentIds.length === 0) {
+            return skippedResolve("no comments to resolve");
+        }
+        const target = resolveScmReviewTarget(args.prUrl);
+        if (target === undefined) {
+            return skippedResolve("no SCM resolver for this PR URL");
+        }
+        const resolver = (_a = args.resolver) !== null && _a !== void 0 ? _a : createReviewThreadResolver({
+            target,
+            github: args.github,
+        });
+        if (resolver === undefined) {
+            return skippedResolve("no GitHub client bound to resolve threads");
+        }
+        return resolver.resolveReviewThreadsForComments({
+            target,
+            commentIds: args.commentIds,
+            signal: args.signal,
+        });
+    });
+}
 /** Cap on pages pulled per PR; GitHub serves 100 comments per page. */
 const REVIEW_COMMENTS_MAX_PAGES = 5;
 const REVIEW_COMMENTS_PAGE_SIZE = 100;
+/** Cap on review-thread pages when mapping comment ids to GraphQL thread ids. */
+const REVIEW_THREADS_MAX_PAGES = 20;
+const REVIEW_THREADS_PAGE_SIZE = 100;
 /**
  * Reads inline review comments through the host GitHub client (Cursor
  * account lease, App installation token, or PAT).
@@ -72,6 +118,149 @@ export function createHostGithubReviewCommentReader(github) {
         },
     };
 }
+/**
+ * Resolves inline review threads through the host GitHub client (Cursor
+ * account lease, App installation token, or PAT). GitHub GraphQL has no
+ * comment→thread field, so this pages the PR's review threads and matches
+ * each REST comment id by `databaseId` — the same approach as Bugbot's
+ * `resolveReviewThreadForComment`.
+ */
+export function createHostGithubReviewThreadResolver(github) {
+    return {
+        resolveReviewThreadsForComments(_a) {
+            return __awaiter(this, arguments, void 0, function* ({ target, commentIds, signal }) {
+                var _b, _c, _d, _e, _f;
+                var _g, _h;
+                const uniqueIds = [...new Set(commentIds.filter((id) => id > 0))];
+                if (uniqueIds.length === 0) {
+                    return skippedResolve("no comments to resolve");
+                }
+                const [owner, repo] = target.repo.split("/", 2);
+                if (owner === undefined || repo === undefined || repo === "") {
+                    return skippedResolve("unparseable owner/repo from PR URL");
+                }
+                try {
+                    const octokit = yield github.getOctokit();
+                    const wanted = new Set(uniqueIds);
+                    const matched = new Map();
+                    let cursor = null;
+                    for (let page = 0; page < REVIEW_THREADS_MAX_PAGES; page++) {
+                        signal === null || signal === void 0 ? void 0 : signal.throwIfAborted();
+                        const response = (yield octokit.graphql(REVIEW_THREADS_FOR_PR_QUERY, {
+                            owner,
+                            repo,
+                            number: target.prNumber,
+                            cursor,
+                        }));
+                        const reviewThreads = (_c = (_b = response.repository) === null || _b === void 0 ? void 0 : _b.pullRequest) === null || _c === void 0 ? void 0 : _c.reviewThreads;
+                        for (const thread of (_g = reviewThreads === null || reviewThreads === void 0 ? void 0 : reviewThreads.nodes) !== null && _g !== void 0 ? _g : []) {
+                            if ((thread === null || thread === void 0 ? void 0 : thread.id) === undefined || thread.id === "") {
+                                continue;
+                            }
+                            for (const comment of (_h = (_d = thread.comments) === null || _d === void 0 ? void 0 : _d.nodes) !== null && _h !== void 0 ? _h : []) {
+                                const databaseId = comment === null || comment === void 0 ? void 0 : comment.databaseId;
+                                if (databaseId !== undefined &&
+                                    databaseId !== null &&
+                                    wanted.has(databaseId) &&
+                                    !matched.has(databaseId)) {
+                                    matched.set(databaseId, {
+                                        threadId: thread.id,
+                                        isResolved: thread.isResolved === true,
+                                    });
+                                }
+                            }
+                        }
+                        if (matched.size === wanted.size) {
+                            break;
+                        }
+                        const pageInfo = reviewThreads === null || reviewThreads === void 0 ? void 0 : reviewThreads.pageInfo;
+                        if ((pageInfo === null || pageInfo === void 0 ? void 0 : pageInfo.hasNextPage) !== true || !pageInfo.endCursor) {
+                            break;
+                        }
+                        cursor = pageInfo.endCursor;
+                    }
+                    const toResolve = [
+                        ...new Map([...matched.values()]
+                            .filter((thread) => !thread.isResolved)
+                            .map((thread) => [thread.threadId, thread.threadId])).values(),
+                    ];
+                    let resolved = 0;
+                    let failed = 0;
+                    for (const threadId of toResolve) {
+                        signal === null || signal === void 0 ? void 0 : signal.throwIfAborted();
+                        try {
+                            const mutation = (yield octokit.graphql(RESOLVE_REVIEW_THREAD_MUTATION, { threadId }));
+                            if (((_f = (_e = mutation.resolveReviewThread) === null || _e === void 0 ? void 0 : _e.thread) === null || _f === void 0 ? void 0 : _f.isResolved) === true) {
+                                resolved += 1;
+                            }
+                            else {
+                                failed += 1;
+                            }
+                        }
+                        catch (_j) {
+                            failed += 1;
+                        }
+                    }
+                    const alreadyResolved = new Set([...matched.values()]
+                        .filter((thread) => thread.isResolved)
+                        .map((thread) => thread.threadId)).size;
+                    const notFound = wanted.size - matched.size;
+                    return {
+                        requested: uniqueIds.length,
+                        resolved,
+                        alreadyResolved,
+                        notFound,
+                        failed,
+                        detail: `resolved ${resolved} of ${toResolve.length} open thread(s) for ${uniqueIds.length} comment(s) via host GitHub (${alreadyResolved} already resolved, ${notFound} not found, ${failed} failed)`,
+                    };
+                }
+                catch (error) {
+                    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                        throw error;
+                    }
+                    return {
+                        requested: uniqueIds.length,
+                        resolved: 0,
+                        alreadyResolved: 0,
+                        notFound: 0,
+                        failed: uniqueIds.length,
+                        detail: `host GitHub thread resolve failed: ${error instanceof Error ? error.message : String(error)}`,
+                    };
+                }
+            });
+        },
+    };
+}
+const REVIEW_THREADS_FOR_PR_QUERY = `
+query ReviewThreadsForPr(
+  $owner: String!
+  $repo: String!
+  $number: Int!
+  $cursor: String
+) {
+  repository(owner: $owner, name: $repo) {
+    pullRequest(number: $number) {
+      reviewThreads(first: ${REVIEW_THREADS_PAGE_SIZE}, after: $cursor) {
+        nodes {
+          id
+          isResolved
+          comments(first: ${REVIEW_THREADS_PAGE_SIZE}) {
+            nodes { databaseId }
+          }
+        }
+        pageInfo { hasNextPage endCursor }
+      }
+    }
+  }
+}
+`;
+const RESOLVE_REVIEW_THREAD_MUTATION = `
+mutation ResolveReviewThread($threadId: ID!) {
+  resolveReviewThread(input: { threadId: $threadId }) {
+    thread { isResolved }
+  }
+}
+`;
 /**
  * GitHub review comment → {@link ExistingReviewComment}.
  *
@@ -334,6 +523,16 @@ function skippedHost(detail) {
         detail,
     };
 }
+function skippedResolve(detail) {
+    return {
+        requested: 0,
+        resolved: 0,
+        alreadyResolved: 0,
+        notFound: 0,
+        failed: 0,
+        detail,
+    };
+}
 function parseGithubPrUrl(prUrl) {
     let url;
     try {