@squadrules/mcp 4.8.6

package/dist/services/qdrant/undici-compat.js

@@ -0,0 +1,23 @@
+let patched = false;
+/**
+ * Qdrant client currently injects `dispatcher` into fetch init.
+ * On Node 25+, that dispatcher from qdrant's undici v6 is not compatible
+ * with the runtime fetch internals and causes `InvalidArgumentError: invalid onError method`.
+ * Strip only that field and preserve all other init options.
+ */
+export function installQdrantFetchCompatibility() {
+    if (patched)
+        return;
+    if (typeof globalThis.fetch !== 'function')
+        return;
+    const nativeFetch = globalThis.fetch.bind(globalThis);
+    globalThis.fetch = ((input, init) => {
+        if (init && typeof init === 'object' && 'dispatcher' in init) {
+            const { dispatcher: _dispatcher, ...rest } = init;
+            return nativeFetch(input, rest);
+        }
+        return nativeFetch(input, init);
+    });
+    patched = true;
+}
+//# sourceMappingURL=undici-compat.js.map

package/dist/services/qdrant/undici-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undici-compat.js","sourceRoot":"","sources":["../../../src/services/qdrant/undici-compat.ts"],"names":[],"mappings":"AAAA,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B;IAC7C,IAAI,OAAO;QAAE,OAAO;IACpB,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO;IAEnD,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,KAAkC,EAAE,IAAkC,EAAE,EAAE;QAC7F,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YAC7D,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,IAA8C,CAAC;YAC5F,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC,CAAiB,CAAC;IAEnB,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/services/qdrant/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Utility helpers extracted from original qdrant.ts
+ * Functions are pure / accept service context where necessary.
+ */
+export declare function isValidUUID(uuid: string): boolean;
+export declare function convertTestIdToUUID(testId: string): string;
+export declare function validateAndConvertId(id: string): string;
+export declare function validatePayload(payload: any): void;
+export declare function parseBooleanEnv(name: string, defaultValue: boolean): boolean;
+/**
+ * Sanitize points, removing empty vectors and converting root arrays to named vectors.
+ * Keep lightweight and delegate upsert to caller.
+ */
+export declare function sanitizePoints(points: any[]): any[];
+/**
+ * Upsert points using provided Qdrant client and collection name.
+ * This is intentionally small and throws any client error to be handled by caller.
+ */
+export declare function sanitizeAndUpsert(client: any, collectionName: string, points: any[]): Promise<any>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/qdrant/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/utils.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAkClD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAO5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CA4BnD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAIxG"}

package/dist/services/qdrant/utils.js

