Skip to content

Releases: sysone-help/sysone

v0.5.0 — Plain questions, comparisons and recipes

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 07:30

Ask a one-off question with sys.check(text, "Needs a reply?"); use the same shorthand with filter and partition. Reusable predicates and explicit yes/no/uncertain decisions are preserved. This is backward-compatible with 0.4.

The site now shows executable Sysone/native Jev comparisons, six editable presets, routing and RAG recipes, immediate input validation, visible decision branches and shareable preset links. Ten documented improvement cycles include the reasoning and validation; recorded Jev judgments are advisory, not usability benchmarks.

  • Zero runtime, optional, peer or bundled third-party dependencies.
  • Complete bundle: 3,914 bytes min+gzip in the reference environment, below the unchanged 4,000-byte CI budget. This excludes types/docs and is not the tarball size.
  • 39 tests, TypeScript checks and isolated package installation passed on CI with Node 22 and 24.
  • Native comparison tests verify identical requests and decisions, including threshold boundaries and common failures. Live native TypeSafe access is not claimed; hosted playground checks use Vercel.

Install the attached tarball while npm publication awaits maintainer authentication:

npm install https://github.com/sysone-help/sysone/releases/download/v0.5.0/sysone-0.5.0.tgz

Try the playground · Native comparison · Recipes

Sysone 0.4.0 — custom providers

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 07:12

Sysone 0.4.0 names the provider for your own endpoint customProvider, independently of the model and wire protocol.

import { createSysone } from 'sysone';
import { customProvider } from 'sysone/providers/custom';

const sys = createSysone({
  provider: customProvider({ baseURL: 'http://localhost:8080/v1' }),
  model: 'openjev-latest',
});

Breaking rename: replace systemOne() from sysone/providers/system-one with customProvider() from sysone/providers/custom. Its options type is now CustomProviderOptions. The default metadata provider ID is custom; explicit IDs and the HTTP contract remain unchanged.

An open model offered through Vercel still uses vercel(). customProvider connects to your own endpoint and currently supports the System One HTTP protocol. It does not load model weights or automatically support arbitrary inference APIs. Other protocols can implement EvaluationProvider.

Zero dependencies and the 4 kB min+gzip budget remain enforced. Full bundle reference: 3,901 bytes gzip (esbuild 0.28.2, ES2022, zlib 1.3.1.zlib-ng, level 9; types/docs excluded). Validation: 31 tests, type checks, production build, footprint checks and isolated package installation exercising every provider.

The initial npm publication remains pending authentication. Install this release:

npm install https://github.com/sysone-help/sysone/releases/download/v0.4.0/sysone-0.4.0.tgz

Sysone 0.3.0 — zero dependencies

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 07:07

Sysone 0.3.0 has zero runtime, optional or peer dependencies, including every provider. The complete library is 3,902 bytes minified + gzip; the core alone is 2,711 bytes.

  • Vercel now uses native fetch against the Gateway evaluation protocol. Remove ai and @ai-sdk/gateway if your application does not use them elsewhere. The explicit { provider, model } interface is unchanged.
  • All providers share a small HTTP transport with cancellation, sanitized failures and no retries. Response evidence and metadata are validated locally. Malformed Gateway responses now consistently use INVALID_RESPONSE.
  • Compact ESM entry points share implementation code and support tree shaking. TypeScript declarations are included. No third-party runtime code is bundled.
  • CI enforces a 4,000-byte gzip budget for core plus all providers, verifies published size claims, and rejects dependency additions.

Measured with all core exports retained, esbuild 0.28.2, ESM/ES2022, gzip level 9 (zlib 1.3.1.zlib-ng). Compression implementations can vary slightly; CI checks bundle hashes and enforces the same budget on each Node version. These are JavaScript bundle sizes, excluding types and documentation; they are not tarball download sizes. Reproduce with npm run build && npm run size.

Validation: 31 tests, type checks, production build, and a normal install into an empty consumer containing only Sysone. All three providers execute without external packages. The direct Vercel transport was validated with live Jev predicate, classifier and rubric requests before promoting the deployment.

The Gateway evaluation protocol remains experimental; Sysone now maintains the HTTP adapter directly. See docs/vercel-transport.md for the wire contract.

