monora-ai 2.1.0 → 2.1.3

package/dist/quotas.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Resource quotas for controlling LLM usage and costs.
+ *
+ * Provides per-trace limits on tokens, LLM calls, and duration
+ * to prevent runaway costs and resource exhaustion.
+ */
+/**
+ * Quota enforcement action when limits are exceeded.
+ */
+export type QuotaAction = 'warn' | 'block';
+/**
+ * Configuration for resource quotas.
+ */
+export interface QuotasConfig {
+    /** Enable quota enforcement (default: false) */
+    enabled?: boolean;
+    /** Maximum tokens per trace (input + output combined) */
+    max_tokens_per_trace?: number;
+    /** Maximum LLM calls per trace */
+    max_llm_calls_per_trace?: number;
+    /** Maximum trace duration in seconds */
+    max_trace_duration_sec?: number;
+    /** Maximum cost per trace in USD (requires cost tracking) */
+    max_cost_per_trace?: number;
+    /** Action when quota exceeded: 'warn' logs warning, 'block' throws error */
+    action?: QuotaAction;
+}
+/**
+ * Default quota configuration values.
+ */
+export declare const DEFAULT_QUOTAS: Required<QuotasConfig>;
+/**
+ * Result of a quota check.
+ */
+export interface QuotaCheckResult {
+    /** Whether the quota check passed */
+    allowed: boolean;
+    /** Which quota was exceeded (if any) */
+    exceededQuota?: 'tokens' | 'calls' | 'duration' | 'cost';
+    /** Current value */
+    currentValue?: number;
+    /** Limit value */
+    limitValue?: number;
+    /** Human-readable message */
+    message: string;
+}
+/**
+ * Quota violation error thrown when action is 'block'.
+ */
+export declare class QuotaExceededError extends Error {
+    readonly quota: string;
+    readonly currentValue: number;
+    readonly limitValue: number;
+    /** Policy type for metrics (e.g., "quota.tokens"). Matches Python SDK's policy_type. */
+    readonly policyType: string;
+    readonly model: string;
+    constructor(quota: string, currentValue: number, limitValue: number, model?: string);
+}
+/**
+ * Usage statistics for a trace.
+ */
+export interface TraceUsage {
+    /** Total tokens used (input + output) */
+    totalTokens: number;
+    /** Number of LLM calls made */
+    llmCalls: number;
+    /** Trace start time (epoch ms) */
+    startTime: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+}
+/**
+ * Resource quota tracker for a single trace.
+ */
+export declare class TraceQuotaTracker {
+    private readonly config;
+    private usage;
+    constructor(config?: QuotasConfig);
+    /**
+     * Check if quotas are enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Get current usage statistics.
+     */
+    getUsage(): TraceUsage;
+    /**
+     * Get the quota configuration.
+     */
+    getConfig(): Required<QuotasConfig>;
+    /**
+     * Update trace start time if the provided time is earlier.
+     */
+    setStartTime(startTime?: number): void;
+    /**
+     * Record token usage from an LLM call.
+     *
+     * @param inputTokens - Number of input/prompt tokens
+     * @param outputTokens - Number of output/completion tokens
+     * @param cost - Optional cost in USD for this call
+     */
+    recordTokenUsage(inputTokens: number, outputTokens: number, cost?: number): void;
+    /**
+     * Check all quotas and return the result.
+     * Does not modify state or throw errors.
+     */
+    checkQuotas(): QuotaCheckResult;
+    /**
+     * Enforce quotas based on configured action.
+     * Logs warning or throws error depending on config.
+     *
+     * @throws QuotaExceededError if action is 'block' and quota exceeded
+     */
+    enforceQuotas(): QuotaCheckResult;
+    /**
+     * Reset usage statistics (for reuse).
+     */
+    reset(): void;
+}
+/**
+ * Global quota manager that tracks quotas per trace.
+ */
+export declare class QuotaManager {
+    private readonly defaultConfig;
+    private readonly trackers;
+    constructor(config?: QuotasConfig);
+    /**
+     * Check if quotas are enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Get or create a quota tracker for a trace.
+     */
+    getTracker(traceId: string): TraceQuotaTracker;
+    /**
+     * Check if a quota tracker exists for a trace without creating one.
+     */
+    hasTracker(traceId: string): boolean;
+    /**
+     * Record token usage for a trace.
+     */
+    recordUsage(traceId: string, inputTokens: number, outputTokens: number, cost?: number): void;
+    /**
+     * Check quotas for a trace (creates a tracker if missing).
+     */
+    checkQuotas(traceId: string): QuotaCheckResult;
+    /**
+     * Enforce quotas for a trace (creates a tracker if missing).
+     *
+     * @throws QuotaExceededError if action is 'block' and quota exceeded
+     */
+    enforceQuotas(traceId: string): QuotaCheckResult;
+    /**
+     * Get usage statistics for a trace without creating a tracker.
+     * Returns null if the trace is unknown.
+     */
+    getUsage(traceId: string): TraceUsage | null;
+    /**
+     * Remove tracker for a completed trace.
+     */
+    removeTrace(traceId: string): void;
+    /**
+     * Get all tracked trace IDs.
+     */
+    getTrackedTraces(): string[];
+    /**
+     * Clear all trackers.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=quotas.d.ts.map

package/dist/quotas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotas.d.ts","sourceRoot":"","sources":["../src/quotas.ts"],"names":[],"mappings":"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"}

package/dist/quotas.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Resource quotas for controlling LLM usage and costs.
+ *
+ * Provides per-trace limits on tokens, LLM calls, and duration
+ * to prevent runaway costs and resource exhaustion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuotaManager = exports.TraceQuotaTracker = exports.QuotaExceededError = exports.DEFAULT_QUOTAS = void 0;
+const logger_1 = require("./logger");
+const context_1 = require("./context");
+/**
+ * Default quota configuration values.
+ */
+exports.DEFAULT_QUOTAS = {
+    enabled: false,
+    max_tokens_per_trace: 100000,
+    max_llm_calls_per_trace: 50,
+    max_trace_duration_sec: 3600,
+    max_cost_per_trace: 10.0,
+    action: 'warn',
+};
+/**
+ * Quota violation error thrown when action is 'block'.
+ */
+class QuotaExceededError extends Error {
+    constructor(quota, currentValue, limitValue, model) {
+        super(`Quota exceeded: ${quota} (${currentValue} > ${limitValue})`);
+        this.name = 'QuotaExceededError';
+        this.quota = quota;
+        this.currentValue = currentValue;
+        this.limitValue = limitValue;
+        this.policyType = `quota.${quota}`;
+        this.model = model || 'unknown';
+    }
+}
+exports.QuotaExceededError = QuotaExceededError;
+/**
+ * Resource quota tracker for a single trace.
+ */
+class TraceQuotaTracker {
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_QUOTAS, ...config };
+        this.usage = {
+            totalTokens: 0,
+            llmCalls: 0,
+            startTime: Date.now(),
+            estimatedCost: 0,
+        };
+    }
+    /**
+     * Check if quotas are enabled.
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Get current usage statistics.
+     */
+    getUsage() {
+        return { ...this.usage };
+    }
+    /**
+     * Get the quota configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update trace start time if the provided time is earlier.
+     */
+    setStartTime(startTime) {
+        if (startTime === undefined || startTime === null) {
+            return;
+        }
+        if (startTime < this.usage.startTime) {
+            this.usage.startTime = startTime;
+        }
+    }
+    /**
+     * Record token usage from an LLM call.
+     *
+     * @param inputTokens - Number of input/prompt tokens
+     * @param outputTokens - Number of output/completion tokens
+     * @param cost - Optional cost in USD for this call
+     */
+    recordTokenUsage(inputTokens, outputTokens, cost) {
+        this.usage.totalTokens += inputTokens + outputTokens;
+        this.usage.llmCalls += 1;
+        if (cost !== undefined) {
+            this.usage.estimatedCost += cost;
+        }
+    }
+    /**
+     * Check all quotas and return the result.
+     * Does not modify state or throw errors.
+     */
+    checkQuotas() {
+        if (!this.config.enabled) {
+            return { allowed: true, message: 'Quotas disabled' };
+        }
+        // Check token quota
+        if (this.usage.totalTokens > this.config.max_tokens_per_trace) {
+            return {
+                allowed: false,
+                exceededQuota: 'tokens',
+                currentValue: this.usage.totalTokens,
+                limitValue: this.config.max_tokens_per_trace,
+                message: `Token quota exceeded: ${this.usage.totalTokens} > ${this.config.max_tokens_per_trace}`,
+            };
+        }
+        // Check call quota
+        if (this.usage.llmCalls > this.config.max_llm_calls_per_trace) {
+            return {
+                allowed: false,
+                exceededQuota: 'calls',
+                currentValue: this.usage.llmCalls,
+                limitValue: this.config.max_llm_calls_per_trace,
+                message: `LLM call quota exceeded: ${this.usage.llmCalls} > ${this.config.max_llm_calls_per_trace}`,
+            };
+        }
+        // Check duration quota
+        const durationSec = (Date.now() - this.usage.startTime) / 1000;
+        if (durationSec > this.config.max_trace_duration_sec) {
+            return {
+                allowed: false,
+                exceededQuota: 'duration',
+                currentValue: durationSec,
+                limitValue: this.config.max_trace_duration_sec,
+                message: `Trace duration quota exceeded: ${durationSec.toFixed(1)}s > ${this.config.max_trace_duration_sec}s`,
+            };
+        }
+        // Check cost quota
+        if (this.usage.estimatedCost > this.config.max_cost_per_trace) {
+            return {
+                allowed: false,
+                exceededQuota: 'cost',
+                currentValue: this.usage.estimatedCost,
+                limitValue: this.config.max_cost_per_trace,
+                message: `Cost quota exceeded: $${this.usage.estimatedCost.toFixed(4)} > $${this.config.max_cost_per_trace}`,
+            };
+        }
+        return { allowed: true, message: 'All quotas within limits' };
+    }
+    /**
+     * Enforce quotas based on configured action.
+     * Logs warning or throws error depending on config.
+     *
+     * @throws QuotaExceededError if action is 'block' and quota exceeded
+     */
+    enforceQuotas() {
+        const result = this.checkQuotas();
+        if (!result.allowed) {
+            if (this.config.action === 'block') {
+                throw new QuotaExceededError(result.exceededQuota, result.currentValue, result.limitValue);
+            }
+            else {
+                logger_1.logger.warning('Quota warning: %s', result.message);
+            }
+        }
+        return result;
+    }
+    /**
+     * Reset usage statistics (for reuse).
+     */
+    reset() {
+        this.usage = {
+            totalTokens: 0,
+            llmCalls: 0,
+            startTime: Date.now(),
+            estimatedCost: 0,
+        };
+    }
+}
+exports.TraceQuotaTracker = TraceQuotaTracker;
+/**
+ * Global quota manager that tracks quotas per trace.
+ */
+class QuotaManager {
+    constructor(config = {}) {
+        this.trackers = new Map();
+        this.defaultConfig = { ...exports.DEFAULT_QUOTAS, ...config };
+    }
+    /**
+     * Check if quotas are enabled.
+     */
+    isEnabled() {
+        return this.defaultConfig.enabled;
+    }
+    /**
+     * Get or create a quota tracker for a trace.
+     */
+    getTracker(traceId) {
+        let tracker = this.trackers.get(traceId);
+        if (!tracker) {
+            tracker = new TraceQuotaTracker(this.defaultConfig);
+            this.trackers.set(traceId, tracker);
+        }
+        const startTime = (0, context_1.getTraceStartTime)(traceId);
+        tracker.setStartTime(startTime);
+        return tracker;
+    }
+    /**
+     * Check if a quota tracker exists for a trace without creating one.
+     */
+    hasTracker(traceId) {
+        return this.trackers.has(traceId);
+    }
+    /**
+     * Record token usage for a trace.
+     */
+    recordUsage(traceId, inputTokens, outputTokens, cost) {
+        const tracker = this.getTracker(traceId);
+        tracker.recordTokenUsage(inputTokens, outputTokens, cost);
+    }
+    /**
+     * Check quotas for a trace (creates a tracker if missing).
+     */
+    checkQuotas(traceId) {
+        const tracker = this.getTracker(traceId);
+        return tracker.checkQuotas();
+    }
+    /**
+     * Enforce quotas for a trace (creates a tracker if missing).
+     *
+     * @throws QuotaExceededError if action is 'block' and quota exceeded
+     */
+    enforceQuotas(traceId) {
+        const tracker = this.getTracker(traceId);
+        return tracker.enforceQuotas();
+    }
+    /**
+     * Get usage statistics for a trace without creating a tracker.
+     * Returns null if the trace is unknown.
+     */
+    getUsage(traceId) {
+        const tracker = this.trackers.get(traceId);
+        return tracker ? tracker.getUsage() : null;
+    }
+    /**
+     * Remove tracker for a completed trace.
+     */
+    removeTrace(traceId) {
+        this.trackers.delete(traceId);
+    }
+    /**
+     * Get all tracked trace IDs.
+     */
+    getTrackedTraces() {
+        return Array.from(this.trackers.keys());
+    }
+    /**
+     * Clear all trackers.
+     */
+    clear() {
+        this.trackers.clear();
+    }
+}
+exports.QuotaManager = QuotaManager;

