@jclaw/core 0.1.0

package/dist/context/memsearch-client.js

@@ -0,0 +1,182 @@
+/**
+ * MemSearch Client
+ *
+ * 通过 Python 子进程调用 MemSearch
+ * 替代 OpenViking，更简单轻量
+ *
+ * MemSearch GitHub: https://github.com/zilliztech/memsearch
+ *
+ * @module @jclaw/core/context/memsearch-client
+ */
+import { spawn } from 'child_process';
+import { writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+export class MemSearchClient {
+    initialized = false;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            memoryPath: config.memoryPath || './memory',
+            embeddingProvider: config.embeddingProvider || 'local',
+            embeddingModel: config.embeddingModel || 'all-MiniLM-L6-v2',
+            verbose: config.verbose || false,
+        };
+    }
+    async connect() {
+        try {
+            // 确保内存目录存在
+            if (!existsSync(this.config.memoryPath)) {
+                await mkdir(this.config.memoryPath, { recursive: true });
+            }
+            // 测试 MemSearch 是否可用
+            await this.runPythonScript('test', {});
+            this.initialized = true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`Failed to initialize MemSearch: ${message}`);
+        }
+    }
+    async disconnect() {
+        this.initialized = false;
+    }
+    async query(question, options) {
+        if (!this.initialized) {
+            throw new Error('Client not initialized');
+        }
+        const results = await this.runPythonScript('search', {
+            query: question,
+            top_k: options?.topK ?? 5,
+            memory_path: this.config.memoryPath,
+        });
+        return results.map((r) => r.content).join('\n\n');
+    }
+    async addResource(resourcePath) {
+        if (!this.initialized) {
+            throw new Error('Client not initialized');
+        }
+        // 将资源复制到内存目录
+        const content = await this.runPythonScript('add_resource', {
+            resource_path: resourcePath,
+            memory_path: this.config.memoryPath,
+        });
+        return content.uri || '';
+    }
+    async saveMemory(content, title) {
+        const date = new Date().toISOString().split('T')[0];
+        const fileName = `${date}.md`;
+        const filePath = join(this.config.memoryPath, fileName);
+        const entry = title
+            ? `\n## ${title}\n${content}\n`
+            : `\n${content}\n`;
+        await writeFile(filePath, entry, { flag: 'a' });
+        // 重新索引
+        await this.runPythonScript('index', {
+            memory_path: this.config.memoryPath,
+        });
+    }
+    isConnected() {
+        return this.initialized;
+    }
+    runPythonScript(action, params) {
+        return new Promise((resolve, reject) => {
+            const script = this.generatePythonScript(action, params);
+            const proc = spawn('python', ['-c', script], {
+                env: {
+                    ...process.env,
+                    MEMSEARCH_PROVIDER: this.config.embeddingProvider,
+                    MEMSEARCH_MODEL: this.config.embeddingModel,
+                },
+            });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Python script failed: ${stderr}`));
+                    return;
+                }
+                try {
+                    const result = JSON.parse(stdout);
+                    resolve(result);
+                }
+                catch {
+                    resolve(stdout.trim());
+                }
+            });
+            proc.on('error', (error) => {
+                reject(error);
+            });
+        });
+    }
+    generatePythonScript(action, params) {
+        const baseScript = `
+import asyncio
+import json
+import sys
+sys.path.insert(0, '.')
+
+from memsearch import MemSearch
+
+async def main():
+    mem = MemSearch(
+        paths=['${params.memory_path || this.config.memoryPath}'],
+        embedding_provider='${this.config.embeddingProvider}',
+        embedding_model='${this.config.embeddingModel}',
+    )
+`;
+        switch (action) {
+            case 'test':
+                return baseScript + `
+    await mem.index()
+    print(json.dumps({"status": "ok"}))
+
+asyncio.run(main())
+`;
+            case 'search':
+                return baseScript + `
+    await mem.index()
+    results = await mem.search('${params.query}', top_k=${params.top_k})
+    print(json.dumps(results))
+
+asyncio.run(main())
+`;
+            case 'index':
+                return baseScript + `
+    await mem.index()
+    print(json.dumps({"status": "indexed"}))
+
+asyncio.run(main())
+`;
+            case 'add_resource':
+                return baseScript + `
+    import shutil
+    from pathlib import Path
+    
+    src = Path('${params.resource_path}')
+    dst = Path('${params.memory_path}') / src.name
+    shutil.copy2(src, dst)
+    await mem.index()
+    print(json.dumps({"uri": str(dst)}))
+
+asyncio.run(main())
+`;
+            default:
+                return baseScript + `
+    print(json.dumps({"error": "Unknown action"}))
+
+asyncio.run(main())
+`;
+        }
+    }
+}
+export function createMemSearchClient(config) {
+    return new MemSearchClient(config);
+}
+//# sourceMappingURL=memsearch-client.js.map

package/dist/context/memsearch-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memsearch-client.js","sourceRoot":"","sources":["../../src/context/memsearch-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAUhC,MAAM,OAAO,eAAe;IAClB,WAAW,GAAG,KAAK,CAAC;IACX,MAAM,CAA4B;IAEnD,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU;YAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,OAAO;YACtD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,kBAAkB;YAC3D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,WAAW;YACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,oBAAoB;YACpB,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAA2B;QACvD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE;YACnD,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC;YACzB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACpC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,YAAoB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,aAAa;QACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE;YACzD,aAAa,EAAE,YAAY;YAC3B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACpC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,KAAc;QAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,GAAG,IAAI,KAAK,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAExD,MAAM,KAAK,GAAG,KAAK;YACjB,CAAC,CAAC,QAAQ,KAAK,KAAK,OAAO,IAAI;YAC/B,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC;QAErB,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAEhD,OAAO;QACP,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE;YAClC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACpC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,eAAe,CAAC,MAAc,EAAE,MAA2B;QACjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;gBAC3C,GAAG,EAAE;oBACH,GAAG,OAAO,CAAC,GAAG;oBACd,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;oBACjD,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;iBAC5C;aACF,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC9B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC9B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAClC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB,CAAC,MAAc,EAAE,MAA2B;QACtE,MAAM,UAAU,GAAG;;;;;;;;;;kBAUL,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;8BAChC,IAAI,CAAC,MAAM,CAAC,iBAAiB;2BAChC,IAAI,CAAC,MAAM,CAAC,cAAc;;CAEpD,CAAC;QAEE,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,UAAU,GAAG;;;;;CAK3B,CAAC;YACI,KAAK,QAAQ;gBACX,OAAO,UAAU,GAAG;;kCAEM,MAAM,CAAC,KAAK,YAAY,MAAM,CAAC,KAAK;;;;CAIrE,CAAC;YACI,KAAK,OAAO;gBACV,OAAO,UAAU,GAAG;;;;;CAK3B,CAAC;YACI,KAAK,cAAc;gBACjB,OAAO,UAAU,GAAG;;;;kBAIV,MAAM,CAAC,aAAa;kBACpB,MAAM,CAAC,WAAW;;;;;;CAMnC,CAAC;YACI;gBACE,OAAO,UAAU,GAAG;;;;CAI3B,CAAC;QACE,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/context/mock-client.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Mock OpenViking Client
+ *
+ * In-memory mock implementation of ContextManager interface for offline testing.
+ *
+ * @module @jclaw/core/context/mock-client
+ */
+import type { ContextManager } from '../types.js';
+/**
+ * Internal resource representation for mock client
+ */
+interface MockResource {
+    id: string;
+    path: string;
+    content: string;
+    addedAt: Date;
+}
+/**
+ * Mock implementation of ContextManager for testing purposes.
+ *
+ * Provides in-memory storage and retrieval without requiring a real
+ * OpenViking server connection. Useful for unit tests and offline development.
+ *
+ * @example
+ * ```typescript
+ * const client = new MockClient();
+ * await client.connect();
+ *
+ * // Set custom query responses for testing
+ * client.setQueryResponse('What is JClaw?', 'JClaw is a self-evolving agent framework');
+ *
+ * const result = await client.query('What is JClaw?');
+ * console.log(result); // 'JClaw is a self-evolving agent framework'
+ * ```
+ */
+export declare class MockClient implements ContextManager {
+    private connected;
+    private resources;
+    private queryResponses;
+    /**
+     * Establish connection to the mock context backend.
+     * Simply sets internal connected flag to true.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the mock context backend.
+     * Simply sets internal connected flag to false.
+     * Does not clear stored resources or query responses.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Query the mock context for relevant information.
+     *
+     * @param question - The question to query
+     * @param options - Query options (topK is ignored in mock)
+     * @returns Mock response or custom response if set via setQueryResponse
+     * @throws Error if client is not connected
+     */
+    query(question: string, options?: {
+        topK?: number;
+    }): Promise<string>;
+    /**
+     * Add a resource to the mock context.
+     *
+     * @param resourcePath - Path to the resource to add
+     * @returns Generated resource identifier
+     * @throws Error if client is not connected
+     */
+    addResource(resourcePath: string): Promise<string>;
+    /**
+     * Set a custom response for a specific query.
+     * Useful for testing specific scenarios.
+     *
+     * @param question - The question to set a response for
+     * @param response - The response to return
+     */
+    setQueryResponse(question: string, response: string): void;
+    /**
+     * Clear a previously set query response.
+     *
+     * @param question - The question to clear the response for
+     */
+    clearQueryResponse(question: string): void;
+    /**
+     * Get all stored resources.
+     * Useful for verifying addResource calls in tests.
+     *
+     * @returns Array of all stored resources
+     */
+    getResources(): MockResource[];
+    /**
+     * Get a specific resource by ID.
+     *
+     * @param id - The resource ID
+     * @returns The resource or undefined if not found
+     */
+    getResourceById(id: string): MockResource | undefined;
+    /**
+     * Clear all stored resources.
+     * Useful for test cleanup.
+     */
+    clearResources(): void;
+    /**
+     * Check if the client is currently connected.
+     *
+     * @returns True if connected, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Reset the client to initial state.
+     * Disconnects, clears all resources and query responses.
+     */
+    reset(): void;
+}
+export {};
+//# sourceMappingURL=mock-client.d.ts.map

package/dist/context/mock-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-client.d.ts","sourceRoot":"","sources":["../../src/context/mock-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,cAAc,CAAkC;IAExD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;;;OAOG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB3E;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBxD;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI1D;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI1C;;;;;OAKG;IACH,YAAY,IAAI,YAAY,EAAE;IAI9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD;;;OAGG;IACH,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/context/mock-client.js

@@ -0,0 +1,150 @@
+/**
+ * Mock OpenViking Client
+ *
+ * In-memory mock implementation of ContextManager interface for offline testing.
+ *
+ * @module @jclaw/core/context/mock-client
+ */
+/**
+ * Mock implementation of ContextManager for testing purposes.
+ *
+ * Provides in-memory storage and retrieval without requiring a real
+ * OpenViking server connection. Useful for unit tests and offline development.
+ *
+ * @example
+ * ```typescript
+ * const client = new MockClient();
+ * await client.connect();
+ *
+ * // Set custom query responses for testing
+ * client.setQueryResponse('What is JClaw?', 'JClaw is a self-evolving agent framework');
+ *
+ * const result = await client.query('What is JClaw?');
+ * console.log(result); // 'JClaw is a self-evolving agent framework'
+ * ```
+ */
+export class MockClient {
+    connected = false;
+    resources = new Map();
+    queryResponses = new Map();
+    /**
+     * Establish connection to the mock context backend.
+     * Simply sets internal connected flag to true.
+     */
+    async connect() {
+        this.connected = true;
+    }
+    /**
+     * Disconnect from the mock context backend.
+     * Simply sets internal connected flag to false.
+     * Does not clear stored resources or query responses.
+     */
+    async disconnect() {
+        this.connected = false;
+    }
+    /**
+     * Query the mock context for relevant information.
+     *
+     * @param question - The question to query
+     * @param options - Query options (topK is ignored in mock)
+     * @returns Mock response or custom response if set via setQueryResponse
+     * @throws Error if client is not connected
+     */
+    async query(question, options) {
+        if (!this.connected) {
+            throw new Error('Client not connected');
+        }
+        // Options are available for future use (topK for limiting results)
+        const _topK = options?.topK; // Available for future implementation
+        void _topK; // mark as used
+        // Check for custom response first
+        const customResponse = this.queryResponses.get(question);
+        if (customResponse !== undefined) {
+            return customResponse;
+        }
+        // Return default mock response
+        return `Mock response for: ${question}`;
+    }
+    /**
+     * Add a resource to the mock context.
+     *
+     * @param resourcePath - Path to the resource to add
+     * @returns Generated resource identifier
+     * @throws Error if client is not connected
+     */
+    async addResource(resourcePath) {
+        if (!this.connected) {
+            throw new Error('Client not connected');
+        }
+        const id = `mock-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        this.resources.set(id, {
+            id,
+            path: resourcePath,
+            content: '',
+            addedAt: new Date(),
+        });
+        return id;
+    }
+    // ===== Test Helper Methods =====
+    /**
+     * Set a custom response for a specific query.
+     * Useful for testing specific scenarios.
+     *
+     * @param question - The question to set a response for
+     * @param response - The response to return
+     */
+    setQueryResponse(question, response) {
+        this.queryResponses.set(question, response);
+    }
+    /**
+     * Clear a previously set query response.
+     *
+     * @param question - The question to clear the response for
+     */
+    clearQueryResponse(question) {
+        this.queryResponses.delete(question);
+    }
+    /**
+     * Get all stored resources.
+     * Useful for verifying addResource calls in tests.
+     *
+     * @returns Array of all stored resources
+     */
+    getResources() {
+        return Array.from(this.resources.values());
+    }
+    /**
+     * Get a specific resource by ID.
+     *
+     * @param id - The resource ID
+     * @returns The resource or undefined if not found
+     */
+    getResourceById(id) {
+        return this.resources.get(id);
+    }
+    /**
+     * Clear all stored resources.
+     * Useful for test cleanup.
+     */
+    clearResources() {
+        this.resources.clear();
+    }
+    /**
+     * Check if the client is currently connected.
+     *
+     * @returns True if connected, false otherwise
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Reset the client to initial state.
+     * Disconnects, clears all resources and query responses.
+     */
+    reset() {
+        this.connected = false;
+        this.resources.clear();
+        this.queryResponses.clear();
+    }
+}
+//# sourceMappingURL=mock-client.js.map

package/dist/context/mock-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-client.js","sourceRoot":"","sources":["../../src/context/mock-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,UAAU;IACb,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,GAA8B,IAAI,GAAG,EAAE,CAAC;IACjD,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;IAExD;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAA2B;QACvD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,mEAAmE;QACnE,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,sCAAsC;QACnE,KAAK,KAAK,CAAC,CAAC,eAAe;QAE3B,kCAAkC;QAClC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,+BAA+B;QAC/B,OAAO,sBAAsB,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,YAAoB;QACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,EAAE,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE;YACrB,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI,IAAI,EAAE;SACpB,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kCAAkC;IAElC;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;QACjD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAgB;QACjC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/context/openviking-client.d.ts

@@ -0,0 +1,87 @@
+/**
+ * OpenViking Client
+ *
+ * HTTP client implementation of ContextManager interface for connecting
+ * to OpenViking MCP Server.
+ *
+ * @module @jclaw/core/context/openviking-client
+ */
+import type { ContextManager } from '../types.js';
+/**
+ * Configuration options for OpenViking client.
+ */
+export interface OpenVikingConfig {
+    /** URL of the OpenViking MCP server */
+    serverUrl: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * HTTP client implementation of ContextManager for OpenViking MCP Server.
+ *
+ * Provides connection management and context operations via HTTP requests.
+ * For Phase 1, this uses a basic HTTP client approach. Full MCP SDK
+ * integration can be added in later phases.
+ *
+ * @example
+ * ```typescript
+ * const client = new OpenVikingClient({
+ *   serverUrl: 'http://localhost:2033/mcp'
+ * });
+ *
+ * await client.connect();
+ * const result = await client.query('What is the project structure?');
+ * await client.disconnect();
+ * ```
+ */
+export declare class OpenVikingClient implements ContextManager {
+    private connected;
+    private readonly config;
+    /**
+     * Create a new OpenViking client instance.
+     *
+     * @param config - Configuration options including server URL and timeout
+     */
+    constructor(config: OpenVikingConfig);
+    /**
+     * Establish connection to the OpenViking server.
+     *
+     * Performs a health check GET request to verify the server is available.
+     *
+     * @throws Error if connection fails or server is not available
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the OpenViking server.
+     *
+     * Simply sets the internal connected flag to false.
+     * No explicit disconnect request is sent to the server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Query the OpenViking context for relevant information.
+     *
+     * @param question - The question to query
+     * @param options - Query options including topK for result count
+     * @returns Relevant context as string
+     * @throws Error if client is not connected or query fails
+     */
+    query(question: string, options?: {
+        topK?: number;
+    }): Promise<string>;
+    /**
+     * Add a resource to the OpenViking context.
+     *
+     * @param resourcePath - Path to the resource to add
+     * @returns Resource identifier returned by the server
+     * @throws Error if client is not connected or add operation fails
+     */
+    addResource(resourcePath: string): Promise<string>;
+    /**
+     * Check if the client is currently connected.
+     *
+     * @returns True if connected, false otherwise
+     */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=openviking-client.d.ts.map

package/dist/context/openviking-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openviking-client.d.ts","sourceRoot":"","sources":["../../src/context/openviking-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD;;;;OAIG;gBACS,MAAM,EAAE,gBAAgB;IAOpC;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;;;OAOG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAwC3E;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCxD;;;;OAIG;IACH,WAAW,IAAI,OAAO;CAGvB"}