@hailer/mcp 1.1.12 → 1.1.13

package/dist/plugins/vipunen/config/schema-config.json

@@ -0,0 +1,19 @@
+{
+    "vectorizer": "none",
+    "properties": [
+        { "name": "artifact_type", "dataType": ["text"], "description": "One of: hook, agent, claude-md, pointer, skill" },
+        { "name": "artifact_name", "dataType": ["text"], "description": "Unique artifact identifier" },
+        { "name": "install_tier", "dataType": ["text"], "description": "One of: user, repo" },
+        { "name": "target_path", "dataType": ["text"], "description": "Relative install path from target root" },
+        { "name": "content", "dataType": ["text"], "description": "Complete deployable artifact content" },
+        { "name": "version", "dataType": ["text"], "description": "Semver version of this artifact" },
+        { "name": "dependencies", "dataType": ["text"], "description": "Comma-separated artifact_names this depends on" },
+        { "name": "project_types", "dataType": ["text"], "description": "Comma-separated project types this applies to (empty = all)" },
+        { "name": "placeholders", "dataType": ["text"], "description": "Comma-separated <TOKEN> names in content" },
+        { "name": "description", "dataType": ["text"], "description": "Human-readable summary of this artifact" },
+        { "name": "tags", "dataType": ["text"], "description": "Comma-separated keywords" },
+        { "name": "install_instructions", "dataType": ["text"], "description": "Natural language instructions for Claude: how to install, register, and uninstall this artifact" },
+        { "name": "created_by", "dataType": ["text"], "description": "Identity of creator" },
+        { "name": "verified_by", "dataType": ["text"], "description": "Identity of verifier or null" }
+    ]
+}

package/dist/plugins/vipunen/config/schema-doc.json

@@ -0,0 +1,22 @@
+{
+    "vectorizer": "text2vec-transformers",
+    "moduleConfig": {
+        "text2vec-transformers": {
+            "vectorizeClassName": false
+        }
+    },
+    "properties": [
+        { "name": "scope", "dataType": ["text"], "description": "System or product within this collection", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "topic", "dataType": ["text"], "description": "Specific aspect within scope", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "title", "dataType": ["text"], "description": "Descriptive searchable chunk title" },
+        { "name": "content", "dataType": ["text"], "description": "The actual chunk text" },
+        { "name": "source_file", "dataType": ["text"], "description": "Path to original source document", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "source_section", "dataType": ["text"], "description": "Heading breadcrumb from source", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "doc_type", "dataType": ["text"], "description": "One of: reference, tutorial, api, conceptual, configuration", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "tags", "dataType": ["text"], "description": "Comma-separated keywords" },
+        { "name": "chunk_index", "dataType": ["int"], "description": "Position in sequence within topic", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "total_chunks", "dataType": ["int"], "description": "Total chunks in this topic", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "created_by", "dataType": ["text"], "description": "Identity of creator (agent name, user ID, or API key alias)", "moduleConfig": { "text2vec-transformers": { "skip": true } } },
+        { "name": "verified_by", "dataType": ["text"], "description": "Identity of verifier (night-owl tier, username) or null", "moduleConfig": { "text2vec-transformers": { "skip": true } } }
+    ]
+}

