Repository navigation
Conversation
Update the Node SDK to 0.142.0. Add list_reserved_ips, get_reserved_ip and move actions, config.ip_address on ISP create, and an ip_address filter on list.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Review the following changes in direct dependencies. Learn more about Socket for GitHub.
|
yummybomb
marked this pull request as ready for review
November 6, 2026 21:35
yummybomb
requested review from
masnwilliams
and removed request for
masnwilliams
November 6, 2026 21:35
This branch was successfully deployed
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.
Summary
Updates
@onkernel/sdkto 0.142.0 and exposes its reserved ISP proxy IP support inmanage_proxies.listacceptsip_addressto find ISP proxies whose primary exit IP is that address. This works for every organization.createacceptsconfig.ip_addressto pin a new ISP proxy to a reserved IP. A top-levelip_addresson create is rejected with a pointer toconfig.ip_addressinstead of being silently dropped.moveaction:id_or_name+ip_addresscallsproxies.update(id, { config: { ip_address } }), which moves an ISP proxy to another reserved exit IP while keeping its ID.list_reserved_ips(optionalip_countryandstatusfilters, pagination) andget_reserved_ip(ip_address) actions overclient.proxyIPs.ip_countryis a new name rather than the deprecated top-levelcountry, so it isn't counted as deprecated-param usage. Passingcountrytolist_reserved_ipsis rejected with a pointer toip_countryinstead of returning an unfiltered list.ip_addressandconfig.ip_addressare validated as IPv4 in the schema, matching the API.Reserved IPs are enabled per organization. The tool description says so and names the
reserved_isp_not_enablederror other organizations get, so agents don't keep retrying. API errors (ip_not_reserved,ip_unavailable, 409 on a concurrent change) reach the agent through the existing tool error handling. The SDK's default retries still apply, and it retries 409s, so a 409 costs two extra requests (about 1.5s) before it surfaces. That is safe:moveto the IP a proxy already uses is a no-op, and a 409 on create means nothing was created. Retries are kept so transient 5xx and network errors onmovestill recover.Testing
bunx tsc --noEmit --incremental falsebun test(1142 pass), with new cases for the list filter, create pin,move, the reserved-IP actions, and IPv4 validationprettier --checkThe new actions are not exercised against the live API; that needs an organization with a reserved allocation.
Note
Medium Risk
SDK bump plus new proxy-IP API paths (
proxyIPs,move) can surface new API errors or edge cases; behavior is covered by unit tests but not live reserved-IP orgs.Overview
Adds reserved ISP exit IP workflows on
manage_proxies: newmove(re-point an ISP proxy viaproxies.updatewithconfig.ip_address),list_reserved_ips/get_reserved_ip(viaclient.proxyIPs), andlistfiltering by exitip_address. Pins new ISP proxies only throughconfig.ip_address; a top-levelip_addresson create is rejected with a clear error. Schemas require IPv4 for relevantip_addressfields;list_reserved_ipsusesip_country/statuswhilecountrythere errors with guidance to useip_country.Docs and deps: README
manage_proxiesbullet updated;@onkernel/sdkraised to 0.142.0 (and lockfile). Tests cover list filter, create pin vs rejection,move, reserved-IP list/get, and bad IP shapes.Reviewed by Cursor Bugbot for commit 3c62140. Bugbot is set up for automated code reviews on this repo. Configure here.