@synthaer/resonance 0.1.0

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0MjD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuKhF"}

package/dist/server.js

@@ -0,0 +1,297 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { handleStoreKnowledge, handleRecallKnowledge, handleSemanticSearch, handleEndorseKnowledge, handleChallengeKnowledge, } from './tools/knowledge.js';
+import { handleStoreExperience, handleRecallExperiences, } from './tools/experiences.js';
+import { handleSessionResume, handleMemoryCheckpoint, } from './tools/sessions.js';
+import { handleGetTrust, handleUpdateTrust, } from './tools/trust.js';
+import { isCloudOnlyTool, cloudRequiredError, CLOUD_ONLY_TOOL_DEFINITIONS, } from './tools/cloud-gate.js';
+const VERSION = '0.1.0';
+const DIKW_STAGES = ['nascent', 'emerging', 'established', 'canonical'];
+const LOCAL_TOOLS = [
+    {
+        name: 'store_knowledge',
+        description: 'Store a knowledge item with local embedding generation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'The knowledge content to store' },
+                kind: { type: 'string', enum: ['fact', 'pattern', 'error', 'decision', 'principle'], description: 'Knowledge type' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
+                context: { type: 'object', description: 'Additional context metadata' },
+                project: { type: 'string', description: 'Project identifier' },
+                sourceAgent: { type: 'string', description: 'Agent that produced this knowledge' },
+                dikwStage: { type: 'string', enum: [...DIKW_STAGES], description: 'DIKW maturation stage' },
+                importance: { type: 'number', description: 'Importance/strength score (0-1)' },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'recall_knowledge',
+        description: 'Retrieve a specific knowledge item by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Knowledge item ID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'semantic_search',
+        description: 'Search knowledge using vector similarity (pgvector) with ILIKE fallback.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query text' },
+                limit: { type: 'number', description: 'Max results (default 20)' },
+                project: { type: 'string', description: 'Filter by project' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
+                minStrength: { type: 'number', description: 'Minimum strength threshold' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'endorse_knowledge',
+        description: 'Record an endorsement for a knowledge item, increasing its trust score.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Knowledge item ID to endorse' },
+                agent: { type: 'string', description: 'Endorsing agent ID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'challenge_knowledge',
+        description: 'Record a challenge against a knowledge item, decreasing its trust score.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Knowledge item ID to challenge' },
+                reason: { type: 'string', description: 'Reason for the challenge' },
+                agent: { type: 'string', description: 'Challenging agent ID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'store_experience',
+        description: 'Store an agent experience record.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'Experience content' },
+                kind: { type: 'string', enum: ['success', 'failure', 'discovery', 'blocker'], description: 'Experience type' },
+                agentId: { type: 'string', description: 'Agent ID' },
+                sessionId: { type: 'string', description: 'Session ID' },
+                project: { type: 'string', description: 'Project identifier' },
+                tags: { type: 'array', items: { type: 'string' } },
+                relatedKnowledgeIds: { type: 'array', items: { type: 'string' } },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'recall_experiences',
+        description: 'Search experiences using vector similarity or keyword matching.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query' },
+                limit: { type: 'number', description: 'Max results (default 20)' },
+                project: { type: 'string', description: 'Filter by project' },
+                agentId: { type: 'string', description: 'Filter by agent' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'session_resume',
+        description: 'Resume or create a session for an agent/project pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'Agent identifier' },
+                projectId: { type: 'string', description: 'Project identifier' },
+            },
+            required: ['agentId', 'projectId'],
+        },
+    },
+    {
+        name: 'memory_checkpoint',
+        description: 'Persist a checkpoint for a session memory thread.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: { type: 'string', description: 'Session ID to checkpoint' },
+            },
+            required: ['sessionId'],
+        },
+    },
+    {
+        name: 'get_trust',
+        description: 'Get trust score and endorsement/challenge counts for a knowledge item.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Knowledge item ID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'update_trust',
+        description: 'Manually adjust the trust score for a knowledge item.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Knowledge item ID' },
+                adjustment: { type: 'number', description: 'Trust score adjustment (-1.0 to 1.0)' },
+                reason: { type: 'string', description: 'Reason for adjustment' },
+            },
+            required: ['id', 'adjustment'],
+        },
+    },
+    {
+        name: 'health',
+        description: 'Return health status, mode, and knowledge counts.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+function textResult(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+    };
+}
+function errorResult(message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+export async function startServer(options) {
+    const { db, embedder, mode, dataDir } = options;
+    const server = new Server({ name: 'Resonance', version: VERSION }, { capabilities: { tools: {} } });
+    // Register all tools (local + cloud-gated)
+    const allTools = [...LOCAL_TOOLS, ...CLOUD_ONLY_TOOL_DEFINITIONS];
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: allTools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const params = (args ?? {});
+        try {
+            // Cloud-gated tools return upgrade guidance in local mode
+            if (isCloudOnlyTool(name) && mode === 'local') {
+                return cloudRequiredError(name);
+            }
+            switch (name) {
+                case 'store_knowledge':
+                    return textResult(await handleStoreKnowledge(db, embedder, {
+                        content: params['content'],
+                        kind: params['kind'],
+                        tags: params['tags'],
+                        context: params['context'],
+                        project: params['project'],
+                        sourceAgent: params['sourceAgent'],
+                        dikwStage: params['dikwStage'],
+                        importance: params['importance'],
+                    }));
+                case 'recall_knowledge':
+                    return textResult(await handleRecallKnowledge(db, {
+                        id: params['id'],
+                    }));
+                case 'semantic_search':
+                    return textResult(await handleSemanticSearch(db, embedder, {
+                        query: params['query'],
+                        limit: params['limit'],
+                        project: params['project'],
+                        tags: params['tags'],
+                        minStrength: params['minStrength'],
+                    }));
+                case 'endorse_knowledge':
+                    return textResult(await handleEndorseKnowledge(db, {
+                        id: params['id'],
+                        agent: params['agent'],
+                    }));
+                case 'challenge_knowledge':
+                    return textResult(await handleChallengeKnowledge(db, {
+                        id: params['id'],
+                        reason: params['reason'],
+                        agent: params['agent'],
+                    }));
+                case 'store_experience':
+                    return textResult(await handleStoreExperience(db, embedder, {
+                        content: params['content'],
+                        kind: params['kind'],
+                        agentId: params['agentId'],
+                        sessionId: params['sessionId'],
+                        project: params['project'],
+                        tags: params['tags'],
+                        relatedKnowledgeIds: params['relatedKnowledgeIds'],
+                    }));
+                case 'recall_experiences':
+                    return textResult(await handleRecallExperiences(db, embedder, {
+                        query: params['query'],
+                        limit: params['limit'],
+                        project: params['project'],
+                        agentId: params['agentId'],
+                    }));
+                case 'session_resume':
+                    return textResult(await handleSessionResume(db, {
+                        agentId: params['agentId'],
+                        projectId: params['projectId'],
+                    }));
+                case 'memory_checkpoint':
+                    return textResult(await handleMemoryCheckpoint(db, {
+                        sessionId: params['sessionId'],
+                    }));
+                case 'get_trust':
+                    return textResult(await handleGetTrust(db, {
+                        id: params['id'],
+                    }));
+                case 'update_trust':
+                    return textResult(await handleUpdateTrust(db, {
+                        id: params['id'],
+                        adjustment: params['adjustment'],
+                        reason: params['reason'],
+                    }));
+                case 'health': {
+                    const knowledgeCount = await db.query(`SELECT COUNT(*) as count FROM knowledge`);
+                    const experienceCount = await db.query(`SELECT COUNT(*) as count FROM experiences`);
+                    const sessionCount = await db.query(`SELECT COUNT(*) as count FROM sessions`);
+                    return textResult({
+                        status: 'ok',
+                        mode,
+                        version: VERSION,
+                        dataDir,
+                        embeddingModel: embedder?.ready ? 'all-MiniLM-L6-v2' : 'not loaded',
+                        embeddingDimensions: embedder?.dimensions ?? 384,
+                        counts: {
+                            knowledge: Number(knowledgeCount.rows[0]?.count ?? 0),
+                            experiences: Number(experienceCount.rows[0]?.count ?? 0),
+                            sessions: Number(sessionCount.rows[0]?.count ?? 0),
+                        },
+                        tools: allTools.length,
+                    });
+                }
+                default:
+                    return errorResult(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,77 @@
+import crypto from 'node:crypto';
+import type { IAsyncDatabase } from './db-types.js';
+import type { KnowledgeItem, Experience, SessionContext, MemoryItem, SearchOptions, MaturationLogEntry, DikwStage } from './types.js';
+export declare class ResonanceStore {
+    private db;
+    private userId;
+    private enforceMultiTenant;
+    private authToken;
+    private encryptionKey;
+    /** The user's plan tier — determines knowledge limits */
+    private planTier;
+    /** The effective limit from the server (plan tier + add-on packs from invoice) */
+    private serverProvidedLimit;
+    /** The highest effective limit ever seen — existing knowledge stays forever */
+    private highWaterLimit;
+    /** Whether the subscription is currently active (cloud confirms this) */
+    private subscriptionActive;
+    /** Local Ed25519 signing key for experiences and knowledge */
+    localSigningKey: crypto.KeyObject | null;
+    /** Fingerprint of the local signing key */
+    localFingerprint: string | null;
+    constructor(db: IAsyncDatabase, userId?: string, enforceMultiTenant?: boolean, authToken?: string | null);
+    /**
+     * Set the account status from the cloud server.
+     * The server provides the REAL limit based on plan tier + add-on packs
+     * from the user's current invoice items. We cache it locally for
+     * offline use.
+     *
+     * @param tier - The plan tier name
+     * @param active - Whether the subscription is currently active
+     * @param effectiveLimit - The REAL limit from the server (tier base + add-on packs)
+     */
+    setAccountStatus(tier: string, active: boolean, effectiveLimit: number): void;
+    /** Get the current knowledge limit — from server if available, fallback to offline default */
+    get knowledgeLimit(): number;
+    /** Whether this user can add new knowledge (requires active subscription) */
+    get canAddKnowledge(): boolean;
+    /** Whether this user can read existing knowledge (always yes — stays local forever) */
+    get canReadKnowledge(): boolean;
+    /** Set the local signing key for experience and knowledge signatures */
+    setSigningKey(privateKey: crypto.KeyObject, fingerprint: string): void;
+    forUser(userId: string): ResonanceStore;
+    /** Update the auth token (and derived encryption key) at runtime. */
+    setAuthToken(token: string | null): void;
+    /** Check whether knowledge operations are available (requires auth). */
+    get knowledgeEnabled(): boolean;
+    private requireAuth;
+    private getKnowledgeCount;
+    private enforceKnowledgeLimit;
+    private decryptKnowledgeRow;
+    setUserContext(): Promise<void>;
+    storeKnowledge(item: Omit<KnowledgeItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<string>;
+    getKnowledge(id: string): Promise<KnowledgeItem | undefined>;
+    updateKnowledge(id: string, updates: Partial<KnowledgeItem>): Promise<void>;
+    deleteKnowledge(id: string): Promise<void>;
+    listKnowledge(options?: {
+        limit?: number;
+        kind?: number;
+        projectId?: string;
+    }): Promise<KnowledgeItem[]>;
+    getAllKnowledge(): Promise<KnowledgeItem[]>;
+    recallKnowledge(query: string, options?: SearchOptions): Promise<KnowledgeItem[]>;
+    storeExperience(exp: Omit<Experience, 'id' | 'createdAt'>): Promise<string>;
+    getExperience(id: string): Promise<Experience | undefined>;
+    updateExperience(id: string, updates: Partial<Omit<Experience, 'id' | 'createdAt'>>): Promise<void>;
+    deleteExperience(id: string): Promise<void>;
+    getAllExperiences(): Promise<Experience[]>;
+    recallExperiences(query: string, options?: SearchOptions): Promise<Experience[]>;
+    sessionResume(agentId: string, projectId: string): Promise<SessionContext>;
+    memoryAppend(sessionId: string, item: MemoryItem): Promise<void>;
+    memoryCheckpoint(sessionId: string): Promise<void>;
+    logMaturation(knowledgeId: string, fromStage: DikwStage, toStage: DikwStage, reason: string, triggeredBy: 'auto' | 'human'): Promise<void>;
+    getMaturationLog(knowledgeId: string): Promise<MaturationLogEntry[]>;
+    private searchCache;
+    private sessionById;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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