@yuihub/mcp-server 1.0.0-beta.1

package/dist/auth.d.ts

@@ -0,0 +1,22 @@
+/**
+ * YuiHub MCP Server - Auth Token Reader
+ * Reads token from Backend's .token file
+ */
+export interface AuthToken {
+    token: string;
+    created_at: string;
+}
+/**
+ * Get default data directory
+ */
+export declare function getDefaultDataDir(): string;
+/**
+ * Read token from .token file
+ * This uses synchronous read since it's called during startup
+ */
+export declare function readTokenSync(dataDir?: string): string | undefined;
+/**
+ * Read token from .token file (async)
+ */
+export declare function readToken(dataDir?: string): Promise<string | undefined>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAelE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7E"}

package/dist/auth.js

@@ -0,0 +1,48 @@
+/**
+ * YuiHub MCP Server - Auth Token Reader
+ * Reads token from Backend's .token file
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+/**
+ * Get default data directory
+ */
+export function getDefaultDataDir() {
+    return process.env.DATA_DIR || path.join(os.homedir(), '.yuihub');
+}
+/**
+ * Read token from .token file
+ * This uses synchronous read since it's called during startup
+ */
+export function readTokenSync(dataDir) {
+    const dir = dataDir || getDefaultDataDir();
+    const tokenPath = path.join(dir, '.token');
+    try {
+        if (fs.existsSync(tokenPath)) {
+            const content = fs.readFileSync(tokenPath, 'utf-8');
+            const auth = JSON.parse(content);
+            return auth.token;
+        }
+    }
+    catch {
+        // Token file not found or invalid
+    }
+    return undefined;
+}
+/**
+ * Read token from .token file (async)
+ */
+export async function readToken(dataDir) {
+    const dir = dataDir || getDefaultDataDir();
+    const tokenPath = path.join(dir, '.token');
+    try {
+        const content = await fs.promises.readFile(tokenPath, 'utf-8');
+        const auth = JSON.parse(content);
+        return auth.token;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAOpB;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,GAAG,GAAG,OAAO,IAAI,iBAAiB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAgB;IAC9C,MAAM,GAAG,GAAG,OAAO,IAAI,iBAAiB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * YuiHub MCP Server - HTTP Client
+ * Communicates with YuiHub Backend API
+ */
+export interface ClientConfig {
+    baseUrl: string;
+    token: string;
+}
+export interface SaveEntry {
+    text: string;
+    session_id: string;
+    tags?: string[];
+    mode?: 'private' | 'public';
+}
+export interface SearchFilter {
+    tag?: string;
+    session?: string;
+}
+export interface SearchResult {
+    id: string;
+    text: string;
+    score: number;
+    mode: string;
+    tags: string;
+    session_id: string;
+    source: string;
+    date: string;
+}
+export interface Session {
+    id: string;
+    title: string;
+    created_at: string;
+}
+export interface Checkpoint {
+    id: string;
+    session_id: string;
+    snapshot: {
+        working_memory: string;
+        decision_rationale: string;
+    };
+    intent: string;
+    entry_ids: string[];
+    created_at: string;
+}
+export interface ContextPacket {
+    intent: string;
+    session_id?: string;
+    working_memory: Record<string, unknown>;
+    long_term_memory: Array<{
+        text: string;
+        relevance: number;
+    }>;
+    meta: {
+        mode: string;
+    };
+}
+export interface HealthStatus {
+    status: string;
+    version: string;
+}
+export declare class YuiHubClient {
+    private baseUrl;
+    private token;
+    constructor(config: ClientConfig);
+    private request;
+    health(): Promise<HealthStatus>;
+    save(entries: SaveEntry[]): Promise<{
+        ok: boolean;
+        count: number;
+    }>;
+    search(query: string, limit?: number, filter?: SearchFilter): Promise<SearchResult[]>;
+    createThread(title?: string): Promise<Session>;
+    createCheckpoint(params: {
+        session_id: string;
+        summary: string;
+        intent: string;
+        working_memory?: Record<string, unknown>;
+        entry_ids?: string[];
+    }): Promise<Checkpoint>;
+    exportContext(intent?: string, session?: string): Promise<ContextPacket>;
+}
+export declare function createClient(config: ClientConfig): YuiHubClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,101 @@
+/**
+ * YuiHub MCP Server - HTTP Client
+ * Communicates with YuiHub Backend API
+ */
+import { YuiHubMCPError } from './errors.js';
+export class YuiHubClient {
+    baseUrl;
+    token;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.token = config.token;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.token}`,
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                if (response.status === 401) {
+                    throw new YuiHubMCPError(-32001, `Unauthorized: ${text}`);
+                }
+                if (response.status === 400) {
+                    throw new YuiHubMCPError(-32602, `Invalid params: ${text}`);
+                }
+                if (response.status === 429) {
+                    throw new YuiHubMCPError(-32003, `Rate limited: ${text}`);
+                }
+                if (response.status >= 500) {
+                    throw new YuiHubMCPError(-32603, `Internal error: ${text}`);
+                }
+                throw new YuiHubMCPError(-32603, `HTTP ${response.status}: ${text}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof YuiHubMCPError) {
+                throw error;
+            }
+            // Connection error
+            throw new YuiHubMCPError(-32002, `Backend not reachable at ${this.baseUrl}: ${error.message}`);
+        }
+    }
+    // Health check
+    async health() {
+        const res = await this.request('GET', '/health');
+        return res;
+    }
+    // Save entries
+    async save(entries) {
+        return this.request('POST', '/save', {
+            entries: entries.map(e => ({
+                text: e.text,
+                mode: e.mode || 'private',
+                tags: e.tags || [],
+                session_id: e.session_id,
+            })),
+        });
+    }
+    // Search memory
+    async search(query, limit = 10, filter) {
+        const params = new URLSearchParams({ q: query, limit: limit.toString() });
+        if (filter?.tag)
+            params.set('tag', filter.tag);
+        if (filter?.session)
+            params.set('session', filter.session);
+        const res = await this.request('GET', `/search?${params}`);
+        return res.results;
+    }
+    // Create new session/thread
+    async createThread(title) {
+        const res = await this.request('POST', '/threads/new', { title });
+        return res.session;
+    }
+    // Create checkpoint
+    async createCheckpoint(params) {
+        const res = await this.request('POST', '/checkpoints', params);
+        return res.checkpoint;
+    }
+    // Export context
+    async exportContext(intent, session) {
+        const params = new URLSearchParams();
+        if (intent)
+            params.set('q', intent);
+        if (session)
+            params.set('session', session);
+        const query = params.toString();
+        const res = await this.request('GET', `/export/context${query ? '?' + query : ''}`);
+        return res.packet;
+    }
+}
+export function createClient(config) {
+    return new YuiHubClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * YuiHub MCP Server - Error Definitions
+ */
+/**
+ * MCP Error Codes:
+ * -32001: Unauthorized (401)
+ * -32002: Backend not reachable
+ * -32003: Rate limited (429)
+ * -32602: Invalid params (400)
+ * -32603: Internal error (500)
+ */
+export declare class YuiHubMCPError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/**
+ * Convert any error to MCP-compatible error
+ */
+export declare function toMCPError(error: unknown): YuiHubMCPError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEnB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAM1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAUzD"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+/**
+ * YuiHub MCP Server - Error Definitions
+ */
+/**
+ * MCP Error Codes:
+ * -32001: Unauthorized (401)
+ * -32002: Backend not reachable
+ * -32003: Rate limited (429)
+ * -32602: Invalid params (400)
+ * -32603: Internal error (500)
+ */
+export class YuiHubMCPError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'YuiHubMCPError';
+        this.code = code;
+        this.data = data;
+    }
+}
+/**
+ * Convert any error to MCP-compatible error
+ */
+export function toMCPError(error) {
+    if (error instanceof YuiHubMCPError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new YuiHubMCPError(-32603, error.message);
+    }
+    return new YuiHubMCPError(-32603, String(error));
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,IAAI,CAAS;IACb,IAAI,CAAW;IAE/B,YAAY,IAAY,EAAE,OAAe,EAAE,IAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * YuiHub MCP Server - Stdio Entry Point
+ * For Claude Desktop, VS Code Copilot, etc.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * YuiHub MCP Server - Stdio Entry Point
+ * For Claude Desktop, VS Code Copilot, etc.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const { server } = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Handle shutdown
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,kBAAkB;IAClB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/resources/handlers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * YuiHub MCP Resources - Handlers
+ * yuihub://recent, yuihub://session/{id}, yuihub://system/status
+ */
+import type { YuiHubClient } from '../client.js';
+export declare function handleRecent(client: YuiHubClient): Promise<string>;
+export declare function handleSession(client: YuiHubClient, sessionId: string): Promise<string>;
+export declare function handleSystemStatus(client: YuiHubClient): Promise<string>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/resources/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/resources/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAUxE;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5F;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9E"}

package/dist/resources/handlers.js

@@ -0,0 +1,29 @@
+/**
+ * YuiHub MCP Resources - Handlers
+ * yuihub://recent, yuihub://session/{id}, yuihub://system/status
+ */
+export async function handleRecent(client) {
+    const results = await client.search('', 20);
+    if (results.length === 0) {
+        return 'No recent memories.';
+    }
+    return results.map((r, i) => `[${i + 1}] ${r.date}\n${r.text.slice(0, 150)}${r.text.length > 150 ? '...' : ''}`).join('\n\n');
+}
+export async function handleSession(client, sessionId) {
+    const results = await client.search('', 50, { session: sessionId });
+    if (results.length === 0) {
+        return `No entries found for session: ${sessionId}`;
+    }
+    return `Session: ${sessionId}\nEntries: ${results.length}\n\n` +
+        results.map((r, i) => `[${i + 1}] ${r.date}\n${r.text.slice(0, 200)}${r.text.length > 200 ? '...' : ''}`).join('\n\n');
+}
+export async function handleSystemStatus(client) {
+    try {
+        const health = await client.health();
+        return `Status: ${health.status}\nVersion: ${health.version}`;
+    }
+    catch (error) {
+        return `Status: offline\nError: ${error.message}`;
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/resources/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/resources/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAE5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACnF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAoB,EAAE,SAAiB;IACzE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAEpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,iCAAiC,SAAS,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,YAAY,SAAS,cAAc,OAAO,CAAC,MAAM,MAAM;QAC5D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACnF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoB;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,WAAW,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,2BAA4B,KAAe,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * YuiHub MCP Resources - Registration
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { YuiHubClient } from '../client.js';
+export declare function registerResources(server: Server, client: YuiHubClient): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAiE5E"}

package/dist/resources/index.js

@@ -0,0 +1,72 @@
+/**
+ * YuiHub MCP Resources - Registration
+ */
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { toMCPError } from '../errors.js';
+import { handleRecent, handleSession, handleSystemStatus } from './handlers.js';
+export function registerResources(server, client) {
+    // List resources handler
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'yuihub://recent',
+                    name: 'Recent Memories',
+                    description: 'Most recent thoughts and entries',
+                    mimeType: 'text/plain',
+                },
+                {
+                    uri: 'yuihub://system/status',
+                    name: 'System Status',
+                    description: 'YuiHub backend health status',
+                    mimeType: 'text/plain',
+                },
+            ],
+        };
+    });
+    // Resource templates for dynamic URIs
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return {
+            resourceTemplates: [
+                {
+                    uriTemplate: 'yuihub://session/{id}',
+                    name: 'Session History',
+                    description: 'All entries for a specific session',
+                    mimeType: 'text/plain',
+                },
+            ],
+        };
+    });
+    // Read resource handler
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        try {
+            let content;
+            if (uri === 'yuihub://recent') {
+                content = await handleRecent(client);
+            }
+            else if (uri === 'yuihub://system/status') {
+                content = await handleSystemStatus(client);
+            }
+            else if (uri.startsWith('yuihub://session/')) {
+                const sessionId = uri.replace('yuihub://session/', '');
+                content = await handleSession(client, sessionId);
+            }
+            else {
+                throw new Error(`Unknown resource: ${uri}`);
+            }
+            return {
+                contents: [{
+                        uri,
+                        mimeType: 'text/plain',
+                        text: content,
+                    }],
+            };
+        }
+        catch (error) {
+            const mcpError = toMCPError(error);
+            throw mcpError;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,MAAoB;IACpE,yBAAyB;IACzB,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC9D,OAAO;YACL,SAAS,EAAE;gBACT;oBACE,GAAG,EAAE,iBAAiB;oBACtB,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,kCAAkC;oBAC/C,QAAQ,EAAE,YAAY;iBACvB;gBACD;oBACE,GAAG,EAAE,wBAAwB;oBAC7B,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,8BAA8B;oBAC3C,QAAQ,EAAE,YAAY;iBACvB;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QACtE,OAAO;YACL,iBAAiB,EAAE;gBACjB;oBACE,WAAW,EAAE,uBAAuB;oBACpC,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,oCAAoC;oBACjD,QAAQ,EAAE,YAAY;iBACvB;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAE/B,IAAI,CAAC;YACH,IAAI,OAAe,CAAC;YAEpB,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;gBAC9B,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,GAAG,KAAK,wBAAwB,EAAE,CAAC;gBAC5C,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;iBAAM,IAAI,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;gBACvD,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG;wBACH,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE,OAAO;qBACd,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * YuiHub MCP Server - Core Server Setup
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { YuiHubClient } from './client.js';
+export interface ServerConfig {
+    name?: string;
+    version?: string;
+    dataDir?: string;
+    backendUrl?: string;
+}
+export declare function createServer(config?: ServerConfig): {
+    server: Server;
+    client: YuiHubClient;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,YAAY,EAAgB,MAAM,aAAa,CAAC;AAKzD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAoChG"}

package/dist/server.js

@@ -0,0 +1,37 @@
+/**
+ * YuiHub MCP Server - Core Server Setup
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { createClient } from './client.js';
+import { readTokenSync, getDefaultDataDir } from './auth.js';
+import { registerTools } from './tools/index.js';
+import { registerResources } from './resources/index.js';
+export function createServer(config = {}) {
+    const dataDir = config.dataDir || getDefaultDataDir();
+    const backendUrl = config.backendUrl || process.env.YUIHUB_API_URL || 'http://localhost:4182';
+    // Read token from .token file
+    const token = process.env.YUIHUB_TOKEN || readTokenSync(dataDir);
+    if (!token) {
+        throw new Error(`No auth token found. Make sure YuiHub Backend is running and has created ${dataDir}/.token`);
+    }
+    // Create HTTP client
+    const client = createClient({
+        baseUrl: backendUrl,
+        token,
+    });
+    // Create MCP server
+    const server = new Server({
+        name: config.name || 'yuihub-mcp',
+        version: config.version || '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // Register handlers
+    registerTools(server, client);
+    registerResources(server, client);
+    return { server, client };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AASzD,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAE9F,8BAA8B;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAEjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4EAA4E,OAAO,SAAS,CAAC,CAAC;IAChH,CAAC;IAED,qBAAqB;IACrB,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,OAAO,EAAE,UAAU;QACnB,KAAK;KACN,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,YAAY;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;KACnC,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd;KACF,CACF,CAAC;IAEF,oBAAoB;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/sse-server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * YuiHub MCP Server - SSE Entry Point
+ * For browser clients
+ */
+export {};
+//# sourceMappingURL=sse-server.d.ts.map

package/dist/sse-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-server.d.ts","sourceRoot":"","sources":["../src/sse-server.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/sse-server.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * YuiHub MCP Server - SSE Entry Point
+ * For browser clients
+ */
+import http from 'http';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { createServer } from './server.js';
+const DEFAULT_PORT = 4106;
+const port = parseInt(process.env.YUIHUB_MCP_PORT || String(DEFAULT_PORT), 10);
+const httpServer = http.createServer();
+// Store active transports
+const transports = new Map();
+let connectionId = 0;
+httpServer.on('request', async (req, res) => {
+    // CORS headers
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+    if (req.method === 'OPTIONS') {
+        res.writeHead(200);
+        res.end();
+        return;
+    }
+    const url = new URL(req.url || '/', `http://localhost:${port}`);
+    // SSE endpoint
+    if (url.pathname === '/sse' && req.method === 'GET') {
+        const id = `conn-${++connectionId}`;
+        console.log(`[SSE] New connection: ${id}`);
+        const { server } = createServer();
+        const transport = new SSEServerTransport('/message', res);
+        transports.set(id, transport);
+        res.on('close', () => {
+            console.log(`[SSE] Connection closed: ${id}`);
+            transports.delete(id);
+        });
+        await server.connect(transport);
+        return;
+    }
+    // Message endpoint for SSE clients
+    if (url.pathname === '/message' && req.method === 'POST') {
+        let body = '';
+        req.on('data', chunk => body += chunk);
+        req.on('end', async () => {
+            // Find the transport for this session (simplified - uses last transport)
+            const transport = Array.from(transports.values()).pop();
+            if (transport) {
+                // Handle incoming message
+                try {
+                    await transport.handlePostMessage(req, res, body);
+                }
+                catch (error) {
+                    console.error('[SSE] Message error:', error);
+                    res.writeHead(500);
+                    res.end('Internal error');
+                }
+            }
+            else {
+                res.writeHead(404);
+                res.end('No active connection');
+            }
+        });
+        return;
+    }
+    // Health check
+    if (url.pathname === '/health') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'ok', connections: transports.size }));
+        return;
+    }
+    // Not found
+    res.writeHead(404);
+    res.end('Not Found');
+});
+httpServer.listen(port, () => {
+    console.log(`[YuiHub MCP] SSE Server running on http://localhost:${port}`);
+    console.log(`[YuiHub MCP] SSE endpoint: http://localhost:${port}/sse`);
+});
+// Handle shutdown
+process.on('SIGINT', () => {
+    console.log('[YuiHub MCP] Shutting down...');
+    httpServer.close();
+    process.exit(0);
+});
+//# sourceMappingURL=sse-server.js.map

