@omnicross/core 0.1.0 → 0.1.2

package/dist/routeResolver-BrbK6ja9.d.cts

@@ -0,0 +1,88 @@
+import { ProviderConfigSource } from './ports/provider-config-source.cjs';
+import { IngressFormat, RouteContext } from './provider-proxy/types.cjs';
+import { OutboundEndpoint, EndpointRoutingConfig, RequestRole } from './outbound-api/types.cjs';
+import { SubscriptionProviderId } from '@omnicross/contracts/subscription-types';
+
+/**
+ * subscriptionSupport — single source of truth for (a) which provider ids are
+ * subscription-backed and (b) which outbound endpoints can soundly serve a
+ * subscription route (`outbound-api-server`, design D2 + review M1/m1).
+ *
+ * The subscription-id catalog mirrors `SubscriptionProviderRegistry`'s ids; the
+ * static fast-path is backstopped at runtime by a live registry lookup (see
+ * `isSubscriptionProviderId`) so it degrades gracefully if it drifts. Both
+ * `routeResolver` and `apiServerHandlers` import from here — no duplicated set.
+ *
+ * @module outbound-api/subscriptionSupport
+ */
+
+/**
+ * The registry-aligned subscription provider ids — the outbound layer's SSOT
+ * fast-path. NOTE: `SubscriptionProviderId` is currently a `z.string()` alias,
+ * so this `readonly SubscriptionProviderId[]` typing does NOT compile-enforce
+ * alignment with the registry; drift is instead tolerated at runtime by
+ * `isSubscriptionProviderId`'s live `registry.getProfile` fallback.
+ */
+declare const SUBSCRIPTION_PROVIDER_IDS: readonly SubscriptionProviderId[];
+/**
+ * True when a provider id refers to a subscription-backed provider. Checks the
+ * registry-aligned static catalog first, then falls back to a live registry
+ * lookup (so a registry addition is honored even before this list is updated).
+ *
+ * NOTE (review m2): this classifies by id string. The resolver MUST confirm the
+ * id does not resolve to a real BYO provider row before treating it as
+ * subscription-backed — see `routeResolver` (BYO rows win).
+ */
+declare function isSubscriptionProviderId(providerId: string): boolean;
+/** True when the endpoint's ingress can soundly serve a subscription route. */
+declare function endpointSupportsSubscription(endpoint: OutboundEndpoint): boolean;
+
+/**
+ * routeResolver — turn an endpoint's `EndpointRoutingConfig` + the detected
+ * request role into a `RouteContext` for the shared `provider-proxy` dispatch
+ * (`outbound-api-server`, design D2).
+ *
+ * Steps:
+ *  1. Pick the model for the role (vision → default fallback when `visionModel`
+ *     is unset; vision is optional).
+ *  2. Parse the chosen `"providerId,modelId"` ref.
+ *  3. Gate by `useSubscription`: OFF → only BYO-key providers are eligible
+ *     (subscription-backed providers excluded); ON → subscription-backed
+ *     providers are eligible.
+ *  4. Resolve the provider (BYO via the `ProviderConfigSource`; subscription via the
+ *     subscription registry) and build the `RouteContext` exactly as the
+ *     internal callers do.
+ *  5. Return a clear `503`-style error when the role's required model is unset,
+ *     the provider is unavailable, or the subscription gate excludes it.
+ *
+ * @module outbound-api/routeResolver
+ */
+
+/** A 503-style resolution failure. */
+interface RouteResolveError {
+    status: number;
+    message: string;
+}
+type RouteResolveResult = {
+    ok: true;
+    route: RouteContext;
+    usedRole: RequestRole;
+} | {
+    ok: false;
+    error: RouteResolveError;
+};
+/** Parse a `"providerId,modelId"` ref. Returns null on a malformed/empty ref. */
+declare function parseModelRef(ref: string | undefined): {
+    providerId: string;
+    modelId: string;
+} | null;
+/** Resolve a route for one authenticated outbound request. */
+declare function resolveRoute(args: {
+    config: EndpointRoutingConfig;
+    role: RequestRole;
+    ingressFormat: IngressFormat;
+    llmConfig: ProviderConfigSource;
+    sessionId?: string | null;
+}): Promise<RouteResolveResult>;
+
+export { type RouteResolveError as R, SUBSCRIPTION_PROVIDER_IDS as S, type RouteResolveResult as a, endpointSupportsSubscription as e, isSubscriptionProviderId as i, parseModelRef as p, resolveRoute as r };

package/dist/routeResolver-HE-ZO0fO.d.ts

