@cachly-dev/mcp-server 0.10.83 → 0.10.84

package/dist/src/toolspecs.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Agent-framework tool-spec exporter.
+ *
+ * cachly exposes 114 MCP tools. MCP-native clients (Claude Code, Cursor,
+ * Windsurf, Copilot) speak MCP directly. But the wider agent ecosystem —
+ * OpenAI Assistants / function calling, the Anthropic Messages API, LangChain,
+ * CrewAI, AutoGen — each want the SAME tool definitions in their own dialect.
+ *
+ * Rather than hand-maintain four copies, we derive every dialect from the single
+ * TOOLS source of truth. Zero new runtime dependencies: these are just shape
+ * transforms over the JSON-Schema input schemas the tools already declare.
+ *
+ * CLI:  npx @cachly-dev/mcp-server tool-specs --format=openapi|openai|anthropic|langchain
+ */
+export type ToolDef = {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+};
+export type SpecFormat = 'openapi' | 'openai' | 'anthropic' | 'langchain';
+/** OpenAI function-calling / Assistants tool array. */
+export declare function toOpenAITools(tools: ReadonlyArray<ToolDef>): unknown[];
+/** Anthropic Messages API tool array (input_schema, not parameters). */
+export declare function toAnthropicTools(tools: ReadonlyArray<ToolDef>): unknown[];
+/**
+ * LangChain / CrewAI StructuredTool descriptors. LangChain consumes a name +
+ * description + JSON-schema args; this shape is accepted by
+ * `convertToOpenAITool`-style helpers and by CrewAI's tool adapters.
+ */
+export declare function toLangChainTools(tools: ReadonlyArray<ToolDef>): unknown[];
+/**
+ * OpenAPI 3.1 document. Each MCP tool becomes a POST operation under
+ * /mcp/tools/{name}, with the tool's input schema as the request body. This lets
+ * any OpenAPI-driven agent (OpenAI Assistants "from OpenAPI", Postman, codegen)
+ * wrap cachly automatically. The operation maps 1:1 onto an MCP tools/call.
+ */
+export declare function toOpenAPI(tools: ReadonlyArray<ToolDef>, version: string, serverUrl?: string): Record<string, unknown>;
+/** Render the requested format as a pretty-printed JSON string. */
+export declare function renderToolSpecs(tools: ReadonlyArray<ToolDef>, format: SpecFormat, version: string): string;

package/dist/src/toolspecs.js

