Add incoming call forwarding to SDKs and CLI - #153
Merged
Conversation
dimavrem22
force-pushed
the
feat/incoming-call-forwarding
branch
3 times, most recently
from
August 22, 2026 01:19
87c80a4 to
a33de2f
Compare
dimavrem22
force-pushed
the
feat/incoming-call-forwarding
branch
from
August 22, 2026 08:34
a33de2f to
848778d
Compare
dimavrem22
marked this pull request as ready for review
August 22, 2026 22:32
alex-w-99
approved these changes
Aug 23, 2026
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.
Executive Summary
Adds incoming-call forwarding configuration and history to every supported SDK and the CLI.
Description
Python, TypeScript, and Rust now expose the
forwardincoming-call action, typed phone/SIP destinations, phone-number and identity projections, and the additivePhoneCall.forwardingshistory. Older call responses without forwarding history continue to parse as an empty list, and call lifecycle webhook receiver types expose the same additive history.The CLI adds mutually exclusive
--forward-to-phoneand--forward-to-sipflags to both identity incoming-action updates and phone-number updates. Public examples, package changelogs, exports, exact wire tests, and a shared cross-language fixture are included; no packages are published by this PR.Reason
Customers need to route inbound identity calls to an external phone or SIP destination while retaining a consistent configuration and call-history contract across all clients.
Decisions
nullclears them; clearing an active target requires switching away fromforwardin the same update so the resulting configuration stays valid.PhoneCall.forwardingsis an oldest-first array separate fromPhoneCall.status, and V1 exposes onlyincoming_actionas its trigger.setmethod remains unchanged, whileset_with_optionsadds forwarding and explicit-clear support.Testing
incoming_call_action.set, phone-number updates, config parsing, and call-history parsing: 49 focused tests passed; related identity coverage passed in a 92-test focused run.npm run buildpassed.cargo fmt --checkpassed.phone incoming-action forward --forward-to-sip: 19 phone-command tests passed;npm run buildandnpm pack --dry-runpassed.ruff checkpassed anduv buildproduced both source and wheel artifacts.Dependency
Built directly on #154; that dependency head is a Git ancestor of this branch.
Compatibility and rollout
Deploy the backend migration and API first. Publish the Python, TypeScript, Rust, and CLI release next and wait for registry propagation before enabling forwarding in the customer Console or publishing the Website docs. Python and Rust releases older than this change use closed
IncomingCallActionenum decoding; after an identity is configured withforward, those older clients can fail while reading that identity or its incoming-call configuration. Deploy Admin Console only after the migration, then customer Console, then Website docs. This is additive for clients on the new release, but it is not read-compatible with strict older Python/Rust clients.No packages are published by this PR.