@debian777/kairos-mcp 3.0.1-beta.14

package/dist/services/embedding/service.js

@@ -0,0 +1,302 @@
+/**
+ * Embedding Service using OpenAI embeddings
+ *
+ * Implements pure OpenAI embedding support.
+ * Uses environment variables:
+ *  - OPENAI_API_KEY
+ *  - OPENAI_EMBEDDING_MODEL
+ *  - EMBEDDING_DIMENSION
+ *
+ * Supports OpenAI and TEI (Text Embeddings Inference) providers. Selection:
+ *  - If OPENAI_API_KEY is set, OpenAI is used.
+ *  - Otherwise, TEI_BASE_URL + TEI_MODEL will be used if configured.
+ */
+import { logger } from '../../utils/logger.js';
+import { EMBEDDING_PROVIDER, OPENAI_API_KEY, TEI_BASE_URL, TEI_MODEL, TEI_API_KEY } from '../../config.js';
+import { DEFAULT_MODEL, DEFAULT_DIMENSION, TEI_EMBEDDING_ENDPOINT } from './config.js';
+import { postEmbeddings, postEmbeddingsOpenAI, postEmbeddingsTEI } from './providers.js';
+import { embeddingRequests, embeddingDuration, embeddingErrors, embeddingVectorSize, embeddingBatchSize } from '../metrics/embedding-metrics.js';
+import { getTenantId } from '../../utils/tenant-context.js';
+export class EmbeddingService {
+    embeddingDimension;
+    constructor() {
+        this.embeddingDimension = DEFAULT_DIMENSION;
+    }
+    async generateEmbedding(text) {
+        const tenantId = getTenantId();
+        const provider = this.getProvider();
+        const timer = embeddingDuration.startTimer({ provider, tenant_id: tenantId });
+        try {
+            if (!text || text.trim().length === 0)
+                throw new Error('Text cannot be empty for embedding generation');
+            const vectors = await postEmbeddings(text.trim());
+            const embedding = vectors?.[0];
+            if (!Array.isArray(embedding))
+                throw new Error('OpenAI returned no embedding');
+            if (embedding.length !== this.embeddingDimension)
+                throw new Error(`Embedding dimension mismatch: got ${embedding.length}, expected ${this.embeddingDimension}`);
+            embeddingRequests.inc({
+                provider,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            // Track vector size (assuming float32, 4 bytes per float)
+            const vectorSize = embedding.length * 4;
+            embeddingVectorSize.observe({ provider, tenant_id: tenantId }, vectorSize);
+            timer({ provider, tenant_id: tenantId });
+            return {
+                embedding,
+                model: DEFAULT_MODEL,
+                usage: { prompt_tokens: 0, total_tokens: 0 },
+            };
+        }
+        catch (error) {
+            embeddingRequests.inc({
+                provider,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            embeddingErrors.inc({
+                provider,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({ provider, tenant_id: tenantId });
+            throw error;
+        }
+    }
+    async generateBatchEmbeddings(texts) {
+        const tenantId = getTenantId();
+        const provider = this.getProvider();
+        const timer = embeddingDuration.startTimer({ provider, tenant_id: tenantId });
+        try {
+            const valid = texts.filter(t => t && t.trim().length > 0);
+            if (valid.length === 0)
+                throw new Error('No valid texts provided for batch embedding');
+            // Track batch size
+            embeddingBatchSize.observe({ tenant_id: tenantId }, valid.length);
+            const vectors = await postEmbeddings(valid);
+            // Validate each vector length
+            const wrongDim = vectors.some(v => !Array.isArray(v) || v.length !== this.embeddingDimension);
+            if (wrongDim) {
+                logger.error('[EmbeddingService] One or more embeddings returned with unexpected dimension');
+                throw new Error('One or more embeddings have unexpected dimension from OpenAI');
+            }
+            embeddingRequests.inc({
+                provider,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            // Track vector size for each embedding
+            for (const embedding of vectors) {
+                if (Array.isArray(embedding)) {
+                    const vectorSize = embedding.length * 4; // float32 = 4 bytes
+                    embeddingVectorSize.observe({ provider, tenant_id: tenantId }, vectorSize);
+                }
+            }
+            timer({ provider, tenant_id: tenantId });
+            return {
+                embeddings: vectors,
+                model: DEFAULT_MODEL,
+                usage: { prompt_tokens: 0, total_tokens: 0 },
+            };
+        }
+        catch (error) {
+            embeddingRequests.inc({
+                provider,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            embeddingErrors.inc({
+                provider,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({ provider, tenant_id: tenantId });
+            throw error;
+        }
+    }
+    calculateCosineSimilarity(embedding1, embedding2) {
+        if (!embedding1 || !embedding2)
+            return 0;
+        if (embedding1.length !== embedding2.length)
+            throw new Error('Embeddings must have the same dimensions');
+        let dot = 0, n1 = 0, n2 = 0;
+        for (let i = 0; i < embedding1.length; i++) {
+            const a = embedding1[i] || 0;
+            const b = embedding2[i] || 0;
+            dot += a * b;
+            n1 += a * a;
+            n2 += b * b;
+        }
+        const mag = Math.sqrt(n1) * Math.sqrt(n2);
+        return mag === 0 ? 0 : dot / mag;
+    }
+    async generateMemoryEmbedding(memory) {
+        const textToEmbed = [
+            memory?.content || '',
+            `Resource: ${memory?.resource || ''}`,
+            `Task: ${memory?.task || ''}`,
+            `Tags: ${(memory?.tags || []).join(', ')}`,
+            `Type: ${memory?.type || ''}`
+        ].filter(text => text.trim().length > 0).join('\n');
+        const result = await this.generateEmbedding(textToEmbed);
+        return result.embedding;
+    }
+    estimateCost() {
+        // Cost estimation could be added later; return 0 for now.
+        return 0;
+    }
+    async healthCheck() {
+        try {
+            const providerPref = EMBEDDING_PROVIDER;
+            if (providerPref === 'openai') {
+                // Explicit OpenAI only - enforce duo
+                if (!OPENAI_API_KEY || !DEFAULT_MODEL) {
+                    return { healthy: false, message: 'OpenAI requires OPENAI_API_KEY and OPENAI_EMBEDDING_MODEL' };
+                }
+                try {
+                    const res = await postEmbeddingsOpenAI('health check');
+                    return { healthy: Array.isArray(res) && res.length > 0, message: 'openai embeddings operational' };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (msg.includes('429'))
+                        return { healthy: true, message: 'openai is rate-limited (429) - reachable but throttled' };
+                    if (msg.includes('401') || msg.toLowerCase().includes('authentication'))
+                        return { healthy: false, message: 'openai authentication failed - check OPENAI_API_KEY' };
+                    return { healthy: false, message: `openai health check failed: ${msg}` };
+                }
+            }
+            if (providerPref === 'tei') {
+                // Explicit TEI only - enforce duo
+                if (!TEI_BASE_URL || !TEI_MODEL) {
+                    return { healthy: false, message: 'TEI requires TEI_BASE_URL and TEI_MODEL' };
+                }
+                try {
+                    const res = await postEmbeddingsTEI('health check');
+                    return { healthy: Array.isArray(res) && res.length > 0, message: 'TEI embeddings operational' };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (msg.includes('401'))
+                        return { healthy: false, message: 'TEI authentication failed (401)' };
+                    if (msg.includes('429'))
+                        return { healthy: true, message: 'TEI is rate-limited (429) - reachable but throttled' };
+                    return { healthy: false, message: `TEI health check failed: ${msg}` };
+                }
+            }
+            // Auto mode: prefer OpenAI if both OPENAI vars are present, otherwise TEI
+            if (OPENAI_API_KEY && DEFAULT_MODEL) {
+                try {
+                    const res = await postEmbeddingsOpenAI('health check');
+                    return { healthy: Array.isArray(res) && res.length > 0, message: 'openai embeddings operational' };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    logger.warn(`[EmbeddingService] OpenAI health check failed, trying TEI fallback: ${msg}`);
+                }
+            }
+            if (TEI_BASE_URL && TEI_MODEL) {
+                try {
+                    const url = TEI_EMBEDDING_ENDPOINT || TEI_BASE_URL;
+                    const payload = { model: TEI_MODEL, input: ['health check'] };
+                    const headers = { 'Content-Type': 'application/json' };
+                    if (TEI_API_KEY)
+                        headers['x-api-key'] = TEI_API_KEY;
+                    const resp = await fetch(url, {
+                        method: 'POST',
+                        headers,
+                        body: JSON.stringify(payload)
+                    });
+                    let data = null;
+                    try {
+                        data = await resp.json();
+                    }
+                    catch (parseErr) {
+                        logger.warn(`[EmbeddingService] TEI returned non-JSON response: ${String(parseErr)}`);
+                    }
+                    if (!resp.ok) {
+                        if (resp.status === 401) {
+                            return { healthy: false, message: 'TEI authentication failed (401)' };
+                        }
+                        if (resp.status === 429) {
+                            return { healthy: true, message: 'TEI is rate-limited (429) - reachable but throttled' };
+                        }
+                        return { healthy: false, message: `TEI returned HTTP ${resp.status}` };
+                    }
+                    // Accept several TEI response shapes:
+                    // - { embeddings: [ [..], ... ] }
+                    // - { data: [ { embedding: [...] }, ... ] }
+                    // - { result: [ ... ] } (some servers)
+                    let embeddings = null;
+                    if (Array.isArray(data?.embeddings)) {
+                        embeddings = data.embeddings;
+                    }
+                    else if (Array.isArray(data?.data)) {
+                        embeddings = data.data.map((d) => d?.embedding ?? d);
+                    }
+                    else if (Array.isArray(data?.result)) {
+                        embeddings = data.result;
+                    }
+                    else if (Array.isArray(data)) {
+                        embeddings = data;
+                    }
+                    if (Array.isArray(embeddings) && embeddings.length > 0 && Array.isArray(embeddings[0])) {
+                        const dim = embeddings[0].length;
+                        if (dim !== DEFAULT_DIMENSION) {
+                            // If env explicitly sets EMBEDDING_DIMENSION, validate against it
+                            logger.warn(`[EmbeddingService] TEI embedding dimension mismatch: got ${dim}, expected ${DEFAULT_DIMENSION}`);
+                            return { healthy: false, message: `TEI embedding dimension mismatch: got ${dim}, expected ${DEFAULT_DIMENSION}` };
+                        }
+                        return { healthy: true, message: 'TEI embeddings operational' };
+                    }
+                    return { healthy: false, message: 'TEI returned unexpected embedding shape or no embeddings' };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { healthy: false, message: `TEI health check error: ${msg}` };
+                }
+            }
+            return { healthy: false, message: 'No embedding provider configured (set OPENAI_API_KEY+OPENAI_EMBEDDING_MODEL or TEI_BASE_URL+TEI_MODEL)' };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { healthy: false, message: `Embedding health check error: ${msg}` };
+        }
+    }
+    getProvider() {
+        const pref = EMBEDDING_PROVIDER;
+        if (pref === 'openai')
+            return 'openai';
+        if (pref === 'tei')
+            return 'tei';
+        if (OPENAI_API_KEY && DEFAULT_MODEL)
+            return 'openai';
+        if (TEI_BASE_URL && TEI_MODEL)
+            return 'tei';
+        return 'local'; // fallback
+    }
+    getConfig() {
+        let provider = 'none';
+        const pref = EMBEDDING_PROVIDER;
+        if (pref === 'openai')
+            provider = 'openai';
+        else if (pref === 'tei')
+            provider = 'tei';
+        else if (OPENAI_API_KEY && DEFAULT_MODEL)
+            provider = 'openai';
+        else if (TEI_BASE_URL && TEI_MODEL)
+            provider = 'tei';
+        return {
+            model: provider === 'openai' ? DEFAULT_MODEL : (TEI_MODEL || DEFAULT_MODEL),
+            dimension: this.embeddingDimension,
+            provider,
+            apiKeyConfigured: !!OPENAI_API_KEY && !!DEFAULT_MODEL,
+            teiConfigured: !!TEI_BASE_URL && !!TEI_MODEL,
+            providerPref: EMBEDDING_PROVIDER
+        };
+    }
+}
+export const embeddingService = new EmbeddingService();
+//# sourceMappingURL=service.js.map

package/dist/services/embedding/service.js.map

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

package/dist/services/embedding/types.d.ts

@@ -0,0 +1,17 @@
+export interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface BatchEmbeddingResult {
+    embeddings: number[][];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/embedding/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/embedding/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACH,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACH,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL"}

package/dist/services/embedding/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/embedding/types.js.map

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

package/dist/services/id-generator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ID Generator Service for KAIROS
+ *
+ * Generates UUID-based identifiers for knowledge items.
+ * Uses URI-based UUIDv5 for deterministic Qdrant IDs where appropriate.
+*/
+export declare const KAIROS_NAMESPACE = "6f1d7e2b-8f7b-4b1e-9c8f-2f2f0b1a2e11";
+export declare class IDGenerator {
+    /**
+     * Generate a protocol ID for protocols
+     * This ID is shared across all steps in a protocol sequence
+     * Uses full UUID for native Qdrant support
+     *
+     * @returns RFC 4122 UUID v4 string
+     */
+    static generateProtocolId(): string;
+    /**
+     * Generate a deterministic protocol_id from domain/type/task combination
+     * This ensures the same domain/type/task always gets the same protocol_id
+     *
+     * @param domain - Knowledge domain
+     * @param type - Knowledge type
+     * @param task - Task identifier
+     * @returns Deterministic UUIDv5 string
+     */
+    static generateDeterministicProtocolId(domain: string, type: string, task: string): string;
+    /**
+    /**
+     * Generate a deterministic memory chain UUID (v5) from a label
+     * Label is normalized (trim, collapse spaces, lower-case)
+     */
+    static generateChainUUIDv5(label: string): string;
+    /**
+     * Generate a UUID for unified protocol
+     * Used for kairos://UUID URIs in the unified store protocol
+     *
+     * @returns RFC 4122 UUID v4 string
+     */
+    static generateUUID(): string;
+    /**
+     * Build Qdrant ID from human-readable URI using deterministic UUIDv5
+     *
+     * This enables URI-based retrieval: given a URI, we can always regenerate
+     * the exact same Qdrant ID for direct lookup.
+     *
+     * @param humanUri - Full human-readable URI (e.g., "kairos://uuid" or legacy "kairos://ai/rule/coding-rules@lF5kZa9D/step/1")
+     * @returns Deterministic UUIDv5 string
+     *
+     * @example
+     * buildQdrantId("kairos://700468C5-2C80-4502-B60B-9A8C74044A35")
+     * // Returns: "700468C5-2C80-4502-B60B-9A8C74044A35" (direct UUID)
+     */
+    static buildQdrantId(humanUri: string): string;
+    /**
+     * Convert URI to Qdrant ID
+     * Supports both new kairos://UUID and legacy URI formats
+     *
+     * @param uri - Full URI string
+     * @returns UUID string for Qdrant operations
+     */
+    static qdrantIdFromUri(uri: string): string;
+}
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/services/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../src/services/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;EAKE;AAOF,eAAO,MAAM,gBAAgB,yCAAyC,CAAC;AAEvE,qBAAa,WAAW;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAInC;;;;;;;;OAQG;IACH,MAAM,CAAC,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1F;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM;IAI7B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI9C;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CA6B9C"}

package/dist/services/id-generator.js

@@ -0,0 +1,101 @@
+/**
+ * ID Generator Service for KAIROS
+ *
+ * Generates UUID-based identifiers for knowledge items.
+ * Uses URI-based UUIDv5 for deterministic Qdrant IDs where appropriate.
+*/
+import { v5 as uuidv5, v4 as uuidv4 } from 'uuid';
+import { structuredLogger } from '../utils/structured-logger.js';
+// KAIROS namespace UUID for deterministic ID generation
+// Generate once and hardcode for deployment consistency
+export const KAIROS_NAMESPACE = '6f1d7e2b-8f7b-4b1e-9c8f-2f2f0b1a2e11';
+export class IDGenerator {
+    /**
+     * Generate a protocol ID for protocols
+     * This ID is shared across all steps in a protocol sequence
+     * Uses full UUID for native Qdrant support
+     *
+     * @returns RFC 4122 UUID v4 string
+     */
+    static generateProtocolId() {
+        return uuidv4();
+    }
+    /**
+     * Generate a deterministic protocol_id from domain/type/task combination
+     * This ensures the same domain/type/task always gets the same protocol_id
+     *
+     * @param domain - Knowledge domain
+     * @param type - Knowledge type
+     * @param task - Task identifier
+     * @returns Deterministic UUIDv5 string
+     */
+    static generateDeterministicProtocolId(domain, type, task) {
+        const input = `${domain}:${type}:${task}`;
+        return uuidv5(input, KAIROS_NAMESPACE);
+    }
+    /**
+    /**
+     * Generate a deterministic memory chain UUID (v5) from a label
+     * Label is normalized (trim, collapse spaces, lower-case)
+     */
+    static generateChainUUIDv5(label) {
+        const normalized = (label || '').trim().replace(/\s+/g, ' ').toLowerCase();
+        return uuidv5(normalized, KAIROS_NAMESPACE);
+    }
+    /**
+     * Generate a UUID for unified protocol
+     * Used for kairos://UUID URIs in the unified store protocol
+     *
+     * @returns RFC 4122 UUID v4 string
+     */
+    static generateUUID() {
+        return crypto.randomUUID();
+    }
+    /**
+     * Build Qdrant ID from human-readable URI using deterministic UUIDv5
+     *
+     * This enables URI-based retrieval: given a URI, we can always regenerate
+     * the exact same Qdrant ID for direct lookup.
+     *
+     * @param humanUri - Full human-readable URI (e.g., "kairos://uuid" or legacy "kairos://ai/rule/coding-rules@lF5kZa9D/step/1")
+     * @returns Deterministic UUIDv5 string
+     *
+     * @example
+     * buildQdrantId("kairos://700468C5-2C80-4502-B60B-9A8C74044A35")
+     * // Returns: "700468C5-2C80-4502-B60B-9A8C74044A35" (direct UUID)
+     */
+    static buildQdrantId(humanUri) {
+        return uuidv5(humanUri, KAIROS_NAMESPACE);
+    }
+    /**
+     * Convert URI to Qdrant ID
+     * Supports both new kairos://UUID and legacy URI formats
+     *
+     * @param uri - Full URI string
+     * @returns UUID string for Qdrant operations
+     */
+    static qdrantIdFromUri(uri) {
+        structuredLogger.debug(`qdrantIdFromUri called with URI: ${uri}`);
+        // kairos://mem/{uuid}
+        const memPrefix = 'kairos://mem/';
+        if (uri.startsWith(memPrefix)) {
+            return uri.substring(memPrefix.length);
+        }
+        // kairos://{domain}/{type}/{task}/step/{step} (deterministic hashed id)
+        if (uri.startsWith('kairos://') && uri.includes('/step/')) {
+            return IDGenerator.buildQdrantId(uri);
+        }
+        // kairos://{uuid}
+        const simplePrefix = 'kairos://';
+        if (uri.startsWith(simplePrefix)) {
+            const candidate = uri.substring(simplePrefix.length);
+            // If it's a bare UUID, return it; otherwise, fall back to v5 hash of full URI
+            if (/^[0-9a-fA-F-]{32,36}$/.test(candidate)) {
+                return candidate;
+            }
+            return IDGenerator.buildQdrantId(uri);
+        }
+        throw new Error(`Unsupported URI format: ${uri}`);
+    }
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/services/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../src/services/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;EAKE;AAEF,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,wDAAwD;AACxD,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AAEvE,MAAM,OAAO,WAAW;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB;QACrB,OAAO,MAAM,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,+BAA+B,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY;QAC7E,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAa;QACpC,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY;QACf,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB;QACjC,OAAO,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAW;QAC9B,gBAAgB,CAAC,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;QAElE,sBAAsB;QACtB,MAAM,SAAS,GAAG,eAAe,CAAC;QAClC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,wEAAwE;QACxE,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,OAAO,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,kBAAkB;QAClB,MAAM,YAAY,GAAG,WAAW,CAAC;QACjC,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACrD,8EAA8E;YAC9E,IAAI,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,OAAO,SAAS,CAAC;YACrB,CAAC;YACD,OAAO,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;CAGJ"}

package/dist/services/key-value-store-factory.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Single export for cache/proof-of-work key-value store.
+ * Uses Redis when REDIS_URL is set (non-empty), in-memory when REDIS_URL is unset or empty.
+ */
+import type { IKeyValueStore } from './key-value-store.js';
+export declare const keyValueStore: IKeyValueStore;
+//# sourceMappingURL=key-value-store-factory.d.ts.map

package/dist/services/key-value-store-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-factory.d.ts","sourceRoot":"","sources":["../../src/services/key-value-store-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,eAAO,MAAM,aAAa,EAAE,cAAsC,CAAC"}

package/dist/services/key-value-store-factory.js

@@ -0,0 +1,15 @@
+/**
+ * Single export for cache/proof-of-work key-value store.
+ * Uses Redis when REDIS_URL is set (non-empty), in-memory when REDIS_URL is unset or empty.
+ */
+import { USE_REDIS } from '../config.js';
+import { MemoryStore } from './memory-store.js';
+import { RedisService } from './redis.js';
+function createKeyValueStore() {
+    if (!USE_REDIS) {
+        return new MemoryStore();
+    }
+    return new RedisService();
+}
+export const keyValueStore = createKeyValueStore();
+//# sourceMappingURL=key-value-store-factory.js.map

package/dist/services/key-value-store-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-factory.js","sourceRoot":"","sources":["../../src/services/key-value-store-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,SAAS,mBAAmB;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAmB,mBAAmB,EAAE,CAAC"}

package/dist/services/key-value-store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Key-value store abstraction for cache and proof-of-work state.
+ * Implementations: Redis (production) or in-memory (dev/simple setups without Redis).
+ */
+/** Matches RedisService API: prefix + space namespacing applied by implementation. */
+export interface IKeyValueStore {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    getJson<T>(key: string): Promise<T | null>;
+    setJson<T>(key: string, value: T, ttl?: number): 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(channel: string, message: string): Promise<number>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=key-value-store.d.ts.map

package/dist/services/key-value-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store.d.ts","sourceRoot":"","sources":["../../src/services/key-value-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/services/key-value-store.js

@@ -0,0 +1,6 @@
+/**
+ * Key-value store abstraction for cache and proof-of-work state.
+ * Implementations: Redis (production) or in-memory (dev/simple setups without Redis).
+ */
+export {};
+//# sourceMappingURL=key-value-store.js.map

package/dist/services/key-value-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store.js","sourceRoot":"","sources":["../../src/services/key-value-store.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/memory/chain-builder-proof.d.ts

@@ -0,0 +1,18 @@
+import type { ProofOfWorkDefinition } from '../../types/memory.js';
+export interface ChallengeBlockMatch {
+    /** Start index of the opening ``` in content. */
+    start: number;
+    /** End index (after closing ```) in content. */
+    end: number;
+    proof: ProofOfWorkDefinition;
+}
+/**
+ * Find all PoW boundaries in content: each ```json block with {"challenge": ...}.
+ * Steps are defined by these boundaries, not by H2 headings.
+ */
+export declare function findAllChallengeBlocks(content: string): ChallengeBlockMatch[];
+export declare function extractProofOfWork(content: string): {
+    cleaned: string;
+    proof?: ProofOfWorkDefinition;
+};
+//# sourceMappingURL=chain-builder-proof.d.ts.map

package/dist/services/memory/chain-builder-proof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-builder-proof.d.ts","sourceRoot":"","sources":["../../../src/services/memory/chain-builder-proof.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AASnE,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAgC7E;AA4BD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAMtG"}