@intentsolutionsio/api-test-automation 1.0.0 → 1.0.6

package/README.md

@@ -216,11 +216,13 @@ describe('GraphQL API', () => {
 The agent generates tests for:
 
 ### Success Scenarios
+
 - Valid requests with proper authentication
 - Correct data formats and required fields
 - Expected response structures
 
 ### Error Scenarios
+
 - Missing or invalid authentication
 - Validation errors (bad data formats)
 - Missing required fields
@@ -229,6 +231,7 @@ The agent generates tests for:
 - Conflict errors (409, duplicates)
 
 ### Edge Cases
+
 - Empty request bodies
 - Null/undefined values
 - Boundary values (min/max lengths)
@@ -236,6 +239,7 @@ The agent generates tests for:
 - Large payloads
 
 ### Performance
+
 - Response time thresholds
 - Payload size validation
 - Concurrent request handling

package/agents/api-tester.md

@@ -1,7 +1,35 @@
 ---
 name: api-tester
-description: >
-  Specialized agent for automated API endpoint testing and validation
+description: Specialized agent for automated API endpoint testing and validation
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: cyan
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- api
+- tester
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
 # API Test Automation Agent
 
@@ -10,6 +38,7 @@ You are a specialized API testing agent that automates endpoint testing with com
 ## Your Capabilities
 
 ### 1. REST API Testing
+
 - **CRUD operations** - GET, POST, PUT, PATCH, DELETE
 - **Request validation** - Headers, body, query parameters
 - **Response validation** - Status codes, headers, body structure
@@ -17,6 +46,7 @@ You are a specialized API testing agent that automates endpoint testing with com
 - **Error scenarios** - 4xx/5xx responses, invalid inputs
 
 ### 2. GraphQL Testing
+
 - **Query testing** - Read operations with various selectors
 - **Mutation testing** - Create, update, delete operations
 - **Subscription testing** - Real-time data streams
@@ -24,12 +54,14 @@ You are a specialized API testing agent that automates endpoint testing with com
 - **Schema validation** - Type checking, required fields
 
 ### 3. API Contract Testing
+
 - **OpenAPI/Swagger** - Validate against spec
 - **Schema validation** - JSON Schema, Joi, Yup
 - **Breaking change detection** - Compare API versions
 - **Documentation sync** - Ensure docs match implementation
 
 ### 4. Test Scenario Generation
+
 - **Happy path tests** - Successful operations
 - **Edge cases** - Boundary values, empty data
 - **Error cases** - Invalid inputs, unauthorized access
@@ -39,6 +71,7 @@ You are a specialized API testing agent that automates endpoint testing with com
 ## When to Activate
 
 Activate when the user needs to:
+
 - Test REST or GraphQL API endpoints
 - Validate API responses against schemas
 - Generate API test suites
@@ -144,6 +177,7 @@ describe('API Endpoint: POST /api/users', () => {
 ## Validation Rules
 
 Always validate:
+
 - **Status codes** - Correct HTTP status
 - **Response structure** - Expected JSON shape
 - **Data types** - String, number, boolean, array, object
@@ -156,6 +190,7 @@ Always validate:
 ## Authentication Patterns
 
 Handle common auth patterns:
+
 - **Bearer tokens** - `Authorization: Bearer <token>`
 - **API keys** - Header or query parameter
 - **OAuth 2.0** - Token exchange flow
@@ -166,6 +201,7 @@ Handle common auth patterns:
 ## Tools and Libraries
 
 Use appropriate tools for the language:
+
 - **JavaScript/TypeScript**: axios, supertest, node-fetch
 - **Python**: requests, httpx, pytest-httpx
 - **Java**: RestAssured, OkHttp
@@ -175,6 +211,7 @@ Use appropriate tools for the language:
 ## Output Format
 
 Provide:
+
 1. **Complete test file** with all necessary imports
 2. **Test data fixtures** or factories
 3. **Authentication helpers** (if needed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/api-test-automation",
-  "version": "1.0.0",
+  "version": "1.0.6",
   "description": "Automated API endpoint testing with request generation, validation, and comprehensive test coverage",
   "keywords": [
     "testing",

package/skills/automating-api-testing/SKILL.md

@@ -1,16 +1,24 @@
 ---
 name: automating-api-testing
-description: |
-  Test automate API endpoint testing including request generation, validation, and comprehensive test coverage for REST and GraphQL APIs.
-  Use when testing API contracts, validating OpenAPI specifications, or ensuring endpoint reliability.
-  Trigger with phrases like "test the API", "generate API tests", or "validate API contracts".
+description: 'Test automate API endpoint testing including request generation, validation,
+  and comprehensive test coverage for REST and GraphQL APIs.
 
+  Use when testing API contracts, validating OpenAPI specifications, or ensuring endpoint
+  reliability.
+
+  Trigger with phrases like "test the API", "generate API tests", or "validate API
+  contracts".
+
+  '
 allowed-tools: Read, Write, Edit, Grep, Glob, Bash(test:api-*)
 version: 1.0.0
 author: Jeremy Longshore <jeremy@intentsolutions.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [testing, api, graphql]
+tags:
+- testing
+- api
+- graphql
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # API Test Automation
 
@@ -81,6 +89,7 @@ Automate comprehensive API endpoint testing for REST and GraphQL APIs including
 ## Examples
 
 **Supertest REST API test suite:**
+
 ```typescript
 import request from 'supertest';
 import { app } from '../src/app';
@@ -126,6 +135,7 @@ describe('POST /api/products', () => {
 ```
 
 **GraphQL API test:**
+
 ```typescript
 it('fetches user by ID', async () => {
   const query = `query { user(id: "1") { id name email } }`;
@@ -144,6 +154,6 @@ it('fetches user by ID', async () => {
 - Supertest: https://github.com/ladjs/supertest
 - REST-assured (Java): https://rest-assured.io/
 - httpx (Python): https://www.python-httpx.org/
-- Newman (Postman CLI): https://learning.postman.com/docs/collections/using-newman-cli/
+- Newman (Postman CLI):
 - OpenAPI specification: https://spec.openapis.org/oas/v3.1.0
-- Ajv JSON Schema validator: https://ajv.js.org/
+- Ajv JSON Schema validator: https://ajv.js.org/

package/skills/automating-api-testing/references/README.md

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for api-test-automation skill
-

package/skills/automating-api-testing/scripts/generate_test_suite.py

@@ -5,16 +5,17 @@ Generates comprehensive test suites for REST and GraphQL APIs based on endpoint
 Generated: 2025-12-10 03:48:17
 """
 
-import os
 import json
 import argparse
 from pathlib import Path
 from datetime import datetime
+from typing import Dict
+
 
 class Generator:
     def __init__(self, config: Dict):
         self.config = config
-        self.output_dir = Path(config.get('output', './output'))
+        self.output_dir = Path(config.get("output", "./output"))
         self.output_dir.mkdir(parents=True, exist_ok=True)
 
     def generate_markdown(self, title: str, content: str) -> Path:
@@ -25,7 +26,7 @@ class Generator:
         md_content = f"""# {title}
 
 Generated by api-test-automation
-Date: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}
+Date: {datetime.now().strftime("%Y-%m-%d %H:%M:%S")}
 
 ## Overview
 {content}
@@ -56,10 +57,10 @@ api-test-automation
             "category": "testing",
             "plugin": "api-test-automation",
             "data": data,
-            "config": self.config
+            "config": self.config,
         }
 
-        with open(file_path, 'w') as f:
+        with open(file_path, "w") as f:
             json.dump(output_data, f, indent=2)
 
         return file_path
@@ -71,7 +72,7 @@ api-test-automation
 
         script_content = f"""#!/bin/bash
 # Generated by api-test-automation
-# Date: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}
+# Date: {datetime.now().strftime("%Y-%m-%d %H:%M:%S")}
 
 set -e  # Exit on error
 
@@ -87,17 +88,20 @@ echo "✅ Completed successfully"
         file_path.chmod(0o755)  # Make executable
         return file_path
 
+
 def main():
-    parser = argparse.ArgumentParser(description="Generates comprehensive test suites for REST and GraphQL APIs based on endpoint analysis and specifications.")
-    parser.add_argument('--type', choices=['markdown', 'json', 'script'], default='markdown')
-    parser.add_argument('--output', '-o', default='./output', help='Output directory')
-    parser.add_argument('--config', '-c', help='Configuration file')
-    parser.add_argument('--title', default='api-test-automation Output')
-    parser.add_argument('--content', help='Content to include')
+    parser = argparse.ArgumentParser(
+        description="Generates comprehensive test suites for REST and GraphQL APIs based on endpoint analysis and specifications."
+    )
+    parser.add_argument("--type", choices=["markdown", "json", "script"], default="markdown")
+    parser.add_argument("--output", "-o", default="./output", help="Output directory")
+    parser.add_argument("--config", "-c", help="Configuration file")
+    parser.add_argument("--title", default="api-test-automation Output")
+    parser.add_argument("--content", help="Content to include")
 
     args = parser.parse_args()
 
-    config = {'output': args.output}
+    config = {"output": args.output}
     if args.config and Path(args.config).exists():
         with open(args.config) as f:
             config.update(json.load(f))
@@ -106,24 +110,20 @@ def main():
 
     print(f"🔧 Generating {args.type} output...")
 
-    if args.type == 'markdown':
-        output_file = generator.generate_markdown(
-            args.title,
-            args.content or "Generated content"
-        )
-    elif args.type == 'json':
-        output_file = generator.generate_json(
-            {"title": args.title, "content": args.content}
-        )
+    if args.type == "markdown":
+        output_file = generator.generate_markdown(args.title, args.content or "Generated content")
+    elif args.type == "json":
+        output_file = generator.generate_json({"title": args.title, "content": args.content})
     else:  # script
         output_file = generator.generate_script(
-            args.title.lower().replace(' ', '_'),
-            args.content or "# Add your script content here"
+            args.title.lower().replace(" ", "_"), args.content or "# Add your script content here"
         )
 
     print(f"✅ Generated: {output_file}")
     return 0
 
+
 if __name__ == "__main__":
     import sys
+
     sys.exit(main())