list_repo_mappings

List GitHub repo to orchestrator mappings with pagination, projection, and filters.

list_repo_mappings

List GitHub repository to orchestrator webhook mappings registered in VantagePeers, newest first, with pagination and projection (lite|full).

Args

Returns

{
  items: RepoMapping[] | RepoMappingLite[],
  nextCursor: string | null
}

nextCursor is null when the current page is the last one; non-null when more rows exist.

Examples

Compact list (fields=lite)

// call
{ "limit": 20, "fields": "lite" }

// response (~2KB for 100 mappings)
{
  "items": [
    {
      "_id": "j5xxx...",
      "_creationTime": 1782050000000,
      "repo": "vantageos-agency/vantage-peers",
      "orchestrator": "sigma",
      "project": "vantage-peers"
    }
  ],
  "nextCursor": "eyJ0aW1lIjoxNzgyMDQ5OTAwMDAwLCJpZCI6Imo1eXl5In0="
}

Paginate through all mappings

// page 1
{ "limit": 20 }
// → { items: [...], nextCursor: "..." }

// page 2 (use nextCursor)
{ "limit": 20, "cursor": "<nextCursor from page 1>" }

Pagination + envelope safety

list_repo_mappings follows the standard VantagePeers envelope safety pattern (PR-C):

• Default limit: 20. Keeps payloads small (~2KB) for typical interactive calls.
• Cap: 200. Requests with limit > 200 are clamped server-side.
• fields=lite: projects to 5 stable keys (_id, _creationTime, repo, orchestrator, project). Excludes active, lastDeployedSHA, lastDeployedAt.
• Cursor: opaque token encoding {time, id} to survive same-millisecond inserts. Treat as opaque — do not parse client-side.
• Hybrid cursor decode: old-format {createdBefore} cursors (S3.3 B8 batch 2 callers) are decoded and forwarded as createdBefore for back-compat. New-format opaque cursors pass through directly.

Same pattern applies to list_bus (PR-A) and list_components (PR-B).

Why this matters