veto-sdk 1.0.0

package/dist/utils/glob.js

@@ -0,0 +1,147 @@
+/**
+ * Simple glob utility for matching files.
+ *
+ * @module utils/glob
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/**
+ * Simple glob pattern matching.
+ * Supports:
+ * - ** for recursive directory matching
+ * - * for wildcard matching in filenames
+ *
+ * @param pattern - Glob pattern (e.g., "data/**\/*.jsonl")
+ * @param cwd - Working directory (defaults to process.cwd())
+ * @returns Array of matching file paths
+ */
+export async function glob(pattern, cwd = process.cwd()) {
+    const absolutePattern = resolve(cwd, pattern);
+    const parts = absolutePattern.split(/[\\/]/);
+    // Find the first part with wildcards
+    let baseIndex = 0;
+    for (let i = 0; i < parts.length; i++) {
+        if (parts[i].includes('*')) {
+            baseIndex = i;
+            break;
+        }
+        baseIndex = i + 1;
+    }
+    const basePath = parts.slice(0, baseIndex).join('/') || '/';
+    const patternParts = parts.slice(baseIndex);
+    if (patternParts.length === 0) {
+        // No wildcards, return the path if it exists
+        try {
+            statSync(absolutePattern);
+            return [absolutePattern];
+        }
+        catch {
+            return [];
+        }
+    }
+    return matchPattern(basePath, patternParts);
+}
+/**
+ * Recursively match pattern parts against directory structure.
+ */
+function matchPattern(currentPath, patternParts) {
+    if (patternParts.length === 0) {
+        return [currentPath];
+    }
+    const [currentPattern, ...remainingParts] = patternParts;
+    const results = [];
+    try {
+        const stat = statSync(currentPath);
+        if (!stat.isDirectory()) {
+            return [];
+        }
+    }
+    catch {
+        return [];
+    }
+    const entries = readdirSync(currentPath);
+    if (currentPattern === '**') {
+        // Match current directory and all subdirectories
+        // First, try matching remaining pattern in current directory
+        results.push(...matchPattern(currentPath, remainingParts));
+        // Then recurse into subdirectories
+        for (const entry of entries) {
+            const entryPath = join(currentPath, entry);
+            try {
+                const stat = statSync(entryPath);
+                if (stat.isDirectory()) {
+                    // Continue with ** pattern in subdirectory
+                    results.push(...matchPattern(entryPath, patternParts));
+                }
+            }
+            catch {
+                // Skip inaccessible entries
+            }
+        }
+    }
+    else {
+        // Match current pattern
+        const regex = patternToRegex(currentPattern);
+        for (const entry of entries) {
+            if (regex.test(entry)) {
+                const entryPath = join(currentPath, entry);
+                if (remainingParts.length === 0) {
+                    // This is the last pattern part
+                    results.push(entryPath);
+                }
+                else {
+                    // Continue matching remaining parts
+                    try {
+                        const stat = statSync(entryPath);
+                        if (stat.isDirectory()) {
+                            results.push(...matchPattern(entryPath, remainingParts));
+                        }
+                    }
+                    catch {
+                        // Skip inaccessible entries
+                    }
+                }
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Convert glob pattern to regex.
+ */
+function patternToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Synchronous version of glob.
+ */
+export function globSync(pattern, cwd = process.cwd()) {
+    // The async version is actually sync, just return directly
+    const absolutePattern = resolve(cwd, pattern);
+    const parts = absolutePattern.split(/[\\/]/);
+    let baseIndex = 0;
+    for (let i = 0; i < parts.length; i++) {
+        if (parts[i].includes('*')) {
+            baseIndex = i;
+            break;
+        }
+        baseIndex = i + 1;
+    }
+    const basePath = parts.slice(0, baseIndex).join('/') || '/';
+    const patternParts = parts.slice(baseIndex);
+    if (patternParts.length === 0) {
+        try {
+            statSync(absolutePattern);
+            return [absolutePattern];
+        }
+        catch {
+            return [];
+        }
+    }
+    return matchPattern(basePath, patternParts);
+}
+//# sourceMappingURL=glob.js.map

package/dist/utils/glob.js.map

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

package/dist/utils/id.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ID generation utilities for Veto.
+ *
+ * @module utils/id
+ */
+/**
+ * Generate a random ID for tool calls.
+ *
+ * Creates a unique identifier suitable for tracking tool call instances.
+ * Uses crypto.randomUUID when available, falls back to a custom implementation.
+ *
+ * @param prefix - Optional prefix for the ID
+ * @returns A unique string ID
+ *
+ * @example
+ * ```typescript
+ * const callId = generateId('call');
+ * // Returns something like: 'call_a1b2c3d4e5f6'
+ * ```
+ */
+export declare function generateId(prefix?: string): string;
+/**
+ * Generate a tool call ID in the format expected by providers.
+ *
+ * @returns A unique tool call ID
+ */
+export declare function generateToolCallId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,GAAG,MAAM,CAclD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/utils/id.js

@@ -0,0 +1,43 @@
+/**
+ * ID generation utilities for Veto.
+ *
+ * @module utils/id
+ */
+/**
+ * Generate a random ID for tool calls.
+ *
+ * Creates a unique identifier suitable for tracking tool call instances.
+ * Uses crypto.randomUUID when available, falls back to a custom implementation.
+ *
+ * @param prefix - Optional prefix for the ID
+ * @returns A unique string ID
+ *
+ * @example
+ * ```typescript
+ * const callId = generateId('call');
+ * // Returns something like: 'call_a1b2c3d4e5f6'
+ * ```
+ */
+export function generateId(prefix = 'veto') {
+    // Use crypto.randomUUID if available (Node 19+, modern browsers)
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        const uuid = crypto.randomUUID();
+        return `${prefix}_${uuid.replace(/-/g, '').slice(0, 12)}`;
+    }
+    // Fallback for older environments
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let id = '';
+    for (let i = 0; i < 12; i++) {
+        id += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return `${prefix}_${id}`;
+}
+/**
+ * Generate a tool call ID in the format expected by providers.
+ *
+ * @returns A unique tool call ID
+ */
+export function generateToolCallId() {
+    return generateId('call');
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAM,GAAG,MAAM;IACxC,iEAAiE;IACjE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,kCAAkC;IAClC,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utility exports for Veto.
+ *
+ * @module utils
+ */
+export * from './logger.js';
+export * from './id.js';
+export * from './glob.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * Utility exports for Veto.
+ *
+ * @module utils
+ */
+export * from './logger.js';
+export * from './id.js';
+export * from './glob.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Logging infrastructure for Veto.
+ *
+ * Provides a flexible logging system with configurable log levels
+ * and support for custom logger implementations.
+ *
+ * @module utils/logger
+ */
+import type { LogLevel } from '../types/config.js';
+/**
+ * Log entry structure for structured logging.
+ */
+export interface LogEntry {
+    /** Log level of this entry */
+    level: LogLevel;
+    /** Log message */
+    message: string;
+    /** Timestamp of the log entry */
+    timestamp: Date;
+    /** Additional context data */
+    context?: Record<string, unknown>;
+    /** Error object if applicable */
+    error?: Error;
+}
+/**
+ * Logger interface that can be implemented for custom logging.
+ *
+ * @example
+ * ```typescript
+ * const customLogger: Logger = {
+ *   debug: (msg, ctx) => myLoggingService.log('debug', msg, ctx),
+ *   info: (msg, ctx) => myLoggingService.log('info', msg, ctx),
+ *   warn: (msg, ctx) => myLoggingService.log('warn', msg, ctx),
+ *   error: (msg, ctx, err) => myLoggingService.log('error', msg, { ...ctx, err }),
+ * };
+ * ```
+ */
+export interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>, error?: Error): void;
+}
+/**
+ * Create a console-based logger with the specified log level.
+ *
+ * @param level - Minimum log level to emit
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('info');
+ * logger.debug('This will not be logged');
+ * logger.info('This will be logged');
+ * ```
+ */
+export declare function createLogger(level: LogLevel): Logger;
+/**
+ * A no-op logger that discards all messages.
+ * Useful for testing or when logging should be completely disabled.
+ */
+export declare const silentLogger: Logger;
+/**
+ * Create a logger that stores entries in memory.
+ * Useful for testing or capturing logs for later analysis.
+ *
+ * @param level - Minimum log level to capture
+ * @returns Object containing the logger and captured entries
+ *
+ * @example
+ * ```typescript
+ * const { logger, entries } = createMemoryLogger('debug');
+ * logger.info('test message', { key: 'value' });
+ * console.log(entries); // [{ level: 'info', message: 'test message', ... }]
+ * ```
+ */
+export declare function createMemoryLogger(level?: LogLevel): {
+    logger: Logger;
+    entries: LogEntry[];
+    clear: () => void;
+};
+/**
+ * Create a child logger with additional default context.
+ *
+ * @param parent - Parent logger to wrap
+ * @param defaultContext - Context to include in all log entries
+ * @returns Logger with merged context
+ *
+ * @example
+ * ```typescript
+ * const parentLogger = createLogger('info');
+ * const childLogger = createChildLogger(parentLogger, { component: 'validator' });
+ * childLogger.info('Validation complete'); // Includes { component: 'validator' }
+ * ```
+ */
+export declare function createChildLogger(parent: Logger, defaultContext: Record<string, unknown>): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iCAAiC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAChF;AAwCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAiCpD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAK1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,QAAkB,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAiCA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,CAcR"}

package/dist/utils/logger.js

@@ -0,0 +1,153 @@
+/**
+ * Logging infrastructure for Veto.
+ *
+ * Provides a flexible logging system with configurable log levels
+ * and support for custom logger implementations.
+ *
+ * @module utils/logger
+ */
+/**
+ * Numeric priority for log levels (lower = more verbose).
+ */
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/**
+ * Check if a log level should be emitted given the configured level.
+ */
+function shouldLog(messageLevel, configuredLevel) {
+    return LOG_LEVEL_PRIORITY[messageLevel] >= LOG_LEVEL_PRIORITY[configuredLevel];
+}
+/**
+ * Format a log message with optional context.
+ */
+function formatMessage(level, message, context) {
+    const timestamp = new Date().toISOString();
+    const levelStr = level.toUpperCase().padEnd(5);
+    const prefix = `[${timestamp}] [VETO] ${levelStr}`;
+    if (context && Object.keys(context).length > 0) {
+        const contextStr = JSON.stringify(context);
+        return `${prefix} ${message} ${contextStr}`;
+    }
+    return `${prefix} ${message}`;
+}
+/**
+ * Create a console-based logger with the specified log level.
+ *
+ * @param level - Minimum log level to emit
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('info');
+ * logger.debug('This will not be logged');
+ * logger.info('This will be logged');
+ * ```
+ */
+export function createLogger(level) {
+    return {
+        debug(message, context) {
+            if (shouldLog('debug', level)) {
+                console.debug(formatMessage('debug', message, context));
+            }
+        },
+        info(message, context) {
+            if (shouldLog('info', level)) {
+                console.info(formatMessage('info', message, context));
+            }
+        },
+        warn(message, context) {
+            if (shouldLog('warn', level)) {
+                console.warn(formatMessage('warn', message, context));
+            }
+        },
+        error(message, context, error) {
+            if (shouldLog('error', level)) {
+                console.error(formatMessage('error', message, context));
+                if (error) {
+                    console.error(error);
+                }
+            }
+        },
+    };
+}
+/**
+ * A no-op logger that discards all messages.
+ * Useful for testing or when logging should be completely disabled.
+ */
+export const silentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Create a logger that stores entries in memory.
+ * Useful for testing or capturing logs for later analysis.
+ *
+ * @param level - Minimum log level to capture
+ * @returns Object containing the logger and captured entries
+ *
+ * @example
+ * ```typescript
+ * const { logger, entries } = createMemoryLogger('debug');
+ * logger.info('test message', { key: 'value' });
+ * console.log(entries); // [{ level: 'info', message: 'test message', ... }]
+ * ```
+ */
+export function createMemoryLogger(level = 'debug') {
+    const entries = [];
+    const addEntry = (messageLevel, message, context, error) => {
+        if (shouldLog(messageLevel, level)) {
+            entries.push({
+                level: messageLevel,
+                message,
+                timestamp: new Date(),
+                context,
+                error,
+            });
+        }
+    };
+    return {
+        entries,
+        clear: () => {
+            entries.length = 0;
+        },
+        logger: {
+            debug: (message, context) => addEntry('debug', message, context),
+            info: (message, context) => addEntry('info', message, context),
+            warn: (message, context) => addEntry('warn', message, context),
+            error: (message, context, error) => addEntry('error', message, context, error),
+        },
+    };
+}
+/**
+ * Create a child logger with additional default context.
+ *
+ * @param parent - Parent logger to wrap
+ * @param defaultContext - Context to include in all log entries
+ * @returns Logger with merged context
+ *
+ * @example
+ * ```typescript
+ * const parentLogger = createLogger('info');
+ * const childLogger = createChildLogger(parentLogger, { component: 'validator' });
+ * childLogger.info('Validation complete'); // Includes { component: 'validator' }
+ * ```
+ */
+export function createChildLogger(parent, defaultContext) {
+    const mergeContext = (context) => {
+        return { ...defaultContext, ...context };
+    };
+    return {
+        debug: (message, context) => parent.debug(message, mergeContext(context)),
+        info: (message, context) => parent.info(message, mergeContext(context)),
+        warn: (message, context) => parent.warn(message, mergeContext(context)),
+        error: (message, context, error) => parent.error(message, mergeContext(context), error),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "veto-sdk",
+  "version": "1.0.0",
+  "description": "Guardrails for AI agent tool calls - intercept, validate, and control",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "benchmark": "node dist/benchmark/cli.js",
+    "benchmark:dev": "tsx src/benchmark/cli.ts"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "guardrail",
+    "tool-calls",
+    "safety",
+    "llm",
+    "openai",
+    "anthropic",
+    "gemini",
+    "claude",
+    "veto"
+  ],
+  "author": "Plaw, Inc.",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "openai": "^4.77.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "openai": "^4.0.0",
+    "zod": "^3.22.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./providers/*": {
+      "types": "./dist/providers/*.d.ts",
+      "import": "./dist/providers/*.js"
+    },
+    "./rules": {
+      "types": "./dist/rules/index.d.ts",
+      "import": "./dist/rules/index.js"
+    },
+    "./kernel": {
+      "types": "./dist/kernel/index.d.ts",
+      "import": "./dist/kernel/index.js"
+    }
+  },
+  "dependencies": {
+    "yaml": "^2.8.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VulnZap/veto",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://veto.run",
+  "bugs": {
+    "url": "https://github.com/VulnZap/veto/issues"
+  }
+}