@agentvault/agentvault 0.14.30 → 0.15.0

package/dist/mcp-handlers.js

@@ -0,0 +1,48 @@
+/**
+ * Create an HTTP request handler for MCP routes.
+ *
+ * Routes:
+ *   POST /mcp  — MCP Streamable HTTP messages
+ *   GET  /mcp  — MCP SSE stream (for server-initiated messages)
+ *   DELETE /mcp — Close MCP session
+ *
+ * All other paths are passed through to the next handler.
+ */
+export function createMcpHandler(mcpServer, basePath = "/mcp") {
+    return (req, res, next) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+        const pathname = url.pathname;
+        // Only handle requests to the MCP path
+        if (!pathname.startsWith(basePath)) {
+            if (next)
+                next();
+            return;
+        }
+        if (!mcpServer) {
+            res.writeHead(503, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "MCP server not initialized" }));
+            return;
+        }
+        // Delegate to the MCP server
+        mcpServer.handleRequest(req, res).catch((err) => {
+            console.error("[MCP] Request handling error:", err);
+            if (!res.headersSent) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Internal MCP error" }));
+            }
+        });
+    };
+}
+/**
+ * Build a status object with MCP info for the /status endpoint.
+ */
+export function getMcpStatus(mcpServer) {
+    if (!mcpServer) {
+        return { mcp_enabled: false, mcp_skills_count: 0 };
+    }
+    return {
+        mcp_enabled: true,
+        mcp_skills_count: mcpServer.skillCount,
+    };
+}
+//# sourceMappingURL=mcp-handlers.js.map

package/dist/mcp-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-handlers.js","sourceRoot":"","sources":["../src/mcp-handlers.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAqC,EACrC,WAAmB,MAAM;IAEzB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QACjF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,uCAAuC;QACvC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACvD,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAqC;IAErC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,SAAS,CAAC,UAAU;KACvC,CAAC;AACJ,CAAC"}

package/dist/mcp-server.js

