@corbits/system-one 0.3.0 → 0.3.1

package/README.md

@@ -198,13 +198,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.
 
-| 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` |
+| 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
+
+- `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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits/system-one",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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",