@agentplugins/core 0.1.0

package/dist/validation.js

@@ -0,0 +1,373 @@
+/**
+ * AgentPlugins Validation Layer
+ *
+ * Catches cross-platform issues before compilation.
+ * Provides platform-specific and universal validators.
+ */
+import { UNIVERSAL_HOOK_NAMES, ALL_TARGETS, Severity, } from './types.js';
+// ─── Universal Validators ─────────────────────────────────────────────────────
+const KEBAB_CASE_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+export function validateUniversal(plugin) {
+    const issues = [];
+    // ─── name ─────────────────────────────────────────────────────────────────
+    if (!plugin.name) {
+        issues.push({ severity: Severity.ERROR, field: 'name', message: 'Plugin name is required' });
+    }
+    else {
+        if (!KEBAB_CASE_RE.test(plugin.name)) {
+            issues.push({
+                severity: Severity.ERROR,
+                field: 'name',
+                message: `Plugin name "${plugin.name}" must be kebab-case (lowercase letters, numbers, hyphens only)`,
+                suggestion: `Rename to: ${toKebabCase(plugin.name)}`,
+            });
+        }
+        if (plugin.name.length > 64) {
+            issues.push({
+                severity: Severity.ERROR,
+                field: 'name',
+                message: `Plugin name "${plugin.name}" is ${plugin.name.length} chars (max 64)`,
+            });
+        }
+    }
+    // ─── version ──────────────────────────────────────────────────────────────
+    if (!plugin.version) {
+        issues.push({ severity: Severity.ERROR, field: 'version', message: 'Plugin version is required' });
+    }
+    else if (!SEMVER_RE.test(plugin.version)) {
+        issues.push({
+            severity: Severity.ERROR,
+            field: 'version',
+            message: `Version "${plugin.version}" is not valid semantic versioning`,
+            suggestion: 'Use format like "1.0.0"',
+        });
+    }
+    // ─── description ──────────────────────────────────────────────────────────
+    if (!plugin.description) {
+        issues.push({ severity: Severity.WARNING, field: 'description', message: 'Description is recommended for discovery' });
+    }
+    else if (plugin.description.length > 1024) {
+        issues.push({
+            severity: Severity.WARNING,
+            field: 'description',
+            message: `Description is ${plugin.description.length} chars (some platforms truncate at 1024)`,
+        });
+    }
+    // ─── targets ──────────────────────────────────────────────────────────────
+    if (plugin.targets) {
+        for (const target of plugin.targets) {
+            if (!ALL_TARGETS.includes(target)) {
+                issues.push({
+                    severity: Severity.ERROR,
+                    field: 'targets',
+                    message: `Unknown target platform: "${target}"`,
+                    suggestion: `Supported: ${ALL_TARGETS.join(', ')}`,
+                });
+            }
+        }
+    }
+    // ─── hooks ────────────────────────────────────────────────────────────────
+    if (plugin.hooks) {
+        for (const [name, def] of Object.entries(plugin.hooks)) {
+            const hookName = name;
+            if (!UNIVERSAL_HOOK_NAMES.includes(hookName)) {
+                issues.push({
+                    severity: Severity.WARNING,
+                    field: `hooks.${name}`,
+                    message: `Hook "${name}" is not a universal hook — it will be ignored by some platforms`,
+                });
+                continue;
+            }
+            if (def) {
+                issues.push(...validateHandler(hookName, def.handler));
+            }
+        }
+    }
+    // ─── skills ───────────────────────────────────────────────────────────────
+    if (plugin.skills) {
+        for (let i = 0; i < plugin.skills.length; i++) {
+            const skill = plugin.skills[i];
+            if (!skill.name) {
+                issues.push({ severity: Severity.ERROR, field: `skills[${i}].name`, message: 'Skill name is required' });
+            }
+            else if (!KEBAB_CASE_RE.test(skill.name)) {
+                issues.push({
+                    severity: Severity.WARNING,
+                    field: `skills[${i}].name`,
+                    message: `Skill name "${skill.name}" should be kebab-case`,
+                    suggestion: `Rename to: ${toKebabCase(skill.name)}`,
+                });
+            }
+            if (!skill.description) {
+                issues.push({ severity: Severity.WARNING, field: `skills[${i}].description`, message: 'Skill description is recommended' });
+            }
+            if (!skill.content && !skill.filePath) {
+                issues.push({
+                    severity: Severity.ERROR,
+                    field: `skills[${i}]`,
+                    message: 'Skill must have either "content" or "filePath"',
+                });
+            }
+        }
+    }
+    // ─── tools ────────────────────────────────────────────────────────────────
+    if (plugin.tools) {
+        for (let i = 0; i < plugin.tools.length; i++) {
+            const tool = plugin.tools[i];
+            if (!tool.name) {
+                issues.push({ severity: Severity.ERROR, field: `tools[${i}].name`, message: 'Tool name is required' });
+            }
+            if (!tool.description) {
+                issues.push({ severity: Severity.WARNING, field: `tools[${i}].description`, message: 'Tool description is recommended' });
+            }
+            // Tool handlers are runtime functions, not HookHandler objects
+            // This check only applies to hooks, not tools
+            if (tool.handlerType === 'inline' && tool.handlerImpl === undefined) {
+                issues.push({
+                    severity: Severity.WARNING,
+                    field: `tools[${i}].handler`,
+                    message: 'Tool has no handler — will be a no-op on platforms without native tool support',
+                });
+            }
+        }
+    }
+    return issues;
+}
+function validateHandler(hookName, handler) {
+    const issues = [];
+    switch (handler.type) {
+        case 'command': {
+            if (!handler.command) {
+                issues.push({ severity: Severity.ERROR, field: `hooks.${hookName}.command`, message: 'Command string is required' });
+            }
+            // Check for dangerous patterns
+            if (handler.command?.includes('rm -rf /')) {
+                issues.push({ severity: Severity.WARNING, field: `hooks.${hookName}.command`, message: 'Command contains dangerous pattern "rm -rf /"' });
+            }
+            break;
+        }
+        case 'http': {
+            if (!handler.url) {
+                issues.push({ severity: Severity.ERROR, field: `hooks.${hookName}.url`, message: 'HTTP URL is required' });
+            }
+            else {
+                // Basic URL validation using pattern check
+                const urlPattern = /^https?:\/\/.+/;
+                if (!urlPattern.test(handler.url)) {
+                    issues.push({ severity: Severity.ERROR, field: `hooks.${hookName}.url`, message: `Invalid URL: ${handler.url}` });
+                }
+            }
+            break;
+        }
+        case 'inline': {
+            if (typeof handler.handler !== 'function') {
+                issues.push({ severity: Severity.ERROR, field: `hooks.${hookName}.handler`, message: 'Inline handler must be a function' });
+            }
+            break;
+        }
+        default: {
+            issues.push({ severity: Severity.ERROR, field: `hooks.${hookName}.type`, message: `Unknown handler type` });
+        }
+    }
+    return issues;
+}
+export function getPlatformConstraints(platform) {
+    const base = {
+        claude: {
+            maxNameLength: 64,
+            supportsHttpHandler: true,
+            supportsInlineHandler: false,
+            supportsPromptHandler: true,
+            supportsMCPToolHandler: true,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'sessionEnd', 'userPromptSubmit', 'userPromptExpansion',
+                'preToolUse', 'postToolUse', 'postToolUseFailure', 'permissionRequest',
+                'permissionDenied', 'subagentStart', 'subagentStop', 'preCompact',
+                'postCompact', 'stop', 'stopFailure', 'notification', 'fileChanged',
+                'cwdChanged', 'setup',
+            ],
+            manifestPath: '.claude-plugin/plugin.json',
+            requiresStrictValidation: false,
+            notes: ['5 handler types: command, http, mcp_tool, prompt, agent'],
+        },
+        codex: {
+            maxNameLength: 64,
+            supportsHttpHandler: false,
+            supportsInlineHandler: false,
+            supportsPromptHandler: false,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'subagentStart', 'preToolUse', 'permissionRequest',
+                'postToolUse', 'preCompact', 'postCompact', 'userPromptSubmit',
+                'subagentStop', 'stop',
+            ],
+            manifestPath: '.codex-plugin/plugin.json',
+            requiresStrictValidation: false,
+            notes: ['Hooks are command-based only (JSON stdin/stdout)'],
+        },
+        copilot: {
+            maxNameLength: 64,
+            supportsHttpHandler: true,
+            supportsInlineHandler: false,
+            supportsPromptHandler: true,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'sessionEnd', 'userPromptSubmit', 'preToolUse',
+                'postToolUse', 'postToolUseFailure', 'subagentStart', 'subagentStop',
+                'stop', 'preCompact', 'permissionRequest', 'notification',
+            ],
+            manifestPath: 'plugin.json',
+            requiresStrictValidation: true,
+            notes: ['preToolUse is fail-closed: errors/timeouts deny tool calls'],
+        },
+        gemini: {
+            maxNameLength: 64,
+            supportsHttpHandler: false,
+            supportsInlineHandler: false,
+            supportsPromptHandler: false,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'preToolUse', 'postToolUse', 'preCompact',
+                'notification', 'userPromptSubmit', 'subagentStart', 'subagentStop',
+                'stop',
+            ],
+            manifestPath: 'gemini-extension.json',
+            requiresStrictValidation: true,
+            notes: ['Uses exit codes: 0=success, 2=block, other=warning'],
+        },
+        kimi: {
+            maxNameLength: 64,
+            supportsHttpHandler: true,
+            supportsInlineHandler: false,
+            supportsPromptHandler: false,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'userPromptSubmit', 'preToolUse', 'permissionRequest',
+                'notification', 'stop',
+            ],
+            manifestPath: 'kimi.plugin.json',
+            requiresStrictValidation: true,
+            notes: ['Hooks are fail-open (not fail-closed like Copilot)'],
+        },
+        opencode: {
+            maxNameLength: 64,
+            supportsHttpHandler: false,
+            supportsInlineHandler: true,
+            supportsPromptHandler: false,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'sessionEnd', 'preToolUse', 'postToolUse',
+                'permissionRequest', 'notification', 'preCompact', 'stop',
+            ],
+            manifestPath: 'package.json', // Uses npm package.json + opencode.json
+            requiresStrictValidation: false,
+            notes: ['TypeScript-native, inline handlers only. Bun runtime.'],
+        },
+        pimono: {
+            maxNameLength: 64,
+            supportsHttpHandler: false,
+            supportsInlineHandler: true,
+            supportsPromptHandler: false,
+            supportsMCPToolHandler: false,
+            maxDescriptionLength: 1024,
+            supportedHooks: [
+                'sessionStart', 'sessionEnd', 'userPromptSubmit', 'preToolUse',
+                'postToolUse', 'permissionRequest', 'subagentStart', 'subagentStop',
+                'preCompact', 'postCompact', 'stop', 'stopFailure', 'notification',
+                'setup',
+            ],
+            manifestPath: 'package.json', // Uses package.json with "pi" key
+            requiresStrictValidation: false,
+            notes: ['TypeScript-native, inline handlers only. Uses ExtensionAPI pattern.'],
+        },
+    };
+    return base[platform];
+}
+export function validateForPlatform(plugin, platform) {
+    const constraints = getPlatformConstraints(platform);
+    const issues = [];
+    // Check unsupported hooks
+    if (plugin.hooks) {
+        for (const [name, def] of Object.entries(plugin.hooks)) {
+            const hookName = name;
+            if (!def)
+                continue;
+            if (!constraints.supportedHooks.includes(hookName)) {
+                issues.push({
+                    severity: Severity.WARNING,
+                    field: `hooks.${hookName}`,
+                    message: `"${hookName}" is not supported by ${platform} — this hook will be ignored`,
+                    suggestion: findNearestEquivalent(hookName, constraints.supportedHooks),
+                });
+            }
+            // Check handler type compatibility
+            const handler = def.handler;
+            if (handler.type === 'http' && !constraints.supportsHttpHandler) {
+                issues.push({
+                    severity: Severity.ERROR,
+                    field: `hooks.${hookName}.handler`,
+                    message: `HTTP handlers are not supported by ${platform}`,
+                    suggestion: 'Use "command" or "inline" handler type instead',
+                });
+            }
+            if (handler.type === 'inline' && !constraints.supportsInlineHandler) {
+                issues.push({
+                    severity: Severity.INFO,
+                    field: `hooks.${hookName}.handler`,
+                    message: `Inline handlers on ${platform} will be auto-wrapped as command scripts`,
+                });
+            }
+        }
+    }
+    // Check name length
+    if (plugin.name && plugin.name.length > constraints.maxNameLength) {
+        issues.push({
+            severity: Severity.ERROR,
+            field: 'name',
+            message: `Name "${plugin.name}" (${plugin.name.length} chars) exceeds ${platform} limit of ${constraints.maxNameLength}`,
+        });
+    }
+    // Check description length
+    if (plugin.description && plugin.description.length > constraints.maxDescriptionLength) {
+        issues.push({
+            severity: Severity.WARNING,
+            field: 'description',
+            message: `Description may be truncated on ${platform} (max ${constraints.maxDescriptionLength} chars)`,
+        });
+    }
+    return issues;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '')
+        .toLowerCase()
+        .replace(/^-+|-+$/g, '')
+        .replace(/-+/g, '-');
+}
+function findNearestEquivalent(hook, supported) {
+    // Map of known equivalents
+    const equivalents = {
+        userPromptExpansion: 'userPromptSubmit',
+        permissionDenied: 'permissionRequest',
+        postToolUseFailure: 'postToolUse',
+        setup: 'sessionStart',
+        cwdChanged: 'fileChanged',
+        stopFailure: 'stop',
+    };
+    const equiv = equivalents[hook];
+    if (equiv && supported.includes(equiv)) {
+        return `Use "${equiv}" instead, which is supported by this platform`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@agentplugins/core",
+  "version": "0.1.0",
+  "description": "Core types, validation, and plugin registry for AgentPlugins",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "test:run": "vitest run __tests__/placeholder.test.ts"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agentplugins",
+    "ai",
+    "plugin",
+    "core"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.4"
+  }
+}