veto-sdk 1.0.0

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oBAAoB,EAAE,yBAAyB,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/providers/types.js

@@ -0,0 +1,10 @@
+/**
+ * Provider-specific type definitions.
+ *
+ * This module defines the tool schema formats used by different AI providers,
+ * allowing Veto to work transparently with each provider's format.
+ *
+ * @module providers/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/rules/api-client.d.ts

@@ -0,0 +1,103 @@
+/**
+ * API client for the validation endpoint.
+ *
+ * Sends tool call context and rules to an external API for validation
+ * and returns the decision.
+ *
+ * @module rules/api-client
+ */
+import type { Logger } from '../utils/logger.js';
+import type { Rule, ToolCallContext, ValidationAPIResponse } from './types.js';
+/**
+ * Configuration for the validation API client.
+ */
+export interface ValidationAPIConfig {
+    /** Base URL of the validation API */
+    baseUrl: string;
+    /** Endpoint path for tool call validation */
+    endpoint?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+    /** API key for authentication (sent as Authorization: Bearer header) */
+    apiKey?: string;
+    /** Number of retries on failure */
+    retries?: number;
+    /** Delay between retries in milliseconds */
+    retryDelay?: number;
+}
+/**
+ * Options for the API client.
+ */
+export interface ValidationAPIClientOptions {
+    /** API configuration */
+    config: ValidationAPIConfig;
+    /** Logger instance */
+    logger: Logger;
+    /** Behavior when API is unavailable */
+    failMode?: 'open' | 'closed';
+}
+/**
+ * Error thrown when the validation API fails.
+ */
+export declare class ValidationAPIError extends Error {
+    readonly statusCode?: number;
+    readonly responseBody?: string;
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/**
+ * Client for communicating with the validation API.
+ */
+export declare class ValidationAPIClient {
+    private readonly config;
+    private readonly logger;
+    private readonly failMode;
+    constructor(options: ValidationAPIClientOptions);
+    /**
+     * Validate a tool call against the rules.
+     *
+     * @param context - Tool call context
+     * @param rules - Applicable rules
+     * @returns Validation response
+     */
+    validate(context: ToolCallContext, rules: Rule[]): Promise<ValidationAPIResponse>;
+    /**
+     * Check if the API is healthy.
+     *
+     * @returns True if the API is reachable
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Make the actual HTTP request.
+     */
+    private makeRequest;
+    /**
+     * Build request headers.
+     */
+    private buildHeaders;
+    /**
+     * Parse and validate the API response.
+     */
+    private parseResponse;
+    /**
+     * Get a response based on fail mode when API is unavailable.
+     */
+    private getFailModeResponse;
+    /**
+     * Resolve configuration with defaults.
+     */
+    private resolveConfig;
+    /**
+     * Delay for the specified milliseconds.
+     */
+    private delay;
+}
+/**
+ * Create a new validation API client.
+ *
+ * @param options - Client options
+ * @returns ValidationAPIClient instance
+ */
+export declare function createValidationAPIClient(options: ValidationAPIClientOptions): ValidationAPIClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/rules/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/rules/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,IAAI,EACJ,eAAe,EAEf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAeD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wBAAwB;IACxB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAMxE;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;gBAEjC,OAAO,EAAE,0BAA0B;IAa/C;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC,qBAAqB,CAAC;IA0DjC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;OAEG;YACW,WAAW;IA6CzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAErB"}

package/dist/rules/api-client.js

@@ -0,0 +1,241 @@
+/**
+ * API client for the validation endpoint.
+ *
+ * Sends tool call context and rules to an external API for validation
+ * and returns the decision.
+ *
+ * @module rules/api-client
+ */
+/**
+ * Error thrown when the validation API fails.
+ */
+export class ValidationAPIError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.name = 'ValidationAPIError';
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+/**
+ * Client for communicating with the validation API.
+ */
+export class ValidationAPIClient {
+    config;
+    logger;
+    failMode;
+    constructor(options) {
+        this.config = this.resolveConfig(options.config);
+        this.logger = options.logger;
+        this.failMode = options.failMode ?? 'closed';
+        this.logger.info('Validation API client initialized', {
+            baseUrl: this.config.baseUrl,
+            endpoint: this.config.endpoint,
+            timeout: this.config.timeout,
+            failMode: this.failMode,
+        });
+    }
+    /**
+     * Validate a tool call against the rules.
+     *
+     * @param context - Tool call context
+     * @param rules - Applicable rules
+     * @returns Validation response
+     */
+    async validate(context, rules) {
+        const request = {
+            context,
+            rules,
+        };
+        const url = `${this.config.baseUrl}${this.config.endpoint}`;
+        this.logger.debug('Sending validation request', {
+            url,
+            toolName: context.tool_name,
+            callId: context.call_id,
+            ruleCount: rules.length,
+        });
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.retries; attempt++) {
+            try {
+                const response = await this.makeRequest(url, request);
+                this.logger.debug('Received validation response', {
+                    callId: context.call_id,
+                    decision: response.decision,
+                    shouldPassWeight: response.should_pass_weight,
+                    shouldBlockWeight: response.should_block_weight,
+                });
+                return response;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < this.config.retries) {
+                    this.logger.warn('Validation request failed, retrying', {
+                        attempt: attempt + 1,
+                        maxRetries: this.config.retries,
+                        error: lastError.message,
+                    });
+                    await this.delay(this.config.retryDelay);
+                }
+            }
+        }
+        // All retries exhausted
+        this.logger.error('Validation API request failed after all retries', {
+            url,
+            callId: context.call_id,
+            retries: this.config.retries,
+        }, lastError);
+        // Return based on fail mode
+        return this.getFailModeResponse(lastError?.message ?? 'API unavailable');
+    }
+    /**
+     * Check if the API is healthy.
+     *
+     * @returns True if the API is reachable
+     */
+    async healthCheck() {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(`${this.config.baseUrl}/health`, {
+                method: 'GET',
+                headers: this.buildHeaders(),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Make the actual HTTP request.
+     */
+    async makeRequest(url, request) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: this.buildHeaders(),
+                body: JSON.stringify(request),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const body = await response.text().catch(() => 'Unable to read response body');
+                throw new ValidationAPIError(`API returned status ${response.status}`, response.status, body);
+            }
+            const data = await response.json();
+            return this.parseResponse(data);
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof ValidationAPIError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new ValidationAPIError(`Request timed out after ${this.config.timeout}ms`);
+            }
+            throw new ValidationAPIError(`Request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Build request headers.
+     */
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.config.headers,
+        };
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+        }
+        return headers;
+    }
+    /**
+     * Parse and validate the API response.
+     */
+    parseResponse(data) {
+        if (!data || typeof data !== 'object') {
+            throw new ValidationAPIError('Invalid response format');
+        }
+        const response = data;
+        // Validate required fields
+        if (typeof response.should_pass_weight !== 'number') {
+            throw new ValidationAPIError('Missing or invalid should_pass_weight');
+        }
+        if (typeof response.should_block_weight !== 'number') {
+            throw new ValidationAPIError('Missing or invalid should_block_weight');
+        }
+        if (response.decision !== 'pass' && response.decision !== 'block') {
+            throw new ValidationAPIError('Missing or invalid decision (must be "pass" or "block")');
+        }
+        if (typeof response.reasoning !== 'string') {
+            throw new ValidationAPIError('Missing or invalid reasoning');
+        }
+        return {
+            should_pass_weight: response.should_pass_weight,
+            should_block_weight: response.should_block_weight,
+            decision: response.decision,
+            reasoning: response.reasoning,
+            matched_rules: response.matched_rules,
+            metadata: response.metadata,
+        };
+    }
+    /**
+     * Get a response based on fail mode when API is unavailable.
+     */
+    getFailModeResponse(reason) {
+        if (this.failMode === 'open') {
+            this.logger.warn('Failing open due to API error', { reason });
+            return {
+                should_pass_weight: 1.0,
+                should_block_weight: 0.0,
+                decision: 'pass',
+                reasoning: `API unavailable, failing open: ${reason}`,
+            };
+        }
+        else {
+            this.logger.warn('Failing closed due to API error', { reason });
+            return {
+                should_pass_weight: 0.0,
+                should_block_weight: 1.0,
+                decision: 'block',
+                reasoning: `API unavailable, failing closed: ${reason}`,
+            };
+        }
+    }
+    /**
+     * Resolve configuration with defaults.
+     */
+    resolveConfig(config) {
+        return {
+            baseUrl: config.baseUrl.replace(/\/$/, ''), // Remove trailing slash
+            endpoint: config.endpoint ?? '/tool/call/check',
+            timeout: config.timeout ?? 10000,
+            headers: config.headers ?? {},
+            apiKey: config.apiKey,
+            retries: config.retries ?? 2,
+            retryDelay: config.retryDelay ?? 1000,
+        };
+    }
+    /**
+     * Delay for the specified milliseconds.
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create a new validation API client.
+ *
+ * @param options - Client options
+ * @returns ValidationAPIClient instance
+ */
+export function createValidationAPIClient(options) {
+    return new ValidationAPIClient(options);
+}
+//# sourceMappingURL=api-client.js.map

package/dist/rules/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/rules/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuDH;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAAU;IACpB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,UAAmB,EAAE,YAAqB;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACb,MAAM,CAAoB;IAC1B,MAAM,CAAS;IACf,QAAQ,CAAoB;IAE7C,YAAY,OAAmC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YACpD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAwB,EACxB,KAAa;QAEb,MAAM,OAAO,GAAyB;YACpC,OAAO;YACP,KAAK;SACN,CAAC;QAEF,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAE5D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;YAC9C,GAAG;YACH,QAAQ,EAAE,OAAO,CAAC,SAAS;YAC3B,MAAM,EAAE,OAAO,CAAC,OAAO;YACvB,SAAS,EAAE,KAAK,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAEtD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;oBAChD,MAAM,EAAE,OAAO,CAAC,OAAO;oBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB;oBAC7C,iBAAiB,EAAE,QAAQ,CAAC,mBAAmB;iBAChD,CAAC,CAAC;gBAEH,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;wBACtD,OAAO,EAAE,OAAO,GAAG,CAAC;wBACpB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;wBAC/B,KAAK,EAAE,SAAS,CAAC,OAAO;qBACzB,CAAC,CAAC;oBACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,iDAAiD,EACjD;YACE,GAAG;YACH,MAAM,EAAE,OAAO,CAAC,OAAO;YACvB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC7B,EACD,SAAS,CACV,CAAC;QAEF,4BAA4B;QAC5B,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,IAAI,iBAAiB,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,SAAS,EAAE;gBAC5D,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;gBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,GAAW,EACX,OAA6B;QAE7B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,8BAA8B,CAAC,CAAC;gBAC/E,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,QAAQ,CAAC,MAAM,EAAE,EACxC,QAAQ,CAAC,MAAM,EACf,IAAI,CACL,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;YACnF,CAAC;YAED,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;SACvB,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,IAAa;QACjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,IAA+B,CAAC;QAEjD,2BAA2B;QAC3B,IAAI,OAAO,QAAQ,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,kBAAkB,CAAC,wCAAwC,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAClE,MAAM,IAAI,kBAAkB,CAAC,yDAAyD,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO;YACL,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;YAC/C,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;YACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,aAAa,EAAE,QAAQ,CAAC,aAAqC;YAC7D,QAAQ,EAAE,QAAQ,CAAC,QAA+C;SACnE,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAc;QACxC,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO;gBACL,kBAAkB,EAAE,GAAG;gBACvB,mBAAmB,EAAE,GAAG;gBACxB,QAAQ,EAAE,MAAM;gBAChB,SAAS,EAAE,kCAAkC,MAAM,EAAE;aACtD,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,OAAO;gBACL,kBAAkB,EAAE,GAAG;gBACvB,mBAAmB,EAAE,GAAG;gBACxB,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,oCAAoC,MAAM,EAAE;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,MAA2B;QAC/C,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,wBAAwB;YACpE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB;YAC/C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmC;IAEnC,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/rules/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Rules module exports.
+ *
+ * @module rules
+ */
+export * from './types.js';
+export * from './loader.js';
+export * from './api-client.js';
+export * from './rule-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/rules/index.js

@@ -0,0 +1,10 @@
+/**
+ * Rules module exports.
+ *
+ * @module rules
+ */
+export * from './types.js';
+export * from './loader.js';
+export * from './api-client.js';
+export * from './rule-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/rules/loader.d.ts

@@ -0,0 +1,116 @@
+/**
+ * YAML rule loader and parser.
+ *
+ * Loads rules from YAML files and builds an indexed structure for
+ * efficient rule lookup during validation.
+ *
+ * @module rules/loader
+ */
+import type { Logger } from '../utils/logger.js';
+import type { Rule, LoadedRules } from './types.js';
+/**
+ * Options for the rule loader.
+ */
+export interface RuleLoaderOptions {
+    /** Logger instance */
+    logger: Logger;
+    /** Whether to watch for file changes (future feature) */
+    watch?: boolean;
+}
+/**
+ * YAML parser function type.
+ * Users must provide their own YAML parser (e.g., js-yaml).
+ */
+export type YamlParser = (content: string) => unknown;
+/**
+ * Loads and manages YAML-based rules.
+ */
+export declare class RuleLoader {
+    private readonly logger;
+    private yamlParser;
+    private loadedRules;
+    constructor(options: RuleLoaderOptions);
+    /**
+     * Set the YAML parser to use for loading rules.
+     *
+     * @param parser - YAML parsing function
+     *
+     * @example
+     * ```typescript
+     * import yaml from 'js-yaml';
+     * loader.setYamlParser(yaml.load);
+     * ```
+     */
+    setYamlParser(parser: YamlParser): void;
+    /**
+     * Load rules from a directory containing YAML files.
+     *
+     * @param dirPath - Path to the directory
+     * @param recursive - Whether to search subdirectories
+     * @returns Loaded rules
+     */
+    loadFromDirectory(dirPath: string, recursive?: boolean): LoadedRules;
+    /**
+     * Load rules from a single YAML file.
+     *
+     * @param filePath - Path to the YAML file
+     */
+    loadFromFile(filePath: string): void;
+    /**
+     * Load rules from a YAML string.
+     *
+     * @param content - YAML content
+     * @param sourceName - Name to identify the source
+     */
+    loadFromString(content: string, sourceName?: string): void;
+    /**
+     * Add rules directly without YAML parsing.
+     *
+     * @param rules - Rules to add
+     * @param setName - Name for the rule set
+     */
+    addRules(rules: Rule[], setName?: string): void;
+    /**
+     * Get all loaded rules.
+     */
+    getRules(): LoadedRules;
+    /**
+     * Get rules applicable to a specific tool.
+     *
+     * @param toolName - Name of the tool
+     * @returns Rules that apply to the tool
+     */
+    getRulesForTool(toolName: string): Rule[];
+    /**
+     * Clear all loaded rules.
+     */
+    clear(): void;
+    /**
+     * Reload rules from previously loaded sources.
+     */
+    reload(): LoadedRules;
+    /**
+     * Find YAML files in a directory.
+     */
+    private findYamlFiles;
+    /**
+     * Parse a rule set from parsed YAML.
+     */
+    private parseRuleSet;
+    /**
+     * Parse a single rule from YAML data.
+     */
+    private parseRule;
+    /**
+     * Build the rule index for efficient lookup.
+     */
+    private buildIndex;
+}
+/**
+ * Create a new rule loader.
+ *
+ * @param options - Loader options
+ * @returns RuleLoader instance
+ */
+export declare function createRuleLoader(options: RuleLoaderOptions): RuleLoader;
+//# sourceMappingURL=loader.d.ts.map

package/dist/rules/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/rules/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAW,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAYtD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,WAAW,CAMjB;gBAEU,OAAO,EAAE,iBAAiB;IAItC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKvC;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,WAAW;IA2BjE;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuBpC;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAW,GAAG,IAAI;IAkB5D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,SAAiB,GAAG,IAAI;IAcvD;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAOzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,MAAM,IAAI,WAAW;IAerB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsCpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;IACH,OAAO,CAAC,UAAU;CA6BnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}