anantham-v2 2.0.0-alpha.1

package/dist/mcp/mcp-registry.js

@@ -0,0 +1,162 @@
+/**
+ * Anantham V2 — MCP Registry
+ *
+ * Authoritative registry managing MCP server configurations, client instances,
+ * capability discovery, and automatic synchronization into ToolRegistry.
+ */
+import { MCPServerConfigSchema, MCPServerRecordSchema, } from "../domain/mcp.js";
+import { MCPClient } from "./mcp-client.js";
+import { MCPToolNormalizer } from "./mcp-tool-normalizer.js";
+import { EventTypes } from "../domain/event.js";
+export class MCPRegistry {
+    servers = new Map();
+    clients = new Map();
+    eventStore;
+    toolNormalizer;
+    constructor(options = {}) {
+        this.eventStore = options.eventStore;
+        this.toolNormalizer = options.toolNormalizer || new MCPToolNormalizer();
+    }
+    /**
+     * Register a new MCP server configuration.
+     */
+    registerServer(config, transportAdapter) {
+        const validatedConfig = MCPServerConfigSchema.parse(config);
+        if (this.servers.has(validatedConfig.id)) {
+            throw new Error(`MCP Server "${validatedConfig.id}" is already registered.`);
+        }
+        const record = MCPServerRecordSchema.parse({
+            config: validatedConfig,
+            connectionState: validatedConfig.enabled ? "disconnected" : "disabled",
+            healthStatus: validatedConfig.enabled ? "healthy" : "disabled",
+            consecutiveFailures: 0,
+            circuitBroken: false,
+        });
+        const client = new MCPClient({
+            config: validatedConfig,
+            transportAdapter,
+            eventStore: this.eventStore,
+        });
+        this.servers.set(validatedConfig.id, record);
+        this.clients.set(validatedConfig.id, client);
+        this.emitEvent(EventTypes.MCP_REGISTERED, {
+            serverId: validatedConfig.id,
+            transport: validatedConfig.transport,
+            projectId: validatedConfig.projectId,
+        });
+        return record;
+    }
+    /**
+     * Unregister an MCP server and disconnect client.
+     */
+    async unregisterServer(serverId) {
+        const client = this.clients.get(serverId);
+        if (client) {
+            await client.disconnect();
+            this.clients.delete(serverId);
+        }
+        const deleted = this.servers.delete(serverId);
+        if (deleted) {
+            this.emitEvent(EventTypes.MCP_DEREGISTERED, { serverId });
+        }
+        return deleted;
+    }
+    getServer(serverId) {
+        return this.servers.get(serverId);
+    }
+    getClient(serverId) {
+        return this.clients.get(serverId);
+    }
+    /**
+     * List servers with optional project-level isolation filtering.
+     */
+    listServers(projectId) {
+        const records = Array.from(this.servers.values());
+        if (!projectId) {
+            return records;
+        }
+        // Return global servers + project-specific servers
+        return records.filter((r) => !r.config.projectId || r.config.projectId === projectId || r.config.projectId === "global");
+    }
+    /**
+     * Enable an existing MCP server.
+     */
+    enableServer(serverId) {
+        const server = this.servers.get(serverId);
+        if (!server) {
+            throw new Error(`MCP Server "${serverId}" not found.`);
+        }
+        server.config.enabled = true;
+        server.connectionState = "disconnected";
+        server.healthStatus = "healthy";
+        return server;
+    }
+    /**
+     * Disable an existing MCP server.
+     */
+    async disableServer(serverId) {
+        const server = this.servers.get(serverId);
+        if (!server) {
+            throw new Error(`MCP Server "${serverId}" not found.`);
+        }
+        server.config.enabled = false;
+        server.connectionState = "disabled";
+        server.healthStatus = "disabled";
+        const client = this.clients.get(serverId);
+        if (client) {
+            await client.disconnect();
+        }
+        return server;
+    }
+    /**
+     * Discover capabilities for an MCP server and update records.
+     */
+    async discoverServer(serverId) {
+        const client = this.clients.get(serverId);
+        const server = this.servers.get(serverId);
+        if (!client || !server) {
+            throw new Error(`MCP Server "${serverId}" not found.`);
+        }
+        const discovery = await client.discover();
+        server.discovery = discovery;
+        server.connectionState = client.getConnectionState();
+        server.healthStatus = client.getHealthStatus();
+        return discovery;
+    }
+    /**
+     * Synchronize discovered tools from an MCP server directly into Anantham ToolRegistry.
+     */
+    async syncToolsToRegistry(serverId, toolRegistry) {
+        const client = this.clients.get(serverId);
+        const server = this.servers.get(serverId);
+        if (!client || !server) {
+            throw new Error(`MCP Server "${serverId}" not found.`);
+        }
+        if (!server.discovery) {
+            await this.discoverServer(serverId);
+        }
+        let count = 0;
+        if (server.discovery?.tools) {
+            for (const tool of server.discovery.tools) {
+                const registration = this.toolNormalizer.normalize(tool, client);
+                toolRegistry.register(registration);
+                count++;
+            }
+        }
+        return count;
+    }
+    emitEvent(type, payload) {
+        if (this.eventStore) {
+            this.eventStore.append({
+                id: `evt_mcp_reg_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+                schemaVersion: 1,
+                projectId: payload.projectId || "global",
+                type,
+                actor: "system",
+                timestamp: new Date().toISOString(),
+                payload,
+            });
+        }
+    }
+}
+//# sourceMappingURL=mcp-registry.js.map

package/dist/mcp/mcp-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../../src/mcp/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAA4B,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOhD,MAAM,OAAO,WAAW;IACL,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvC,UAAU,CAAc;IACxB,cAAc,CAAoB;IAEnD,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,iBAAiB,EAAE,CAAC;IAC1E,CAAC;IAED;;OAEG;IACI,cAAc,CACnB,MAAuB,EACvB,gBAAsC;QAEtC,MAAM,eAAe,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,eAAe,eAAe,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,MAAM,GAAoB,qBAAqB,CAAC,KAAK,CAAC;YAC1D,MAAM,EAAE,eAAe;YACvB,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU;YACtE,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YAC9D,mBAAmB,EAAE,CAAC;YACtB,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,eAAe;YACvB,gBAAgB;YAChB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAE7C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,EAAE;YACxC,QAAQ,EAAE,eAAe,CAAC,EAAE;YAC5B,SAAS,EAAE,eAAe,CAAC,SAAS;YACpC,SAAS,EAAE,eAAe,CAAC,SAAS;SACrC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,SAAS,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAEM,SAAS,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,SAAkB;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,mDAAmD;QACnD,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ,CAClG,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,QAAgB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QAC7B,MAAM,CAAC,eAAe,GAAG,cAAc,CAAC;QACxC,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;QAEhC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CAAC,QAAgB;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QAC9B,MAAM,CAAC,eAAe,GAAG,UAAU,CAAC;QACpC,MAAM,CAAC,YAAY,GAAG,UAAU,CAAC;QAEjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,QAAgB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACrD,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAE/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE,YAA0B;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACjE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACpC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,IAAY,EAAE,OAAgC;QAC9D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBACrB,EAAE,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACzE,aAAa,EAAE,CAAC;gBAChB,SAAS,EAAE,OAAO,CAAC,SAAmB,IAAI,QAAQ;gBAClD,IAAI;gBACJ,KAAK,EAAE,QAAQ;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/mcp/mcp-resource-normalizer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Anantham V2 — MCP Resource Normalizer
+ *
+ * Normalizes discovered MCP resources into authoritative Anantham ContentObject entities,
+ * enforcing content validation, secret scrubbing, and provenance lineage.
+ */
+import { type MCPResource } from "../domain/mcp.js";
+import { type ContentObject } from "../domain/content.js";
+import { type MCPClient } from "./mcp-client.js";
+export declare class MCPResourceNormalizer {
+    /**
+     * Normalizes an MCP resource into an Anantham ContentObject.
+     */
+    normalize(resource: MCPResource, client: MCPClient): Promise<ContentObject>;
+}
+//# sourceMappingURL=mcp-resource-normalizer.d.ts.map

package/dist/mcp/mcp-resource-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource-normalizer.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-resource-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,qBAAqB;IAChC;;OAEG;IACU,SAAS,CACpB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,aAAa,CAAC;CAmD1B"}

package/dist/mcp/mcp-resource-normalizer.js

@@ -0,0 +1,61 @@
+/**
+ * Anantham V2 — MCP Resource Normalizer
+ *
+ * Normalizes discovered MCP resources into authoritative Anantham ContentObject entities,
+ * enforcing content validation, secret scrubbing, and provenance lineage.
+ */
+import { ContentObjectSchema } from "../domain/content.js";
+import crypto from "node:crypto";
+export class MCPResourceNormalizer {
+    /**
+     * Normalizes an MCP resource into an Anantham ContentObject.
+     */
+    async normalize(resource, client) {
+        const rawContent = await client.readResource(resource.uri);
+        const contentText = typeof rawContent === "string"
+            ? rawContent
+            : JSON.stringify(rawContent);
+        const hash = crypto.createHash("sha256").update(contentText).digest("hex");
+        const byteSize = Buffer.byteLength(contentText, "utf8");
+        const now = new Date().toISOString();
+        const contentObject = ContentObjectSchema.parse({
+            id: `cnt_mcp_${resource.serverId}_${crypto.randomUUID().slice(0, 8)}`,
+            kind: "mcp-resource",
+            name: resource.name,
+            mimeType: resource.mimeType || "text/plain",
+            sizeBytes: byteSize,
+            sha256: hash,
+            source: {
+                type: "mcp",
+                uri: `mcp://${resource.serverId}/${resource.uri}`,
+            },
+            representations: [
+                {
+                    id: `rep_${crypto.randomUUID().slice(0, 8)}`,
+                    type: "text",
+                    mimeType: resource.mimeType || "text/plain",
+                    sizeBytes: byteSize,
+                    sha256: hash,
+                    data: contentText,
+                },
+            ],
+            security: {
+                trust: "mcp-content",
+                sensitivity: "normal",
+                scanned: true,
+                authority: "mcp-output",
+            },
+            provenance: {
+                sourceType: "mcp",
+                sourceUri: resource.uri,
+                parentIds: [],
+                capturedAt: now,
+                transformations: [],
+            },
+            createdAt: now,
+            updatedAt: now,
+        });
+        return contentObject;
+    }
+}
+//# sourceMappingURL=mcp-resource-normalizer.js.map