@@ -0,0 +1,121 @@
+import { v4 as uuidv4 } from 'uuid';
+import { KairosError } from '../../types/index.js';
+import { logger } from '../../utils/structured-logger.js';
+/**
+ * Utility helpers extracted from original qdrant.ts
+ * Functions are pure / accept service context where necessary.
+ */
+export function isValidUUID(uuid) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+export function convertTestIdToUUID(testId) {
+    if (isValidUUID(testId))
+        return testId;
+    const deterministicUUID = uuidv4();
+    logger.debug(`Converted test ID "${testId}" to UUID: ${deterministicUUID}`);
+    return deterministicUUID;
+}
+export function validateAndConvertId(id) {
+    if (!id || typeof id !== 'string') {
+        throw new KairosError(`Invalid ID format: ${id}. ID must be a non-empty string.`, 'INVALID_ID_FORMAT', 400);
+    }
+    const converted = convertTestIdToUUID(id);
+    if (!isValidUUID(converted)) {
+        throw new KairosError(`ID "${id}" could not be converted to a valid UUID.`, 'INVALID_UUID_FORMAT', 400);
+    }
+    return converted;
+}
+export function validatePayload(payload) {
+    if (!payload || typeof payload !== 'object') {
+        throw new KairosError('Payload must be a valid object', 'INVALID_PAYLOAD_STRUCTURE', 400);
+    }
+    const requiredFields = ['label', 'text', 'domain', 'task', 'type'];
+    for (const field of requiredFields) {
+        if (!(field in payload)) {
+            throw new KairosError(`Missing required field: ${field}`, 'MISSING_REQUIRED_FIELD', 400, { missingField: field });
+        }
+    }
+    if (typeof payload.label !== 'string' || payload.label.trim() === '') {
+        throw new KairosError('label must be a non-empty string', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (typeof payload.text !== 'string' || payload.text.trim() === '') {
+        throw new KairosError('text must be a non-empty string', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (typeof payload.domain !== 'string' || payload.domain.trim() === '') {
+        throw new KairosError('domain must be a non-empty string', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (typeof payload.task !== 'string' || payload.task.trim() === '') {
+        throw new KairosError('task must be a non-empty string', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (typeof payload.type !== 'string' || payload.type.trim() === '') {
+        throw new KairosError('type must be a non-empty string', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (payload.tags && !Array.isArray(payload.tags)) {
+        throw new KairosError('tags must be an array if provided', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (payload.protocol && typeof payload.protocol !== 'object') {
+        throw new KairosError('protocol must be an object if provided', 'INVALID_FIELD_TYPE', 400);
+    }
+    if (payload.ai && typeof payload.ai !== 'object') {
+        throw new KairosError('ai must be an object if provided', 'INVALID_FIELD_TYPE', 400);
+    }
+}
+export function parseBooleanEnv(name, defaultValue) {
+    const raw = process.env[name];
+    if (raw === undefined)
+        return defaultValue;
+    const normalized = String(raw).trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(normalized))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(normalized))
+        return false;
+    return defaultValue;
+}
+/**
+ * Sanitize points, removing empty vectors and converting root arrays to named vectors.
+ * Keep lightweight and delegate upsert to caller.
+ */
+export function sanitizePoints(points) {
+    return (points || []).map((pt) => {
+        const newPt = { ...pt };
+        const vec = pt.vector;
+        if (!vec)
+            return newPt;
+        if (Array.isArray(vec)) {
+            if (!vec.length) {
+                delete newPt.vector;
+            }
+            else {
+                newPt.vector = { [`vs${vec.length}`]: vec };
+            }
+            return newPt;
+        }
+        if (typeof vec === 'object') {
+            const filtered = {};
+            Object.entries(vec).forEach(([k, v]) => {
+                if (Array.isArray(v) && v.length > 0)
+                    filtered[k] = v;
+            });
+            if (Object.keys(filtered).length === 0) {
+                delete newPt.vector;
+            }
+            else {
+                newPt.vector = filtered;
+            }
+            return newPt;
+        }
+        delete newPt.vector;
+        return newPt;
+    });
+}
+/**
+ * Upsert points using provided Qdrant client and collection name.
+ * This is intentionally small and throws any client error to be handled by caller.
+ */
+export async function sanitizeAndUpsert(client, collectionName, points) {
+    const sanitized = sanitizePoints(points);
+    logger.debug(`sanitizeAndUpsert: sanitized points count=${sanitized.length}`);
+    return await client.upsert(collectionName, { points: sanitized });
+}
+//# sourceMappingURL=utils.js.map

package/dist/services/qdrant/utils.js.map

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

package/dist/services/redis-cache.d.ts

@@ -0,0 +1,50 @@
+import type { Memory } from '../types/memory.js';
+export interface SearchResult {
+    memories: Memory[];
+    scores: number[];
+}
+export interface CachedSearchResult {
+    results: Array<{
+        uri: string;
+        label: string;
+        score: number;
+    }>;
+}
+export declare class RedisCacheService {
+    private cachePrefix;
+    private invalidationChannel;
+    private statsPrefix;
+    private memoryPrefix;
+    /** Bounded TTL for cached memory resources — safety net when invalidation fails. */
+    static readonly MEMORY_CACHE_TTL_SECONDS = 3600;
+    constructor();
+    private getCacheKey;
+    getSearchResult(query: string, limit: number, opts?: {
+        collapse?: boolean;
+    }): Promise<CachedSearchResult | null>;
+    setSearchResult(query: string, limit: number, result: SearchResult, opts?: {
+        collapse?: boolean;
+    }): Promise<void>;
+    invalidateSearchCache(): Promise<void>;
+    invalidateMemoryCache(uuid: string): Promise<void>;
+    /**
+     * Strict memory cache invalidation that propagates errors.
+     * Use after writes where a stale cache would cause a false-success response.
+     */
+    invalidateMemoryCacheStrict(uuid: string): Promise<void>;
+    publishInvalidation(type: string): Promise<void>;
+    incrementHits(): Promise<void>;
+    incrementMisses(): Promise<void>;
+    getCacheStats(): Promise<{
+        hits: number;
+        misses: number;
+    }>;
+    getMemoryResource(uuid: string): Promise<Memory | null>;
+    setMemoryResource(memory: Memory): Promise<void>;
+    invalidateBeginCache(): Promise<void>;
+    invalidateAfterUpdate(): Promise<void>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttl?: number): Promise<void>;
+}
+export declare const redisCacheService: RedisCacheService;
+//# sourceMappingURL=redis-cache.d.ts.map

package/dist/services/redis-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.d.ts","sourceRoot":"","sources":["../../src/services/redis-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAOjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,mBAAmB,CAAwB;IACnD,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,YAAY,CAA2B;IAC/C,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,wBAAwB,QAAQ;;IAMhD,OAAO,CAAC,WAAW;IAKb,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAkBhH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjH,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BtC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD;;;OAGG;IACG,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,aAAa,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB1D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAevD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BrC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAStC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOnE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/services/redis-cache.js

@@ -0,0 +1,237 @@
+import { logger } from '../utils/structured-logger.js';
+import { keyValueStore } from './key-value-store-factory.js';
+import { KAIROS_REDIS_PREFIX, MEMORY_CACHE_KEY_PREFIX } from '../config.js';
+import { getSpaceIdFromStorage } from '../utils/tenant-context.js';
+import { buildLayerUri } from '../tools/kairos-uri.js';
+export class RedisCacheService {
+    cachePrefix = 'search:';
+    invalidationChannel = 'cache:invalidation';
+    statsPrefix = 'stats:';
+    memoryPrefix = MEMORY_CACHE_KEY_PREFIX;
+    /** Bounded TTL for cached memory resources — safety net when invalidation fails. */
+    static MEMORY_CACHE_TTL_SECONDS = 3600;
+    constructor() {
+        logger.info('[RedisCacheService] Initialized with RedisService');
+    }
+    getCacheKey(query, limit, opts) {
+        const mode = opts && typeof opts.collapse === 'boolean' ? (opts.collapse ? 'collapsed' : 'natural') : 'collapsed';
+        return `${this.cachePrefix}${mode}:${query}:${limit}`;
+    }
+    async getSearchResult(query, limit, opts) {
+        try {
+            const key = this.getCacheKey(query, limit, opts);
+            const cached = await keyValueStore.getJson(key);
+            if (cached) {
+                logger.debug(`[RedisCacheService] Cache hit for query "${query}" limit ${limit}`);
+                await this.incrementHits();
+                return cached;
+            }
+            logger.debug(`[RedisCacheService] Cache miss for query "${query}" limit ${limit}`);
+            await this.incrementMisses();
+            return null;
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get search result from cache:', error);
+            return null;
+        }
+    }
+    async setSearchResult(query, limit, result, opts) {
+        try {
+            const key = this.getCacheKey(query, limit, opts);
+            const ttl = 300; // 5 minutes
+            const cachedResult = {
+                results: result.memories.map((memory, index) => ({
+                    uri: buildLayerUri(memory.memory_uuid),
+                    label: memory.label,
+                    score: result.scores[index] ?? 0
+                }))
+            };
+            await keyValueStore.setJson(key, cachedResult, ttl);
+            logger.debug(`[RedisCacheService] Cached search result for query "${query}" limit ${limit}`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to set search result in cache:', error);
+        }
+    }
+    async invalidateSearchCache() {
+        try {
+            logger.debug(`[RedisCacheService] Search cache invalidation requested`);
+            // Delete keys matching search cache pattern (all collapse modes)
+            const keys = await keyValueStore.keys(`${this.cachePrefix}*`);
+            if (!keys || keys.length === 0) {
+                logger.debug('[RedisCacheService] No search cache keys to delete');
+                // Still publish invalidation event even if no keys to delete
+                await this.publishInvalidation('search');
+                return;
+            }
+            // Keys returned are full Redis keys (prefix + spaceId + logicalKey); strip to get logicalKey for del()
+            const keyPrefix = `${KAIROS_REDIS_PREFIX}${getSpaceIdFromStorage()}:`;
+            const stripped = keys.map(k => k.startsWith(keyPrefix) ? k.slice(keyPrefix.length) : k);
+            await Promise.all(stripped.map(k => keyValueStore.del(k)));
+            logger.debug(`[RedisCacheService] Invalidated ${stripped.length} search cache keys`);
+            // Publish invalidation event
+            await this.publishInvalidation('search');
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate search cache:', error);
+        }
+    }
+    // Remove cached memory by UUID. Key is global (prefix+mem:uuid), so one del invalidates for all spaces.
+    // Errors are caught and logged; callers that need strict invalidation should use invalidateMemoryCacheStrict.
+    async invalidateMemoryCache(uuid) {
+        try {
+            if (!uuid || typeof uuid !== 'string') {
+                logger.warn('[RedisCacheService] invalidateMemoryCache called with invalid uuid');
+                return;
+            }
+            const key = `${this.memoryPrefix}${uuid}`;
+            await keyValueStore.del(key);
+            logger.debug(`[RedisCacheService] Invalidated memory cache for UUID ${uuid}`);
+            // Publish invalidation event
+            await this.publishInvalidation('memory');
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate memory cache:', error);
+        }
+    }
+    /**
+     * Strict memory cache invalidation that propagates errors.
+     * Use after writes where a stale cache would cause a false-success response.
+     */
+    async invalidateMemoryCacheStrict(uuid) {
+        if (!uuid || typeof uuid !== 'string') {
+            throw new Error(`Cannot invalidate memory cache: invalid uuid "${uuid}"`);
+        }
+        const key = `${this.memoryPrefix}${uuid}`;
+        await keyValueStore.del(key);
+        logger.debug(`[RedisCacheService] Strict-invalidated memory cache for UUID ${uuid}`);
+        await this.publishInvalidation('memory');
+    }
+    async publishInvalidation(type) {
+        try {
+            const message = JSON.stringify({
+                type,
+                timestamp: Date.now()
+            });
+            const subscribers = await keyValueStore.publish(this.invalidationChannel, message);
+            logger.debug(`[RedisCacheService] Published invalidation event: ${type} to ${this.invalidationChannel} (${subscribers} subscribers notified)`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to publish invalidation:', error);
+        }
+    }
+    async incrementHits() {
+        try {
+            await keyValueStore.incr(`${this.statsPrefix}hits`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to increment hits:', error);
+        }
+    }
+    async incrementMisses() {
+        try {
+            await keyValueStore.incr(`${this.statsPrefix}misses`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to increment misses:', error);
+        }
+    }
+    async getCacheStats() {
+        try {
+            const [hits, misses] = await Promise.all([
+                keyValueStore.get(`${this.statsPrefix}hits`),
+                keyValueStore.get(`${this.statsPrefix}misses`)
+            ]);
+            return {
+                hits: parseInt(hits || '0', 10),
+                misses: parseInt(misses || '0', 10)
+            };
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get cache stats:', error);
+            return { hits: 0, misses: 0 };
+        }
+    }
+    // Memory resource caching methods
+    async getMemoryResource(uuid) {
+        try {
+            const key = `${this.memoryPrefix}${uuid}`;
+            const cached = await keyValueStore.getJson(key);
+            if (cached) {
+                logger.debug(`[RedisCacheService] Memory cache hit for UUID ${uuid}`);
+                return cached;
+            }
+            return null;
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get memory from cache:', error);
+            return null;
+        }
+    }
+    async setMemoryResource(memory) {
+        try {
+            const key = `${this.memoryPrefix}${memory.memory_uuid}`;
+            // Bounded TTL prevents permanent stale data if invalidation fails
+            await keyValueStore.setJson(key, memory, RedisCacheService.MEMORY_CACHE_TTL_SECONDS);
+            logger.debug(`[RedisCacheService] Cached memory resource for UUID ${memory.memory_uuid} (TTL ${RedisCacheService.MEMORY_CACHE_TTL_SECONDS}s)`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to cache memory resource:', error);
+        }
+    }
+    // Invalidate the cached activation/search result set
+    async invalidateBeginCache() {
+        try {
+            logger.debug(`[RedisCacheService] Begin/activate cache invalidation requested`);
+            const patterns = ['begin:*', 'activate:*'];
+            const merged = [];
+            for (const pattern of patterns) {
+                const keys = await keyValueStore.keys(pattern);
+                if (keys?.length)
+                    merged.push(...keys);
+            }
+            if (merged.length === 0) {
+                logger.debug('[RedisCacheService] No begin/activate cache keys to delete');
+                return;
+            }
+            const unique = [...new Set(merged)];
+            // Keys returned are full Redis keys (prefix + spaceId + logicalKey); strip to get logicalKey for del()
+            const keyPrefix = `${KAIROS_REDIS_PREFIX}${getSpaceIdFromStorage()}:`;
+            const stripped = unique.map(k => k.startsWith(keyPrefix) ? k.slice(keyPrefix.length) : k);
+            await Promise.all(stripped.map(k => keyValueStore.del(k)));
+            logger.debug(`[RedisCacheService] Invalidated ${stripped.length} begin/activate cache keys`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate begin cache:', error);
+        }
+    }
+    // For atomic operations as per plan
+    // System is mostly read-heavy, so invalidate aggressively on writes
+    async invalidateAfterUpdate() {
+        logger.debug('[RedisCacheService] Cache invalidation after Qdrant update - clearing all search and begin caches');
+        await Promise.all([
+            this.invalidateSearchCache(),
+            this.invalidateBeginCache()
+        ]);
+    }
+    // Generic get and set methods for arbitrary caching
+    async get(key) {
+        try {
+            return await keyValueStore.get(key);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get from cache:', error);
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            await keyValueStore.set(key, value, ttl);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to set in cache:', error);
+        }
+    }
+}
+export const redisCacheService = new RedisCacheService();
+//# sourceMappingURL=redis-cache.js.map

package/dist/services/redis-cache.js.map

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

package/dist/services/redis.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Redis Service for KAIROS persistence
+ *
+ * Provides Redis-based persistence for game data and other shared state.
+ * Uses configurable key prefix (default: 'kb:') via KAIROS_REDIS_PREFIX env var for isolation.
+ * Use keyValueStore from key-value-store-factory.js unless you need Redis-specific behavior.
+ */
+import type { IKeyValueStore } from './key-value-store.js';
+export declare class RedisService implements IKeyValueStore {
+    private client;
+    private readonly prefix;
+    private connected;
+    private readonly redisUrl;
+    private readonly maskedRedisUrl;
+    constructor();
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Key is namespaced by current space (AsyncLocalStorage) so cache and proof-of-work do not collide across spaces. Memory cache keys (mem:*) and OIDC state keys (oidc-state:*) are global. */
+    private getKey;
+    get(key: string): Promise<string | null>;
+    getdel(key: string): Promise<string | null>;
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    hget(hash: string, field: string): Promise<string | null>;
+    hset(hash: string, field: string, value: string): Promise<void>;
+    hgetall(hash: string): Promise<Record<string, string> | null>;
+    hsetall(hash: string, data: Record<string, string>): Promise<void>;
+    incr(key: string): Promise<number>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Publish a message to a Redis channel (pub/sub)
+     * Note: Channel names are NOT prefixed to allow cross-instance communication
+     * @param channel Channel name to publish to
+     * @param message Message to publish
+     * @returns Number of subscribers that received the message
+     */
+    publish(channel: string, message: string): Promise<number>;
+    getJson<T>(key: string): Promise<T | null>;
+    getdelJson<T>(key: string): Promise<T | null>;
+    setJson<T>(key: string, value: T, ttl?: number): Promise<void>;
+    hgetJson<T>(hash: string, field: string): Promise<T | null>;
+    hsetJson<T>(hash: string, field: string, value: T): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/services/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAa3D,qBAAa,YAAa,YAAW,cAAc;IAC/C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;;IAwDlC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,+LAA+L;IAC/L,OAAO,CAAC,MAAM;IAQR,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAS7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW1C,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW7C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW3D,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,WAAW,IAAI,OAAO;CAGzB"}