chore(sdks): drop x-speakeasy-pagination overlay from all SDK sources

[alexluong]

What

Removes pagination-config-overlay.yaml from all three SDK sources (TS, Go, Python) in .speakeasy/workflow.yaml, and deletes the overlay file. SDK regeneration is not included in this commit — to be done as a follow-up so the workflow change reviews cleanly.

Why

The shared pagination overlay added x-speakeasy-pagination to list endpoints. Speakeasy turned that annotation into:

• TS: a PageIterator wrapper that forced response.result.models (regression flagged in test(spec-sdk): fix paginator response shape after Speakeasy 1.753.0 #916)
• Go: a res.Next() helper on the response struct
• Python: a res.next() method for cursor chaining

In TS the wrapper is a clear DX regression. In Go/Python the helper saves one line at the cost of hiding which request params get carried across the cursor call. Net: not worth it — symmetric, explicit cursor paging is cleaner across all three.

Originally the annotation lived in the Python-only overlay (auto-pagination for Python users). f5b4f45 extracted it into a shared overlay applied to all three sources on the assumption Go/TS would also benefit; turns out the ergonomic tradeoff doesn't pan out.

Caller-side impact (post-regen)

TypeScript

Before:

const response = await sdk.events.list({ tenantId });
for await (const page of response) {
  for (const ev of page.result.models) { ... }
}
// or: response.result.models + response.next()

After:

const result = await sdk.events.list({ tenantId });
for (const ev of result.models) { ... }
if (result.pagination?.next) {
  const more = await sdk.events.list({ tenantId, next: result.pagination.next });
}

Return type: Promise<PageIterator<...>> → Promise<EventPaginatedResult>.

Go

Before:

res, err := s.Events.List(ctx, operations.ListEventsRequest{})
if res.EventPaginatedResult != nil {
    for {
        // handle items
        res, err = res.Next()
        if res == nil { break }
    }
}

After:

res, err := s.Events.List(ctx, operations.ListEventsRequest{})
if res.EventPaginatedResult != nil {
    for _, ev := range res.EventPaginatedResult.Models { ... }
    if res.EventPaginatedResult.Pagination.Next != nil {
        req := operations.ListEventsRequest{Next: res.EventPaginatedResult.Pagination.Next}
        res, err = s.Events.List(ctx, req)
    }
}

Lost: the Next func() (*ListEventsResponse, error) field. Response envelope unchanged.

Python

Before:

res = outpost.events.list(request={})
while res is not None:
    # res.models
    res = res.next()

After:

res = outpost.events.list(request={})
# res.models, res.pagination.next
while res.pagination and res.pagination.next:
    res = outpost.events.list(request={"next": res.pagination.next})

Return type: ListEventsResponse (with .next()) → EventPaginatedResult.

Follow-ups

• Regenerate all three SDKs (separate PR) — will produce breaking changes; bump majors accordingly
• Revert / close test(spec-sdk): fix paginator response shape after Speakeasy 1.753.0 #916 — the .result.models shape it adapts tests to will be gone