package/dist/mcp/mcp-resource-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource-normalizer.js","sourceRoot":"","sources":["../../src/mcp/mcp-resource-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAsB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACI,KAAK,CAAC,SAAS,CACpB,QAAqB,EACrB,MAAiB;QAEjB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,WAAW,GACf,OAAO,UAAU,KAAK,QAAQ;YAC5B,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAEjC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,aAAa,GAAkB,mBAAmB,CAAC,KAAK,CAAC;YAC7D,EAAE,EAAE,WAAW,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACrE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,YAAY;YAC3C,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK;gBACX,GAAG,EAAE,SAAS,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE;aAClD;YACD,eAAe,EAAE;gBACf;oBACE,EAAE,EAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBAC5C,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,YAAY;oBAC3C,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,WAAW;iBAClB;aACF;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,aAAa;gBACpB,WAAW,EAAE,QAAQ;gBACrB,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,YAAY;aACxB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,QAAQ,CAAC,GAAG;gBACvB,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,GAAG;gBACf,eAAe,EAAE,EAAE;aACpB;YACD,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

package/dist/mcp/mcp-tool-normalizer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Anantham V2 — MCP Tool Normalizer
+ *
+ * Normalizes discovered MCP tools into authoritative Anantham ToolRegistration contracts
+ * so they can be registered in ToolRegistry and executed via ToolGateway with full policy enforcement.
+ */
+import { type MCPTool } from "../domain/mcp.js";
+import { type ToolRegistration } from "../tools/tool-registry.js";
+import { type MCPClient } from "./mcp-client.js";
+export declare class MCPToolNormalizer {
+    /**
+     * Normalizes an MCP tool into an Anantham ToolRegistration.
+     */
+    normalize(tool: MCPTool, client: MCPClient): ToolRegistration;
+}
+//# sourceMappingURL=mcp-tool-normalizer.d.ts.map

