@corbits/system-one 0.3.0 → 0.3.2

package/README.md

@@ -18,6 +18,16 @@ bun add @corbits/system-one @intx/inference@^0.4.0 @intx/types@^0.4.0
 
 Runs on Bun >= 1.2 or Node >= 24.
 
+To consume an exact Git commit before it is published, enable the package's
+source condition because Git dependencies do not run `prepack`:
+
+```bash
+bun add github:corbitsdev/corbits-system-one#<commit>
+bun --conditions=corbits-system-one-src your-script.ts
+```
+
+Published consumers continue to use the built `dist` entry by default.
+
 ## Quickstart
 
 Needs `TYPESAFE_API_KEY` set.
@@ -198,13 +208,20 @@ The hub offering's `quirks` are validated and all optional:
 }
 ```
 
-`questions` and `state` are per-call defaults; `providerOptions.systemOne` on a call wins field by field. A top-level `model` applies when `endpoint` sets none. Unknown keys throw. The adapter sends the bearer sentinel and the harness injects the offering's credential.
+Without `endpoint`, the adapter posts to the catalog provider's `baseURL` + `/systemone`, the host the offering's credential was issued for. A `model` quirk (top level or on `endpoint`) is the model sent on the wire, so one catalog model can be served by providers that name it differently. `questions` and `state` are per-call defaults; `providerOptions.systemOne` on a call wins field by field. Unknown keys throw. The adapter sends the bearer sentinel and the harness injects the offering's credential.
+
+| Provider          | Provider `baseURL`                         | `model` quirk                 |
+| ----------------- | ------------------------------------------ | ----------------------------- |
+| TypeSafe          | `https://api.typesafe.ai/v1`               | `jev-latest`                  |
+| Vercel AI Gateway | `https://ai-gateway.vercel.sh/typesafe/v1` | `typesafe-ai/jev`             |
+| OpenRouter        | `https://openrouter.ai/api/v1`             | `typesafe/jev-1.13`           |
+| OpenCode Zen      | `https://opencode.ai/zen/v1`               | `jev-1.13` or `jev-1.13-free` |
+
+## Upgrading to 0.3.1
 
-| Gateway            | `endpoint`                                                       | `model`                       |
-| ------------------ | ---------------------------------------------------------------- | ----------------------------- |
-| Official (default) | omit, or `{"kind":"official"}`                                   | `jev-latest`                  |
-| Vercel AI Gateway  | `{"kind":"gateway"}`                                             | `typesafe-ai/jev`             |
-| OpenCode Zen       | `{"kind":"custom","url":"https://opencode.ai/zen/v1/systemone"}` | `jev-1.13` or `jev-1.13-free` |
+- `createSystemOneAdapterFactory` without an `endpoint` quirk now posts to the catalog provider's `baseURL` + `/systemone` instead of the official TypeSafe URL. Set the provider `baseURL` to the API root (for example `https://api.typesafe.ai/v1`), or keep the old behavior with `{"endpoint":{"kind":"official"}}`. The harness sends the offering's credential to whatever URL the adapter returns, so only set an explicit `endpoint` on a host that credential belongs to.
+- A `model` quirk now overrides the model the harness passes (the catalog canonical name).
+- `createSystemOneAdapter` and `evaluate` are unchanged.
 
 ## Upgrading from 0.1
 

package/dist/adapter.d.ts

@@ -5,7 +5,10 @@ export declare const SYSTEM_ONE_PROVIDER = "corbits-system-one";
 export declare function createSystemOneAdapter(config?: EvaluateConfig): ProviderAdapter;
 /**
  * Interchange `AdapterFactory` for `SIDECAR_ADAPTER_MANIFEST`: validates the
- * offering's `quirks` and reuses `createSystemOneAdapter`. A top-level
- * `model` fills the endpoint's model when the endpoint sets none.
+ * offering's `quirks` and builds the same adapter `createSystemOneAdapter`
+ * does. Without an
+ * `endpoint` quirk, requests go to the catalog provider's `baseURL` +
+ * `/systemone`. A quirk `model` (on `endpoint` or top level) is the model
+ * sent on the wire, overriding the catalog's canonical name.
  */
 export declare const createSystemOneAdapterFactory: AdapterFactory;