The initial npm publication remains pending authentication. Install the release package:

npm install https://github.com/sysone-help/sysone/releases/download/v0.3.0/sysone-0.3.0.tgz

Node.js 22+ and ESM. No additional packages are needed for any provider.

Sysone 0.2.0 — providers and models

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 06:52

Sysone 0.2.0 separates provider connections from model selection. A single provider can serve multiple evaluation models, including concurrent requests, without binding the connection to Jev.

const gateway = vercel({ apiKey });
const sys = createSysone({
  provider: gateway,
  model: 'typesafe-ai/jev',
});

Breaking changes:

  • vercel(options), typesafe(options) and systemOne(options) now return reusable providers. createSysone requires both provider and an explicit model ID.
  • Custom integrations implement EvaluationProvider with id and receive { model, state, questions } per request. The model-bound EvaluationModel contract is replaced.
  • systemOne's optional transport label is now id.
  • Gateway extensions remain namespaced in metadata.providerMetadata; the TypeSafe-only projection into answer.confidence is removed. Native System One confidence is unchanged.

Model IDs are provider catalog IDs. Unsupported models fail without silent fallback. No additional live Gateway models are advertised by this change.

The README includes migration examples, and sysone.help uses the new configuration. Validation: 28 tests, type checks, production build and isolated package installation. Tests cover concurrent models sharing one gateway, explicit selection through every adapter, and preservation of model-specific metadata.

The initial npm publication remains pending authentication. Install the release package:

npm install https://github.com/sysone-help/sysone/releases/download/v0.2.0/sysone-0.2.0.tgz

Node.js 22+ and ESM. The Vercel adapter additionally requires ai@7.0.105 and @ai-sdk/gateway@4.0.85.

Sysone 0.1.1

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 06:43

Sysone 0.1.1 adds an experimental transport for compatible evaluation servers and a developer-focused playground at https://sysone.help.

  • systemOne(modelId, { baseURL }) connects to the System One HTTP protocol, including independent OpenJev servers. It supports optional authentication, custom headers, cancellation and evidence validation without silently rounding values.
  • The website opens directly into editable examples with TypeScript output, keyboard execution, light/dark themes, API reference and documented model alternatives.
  • Research distinguishes OpenJev's compatible server from open evaluation weights such as Bespoke Nimble and Kotoba. Confidence definitions and model limits are documented; quality equivalence with Jev is not claimed.
  • Project attribution replaces personal credits in package metadata, documentation and licenses.

Validation: 24 contract/endpoint tests, type checks, production build and an isolated consumer installation without optional AI SDK dependencies. OpenJev compatibility uses source-derived fixtures; its GPU backend has not been run by this project. The shared playground still uses Jev through Vercel.

The first npm publication remains pending authentication. Install the release package now:

npm install https://github.com/sysone-help/sysone/releases/download/v0.1.1/sysone-0.1.1.tgz

Node.js 22+ and ESM. Only the Vercel adapter needs the optional peers ai@7.0.105 and @ai-sdk/gateway@4.0.85.

Sysone 0.1.0

Choose a tag to compare

@6uimorais 6uimorais released this 19 Sep 05:51

Sysone 0.1.0 introduces typed decisions for TypeScript and a live educational playground at https://sysone.help.

  • Reusable predicates, classifiers and ordered rubrics.
  • Typed evaluation, explicit uncertainty, filtering, partitioning and ranking.
  • TypeSafe and Vercel AI Gateway adapters.
  • Cancellation, bounded concurrency and validated evidence.
  • MIT license, TypeScript declarations and no runtime dependencies for the core/direct adapter.

The initial npm publication is pending maintainer authentication. The attached tarball is installable now:

npm install https://github.com/sysone-help/sysone/releases/download/v0.1.0/sysone-0.1.0.tgz

Requires Node.js 22+ and ESM. For Vercel, additionally install ai@7.0.105 @ai-sdk/gateway@4.0.85.

Validation: 19 contract/endpoint tests, type inference checks, production build, isolated package installation, CI on Node 22 and 24, and live Jev playground checks. TypeSafe direct was tested with fixtures; live validation used Vercel.