package/dist/mcp/mcp-tool-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-normalizer.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-tool-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,iBAAiB;IAC5B;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,gBAAgB;CA2CrE"}

package/dist/mcp/mcp-tool-normalizer.js

@@ -0,0 +1,50 @@
+/**
+ * Anantham V2 — MCP Tool Normalizer
+ *
+ * Normalizes discovered MCP tools into authoritative Anantham ToolRegistration contracts
+ * so they can be registered in ToolRegistry and executed via ToolGateway with full policy enforcement.
+ */
+export class MCPToolNormalizer {
+    /**
+     * Normalizes an MCP tool into an Anantham ToolRegistration.
+     */
+    normalize(tool, client) {
+        const namespacedName = `mcp_${tool.serverId}_${tool.name}`.replace(/[^a-zA-Z0-9_]/g, "_");
+        // Safe parameters schema construction with prototype pollution defense
+        const rawSchema = (tool.inputSchema || {});
+        const safeSchema = {
+            type: "object",
+            properties: {},
+            required: Array.isArray(rawSchema.required) ? rawSchema.required : [],
+        };
+        if (rawSchema.properties && typeof rawSchema.properties === "object") {
+            const props = {};
+            for (const [key, val] of Object.entries(rawSchema.properties)) {
+                if (key === "__proto__" || key === "constructor" || key === "prototype") {
+                    continue;
+                }
+                props[key] = val;
+            }
+            safeSchema.properties = props;
+        }
+        const definition = {
+            name: namespacedName,
+            description: `[MCP: ${tool.serverId}] ${tool.description || tool.name}`,
+            parametersSchema: safeSchema,
+            isIdempotent: Boolean(tool.isIdempotent),
+            riskLevel: tool.riskLevel || "medium",
+            sensitivity: tool.sensitivity || "normal",
+            timeoutMs: tool.timeoutMs || client.config.timeoutMs,
+        };
+        const handler = async (args) => {
+            const safeArgs = (args && typeof args === "object") ? args : {};
+            const result = await client.callTool(tool.name, safeArgs);
+            return result;
+        };
+        return {
+            definition,
+            handler,
+        };
+    }
+}
+//# sourceMappingURL=mcp-tool-normalizer.js.map

