refactor RunQueryCtx to QueryCtx using Pick

[ianmacartney]

Renames the internal RunQueryCtx type to QueryCtx and updates its definition to use Pick instead of a manually declared interface, aligning it with idiomatic TypeScript patterns for extracting a subset of an existing type.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository: get-convex/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 460024c8-d8d6-45b6-b33f-6aca4064f1c7

📥 Commits

Reviewing files that changed from the base of the PR and between 9713c5c and 74b10d7.

📒 Files selected for processing (1)

• src/client/definePlaygroundAPI.ts

---

📝 Walkthrough

Walkthrough

In definePlaygroundAPI.ts, the internal validateApiKey helper's parameter type is widened from a query-only context to a union of QueryCtx | MutationCtx | ActionCtx. To support this, the single RunQueryCtx local alias is replaced with three distinct aliases: QueryCtx (providing runQuery), MutationCtx (providing runQuery and runMutation), and ActionCtx (providing runQuery and runAction). The GenericMutationCtx type is added to the Convex server imports to enable the new MutationCtx alias. The runtime behavior of validateApiKey is unchanged.

Possibly related PRs

• get-convex/agent#277: Also updates client/server context typing to handle QueryCtx, MutationCtx, and ActionCtx interchangeably, directly related to this PR's broadening of validateApiKey acceptance.

Suggested reviewers

• robelest

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main refactoring work: renaming RunQueryCtx to QueryCtx and converting to Pick-based type definitions, which aligns with the code changes.
Description check	✅ Passed	The description is directly related to the changeset, explaining the renaming of RunQueryCtx to QueryCtx and the switch to TypeScript's Pick utility type.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch ian/update-types

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[ianmacartney]

• refactor RunQueryCtx to QueryCtx using Pick #284 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@convex-dev/agent@284

commit: 74b10d7