@axinom/mosaic-agent-skills 0.0.1

package/README.md

@@ -0,0 +1,121 @@
+# Axinom Mosaic Agent Skills
+
+Model Context Protocol (MCP) server providing comprehensive Axinom Mosaic
+development tools for AI agents.
+
+## Features
+
+This unified package provides two categories of tools:
+
+### 1. Skills Management (4 tools)
+
+Official Mosaic development workflows with step-by-step guidance:
+
+- `list_skills` - List all available skill workflows
+- `get_skill` - Read a complete skill workflow
+- `get_skill_references` - Read reference files mentioned in workflows
+- `execute_skill` - Commit to executing a workflow
+
+### 2. GraphQL Schema Tools (5 tools)
+
+Schema inspection and code generation utilities:
+
+- `search_schema` - Search schema with regex patterns
+- `get_type_definitions` - Get type definitions (type, input, enum, interface,
+  union, scalar)
+- `get_query_fields` - Get Query field definitions with args and return types
+- `get_mutation_fields` - Get Mutation field definitions
+- `get_subscription_fields` - Get Subscription field definitions
+
+## Installation
+
+```bash
+yarn add @axinom/mosaic-agent-skills
+```
+
+## Usage
+
+### As MCP Server (Claude Desktop, etc.)
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "mosaic-agent-skills": {
+      "command": "node",
+      "args": [
+        "/path/to/node_modules/@axinom/mosaic-agent-skills/dist/index.js"
+      ],
+      "env": {
+        "SKILLS_PATH": "/optional/custom/skills/path"
+      }
+    }
+  }
+}
+```
+
+### Configuration
+
+- `SKILLS_PATH` - Optional environment variable to override skills directory
+  - Default: `./skills` (bundled with package)
+  - Custom: Set to absolute path for external skills
+
+## Development
+
+```bash
+# Build
+yarn build
+
+# Watch mode
+yarn dev
+
+# Start server
+yarn start
+```
+
+## Architecture
+
+```
+src/
+├── index.ts              # MCP server setup & tool registration
+├── logger.ts             # Logging utility
+└── tools/
+    ├── skills/          # Skills management tools
+    │   ├── index.ts     # Tool registration
+    │   ├── tools.ts     # Tool handlers
+    │   ├── utils.ts     # File scanning & parsing
+    │   └── types.ts     # Type definitions
+    └── graphql/         # GraphQL schema tools
+        ├── index.ts     # Tool registration
+        ├── tools.ts     # Tool handlers
+        └── utils.ts     # Schema inspection & loading
+
+skills/                  # Bundled skill workflows
+├── _shared/            # Common references & utilities
+└── [skill-name]/       # Individual skill workflows
+```
+
+## Skills Workflows
+
+Skills are step-by-step workflows that encode Axinom Mosaic development best
+practices. Each skill provides:
+
+- Clear goals and prerequisites
+- Detailed implementation steps
+- Reference files and code examples
+- Validation criteria
+
+Skills cover various aspects of Mosaic development including UI generation,
+GraphQL operations, code patterns, and architectural conventions. Use
+`list_skills` to discover available workflows.
+
+## Security
+
+- Path validation prevents directory traversal attacks
+- Schema paths must be absolute
+- Reference paths resolved relative to skill location
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const logger_1 = require("./logger");
+const graphql_1 = require("./tools/graphql");
+const skills_1 = require("./tools/skills");
+const SKILLS_PATH = process.env.SKILLS_PATH
+    ? path.resolve(process.env.SKILLS_PATH)
+    : path.resolve(__dirname, '../skills');
+async function main() {
+    logger_1.logger.info('Starting Axinom Mosaic Agent Skills MCP Server...');
+    logger_1.logger.info(`Skills path: ${SKILLS_PATH}`);
+    const server = new mcp_js_1.McpServer({
+        name: '@axinom/mosaic-agent-skills',
+        version: '0.0.1',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    (0, skills_1.registerSkillsTools)(server, SKILLS_PATH);
+    (0, graphql_1.registerGraphQLTools)(server);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    logger_1.logger.info('Server running on stdio');
+    logger_1.logger.info('Tools available: list_skills, get_skill, get_skill_references, execute_skill, search_schema, get_type_definitions, get_query_fields, get_mutation_fields, get_subscription_fields');
+}
+main().catch((error) => {
+    logger_1.logger.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,2CAA6B;AAE7B,oEAAoE;AACpE,wEAAiF;AAEjF,qCAAkC;AAClC,6CAAuD;AACvD,2CAAqD;AAMrD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW;IACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAMzC,KAAK,UAAU,IAAI;IACjB,eAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACjE,eAAM,CAAC,IAAI,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,kBAAS,CAC1B;QACE,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAGF,IAAA,4BAAmB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,IAAA,8BAAoB,EAAC,MAAM,CAAC,CAAC;IAG7B,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,eAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvC,eAAM,CAAC,IAAI,CACT,mLAAmL,CACpL,CAAC;AACJ,CAAC;AAGD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,eAAM,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    info(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM;kBACH,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;mBAIhC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAIlC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;CAGhD,CAAC"}

package/dist/logger.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.logger = {
+    info(message, ...args) {
+        console.error(`[MCP Server] ${message}`, ...args);
+    },
+    error(message, ...args) {
+        console.error(`[MCP Server] ERROR: ${message}`, ...args);
+    },
+    warn(message, ...args) {
+        console.error(`[MCP Server] WARNING: ${message}`, ...args);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAQa,QAAA,MAAM,GAAG;IACpB,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,KAAK,CAAC,gBAAgB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,KAAK,CAAC,yBAAyB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/dist/tools/graphql/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGraphQLTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/graphql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/graphql/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmH5D"}

package/dist/tools/graphql/index.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLTools = void 0;
+const zod_1 = require("zod");
+const tools_1 = require("./tools");
+function registerGraphQLTools(server) {
+    server.registerTool('search_schema', {
+        title: 'Search GraphQL Schema',
+        description: 'Search a GraphQL schema using regex pattern. Finds matching type definitions (type, input, enum, interface, union, scalar) and field names in Query, Mutation, and Subscription. Use regex patterns like "Movie" to find all related types/fields at once. Returns arrays of matching type names and fields (as TypeName.fieldName).',
+        inputSchema: zod_1.z.object({
+            schemaPath: zod_1.z
+                .string()
+                .describe('Absolute path to the GraphQL schema file'),
+            pattern: zod_1.z
+                .string()
+                .describe('Regex pattern to search for (case-insensitive). Examples: "Movie", "^create", "Filter$"'),
+        }),
+    }, async (args) => {
+        const validated = tools_1.SearchSchemaInputSchema.parse(args);
+        return (0, tools_1.searchSchemaTool)(validated);
+    });
+    server.registerTool('get_type_definitions', {
+        title: 'Get GraphQL Type Definitions',
+        description: 'Get GraphQL type definitions in SDL format. Works with any type kind: type, input, enum, interface, union, scalar. Supports batch requests - pass multiple type names to retrieve all definitions in one call.',
+        inputSchema: zod_1.z.object({
+            schemaPath: zod_1.z
+                .string()
+                .describe('Absolute path to the GraphQL schema file'),
+            typeNames: zod_1.z
+                .array(zod_1.z.string())
+                .describe('Array of type names to retrieve (e.g., ["Movie", "MovieFilter", "PublishStatus"])'),
+        }),
+    }, async (args) => {
+        const validated = tools_1.GetTypeDefinitionsInputSchema.parse(args);
+        return (0, tools_1.getTypeDefinitionsTool)(validated);
+    });
+    server.registerTool('get_query_fields', {
+        title: 'Get GraphQL Query Fields',
+        description: 'Get GraphQL Query field definitions in SDL format. Returns field signatures with arguments and return types. Supports batch requests - pass multiple field names to retrieve all definitions in one call.',
+        inputSchema: zod_1.z.object({
+            schemaPath: zod_1.z
+                .string()
+                .describe('Absolute path to the GraphQL schema file'),
+            fieldNames: zod_1.z
+                .array(zod_1.z.string())
+                .describe('Array of Query field names (e.g., ["movies", "movie", "tvshows"])'),
+        }),
+    }, async (args) => {
+        const validated = tools_1.GetQueryFieldsInputSchema.parse(args);
+        return (0, tools_1.getQueryFieldsTool)(validated);
+    });
+    server.registerTool('get_mutation_fields', {
+        title: 'Get GraphQL Mutation Fields',
+        description: 'Get GraphQL Mutation field definitions in SDL format. Returns field signatures with arguments and return types. Supports batch requests - pass multiple field names to retrieve all definitions in one call.',
+        inputSchema: zod_1.z.object({
+            schemaPath: zod_1.z
+                .string()
+                .describe('Absolute path to the GraphQL schema file'),
+            fieldNames: zod_1.z
+                .array(zod_1.z.string())
+                .describe('Array of Mutation field names (e.g., ["createMovie", "updateMovie", "deleteMovie"])'),
+        }),
+    }, async (args) => {
+        const validated = tools_1.GetMutationFieldsInputSchema.parse(args);
+        return (0, tools_1.getMutationFieldsTool)(validated);
+    });
+    server.registerTool('get_subscription_fields', {
+        title: 'Get GraphQL Subscription Fields',
+        description: 'Get GraphQL Subscription field definitions in SDL format. Returns field signatures with return types. Supports batch requests - pass multiple field names to retrieve all definitions in one call.',
+        inputSchema: zod_1.z.object({
+            schemaPath: zod_1.z
+                .string()
+                .describe('Absolute path to the GraphQL schema file'),
+            fieldNames: zod_1.z
+                .array(zod_1.z.string())
+                .describe('Array of Subscription field names (e.g., ["movieMutated", "tvshowMutated"])'),
+        }),
+    }, async (args) => {
+        const validated = tools_1.GetSubscriptionFieldsInputSchema.parse(args);
+        return (0, tools_1.getSubscriptionFieldsTool)(validated);
+    });
+}
+exports.registerGraphQLTools = registerGraphQLTools;
+//# sourceMappingURL=index.js.map

package/dist/tools/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/graphql/index.ts"],"names":[],"mappings":";;;AAKA,6BAAwB;AAExB,mCAWiB;AAEjB,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,sUAAsU;QACxU,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0CAA0C,CAAC;YACvD,OAAO,EAAE,OAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CACP,yFAAyF,CAC1F;SACJ,CAAC;KACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,+BAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,IAAA,wBAAgB,EAAC,SAAS,CAAC,CAAC;IACrC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,gNAAgN;QAClN,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,OAAC;iBACT,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,mFAAmF,CACpF;SACJ,CAAC;KACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,qCAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,IAAA,8BAAsB,EAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,2MAA2M;QAC7M,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0CAA0C,CAAC;YACvD,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,mEAAmE,CACpE;SACJ,CAAC;KACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,iCAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,IAAA,0BAAkB,EAAC,SAAS,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,8MAA8M;QAChN,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0CAA0C,CAAC;YACvD,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,qFAAqF,CACtF;SACJ,CAAC;KACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,oCAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO,IAAA,6BAAqB,EAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,oMAAoM;QACtM,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0CAA0C,CAAC;YACvD,UAAU,EAAE,OAAC;iBACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,6EAA6E,CAC9E;SACJ,CAAC;KACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,wCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,IAAA,iCAAyB,EAAC,SAAS,CAAC,CAAC;IAC9C,CAAC,CACF,CAAC;AACJ,CAAC;AAnHD,oDAmHC"}

package/dist/tools/graphql/tools.d.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+export declare const SearchSchemaInputSchema: z.ZodObject<{
+    schemaPath: z.ZodString;
+    pattern: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaPath: string;
+    pattern: string;
+}, {
+    schemaPath: string;
+    pattern: string;
+}>;
+export declare const GetTypeDefinitionsInputSchema: z.ZodObject<{
+    schemaPath: z.ZodString;
+    typeNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaPath: string;
+    typeNames: string[];
+}, {
+    schemaPath: string;
+    typeNames: string[];
+}>;
+export declare const GetQueryFieldsInputSchema: z.ZodObject<{
+    schemaPath: z.ZodString;
+    fieldNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaPath: string;
+    fieldNames: string[];
+}, {
+    schemaPath: string;
+    fieldNames: string[];
+}>;
+export declare const GetMutationFieldsInputSchema: z.ZodObject<{
+    schemaPath: z.ZodString;
+    fieldNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaPath: string;
+    fieldNames: string[];
+}, {
+    schemaPath: string;
+    fieldNames: string[];
+}>;
+export declare const GetSubscriptionFieldsInputSchema: z.ZodObject<{
+    schemaPath: z.ZodString;
+    fieldNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaPath: string;
+    fieldNames: string[];
+}, {
+    schemaPath: string;
+    fieldNames: string[];
+}>;
+export type SearchSchemaInput = z.infer<typeof SearchSchemaInputSchema>;
+export type GetTypeDefinitionsInput = z.infer<typeof GetTypeDefinitionsInputSchema>;
+export type GetQueryFieldsInput = z.infer<typeof GetQueryFieldsInputSchema>;
+export type GetMutationFieldsInput = z.infer<typeof GetMutationFieldsInputSchema>;
+export type GetSubscriptionFieldsInput = z.infer<typeof GetSubscriptionFieldsInputSchema>;
+interface ToolResponse {
+    [key: string]: unknown;
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+export declare function searchSchemaTool(input: SearchSchemaInput): ToolResponse;
+export declare function getTypeDefinitionsTool(input: GetTypeDefinitionsInput): ToolResponse;
+export declare function getQueryFieldsTool(input: GetQueryFieldsInput): ToolResponse;
+export declare function getMutationFieldsTool(input: GetMutationFieldsInput): ToolResponse;
+export declare function getSubscriptionFieldsTool(input: GetSubscriptionFieldsInput): ToolResponse;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools/graphql/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/graphql/tools.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,uBAAuB;;;;;;;;;EAOlC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;EAKxC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;EAKpC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;EAKvC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;EAK3C,CAAC;AAGH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAGF,UAAU,YAAY;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAiCvE;AAKD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,uBAAuB,GAC7B,YAAY,CAgCd;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAgC3E;AAKD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,GAC5B,YAAY,CAgCd;AAKD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CAgCd"}

package/dist/tools/graphql/tools.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubscriptionFieldsTool = exports.getMutationFieldsTool = exports.getQueryFieldsTool = exports.getTypeDefinitionsTool = exports.searchSchemaTool = exports.GetSubscriptionFieldsInputSchema = exports.GetMutationFieldsInputSchema = exports.GetQueryFieldsInputSchema = exports.GetTypeDefinitionsInputSchema = exports.SearchSchemaInputSchema = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("./utils");
+exports.SearchSchemaInputSchema = zod_1.z.object({
+    schemaPath: zod_1.z.string().describe('Absolute path to the GraphQL schema file'),
+    pattern: zod_1.z
+        .string()
+        .describe('Regex pattern to search for in type and field names (case-insensitive)'),
+});
+exports.GetTypeDefinitionsInputSchema = zod_1.z.object({
+    schemaPath: zod_1.z.string().describe('Absolute path to the GraphQL schema file'),
+    typeNames: zod_1.z
+        .array(zod_1.z.string())
+        .describe('Array of type names to retrieve definitions for'),
+});
+exports.GetQueryFieldsInputSchema = zod_1.z.object({
+    schemaPath: zod_1.z.string().describe('Absolute path to the GraphQL schema file'),
+    fieldNames: zod_1.z
+        .array(zod_1.z.string())
+        .describe('Array of query field names to retrieve definitions for'),
+});
+exports.GetMutationFieldsInputSchema = zod_1.z.object({
+    schemaPath: zod_1.z.string().describe('Absolute path to the GraphQL schema file'),
+    fieldNames: zod_1.z
+        .array(zod_1.z.string())
+        .describe('Array of mutation field names to retrieve definitions for'),
+});
+exports.GetSubscriptionFieldsInputSchema = zod_1.z.object({
+    schemaPath: zod_1.z.string().describe('Absolute path to the GraphQL schema file'),
+    fieldNames: zod_1.z
+        .array(zod_1.z.string())
+        .describe('Array of subscription field names to retrieve definitions for'),
+});
+function searchSchemaTool(input) {
+    try {
+        const schema = (0, utils_1.loadSchema)(input.schemaPath);
+        const result = (0, utils_1.searchSchema)(schema, input.pattern);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        matchingTypes: result.matchingTypes,
+                        matchingFields: result.matchingFields,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+exports.searchSchemaTool = searchSchemaTool;
+function getTypeDefinitionsTool(input) {
+    try {
+        const schema = (0, utils_1.loadSchema)(input.schemaPath);
+        const results = (0, utils_1.getTypes)(schema, input.typeNames);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        types: results,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+exports.getTypeDefinitionsTool = getTypeDefinitionsTool;
+function getQueryFieldsTool(input) {
+    try {
+        const schema = (0, utils_1.loadSchema)(input.schemaPath);
+        const results = (0, utils_1.getQueryFields)(schema, input.fieldNames);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        fields: results,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+exports.getQueryFieldsTool = getQueryFieldsTool;
+function getMutationFieldsTool(input) {
+    try {
+        const schema = (0, utils_1.loadSchema)(input.schemaPath);
+        const results = (0, utils_1.getMutationFields)(schema, input.fieldNames);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        fields: results,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+exports.getMutationFieldsTool = getMutationFieldsTool;
+function getSubscriptionFieldsTool(input) {
+    try {
+        const schema = (0, utils_1.loadSchema)(input.schemaPath);
+        const results = (0, utils_1.getSubscriptionFields)(schema, input.fieldNames);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        fields: results,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+exports.getSubscriptionFieldsTool = getSubscriptionFieldsTool;
+//# sourceMappingURL=tools.js.map

package/dist/tools/graphql/tools.js.map

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

package/dist/tools/graphql/utils.d.ts

@@ -0,0 +1,20 @@
+import { GraphQLSchema } from 'graphql';
+export interface SearchResult {
+    matchingTypes: string[];
+    matchingFields: string[];
+}
+export interface FieldDefinition {
+    name: string;
+    definition: string;
+}
+export interface TypeDefinition {
+    name: string;
+    definition: string;
+}
+export declare function loadSchema(schemaPath: string): GraphQLSchema;
+export declare function searchSchema(schema: GraphQLSchema, pattern: string): SearchResult;
+export declare function getTypes(schema: GraphQLSchema, typeNames: string[]): TypeDefinition[];
+export declare function getQueryFields(schema: GraphQLSchema, fieldNames: string[]): FieldDefinition[];
+export declare function getMutationFields(schema: GraphQLSchema, fieldNames: string[]): FieldDefinition[];
+export declare function getSubscriptionFields(schema: GraphQLSchema, fieldNames: string[]): FieldDefinition[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/tools/graphql/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/graphql/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,aAAa,EAEd,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAa5D;AAKD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,YAAY,CAsBd;AAKD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EAAE,GAClB,cAAc,EAAE,CA0BlB;AAKD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,eAAe,EAAE,CAWnB;AAKD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,eAAe,EAAE,CAWnB;AAKD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,eAAe,EAAE,CAWnB"}