@mondaydotcomorg/atp-providers 0.17.16 → 0.18.4-rc.0

package/dist/audit/otel-metrics.js

@@ -0,0 +1,115 @@
+/**
+ * OpenTelemetry Metrics Definitions
+
+/**
+ * Counter metric names
+ */
+export var OTelCounter;
+(function (OTelCounter) {
+    OTelCounter["EXECUTIONS_TOTAL"] = "atp.executions.total";
+    OTelCounter["TOOLS_CALLS"] = "atp.tools.calls";
+    OTelCounter["LLM_CALLS"] = "atp.llm.calls";
+    OTelCounter["APPROVALS_TOTAL"] = "atp.approvals.total";
+    OTelCounter["SECURITY_EVENTS"] = "atp.security.events";
+})(OTelCounter || (OTelCounter = {}));
+/**
+ * Histogram metric names
+ */
+export var OTelHistogram;
+(function (OTelHistogram) {
+    OTelHistogram["EXECUTION_DURATION"] = "atp.execution.duration";
+    OTelHistogram["TOOL_DURATION"] = "atp.tool.duration";
+})(OTelHistogram || (OTelHistogram = {}));
+/**
+ * Span/trace names
+ */
+export var OTelSpan;
+(function (OTelSpan) {
+    OTelSpan["EXECUTION_START"] = "atp.execution.start";
+    OTelSpan["EXECUTION_COMPLETE"] = "atp.execution.complete";
+    OTelSpan["EXECUTION_PAUSE"] = "atp.execution.pause";
+    OTelSpan["EXECUTION_RESUME"] = "atp.execution.resume";
+    OTelSpan["EXECUTION_ERROR"] = "atp.execution.error";
+    OTelSpan["TOOL_CALL"] = "atp.tool_call";
+    OTelSpan["LLM_CALL"] = "atp.llm_call";
+    OTelSpan["APPROVAL_REQUEST"] = "atp.approval.request";
+    OTelSpan["APPROVAL_RESPONSE"] = "atp.approval.response";
+    OTelSpan["CLIENT_INIT"] = "atp.client_init";
+    OTelSpan["ERROR"] = "atp.error";
+})(OTelSpan || (OTelSpan = {}));
+/**
+ * Attribute names (for consistent span/metric attributes)
+ */
+export var OTelAttribute;
+(function (OTelAttribute) {
+    OTelAttribute["EVENT_ID"] = "atp.event.id";
+    OTelAttribute["EVENT_TYPE"] = "atp.event.type";
+    OTelAttribute["EVENT_ACTION"] = "atp.event.action";
+    OTelAttribute["TIMESTAMP"] = "atp.timestamp";
+    OTelAttribute["CLIENT_ID"] = "atp.client.id";
+    OTelAttribute["USER_ID"] = "atp.user.id";
+    OTelAttribute["IP_ADDRESS"] = "atp.ip_address";
+    OTelAttribute["USER_AGENT"] = "atp.user_agent";
+    OTelAttribute["STATUS"] = "atp.status";
+    OTelAttribute["RESOURCE"] = "atp.resource";
+    OTelAttribute["RESOURCE_ID"] = "atp.resource.id";
+    OTelAttribute["TOOL_NAME"] = "atp.tool.name";
+    OTelAttribute["TOOL_INPUT_SIZE"] = "tool.input_size";
+    OTelAttribute["TOOL_OUTPUT_SIZE"] = "tool.output_size";
+    OTelAttribute["API_GROUP"] = "atp.api.group";
+    OTelAttribute["DURATION_MS"] = "atp.duration_ms";
+    OTelAttribute["MEMORY_BYTES"] = "atp.memory_bytes";
+    OTelAttribute["LLM_CALLS"] = "atp.llm_calls";
+    OTelAttribute["HTTP_CALLS"] = "atp.http_calls";
+    OTelAttribute["RISK_SCORE"] = "atp.security.risk_score";
+    OTelAttribute["SECURITY_EVENTS"] = "atp.security.events";
+    OTelAttribute["SECURITY_EVENTS_COUNT"] = "atp.security.events_count";
+    OTelAttribute["ERROR_MESSAGE"] = "atp.error.message";
+    OTelAttribute["ERROR_CODE"] = "atp.error.code";
+    OTelAttribute["ERROR_STACK"] = "atp.error.stack";
+})(OTelAttribute || (OTelAttribute = {}));
+/**
+ * Metric configurations
+ */
+export const METRIC_CONFIGS = {
+    [OTelCounter.EXECUTIONS_TOTAL]: {
+        description: 'Total number of executions',
+        unit: '1',
+    },
+    [OTelCounter.TOOLS_CALLS]: {
+        description: 'Tool call count',
+        unit: '1',
+    },
+    [OTelCounter.LLM_CALLS]: {
+        description: 'LLM call count',
+        unit: '1',
+    },
+    [OTelCounter.APPROVALS_TOTAL]: {
+        description: 'Approval request count',
+        unit: '1',
+    },
+    [OTelCounter.SECURITY_EVENTS]: {
+        description: 'Security events count',
+        unit: '1',
+    },
+    [OTelHistogram.EXECUTION_DURATION]: {
+        description: 'Execution duration in milliseconds',
+        unit: 'ms',
+    },
+    [OTelHistogram.TOOL_DURATION]: {
+        description: 'Tool execution duration',
+        unit: 'ms',
+    },
+};
+/**
+ * OpenTelemetry tracer and meter names
+ */
+export const OTEL_SERVICE_NAME = 'agent-tool-protocol';
+export const OTEL_TRACER_NAME = 'agent-tool-protocol';
+export const OTEL_METER_NAME = 'agent-tool-protocol';
+/**
+ * Attribute prefixes for custom metadata
+ */
+export const ATTRIBUTE_PREFIX_TOOL = 'atp.tool';
+export const ATTRIBUTE_PREFIX_METADATA = 'atp.metadata';
+//# sourceMappingURL=otel-metrics.js.map