package/dist/sse-server.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * YuiHub MCP Tools - Context Operations
+ * fetch_context, create_checkpoint
+ */
+import { z } from 'zod';
+import type { YuiHubClient } from '../client.js';
+export declare const fetchContextSchema: z.ZodObject<{
+    intent: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FetchContextInput = z.infer<typeof fetchContextSchema>;
+export declare function fetchContext(client: YuiHubClient, input: FetchContextInput): Promise<string>;
+export declare const createCheckpointSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    summary: z.ZodString;
+    intent: z.ZodString;
+    working_memory: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    entry_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateCheckpointInput = z.infer<typeof createCheckpointSchema>;
+export declare function createCheckpoint(client: YuiHubClient, input: CreateCheckpointInput): Promise<string>;
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalG;AAGD,eAAO,MAAM,sBAAsB;;;;;;iBAMjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1G"}

package/dist/tools/context.js

@@ -0,0 +1,43 @@
+/**
+ * YuiHub MCP Tools - Context Operations
+ * fetch_context, create_checkpoint
+ */
+import { z } from 'zod';
+// --- fetch_context ---
+export const fetchContextSchema = z.object({
+    intent: z.string().optional().describe('Current intent/goal for context retrieval'),
+    session: z.string().optional().describe('Session ID to get context for'),
+});
+export async function fetchContext(client, input) {
+    const packet = await client.exportContext(input.intent, input.session);
+    const memories = packet.long_term_memory.map((m, i) => `[${i + 1}] (relevance: ${m.relevance.toFixed(3)})\n${m.text.slice(0, 200)}${m.text.length > 200 ? '...' : ''}`).join('\n\n');
+    return `Intent: ${packet.intent}
+Session: ${packet.session_id || 'N/A'}
+Mode: ${packet.meta.mode}
+
+Long-term Memory:
+${memories || 'No relevant memories found.'}`;
+}
+// --- create_checkpoint ---
+export const createCheckpointSchema = z.object({
+    session_id: z.string().describe('Session ID to checkpoint'),
+    summary: z.string().describe('Summary of the decision/conclusion'),
+    intent: z.string().describe('Current goal/intent'),
+    working_memory: z.record(z.string(), z.unknown()).optional().describe('Current working memory state'),
+    entry_ids: z.array(z.string()).optional().describe('Related entry IDs'),
+});
+export async function createCheckpoint(client, input) {
+    const checkpoint = await client.createCheckpoint({
+        session_id: input.session_id,
+        summary: input.summary,
+        intent: input.intent,
+        working_memory: input.working_memory,
+        entry_ids: input.entry_ids,
+    });
+    return `Created checkpoint:
+ID: ${checkpoint.id}
+Session: ${checkpoint.session_id}
+Intent: ${checkpoint.intent}
+Created: ${checkpoint.created_at}`;
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wBAAwB;AACxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACnF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACzE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB,EAAE,KAAwB;IAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAChH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,OAAO,WAAW,MAAM,CAAC,MAAM;WACtB,MAAM,CAAC,UAAU,IAAI,KAAK;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI;;;EAGtB,QAAQ,IAAI,6BAA6B,EAAE,CAAC;AAC9C,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrG,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACxE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB,EAAE,KAA4B;IACvF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;QAC/C,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO;MACH,UAAU,CAAC,EAAE;WACR,UAAU,CAAC,UAAU;UACtB,UAAU,CAAC,MAAM;WAChB,UAAU,CAAC,UAAU,EAAE,CAAC;AACnC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YuiHub MCP Tools - Registration
+ * Using Zod v4 native z.toJSONSchema()
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { YuiHubClient } from '../client.js';
+export declare function registerTools(server: Server, client: YuiHubClient): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AASjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwExE"}

package/dist/tools/index.js

@@ -0,0 +1,83 @@
+/**
+ * YuiHub MCP Tools - Registration
+ * Using Zod v4 native z.toJSONSchema()
+ */
+import { z } from 'zod';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { toMCPError } from '../errors.js';
+import { saveThoughtSchema, saveThought } from './memory.js';
+import { searchMemorySchema, searchMemory } from './memory.js';
+import { startSessionSchema, startSession } from './session.js';
+import { fetchContextSchema, fetchContext } from './context.js';
+import { createCheckpointSchema, createCheckpoint } from './context.js';
+export function registerTools(server, client) {
+    // List tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'save_thought',
+                    description: 'Save a thought, memo, or decision to YuiHub memory',
+                    inputSchema: z.toJSONSchema(saveThoughtSchema),
+                },
+                {
+                    name: 'search_memory',
+                    description: 'Search past memories using semantic search',
+                    inputSchema: z.toJSONSchema(searchMemorySchema),
+                },
+                {
+                    name: 'start_session',
+                    description: 'Start a new thinking session/thread',
+                    inputSchema: z.toJSONSchema(startSessionSchema),
+                },
+                {
+                    name: 'fetch_context',
+                    description: 'Fetch context packet for a given intent or session',
+                    inputSchema: z.toJSONSchema(fetchContextSchema),
+                },
+                {
+                    name: 'create_checkpoint',
+                    description: 'Create a decision checkpoint to persist current state',
+                    inputSchema: z.toJSONSchema(createCheckpointSchema),
+                },
+            ],
+        };
+    });
+    // Call tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            switch (name) {
+                case 'save_thought':
+                    result = await saveThought(client, saveThoughtSchema.parse(args));
+                    break;
+                case 'search_memory':
+                    result = await searchMemory(client, searchMemorySchema.parse(args));
+                    break;
+                case 'start_session':
+                    result = await startSession(client, startSessionSchema.parse(args));
+                    break;
+                case 'fetch_context':
+                    result = await fetchContext(client, fetchContextSchema.parse(args));
+                    break;
+                case 'create_checkpoint':
+                    result = await createCheckpoint(client, createCheckpointSchema.parse(args));
+                    break;
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+            return {
+                content: [{ type: 'text', text: result }],
+            };
+        }
+        catch (error) {
+            const mcpError = toMCPError(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${mcpError.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/memory.d.ts

@@ -0,0 +1,26 @@
+/**
+ * YuiHub MCP Tools - Memory Operations
+ * save_thought, search_memory
+ */
+import { z } from 'zod';
+import type { YuiHubClient } from '../client.js';
+export declare const saveThoughtSchema: z.ZodObject<{
+    text: z.ZodString;
+    session_id: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>>;
+}, z.core.$strip>;
+export type SaveThoughtInput = z.infer<typeof saveThoughtSchema>;
+export declare function saveThought(client: YuiHubClient, input: SaveThoughtInput): Promise<string>;
+export declare const searchMemorySchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    session: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SearchMemoryInput = z.infer<typeof searchMemorySchema>;
+export declare function searchMemory(client: YuiHubClient, input: SearchMemoryInput): Promise<string>;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAShG;AAGD,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalG"}

package/dist/tools/memory.js

@@ -0,0 +1,39 @@
+/**
+ * YuiHub MCP Tools - Memory Operations
+ * save_thought, search_memory
+ */
+import { z } from 'zod';
+// --- save_thought ---
+export const saveThoughtSchema = z.object({
+    text: z.string().describe('The thought, memo, or decision to save'),
+    session_id: z.string().describe('Session/Thread ID (th-ULID format)'),
+    tags: z.array(z.string()).optional().describe('Optional tags'),
+    mode: z.enum(['private', 'public']).optional().default('private').describe('Privacy mode'),
+});
+export async function saveThought(client, input) {
+    const result = await client.save([{
+            text: input.text,
+            session_id: input.session_id,
+            tags: input.tags,
+            mode: input.mode,
+        }]);
+    return `Saved ${result.count} entry to session ${input.session_id}`;
+}
+// --- search_memory ---
+export const searchMemorySchema = z.object({
+    query: z.string().describe('Semantic search query'),
+    limit: z.number().optional().default(10).describe('Maximum results'),
+    session: z.string().optional().describe('Filter by session ID'),
+    tag: z.string().optional().describe('Filter by tag'),
+});
+export async function searchMemory(client, input) {
+    const results = await client.search(input.query, input.limit, {
+        session: input.session,
+        tag: input.tag,
+    });
+    if (results.length === 0) {
+        return 'No results found.';
+    }
+    return results.map((r, i) => `[${i + 1}] (score: ${r.score.toFixed(3)})\n${r.text.slice(0, 200)}${r.text.length > 200 ? '...' : ''}`).join('\n\n');
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,uBAAuB;AACvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC3F,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB,EAAE,KAAuB;IAC7E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC,CAAC;IAEJ,OAAO,SAAS,MAAM,CAAC,KAAK,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAAC;AACtE,CAAC;AAED,wBAAwB;AACxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC/D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CACrD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB,EAAE,KAAwB;IAC/E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;QAC5D,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1B,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACxG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC"}

package/dist/tools/session.d.ts

@@ -0,0 +1,12 @@
+/**
+ * YuiHub MCP Tools - Session Operations
+ * start_session
+ */
+import { z } from 'zod';
+import type { YuiHubClient } from '../client.js';
+export declare const startSessionSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StartSessionInput = z.infer<typeof startSessionSchema>;
+export declare function startSession(client: YuiHubClient, input: StartSessionInput): Promise<string>;
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlG"}

package/dist/tools/session.js

@@ -0,0 +1,14 @@
+/**
+ * YuiHub MCP Tools - Session Operations
+ * start_session
+ */
+import { z } from 'zod';
+// --- start_session ---
+export const startSessionSchema = z.object({
+    title: z.string().optional().describe('Optional session title'),
+});
+export async function startSession(client, input) {
+    const session = await client.createThread(input.title);
+    return `Created new session:\nID: ${session.id}\nTitle: ${session.title}\nCreated: ${session.created_at}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wBAAwB;AACxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAChE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB,EAAE,KAAwB;IAC/E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEvD,OAAO,6BAA6B,OAAO,CAAC,EAAE,YAAY,OAAO,CAAC,KAAK,cAAc,OAAO,CAAC,UAAU,EAAE,CAAC;AAC5G,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@yuihub/mcp-server",
+  "version": "1.0.0-beta.1",
+  "description": "YuiHub MCP Server - Protocol Adapter for Semantic Memory",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vemikrs/yuihub.git",
+    "directory": "apps/v1/mcp-server"
+  },
+  "keywords": [
+    "yuihub",
+    "mcp",
+    "semantic-memory",
+    "ai",
+    "agent"
+  ],
+  "bin": {
+    "yuihub-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "dev:stdio": "tsx src/index.ts",
+    "dev:sse": "tsx src/sse-server.ts",
+    "start": "node dist/index.js",
+    "start:sse": "node dist/sse-server.js",
+    "test": "vitest run",
+    "test:integration": "vitest run tests/integration",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@yuihub/core": "workspace:*",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  }
+}