package/dist/plugins/vipunen/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Vipunen Plugin — Weaviate RAG Knowledge Base
+ *
+ * Provides tools for querying and managing vectorized documentation.
+ * Conditionally registered: only active when weaviateHost is provided.
+ *
+ * Auth model:
+ * - Server authenticates to Weaviate with a single WEAVIATE_API_KEY (env var).
+ * - Clients authenticate to MCP with their own API keys (VIPUNEN_API_KEYS env var).
+ * - Each client key belongs to a group: admin, dev, or readonly.
+ * - Groups control what operations and collections are accessible.
+ */
+import { Tool } from '../../mcp/tool-registry';
+import { VipunenGroup, VipunenContext } from './tools';
+export interface VipunenPluginOptions {
+    weaviateHost?: string;
+    weaviateApiKey?: string;
+    vipunenApiKeys?: Record<string, VipunenGroup>;
+}
+/**
+ * Register Vipunen tools if weaviateHost is provided.
+ * Returns the tools array (empty if not configured).
+ */
+export declare function registerVipunenTools(options?: VipunenPluginOptions): Tool[];
+/**
+ * Resolve a client API key to a VipunenContext with group.
+ * Throws if the key is not recognized.
+ */
+export declare function resolveVipunenContext(apiKey: string): VipunenContext;
+/**
+ * Check if a Vipunen API key is valid (exists in the configured key map).
+ */
+export declare function isValidVipunenKey(apiKey: string): boolean;
+/**
+ * Reset plugin state — for tests only.
+ */
+export declare function resetVipunenPlugin(): void;
+export { WeaviateClient, WeaviateAuthError } from './client';
+export { createVipunenTools } from './tools';
+export type { VipunenGroup, VipunenContext } from './tools';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/vipunen/index.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Vipunen Plugin — Weaviate RAG Knowledge Base
+ *
+ * Provides tools for querying and managing vectorized documentation.
+ * Conditionally registered: only active when weaviateHost is provided.
+ *
+ * Auth model:
+ * - Server authenticates to Weaviate with a single WEAVIATE_API_KEY (env var).
+ * - Clients authenticate to MCP with their own API keys (VIPUNEN_API_KEYS env var).
+ * - Each client key belongs to a group: admin, dev, or readonly.
+ * - Groups control what operations and collections are accessible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVipunenTools = exports.WeaviateAuthError = exports.WeaviateClient = void 0;
+exports.registerVipunenTools = registerVipunenTools;
+exports.resolveVipunenContext = resolveVipunenContext;
+exports.isValidVipunenKey = isValidVipunenKey;
+exports.resetVipunenPlugin = resetVipunenPlugin;
+const client_1 = require("./client");
+const tools_1 = require("./tools");
+const logger_1 = require("../../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'vipunen-plugin' });
+let activeClient = null;
+let apiKeyMap = {};
+/**
+ * Register Vipunen tools if weaviateHost is provided.
+ * Returns the tools array (empty if not configured).
+ */
+function registerVipunenTools(options) {
+    const host = options?.weaviateHost;
+    if (!host) {
+        logger.debug('Vipunen plugin not activated (no weaviateHost)');
+        return [];
+    }
+    if (activeClient) {
+        throw new Error('Vipunen plugin already registered — call resetVipunenPlugin() before re-registering');
+    }
+    const client = new client_1.WeaviateClient({
+        host,
+        apiKey: options?.weaviateApiKey,
+    });
+    activeClient = client;
+    // Store the API key → group mapping (validated by Zod in config.ts)
+    apiKeyMap = Object.freeze({ ...(options?.vipunenApiKeys ?? {}) });
+    const keyCount = Object.keys(apiKeyMap).length;
+    if (keyCount === 0) {
+        logger.warn('Vipunen plugin activated with NO client API keys — all requests will be rejected');
+    }
+    const tools = (0, tools_1.createVipunenTools)(client);
+    logger.info('Vipunen plugin activated', {
+        toolCount: tools.length,
+        tools: tools.map(t => t.name),
+        clientKeys: keyCount,
+        groups: [...new Set(Object.values(apiKeyMap))],
+    });
+    return tools;
+}
+/**
+ * Resolve a client API key to a VipunenContext with group.
+ * Throws if the key is not recognized.
+ */
+function resolveVipunenContext(apiKey) {
+    const group = apiKeyMap[apiKey];
+    if (!group) {
+        throw new Error('Invalid Vipunen API key');
+    }
+    return { group };
+}
+/**
+ * Check if a Vipunen API key is valid (exists in the configured key map).
+ */
+function isValidVipunenKey(apiKey) {
+    return apiKey in apiKeyMap;
+}
+/**
+ * Reset plugin state — for tests only.
+ */
+function resetVipunenPlugin() {
+    activeClient = null;
+    apiKeyMap = {};
+}
+var client_2 = require("./client");
+Object.defineProperty(exports, "WeaviateClient", { enumerable: true, get: function () { return client_2.WeaviateClient; } });
+Object.defineProperty(exports, "WeaviateAuthError", { enumerable: true, get: function () { return client_2.WeaviateAuthError; } });
+var tools_2 = require("./tools");
+Object.defineProperty(exports, "createVipunenTools", { enumerable: true, get: function () { return tools_2.createVipunenTools; } });
+//# sourceMappingURL=index.js.map

package/dist/plugins/vipunen/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Vipunen Tools — Weaviate RAG Knowledge Base
+ *
+ * Tools for querying and managing vectorized documentation in Weaviate.
+ * All tools use contextType: 'none' — they don't need Hailer authentication.
+ *
+ * Auth model:
+ * - Server authenticates to Weaviate with a single WEAVIATE_API_KEY
+ * - Clients authenticate to MCP with their own API keys (VIPUNEN_API_KEYS)
+ * - Each client key belongs to a group: admin, dev, or readonly
+ * - Groups control what operations and collections are accessible
+ *
+ * Permission tiers:
+ * - readonly: 5 tools (query, find-similar, list-sources, count, filter)
+ * - dev: 8 tools (readonly + insert-one, update-chunks, delete-source) — no VipunenConfig writes
+ * - admin: 13 tools (dev + get-schema, export, batch-insert, create-collection, delete-collection)
+ */
+import { Tool } from '../../mcp/tool-registry';
+import { WeaviateClient } from './client';
+export type VipunenGroup = 'admin' | 'dev' | 'readonly';
+/** Execution context passed to each tool — resolved by the plugin from the client's API key */
+export interface VipunenContext {
+    group: VipunenGroup;
+}
+export declare function createVipunenTools(client: WeaviateClient): Tool[];
+//# sourceMappingURL=tools.d.ts.map