Repository navigation
feat(tanstack-ai): add Parallel search tool package - #67
Draft
georgeatparallel wants to merge 1 commit into
Draft
georgeatparallel wants to merge 1 commit into
georgeatparallel wants to merge 1 commit into
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TanStack requested a separately maintained Parallel integration in TanStack/ai#1205. This adds the unpublished
@parallel-web/tanstack-aipackage here, exposing one server-sideparallelSearchTool()for an existingchat({ tools })call.The runtime is 87 lines:
toolDefinition().server()delegates to the Parallel SDK, preserves the prior result-cap and blank-objective fixes, forwards cancellation, and sends the existing package attribution header. Credentials and source policy stay application-controlled. There is no custom client wrapper or release-pipeline change.Patterns checked before implementation:
Validation: 25 new offline tests pass, including a real TanStack chat loop with a fake model and mocked SDK transport. Workspace lint, formatting, typecheck, build and
env -u PARALLEL_API_KEY pnpm test:cipass (live tests skipped). Typecheck includes the new tests. Frozen-lockfile install passes. Packed tarball imports and executes with mocked HTTP on Node 22.13.0 and 24.18.0; consumer TypeScript passes NodeNext and bundler resolution. No paid API calls were made. The initial sandbox-only localhost failures passed when rerun with localhost access.Exact-head CI run 37035423768 passed all seven jobs on
fe062273ea6eddae5ce5c52e9c1a12c4efb5aac1.Release decisions: confirm the npm/maintenance owner and proposed name (registry lookup returned 404), then have an npm organization owner perform the reviewed first release under the existing publishing guide. Tested versions are TanStack 0.63.0 and Parallel SDK 1.3.5; the TanStack peer range is deliberately
^0.63.0. After publication, submit the offered TanStack docs listing. This draft neither publishes to npm nor adds the upstream listing.