3 Commits

Author SHA1 Message Date
26becee66a feat(api): official TypeSafe SDKs work unchanged against OpenJev
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.
2026-11-11 05:41:06 +03:00
4eb0edf7d5 feat(adoption): comparison doc, Python example, examples index, npm keywords
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).
2026-11-11 04:22:00 +03:00
caelum0x
4847e35451 OpenJev: open-source typed decision service
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>
2026-09-25 00:12:36 +03:00