prpm 1.2.1 → 2.1.0

package/dist/schemas/kiro-agent.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/agent.json",
+  "$comment": "https://kiro.dev/docs/cli/custom-agents/",
+  "title": "Kiro Agent Configuration Format",
+  "description": "JSON Schema for Kiro custom agent configurations (.kiro/agents/*.json) - specialized AI assistants with specific tools and context",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Agent's identifier (optional, defaults to filename)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable explanation of agent's purpose"
+    },
+    "prompt": {
+      "type": "string",
+      "description": "High-level context for the agent. Can be inline text or reference external markdown files via file:// URI"
+    },
+    "mcpServers": {
+      "type": "object",
+      "description": "Model Context Protocol (MCP) servers configuration",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "string",
+            "description": "Command to start the MCP server"
+          },
+          "args": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Command-line arguments for the server"
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Environment variables for the server"
+          },
+          "timeout": {
+            "type": "number",
+            "description": "Server timeout in milliseconds"
+          }
+        },
+        "required": ["command"]
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of available tools (built-in or from MCP servers). Supports wildcards."
+    },
+    "toolAliases": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Rename tools to avoid naming conflicts"
+    },
+    "allowedTools": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Tools that can be used without user permission. Supports wildcards."
+    },
+    "toolsSettings": {
+      "type": "object",
+      "description": "Configure specific tool behaviors",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "allowedPaths": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Allowed file paths for file system tools"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Local file resources accessible to the agent (file:// URIs)"
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Commands triggered at specific lifecycle points",
+      "properties": {
+        "agentSpawn": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "userPromptSubmit": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "preToolUse": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "postToolUse": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "stop": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "useLegacyMcpJson": {
+      "type": "boolean",
+      "description": "Include legacy MCP configurations"
+    },
+    "model": {
+      "type": "string",
+      "description": "Specific AI model for the agent"
+    }
+  },
+  "examples": [
+    {
+      "name": "backend-specialist",
+      "description": "Expert in building Express.js APIs with MongoDB",
+      "prompt": "You are a backend developer specializing in Node.js and Express. Focus on API design, database optimization, and security best practices.",
+      "tools": ["fs_read", "fs_write", "execute_bash"],
+      "toolsSettings": {
+        "fs_write": {
+          "allowedPaths": ["src/api/**", "tests/api/**", "server.js", "package.json"]
+        }
+      },
+      "resources": [
+        "file://.kiro/steering/backend-standards.md"
+      ]
+    },
+    {
+      "name": "aws-rust-agent",
+      "description": "Specialized agent for AWS and Rust development",
+      "prompt": "file://./prompts/aws-rust-expert.md",
+      "mcpServers": {
+        "fetch": { "command": "fetch-server", "args": [] },
+        "git": { "command": "git-mcp", "args": [] }
+      },
+      "tools": ["fetch", "git_status", "fs_read", "fs_write"],
+      "allowedTools": ["fetch", "git_status"]
+    }
+  ]
+}

package/dist/schemas/kiro-hook.schema.json

@@ -0,0 +1,165 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/hook.json",
+  "$comment": "https://kiro.dev/docs/hooks/",
+  "title": "Kiro Hook Format",
+  "description": "JSON Schema for Kiro hook configuration files (.kiro/hooks/*.json) - event-driven automations. Supports both file-based events (fileCreated, fileModified, fileDeleted) and lifecycle events (agentSpawn, userPromptSubmit, preToolUse, postToolUse, stop).",
+  "type": "object",
+  "required": ["name", "description", "version", "when", "then"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human-readable name for the hook",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "description": "Explanation of what this hook does",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "description": "Hook version (typically '1')",
+      "pattern": "^[0-9]+$"
+    },
+    "when": {
+      "type": "object",
+      "description": "Event trigger configuration. File events require patterns, lifecycle events do not.",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "fileCreated",
+            "fileModified",
+            "fileDeleted",
+            "agentSpawn",
+            "userPromptSubmit",
+            "preToolUse",
+            "postToolUse",
+            "stop"
+          ],
+          "description": "Event type. File events: fileCreated (new files created), fileModified (files saved), fileDeleted (files removed). Lifecycle events: agentSpawn (agent activated), userPromptSubmit (user submits prompt), preToolUse (before tool execution, can block), postToolUse (after tool execution), stop (agent finishes responding)."
+        },
+        "patterns": {
+          "type": "array",
+          "description": "Glob patterns to match files (required for file events, optional for lifecycle events)",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": { "enum": ["fileCreated", "fileModified", "fileDeleted"] }
+            }
+          },
+          "then": {
+            "required": ["patterns"]
+          }
+        }
+      ]
+    },
+    "then": {
+      "type": "object",
+      "description": "Action to take when event occurs",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["askAgent", "runCommand"],
+          "description": "Type of action to perform"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Prompt for askAgent action type"
+        },
+        "command": {
+          "type": "string",
+          "description": "Shell command for runCommand action type"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "askAgent"
+              }
+            }
+          },
+          "then": {
+            "required": ["prompt"]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "runCommand"
+              }
+            }
+          },
+          "then": {
+            "required": ["command"]
+          }
+        }
+      ]
+    }
+  },
+  "examples": [
+    {
+      "name": "Auto Test Files",
+      "description": "Creates test files for new components",
+      "version": "1",
+      "when": {
+        "type": "fileCreated",
+        "patterns": ["src/components/**/*.tsx"]
+      },
+      "then": {
+        "type": "askAgent",
+        "prompt": "A new component was created. Create a corresponding test file."
+      }
+    },
+    {
+      "name": "Lint on Save",
+      "description": "Runs linter when files are modified",
+      "version": "1",
+      "when": {
+        "type": "fileModified",
+        "patterns": ["src/**/*.ts", "src/**/*.tsx"]
+      },
+      "then": {
+        "type": "runCommand",
+        "command": "npm run lint"
+      }
+    },
+    {
+      "name": "Session Setup",
+      "description": "Loads project context when agent starts",
+      "version": "1",
+      "when": {
+        "type": "agentSpawn"
+      },
+      "then": {
+        "type": "askAgent",
+        "prompt": "Read the README.md and CONTRIBUTING.md to understand the project structure and coding conventions."
+      }
+    },
+    {
+      "name": "Security Check",
+      "description": "Reviews tool calls for security concerns",
+      "version": "1",
+      "when": {
+        "type": "preToolUse"
+      },
+      "then": {
+        "type": "askAgent",
+        "prompt": "Review this tool call for potential security issues. Block if it accesses sensitive files or runs dangerous commands."
+      }
+    }
+  ]
+}