package/dist/adapter.js

@@ -209,36 +209,37 @@ const SystemOneFactoryQuirks = type({
     "state?": State,
     "+": "reject",
 });
+// Interchange joins a relative request path to the catalog provider's
+// `baseURL`, the host the offering's credential was issued for.
+const PROVIDER_ENDPOINT = { kind: "custom", url: "/systemone" };
 /**
  * Interchange `AdapterFactory` for `SIDECAR_ADAPTER_MANIFEST`: validates the
- * offering's `quirks` and reuses `createSystemOneAdapter`. A top-level
- * `model` fills the endpoint's model when the endpoint sets none.
+ * offering's `quirks` and builds the same adapter `createSystemOneAdapter`
+ * does. Without an
+ * `endpoint` quirk, requests go to the catalog provider's `baseURL` +
+ * `/systemone`. A quirk `model` (on `endpoint` or top level) is the model
+ * sent on the wire, overriding the catalog's canonical name.
  */
 export const createSystemOneAdapterFactory = (source, quirks) => {
     const parsed = SystemOneFactoryQuirks(quirks ?? {});
     if (parsed instanceof type.errors) {
         throw new Error(`${SYSTEM_ONE_PROVIDER} adapter: invalid quirks: ${parsed.summary}`);
     }
-    const endpoint = {
-        kind: "official",
-        ...parsed.endpoint,
-    };
-    if (parsed.model !== undefined && endpoint.model === undefined) {
-        endpoint.model = parsed.model;
+    const wireModel = parsed.endpoint?.model ?? parsed.model;
+    if (wireModel === "") {
+        throw new Error(`${SYSTEM_ONE_PROVIDER} adapter: invalid quirks: model must not be empty`);
     }
-    const adapter = createSystemOneProviderAdapter({ endpoint }, source);
+    const adapter = createSystemOneProviderAdapter({ endpoint: parsed.endpoint ?? PROVIDER_ENDPOINT }, source);
     const defaults = {
         ...(parsed.state !== undefined && { state: parsed.state }),
         ...(parsed.questions !== undefined && { questions: parsed.questions }),
     };
-    if (Object.keys(defaults).length === 0)
-        return adapter;
     return {
         ...adapter,
         buildRequest: (messages, model, options) => {
             const raw = options.providerOptions?.["systemOne"];
             const call = raw === undefined ? {} : raw;
-            return adapter.buildRequest(messages, model, {
+            return adapter.buildRequest(messages, wireModel ?? model, {
                 ...options,
                 providerOptions: {
                     ...options.providerOptions,

package/dist/evaluate.js

@@ -195,7 +195,8 @@ function envKey(name) {
  */
 export async function evaluate(input, options) {
     const deps = options?.deps ?? {
-        fetch: globalThis.fetch,
+        // Browsers reject fetch called as a method of another object.
+        fetch: (input, init) => fetch(input, init),
         scheduler: createDefaultScheduler(),
     };
     const start = deps.scheduler.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits/system-one",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Typed-decision evaluation client for System One (Jev-class) models: arktype question/decision schemas, endpoint configuration with gateway override, and timeout/fallback semantics.",
   "keywords": [
     "corbits",
@@ -29,6 +29,7 @@
   "sideEffects": false,
   "exports": {
     ".": {
+      "corbits-system-one-src": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
@@ -51,17 +52,17 @@
     "arktype": "2.2.3"
   },
   "devDependencies": {
-    "@intx/inference": "0.4.0",
-    "@intx/inference-testing": "0.4.0",
-    "@intx/types": "0.4.0",
+    "@intx/inference": "0.5.0",
+    "@intx/inference-testing": "0.5.0",
+    "@intx/types": "0.5.0",
     "@types/bun": "1.3.14",
     "oxfmt": "0.70.0",
     "oxlint": "1.85.0",
     "typescript": "6.0.3"
   },
   "peerDependencies": {
-    "@intx/inference": "^0.4.0",
-    "@intx/types": "^0.4.0"
+    "@intx/inference": "^0.5.0",
+    "@intx/types": "^0.5.0"
   },
   "engines": {
     "bun": ">=1.2.0",