package/dist/mcp/mcp-tool-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-normalizer.js","sourceRoot":"","sources":["../../src/mcp/mcp-tool-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,iBAAiB;IAC5B;;OAEG;IACI,SAAS,CAAC,IAAa,EAAE,MAAiB;QAC/C,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAE1F,uEAAuE;QACvE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAwB,CAAC;QAClE,MAAM,UAAU,GAA4B;YAC1C,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;SACtE,CAAC;QAEF,IAAI,SAAS,CAAC,UAAU,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,KAAK,GAA4B,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,UAAqC,CAAC,EAAE,CAAC;gBACzF,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;oBACxE,SAAS;gBACX,CAAC;gBACD,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACnB,CAAC;YACD,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC;QAChC,CAAC;QAED,MAAM,UAAU,GAAa;YAC3B,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,SAAS,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE;YACvE,gBAAgB,EAAE,UAAU;YAC5B,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS;SACrD,CAAC;QAEF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAS,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,OAAO;YACL,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./memory-types.js";
+export * from "./memory-index-manager.js";
+export * from "./memory-retrieval-engine.js";
+export * from "./memory-manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,5 @@
+export * from "./memory-types.js";
+export * from "./memory-index-manager.js";
+export * from "./memory-retrieval-engine.js";
+export * from "./memory-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC"}

package/dist/memory/memory-index-manager.d.ts

@@ -0,0 +1,36 @@
+import type { SqliteEngine } from "../persistence/sqlite-engine.js";
+import type { MemoryItem } from "../domain/memory.js";
+export interface IndexIntegrityReport {
+    isValid: boolean;
+    expectedCount: number;
+    actualCount: number;
+}
+/**
+ * MemoryIndexManager maintains the derived SQLite FTS5 index for full-text search.
+ * INVARIANT: The index is derived state and 100% rebuildable from the authoritative memory_items table.
+ * PRD Part 1 Section 64.
+ */
+export declare class MemoryIndexManager {
+    private readonly engine;
+    constructor(engine: SqliteEngine);
+    /**
+     * Indexes a single MemoryItem into the FTS5 virtual table.
+     */
+    indexItem(item: MemoryItem): void;
+    /**
+     * Removes a MemoryItem from the FTS5 index.
+     */
+    removeItem(id: string): void;
+    /**
+     * Drops all FTS entries and re-indexes all records from the authoritative memory_items table.
+     * INVARIANT 2: Rebuildability guaranteed.
+     */
+    rebuildIndex(): {
+        indexedCount: number;
+    };
+    /**
+     * Verifies that the FTS index count matches the authoritative SQLite memory table count.
+     */
+    verifyIndexIntegrity(): IndexIntegrityReport;
+}
+//# sourceMappingURL=memory-index-manager.d.ts.map