@@ -0,0 +1,121 @@
+/**
+ * Agent-framework tool-spec exporter.
+ *
+ * cachly exposes 114 MCP tools. MCP-native clients (Claude Code, Cursor,
+ * Windsurf, Copilot) speak MCP directly. But the wider agent ecosystem —
+ * OpenAI Assistants / function calling, the Anthropic Messages API, LangChain,
+ * CrewAI, AutoGen — each want the SAME tool definitions in their own dialect.
+ *
+ * Rather than hand-maintain four copies, we derive every dialect from the single
+ * TOOLS source of truth. Zero new runtime dependencies: these are just shape
+ * transforms over the JSON-Schema input schemas the tools already declare.
+ *
+ * CLI:  npx @cachly-dev/mcp-server tool-specs --format=openapi|openai|anthropic|langchain
+ */
+const SERVER_TITLE = 'cachly AI Brain — MCP tools';
+/** OpenAI function-calling / Assistants tool array. */
+export function toOpenAITools(tools) {
+    return tools.map(t => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.inputSchema ?? { type: 'object', properties: {} },
+        },
+    }));
+}
+/** Anthropic Messages API tool array (input_schema, not parameters). */
+export function toAnthropicTools(tools) {
+    return tools.map(t => ({
+        name: t.name,
+        description: t.description,
+        input_schema: t.inputSchema ?? { type: 'object', properties: {} },
+    }));
+}
+/**
+ * LangChain / CrewAI StructuredTool descriptors. LangChain consumes a name +
+ * description + JSON-schema args; this shape is accepted by
+ * `convertToOpenAITool`-style helpers and by CrewAI's tool adapters.
+ */
+export function toLangChainTools(tools) {
+    return tools.map(t => ({
+        name: t.name,
+        description: t.description,
+        schema: t.inputSchema ?? { type: 'object', properties: {} },
+    }));
+}
+/**
+ * OpenAPI 3.1 document. Each MCP tool becomes a POST operation under
+ * /mcp/tools/{name}, with the tool's input schema as the request body. This lets
+ * any OpenAPI-driven agent (OpenAI Assistants "from OpenAPI", Postman, codegen)
+ * wrap cachly automatically. The operation maps 1:1 onto an MCP tools/call.
+ */
+export function toOpenAPI(tools, version, serverUrl = 'https://api.cachly.dev') {
+    const paths = {};
+    for (const t of tools) {
+        paths[`/mcp/tools/${t.name}`] = {
+            post: {
+                operationId: t.name,
+                summary: t.description.split('. ')[0],
+                description: t.description,
+                requestBody: {
+                    required: (t.inputSchema?.required?.length ?? 0) > 0,
+                    content: {
+                        'application/json': {
+                            schema: t.inputSchema ?? { type: 'object', properties: {} },
+                        },
+                    },
+                },
+                responses: {
+                    '200': {
+                        description: 'Tool result (MCP content blocks).',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        content: {
+                                            type: 'array',
+                                            items: {
+                                                type: 'object',
+                                                properties: { type: { type: 'string' }, text: { type: 'string' } },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: SERVER_TITLE,
+            version,
+            description: 'OpenAPI projection of the cachly MCP tool surface. Each path maps 1:1 onto an MCP ' +
+                'tools/call. Authenticate with a bearer token (CACHLY_JWT, a cky_ API key, or an ' +
+                'OAuth2 client_credentials access token).',
+        },
+        servers: [{ url: serverUrl }],
+        components: {
+            securitySchemes: {
+                bearerAuth: { type: 'http', scheme: 'bearer', bearerFormat: 'JWT' },
+            },
+        },
+        security: [{ bearerAuth: [] }],
+        paths,
+    };
+}
+/** Render the requested format as a pretty-printed JSON string. */
+export function renderToolSpecs(tools, format, version) {
+    switch (format) {
+        case 'openapi': return JSON.stringify(toOpenAPI(tools, version), null, 2);
+        case 'openai': return JSON.stringify({ tools: toOpenAITools(tools) }, null, 2);
+        case 'anthropic': return JSON.stringify({ tools: toAnthropicTools(tools) }, null, 2);
+        case 'langchain': return JSON.stringify({ tools: toLangChainTools(tools) }, null, 2);
+    }
+}
+//# sourceMappingURL=toolspecs.js.map

package/dist/src/toolspecs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.10.83",
+  "version": "0.10.84",
   "mcpName": "io.github.cachly-dev/cachly-mcp",
   "description": "Your AI forgets everything between sessions. cachly fixes that permanently. Persistent memory + causal root-cause analysis for Claude Code, Cursor, Copilot & Windsurf. Learns from every bug fix, git commit, and CI run automatically. Arrives pre-briefed. Predicts failures before they happen. 107 MCP tools · Free tier forever · GDPR · EU servers.",
   "type": "module",

package/server.json

@@ -6,13 +6,13 @@
     "url": "https://github.com/cachly-dev/cachly-mcp",
     "source": "github"
   },
-  "version": "0.10.83",
+  "version": "0.10.84",
   "packages": [
     {
       "registryType": "npm",
       "name": "@cachly-dev/mcp-server",
       "identifier": "@cachly-dev/mcp-server",
-      "version": "0.10.83",
+      "version": "0.10.84",
       "transport": {
         "type": "stdio"
       }