Found by running typesafe-sdk 0.7.5 and @typesafe-ai/sdk 0.7.0 against a
local server and fixed:
- zstd (and gzip/deflate/br) request bodies are decoded; the SDKs compress
bodies of 1 KiB or more, which used to fail with a 500
- GET /v1/models also returns models: [{ name, description, release_date }]
- every systemone, batch and models response carries x-typesafe-request-id
- a base URL ending in /v1 (or /api/v1) resolves to the same handlers
- request errors carry a detail list; a non-JSON body is a 400, not a 500
- multipart (image asset) requests get a clear 415
Adds examples/official-sdk.py and .mjs, a /docs/typesafe-sdk page, a README
block and a COMPARISON.md section, limited to what was observed to pass.
Adoption-ranked work from plans/research/ai-and-active-next-2026-11-11.md
section 2 (openjev_next list), skipping items that need training/eval or a
live deploy this pass:
- docs/COMPARISON.md: honest OpenJev vs TypeSafe Jev vs Kev vs OpenAI
Decisions API table, sourced from already-verified facts in
plans/openjev.md's 2026-11-06 research entry, with our own real
otsone-mini/otsone-base/system-one numbers and their caveats stated
(item #4, "public comparison writeup").
- examples/triage-tickets.py: a real runnable Python SDK example (Choice +
Score + Noul ticket triage), verified end to end against a mocked
TypeSafe2/httpx2 transport; examples/README.md indexes both examples.
Fixes a real gap found while writing it: TypeSafeClient() always
requires a non-empty api_key even against a keyless self-hosted server
(server-side "unknown keys pass through") -- worked around in the
example with a documented placeholder, not changed in the SDK itself.
- sdk/js/package.json: @openjev/sdk had no `keywords` field at all (its
sibling @openjev/lite and both Python packages do) -- real npm-search
discoverability gap on the flagship package, fixed; publint still
passes clean.
Not done this pass (needs model eval/training or a live deploy, out of
scope under the no-training/no-deploy constraints): Kev-style versioned
eval-suite naming (#1), growing gold.json with a real holdout split (#2),
a hosted try-it-now demo widget (#3).
Typed decision/classification service with an in-process gte-small ONNX
embedding engine and lexical fallback, JS/Python SDKs, adapters, and the
otsone model family. Apache-2.0 (sub-packages keep their MIT licenses).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>