mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-21 16:27:18 +02:00
DottaandPaperclip
d23fbf8ae4
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - Connections is the subsystem that defines which external apps and MCP-style integrations operators can browse, configure, and run > - The v3 schema core in #9958 added stable connection identities, auth metadata, and grant-aware contracts, but the app catalog still used the older gallery shape > - The product needs a richer, typed AppDefinition catalog so browsing and setup can render provider-specific auth and configuration requirements consistently > - This pull request moves the Wave 1 app catalog onto generated AppDefinition data and carries that shape through shared types, server lookup paths, and app connection UI > - The benefit is that follow-up runtime and wizard work can build against one catalog contract instead of local-only mock/gallery data ## Linked Issues or Issue Description Refs #9958. No public GitHub issue exists for this branch. This is the catalog layer for the Connections v3 stack after the schema-core foundation in #9958. ## What Changed - Adds generated AppDefinition data for the Wave 1 catalog and ingestion reporting. - Replaces the legacy tool app gallery exports with AppDefinition-centered shared contracts, validators, and tests. - Updates server tool-access lookup behavior to use the AppDefinition catalog. - Updates app connection UI surfaces and tests to consume AppDefinition-backed catalog data. - Documents the catalog ingestion workflow in the connector playbook. ## Verification - `pnpm run preflight:workspace-links` - `pnpm exec vitest run packages/shared/src/app-definitions.test.ts packages/shared/src/app-definitions-url.test.ts ui/src/pages/apps/AppsConnect.test.tsx server/src/__tests__/tool-access-service.test.ts` ## Risks - Medium: this changes the catalog contract used by shared, server, and UI app connection surfaces. - Catalog data quality matters because generated definitions now drive browse/setup display. - Follow-up runtime and wizard PRs must rebase on this branch or on master after this lands. > For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and discuss it in `#dev` before opening the PR. Feature PRs that overlap with planned core work may need to be redirected — check the roadmap first. See `CONTRIBUTING.md`. ## Model Used OpenAI GPT-5 Codex coding agent with repository tool use. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
52 lines
1.3 KiB
JSON
52 lines
1.3 KiB
JSON
{
|
|
"schemaVersion": 1,
|
|
"slug": "github",
|
|
"name": "GitHub",
|
|
"description": "Read code and pull requests, and coordinate repository work.",
|
|
"categories": [
|
|
"developer"
|
|
],
|
|
"featured": true,
|
|
"branding": {
|
|
"logoUrl": "https://www.google.com/s2/favicons?domain=github.com&sz=128"
|
|
},
|
|
"urlPatterns": [
|
|
"https://api.githubcopilot.com/mcp/*"
|
|
],
|
|
"methods": [
|
|
{
|
|
"key": "mcp-key",
|
|
"transport": "mcp_remote",
|
|
"auth": "api_key",
|
|
"ownershipModes": [
|
|
"customer"
|
|
],
|
|
"whenToUse": "Use the provider-hosted connection for the quickest setup.",
|
|
"defaults": {
|
|
"serverUrl": "https://api.githubcopilot.com/mcp/"
|
|
},
|
|
"guidanceMd": "Create a fine-grained token limited to the repositories agents should use.",
|
|
"riskTier": "S3",
|
|
"credentialFields": [
|
|
{
|
|
"key": "authorization",
|
|
"label": "GitHub token",
|
|
"type": "password",
|
|
"required": true,
|
|
"placeholder": "github_pat_...",
|
|
"secret": true
|
|
}
|
|
],
|
|
"keyPlacement": {
|
|
"location": "header",
|
|
"name": "Authorization",
|
|
"prefix": "Bearer "
|
|
},
|
|
"requiredResourceFilters": [
|
|
"organization",
|
|
"repository"
|
|
]
|
|
}
|
|
]
|
|
}
|