package/dist/audit/otel-metrics.js.map

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

package/dist/auth/env.d.ts

@@ -0,0 +1,21 @@
+import type { AuthProvider } from '@mondaydotcomorg/atp-protocol';
+/**
+ * Environment variable based auth provider
+ * Simple provider that reads credentials from process.env
+ * Good for development and simple deployments
+ */
+export declare class EnvAuthProvider implements AuthProvider {
+    name: string;
+    private prefix;
+    private credentials;
+    constructor(options?: {
+        prefix?: string;
+        credentials?: Record<string, string>;
+    });
+    getCredential(key: string): Promise<string | null>;
+    setCredential(key: string, value: string, _ttl?: number): Promise<void>;
+    deleteCredential(key: string): Promise<void>;
+    listCredentials(): Promise<string[]>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/auth/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/auth/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACnD,IAAI,SAAS;IACb,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAsB;gBAGxC,OAAO,GAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;IAYD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASlD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}

package/dist/auth/env.js

@@ -0,0 +1,48 @@
+/**
+ * Environment variable based auth provider
+ * Simple provider that reads credentials from process.env
+ * Good for development and simple deployments
+ */
+export class EnvAuthProvider {
+    name = 'env';
+    prefix;
+    credentials;
+    constructor(options = {}) {
+        this.prefix = options.prefix || 'ATP_';
+        this.credentials = new Map();
+        if (options.credentials) {
+            for (const [key, value] of Object.entries(options.credentials)) {
+                this.credentials.set(key, value);
+            }
+        }
+    }
+    async getCredential(key) {
+        if (this.credentials.has(key)) {
+            return this.credentials.get(key) || null;
+        }
+        const envValue = process.env[key] || process.env[`${this.prefix}${key}`];
+        return envValue || null;
+    }
+    async setCredential(key, value, _ttl) {
+        this.credentials.set(key, value);
+    }
+    async deleteCredential(key) {
+        this.credentials.delete(key);
+    }
+    async listCredentials() {
+        const keys = new Set();
+        for (const key of this.credentials.keys()) {
+            keys.add(key);
+        }
+        for (const key of Object.keys(process.env)) {
+            if (key.startsWith(this.prefix)) {
+                keys.add(key.substring(this.prefix.length));
+            }
+        }
+        return Array.from(keys);
+    }
+    async disconnect() {
+        this.credentials.clear();
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/auth/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/auth/env.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAC3B,IAAI,GAAG,KAAK,CAAC;IACL,MAAM,CAAS;IACf,WAAW,CAAsB;IAEzC,YACC,UAGI,EAAE;QAEN,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAE7B,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;QACF,CAAC;IACF,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC1C,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;QACzE,OAAO,QAAQ,IAAI,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,KAAa,EAAE,IAAa;QAC5D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAAW;QACjC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,eAAe;QACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACD"}

package/dist/cache/file.d.ts

@@ -0,0 +1,47 @@
+import type { CacheProvider } from '@mondaydotcomorg/atp-protocol';
+export interface FileCacheOptions {
+    cacheDir?: string;
+    maxKeys?: number;
+    defaultTTL?: number;
+    cleanupInterval?: number;
+}
+/**
+ * File-based cache provider for persistent local caching
+ * Good for single-server deployments that need persistence across restarts
+ * Supports cross-pod scenarios when using a shared filesystem (NFS, EFS, etc.)
+ */
+export declare class FileCache implements CacheProvider {
+    name: string;
+    private cacheDir;
+    private maxKeys;
+    private defaultTTL;
+    private cleanupInterval;
+    private cleanupTimer?;
+    private initPromise?;
+    constructor(options?: FileCacheOptions);
+    private initialize;
+    private ensureInitialized;
+    private getFilePath;
+    private startCleanup;
+    private cleanExpired;
+    private enforceMaxKeys;
+    get<T>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    clear(pattern?: string): Promise<void>;
+    mget(keys: string[]): Promise<Array<unknown | null>>;
+    mset(entries: Array<[string, unknown, number?]>): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Get cache statistics */
+    getStats(): Promise<{
+        keys: number;
+        maxKeys: number;
+        utilization: number;
+        sizeBytes: number;
+        cacheDir: string;
+    }>;
+    /** Manually trigger cleanup of expired entries */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/cache/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/cache/file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAUnE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,SAAU,YAAW,aAAa;IAC9C,IAAI,SAAU;IACd,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,WAAW,CAAC,CAAgB;gBAExB,OAAO,GAAE,gBAAqB;YAU5B,UAAU;YAaV,iBAAiB;IAM/B,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;YAeN,YAAY;YAqCZ,cAAc;IAmCtB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA0BtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CtC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAIpD,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,2BAA2B;IACrB,QAAQ;;;;;;;IAqCd,kDAAkD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}

package/dist/cache/file.js

@@ -0,0 +1,262 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+/**
+ * File-based cache provider for persistent local caching
+ * Good for single-server deployments that need persistence across restarts
+ * Supports cross-pod scenarios when using a shared filesystem (NFS, EFS, etc.)
+ */
+export class FileCache {
+    name = 'file';
+    cacheDir;
+    maxKeys;
+    defaultTTL;
+    cleanupInterval;
+    cleanupTimer;
+    initPromise;
+    constructor(options = {}) {
+        this.cacheDir = options.cacheDir || path.join(os.tmpdir(), 'atp-cache');
+        this.maxKeys = options.maxKeys || 1000;
+        this.defaultTTL = options.defaultTTL || 3600;
+        this.cleanupInterval = options.cleanupInterval || 300; // 5 minutes
+        // Initialize asynchronously
+        this.initPromise = this.initialize();
+    }
+    async initialize() {
+        try {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+            // Start periodic cleanup
+            this.startCleanup();
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to initialize cache directory:', error instanceof Error ? error.message : error);
+        }
+    }
+    async ensureInitialized() {
+        if (this.initPromise) {
+            await this.initPromise;
+        }
+    }
+    getFilePath(key) {
+        // Sanitize key to be filesystem-safe
+        const sanitizedKey = key.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return path.join(this.cacheDir, `${sanitizedKey}.json`);
+    }
+    startCleanup() {
+        if (this.cleanupInterval > 0) {
+            this.cleanupTimer = setInterval(() => {
+                this.cleanExpired().catch((error) => {
+                    console.error('[FileCache] Cleanup error:', error);
+                });
+            }, this.cleanupInterval * 1000);
+            // Don't prevent process exit
+            if (this.cleanupTimer.unref) {
+                this.cleanupTimer.unref();
+            }
+        }
+    }
+    async cleanExpired() {
+        try {
+            await this.ensureInitialized();
+            const files = await fs.readdir(this.cacheDir);
+            const now = Date.now();
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const filePath = path.join(this.cacheDir, file);
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const entry = JSON.parse(content);
+                    if (entry.expiresAt !== -1 && now > entry.expiresAt) {
+                        await fs.unlink(filePath);
+                    }
+                }
+                catch {
+                    // If we can't read or parse a file, delete it
+                    try {
+                        await fs.unlink(filePath);
+                    }
+                    catch {
+                        // Ignore deletion errors
+                    }
+                }
+            }
+            // Enforce max keys limit
+            await this.enforceMaxKeys();
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to clean expired entries:', error instanceof Error ? error.message : error);
+        }
+    }
+    async enforceMaxKeys() {
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json'));
+            if (jsonFiles.length > this.maxKeys) {
+                // Sort by modification time and remove oldest
+                const fileStats = await Promise.all(jsonFiles.map(async (file) => {
+                    const filePath = path.join(this.cacheDir, file);
+                    const stats = await fs.stat(filePath);
+                    return { file, mtime: stats.mtime.getTime() };
+                }));
+                fileStats.sort((a, b) => a.mtime - b.mtime);
+                const toDelete = fileStats.slice(0, jsonFiles.length - this.maxKeys);
+                await Promise.all(toDelete.map((item) => {
+                    const filePath = path.join(this.cacheDir, item.file);
+                    return fs.unlink(filePath).catch(() => {
+                        // Ignore errors
+                    });
+                }));
+            }
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to enforce max keys:', error instanceof Error ? error.message : error);
+        }
+    }
+    async get(key) {
+        try {
+            await this.ensureInitialized();
+            const filePath = this.getFilePath(key);
+            const content = await fs.readFile(filePath, 'utf-8');
+            const entry = JSON.parse(content);
+            if (entry.expiresAt !== -1 && Date.now() > entry.expiresAt) {
+                await this.delete(key);
+                return null;
+            }
+            return entry.value;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            console.error('[FileCache] Failed to get key:', key, error instanceof Error ? error.message : error);
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            await this.ensureInitialized();
+            await this.enforceMaxKeys();
+            const expiresAt = ttl
+                ? Date.now() + ttl * 1000
+                : this.defaultTTL > 0
+                    ? Date.now() + this.defaultTTL * 1000
+                    : -1;
+            const entry = { value, expiresAt };
+            const filePath = this.getFilePath(key);
+            await fs.writeFile(filePath, JSON.stringify(entry), 'utf-8');
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to set key:', key, error instanceof Error ? error.message : error);
+        }
+    }
+    async delete(key) {
+        try {
+            await this.ensureInitialized();
+            const filePath = this.getFilePath(key);
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                console.error('[FileCache] Failed to delete key:', key, error instanceof Error ? error.message : error);
+            }
+        }
+    }
+    async has(key) {
+        const value = await this.get(key);
+        return value !== null;
+    }
+    async clear(pattern) {
+        try {
+            await this.ensureInitialized();
+            const files = await fs.readdir(this.cacheDir);
+            if (!pattern) {
+                // Clear all cache files
+                await Promise.all(files
+                    .filter((f) => f.endsWith('.json'))
+                    .map((file) => {
+                    const filePath = path.join(this.cacheDir, file);
+                    return fs.unlink(filePath).catch(() => {
+                        // Ignore errors
+                    });
+                }));
+                return;
+            }
+            // Convert glob pattern to regex
+            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+            // Read all files and check if they match the pattern
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                // Extract original key from filename (reverse sanitization is approximate)
+                const keyBase = file.replace('.json', '');
+                // We need to read the file to get the original key
+                // For now, use a simple pattern match on the sanitized filename
+                if (regex.test(keyBase)) {
+                    const filePath = path.join(this.cacheDir, file);
+                    await fs.unlink(filePath).catch(() => {
+                        // Ignore errors
+                    });
+                }
+            }
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to clear cache:', error instanceof Error ? error.message : error);
+        }
+    }
+    async mget(keys) {
+        return Promise.all(keys.map((key) => this.get(key)));
+    }
+    async mset(entries) {
+        await Promise.all(entries.map(([key, value, ttl]) => this.set(key, value, ttl)));
+    }
+    async disconnect() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        // Don't delete cache files on disconnect - they should persist
+    }
+    /** Get cache statistics */
+    async getStats() {
+        try {
+            await this.ensureInitialized();
+            const files = await fs.readdir(this.cacheDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json'));
+            // Calculate total size
+            let totalSize = 0;
+            for (const file of jsonFiles) {
+                const filePath = path.join(this.cacheDir, file);
+                try {
+                    const stats = await fs.stat(filePath);
+                    totalSize += stats.size;
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+            return {
+                keys: jsonFiles.length,
+                maxKeys: this.maxKeys,
+                utilization: (jsonFiles.length / this.maxKeys) * 100,
+                sizeBytes: totalSize,
+                cacheDir: this.cacheDir,
+            };
+        }
+        catch (error) {
+            console.error('[FileCache] Failed to get stats:', error);
+            return {
+                keys: 0,
+                maxKeys: this.maxKeys,
+                utilization: 0,
+                sizeBytes: 0,
+                cacheDir: this.cacheDir,
+            };
+        }
+    }
+    /** Manually trigger cleanup of expired entries */
+    async cleanup() {
+        await this.cleanExpired();
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/cache/file.js.map

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

package/dist/cache/memory.d.ts

@@ -0,0 +1,30 @@
+import type { CacheProvider } from '@mondaydotcomorg/atp-protocol';
+/**
+ * In-memory cache provider with LRU eviction
+ * Good for development and single-server deployments
+ */
+export declare class MemoryCache implements CacheProvider {
+    name: string;
+    private cache;
+    private maxKeys;
+    private defaultTTL;
+    constructor(options?: {
+        maxKeys?: number;
+        defaultTTL?: number;
+    });
+    get<T>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    clear(pattern?: string): Promise<void>;
+    mget(keys: string[]): Promise<Array<unknown | null>>;
+    mset(entries: Array<[string, unknown, number?]>): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Get cache statistics */
+    getStats(): {
+        keys: number;
+        maxKeys: number;
+        utilization: number;
+    };
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAOnE;;;GAGG;AACH,qBAAa,WAAY,YAAW,aAAa;IAChD,IAAI,SAAY;IAChB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAM7D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkBtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAIpD,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,2BAA2B;IAC3B,QAAQ;;;;;CAOR"}

package/dist/cache/memory.js

@@ -0,0 +1,81 @@
+/**
+ * In-memory cache provider with LRU eviction
+ * Good for development and single-server deployments
+ */
+export class MemoryCache {
+    name = 'memory';
+    cache;
+    maxKeys;
+    defaultTTL;
+    constructor(options = {}) {
+        this.cache = new Map();
+        this.maxKeys = options.maxKeys || 1000;
+        this.defaultTTL = options.defaultTTL || 3600;
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (entry.expiresAt !== -1 && Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    async set(key, value, ttl) {
+        if (this.cache.size >= this.maxKeys && !this.cache.has(key)) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        const expiresAt = ttl
+            ? Date.now() + ttl * 1000
+            : this.defaultTTL > 0
+                ? Date.now() + this.defaultTTL * 1000
+                : -1;
+        this.cache.set(key, { value, expiresAt });
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async has(key) {
+        const value = await this.get(key);
+        return value !== null;
+    }
+    async clear(pattern) {
+        if (!pattern) {
+            this.cache.clear();
+            return;
+        }
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        for (const key of this.cache.keys()) {
+            if (regex.test(key)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    async mget(keys) {
+        return Promise.all(keys.map((key) => this.get(key)));
+    }
+    async mset(entries) {
+        for (const [key, value, ttl] of entries) {
+            await this.set(key, value, ttl);
+        }
+    }
+    async disconnect() {
+        this.cache.clear();
+    }
+    /** Get cache statistics */
+    getStats() {
+        return {
+            keys: this.cache.size,
+            maxKeys: this.maxKeys,
+            utilization: (this.cache.size / this.maxKeys) * 100,
+        };
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/cache/memory.js.map

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