Add TrussChainlet and TrussHandle to the chains SDK reference - #2553
Open
pat-baseten wants to merge 4 commits into
Open
Add TrussChainlet and TrussHandle to the chains SDK reference#2553pat-baseten wants to merge 4 commits into
pat-baseten wants to merge 4 commits into
Conversation
Maps both classes in generate_reference.py (TrussChainlet under Chainlet classes, TrussHandle under Core next to StubBase) and adds WeightsSource to UNDOCUMENTED so the generator's completeness check passes again. Adds the corresponding sections to generated-reference.mdx and API-reference.mdx and regenerates reference.patch, which now applies cleanly with stock patch.
…th in code spans The trailing-whitespace hook strips diff context lines, which is what malformed reference.patch. HTML entities inside code spans render literally, so use a raw <sync_path>.
sys.path the script's own directory so the mdx_adapter sphinx extension resolves regardless of CWD, and record in the README that newer sphinx/sphinx-markdown-builder versions silently fall back to .md output with degraded tables.
'Non-entry leaf chain member' becomes 'chain member that only receives calls' in the docstring and both reference layers.
marius-baseten
approved these changes
Jul 20, 2026
|
|
||
| class TrussChainlet(private_types.ABCChainlet, metaclass=abc.ABCMeta): | ||
| """Declares an existing Truss directory as a non-entry leaf chain member. | ||
| """Declares an existing Truss directory as a chain member that only receives calls. |
Contributor
There was a problem hiding this comment.
Nit: "chain member" seems like a drift from original terminology. I think just "chainlet" is fine, or "dependency chainlet".
| "truss_chains.run_local", | ||
| "truss_chains.DeployedServiceDescriptor", | ||
| "truss_chains.StubBase", | ||
| "truss_chains.remote_chainlet.truss_chainlet.TrussHandle", |
Contributor
There was a problem hiding this comment.
I thought this is declared non-public above, which one is intended? Currently it seems to be included in the docs.
mattelim
approved these changes
Jul 20, 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
3 participants
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.
TrussChainlet and TrussHandle went public but are missing from the doc_gen section lists, so the generated SDK reference on docs.baseten.co doesn't cover them (and the generator errors on unmapped symbols, including WeightsSource, which this maps as undocumented). Companion to docs PR basetenlabs/docs.baseten.co#1211.
Fixes DI-2156