paperclip-github-plugin 0.2.1

package/dist/manifest.js

@@ -0,0 +1,548 @@
+// src/manifest.ts
+import { createRequire } from "node:module";
+
+// src/github-agent-tools.ts
+var repositoryProperty = {
+  type: "string",
+  description: "GitHub repository as owner/repo or https://github.com/owner/repo. Omit when the current Paperclip project has exactly one mapped repository."
+};
+var paperclipIssueIdProperty = {
+  type: "string",
+  description: "Paperclip issue id used to infer the linked GitHub issue and repository when available."
+};
+var issueNumberProperty = {
+  type: "integer",
+  minimum: 1,
+  description: "GitHub issue number."
+};
+var pullRequestNumberProperty = {
+  type: "integer",
+  minimum: 1,
+  description: "GitHub pull request number."
+};
+var llmModelProperty = {
+  type: "string",
+  description: "Exact LLM name used to draft the comment. Required so the plugin can append the mandatory AI-authorship footer."
+};
+var issueTargetSchema = {
+  anyOf: [
+    {
+      required: ["paperclipIssueId"]
+    },
+    {
+      required: ["issueNumber"]
+    }
+  ]
+};
+var pullRequestTargetSchema = {
+  anyOf: [
+    {
+      required: ["paperclipIssueId"]
+    },
+    {
+      required: ["pullRequestNumber"]
+    }
+  ]
+};
+var GITHUB_AGENT_TOOLS = [
+  {
+    name: "search_repository_items",
+    displayName: "Search Repository Items",
+    description: "Search issues and pull requests in a GitHub repository for triage and deduplication.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["query"],
+      properties: {
+        repository: repositoryProperty,
+        query: {
+          type: "string",
+          description: "Free-text search query."
+        },
+        type: {
+          type: "string",
+          enum: ["issue", "pull_request", "all"],
+          description: "Which item type to search."
+        },
+        state: {
+          type: "string",
+          enum: ["open", "closed", "all"],
+          description: "State filter."
+        },
+        author: {
+          type: "string",
+          description: "GitHub login that authored the item."
+        },
+        assignee: {
+          type: "string",
+          description: "GitHub login assigned to the item."
+        },
+        labels: {
+          type: "array",
+          items: {
+            type: "string"
+          },
+          description: "Label names that must be present on the item."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 50,
+          description: "Maximum number of results to return."
+        }
+      }
+    }
+  },
+  {
+    name: "get_issue",
+    displayName: "Get Issue",
+    description: "Read one GitHub issue with its metadata, assignees, labels, milestone, and linked pull requests.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "list_issue_comments",
+    displayName: "List Issue Comments",
+    description: "Read all comments on a GitHub issue so the agent has the full implementation context.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "update_issue",
+    displayName: "Update Issue",
+    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty,
+        title: {
+          type: "string"
+        },
+        body: {
+          type: "string"
+        },
+        state: {
+          type: "string",
+          enum: ["open", "closed"]
+        },
+        setLabels: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        addLabels: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        removeLabels: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        setAssignees: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        addAssignees: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        removeAssignees: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        milestoneNumber: {
+          type: ["integer", "null"],
+          minimum: 1,
+          description: "Milestone number to set, or null to clear the milestone."
+        }
+      }
+    }
+  },
+  {
+    name: "add_issue_comment",
+    displayName: "Add Issue Comment",
+    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; include llmModel so the plugin can append the required AI-authorship footer.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["body", "llmModel"],
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty,
+        body: {
+          type: "string",
+          description: "Human-facing comment body without the AI footer."
+        },
+        llmModel: llmModelProperty
+      }
+    }
+  },
+  {
+    name: "create_pull_request",
+    displayName: "Create Pull Request",
+    description: "Open a GitHub pull request once the implementation branch is pushed.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["head", "base", "title"],
+      properties: {
+        repository: repositoryProperty,
+        head: {
+          type: "string",
+          description: "Head branch name or owner:branch."
+        },
+        base: {
+          type: "string",
+          description: "Base branch name."
+        },
+        title: {
+          type: "string"
+        },
+        body: {
+          type: "string"
+        },
+        draft: {
+          type: "boolean"
+        }
+      }
+    }
+  },
+  {
+    name: "get_pull_request",
+    displayName: "Get Pull Request",
+    description: "Read one pull request with branch metadata, review summary, and merge readiness.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "update_pull_request",
+    displayName: "Update Pull Request",
+    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty,
+        title: {
+          type: "string"
+        },
+        body: {
+          type: "string"
+        },
+        base: {
+          type: "string"
+        },
+        state: {
+          type: "string",
+          enum: ["open", "closed"]
+        },
+        isDraft: {
+          type: "boolean",
+          description: "True converts the pull request to draft. False marks it ready for review."
+        }
+      }
+    }
+  },
+  {
+    name: "list_pull_request_files",
+    displayName: "List Pull Request Files",
+    description: "List the changed files in a pull request, including additions, deletions, and patches when available.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "get_pull_request_checks",
+    displayName: "Get Pull Request Checks",
+    description: "Read CI status for a pull request, including workflow runs, check runs, and commit status contexts.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "list_pull_request_review_threads",
+    displayName: "List Pull Request Review Threads",
+    description: "Read review threads on a pull request, including file paths, comments, and resolution state.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
+  {
+    name: "reply_to_review_thread",
+    displayName: "Reply To Review Thread",
+    description: "Reply to an existing pull request review thread. Provide only the human-facing body; include llmModel so the plugin can append the required AI-authorship footer.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["threadId", "body", "llmModel"],
+      properties: {
+        threadId: {
+          type: "string",
+          description: "GitHub pull request review thread node id."
+        },
+        body: {
+          type: "string",
+          description: "Human-facing reply body without the AI footer."
+        },
+        llmModel: llmModelProperty
+      }
+    }
+  },
+  {
+    name: "resolve_review_thread",
+    displayName: "Resolve Review Thread",
+    description: "Mark a pull request review thread as resolved after addressing the feedback.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["threadId"],
+      properties: {
+        threadId: {
+          type: "string",
+          description: "GitHub pull request review thread node id."
+        }
+      }
+    }
+  },
+  {
+    name: "unresolve_review_thread",
+    displayName: "Unresolve Review Thread",
+    description: "Reopen a previously resolved pull request review thread.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["threadId"],
+      properties: {
+        threadId: {
+          type: "string",
+          description: "GitHub pull request review thread node id."
+        }
+      }
+    }
+  },
+  {
+    name: "request_pull_request_reviewers",
+    displayName: "Request Pull Request Reviewers",
+    description: "Request users or teams to review a pull request.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...pullRequestTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty,
+        userReviewers: {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "string"
+          }
+        },
+        teamReviewers: {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "string"
+          }
+        }
+      },
+      anyOf: [
+        {
+          required: ["paperclipIssueId", "userReviewers"]
+        },
+        {
+          required: ["paperclipIssueId", "teamReviewers"]
+        },
+        {
+          required: ["pullRequestNumber", "userReviewers"]
+        },
+        {
+          required: ["pullRequestNumber", "teamReviewers"]
+        }
+      ]
+    }
+  }
+];
+
+// src/manifest.ts
+var require2 = createRequire(import.meta.url);
+var packageJson = require2("../package.json");
+var DASHBOARD_WIDGET_CAPABILITY = "ui.dashboardWidget.register";
+var SCHEDULE_TICK_CRON = "* * * * *";
+var MANIFEST_VERSION = process.env.PLUGIN_VERSION?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var manifest = {
+  id: "paperclip-github-plugin",
+  apiVersion: 1,
+  version: MANIFEST_VERSION,
+  displayName: "GitHub Sync",
+  description: "Synchronize GitHub issues into Paperclip projects.",
+  author: "\xC1lvaro S\xE1nchez-Mariscal",
+  categories: ["connector", "ui"],
+  capabilities: [
+    "ui.page.register",
+    DASHBOARD_WIDGET_CAPABILITY,
+    "ui.detailTab.register",
+    "ui.commentAnnotation.register",
+    "ui.action.register",
+    "plugin.state.read",
+    "plugin.state.write",
+    "instance.settings.register",
+    "issues.read",
+    "issues.create",
+    "issues.update",
+    "issue.comments.read",
+    "issue.comments.create",
+    "agents.read",
+    "jobs.schedule",
+    "http.outbound",
+    "secrets.read-ref",
+    "agent.tools.register"
+  ],
+  instanceConfigSchema: {
+    type: "object",
+    properties: {
+      githubTokenRef: {
+        type: "string",
+        title: "GitHub Token Secret"
+      },
+      paperclipBoardApiTokenRefs: {
+        type: "object",
+        title: "Paperclip Board Token Secrets",
+        additionalProperties: {
+          type: "string"
+        }
+      },
+      paperclipApiBaseUrl: {
+        type: "string",
+        title: "Trusted Paperclip API Origin"
+      }
+    }
+  },
+  jobs: [
+    {
+      jobKey: "sync.github-issues",
+      displayName: "Sync GitHub issues",
+      description: "Checks for GitHub issue updates and syncs them on the configured cadence.",
+      schedule: SCHEDULE_TICK_CRON
+    }
+  ],
+  tools: GITHUB_AGENT_TOOLS,
+  entrypoints: {
+    worker: "./dist/worker.js",
+    ui: "./dist/ui/"
+  },
+  ui: {
+    slots: [
+      {
+        type: "dashboardWidget",
+        id: "paperclip-github-plugin-dashboard-widget",
+        displayName: "GitHub Sync",
+        exportName: "GitHubSyncDashboardWidget"
+      },
+      {
+        type: "detailTab",
+        id: "paperclip-github-plugin-issue-detail-tab",
+        displayName: "GitHub",
+        exportName: "GitHubSyncIssueDetailTab",
+        entityTypes: ["issue"]
+      },
+      {
+        type: "commentAnnotation",
+        id: "paperclip-github-plugin-comment-annotation",
+        displayName: "GitHub Sync Links",
+        exportName: "GitHubSyncCommentAnnotation",
+        entityTypes: ["comment"]
+      },
+      {
+        type: "globalToolbarButton",
+        id: "paperclip-github-plugin-global-toolbar-button",
+        displayName: "GitHub Sync",
+        exportName: "GitHubSyncGlobalToolbarButton"
+      },
+      {
+        type: "toolbarButton",
+        id: "paperclip-github-plugin-toolbar-button",
+        displayName: "GitHub Sync",
+        exportName: "GitHubSyncEntityToolbarButton",
+        entityTypes: ["project", "issue"]
+      },
+      {
+        type: "settingsPage",
+        id: "paperclip-github-plugin-settings-page",
+        displayName: "GitHub Sync",
+        exportName: "GitHubSyncSettingsPage"
+      }
+    ]
+  }
+};
+var manifest_default = manifest;
+export {
+  manifest_default as default,
+  manifest
+};