monora-ai 2.1.0 → 2.1.3

package/dist/sinks/stdout.js

@@ -6,10 +6,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StdoutSink = void 0;
 const util_1 = require("util");
 class StdoutSink {
-    constructor(format = 'json') {
+    constructor(format = 'pretty') {
         this.format = format;
+        this.quiet = isQuietMode();
     }
     emit(events) {
+        if (this.quiet) {
+            return;
+        }
         for (const event of events) {
             try {
                 const payload = this.format === 'pretty'
@@ -32,3 +36,10 @@ class StdoutSink {
     }
 }
 exports.StdoutSink = StdoutSink;
+function isQuietMode() {
+    const raw = String(process.env.MONORA_QUIET || '').trim().toLowerCase();
+    if (!raw) {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(raw);
+}

package/dist/spec.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Monora Schema Specification Types
+ *
+ * Provides typed schema definitions for AI model monitoring with
+ * field specifications, PII detection, and compliance configuration.
+ */
+/** Field data types for schema definition */
+export type FieldType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+/** Types of PII that can be detected in fields */
+export type PIIType = 'email' | 'phone' | 'ssn' | 'credit_card' | 'name' | 'address' | 'ip_address' | 'date_of_birth' | 'custom';
+/** Field role in the AI system */
+export type FieldRole = 'input' | 'output' | 'metadata' | 'identifier';
+/**
+ * Specification for a single field in the schema.
+ */
+export interface FieldSpec {
+    /** Field name (supports dot notation for nested fields) */
+    name: string;
+    /** Data type of the field */
+    dataType: FieldType;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field can be null */
+    nullable?: boolean;
+    /** Human-readable description */
+    description?: string;
+    /** Type of PII contained, if any */
+    piiType?: PIIType;
+    /** Regex pattern for redacting PII */
+    redactionPattern?: string;
+    /** Minimum value for numeric fields */
+    minValue?: number;
+    /** Maximum value for numeric fields */
+    maxValue?: number;
+    /** Regex pattern for string validation */
+    pattern?: string;
+    /** Role of the field (input/output/metadata/identifier) */
+    role?: FieldRole;
+}
+/**
+ * Create a FieldSpec with defaults applied.
+ */
+export declare function createFieldSpec(name: string, dataType: FieldType, options?: Partial<Omit<FieldSpec, 'name' | 'dataType'>>): FieldSpec;
+/**
+ * Convert FieldSpec to JSON Schema property definition.
+ */
+export declare function fieldSpecToJsonSchema(spec: FieldSpec): Record<string, any>;
+/**
+ * Convert FieldSpec to a redaction rule for data handling.
+ */
+export declare function fieldSpecToRedactionRule(spec: FieldSpec): Record<string, any> | null;
+/**
+ * Enrichment configuration for compliance features.
+ */
+export interface EnrichmentConfig {
+    /** Enable bias detection */
+    biasDetection?: boolean;
+    /** Enable risk tracking */
+    riskTracking?: boolean;
+    /** Enable human oversight */
+    humanOversight?: boolean;
+    /** Enable data redaction */
+    dataRedaction?: boolean;
+    /** Enable identity tracking */
+    identityTracking?: boolean;
+    /** Enable cost tracking */
+    costTracking?: boolean;
+    /** Enable immutability/hash chain */
+    immutability?: boolean;
+    /** Enable event signing */
+    signing?: boolean;
+    /** Enable data governance */
+    dataGovernance?: boolean;
+    /** Enable lifecycle tracking */
+    lifecycleTracking?: boolean;
+    /** Enable data residency enforcement */
+    dataResidency?: boolean;
+}
+/**
+ * Create default EnrichmentConfig.
+ */
+export declare function createEnrichmentConfig(options?: Partial<EnrichmentConfig>): EnrichmentConfig;
+/**
+ * Get enrichment configuration for a specific compliance framework.
+ */
+export declare function enrichmentConfigForFramework(framework: string): EnrichmentConfig;
+/**
+ * Merge two enrichment configurations (union of enabled features).
+ */
+export declare function mergeEnrichmentConfigs(base: EnrichmentConfig, other: EnrichmentConfig): EnrichmentConfig;
+/**
+ * MonoraSpec - Complete schema specification for an AI model.
+ */
+export interface MonoraSpec {
+    /** Input fields (prompts, queries, etc.) */
+    inputs: FieldSpec[];
+    /** Output fields (responses, completions, etc.) */
+    outputs: FieldSpec[];
+    /** Metadata fields (timestamps, service info, etc.) */
+    metadata?: FieldSpec[];
+    /** Identifier fields (trace_id, event_id, etc.) */
+    identifiers?: FieldSpec[];
+    /** Enrichment configuration */
+    enrichments?: EnrichmentConfig;
+    /** Compliance frameworks to target */
+    complianceTargets?: string[];
+    /** Model/application name */
+    modelName?: string;
+    /** Model version */
+    modelVersion?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Event timestamp field name */
+    eventTimestampField?: string;
+}
+/**
+ * Create a MonoraSpec with defaults applied.
+ */
+export declare function createMonoraSpec(options: {
+    inputs: FieldSpec[];
+    outputs: FieldSpec[];
+    metadata?: FieldSpec[];
+    identifiers?: FieldSpec[];
+    enrichments?: EnrichmentConfig;
+    complianceTargets?: string[];
+    modelName?: string;
+    modelVersion?: string;
+    description?: string;
+    eventTimestampField?: string;
+}): MonoraSpec;
+/**
+ * Get all fields from a MonoraSpec.
+ */
+export declare function getAllFields(spec: MonoraSpec): FieldSpec[];
+/**
+ * Get fields with PII from a MonoraSpec.
+ */
+export declare function getPiiFields(spec: MonoraSpec): FieldSpec[];
+/**
+ * Convert MonoraSpec to schema contract format for onboarding validation.
+ */
+export declare function specToSchemaContract(spec: MonoraSpec): Record<string, any>;
+/**
+ * Convert MonoraSpec to Monora configuration format.
+ */
+export declare function specToConfig(spec: MonoraSpec): Record<string, any>;
+/**
+ * Create MonoraSpec from a schema contract.
+ */
+export declare function specFromSchemaContract(contract: Record<string, any>): MonoraSpec;
+/**
+ * Convert MonoraSpec to dictionary representation.
+ */
+export declare function specToDict(spec: MonoraSpec): Record<string, any>;
+/**
+ * Create MonoraSpec from dictionary representation.
+ */
+export declare function specFromDict(data: Record<string, any>): MonoraSpec;
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

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

package/dist/spec.js

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * Monora Schema Specification Types
+ *
+ * Provides typed schema definitions for AI model monitoring with
+ * field specifications, PII detection, and compliance configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFieldSpec = createFieldSpec;
+exports.fieldSpecToJsonSchema = fieldSpecToJsonSchema;
+exports.fieldSpecToRedactionRule = fieldSpecToRedactionRule;
+exports.createEnrichmentConfig = createEnrichmentConfig;
+exports.enrichmentConfigForFramework = enrichmentConfigForFramework;
+exports.mergeEnrichmentConfigs = mergeEnrichmentConfigs;
+exports.createMonoraSpec = createMonoraSpec;
+exports.getAllFields = getAllFields;
+exports.getPiiFields = getPiiFields;
+exports.specToSchemaContract = specToSchemaContract;
+exports.specToConfig = specToConfig;
+exports.specFromSchemaContract = specFromSchemaContract;
+exports.specToDict = specToDict;
+exports.specFromDict = specFromDict;
+/**
+ * Create a FieldSpec with defaults applied.
+ */
+function createFieldSpec(name, dataType, options = {}) {
+    return {
+        name,
+        dataType,
+        required: options.required ?? true,
+        nullable: options.nullable ?? false,
+        description: options.description,
+        piiType: options.piiType,
+        redactionPattern: options.redactionPattern,
+        minValue: options.minValue,
+        maxValue: options.maxValue,
+        pattern: options.pattern,
+        role: options.role,
+    };
+}
+/**
+ * Convert FieldSpec to JSON Schema property definition.
+ */
+function fieldSpecToJsonSchema(spec) {
+    const schema = {
+        type: spec.dataType,
+    };
+    if (spec.description) {
+        schema.description = spec.description;
+    }
+    if (spec.minValue !== undefined) {
+        schema.minimum = spec.minValue;
+    }
+    if (spec.maxValue !== undefined) {
+        schema.maximum = spec.maxValue;
+    }
+    if (spec.pattern) {
+        schema.pattern = spec.pattern;
+    }
+    return schema;
+}
+/**
+ * Convert FieldSpec to a redaction rule for data handling.
+ */
+function fieldSpecToRedactionRule(spec) {
+    if (!spec.piiType) {
+        return null;
+    }
+    const patterns = {
+        email: '[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}',
+        phone: '\\+?[\\d\\s\\-\\(\\)]{10,}',
+        ssn: '\\d{3}-?\\d{2}-?\\d{4}',
+        credit_card: '\\d{4}[\\s\\-]?\\d{4}[\\s\\-]?\\d{4}[\\s\\-]?\\d{4}',
+        ip_address: '\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}',
+        name: '.*',
+        address: '.*',
+        date_of_birth: '\\d{4}-\\d{2}-\\d{2}',
+        custom: '.*',
+    };
+    return {
+        fields: [spec.name],
+        pattern: spec.redactionPattern || patterns[spec.piiType],
+        replacement: `[REDACTED:${spec.piiType.toUpperCase()}]`,
+    };
+}
+/** Framework to enrichment mapping */
+const FRAMEWORK_ENRICHMENTS = {
+    gdpr: {
+        dataRedaction: true,
+        dataGovernance: true,
+        identityTracking: true,
+        dataResidency: true,
+    },
+    soc2: {
+        identityTracking: true,
+        riskTracking: true,
+        immutability: true,
+        signing: true,
+    },
+    iso42001: {
+        riskTracking: true,
+        humanOversight: true,
+        biasDetection: true,
+        lifecycleTracking: true,
+        dataGovernance: true,
+    },
+    eu_ai_act: {
+        riskTracking: true,
+        humanOversight: true,
+        biasDetection: true,
+        dataGovernance: true,
+        lifecycleTracking: true,
+    },
+    hipaa: {
+        dataRedaction: true,
+        identityTracking: true,
+        immutability: true,
+        signing: true,
+        dataGovernance: true,
+    },
+    iso27001: {
+        immutability: true,
+        signing: true,
+        identityTracking: true,
+        riskTracking: true,
+    },
+    pci_dss: {
+        dataRedaction: true,
+        immutability: true,
+        signing: true,
+        identityTracking: true,
+    },
+    nist_ai_rmf: {
+        riskTracking: true,
+        humanOversight: true,
+        biasDetection: true,
+        lifecycleTracking: true,
+    },
+};
+/**
+ * Create default EnrichmentConfig.
+ */
+function createEnrichmentConfig(options = {}) {
+    return {
+        biasDetection: options.biasDetection ?? false,
+        riskTracking: options.riskTracking ?? false,
+        humanOversight: options.humanOversight ?? false,
+        dataRedaction: options.dataRedaction ?? true,
+        identityTracking: options.identityTracking ?? false,
+        costTracking: options.costTracking ?? false,
+        immutability: options.immutability ?? true,
+        signing: options.signing ?? false,
+        dataGovernance: options.dataGovernance ?? false,
+        lifecycleTracking: options.lifecycleTracking ?? false,
+        dataResidency: options.dataResidency ?? false,
+    };
+}
+/**
+ * Get enrichment configuration for a specific compliance framework.
+ */
+function enrichmentConfigForFramework(framework) {
+    const frameworkLower = framework.toLowerCase().replace(/-/g, '_');
+    const frameworkConfig = FRAMEWORK_ENRICHMENTS[frameworkLower] || {};
+    return createEnrichmentConfig(frameworkConfig);
+}
+/**
+ * Merge two enrichment configurations (union of enabled features).
+ */
+function mergeEnrichmentConfigs(base, other) {
+    return {
+        biasDetection: base.biasDetection || other.biasDetection,
+        riskTracking: base.riskTracking || other.riskTracking,
+        humanOversight: base.humanOversight || other.humanOversight,
+        dataRedaction: base.dataRedaction || other.dataRedaction,
+        identityTracking: base.identityTracking || other.identityTracking,
+        costTracking: base.costTracking || other.costTracking,
+        immutability: base.immutability || other.immutability,
+        signing: base.signing || other.signing,
+        dataGovernance: base.dataGovernance || other.dataGovernance,
+        lifecycleTracking: base.lifecycleTracking || other.lifecycleTracking,
+        dataResidency: base.dataResidency || other.dataResidency,
+    };
+}
+/**
+ * Create a MonoraSpec with defaults applied.
+ */
+function createMonoraSpec(options) {
+    return {
+        inputs: options.inputs,
+        outputs: options.outputs,
+        metadata: options.metadata ?? [],
+        identifiers: options.identifiers ?? [],
+        enrichments: options.enrichments ?? createEnrichmentConfig(),
+        complianceTargets: options.complianceTargets ?? [],
+        modelName: options.modelName,
+        modelVersion: options.modelVersion ?? '1.0.0',
+        description: options.description,
+        eventTimestampField: options.eventTimestampField ?? 'timestamp',
+    };
+}
+/**
+ * Get all fields from a MonoraSpec.
+ */
+function getAllFields(spec) {
+    return [
+        ...spec.inputs,
+        ...spec.outputs,
+        ...(spec.metadata || []),
+        ...(spec.identifiers || []),
+    ];
+}
+/**
+ * Get fields with PII from a MonoraSpec.
+ */
+function getPiiFields(spec) {
+    return getAllFields(spec).filter((f) => f.piiType);
+}
+/**
+ * Convert MonoraSpec to schema contract format for onboarding validation.
+ */
+function specToSchemaContract(spec) {
+    const properties = {};
+    const required = [];
+    for (const field of getAllFields(spec)) {
+        properties[field.name] = fieldSpecToJsonSchema(field);
+        if (field.required) {
+            required.push(field.name);
+        }
+    }
+    return {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        type: 'object',
+        properties,
+        required,
+        roles: {
+            inputs: spec.inputs.map((f) => f.name),
+            outputs: spec.outputs.map((f) => f.name),
+            metadata: (spec.metadata || []).map((f) => f.name),
+            identifiers: (spec.identifiers || []).map((f) => f.name),
+        },
+        pii_fields: getPiiFields(spec).map((f) => ({
+            field: f.name,
+            type: f.piiType,
+        })),
+        model_info: {
+            name: spec.modelName,
+            version: spec.modelVersion,
+            description: spec.description,
+        },
+    };
+}
+/**
+ * Convert MonoraSpec to Monora configuration format.
+ */
+function specToConfig(spec) {
+    const enrichments = spec.enrichments || createEnrichmentConfig();
+    const redactionRules = [];
+    // Build redaction rules from PII fields
+    for (const field of getPiiFields(spec)) {
+        const rule = fieldSpecToRedactionRule(field);
+        if (rule) {
+            redactionRules.push(rule);
+        }
+    }
+    const config = {
+        defaults: {
+            service_name: spec.modelName || 'monora-model',
+        },
+        model_spec: {
+            name: spec.modelName || 'monora-model',
+            version: spec.modelVersion || '1.0.0',
+            event_ts_field: spec.eventTimestampField || 'timestamp',
+            roles: {
+                inputs: spec.inputs.map((f) => f.name),
+                outputs: spec.outputs.map((f) => f.name),
+                metadata: (spec.metadata || []).map((f) => f.name),
+                identifiers: (spec.identifiers || []).map((f) => f.name),
+            },
+        },
+        immutability: {
+            enabled: enrichments.immutability ?? true,
+            verify_on_emit: true,
+        },
+        signing: {
+            enabled: enrichments.signing ?? false,
+        },
+        identity: {
+            enabled: enrichments.identityTracking ?? false,
+        },
+        risk_register: {
+            enabled: enrichments.riskTracking ?? false,
+        },
+        bias: {
+            enabled: enrichments.biasDetection ?? false,
+        },
+        human_oversight: {
+            enabled: enrichments.humanOversight ?? false,
+        },
+        data_governance: {
+            enabled: enrichments.dataGovernance ?? false,
+        },
+        lifecycle: {
+            enabled: enrichments.lifecycleTracking ?? false,
+        },
+    };
+    // Add data handling if redaction enabled
+    if (enrichments.dataRedaction && redactionRules.length > 0) {
+        config.data_handling = {
+            enabled: true,
+            mode: 'redact',
+            rules: redactionRules,
+        };
+    }
+    // Add compliance targets
+    if (spec.complianceTargets && spec.complianceTargets.length > 0) {
+        config.onboarding = {
+            enabled: true,
+            standards: spec.complianceTargets.map((t) => t.toUpperCase()),
+        };
+    }
+    return config;
+}
+/**
+ * Create MonoraSpec from a schema contract.
+ */
+function specFromSchemaContract(contract) {
+    const roles = contract.roles || {};
+    const properties = contract.properties || {};
+    const piiFieldsRaw = contract.pii_fields || [];
+    const modelInfo = contract.model_info || {};
+    const piiMap = new Map();
+    for (const pii of piiFieldsRaw) {
+        if (pii.field && pii.type) {
+            piiMap.set(pii.field, pii.type);
+        }
+    }
+    const createFieldsFromRoles = (roleNames, role) => {
+        return (roleNames || []).map((name) => {
+            const prop = properties[name] || {};
+            return createFieldSpec(name, prop.type || 'string', {
+                description: prop.description,
+                piiType: piiMap.get(name),
+                required: (contract.required || []).includes(name),
+                role,
+            });
+        });
+    };
+    return createMonoraSpec({
+        inputs: createFieldsFromRoles(roles.inputs || [], 'input'),
+        outputs: createFieldsFromRoles(roles.outputs || [], 'output'),
+        metadata: createFieldsFromRoles(roles.metadata || [], 'metadata'),
+        identifiers: createFieldsFromRoles(roles.identifiers || [], 'identifier'),
+        modelName: modelInfo.name,
+        modelVersion: modelInfo.version,
+        description: modelInfo.description,
+    });
+}
+/**
+ * Convert MonoraSpec to dictionary representation.
+ */
+function specToDict(spec) {
+    return {
+        inputs: spec.inputs,
+        outputs: spec.outputs,
+        metadata: spec.metadata || [],
+        identifiers: spec.identifiers || [],
+        enrichments: spec.enrichments || createEnrichmentConfig(),
+        compliance_targets: spec.complianceTargets || [],
+        model_name: spec.modelName,
+        model_version: spec.modelVersion,
+        description: spec.description,
+        event_timestamp_field: spec.eventTimestampField,
+    };
+}
+/**
+ * Create MonoraSpec from dictionary representation.
+ */
+function specFromDict(data) {
+    return createMonoraSpec({
+        inputs: data.inputs || [],
+        outputs: data.outputs || [],
+        metadata: data.metadata || [],
+        identifiers: data.identifiers || [],
+        enrichments: data.enrichments,
+        complianceTargets: data.compliance_targets || data.complianceTargets,
+        modelName: data.model_name || data.modelName,
+        modelVersion: data.model_version || data.modelVersion,
+        description: data.description,
+        eventTimestampField: data.event_timestamp_field || data.eventTimestampField,
+    });
+}