@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/plugins/index.d.ts

@@ -0,0 +1,512 @@
+/**
+ * External Tool Plugins
+ *
+ * Plugin system for integrating with external AI coding tools.
+ *
+ * Structure:
+ * - schemas/       - Manifest schemas and validation
+ * - tools/         - Framework-owned external tool manifests
+ * - installers/    - Registry-level installers for MCP, hooks, plugins
+ *
+ * Note: tools are now represented as runtime assets (`external/host`).
+ * Built-in manifests remain as metadata for installers/detection.
+ */
+export { toolCategorySchema, mcpTransportSchema, configFormatSchema, hookLifecycleEventSchema, platformSchema, pathTemplateSchema, configLocationSchema, assetPathsSchema, mcpCapabilitiesSchema, hookCapabilitiesSchema, pluginCapabilitiesSchema, skillsCapabilitiesSchema, detectionConfigSchema, integrationPointsSchema, externalHostManifestSchema, validateManifest, createManifest } from './schemas/index.ts';
+export type { ToolCategory, McpTransport, ConfigFormat, HookEvent, Platform, PathTemplate, ConfigLocation, AssetPaths, McpCapabilities, HookCapabilities, PluginCapabilities, SkillsCapabilities, DetectionConfig, IntegrationPoints, ExternalHostManifest } from './schemas/index.ts';
+export { builtinManifests, builtinToolIds, getBuiltinManifest, getAllBuiltinManifests, getMcpCapableBuiltins, getBuiltinsByCategory } from './tools/index.ts';
+export { JsonMcpInstaller, TomlMcpInstaller, getMcpInstaller, getAllMcpInstallers, ShellHooksInstaller, getHooksInstaller, getAllHooksInstallers, installMcpForTool, isMcpConfiguredForTool, uninstallMcpForTool, installHooksForTool, uninstallHooksForTool, generateHooksForTool, getMcpConfigPath, getHooksDir } from './installers/index.ts';
+export type { InstallResult, McpInstallOptions, McpInstallResult, HooksInstallOptions, HooksInstallResult, HooksGenerateOptions, HooksGenerateResult } from './installers/index.ts';
+import * as _schemas from './schemas/index.ts';
+import * as _installers from './installers/index.ts';
+export declare const plugins: {
+    externalInstallRoots(runtime: import("@vibesdotdev/kernel").VibesRuntime, scope: {
+        global: boolean;
+        projectDir?: string;
+    }): Promise<import("./installers/types.ts").ExternalInstallTarget>;
+    installMcpForTool(manifest: _schemas.ExternalHostManifest, options: Omit<_installers.McpInstallOptions, "manifest">, runtime: import("@vibesdotdev/kernel").VibesRuntime): Promise<_installers.McpInstallResult>;
+    isMcpConfiguredForTool(runtime: import("@vibesdotdev/kernel").VibesRuntime, manifest: _schemas.ExternalHostManifest, global: boolean, projectDir?: string): Promise<boolean>;
+    uninstallMcpForTool(runtime: import("@vibesdotdev/kernel").VibesRuntime, manifest: _schemas.ExternalHostManifest, global: boolean, projectDir?: string): Promise<_installers.InstallResult>;
+    installHooksForTool(manifest: _schemas.ExternalHostManifest, options: Omit<_installers.HooksInstallOptions, "manifest">, runtime: import("@vibesdotdev/kernel").VibesRuntime): Promise<_installers.HooksInstallResult>;
+    generateHooksForTool(manifest: _schemas.ExternalHostManifest, options: Omit<_installers.HooksGenerateOptions, "manifest">, runtime: import("@vibesdotdev/kernel").VibesRuntime): Promise<_installers.HooksGenerateResult>;
+    uninstallHooksForTool(runtime: import("@vibesdotdev/kernel").VibesRuntime, manifest: _schemas.ExternalHostManifest, global: boolean, projectDir?: string, options?: _installers.HooksUninstallOptions): Promise<_installers.InstallResult>;
+    getMcpConfigPath(manifest: _schemas.ExternalHostManifest, global: boolean, roots: _installers.ExternalInstallRoots): string | undefined;
+    getHooksDir(manifest: _schemas.ExternalHostManifest, global: boolean, roots: _installers.ExternalInstallRoots): string | undefined;
+    mcpInstallerConfigSchema: import("zod").ZodObject<{
+        configTemplate: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+        defaultTransport: import("zod").ZodDefault<import("zod").ZodEnum<{
+            http: "http";
+            stdio: "stdio";
+            sse: "sse";
+        }>>;
+        envVars: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    hooksInstallerConfigSchema: import("zod").ZodObject<{
+        templates: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        hooksDir: import("zod").ZodDefault<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    pluginInstallerConfigSchema: import("zod").ZodObject<{
+        template: import("zod").ZodOptional<import("zod").ZodString>;
+        entryPoint: import("zod").ZodDefault<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    JsonMcpInstaller: typeof _installers.JsonMcpInstaller;
+    TomlMcpInstaller: typeof _installers.TomlMcpInstaller;
+    getTomlMcpServerConfigIssues: typeof _installers.getTomlMcpServerConfigIssues;
+    getMcpInstaller: typeof _installers.getMcpInstaller;
+    getAllMcpInstallers: typeof _installers.getAllMcpInstallers;
+    ShellHooksInstaller: typeof _installers.ShellHooksInstaller;
+    getHooksInstaller: typeof _installers.getHooksInstaller;
+    getAllHooksInstallers: typeof _installers.getAllHooksInstallers;
+    getBuiltinManifest(id: string): _schemas.ExternalHostManifest | undefined;
+    getAllBuiltinManifests(): _schemas.ExternalHostManifest[];
+    getMcpCapableBuiltins(): _schemas.ExternalHostManifest[];
+    getBuiltinsByCategory(category: string): _schemas.ExternalHostManifest[];
+    builtinManifests: Record<string, _schemas.ExternalHostManifest>;
+    builtinToolIds: string[];
+    toolCategorySchema: import("zod").ZodEnum<{
+        cli: "cli";
+        "ide-extension": "ide-extension";
+        "ide-native": "ide-native";
+    }>;
+    mcpTransportSchema: import("zod").ZodEnum<{
+        http: "http";
+        stdio: "stdio";
+        sse: "sse";
+    }>;
+    configFormatSchema: import("zod").ZodEnum<{
+        json: "json";
+        yaml: "yaml";
+        jsonc: "jsonc";
+        toml: "toml";
+    }>;
+    hookLifecycleEventSchema: import("zod").ZodEnum<{
+        "session.start": "session.start";
+        "session.end": "session.end";
+        "prompt.submit": "prompt.submit";
+        "tool.before": "tool.before";
+        "tool.after": "tool.after";
+        "context.beforeCompact": "context.beforeCompact";
+        "context.afterCompact": "context.afterCompact";
+        "permission.request": "permission.request";
+        "agent.stop": "agent.stop";
+        "subagent.stop": "subagent.stop";
+        notification: "notification";
+    }>;
+    platformSchema: import("zod").ZodEnum<{
+        all: "all";
+        win32: "win32";
+        darwin: "darwin";
+        linux: "linux";
+    }>;
+    pathTemplateSchema: import("zod").ZodString;
+    configLocationSchema: import("zod").ZodObject<{
+        path: import("zod").ZodString;
+        format: import("zod").ZodEnum<{
+            json: "json";
+            yaml: "yaml";
+            jsonc: "jsonc";
+            toml: "toml";
+        }>;
+        scope: import("zod").ZodEnum<{
+            global: "global";
+            project: "project";
+        }>;
+        platform: import("zod").ZodOptional<import("zod").ZodEnum<{
+            all: "all";
+            win32: "win32";
+            darwin: "darwin";
+            linux: "linux";
+        }>>;
+        mcpPath: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    assetPathsSchema: import("zod").ZodObject<{
+        hooks: import("zod").ZodOptional<import("zod").ZodString>;
+        plugins: import("zod").ZodOptional<import("zod").ZodString>;
+        commands: import("zod").ZodOptional<import("zod").ZodString>;
+        agents: import("zod").ZodOptional<import("zod").ZodString>;
+        templates: import("zod").ZodOptional<import("zod").ZodString>;
+        skills: import("zod").ZodOptional<import("zod").ZodString>;
+        settings: import("zod").ZodOptional<import("zod").ZodString>;
+        globalSettings: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    mcpCapabilitiesSchema: import("zod").ZodObject<{
+        supported: import("zod").ZodBoolean;
+        transports: import("zod").ZodArray<import("zod").ZodEnum<{
+            http: "http";
+            stdio: "stdio";
+            sse: "sse";
+        }>>;
+        defaultServerName: import("zod").ZodDefault<import("zod").ZodString>;
+        projectConfig: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        envVarsInConfig: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        options: import("zod").ZodOptional<import("zod").ZodObject<{
+            startupTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            toolTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            autoRestart: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    hookCapabilitiesSchema: import("zod").ZodObject<{
+        supported: import("zod").ZodBoolean;
+        events: import("zod").ZodArray<import("zod").ZodEnum<{
+            "session.start": "session.start";
+            "session.end": "session.end";
+            "prompt.submit": "prompt.submit";
+            "tool.before": "tool.before";
+            "tool.after": "tool.after";
+            "context.beforeCompact": "context.beforeCompact";
+            "context.afterCompact": "context.afterCompact";
+            "permission.request": "permission.request";
+            "agent.stop": "agent.stop";
+            "subagent.stop": "subagent.stop";
+            notification: "notification";
+        }>>;
+        nativeEventMap: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodEnum<{
+            "session.start": "session.start";
+            "session.end": "session.end";
+            "prompt.submit": "prompt.submit";
+            "tool.before": "tool.before";
+            "tool.after": "tool.after";
+            "context.beforeCompact": "context.beforeCompact";
+            "context.afterCompact": "context.afterCompact";
+            "permission.request": "permission.request";
+            "agent.stop": "agent.stop";
+            "subagent.stop": "subagent.stop";
+            notification: "notification";
+        }>>>;
+        format: import("zod").ZodOptional<import("zod").ZodEnum<{
+            json: "json";
+            typescript: "typescript";
+            shell: "shell";
+            python: "python";
+        }>>;
+        structuredInput: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        canModify: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        trust: import("zod").ZodOptional<import("zod").ZodObject<{
+            step: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    pluginCapabilitiesSchema: import("zod").ZodObject<{
+        supported: import("zod").ZodBoolean;
+        format: import("zod").ZodOptional<import("zod").ZodEnum<{
+            typescript: "typescript";
+            python: "python";
+            javascript: "javascript";
+            lua: "lua";
+        }>>;
+        entryPoint: import("zod").ZodOptional<import("zod").ZodString>;
+        manifestFile: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    skillsCapabilitiesSchema: import("zod").ZodObject<{
+        supported: import("zod").ZodBoolean;
+        format: import("zod").ZodDefault<import("zod").ZodEnum<{
+            "agents-md": "agents-md";
+        }>>;
+        projectScoped: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        globalPath: import("zod").ZodOptional<import("zod").ZodString>;
+        projectPath: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    detectionConfigSchema: import("zod").ZodObject<{
+        command: import("zod").ZodOptional<import("zod").ZodString>;
+        altCommands: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        configDir: import("zod").ZodOptional<import("zod").ZodString>;
+        binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+        versionArgs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        versionRegex: import("zod").ZodOptional<import("zod").ZodString>;
+        platformPaths: import("zod").ZodOptional<import("zod").ZodObject<{
+            darwin: import("zod").ZodOptional<import("zod").ZodObject<{
+                binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                configDir: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+            linux: import("zod").ZodOptional<import("zod").ZodObject<{
+                binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                configDir: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+            win32: import("zod").ZodOptional<import("zod").ZodObject<{
+                binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                configDir: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
+        extensionMatch: import("zod").ZodOptional<import("zod").ZodObject<{
+            dir: import("zod").ZodString;
+            prefixes: import("zod").ZodArray<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    integrationPointsSchema: import("zod").ZodObject<{
+        mcp: import("zod").ZodOptional<import("zod").ZodObject<{
+            installer: import("zod").ZodOptional<import("zod").ZodString>;
+            configTemplate: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+        }, import("zod/v4/core").$strip>>;
+        hooks: import("zod").ZodOptional<import("zod").ZodObject<{
+            installer: import("zod").ZodOptional<import("zod").ZodString>;
+            templates: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }> & import("zod/v4/core").$partial, import("zod").ZodString>>;
+            handlerOptions: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }> & import("zod/v4/core").$partial, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>>;
+            hookAdapterId: import("zod").ZodOptional<import("zod").ZodString>;
+            workspaceRootEnv: import("zod").ZodOptional<import("zod").ZodString>;
+            defaultPromptPolicy: import("zod").ZodDefault<import("zod").ZodEnum<{
+                default: "default";
+                none: "none";
+                "custom-only": "custom-only";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        plugins: import("zod").ZodOptional<import("zod").ZodObject<{
+            installer: import("zod").ZodOptional<import("zod").ZodString>;
+            template: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        presets: import("zod").ZodOptional<import("zod").ZodObject<{
+            available: import("zod").ZodArray<import("zod").ZodString>;
+            default: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    externalHostManifestSchema: import("zod").ZodObject<{
+        schemaVersion: import("zod").ZodLiteral<"1.0">;
+        id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        hostAliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        shortName: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodString;
+        category: import("zod").ZodEnum<{
+            cli: "cli";
+            "ide-extension": "ide-extension";
+            "ide-native": "ide-native";
+        }>;
+        website: import("zod").ZodURL;
+        platforms: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodEnum<{
+            all: "all";
+            win32: "win32";
+            darwin: "darwin";
+            linux: "linux";
+        }>>>;
+        configs: import("zod").ZodArray<import("zod").ZodObject<{
+            path: import("zod").ZodString;
+            format: import("zod").ZodEnum<{
+                json: "json";
+                yaml: "yaml";
+                jsonc: "jsonc";
+                toml: "toml";
+            }>;
+            scope: import("zod").ZodEnum<{
+                global: "global";
+                project: "project";
+            }>;
+            platform: import("zod").ZodOptional<import("zod").ZodEnum<{
+                all: "all";
+                win32: "win32";
+                darwin: "darwin";
+                linux: "linux";
+            }>>;
+            mcpPath: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        assets: import("zod").ZodOptional<import("zod").ZodObject<{
+            hooks: import("zod").ZodOptional<import("zod").ZodString>;
+            plugins: import("zod").ZodOptional<import("zod").ZodString>;
+            commands: import("zod").ZodOptional<import("zod").ZodString>;
+            agents: import("zod").ZodOptional<import("zod").ZodString>;
+            templates: import("zod").ZodOptional<import("zod").ZodString>;
+            skills: import("zod").ZodOptional<import("zod").ZodString>;
+            settings: import("zod").ZodOptional<import("zod").ZodString>;
+            globalSettings: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        mcp: import("zod").ZodObject<{
+            supported: import("zod").ZodBoolean;
+            transports: import("zod").ZodArray<import("zod").ZodEnum<{
+                http: "http";
+                stdio: "stdio";
+                sse: "sse";
+            }>>;
+            defaultServerName: import("zod").ZodDefault<import("zod").ZodString>;
+            projectConfig: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            envVarsInConfig: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            options: import("zod").ZodOptional<import("zod").ZodObject<{
+                startupTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                toolTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                autoRestart: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        hooks: import("zod").ZodObject<{
+            supported: import("zod").ZodBoolean;
+            events: import("zod").ZodArray<import("zod").ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }>>;
+            nativeEventMap: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }>>>;
+            format: import("zod").ZodOptional<import("zod").ZodEnum<{
+                json: "json";
+                typescript: "typescript";
+                shell: "shell";
+                python: "python";
+            }>>;
+            structuredInput: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            canModify: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            trust: import("zod").ZodOptional<import("zod").ZodObject<{
+                step: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        plugins: import("zod").ZodObject<{
+            supported: import("zod").ZodBoolean;
+            format: import("zod").ZodOptional<import("zod").ZodEnum<{
+                typescript: "typescript";
+                python: "python";
+                javascript: "javascript";
+                lua: "lua";
+            }>>;
+            entryPoint: import("zod").ZodOptional<import("zod").ZodString>;
+            manifestFile: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        skills: import("zod").ZodDefault<import("zod").ZodObject<{
+            supported: import("zod").ZodBoolean;
+            format: import("zod").ZodDefault<import("zod").ZodEnum<{
+                "agents-md": "agents-md";
+            }>>;
+            projectScoped: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            globalPath: import("zod").ZodOptional<import("zod").ZodString>;
+            projectPath: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        detection: import("zod").ZodObject<{
+            command: import("zod").ZodOptional<import("zod").ZodString>;
+            altCommands: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            configDir: import("zod").ZodOptional<import("zod").ZodString>;
+            binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+            versionArgs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            versionRegex: import("zod").ZodOptional<import("zod").ZodString>;
+            platformPaths: import("zod").ZodOptional<import("zod").ZodObject<{
+                darwin: import("zod").ZodOptional<import("zod").ZodObject<{
+                    binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                    configDir: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                linux: import("zod").ZodOptional<import("zod").ZodObject<{
+                    binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                    configDir: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                win32: import("zod").ZodOptional<import("zod").ZodObject<{
+                    binaryPath: import("zod").ZodOptional<import("zod").ZodString>;
+                    configDir: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>>;
+            extensionMatch: import("zod").ZodOptional<import("zod").ZodObject<{
+                dir: import("zod").ZodString;
+                prefixes: import("zod").ZodArray<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        launch: import("zod").ZodOptional<import("zod").ZodObject<{
+            defaultMode: import("zod").ZodDefault<import("zod").ZodString>;
+            modes: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodArray<import("zod").ZodString>, import("zod").ZodObject<{
+                command: import("zod").ZodOptional<import("zod").ZodString>;
+                argv: import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                    when: import("zod").ZodString;
+                    args: import("zod").ZodArray<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>]>>;
+                stdin: import("zod").ZodDefault<import("zod").ZodEnum<{
+                    null: "null";
+                    inherit: "inherit";
+                }>>;
+                structuredOutput: import("zod").ZodOptional<import("zod").ZodObject<{
+                    field: import("zod").ZodString;
+                    schemaTarget: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        "draft-2020-12": "draft-2020-12";
+                        "draft-7": "draft-7";
+                    }>>;
+                    wrap: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>]>>;
+        }, import("zod/v4/core").$strip>>;
+        integration: import("zod").ZodObject<{
+            mcp: import("zod").ZodOptional<import("zod").ZodObject<{
+                installer: import("zod").ZodOptional<import("zod").ZodString>;
+                configTemplate: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+            }, import("zod/v4/core").$strip>>;
+            hooks: import("zod").ZodOptional<import("zod").ZodObject<{
+                installer: import("zod").ZodOptional<import("zod").ZodString>;
+                templates: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodEnum<{
+                    "session.start": "session.start";
+                    "session.end": "session.end";
+                    "prompt.submit": "prompt.submit";
+                    "tool.before": "tool.before";
+                    "tool.after": "tool.after";
+                    "context.beforeCompact": "context.beforeCompact";
+                    "context.afterCompact": "context.afterCompact";
+                    "permission.request": "permission.request";
+                    "agent.stop": "agent.stop";
+                    "subagent.stop": "subagent.stop";
+                    notification: "notification";
+                }> & import("zod/v4/core").$partial, import("zod").ZodString>>;
+                handlerOptions: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodEnum<{
+                    "session.start": "session.start";
+                    "session.end": "session.end";
+                    "prompt.submit": "prompt.submit";
+                    "tool.before": "tool.before";
+                    "tool.after": "tool.after";
+                    "context.beforeCompact": "context.beforeCompact";
+                    "context.afterCompact": "context.afterCompact";
+                    "permission.request": "permission.request";
+                    "agent.stop": "agent.stop";
+                    "subagent.stop": "subagent.stop";
+                    notification: "notification";
+                }> & import("zod/v4/core").$partial, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>>;
+                hookAdapterId: import("zod").ZodOptional<import("zod").ZodString>;
+                workspaceRootEnv: import("zod").ZodOptional<import("zod").ZodString>;
+                defaultPromptPolicy: import("zod").ZodDefault<import("zod").ZodEnum<{
+                    default: "default";
+                    none: "none";
+                    "custom-only": "custom-only";
+                }>>;
+            }, import("zod/v4/core").$strip>>;
+            plugins: import("zod").ZodOptional<import("zod").ZodObject<{
+                installer: import("zod").ZodOptional<import("zod").ZodString>;
+                template: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+            presets: import("zod").ZodOptional<import("zod").ZodObject<{
+                available: import("zod").ZodArray<import("zod").ZodString>;
+                default: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        version: import("zod").ZodDefault<import("zod").ZodString>;
+        metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, import("zod/v4/core").$strip>;
+    validateManifest: typeof _schemas.validateManifest;
+    createManifest: typeof _schemas.createManifest;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,EACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AACrD,eAAO,MAAM,OAAO;;;kBACwhB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD5e,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,25 @@
+/**
+ * External Tool Plugins
+ *
+ * Plugin system for integrating with external AI coding tools.
+ *
+ * Structure:
+ * - schemas/       - Manifest schemas and validation
+ * - tools/         - Framework-owned external tool manifests
+ * - installers/    - Registry-level installers for MCP, hooks, plugins
+ *
+ * Note: tools are now represented as runtime assets (`external/host`).
+ * Built-in manifests remain as metadata for installers/detection.
+ */
+// Schemas
+export { toolCategorySchema, mcpTransportSchema, configFormatSchema, hookLifecycleEventSchema, platformSchema, pathTemplateSchema, configLocationSchema, assetPathsSchema, mcpCapabilitiesSchema, hookCapabilitiesSchema, pluginCapabilitiesSchema, skillsCapabilitiesSchema, detectionConfigSchema, integrationPointsSchema, externalHostManifestSchema, validateManifest, createManifest } from "./schemas/index.js";
+// Built-in tools
+export { builtinManifests, builtinToolIds, getBuiltinManifest, getAllBuiltinManifests, getMcpCapableBuiltins, getBuiltinsByCategory } from "./tools/index.js";
+// Installers
+export { JsonMcpInstaller, TomlMcpInstaller, getMcpInstaller, getAllMcpInstallers, ShellHooksInstaller, getHooksInstaller, getAllHooksInstallers, installMcpForTool, isMcpConfiguredForTool, uninstallMcpForTool, installHooksForTool, uninstallHooksForTool, generateHooksForTool, getMcpConfigPath, getHooksDir } from "./installers/index.js";
+// Namespace export for consumers that use `import { plugins } from '...'`
+import * as _schemas from "./schemas/index.js";
+import * as _tools from "./tools/index.js";
+import * as _installers from "./installers/index.js";
+export const plugins = { ..._schemas, ..._tools, ..._installers };
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,UAAU;AACV,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,EACd,MAAM,oBAAoB,CAAC;AAoB5B,iBAAiB;AACjB,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,aAAa;AACb,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,MAAM,uBAAuB,CAAC;AAY/B,0EAA0E;AAC1E,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC"}

package/dist/plugins/installers/config-file.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Config-file I/O for the installers, through the runtime's filesystem.
+ *
+ * A read answers absence (`null`) and refuses every other failure typed
+ * (`UNAVAILABLE` `config-unreadable`, path only). A write is an atomic
+ * replace: the new text goes to a sibling temp file which is then renamed
+ * over the target, so a reader (or a crash) sees the old document or the new
+ * one, never a truncated one.
+ */
+import { type ExternalFileSystem } from '../../utils/runtime-fs.ts';
+/** The config text at `path`, `null` when absent; any other failure is refused `config-unreadable`. */
+export declare function readConfigText(fs: ExternalFileSystem, path: string): Promise<string | null>;
+/** The sibling temp path one atomic write stages its text in. */
+export declare function stagingPathFor(path: string): string;
+/**
+ * Replace the file at `path` with `text` atomically: create its directory,
+ * write a sibling staging file, rename it over the target. A failed rename
+ * removes the staging file and rethrows the rename's failure.
+ */
+export declare function writeConfigAtomically(fs: ExternalFileSystem, path: string, text: string): Promise<void>;
+//# sourceMappingURL=config-file.d.ts.map

package/dist/plugins/installers/config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/config-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,uGAAuG;AACvG,wBAAsB,cAAc,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWjG;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7G"}

package/dist/plugins/installers/config-file.js

@@ -0,0 +1,48 @@
+/**
+ * Config-file I/O for the installers, through the runtime's filesystem.
+ *
+ * A read answers absence (`null`) and refuses every other failure typed
+ * (`UNAVAILABLE` `config-unreadable`, path only). A write is an atomic
+ * replace: the new text goes to a sibling temp file which is then renamed
+ * over the target, so a reader (or a crash) sees the old document or the new
+ * one, never a truncated one.
+ */
+import { dirname } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { readTextIfPresent } from "../../utils/runtime-fs.js";
+/** The config text at `path`, `null` when absent; any other failure is refused `config-unreadable`. */
+export async function readConfigText(fs, path) {
+    try {
+        return await readTextIfPresent(fs, path);
+    }
+    catch (error) {
+        throw new CapabilityError(`Cannot read MCP config at ${path}.`, 'UNAVAILABLE', {
+            reason: 'config-unreadable',
+            retryable: false,
+            details: { path },
+            cause: CaughtFailureSchema.parse(error)
+        });
+    }
+}
+/** The sibling temp path one atomic write stages its text in. */
+export function stagingPathFor(path) {
+    return `${path}.vibes-staging-${globalThis.crypto.randomUUID()}`;
+}
+/**
+ * Replace the file at `path` with `text` atomically: create its directory,
+ * write a sibling staging file, rename it over the target. A failed rename
+ * removes the staging file and rethrows the rename's failure.
+ */
+export async function writeConfigAtomically(fs, path, text) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const staging = stagingPathFor(path);
+    await fs.writeFile(staging, text);
+    try {
+        await fs.rename(staging, path);
+    }
+    catch (error) {
+        await fs.remove(staging);
+        throw error;
+    }
+}
+//# sourceMappingURL=config-file.js.map

package/dist/plugins/installers/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../src/plugins/installers/config-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAA2B,MAAM,2BAA2B,CAAC;AAEvF,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAsB,EAAE,IAAY;IACxE,IAAI,CAAC;QACJ,OAAO,MAAM,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,6BAA6B,IAAI,GAAG,EAAE,aAAa,EAAE;YAC9E,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,IAAI,EAAE;YACjB,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,GAAG,IAAI,kBAAkB,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAsB,EAAE,IAAY,EAAE,IAAY;IAC7F,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC;QACJ,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC"}