package/dist/register.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Auto-init hook for zero-code instrumentation.
+ *
+ * This module is designed to be loaded via NODE_OPTIONS="--require monora-ai/register"
+ * It automatically initializes Monora and instruments detected AI SDKs.
+ *
+ * Usage:
+ *   npx monora start -- node server.js
+ *   NODE_OPTIONS="--require monora-ai/register" node server.js
+ */
+import { init, shutdown } from './runtime';
+export { init, shutdown };
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAe,MAAM,WAAW,CAAC;AAgGxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC"}

package/dist/register.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Auto-init hook for zero-code instrumentation.
+ *
+ * This module is designed to be loaded via NODE_OPTIONS="--require monora-ai/register"
+ * It automatically initializes Monora and instruments detected AI SDKs.
+ *
+ * Usage:
+ *   npx monora start -- node server.js
+ *   NODE_OPTIONS="--require monora-ai/register" node server.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdown = exports.init = void 0;
+const runtime_1 = require("./runtime");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return runtime_1.init; } });
+Object.defineProperty(exports, "shutdown", { enumerable: true, get: function () { return runtime_1.shutdown; } });
+const autodetect_1 = require("./autodetect");
+const integrations_1 = require("./integrations");
+const logger_1 = require("./logger");
+let isShuttingDown = false;
+// Only auto-init if explicitly enabled
+if (process.env.MONORA_AUTO_INIT === 'true') {
+    const configPath = process.env.MONORA_CONFIG_PATH;
+    try {
+        // Build init options
+        const initOptions = {};
+        if (configPath) {
+            initOptions.configPath = configPath;
+            logger_1.logger.debug('Monora: using config from %s', configPath);
+        }
+        else {
+            // Auto-detect configuration
+            const detection = (0, autodetect_1.detectFramework)();
+            const env = (0, autodetect_1.detectEnvironment)();
+            const preset = (0, autodetect_1.selectPresetForEnvironment)(env);
+            initOptions.preset = preset;
+            // Apply detected model allowlist
+            if (detection.suggestedModels.length > 0) {
+                initOptions.policies = detection.suggestedModels;
+            }
+            logger_1.logger.debug('Monora: using auto-detected config (preset=%s, env=%s)', preset, env);
+        }
+        // Initialize Monora
+        (0, runtime_1.init)(initOptions);
+        logger_1.logger.info('Monora: initialized with auto-instrumentation');
+        // Auto-patch detected SDKs
+        const detection = (0, autodetect_1.detectFramework)();
+        const sdkNames = new Set(detection.aiSdks.map(sdk => sdk.name));
+        if (sdkNames.has('openai') || sdkNames.has('vercel-ai-openai') || sdkNames.has('langchain-openai')) {
+            try {
+                // Check if OpenAI is actually importable
+                require.resolve('openai');
+                (0, integrations_1.patchOpenAI)({});
+                logger_1.logger.debug('Monora: patched OpenAI SDK');
+            }
+            catch {
+                // OpenAI not installed, skip
+            }
+        }
+        if (sdkNames.has('anthropic') || sdkNames.has('vercel-ai-anthropic') || sdkNames.has('langchain-anthropic')) {
+            try {
+                // Check if Anthropic is actually importable
+                require.resolve('@anthropic-ai/sdk');
+                (0, integrations_1.patchAnthropic)({});
+                logger_1.logger.debug('Monora: patched Anthropic SDK');
+            }
+            catch {
+                // Anthropic not installed, skip
+            }
+        }
+        // Graceful shutdown on process exit
+        const handleExit = async () => {
+            if (isShuttingDown) {
+                return;
+            }
+            isShuttingDown = true;
+            try {
+                await (0, runtime_1.shutdown)();
+            }
+            catch {
+                // Ignore shutdown errors
+            }
+        };
+        process.on('SIGINT', async () => {
+            await handleExit();
+            process.exit(130);
+        });
+        process.on('SIGTERM', async () => {
+            await handleExit();
+            process.exit(143);
+        });
+        process.on('beforeExit', async () => {
+            await handleExit();
+        });
+    }
+    catch (error) {
+        logger_1.logger.error('Monora: failed to auto-init: %s', error);
+    }
+}

