prpm 1.2.1 → 2.1.0

package/dist/schemas/opencode-plugin.schema.json

@@ -0,0 +1,391 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/opencode/plugin.json",
+  "$comment": "https://opencode.ai/docs/plugins/",
+  "title": "OpenCode Plugin Format",
+  "description": "JSON Schema for OpenCode plugin modules. Plugins are JavaScript/TypeScript modules that hook into events across commands, files, LSP, messages, permissions, server, sessions, todos, tools, and TUI interactions. Plugins export an async function that receives a context object (with project, client, $, directory, worktree) and returns an object with an event handler function.",
+  "type": "object",
+  "required": ["name", "description", "plugin"],
+  "$defs": {
+    "eventTypes": {
+      "command": {
+        "command.executed": {
+          "description": "Triggered when a command is executed",
+          "event": "command.executed"
+        }
+      },
+      "file": {
+        "file.edited": {
+          "description": "Triggered when a file is edited",
+          "event": "file.edited"
+        },
+        "file.watcher.updated": {
+          "description": "Triggered when a file watcher detects changes",
+          "event": "file.watcher.updated"
+        }
+      },
+      "installation": {
+        "installation.updated": {
+          "description": "Triggered when installation state is updated",
+          "event": "installation.updated"
+        }
+      },
+      "lsp": {
+        "lsp.client.diagnostics": {
+          "description": "Triggered when LSP client receives diagnostics",
+          "event": "lsp.client.diagnostics"
+        },
+        "lsp.updated": {
+          "description": "Triggered when LSP state is updated",
+          "event": "lsp.updated"
+        }
+      },
+      "message": {
+        "message.part.removed": {
+          "description": "Triggered when a message part is removed",
+          "event": "message.part.removed"
+        },
+        "message.part.updated": {
+          "description": "Triggered when a message part is updated",
+          "event": "message.part.updated"
+        },
+        "message.removed": {
+          "description": "Triggered when a message is removed",
+          "event": "message.removed"
+        },
+        "message.updated": {
+          "description": "Triggered when a message is updated",
+          "event": "message.updated"
+        }
+      },
+      "permission": {
+        "permission.replied": {
+          "description": "Triggered when a permission request receives a reply",
+          "event": "permission.replied"
+        },
+        "permission.updated": {
+          "description": "Triggered when permission state is updated",
+          "event": "permission.updated"
+        }
+      },
+      "server": {
+        "server.connected": {
+          "description": "Triggered when server connection is established",
+          "event": "server.connected"
+        }
+      },
+      "session": {
+        "session.created": {
+          "description": "Triggered when a new session is created",
+          "event": "session.created"
+        },
+        "session.compacted": {
+          "description": "Triggered when a session is compacted",
+          "event": "session.compacted"
+        },
+        "session.deleted": {
+          "description": "Triggered when a session is deleted",
+          "event": "session.deleted"
+        },
+        "session.diff": {
+          "description": "Triggered when session changes are detected",
+          "event": "session.diff"
+        },
+        "session.error": {
+          "description": "Triggered when a session error occurs",
+          "event": "session.error"
+        },
+        "session.idle": {
+          "description": "Triggered when session becomes idle",
+          "event": "session.idle"
+        },
+        "session.status": {
+          "description": "Triggered when session status changes",
+          "event": "session.status"
+        },
+        "session.updated": {
+          "description": "Triggered when session is updated",
+          "event": "session.updated"
+        }
+      },
+      "todo": {
+        "todo.updated": {
+          "description": "Triggered when a todo item is updated",
+          "event": "todo.updated"
+        }
+      },
+      "tool": {
+        "tool.execute.after": {
+          "description": "Triggered after a tool execution completes",
+          "event": "tool.execute.after"
+        },
+        "tool.execute.before": {
+          "description": "Triggered before a tool execution begins",
+          "event": "tool.execute.before"
+        }
+      },
+      "tui": {
+        "tui.prompt.append": {
+          "description": "Triggered when content is appended to the TUI prompt",
+          "event": "tui.prompt.append"
+        },
+        "tui.command.execute": {
+          "description": "Triggered when a TUI command is executed",
+          "event": "tui.command.execute"
+        },
+        "tui.toast.show": {
+          "description": "Triggered when a toast notification is shown",
+          "event": "tui.toast.show"
+        }
+      }
+    }
+  },
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Plugin name"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of plugin functionality"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "author": {
+      "type": "string",
+      "description": "Plugin author"
+    },
+    "plugin": {
+      "type": "object",
+      "description": "Plugin implementation details",
+      "required": ["file"],
+      "properties": {
+        "file": {
+          "type": "string",
+          "description": "Path to plugin JavaScript/TypeScript file (e.g., plugin.js, plugin.ts)"
+        },
+        "export": {
+          "type": "string",
+          "description": "Named export from the plugin file",
+          "default": "default"
+        },
+        "location": {
+          "type": "string",
+          "description": "Plugin location: 'project' (.opencode/plugin/) or 'global' (~/.config/opencode/plugin)",
+          "enum": ["project", "global"],
+          "default": "project"
+        }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Event hooks implemented by this plugin. All event handlers receive an event object with the event type and relevant data. Plugin exports: export const MyPlugin = async (context) => { return { event: async ({ event }) => { /* handler */ } } }",
+      "properties": {
+        "command": {
+          "type": "array",
+          "description": "Command execution events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "command.executed"
+            ]
+          }
+        },
+        "file": {
+          "type": "array",
+          "description": "File system events including edits and watcher updates",
+          "items": {
+            "type": "string",
+            "enum": [
+              "file.edited",
+              "file.watcher.updated"
+            ]
+          }
+        },
+        "installation": {
+          "type": "array",
+          "description": "Installation state events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "installation.updated"
+            ]
+          }
+        },
+        "lsp": {
+          "type": "array",
+          "description": "Language Server Protocol events including diagnostics and state updates",
+          "items": {
+            "type": "string",
+            "enum": [
+              "lsp.client.diagnostics",
+              "lsp.updated"
+            ]
+          }
+        },
+        "message": {
+          "type": "array",
+          "description": "Message and message part lifecycle events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "message.part.removed",
+              "message.part.updated",
+              "message.removed",
+              "message.updated"
+            ]
+          }
+        },
+        "permission": {
+          "type": "array",
+          "description": "Permission request and response events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "permission.replied",
+              "permission.updated"
+            ]
+          }
+        },
+        "server": {
+          "type": "array",
+          "description": "Server connection events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "server.connected"
+            ]
+          }
+        },
+        "session": {
+          "type": "array",
+          "description": "Session lifecycle events including creation, updates, errors, and deletion",
+          "items": {
+            "type": "string",
+            "enum": [
+              "session.created",
+              "session.compacted",
+              "session.deleted",
+              "session.diff",
+              "session.error",
+              "session.idle",
+              "session.status",
+              "session.updated"
+            ]
+          }
+        },
+        "todo": {
+          "type": "array",
+          "description": "Todo item update events",
+          "items": {
+            "type": "string",
+            "enum": [
+              "todo.updated"
+            ]
+          }
+        },
+        "tool": {
+          "type": "array",
+          "description": "Tool execution lifecycle events (before/after execution)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "tool.execute.after",
+              "tool.execute.before"
+            ]
+          }
+        },
+        "tui": {
+          "type": "array",
+          "description": "Terminal UI events including prompts, commands, and notifications",
+          "items": {
+            "type": "string",
+            "enum": [
+              "tui.prompt.append",
+              "tui.command.execute",
+              "tui.toast.show"
+            ]
+          }
+        }
+      }
+    },
+    "tools": {
+      "type": "array",
+      "description": "Custom tools provided by this plugin",
+      "items": {
+        "type": "object",
+        "required": ["name", "description"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Tool name"
+          },
+          "description": {
+            "type": "string",
+            "description": "Tool description"
+          },
+          "parameters": {
+            "type": "object",
+            "description": "Tool parameters (JSON Schema)"
+          }
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "name": "env-protection",
+      "description": "Prevents sharing .env files",
+      "version": "1.0.0",
+      "author": "Security Team",
+      "plugin": {
+        "file": "env-protection.js",
+        "location": "global"
+      },
+      "hooks": {
+        "file": ["onFileRead"],
+        "permission": ["onPermissionRequest"]
+      }
+    },
+    {
+      "name": "notification-plugin",
+      "description": "Sends notifications on command completion",
+      "version": "1.0.0",
+      "author": "DevOps Team",
+      "plugin": {
+        "file": "notify.ts",
+        "export": "NotifyPlugin",
+        "location": "project"
+      },
+      "hooks": {
+        "command": ["onCommandEnd", "onCommandError"]
+      }
+    },
+    {
+      "name": "custom-tools",
+      "description": "Adds custom development tools",
+      "version": "1.0.0",
+      "plugin": {
+        "file": "tools.js"
+      },
+      "tools": [
+        {
+          "name": "lint",
+          "description": "Run linter on current file",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "fix": {
+                "type": "boolean",
+                "description": "Auto-fix issues"
+              }
+            }
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/schemas/opencode-slash-command.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/opencode/slash-command.json",
+  "$comment": "https://opencode.ai/docs/slash-commands/",
+  "title": "OpenCode Slash Command Format",
+  "description": "JSON Schema for OpenCode Slash Commands - markdown files with YAML frontmatter stored in .opencode/command/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["template"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Brief description of what the command does (shown in TUI)"
+        },
+        "template": {
+          "type": "string",
+          "description": "The prompt text sent to the LLM when executed. Required field. Supports placeholders: $ARGUMENTS, $1-$9, !`command`, @filename"
+        },
+        "agent": {
+          "type": "string",
+          "description": "Specifies which agent executes the command"
+        },
+        "model": {
+          "type": "string",
+          "description": "Overrides default model for this command (e.g., 'anthropic/claude-sonnet-4-20250514')"
+        },
+        "subtask": {
+          "type": "boolean",
+          "description": "Forces subagent invocation behavior when true"
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Additional command documentation or notes (optional)"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Run tests for a specific file",
+        "template": "Run the tests for $1 and report the results",
+        "agent": "test-runner",
+        "subtask": true
+      },
+      "content": "# Test Runner Command\n\nExecutes tests for the specified file and provides a detailed report."
+    },
+    {
+      "frontmatter": {
+        "template": "Review the following code for best practices:\n\n@$1",
+        "model": "anthropic/claude-sonnet-4-20250514"
+      },
+      "content": ""
+    }
+  ]
+}