package/dist/memory/memory-index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-index-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-index-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAoBxC;;OAEG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKnC;;;OAGG;IACI,YAAY,IAAI;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;IAsD/C;;OAEG;IACI,oBAAoB,IAAI,oBAAoB;CAgBpD"}

package/dist/memory/memory-index-manager.js

@@ -0,0 +1,85 @@
+/**
+ * MemoryIndexManager maintains the derived SQLite FTS5 index for full-text search.
+ * INVARIANT: The index is derived state and 100% rebuildable from the authoritative memory_items table.
+ * PRD Part 1 Section 64.
+ */
+export class MemoryIndexManager {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Indexes a single MemoryItem into the FTS5 virtual table.
+     */
+    indexItem(item) {
+        // Delete any existing FTS entry for this ID first
+        this.removeItem(item.id);
+        const stmt = this.engine.raw.prepare(`
+      INSERT INTO memory_fts (id, content, tags, type, scope, project_id, session_id)
+      VALUES (?, ?, ?, ?, ?, ?, ?);
+    `);
+        stmt.run(item.id, item.content, item.tags ? item.tags.join(" ") : "", item.type, item.scope, item.projectId ?? null, item.sessionId ?? null);
+    }
+    /**
+     * Removes a MemoryItem from the FTS5 index.
+     */
+    removeItem(id) {
+        const stmt = this.engine.raw.prepare("DELETE FROM memory_fts WHERE id = ?;");
+        stmt.run(id);
+    }
+    /**
+     * Drops all FTS entries and re-indexes all records from the authoritative memory_items table.
+     * INVARIANT 2: Rebuildability guaranteed.
+     */
+    rebuildIndex() {
+        return this.engine.transaction(() => {
+            // 1. Wipe FTS index
+            this.engine.raw.exec("DELETE FROM memory_fts;");
+            // 2. Fetch all authoritative items
+            const stmt = this.engine.raw.prepare(`
+        SELECT id, content, tags_json, type, scope, project_id, session_id
+        FROM memory_items;
+      `);
+            const rows = stmt.all();
+            // 3. Batch insert into FTS
+            const insertStmt = this.engine.raw.prepare(`
+        INSERT INTO memory_fts (id, content, tags, type, scope, project_id, session_id)
+        VALUES (?, ?, ?, ?, ?, ?, ?);
+      `);
+            let count = 0;
+            for (const row of rows) {
+                let tagsStr = "";
+                if (row.tags_json) {
+                    try {
+                        const tags = JSON.parse(row.tags_json);
+                        if (Array.isArray(tags))
+                            tagsStr = tags.join(" ");
+                    }
+                    catch {
+                        // Ignore parse errors on tags
+                    }
+                }
+                insertStmt.run(row.id, row.content, tagsStr, row.type, row.scope, row.project_id, row.session_id);
+                count++;
+            }
+            return { indexedCount: count };
+        });
+    }
+    /**
+     * Verifies that the FTS index count matches the authoritative SQLite memory table count.
+     */
+    verifyIndexIntegrity() {
+        const authorCountStmt = this.engine.raw.prepare("SELECT COUNT(*) AS count FROM memory_items;");
+        const authorRow = authorCountStmt.get();
+        const ftsCountStmt = this.engine.raw.prepare("SELECT COUNT(*) AS count FROM memory_fts;");
+        const ftsRow = ftsCountStmt.get();
+        const expected = Number(authorRow.count);
+        const actual = Number(ftsRow.count);
+        return {
+            isValid: expected === actual,
+            expectedCount: expected,
+            actualCount: actual,
+        };
+    }
+}
+//# sourceMappingURL=memory-index-manager.js.map