@@ -0,0 +1,88 @@
+import { ProviderConfigSource } from './ports/provider-config-source.js';
+import { IngressFormat, RouteContext } from './provider-proxy/types.js';
+import { OutboundEndpoint, EndpointRoutingConfig, RequestRole } from './outbound-api/types.js';
+import { SubscriptionProviderId } from '@omnicross/contracts/subscription-types';
+
+/**
+ * subscriptionSupport — single source of truth for (a) which provider ids are
+ * subscription-backed and (b) which outbound endpoints can soundly serve a
+ * subscription route (`outbound-api-server`, design D2 + review M1/m1).
+ *
+ * The subscription-id catalog mirrors `SubscriptionProviderRegistry`'s ids; the
+ * static fast-path is backstopped at runtime by a live registry lookup (see
+ * `isSubscriptionProviderId`) so it degrades gracefully if it drifts. Both
+ * `routeResolver` and `apiServerHandlers` import from here — no duplicated set.
+ *
+ * @module outbound-api/subscriptionSupport
+ */
+
+/**
+ * The registry-aligned subscription provider ids — the outbound layer's SSOT
+ * fast-path. NOTE: `SubscriptionProviderId` is currently a `z.string()` alias,
+ * so this `readonly SubscriptionProviderId[]` typing does NOT compile-enforce
+ * alignment with the registry; drift is instead tolerated at runtime by
+ * `isSubscriptionProviderId`'s live `registry.getProfile` fallback.
+ */
+declare const SUBSCRIPTION_PROVIDER_IDS: readonly SubscriptionProviderId[];
+/**
+ * True when a provider id refers to a subscription-backed provider. Checks the
+ * registry-aligned static catalog first, then falls back to a live registry
+ * lookup (so a registry addition is honored even before this list is updated).
+ *
+ * NOTE (review m2): this classifies by id string. The resolver MUST confirm the
+ * id does not resolve to a real BYO provider row before treating it as
+ * subscription-backed — see `routeResolver` (BYO rows win).
+ */
+declare function isSubscriptionProviderId(providerId: string): boolean;
+/** True when the endpoint's ingress can soundly serve a subscription route. */
+declare function endpointSupportsSubscription(endpoint: OutboundEndpoint): boolean;
+
+/**
+ * routeResolver — turn an endpoint's `EndpointRoutingConfig` + the detected
+ * request role into a `RouteContext` for the shared `provider-proxy` dispatch
+ * (`outbound-api-server`, design D2).
+ *
+ * Steps:
+ *  1. Pick the model for the role (vision → default fallback when `visionModel`
+ *     is unset; vision is optional).
+ *  2. Parse the chosen `"providerId,modelId"` ref.
+ *  3. Gate by `useSubscription`: OFF → only BYO-key providers are eligible
+ *     (subscription-backed providers excluded); ON → subscription-backed
+ *     providers are eligible.
+ *  4. Resolve the provider (BYO via the `ProviderConfigSource`; subscription via the
+ *     subscription registry) and build the `RouteContext` exactly as the
+ *     internal callers do.
+ *  5. Return a clear `503`-style error when the role's required model is unset,
+ *     the provider is unavailable, or the subscription gate excludes it.
+ *
+ * @module outbound-api/routeResolver
+ */
+
+/** A 503-style resolution failure. */
+interface RouteResolveError {
+    status: number;
+    message: string;
+}
+type RouteResolveResult = {
+    ok: true;
+    route: RouteContext;
+    usedRole: RequestRole;
+} | {
+    ok: false;
+    error: RouteResolveError;
+};
+/** Parse a `"providerId,modelId"` ref. Returns null on a malformed/empty ref. */
+declare function parseModelRef(ref: string | undefined): {
+    providerId: string;
+    modelId: string;
+} | null;
+/** Resolve a route for one authenticated outbound request. */
+declare function resolveRoute(args: {
+    config: EndpointRoutingConfig;
+    role: RequestRole;
+    ingressFormat: IngressFormat;
+    llmConfig: ProviderConfigSource;
+    sessionId?: string | null;
+}): Promise<RouteResolveResult>;
+
+export { type RouteResolveError as R, SUBSCRIPTION_PROVIDER_IDS as S, type RouteResolveResult as a, endpointSupportsSubscription as e, isSubscriptionProviderId as i, parseModelRef as p, resolveRoute as r };

package/dist/serializeError.cjs