package/dist/schemas/opencode.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/opencode.json",
+  "$comment": "https://opencode.ai/docs/agents/",
+  "title": "OpenCode Agent Format",
+  "description": "JSON Schema for OpenCode Agents - markdown files with YAML frontmatter stored in .opencode/agent/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["description", "mode"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Brief explanation of the agent's purpose and use cases (required)"
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["subagent", "primary", "all"],
+          "description": "Determines how the agent can be used: 'primary' (main assistant), 'subagent' (spawned by primary), or 'all' (both contexts). Required field.",
+          "default": "all"
+        },
+        "model": {
+          "type": "string",
+          "description": "Override default model (e.g., 'anthropic/claude-sonnet-4-20250514')"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0.0,
+          "maximum": 1.0,
+          "description": "Controls response randomness (0.0-1.0). Defaults to model-specific values (typically 0, or 0.55 for Qwen models)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Path to custom system prompt file using {file:./path} syntax"
+        },
+        "tools": {
+          "type": "object",
+          "description": "Enable/disable specific tools. Supports wildcards (e.g., 'mymcp_*')",
+          "properties": {
+            "write": { "type": "boolean" },
+            "edit": { "type": "boolean" },
+            "bash": { "type": "boolean" },
+            "read": { "type": "boolean" },
+            "grep": { "type": "boolean" },
+            "glob": { "type": "boolean" },
+            "webfetch": { "type": "boolean" },
+            "websearch": { "type": "boolean" }
+          },
+          "additionalProperties": { "type": "boolean" }
+        },
+        "permission": {
+          "type": "object",
+          "description": "Manages tool access with values: 'ask', 'allow', or 'deny'",
+          "properties": {
+            "edit": {
+              "type": "string",
+              "enum": ["ask", "allow", "deny"]
+            },
+            "bash": {
+              "oneOf": [
+                { "type": "string", "enum": ["ask", "allow", "deny"] },
+                { "type": "object", "description": "Specific commands allowed" }
+              ]
+            },
+            "webfetch": {
+              "type": "string",
+              "enum": ["ask", "allow", "deny"]
+            }
+          },
+          "additionalProperties": {
+            "oneOf": [
+              { "type": "string", "enum": ["ask", "allow", "deny"] },
+              { "type": "object" }
+            ]
+          }
+        },
+        "disable": {
+          "type": "boolean",
+          "description": "When true, disables the agent"
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "System prompt content as markdown text"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Reviews code for best practices",
+        "mode": "subagent",
+        "model": "anthropic/claude-sonnet-4-20250514",
+        "temperature": 0.7,
+        "tools": {
+          "write": false,
+          "edit": true,
+          "bash": false
+        },
+        "permission": {
+          "edit": "ask",
+          "bash": "deny"
+        }
+      },
+      "content": "You are an expert code reviewer.\n\n## Instructions\n\n- Check for code smells\n- Verify test coverage\n- Suggest improvements"
+    }
+  ]
+}