@omnicross/core 0.1.0 → 0.1.1

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/transformer/anthropicBetaInject.cjs

@@ -0,0 +1,51 @@
+"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);
+
+// src/transformer/anthropicBetaInject.ts
+var anthropicBetaInject_exports = {};
+__export(anthropicBetaInject_exports, {
+  EXTENDED_CONTEXT_BETA: () => EXTENDED_CONTEXT_BETA,
+  injectExtendedContextBeta: () => injectExtendedContextBeta
+});
+module.exports = __toCommonJS(anthropicBetaInject_exports);
+var import_extended_context = require("@omnicross/contracts/extended-context");
+var EXTENDED_CONTEXT_BETA = "context-1m-2025-08-07";
+var ANTHROPIC_BETA_HEADER = "anthropic-beta";
+function injectExtendedContextBeta(headers, model, useExtendedContext) {
+  if (!useExtendedContext) return;
+  if (!(0, import_extended_context.isExtendedContextCapable)(model)) return;
+  let existingValue = "";
+  for (const key of Object.keys(headers)) {
+    if (key.toLowerCase() === ANTHROPIC_BETA_HEADER) {
+      const v = headers[key];
+      if (typeof v === "string") existingValue = v;
+      if (key !== ANTHROPIC_BETA_HEADER) delete headers[key];
+    }
+  }
+  const parts = existingValue.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (!parts.includes(EXTENDED_CONTEXT_BETA)) {
+    parts.push(EXTENDED_CONTEXT_BETA);
+  }
+  headers[ANTHROPIC_BETA_HEADER] = parts.join(",");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EXTENDED_CONTEXT_BETA,
+  injectExtendedContextBeta
+});

package/dist/transformer/anthropicBetaInject.d.cts

@@ -0,0 +1,20 @@
+declare const EXTENDED_CONTEXT_BETA = "context-1m-2025-08-07";
+/**
+ * Idempotently merge the 1M-context beta flag into an Anthropic request's
+ * `anthropic-beta` HTTP header (comma-separated list).
+ *
+ * Mutates `headers` in place. No-op when:
+ *  - `useExtendedContext` is false (user has not opted in), OR
+ *  - `model` is not in the 1M-capable allowlist (defensive — guards against
+ *    stale flag set on a model whose 1M variant isn't supported), OR
+ *  - the flag already appears in the existing header value (re-entry safe).
+ *
+ * Header-name lookup is case-insensitive: HTTP headers are conventionally
+ * stored in different casings by different code paths (Node IncomingMessage
+ * lowercases; some libraries preserve `Anthropic-Beta`). The helper deletes
+ * any case-variant key it finds and re-emits the canonical lowercase
+ * `anthropic-beta`.
+ */
+declare function injectExtendedContextBeta(headers: Record<string, string>, model: string, useExtendedContext: boolean): void;
+
+export { EXTENDED_CONTEXT_BETA, injectExtendedContextBeta };

package/dist/transformer/anthropicBetaInject.d.ts

@@ -0,0 +1,20 @@
+declare const EXTENDED_CONTEXT_BETA = "context-1m-2025-08-07";
+/**
+ * Idempotently merge the 1M-context beta flag into an Anthropic request's
+ * `anthropic-beta` HTTP header (comma-separated list).
+ *
+ * Mutates `headers` in place. No-op when:
+ *  - `useExtendedContext` is false (user has not opted in), OR
+ *  - `model` is not in the 1M-capable allowlist (defensive — guards against
+ *    stale flag set on a model whose 1M variant isn't supported), OR
+ *  - the flag already appears in the existing header value (re-entry safe).
+ *
+ * Header-name lookup is case-insensitive: HTTP headers are conventionally
+ * stored in different casings by different code paths (Node IncomingMessage
+ * lowercases; some libraries preserve `Anthropic-Beta`). The helper deletes
+ * any case-variant key it finds and re-emits the canonical lowercase
+ * `anthropic-beta`.
+ */
+declare function injectExtendedContextBeta(headers: Record<string, string>, model: string, useExtendedContext: boolean): void;
+
+export { EXTENDED_CONTEXT_BETA, injectExtendedContextBeta };

package/dist/transformer/anthropicBetaInject.js

@@ -0,0 +1,25 @@
+// src/transformer/anthropicBetaInject.ts
+import { isExtendedContextCapable } from "@omnicross/contracts/extended-context";
+var EXTENDED_CONTEXT_BETA = "context-1m-2025-08-07";
+var ANTHROPIC_BETA_HEADER = "anthropic-beta";
+function injectExtendedContextBeta(headers, model, useExtendedContext) {
+  if (!useExtendedContext) return;
+  if (!isExtendedContextCapable(model)) return;
+  let existingValue = "";
+  for (const key of Object.keys(headers)) {
+    if (key.toLowerCase() === ANTHROPIC_BETA_HEADER) {
+      const v = headers[key];
+      if (typeof v === "string") existingValue = v;
+      if (key !== ANTHROPIC_BETA_HEADER) delete headers[key];
+    }
+  }
+  const parts = existingValue.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (!parts.includes(EXTENDED_CONTEXT_BETA)) {
+    parts.push(EXTENDED_CONTEXT_BETA);
+  }
+  headers[ANTHROPIC_BETA_HEADER] = parts.join(",");
+}
+export {
+  EXTENDED_CONTEXT_BETA,
+  injectExtendedContextBeta
+};