@@ -0,0 +1,192 @@
+/**
+ * AgentVault MCP Server — serves agent skills as MCP tools.
+ *
+ * Uses Streamable HTTP transport mounted on the plugin's HTTP server.
+ * Auth: SPT Bearer tokens validated via POST /capabilities/introspect.
+ *
+ * Design:
+ * - One McpServer instance is created at startup and skills are registered as tools.
+ * - Each incoming HTTP request creates a fresh StreamableHTTPServerTransport (stateless mode).
+ * - After the transport handles the request, close() is called so the server can
+ *   accept the next connection (Protocol enforces single-transport at a time).
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+/* -------------------------------------------------------------------------- */
+/*  AgentVaultMcpServer                                                        */
+/* -------------------------------------------------------------------------- */
+export class AgentVaultMcpServer {
+    server;
+    skills = new Map();
+    opts;
+    initialized = false;
+    constructor(opts) {
+        this.opts = opts;
+        this.server = new McpServer({
+            name: `agentvault-${opts.agentName}`,
+            version: "1.0.0",
+        });
+    }
+    /* ---- Skill registration ------------------------------------------------ */
+    /**
+     * Register a skill that will be exposed as an MCP tool.
+     * Must be called *before* `initialize()`.
+     */
+    registerSkill(skill) {
+        this.skills.set(skill.name, skill);
+    }
+    /**
+     * Register all skills as MCP tools / resources / prompts.
+     * Called lazily on first request if not called explicitly.
+     */
+    initialize() {
+        if (this.initialized)
+            return;
+        for (const [name, skill] of this.skills) {
+            this.registerToolForSkill(name, skill);
+        }
+        // Registry resource — lists all registered skills as JSON.
+        this.server.resource("skills-registry", "skills://registry", { description: "List of all registered agent skills", mimeType: "application/json" }, async () => {
+            const registry = Array.from(this.skills.values()).map((s) => ({
+                name: s.name,
+                version: s.version,
+                description: s.description,
+                tags: s.tags,
+                sla: s.slaDefinition,
+                hasSchema: !!s.inputSchema,
+                hasInstructions: !!s.instructions,
+            }));
+            return {
+                contents: [{
+                        uri: "skills://registry",
+                        mimeType: "application/json",
+                        text: JSON.stringify(registry, null, 2),
+                    }],
+            };
+        });
+        // Skills that carry instructions are also surfaced as MCP prompts.
+        for (const [name, skill] of this.skills) {
+            if (skill.instructions) {
+                this.server.prompt(name, skill.description ?? `Instructions for ${name}`, () => ({
+                    messages: [{
+                            role: "user",
+                            content: { type: "text", text: skill.instructions },
+                        }],
+                }));
+            }
+        }
+        this.initialized = true;
+    }
+    /* ---- HTTP request handler ---------------------------------------------- */
+    /**
+     * Handle an incoming HTTP request to the /mcp endpoint.
+     *
+     * Supports the Streamable HTTP transport protocol:
+     * - POST for JSON-RPC messages
+     * - GET  for SSE notification stream
+     * - DELETE for session close
+     *
+     * Each request gets a fresh stateless transport; after the response is
+     * flushed the transport + underlying protocol connection are torn down
+     * so the single McpServer instance is ready for the next caller.
+     */
+    async handleRequest(req, res) {
+        if (!this.initialized) {
+            this.initialize();
+        }
+        // --- Auth: require SPT Bearer token ---
+        const authHeader = req.headers.authorization;
+        if (!authHeader?.startsWith("Bearer ")) {
+            res.writeHead(401, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Missing or invalid Authorization header" }));
+            return;
+        }
+        const token = authHeader.slice(7);
+        const valid = await this.validateSpt(token);
+        if (!valid) {
+            res.writeHead(403, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Invalid or expired SPT token" }));
+            return;
+        }
+        // --- Stateless transport per request ---
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // stateless
+        });
+        await this.server.connect(transport);
+        try {
+            await transport.handleRequest(req, res);
+        }
+        finally {
+            // Tear down so the McpServer can accept the next connection.
+            // transport.close() triggers Protocol._onclose() which clears _transport.
+            await transport.close();
+        }
+    }
+    /* ---- Private helpers --------------------------------------------------- */
+    /**
+     * Register a single skill as an MCP tool.
+     *
+     * The MCP SDK's `tool()` overloads that accept a schema expect Zod types.
+     * Since our skill definitions use raw JSON Schema we register without
+     * schema validation (name + description + handler) and let the handler
+     * receive the raw args object.
+     */
+    registerToolForSkill(name, skill) {
+        const description = skill.description ?? `AgentVault skill: ${name}`;
+        this.server.tool(name, description, async (args) => {
+            if (!this.opts.onInvoke) {
+                return {
+                    content: [{ type: "text", text: `Skill "${name}" invoked but no handler registered` }],
+                };
+            }
+            try {
+                const result = await this.opts.onInvoke(name, args);
+                const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+                return {
+                    content: [{ type: "text", text }],
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error invoking skill "${name}": ${message}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Validate a Service Provider Token against the AgentVault backend.
+     */
+    async validateSpt(token) {
+        try {
+            const url = `${this.opts.apiUrl}/api/v1/capabilities/introspect`;
+            const headers = {
+                "Content-Type": "application/json",
+            };
+            if (this.opts.apiKey) {
+                headers["Authorization"] = `Bearer ${this.opts.apiKey}`;
+            }
+            const resp = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ token }),
+            });
+            if (!resp.ok)
+                return false;
+            const data = (await resp.json());
+            return data.active === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /* ---- Accessors --------------------------------------------------------- */
+    get skillCount() {
+        return this.skills.size;
+    }
+    get isInitialized() {
+        return this.initialized;
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/openclaw-compat.js

@@ -0,0 +1,94 @@
+/**
+ * OpenClaw SDK compatibility layer — dynamic import wrappers with caching.
+ *
+ * Each wrapper attempts to import a deep SDK module at runtime. If the import
+ * fails (older gateway, missing SDK), the function returns a no-op result.
+ * Results are cached after the first attempt.
+ *
+ * IMPORTANT: All imports are guarded by try/catch — the plugin degrades
+ * gracefully on older OpenClaw versions.
+ */
+// ---------------------------------------------------------------------------
+// requestHeartbeatNow — wake agent proactively before outbound sends
+// ---------------------------------------------------------------------------
+let _heartbeatFn = null;
+/**
+ * Request an immediate heartbeat wake from the OpenClaw gateway.
+ * Returns true if the heartbeat API was available and called, false otherwise.
+ * Never throws.
+ */
+export async function requestHeartbeatNow(opts) {
+    if (_heartbeatFn === null) {
+        try {
+            // @ts-expect-error — deep SDK import only available when openclaw is installed
+            const mod = await import("openclaw/dist/plugin-sdk/infra/heartbeat-wake.js");
+            _heartbeatFn = mod.requestHeartbeatNow ?? mod.default?.requestHeartbeatNow ?? false;
+        }
+        catch {
+            _heartbeatFn = false;
+        }
+    }
+    if (typeof _heartbeatFn === "function") {
+        try {
+            await _heartbeatFn(opts);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+let _agentEventFn = null;
+/**
+ * Subscribe to agent-level events (tool_use, reasoning_complete, error, etc.).
+ * Returns an unsubscribe function, or a no-op if the API is unavailable.
+ */
+export async function onAgentEvent(callback) {
+    if (_agentEventFn === null) {
+        try {
+            // @ts-expect-error — deep SDK import only available when openclaw is installed
+            const mod = await import("openclaw/dist/plugin-sdk/infra/agent-events.js");
+            _agentEventFn = mod.onAgentEvent ?? mod.default?.onAgentEvent ?? false;
+        }
+        catch {
+            _agentEventFn = false;
+        }
+    }
+    if (typeof _agentEventFn === "function") {
+        try {
+            return _agentEventFn(callback);
+        }
+        catch {
+            return () => { };
+        }
+    }
+    return () => { };
+}
+let _transcriptFn = null;
+/**
+ * Subscribe to session transcript updates for behavioral analysis.
+ * Returns an unsubscribe function, or a no-op if the API is unavailable.
+ */
+export async function onSessionTranscriptUpdate(callback) {
+    if (_transcriptFn === null) {
+        try {
+            // @ts-expect-error — deep SDK import only available when openclaw is installed
+            const mod = await import("openclaw/dist/plugin-sdk/sessions/transcript-events.js");
+            _transcriptFn = mod.onSessionTranscriptUpdate ?? mod.default?.onSessionTranscriptUpdate ?? false;
+        }
+        catch {
+            _transcriptFn = false;
+        }
+    }
+    if (typeof _transcriptFn === "function") {
+        try {
+            return _transcriptFn(callback);
+        }
+        catch {
+            return () => { };
+        }
+    }
+    return () => { };
+}
+//# sourceMappingURL=openclaw-compat.js.map

package/dist/openclaw-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-compat.js","sourceRoot":"","sources":["../src/openclaw-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,qEAAqE;AACrE,8EAA8E;AAE9E,IAAI,YAAY,GAAmE,IAAI,CAAC;AAExF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA0B;IAClE,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,+EAA+E;YAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kDAAkD,CAAC,CAAC;YAC7E,YAAY,GAAG,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,OAAO,EAAE,mBAAmB,IAAI,KAAK,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,IAAI,aAAa,GAA8D,IAAI,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAA4B;IAC7D,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,+EAA+E;YAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gDAAgD,CAAC,CAAC;YAC3E,aAAa,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;AAClB,CAAC;AAOD,IAAI,aAAa,GAA8D,IAAI,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAA4B;IAC1E,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,+EAA+E;YAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,wDAAwD,CAAC,CAAC;YACnF,aAAa,GAAG,GAAG,CAAC,yBAAyB,IAAI,GAAG,CAAC,OAAO,EAAE,yBAAyB,IAAI,KAAK,CAAC;QACnG,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/openclaw-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-entry.d.ts","sourceRoot":"","sources":["../src/openclaw-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EACV,iBAAiB,EASlB,MAAM,qBAAqB,CAAC;AAsD7B,gFAAgF;AAChF,eAAO,IAAI,oBAAoB,SAAQ,CAAC;AAqCxC,uEAAuE;AACvE,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9C;AAED,qFAAqF;AACrF,iBAAS,yBAAyB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAcT;AAED,sFAAsF;AACtF,iBAAS,cAAc,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAiBR;AAizBD,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAC;;;;;kBAQrD,iBAAiB;;AAJjC,wBAoRE"}
+{"version":3,"file":"openclaw-entry.d.ts","sourceRoot":"","sources":["../src/openclaw-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EACV,iBAAiB,EASlB,MAAM,qBAAqB,CAAC;AAsD7B,gFAAgF;AAChF,eAAO,IAAI,oBAAoB,SAAQ,CAAC;AA6CxC,uEAAuE;AACvE,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9C;AAED,qFAAqF;AACrF,iBAAS,yBAAyB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAcT;AAED,sFAAsF;AACtF,iBAAS,cAAc,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAiBR;AAk1BD,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAC;;;;;kBAQrD,iBAAiB;;AAJjC,wBAoRE"}