Name the generator we actually run

Our SDKs are generated by openapi-generator on our own CI. The docs said a
hosted third-party service, which we retired: hanzoai/openapi's LLM.md and its
regenerate-sdks.yml both already said so, while its README still called that
service "canonical" and told a reader to fetch an API key for it out of KMS.

Two sources disagreeing is how somebody follows the wrong one, and the wrong one
here sends them looking for a credential that should not exist.

The same claim had spread to what customers and agents read: five pages on
docs.hanzo.ai and six agent skills advertised a vendor we do not use, and
hip-0040 -- the standard for multi-language SDKs -- argued FOR it by name. The
argument survives without the brand, because it was never about the vendor: one
spec beats N hand-written clients. python-sdk's mock script also pulled that
vendor's fork of prism-cli; it takes upstream @stoplight/prism-cli now.

What is deliberately left alone is every occurrence that is not about us: a
filament material in a 3D-printer integration, a browser of that name in three
user-agent parsers, tokenizer vocabulary where the string is a token id, and
citations recording where Mux, Perigon and Stigg publish their own specs.
Renaming any of those breaks something real.
This commit is contained in:
2026-08-13 14:30:19 -07:00
parent 6d5dc78fcb
commit aad145dec0
5 changed files with 109 additions and 8 deletions
+2 -2
View File
@@ -2,8 +2,8 @@
# Regenerate the Hanzo Python client (`hanzoai`) from the unified OpenAPI spec.
#
# The ONE way: hanzoai/openapi `hanzo.yaml` is the single source of truth. The
# `hanzoai` package under pkg/ is generated from it with openapi-generator — no
# Stainless. Other pkg/hanzo-* packages are hand-written and untouched here.
# `hanzoai` package under pkg/ is generated from it with openapi-generator, run
# on our own CI. Other pkg/hanzo-* packages are hand-written and untouched here.
#
# ./scripts/generate.sh # pulls spec from hanzoai/openapi@main
# SPEC=/path/to/hanzo.yaml ./scripts/generate.sh # local spec override
+2 -2
View File
@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
# Run prism mock on the given spec
if [ "$1" == "--daemon" ]; then
npm exec --package=@stainless-api/[email protected] -- prism mock "$URL" &> .prism.log &
npm exec --package=@stoplight/[email protected] -- prism mock "$URL" &> .prism.log &
# Wait for server to come online
echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
echo
else
npm exec --package=@stainless-api/[email protected] -- prism mock "$URL"
npm exec --package=@stoplight/[email protected] -- prism mock "$URL"
fi