@@ -1,82 +1,6 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-// src/serializeError.ts
-var serializeError_exports = {};
-__export(serializeError_exports, {
-  serializeError: () => serializeError
-});
-module.exports = __toCommonJS(serializeError_exports);
-function serializeError(err) {
-  if (err == null) return "Unknown error (null)";
-  if (err instanceof Error) {
-    let msg = err.message || err.name || "Error";
-    if (err.cause) {
-      msg += ` [cause: ${serializeError(err.cause)}]`;
-    }
-    const anyErr = err;
-    if (anyErr.status != null) msg += ` (status: ${anyErr.status})`;
-    else if (anyErr.code != null) msg += ` (code: ${anyErr.code})`;
-    return msg;
-  }
-  if (typeof err === "string") return err || "Empty error string";
-  if (typeof err !== "object") return String(err);
-  const obj = err;
-  if (typeof obj.message === "string" && obj.message) {
-    let msg = obj.message;
-    if (obj.status != null) msg += ` (status: ${obj.status})`;
-    else if (obj.code != null) msg += ` (code: ${obj.code})`;
-    if (typeof obj.type === "string") msg += ` [type: ${obj.type}]`;
-    return msg;
-  }
-  if (typeof obj.error === "string" && obj.error) {
-    return obj.error;
-  }
-  if (obj.error && typeof obj.error === "object") {
-    const inner = obj.error;
-    if (typeof inner.message === "string" && inner.message) {
-      let msg = inner.message;
-      if (typeof inner.type === "string") msg += ` [type: ${inner.type}]`;
-      return msg;
-    }
-  }
-  try {
-    const json = JSON.stringify(err, getCircularReplacer(), 2);
-    if (json && json.length > 1e3) {
-      return json.slice(0, 1e3) + "... (truncated)";
-    }
-    return json || "Unserializable error";
-  } catch {
-    return `Unserializable error: ${Object.prototype.toString.call(err)}`;
-  }
-}
-function getCircularReplacer() {
-  const seen = /* @__PURE__ */ new WeakSet();
-  return (_key, value) => {
-    if (typeof value === "object" && value !== null) {
-      if (seen.has(value)) return "[Circular]";
-      seen.add(value);
-    }
-    return value;
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  serializeError
-});
+var _chunkSVNDB62Dcjs = require('./chunk-SVNDB62D.cjs');
+
+
+exports.serializeError = _chunkSVNDB62Dcjs.serializeError;

package/dist/serializeError.js

@@ -1,57 +1,6 @@
-// src/serializeError.ts
-function serializeError(err) {
-  if (err == null) return "Unknown error (null)";
-  if (err instanceof Error) {
-    let msg = err.message || err.name || "Error";
-    if (err.cause) {
-      msg += ` [cause: ${serializeError(err.cause)}]`;
-    }
-    const anyErr = err;
-    if (anyErr.status != null) msg += ` (status: ${anyErr.status})`;
-    else if (anyErr.code != null) msg += ` (code: ${anyErr.code})`;
-    return msg;
-  }
-  if (typeof err === "string") return err || "Empty error string";
-  if (typeof err !== "object") return String(err);
-  const obj = err;
-  if (typeof obj.message === "string" && obj.message) {
-    let msg = obj.message;
-    if (obj.status != null) msg += ` (status: ${obj.status})`;
-    else if (obj.code != null) msg += ` (code: ${obj.code})`;
-    if (typeof obj.type === "string") msg += ` [type: ${obj.type}]`;
-    return msg;
-  }
-  if (typeof obj.error === "string" && obj.error) {
-    return obj.error;
-  }
-  if (obj.error && typeof obj.error === "object") {
-    const inner = obj.error;
-    if (typeof inner.message === "string" && inner.message) {
-      let msg = inner.message;
-      if (typeof inner.type === "string") msg += ` [type: ${inner.type}]`;
-      return msg;
-    }
-  }
-  try {
-    const json = JSON.stringify(err, getCircularReplacer(), 2);
-    if (json && json.length > 1e3) {
-      return json.slice(0, 1e3) + "... (truncated)";
-    }
-    return json || "Unserializable error";
-  } catch {
-    return `Unserializable error: ${Object.prototype.toString.call(err)}`;
-  }
-}
-function getCircularReplacer() {
-  const seen = /* @__PURE__ */ new WeakSet();
-  return (_key, value) => {
-    if (typeof value === "object" && value !== null) {
-      if (seen.has(value)) return "[Circular]";
-      seen.add(value);
-    }
-    return value;
-  };
-}
+import {
+  serializeError
+} from "./chunk-AVYJ4YBN.js";
 export {
   serializeError
 };