paperclip-github-plugin 0.7.4 → 0.8.0

package/dist/worker.js

@@ -223,6 +223,21 @@ var GITHUB_AGENT_TOOLS = [
       }
     }
   },
+  {
+    name: "assign_to_current_user",
+    displayName: "Assign To Current User",
+    description: "Assign a GitHub issue to the GitHub user authenticated by the saved token, preserving any existing assignees.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
   {
     name: "add_issue_comment",
     displayName: "Add Issue Comment",
@@ -2243,6 +2258,40 @@ function doesImportedIssueMatchTarget(issue, target) {
   }
   return target.issueId !== void 0 && issue.paperclipIssueId === target.issueId || target.githubIssueId !== void 0 && issue.githubIssueId === target.githubIssueId || target.githubIssueNumber !== void 0 && issue.githubIssueNumber === target.githubIssueNumber;
 }
+function resolvePaperclipIssueOriginGitHubIssueLink(issue, companyId) {
+  if (issue?.originKind !== GITHUB_ISSUE_ORIGIN_KIND || typeof issue.originId !== "string") {
+    return null;
+  }
+  const reference = parseGitHubIssueHtmlUrl(issue.originId);
+  if (!reference) {
+    return null;
+  }
+  return {
+    source: "issue_origin",
+    companyId,
+    paperclipProjectId: issue.projectId ?? void 0,
+    repositoryUrl: reference.repositoryUrl,
+    githubIssueNumber: reference.issueNumber,
+    githubIssueUrl: reference.issueUrl,
+    linkedPullRequestNumbers: [],
+    linkedPullRequests: []
+  };
+}
+function resolvePaperclipIssueOriginGitHubPullRequestLink(issue) {
+  if (issue?.originKind !== GITHUB_PULL_REQUEST_ORIGIN_KIND || typeof issue.originId !== "string") {
+    return null;
+  }
+  const reference = parseGitHubPullRequestHtmlUrl(issue.originId);
+  if (!reference) {
+    return null;
+  }
+  return {
+    source: "issue_origin",
+    repositoryUrl: reference.repositoryUrl,
+    githubPullRequestNumber: reference.pullRequestNumber,
+    githubPullRequestUrl: reference.pullRequestUrl
+  };
+}
 async function resolvePaperclipIssueGitHubLink(ctx, issueId, companyId, options = {}) {
   const linkRecords = options.linkRecords ?? await listGitHubIssueLinkRecords(ctx, {
     paperclipIssueId: issueId
@@ -2287,6 +2336,10 @@ async function resolvePaperclipIssueGitHubLink(ctx, issueId, companyId, options
     }
   }
   const issue = options.paperclipIssue ?? await ctx.issues.get(issueId, companyId);
+  const issueOriginLink = resolvePaperclipIssueOriginGitHubIssueLink(issue, companyId);
+  if (issueOriginLink) {
+    return await hydrateRecoveredPaperclipIssueGitHubLink(ctx, issueId, issueOriginLink) ?? issueOriginLink;
+  }
   const githubIssueUrl = extractImportedGitHubIssueUrlFromDescription(issue?.description);
   const githubIssueReference = githubIssueUrl ? parseGitHubIssueHtmlUrl(githubIssueUrl) : null;
   if (!githubIssueReference) {
@@ -2304,6 +2357,18 @@ async function resolvePaperclipIssueGitHubLink(ctx, issueId, companyId, options
   };
   return await hydrateRecoveredPaperclipIssueGitHubLink(ctx, issueId, fallbackLink) ?? fallbackLink;
 }
+async function resolvePaperclipIssueGitHubPullRequestLink(ctx, issueId, companyId) {
+  const links = await listGitHubPullRequestLinkRecords(ctx, {
+    paperclipIssueId: issueId
+  });
+  return links.filter((record) => !record.data.companyId || record.data.companyId === companyId).sort((left, right) => {
+    const rightTimestamp = Date.parse(right.updatedAt ?? right.createdAt ?? "");
+    const leftTimestamp = Date.parse(left.updatedAt ?? left.createdAt ?? "");
+    const safeRightTimestamp = Number.isFinite(rightTimestamp) ? rightTimestamp : 0;
+    const safeLeftTimestamp = Number.isFinite(leftTimestamp) ? leftTimestamp : 0;
+    return safeRightTimestamp - safeLeftTimestamp;
+  })[0] ?? null;
+}
 async function hydrateRecoveredPaperclipIssueGitHubLink(ctx, issueId, fallbackLink) {
   const repository = parseRepositoryReference(fallbackLink.repositoryUrl);
   if (!repository) {
@@ -2379,21 +2444,33 @@ async function resolveManualSyncTarget(ctx, settings, input) {
     }
     const link = await resolvePaperclipIssueGitHubLink(ctx, input.issueId, companyId2);
     if (!link) {
-      throw new Error("This Paperclip issue is not linked to a GitHub issue yet. Run a broader sync first.");
-    }
-    const candidateMappings = getSyncableMappingsForTarget(settings.mappings, {
-      kind: "issue",
-      companyId: companyId2,
-      projectId: link.paperclipProjectId,
-      repositoryUrl: link.repositoryUrl,
-      issueId: input.issueId,
-      githubIssueId: link.githubIssueId,
-      githubIssueNumber: link.githubIssueNumber,
-      githubIssueUrl: link.githubIssueUrl,
-      displayLabel: `issue #${link.githubIssueNumber}`
-    });
-    if (candidateMappings.length === 0) {
-      throw new Error("No saved GitHub repository mapping matches this Paperclip issue.");
+      const pullRequestLink = await resolvePaperclipIssueGitHubPullRequestLink(ctx, input.issueId, companyId2);
+      if (!pullRequestLink) {
+        throw new Error("This Paperclip issue is not linked to a GitHub issue or pull request yet. Run a broader sync first.");
+      }
+      const candidateMappings = getSyncableMappingsForTarget(settings.mappings, {
+        kind: "issue",
+        companyId: companyId2,
+        projectId: pullRequestLink.data.paperclipProjectId,
+        repositoryUrl: pullRequestLink.data.repositoryUrl,
+        issueId: input.issueId,
+        githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
+        githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
+        displayLabel: `pull request #${pullRequestLink.data.githubPullRequestNumber}`
+      });
+      if (candidateMappings.length === 0) {
+        throw new Error("No saved GitHub repository mapping matches this Paperclip issue.");
+      }
+      return {
+        kind: "issue",
+        companyId: companyId2,
+        projectId: pullRequestLink.data.paperclipProjectId,
+        issueId: input.issueId,
+        repositoryUrl: pullRequestLink.data.repositoryUrl,
+        githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
+        githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
+        displayLabel: `pull request #${pullRequestLink.data.githubPullRequestNumber}`
+      };
     }
     return {
       kind: "issue",
@@ -2517,23 +2594,46 @@ async function buildToolbarSyncState(ctx, input) {
   }
   if (entityType === "issue" && entityId && companyId) {
     const link = await resolvePaperclipIssueGitHubLink(ctx, entityId, companyId);
-    const mappings = link ? getSyncableMappingsForTarget(settings.mappings, {
+    if (link) {
+      const mappings2 = getSyncableMappingsForTarget(settings.mappings, {
+        kind: "issue",
+        companyId,
+        projectId: link.paperclipProjectId,
+        issueId: entityId,
+        repositoryUrl: link.repositoryUrl,
+        githubIssueId: link.githubIssueId,
+        githubIssueNumber: link.githubIssueNumber,
+        githubIssueUrl: link.githubIssueUrl,
+        displayLabel: `issue #${link.githubIssueNumber}`
+      });
+      return {
+        kind: "issue",
+        visible: false,
+        canRun: githubTokenConfigured && mappings2.length > 0,
+        label: `Sync #${link.githubIssueNumber}`,
+        message: `Sync ${link.repositoryUrl.replace(/^https:\/\/github\.com\//, "")} issue #${link.githubIssueNumber}.`,
+        syncState: settings.syncState,
+        githubTokenConfigured,
+        savedMappingCount
+      };
+    }
+    const pullRequestLink = await resolvePaperclipIssueGitHubPullRequestLink(ctx, entityId, companyId);
+    const mappings = pullRequestLink ? getSyncableMappingsForTarget(settings.mappings, {
       kind: "issue",
       companyId,
-      projectId: link.paperclipProjectId,
+      projectId: pullRequestLink.data.paperclipProjectId,
       issueId: entityId,
-      repositoryUrl: link.repositoryUrl,
-      githubIssueId: link.githubIssueId,
-      githubIssueNumber: link.githubIssueNumber,
-      githubIssueUrl: link.githubIssueUrl,
-      displayLabel: `issue #${link.githubIssueNumber}`
+      repositoryUrl: pullRequestLink.data.repositoryUrl,
+      githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
+      githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
+      displayLabel: `pull request #${pullRequestLink.data.githubPullRequestNumber}`
     }) : [];
     return {
       kind: "issue",
       visible: false,
       canRun: githubTokenConfigured && mappings.length > 0,
-      label: link?.githubIssueNumber ? `Sync #${link.githubIssueNumber}` : "Sync issue",
-      message: link ? `Sync ${link.repositoryUrl.replace(/^https:\/\/github\.com\//, "")} issue #${link.githubIssueNumber}.` : "This Paperclip issue is not linked to GitHub yet.",
+      label: pullRequestLink?.data.githubPullRequestNumber ? `Sync PR #${pullRequestLink.data.githubPullRequestNumber}` : "Sync issue",
+      message: pullRequestLink ? `Sync ${pullRequestLink.data.repositoryUrl.replace(/^https:\/\/github\.com\//, "")} pull request #${pullRequestLink.data.githubPullRequestNumber}.` : "This Paperclip issue is not linked to GitHub yet.",
       syncState: settings.syncState,
       githubTokenConfigured,
       savedMappingCount
@@ -2747,26 +2847,45 @@ async function buildIssueGitHubDetails(ctx, input) {
     const safeLeftTimestamp = Number.isFinite(leftTimestamp) ? leftTimestamp : 0;
     return safeRightTimestamp - safeLeftTimestamp;
   })[0];
-  if (!pullRequestLink) {
+  if (pullRequestLink) {
+    return {
+      paperclipIssueId: issueId,
+      kind: "pull_request",
+      source: "pull_request_entity",
+      repositoryUrl: pullRequestLink.data.repositoryUrl,
+      githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
+      githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
+      githubPullRequestState: pullRequestLink.data.githubPullRequestState,
+      title: pullRequestLink.data.title,
+      linkedPullRequestNumbers: [pullRequestLink.data.githubPullRequestNumber],
+      linkedPullRequests: [
+        {
+          number: pullRequestLink.data.githubPullRequestNumber,
+          repositoryUrl: pullRequestLink.data.repositoryUrl
+        }
+      ],
+      syncedAt: pullRequestLink.data.syncedAt
+    };
+  }
+  const paperclipIssue = await ctx.issues.get(issueId, companyId);
+  const pullRequestOriginLink = resolvePaperclipIssueOriginGitHubPullRequestLink(paperclipIssue);
+  if (!pullRequestOriginLink) {
     return null;
   }
   return {
     paperclipIssueId: issueId,
     kind: "pull_request",
-    source: "pull_request_entity",
-    repositoryUrl: pullRequestLink.data.repositoryUrl,
-    githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
-    githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
-    githubPullRequestState: pullRequestLink.data.githubPullRequestState,
-    title: pullRequestLink.data.title,
-    linkedPullRequestNumbers: [pullRequestLink.data.githubPullRequestNumber],
+    source: pullRequestOriginLink.source,
+    repositoryUrl: pullRequestOriginLink.repositoryUrl,
+    githubPullRequestNumber: pullRequestOriginLink.githubPullRequestNumber,
+    githubPullRequestUrl: pullRequestOriginLink.githubPullRequestUrl,
+    linkedPullRequestNumbers: [pullRequestOriginLink.githubPullRequestNumber],
     linkedPullRequests: [
       {
-        number: pullRequestLink.data.githubPullRequestNumber,
-        repositoryUrl: pullRequestLink.data.repositoryUrl
+        number: pullRequestOriginLink.githubPullRequestNumber,
+        repositoryUrl: pullRequestOriginLink.repositoryUrl
       }
-    ],
-    syncedAt: pullRequestLink.data.syncedAt
+    ]
   };
 }
 async function resolveIssueByIdentifier(ctx, input) {
@@ -8040,6 +8159,40 @@ async function listRepositoryIssues(octokit, repository, state = "open", options
   }
   return normalizedIssues;
 }
+async function listRepositoryIssuesForSyncTarget(octokit, repository, state, target, options = {}) {
+  if (target?.kind !== "issue") {
+    return listRepositoryIssues(octokit, repository, state, options);
+  }
+  if (target.githubIssueNumber === void 0) {
+    if (options.onProgress) {
+      await options.onProgress({
+        loadedIssueCount: 0
+      });
+    }
+    return [];
+  }
+  const response = await octokit.rest.issues.get({
+    owner: repository.owner,
+    repo: repository.repo,
+    issue_number: target.githubIssueNumber,
+    headers: {
+      accept: "application/vnd.github+json",
+      "X-GitHub-Api-Version": GITHUB_API_VERSION
+    }
+  });
+  const issue = response.data;
+  if ("pull_request" in issue) {
+    return [];
+  }
+  const normalizedIssue = normalizeGitHubIssueRecord(issue);
+  const issues = state === "open" && normalizedIssue.state !== "open" ? [] : [normalizedIssue];
+  if (options.onProgress) {
+    await options.onProgress({
+      loadedIssueCount: issues.length
+    });
+  }
+  return issues;
+}
 async function listRepositoryIssuesForImport(allIssues) {
   return sortIssuesForImport(allIssues.filter((issue) => issue.state === "open"));
 }
@@ -12301,10 +12454,11 @@ async function performSync(ctx, trigger, options = {}) {
         updateSyncFailureContext(failureContext, {
           phase: "listing_github_issues"
         });
-        const allIssues = await listRepositoryIssues(
+        const allIssues = await listRepositoryIssuesForSyncTarget(
           octokit,
           repository,
           shouldLoadClosedIssues ? "all" : "open",
+          options.target,
           {
             onProgress: async (progress) => {
               currentProgress = {
@@ -12427,7 +12581,7 @@ async function performSync(ctx, trigger, options = {}) {
         };
         await persistRunningProgress(true);
         try {
-          const warmedLinkedPullRequests = await loadLinkedPullRequestsForOpenIssues(octokit, repository);
+          const warmedLinkedPullRequests = options.target?.kind === "issue" ? /* @__PURE__ */ new Map() : await loadLinkedPullRequestsForOpenIssues(octokit, repository);
           for (const [issueNumber, linkedPullRequests] of warmedLinkedPullRequests.entries()) {
             linkedPullRequestsByIssueNumber.set(issueNumber, linkedPullRequests);
           }
@@ -13024,6 +13178,66 @@ function registerGitHubAgentTools(ctx) {
       );
     })
   );
+  ctx.tools.register(
+    "assign_to_current_user",
+    getGitHubAgentToolDeclaration("assign_to_current_user"),
+    async (params, runCtx) => executeGitHubTool(async () => {
+      const input = getToolInputRecord(params);
+      const target = await resolveGitHubIssueToolTarget(ctx, runCtx, input);
+      const octokit = await createGitHubToolOctokit(ctx, runCtx.companyId);
+      const [currentResponse, authenticatedUserResponse] = await Promise.all([
+        octokit.rest.issues.get({
+          owner: target.repository.owner,
+          repo: target.repository.repo,
+          issue_number: target.issueNumber,
+          headers: {
+            "X-GitHub-Api-Version": GITHUB_API_VERSION
+          }
+        }),
+        octokit.rest.users.getAuthenticated({
+          headers: {
+            "X-GitHub-Api-Version": GITHUB_API_VERSION
+          }
+        })
+      ]);
+      const assignedLogin = normalizeOptionalToolString(authenticatedUserResponse.data.login);
+      if (!assignedLogin) {
+        throw new Error("GitHub did not return the login for the saved token.");
+      }
+      const currentAssignees = (currentResponse.data.assignees ?? []).map((assignee) => assignee?.login ?? "").filter(Boolean);
+      const nextAssignees = mergeNamedValues(currentAssignees, {
+        setValues: [],
+        addValues: [assignedLogin],
+        removeValues: []
+      });
+      const alreadyAssigned = nextAssignees.length === currentAssignees.length && nextAssignees.every((assignee, index) => assignee.toLowerCase() === currentAssignees[index]?.toLowerCase());
+      const updatedResponse = alreadyAssigned ? currentResponse : await octokit.rest.issues.update({
+        owner: target.repository.owner,
+        repo: target.repository.repo,
+        issue_number: target.issueNumber,
+        assignees: nextAssignees,
+        headers: {
+          "X-GitHub-Api-Version": GITHUB_API_VERSION
+        }
+      });
+      const updatedIssue = normalizeGitHubIssueRecord(updatedResponse.data);
+      return buildToolSuccessResult(
+        alreadyAssigned ? `GitHub issue #${updatedIssue.number} in ${formatRepositoryLabel(target.repository)} was already assigned to ${assignedLogin}.` : `Assigned GitHub issue #${updatedIssue.number} in ${formatRepositoryLabel(target.repository)} to ${assignedLogin}.`,
+        {
+          repository: target.repository.url,
+          assignedLogin,
+          issue: {
+            number: updatedIssue.number,
+            title: updatedIssue.title,
+            url: updatedIssue.htmlUrl,
+            state: updatedIssue.state,
+            labels: normalizeGitHubIssueLabels(updatedResponse.data.labels),
+            assignees: (updatedResponse.data.assignees ?? []).map((assignee) => assignee?.login ?? "").filter(Boolean)
+          }
+        }
+      );
+    })
+  );
   ctx.tools.register(
     "add_issue_comment",
     getGitHubAgentToolDeclaration("add_issue_comment"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-github-plugin",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "Paperclip plugin for synchronizing GitHub issues into Paperclip projects.",
   "license": "Apache-2.0",
   "type": "module",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@octokit/rest": "^22.0.1",
-    "@paperclipai/plugin-sdk": "^2026.427.0",
+    "@paperclipai/plugin-sdk": "^2026.428.0",
     "react": "^19.2.5",
     "react-markdown": "^10.1.0",
     "rehype-raw": "^7.0.0",