package/dist/schemas/kiro-steering.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro-steering.json",
+  "$comment": "https://kiro.dev/docs/steering/",
+  "title": "Kiro Steering Files Format",
+  "description": "JSON Schema for Kiro steering files (.kiro/steering/*.md) - context-aware instructions with optional frontmatter (defaults to 'always' inclusion)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "Optional YAML frontmatter enclosed in --- markers. If omitted, file defaults to 'always' inclusion mode.",
+      "properties": {
+        "inclusion": {
+          "type": "string",
+          "enum": ["always", "fileMatch", "manual"],
+          "default": "always",
+          "description": "When to include this steering file: always (all contexts, default), fileMatch (specific files), manual (user-triggered)"
+        },
+        "fileMatchPattern": {
+          "type": "string",
+          "description": "Glob pattern for fileMatch inclusion mode (REQUIRED if inclusion is fileMatch)"
+        },
+        "domain": {
+          "type": "string",
+          "description": "Domain or topic for organization (e.g., 'testing', 'api', 'security')"
+        },
+        "foundationalType": {
+          "type": "string",
+          "enum": ["product", "tech", "structure"],
+          "description": "Type of foundational file (product.md, tech.md, structure.md)"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "inclusion": {
+                "const": "fileMatch"
+              }
+            }
+          },
+          "then": {
+            "required": ["fileMatchPattern"]
+          }
+        }
+      ]
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter (or entire file if no frontmatter). Should include H1 title, guidelines, rules, examples."
+    }
+  },
+  "examples": [
+    {
+      "content": "# Testing Guidelines\n\nAlways write tests first.\n\n## Principles\n\n- Test edge cases\n- Mock external dependencies"
+    },
+    {
+      "frontmatter": {
+        "inclusion": "always",
+        "domain": "Testing"
+      },
+      "content": "# Testing Guidelines\n\nAlways write tests first.\n\n## Principles\n\n- Test edge cases\n- Mock external dependencies"
+    },
+    {
+      "frontmatter": {
+        "inclusion": "fileMatch",
+        "fileMatchPattern": "**/*.test.ts",
+        "domain": "Testing"
+      },
+      "content": "# Test File Guidelines\n\nRules specific to test files."
+    }
+  ]
+}

package/dist/schemas/mcp-server.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/mcp-server.schema.json",
+  "title": "MCP Server Package",
+  "description": "Schema for Model Context Protocol (MCP) server packages",
+  "type": "object",
+  "required": ["name", "mcpServers"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Display name of the MCP server package"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of what this MCP server provides"
+    },
+    "version": {
+      "type": "string",
+      "description": "Package version (semver)",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$"
+    },
+    "author": {
+      "type": "string",
+      "description": "Package author"
+    },
+    "repository": {
+      "type": "string",
+      "description": "Repository URL",
+      "format": "uri"
+    },
+    "homepage": {
+      "type": "string",
+      "description": "Homepage URL",
+      "format": "uri"
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier"
+    },
+    "mcpServers": {
+      "type": "object",
+      "description": "MCP server configurations to install",
+      "additionalProperties": {
+        "$ref": "#/definitions/mcpServer"
+      },
+      "minProperties": 1
+    }
+  },
+  "definitions": {
+    "mcpServer": {
+      "type": "object",
+      "description": "MCP server configuration",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["stdio", "http", "sse"],
+          "description": "Server connection type",
+          "default": "stdio"
+        },
+        "command": {
+          "type": "string",
+          "description": "Command to execute (for stdio type)"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments (for stdio type)"
+        },
+        "url": {
+          "type": "string",
+          "description": "Server URL (for http/sse type)",
+          "format": "uri"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variables to set"
+        }
+      },
+      "oneOf": [
+        {
+          "properties": {
+            "type": { "const": "stdio" }
+          },
+          "required": ["command"]
+        },
+        {
+          "properties": {
+            "type": { "enum": ["http", "sse"] }
+          },
+          "required": ["url"]
+        },
+        {
+          "not": {
+            "required": ["type"]
+          },
+          "required": ["command"]
+        }
+      ]
+    }
+  },
+  "examples": [
+    {
+      "name": "GitHub MCP Server",
+      "description": "MCP server for GitHub API integration",
+      "version": "1.0.0",
+      "author": "Anthropic",
+      "mcpServers": {
+        "github": {
+          "command": "npx",
+          "args": ["-y", "@anthropic/mcp-server-github"],
+          "env": {
+            "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+          }
+        }
+      }
+    },
+    {
+      "name": "Filesystem MCP Server",
+      "description": "MCP server for filesystem access",
+      "version": "1.0.0",
+      "mcpServers": {
+        "filesystem": {
+          "command": "npx",
+          "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/dir"]
+        }
+      }
+    }
+  ]
+}