@omnicross/core 0.1.2 → 0.1.4

package/dist/usage/usage-recorder.cjs

@@ -1,6 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkXBSYYZIYcjs = require('../chunk-XBSYYZIY.cjs');
+var _chunkSNYBEXLBcjs = require('../chunk-SNYBEXLB.cjs');
+require('../chunk-XSVNC2UD.cjs');
 
 
-exports.UsageRecorder = _chunkXBSYYZIYcjs.UsageRecorder;
+exports.UsageRecorder = _chunkSNYBEXLBcjs.UsageRecorder;

package/dist/usage/usage-recorder.d.cts

@@ -1,5 +1,5 @@
 import { PricingEngine } from './pricing-engine.cjs';
-import { UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
+import { UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, UsageTimeBucket, UsageTimeSeriesBucket, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
 import { UsageEngineOrigin, UsageTokens } from '@omnicross/contracts/usage-types';
 import { L as Logger } from '../logger-4GvQNzhE.cjs';
 import { UsageEventStore } from '../ports/usage-event-store.cjs';
@@ -34,6 +34,15 @@ interface UsageRecordInput {
     runId?: string | null;
     /** Host event-correlation id for this call. Optional / additive. */
     eventId?: string | null;
+    /**
+     * OPTIONAL per-request audit correlation key (request-audit-log). When the
+     * OUTBOUND relay taps set this to the request's `http.ServerResponse`, the
+     * recorder stashes this request's token counts (synchronously) + cost (on the
+     * deferred pricing tick) keyed by it, so the audit capture can enrich its
+     * record. Any other caller leaves it unset ⇒ the audit stash is never touched
+     * (byte-identical zero regression). Opaque object; NEVER inspected/serialized.
+     */
+    auditResponse?: object;
 }
 /** Optional knobs (mostly for hosts/tests). */
 interface UsageRecorderOptions {
@@ -43,12 +52,20 @@ interface UsageRecorderOptions {
      * `setImmediate` to preserve their exact scheduling.
      */
     defer?: (fn: () => void) => void;
+    /**
+     * OPTIONAL per-request hook (outbound-key-policy). Called synchronously after
+     * cost is computed for each recorded request that carries an `apiKeyId`, so a
+     * host can keep a live per-key spend aggregate WITHOUT re-scanning the store.
+     * Absent ⇒ no-op (byte-identical for hosts/tests that do not wire it).
+     */
+    onRecord?: (apiKeyId: string, costUsd: number, now: number) => void;
 }
 declare class UsageRecorder {
     private store;
     private pricing;
     private logger;
     private defer;
+    private onRecord?;
     constructor(store: UsageEventStore, pricing: PricingEngine, logger: Logger, options?: UsageRecorderOptions);
     /**
      * Record one LLM request. Returns immediately — the actual store insert is
@@ -65,6 +82,7 @@ declare class UsageRecorder {
     getTotals(range: UsageDateRange): Promise<UsageTotals>;
     getByModel(range: UsageDateRange): Promise<ModelUsageRow[]>;
     getByApiKey(range: UsageDateRange): Promise<ApiKeyUsageRow[]>;
+    getTimeSeries(range: UsageDateRange, bucket: UsageTimeBucket): Promise<UsageTimeSeriesBucket[]>;
     getMessagesForSession(sessionId: string): Promise<MessageUsageRow[]>;
     /** Cumulative cache hit/miss stats for one session. */
     getSessionCacheStats(sessionId: string): Promise<SessionCacheStats>;

package/dist/usage/usage-recorder.d.ts

@@ -1,5 +1,5 @@
 import { PricingEngine } from './pricing-engine.js';
-import { UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
+import { UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, UsageTimeBucket, UsageTimeSeriesBucket, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
 import { UsageEngineOrigin, UsageTokens } from '@omnicross/contracts/usage-types';
 import { L as Logger } from '../logger-4GvQNzhE.js';
 import { UsageEventStore } from '../ports/usage-event-store.js';
@@ -34,6 +34,15 @@ interface UsageRecordInput {
     runId?: string | null;
     /** Host event-correlation id for this call. Optional / additive. */
     eventId?: string | null;
+    /**
+     * OPTIONAL per-request audit correlation key (request-audit-log). When the
+     * OUTBOUND relay taps set this to the request's `http.ServerResponse`, the
+     * recorder stashes this request's token counts (synchronously) + cost (on the
+     * deferred pricing tick) keyed by it, so the audit capture can enrich its
+     * record. Any other caller leaves it unset ⇒ the audit stash is never touched
+     * (byte-identical zero regression). Opaque object; NEVER inspected/serialized.
+     */
+    auditResponse?: object;
 }
 /** Optional knobs (mostly for hosts/tests). */
 interface UsageRecorderOptions {
@@ -43,12 +52,20 @@ interface UsageRecorderOptions {
      * `setImmediate` to preserve their exact scheduling.
      */
     defer?: (fn: () => void) => void;
+    /**
+     * OPTIONAL per-request hook (outbound-key-policy). Called synchronously after
+     * cost is computed for each recorded request that carries an `apiKeyId`, so a
+     * host can keep a live per-key spend aggregate WITHOUT re-scanning the store.
+     * Absent ⇒ no-op (byte-identical for hosts/tests that do not wire it).
+     */
+    onRecord?: (apiKeyId: string, costUsd: number, now: number) => void;
 }
 declare class UsageRecorder {
     private store;
     private pricing;
     private logger;
     private defer;
+    private onRecord?;
     constructor(store: UsageEventStore, pricing: PricingEngine, logger: Logger, options?: UsageRecorderOptions);
     /**
      * Record one LLM request. Returns immediately — the actual store insert is
@@ -65,6 +82,7 @@ declare class UsageRecorder {
     getTotals(range: UsageDateRange): Promise<UsageTotals>;
     getByModel(range: UsageDateRange): Promise<ModelUsageRow[]>;
     getByApiKey(range: UsageDateRange): Promise<ApiKeyUsageRow[]>;
+    getTimeSeries(range: UsageDateRange, bucket: UsageTimeBucket): Promise<UsageTimeSeriesBucket[]>;
     getMessagesForSession(sessionId: string): Promise<MessageUsageRow[]>;
     /** Cumulative cache hit/miss stats for one session. */
     getSessionCacheStats(sessionId: string): Promise<SessionCacheStats>;

package/dist/usage/usage-recorder.js

@@ -1,6 +1,7 @@
 import {
   UsageRecorder
-} from "../chunk-MNYKI4CI.js";
+} from "../chunk-BPKCU575.js";
+import "../chunk-OZFM4X3S.js";
 export {
   UsageRecorder
 };

package/dist/usage.cjs

@@ -4,8 +4,9 @@
 var _chunkYMFAJFQTcjs = require('./chunk-YMFAJFQT.cjs');
 
 
-var _chunkXBSYYZIYcjs = require('./chunk-XBSYYZIY.cjs');
+var _chunkSNYBEXLBcjs = require('./chunk-SNYBEXLB.cjs');
+require('./chunk-XSVNC2UD.cjs');
 
 
 
-exports.PricingEngine = _chunkYMFAJFQTcjs.PricingEngine; exports.UsageRecorder = _chunkXBSYYZIYcjs.UsageRecorder;
+exports.PricingEngine = _chunkYMFAJFQTcjs.PricingEngine; exports.UsageRecorder = _chunkSNYBEXLBcjs.UsageRecorder;

package/dist/usage.js

@@ -4,7 +4,8 @@ import {
 } from "./chunk-ZLX3KGXX.js";
 import {
   UsageRecorder
-} from "./chunk-MNYKI4CI.js";
+} from "./chunk-BPKCU575.js";
+import "./chunk-OZFM4X3S.js";
 export {
   PricingEngine,
   UsageRecorder

package/package.json

@@ -1,62 +1,64 @@
-{
-  "name": "@omnicross/core",
-  "version": "0.1.2",
-  "description": "Omnicross LLM serving core — provider dispatch, completion pipeline, transformers, and the provider proxy.",
-  "license": "MIT",
-  "author": "Sayo (https://github.com/Dumoedss)",
-  "homepage": "https://github.com/Dumoedss/omnicross#readme",
-  "keywords": [
-    "omnicross",
-    "llm",
-    "openai",
-    "anthropic",
-    "gemini",
-    "proxy",
-    "router",
-    "completion",
-    "transformer"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Dumoedss/omnicross.git",
-    "directory": "packages/core"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "type": "module",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "import": "./dist/*.js",
-      "require": "./dist/*.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "NOTICE",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
-  },
-  "dependencies": {
-    "@mozilla/readability": "^0.6.0",
-    "@omnicross/contracts": "^0.1.0",
-    "jsdom": "^24.1.3",
-    "turndown": "^7.2.2"
-  }
-}
+{
+  "name": "@omnicross/core",
+  "version": "0.1.4",
+  "description": "Omnicross LLM serving core 鈥?provider dispatch, completion pipeline, transformers, and the provider proxy.",
+  "license": "MIT",
+  "author": "Sayo (https://github.com/Dumoedss)",
+  "homepage": "https://github.com/Dumoedss/omnicross#readme",
+  "keywords": [
+    "omnicross",
+    "llm",
+    "openai",
+    "anthropic",
+    "gemini",
+    "proxy",
+    "router",
+    "completion",
+    "transformer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Dumoedss/omnicross.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
+  },
+  "dependencies": {
+    "@mozilla/readability": "^0.6.0",
+    "@omnicross/contracts": "^0.1.0",
+    "jsdom": "^24.1.3",
+    "socks": "^2.8.3",
+    "turndown": "^7.2.2",
+    "undici": "^6.21.1"
+  }
+}

package/dist/chunk-3MEACFK3.js

@@ -1,193 +0,0 @@
-import {
-  getSubscriptionRegistryForOutbound
-} from "./chunk-AQ5TNQB7.js";
-
-// src/outbound-api/subscriptionSupport.ts
-var SUBSCRIPTION_PROVIDER_IDS = [
-  "claude",
-  "codex",
-  "gemini",
-  "opencodego"
-];
-var SUBSCRIPTION_ID_SET = new Set(SUBSCRIPTION_PROVIDER_IDS);
-function isSubscriptionProviderId(providerId) {
-  if (SUBSCRIPTION_ID_SET.has(providerId)) return true;
-  const registry = getSubscriptionRegistryForOutbound();
-  return registry?.getProfile(providerId) != null;
-}
-var SUBSCRIPTION_SUPPORTED_ENDPOINTS = /* @__PURE__ */ new Set([
-  "messages",
-  "responses"
-]);
-function endpointSupportsSubscription(endpoint) {
-  return SUBSCRIPTION_SUPPORTED_ENDPOINTS.has(endpoint);
-}
-
-// src/outbound-api/routeResolver.ts
-function parseModelRef(ref) {
-  if (!ref) return null;
-  const idx = ref.indexOf(",");
-  if (idx <= 0) return null;
-  const providerId = ref.slice(0, idx).trim();
-  const modelId = ref.slice(idx + 1).trim();
-  if (!providerId || !modelId) return null;
-  return { providerId, modelId };
-}
-function pickModelRefForRole(config, role) {
-  if (role === "vision") {
-    if (config.visionModel && config.visionModel.trim()) {
-      return { ref: config.visionModel, effectiveRole: "vision" };
-    }
-    return { ref: config.defaultModel, effectiveRole: "default" };
-  }
-  if (role === "background") {
-    return { ref: config.backgroundModel, effectiveRole: "background" };
-  }
-  return { ref: config.defaultModel, effectiveRole: "default" };
-}
-async function resolveRoute(args) {
-  const { config, role, ingressFormat, llmConfig } = args;
-  const sessionId = args.sessionId ?? null;
-  const { ref, effectiveRole } = pickModelRefForRole(config, role);
-  if (!ref || !ref.trim()) {
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `endpoint '${config.endpoint}' has no ${effectiveRole} model configured`
-      }
-    };
-  }
-  const parsed = parseModelRef(ref);
-  if (!parsed) {
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `endpoint '${config.endpoint}' ${effectiveRole} model ref is malformed: '${ref}'`
-      }
-    };
-  }
-  const { providerId, modelId } = parsed;
-  const provider = await llmConfig.getProvider(providerId);
-  if (!provider) {
-    if (isSubscriptionProviderId(providerId)) {
-      return await resolveSubscriptionRoute({
-        config,
-        providerId,
-        modelId,
-        ingressFormat,
-        sessionId,
-        effectiveRole
-      });
-    }
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `provider '${providerId}' not found for endpoint '${config.endpoint}'`
-      }
-    };
-  }
-  const isOfficialProvider = provider.isOfficial === true || provider.id === "anthropic";
-  const targetProviderFormat = isOfficialProvider ? "anthropic" : "transform";
-  let anthropicSdkHints = null;
-  if (ingressFormat === "anthropic-messages") {
-    anthropicSdkHints = {
-      apiKey: resolveApiKey(provider.api_key),
-      isOfficialProvider,
-      passThrough: false,
-      attribution: { sessionId, apiKeyId: null }
-    };
-  }
-  const route = {
-    sessionId,
-    targetProviderFormat,
-    model: modelId,
-    ingressFormat,
-    authMode: "byo",
-    providerId,
-    anthropicSdkHints
-  };
-  return { ok: true, route, usedRole: effectiveRole };
-}
-async function resolveSubscriptionRoute(args) {
-  const { config, providerId, modelId, ingressFormat, sessionId, effectiveRole } = args;
-  if (!config.useSubscription) {
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `subscription routing disabled for endpoint '${config.endpoint}'`
-      }
-    };
-  }
-  if (!endpointSupportsSubscription(config.endpoint)) {
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `subscription routing is not supported on the '${config.endpoint}' endpoint; use a BYO API-key provider, or the /v1/messages or /v1/responses endpoint`
-      }
-    };
-  }
-  const registry = getSubscriptionRegistryForOutbound();
-  const profile = registry?.getProfile(providerId) ?? null;
-  if (!profile) {
-    return {
-      ok: false,
-      error: {
-        status: 503,
-        message: `subscription provider '${providerId}' is not available`
-      }
-    };
-  }
-  const hints = {
-    apiKey: "",
-    isOfficialProvider: false,
-    passThrough: false,
-    subscriptionProfile: profile,
-    attribution: { sessionId, apiKeyId: null }
-  };
-  const subscriptionConfig = providerId === "opencodego" ? await registry?.getOpenCodeGoConfig?.() : void 0;
-  const route = {
-    sessionId,
-    targetProviderFormat: "transform",
-    model: modelId,
-    ingressFormat,
-    authMode: "subscription",
-    providerId,
-    // Anthropic delegation carries the dispatch profile inside
-    // `anthropicSdkHints.subscriptionProfile`. The Responses ingress reads the
-    // TOP-LEVEL `route.subscriptionProfile`, and so does the built-in
-    // (factory-absent) `/v1/messages` subscription path (RT2.1) — the registry's
-    // `SubscriptionDispatchProfile` structurally satisfies `SubscriptionAuthProfile`
-    // ({ authStrategy, resolveUpstreamUrl, providerTransformerNames }), so set it
-    // for BOTH. This is INERT when an Anthropic ingress factory is present: that
-    // delegation reads the hint-bundle field above (and uses a different
-    // route-minting path), never the top-level field. (chat/gemini never reach
-    // here — Gate 2 rejected them.)
-    subscriptionProfile: ingressFormat === "openai-responses" || ingressFormat === "anthropic-messages" ? profile : void 0,
-    // Opaque per-account config (opencodego-only; `undefined` otherwise). Read by
-    // the built-in `/v1/messages` plan builder; INERT for the factory-present
-    // delegation path + non-opencodego.
-    subscriptionConfig,
-    anthropicSdkHints: hints
-  };
-  return { ok: true, route, usedRole: effectiveRole };
-}
-function resolveApiKey(apiKey) {
-  if (!apiKey) return "";
-  if (apiKey.startsWith("$")) {
-    return process.env[apiKey.slice(1)] || "";
-  }
-  return apiKey;
-}
-
-export {
-  SUBSCRIPTION_PROVIDER_IDS,
-  isSubscriptionProviderId,
-  endpointSupportsSubscription,
-  parseModelRef,
-  resolveRoute
-};

package/dist/chunk-6VIXXLMX.cjs

@@ -1,14 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/openrouter.ts
-function isOpenRouterProvider(provider) {
-  const baseUrl = (provider.api_base_url || "").toLowerCase();
-  return baseUrl.includes("openrouter.ai");
-}
-var OPENROUTER_APP_HEADERS = {
-  "HTTP-Referer": "https://omnicross.dev",
-  "X-Title": "omnicross"
-};
-
-
-
-
-exports.isOpenRouterProvider = isOpenRouterProvider; exports.OPENROUTER_APP_HEADERS = OPENROUTER_APP_HEADERS;

package/dist/chunk-E3WHL7CO.js

@@ -1,14 +0,0 @@
-// src/openrouter.ts
-function isOpenRouterProvider(provider) {
-  const baseUrl = (provider.api_base_url || "").toLowerCase();
-  return baseUrl.includes("openrouter.ai");
-}
-var OPENROUTER_APP_HEADERS = {
-  "HTTP-Referer": "https://omnicross.dev",
-  "X-Title": "omnicross"
-};
-
-export {
-  isOpenRouterProvider,
-  OPENROUTER_APP_HEADERS
-};