package/dist/memory/memory-index-manager.js.map

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

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,21 @@
+import { type MemoryItem } from "../domain/memory.js";
+import type { SqliteEngine } from "../persistence/sqlite-engine.js";
+import type { EventStore } from "../event-state/event-store.js";
+export declare class MemoryManager {
+    private readonly engine;
+    private readonly memoryRepo;
+    private readonly indexManager;
+    private readonly eventStore;
+    constructor(engine: SqliteEngine, eventStore: EventStore);
+    /**
+     * Persists a validated MemoryItem to SQLite, synchronizes the FTS5 index,
+     * and appends a memory.written event to the EventStore.
+     * PRD Part 1 Section 63.
+     */
+    saveMemory(item: MemoryItem): Promise<MemoryItem>;
+    /**
+     * Deletes a memory item from repository and FTS index, and emits memory.deleted event.
+     */
+    deleteMemory(id: string): Promise<boolean>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU;IAOxD;;;;OAIG;IACU,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC9D;;OAEG;IACU,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAyBxD"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,76 @@
+import { randomUUID } from "node:crypto";
+import { MemoryItemSchema } from "../domain/memory.js";
+import { EventTypes } from "../domain/event.js";
+import { MemoryRepository } from "../persistence/repositories/memory-repository.js";
+import { MemoryIndexManager } from "./memory-index-manager.js";
+export class MemoryManager {
+    engine;
+    memoryRepo;
+    indexManager;
+    eventStore;
+    constructor(engine, eventStore) {
+        this.engine = engine;
+        this.memoryRepo = new MemoryRepository(engine);
+        this.indexManager = new MemoryIndexManager(engine);
+        this.eventStore = eventStore;
+    }
+    /**
+     * Persists a validated MemoryItem to SQLite, synchronizes the FTS5 index,
+     * and appends a memory.written event to the EventStore.
+     * PRD Part 1 Section 63.
+     */
+    async saveMemory(item) {
+        const validated = MemoryItemSchema.parse(item);
+        // 1. Transactionally persist item and index in SQLite
+        this.engine.transaction(() => {
+            this.memoryRepo.save(validated);
+            this.indexManager.indexItem(validated);
+        });
+        // 2. Append event to EventStore
+        const event = {
+            id: `evt_mem_${randomUUID().slice(0, 12)}`,
+            schemaVersion: 1,
+            projectId: validated.projectId,
+            sessionId: validated.sessionId,
+            type: EventTypes.MEMORY_WRITTEN,
+            actor: "system",
+            timestamp: new Date().toISOString(),
+            payload: {
+                memoryId: validated.id,
+                scope: validated.scope,
+                type: validated.type,
+                priority: validated.priority,
+                confidence: validated.confidence,
+                sensitivity: validated.sensitivity,
+            },
+        };
+        this.eventStore.append(event);
+        return Object.freeze(validated);
+    }
+    /**
+     * Deletes a memory item from repository and FTS index, and emits memory.deleted event.
+     */
+    async deleteMemory(id) {
+        const existing = this.memoryRepo.findById(id);
+        if (!existing) {
+            return false;
+        }
+        this.engine.transaction(() => {
+            this.memoryRepo.delete(id);
+            this.indexManager.removeItem(id);
+        });
+        const event = {
+            id: `evt_mem_del_${randomUUID().slice(0, 12)}`,
+            schemaVersion: 1,
+            projectId: existing.projectId,
+            sessionId: existing.sessionId,
+            type: EventTypes.MEMORY_DELETED,
+            actor: "system",
+            timestamp: new Date().toISOString(),
+            payload: { memoryId: id },
+        };
+        this.eventStore.append(event);
+        return true;
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/memory/memory-retrieval-engine.d.ts

@@ -0,0 +1,20 @@
+import type { SqliteEngine } from "../persistence/sqlite-engine.js";
+import type { CandidateContextItem } from "../context/context-engine.js";
+import { type MemorySearchQuery, type MemorySearchResult } from "./memory-types.js";
+export declare class MemoryRetrievalEngine {
+    private readonly engine;
+    private readonly memoryRepo;
+    constructor(engine: SqliteEngine);
+    /**
+     * Performs deterministic, scoped search across memory items using SQLite FTS5.
+     * Enforces strict Project boundary isolation and sensitivity controls.
+     * PRD Part 1 Section 64 & PRD Part 3 Section 139.
+     */
+    search(query: MemorySearchQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Transforms MemorySearchResult items into CandidateContextItem objects for ContextEngine.
+     * INVARIANT 3 & 4: Memory is data, not policy. Retains untrusted authority.
+     */
+    asCandidateContextItems(results: MemorySearchResult[]): CandidateContextItem[];
+}
+//# sourceMappingURL=memory-retrieval-engine.d.ts.map

package/dist/memory/memory-retrieval-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retrieval-engine.d.ts","sourceRoot":"","sources":["../../src/memory/memory-retrieval-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;gBAElC,MAAM,EAAE,YAAY;IAKhC;;;;OAIG;IACU,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAuH5E;;;OAGG;IACI,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,oBAAoB,EAAE;CAqBtF"}