package/dist/registry.d.ts

@@ -79,6 +79,7 @@ export declare class ModelRegistry {
     private loadCustomRegistry;
     private loadModels;
     private canonicalizeModel;
+    getModelMetadata(model: string | null | undefined): Record<string, any> | null;
 }
 export {};
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/registry.js

@@ -207,5 +207,12 @@ class ModelRegistry {
         }
         return this._aliasToCanonical.get(model.toLowerCase()) || model;
     }
+    getModelMetadata(model) {
+        if (!model) {
+            return null;
+        }
+        const canonical = this.canonicalizeModel(model);
+        return this._models.get(canonical) || null;
+    }
 }
 exports.ModelRegistry = ModelRegistry;

package/dist/registryData.json

@@ -28,7 +28,13 @@
       "context_window": 128000,
       "capabilities": ["chat", "function_calling", "vision"],
       "aliases": ["gpt-4o-2024-05-13"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 2.5,
+        "completion_cost_per_1m": 10.0
+      }
     },
     "gpt-4o-mini": {
       "provider": "openai",
@@ -38,7 +44,13 @@
       "context_window": 128000,
       "capabilities": ["chat", "function_calling", "vision"],
       "aliases": ["gpt-4o-mini-2024-07-18"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 0.15,
+        "completion_cost_per_1m": 0.6
+      }
     },
     "gpt-3.5-turbo": {
       "provider": "openai",
@@ -48,7 +60,13 @@
       "context_window": 16385,
       "capabilities": ["chat", "function_calling"],
       "aliases": ["gpt-3.5-turbo-0125"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 0.5,
+        "completion_cost_per_1m": 1.5
+      }
     },
     "claude-3-5-sonnet-20241022": {
       "provider": "anthropic",
@@ -58,7 +76,13 @@
       "context_window": 200000,
       "capabilities": ["chat", "tool_use", "vision"],
       "aliases": ["claude-3.5-sonnet"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 3.0,
+        "completion_cost_per_1m": 15.0
+      }
     },
     "claude-3-opus-20240229": {
       "provider": "anthropic",
@@ -68,7 +92,13 @@
       "context_window": 200000,
       "capabilities": ["chat", "tool_use", "vision"],
       "aliases": ["claude-3-opus"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 15.0,
+        "completion_cost_per_1m": 75.0
+      }
     },
     "deepseek-chat": {
       "provider": "deepseek",
@@ -78,7 +108,14 @@
       "context_window": 64000,
       "capabilities": ["chat"],
       "aliases": ["deepseek:v3"],
-      "deprecated": false
+      "deprecated": false,
+      "pricing": {
+        "currency": "USD",
+        "unit": "1m_tokens",
+        "prompt_cost_per_1m": 0.28,
+        "completion_cost_per_1m": 0.42,
+        "notes": "cache_miss_pricing"
+      }
     }
   },
   "providers": {