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

package/dist/plugins/installers/runtime.d.ts

@@ -0,0 +1,42 @@
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { HooksInstaller, McpInstaller } from './types.ts';
+export declare const EXTERNAL_CONFIG_INSTALLER_KIND: "external/config-installer";
+export declare const ExternalConfigInstallerDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"external/config-installer">;
+    installerType: z.ZodEnum<{
+        mcp: "mcp";
+        hooks: "hooks";
+    }>;
+    formats: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ExternalConfigInstallerDescriptor = z.infer<typeof ExternalConfigInstallerDescriptorSchema>;
+export type ExternalConfigInstaller = McpInstaller | HooksInstaller;
+export declare const externalConfigInstallerKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<unknown>;
+export declare const jsonMcpInstallerDescriptor: ExternalConfigInstallerDescriptor;
+export declare const tomlMcpInstallerDescriptor: ExternalConfigInstallerDescriptor;
+export declare const yamlMcpInstallerDescriptor: ExternalConfigInstallerDescriptor;
+export declare const shellHooksInstallerDescriptor: ExternalConfigInstallerDescriptor;
+export declare function resolveExternalConfigInstaller<T extends ExternalConfigInstaller>(installerType: ExternalConfigInstallerDescriptor['installerType'], format: string, runtime: VibesRuntime): Promise<T | undefined>;
+export declare function listExternalConfigInstallers<T extends ExternalConfigInstaller>(installerType: ExternalConfigInstallerDescriptor['installerType'], runtime: VibesRuntime): Promise<T[]>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/plugins/installers/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAEN,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,8BAA8B,EAAG,2BAAoC,CAAC;AAEnF,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlD,CAAC;AAEH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,uCAAuC,CAC9C,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,cAAc,CAAC;AAEpE,eAAO,MAAM,2BAA2B,oEAGtC,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,iCAOtC,CAAC;AAEJ,eAAO,MAAM,0BAA0B,EAAE,iCAOtC,CAAC;AAEJ,eAAO,MAAM,0BAA0B,EAAE,iCAOtC,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,iCAOzC,CAAC;AAEJ,wBAAsB,8BAA8B,CAAC,CAAC,SAAS,uBAAuB,EACrF,aAAa,EAAE,iCAAiC,CAAC,eAAe,CAAC,EACjE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAOxB;AAED,wBAAsB,4BAA4B,CAAC,CAAC,SAAS,uBAAuB,EACnF,aAAa,EAAE,iCAAiC,CAAC,eAAe,CAAC,EACjE,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CAUd"}

package/dist/plugins/installers/runtime.js

@@ -0,0 +1,56 @@
+import * as z from 'zod/v4';
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+export const EXTERNAL_CONFIG_INSTALLER_KIND = 'external/config-installer';
+export const ExternalConfigInstallerDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(EXTERNAL_CONFIG_INSTALLER_KIND),
+    installerType: z.enum(['mcp', 'hooks']),
+    formats: z.array(z.string().trim().min(1)).min(1)
+});
+export const externalConfigInstallerKind = createRuntimeKind({
+    id: EXTERNAL_CONFIG_INSTALLER_KIND,
+    descriptorSchema: ExternalConfigInstallerDescriptorSchema
+});
+export const jsonMcpInstallerDescriptor = ExternalConfigInstallerDescriptorSchema.parse({
+    id: 'external.config-installer.mcp.json',
+    kind: EXTERNAL_CONFIG_INSTALLER_KIND,
+    installerType: 'mcp',
+    formats: ['json', 'jsonc'],
+    hardware: ['consumer']
+});
+export const tomlMcpInstallerDescriptor = ExternalConfigInstallerDescriptorSchema.parse({
+    id: 'external.config-installer.mcp.toml',
+    kind: EXTERNAL_CONFIG_INSTALLER_KIND,
+    installerType: 'mcp',
+    formats: ['toml'],
+    hardware: ['consumer']
+});
+export const yamlMcpInstallerDescriptor = ExternalConfigInstallerDescriptorSchema.parse({
+    id: 'external.config-installer.mcp.yaml',
+    kind: EXTERNAL_CONFIG_INSTALLER_KIND,
+    installerType: 'mcp',
+    formats: ['yaml'],
+    hardware: ['consumer']
+});
+export const shellHooksInstallerDescriptor = ExternalConfigInstallerDescriptorSchema.parse({
+    id: 'external.config-installer.hooks.shell',
+    kind: EXTERNAL_CONFIG_INSTALLER_KIND,
+    installerType: 'hooks',
+    formats: ['shell'],
+    hardware: ['consumer']
+});
+export async function resolveExternalConfigInstaller(installerType, format, runtime) {
+    const query = runtime.query(EXTERNAL_CONFIG_INSTALLER_KIND);
+    const descriptor = (await query.descriptorsAsync()).find((candidate) => candidate.installerType === installerType && candidate.formats.includes(format));
+    if (!descriptor)
+        return undefined;
+    return runtime.query(EXTERNAL_CONFIG_INSTALLER_KIND).withId(descriptor.id).resolve();
+}
+export async function listExternalConfigInstallers(installerType, runtime) {
+    const query = runtime.query(EXTERNAL_CONFIG_INSTALLER_KIND);
+    const descriptors = await query.descriptorsAsync();
+    return Promise.all(descriptors
+        .filter((descriptor) => descriptor.installerType === installerType)
+        .map((descriptor) => runtime.query(EXTERNAL_CONFIG_INSTALLER_KIND).withId(descriptor.id).resolve()));
+}
+//# sourceMappingURL=runtime.js.map

package/dist/plugins/installers/runtime.js.map

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

package/dist/plugins/installers/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Installer Types
+ *
+ * Defines interfaces for tool installers that the registry uses.
+ * Installers are registered by ID and manifests reference them.
+ */
+import * as z from 'zod/v4';
+import type { ToolTier } from '../../schemas/tiers.ts';
+import type { ExternalHostManifest, ConfigFormat, HookEvent } from '../schemas/manifest.ts';
+import type { McpEnvironmentTier } from './mcp/environment.ts';
+import type { PathTemplateRoots } from '../../external-tool/path-template.ts';
+import type { ExternalFileSystem } from '../../utils/runtime-fs.ts';
+import type { ConfigObject } from './config-value.ts';
+import type { ValueFreeFailure } from '@vibesdotdev/kernel';
+/**
+ * Result of an installation operation
+ */
+export interface InstallResult {
+    success: boolean;
+    message: string;
+    error?: string;
+    details?: ConfigObject;
+    /** The caught failure behind an unsuccessful result, value-free (class name, code, reason). */
+    failure?: ValueFreeFailure;
+}
+/**
+ * The filesystem roots an installer resolves its paths against: the runtime's
+ * `paths/roots` (`userHome`, `vibesHome`) and the project directory (the
+ * caller's explicit one, else the bound `runtime/workspace-path`). Installers
+ * read no host fact themselves; the caller that holds the runtime hands these
+ * in.
+ */
+export interface ExternalInstallRoots extends PathTemplateRoots {
+    /** Machine-level Vibes home: the shared hook dispatcher and the MCP identity env. */
+    readonly vibesHome: string;
+}
+/**
+ * The roots an install acts on plus the runtime filesystem it reads and
+ * writes through (the handed runtime's unbound adapter). Installers take no
+ * host filesystem of their own.
+ */
+export interface ExternalInstallTarget extends ExternalInstallRoots {
+    readonly fs: ExternalFileSystem;
+    /**
+     * Give a written script owner-execute permissions (a hook script the
+     * harness executes directly). A no-op where the platform has no mode bits.
+     */
+    makeExecutable(path: string): Promise<void>;
+}
+/**
+ * Base context passed to all installers
+ */
+export interface InstallerContext {
+    /** The tool manifest */
+    manifest: ExternalHostManifest;
+    /**
+     * Explicit project directory. When set, the written MCP server is pinned to
+     * it (`--workspace-root`); path resolution uses {@link ExternalInstallRoots}.
+     */
+    projectDir?: string;
+    /** Whether to install globally or per-project */
+    global: boolean;
+    /** Dry run - don't make changes */
+    dryRun: boolean;
+    /** Force overwrite existing config */
+    force: boolean;
+}
+/**
+ * MCP installer configuration from manifest
+ */
+export declare const mcpInstallerConfigSchema: z.ZodObject<{
+    configTemplate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+    defaultTransport: z.ZodDefault<z.ZodEnum<{
+        http: "http";
+        stdio: "stdio";
+        sse: "sse";
+    }>>;
+    envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type McpInstallerConfig = z.infer<typeof mcpInstallerConfigSchema>;
+/**
+ * Options for MCP installation
+ */
+export interface McpInstallOptions extends InstallerContext {
+    /** Resolved base command for the active Vibes CLI (may include a runner argument). */
+    vibesPath?: string;
+    /** Bearer for a remote http MCP server's `Authorization` header (global scope only); never published into env. */
+    authToken?: string;
+    /** Transport mode override */
+    transport?: 'stdio' | 'http' | 'sse';
+    /** Server name override */
+    serverName?: string;
+    /** Tool tier for agent-pack MCP/skills surface */
+    tier?: ToolTier;
+    /**
+     * MCP server capability profile. This is deliberately separate from the
+     * host identity: Codex can serve the `full` profile while remaining the
+     * `codex` participant for continuity and storage.
+     */
+    mcpClientId?: string;
+    /** When true (default), build MCP config from agent pack IR */
+    useAgentPack?: boolean;
+    /** Pre-built server config (from agent pack); skips env-based build */
+    serverConfigOverride?: ConfigObject;
+}
+/**
+ * Result of MCP installation
+ */
+export interface McpInstallResult extends InstallResult {
+    configPath: string;
+    created: boolean;
+    updated: boolean;
+    serverName: string;
+    /** Agent pack snapshot paths written alongside MCP config */
+    filesCreated?: string[];
+    filesModified?: string[];
+    /**
+     * True when this install removed a previously published `VIBES_AUTH_TOKEN`:
+     * the MCP server's identity changed to the host's signed-in caller.
+     */
+    removedPublishedBearer?: boolean;
+}
+/**
+ * MCP Installer interface
+ */
+export interface McpInstaller {
+    readonly id: string;
+    readonly supportedFormats: ConfigFormat[];
+    /**
+     * Install MCP server configuration
+     */
+    install(options: McpInstallOptions, target: ExternalInstallTarget, tier: McpEnvironmentTier): Promise<McpInstallResult>;
+    /**
+     * Check if MCP is already configured
+     */
+    isConfigured(manifest: ExternalHostManifest, global: boolean, target: ExternalInstallTarget): Promise<boolean>;
+    /**
+     * Remove MCP configuration
+     */
+    uninstall(manifest: ExternalHostManifest, global: boolean, target: ExternalInstallTarget): Promise<InstallResult>;
+    /**
+     * Get the config path for a manifest
+     */
+    getConfigPath(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallRoots): string;
+}
+/**
+ * Hook template definition
+ */
+export interface HookTemplate {
+    /** Event this hook handles */
+    event: HookEvent;
+    /** Template content (with {{variable}} placeholders) */
+    content: string;
+    /** File name for the hook */
+    filename: string;
+    /** File permissions (e.g., 0o755) */
+    mode?: number;
+}
+/**
+ * Hooks installer configuration from manifest
+ */
+export declare const hooksInstallerConfigSchema: z.ZodObject<{
+    templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    hooksDir: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type HooksInstallerConfig = z.infer<typeof hooksInstallerConfigSchema>;
+/**
+ * Options for hooks installation
+ */
+export interface HooksInstallOptions extends InstallerContext {
+    /** Which hooks to install (defaults to all supported) */
+    hooks?: HookEvent[];
+    /** Path to vibes binary */
+    vibesPath?: string;
+    /**
+     * When set, write hook scripts here instead of the manifest-derived
+     * hooks directory. Used by mixed-scope tools so project vs global hook
+     * placement matches settings registration without forking the installer.
+     */
+    hooksDirOverride?: string;
+    /**
+     * When set, register/unregister hooks in this settings file instead of
+     * resolving `manifest.assets.settings`. Required when a global install uses a
+     * manifest whose settings path is project-relative.
+     */
+    settingsPathOverride?: string;
+}
+/**
+ * Optional overrides for hooks uninstall (directory + settings path).
+ */
+export interface HooksUninstallOptions {
+    hooksDirOverride?: string;
+    settingsPathOverride?: string;
+}
+/**
+ * Result of hooks installation
+ */
+export interface HooksInstallResult extends InstallResult {
+    hooksDir: string;
+    installedHooks: string[];
+    /** Absolute path of the settings file hooks were registered into, if any */
+    registeredSettings?: string;
+    /** The step the user must take before the host runs the registered hooks, when the host requires hook trust. */
+    trustStep?: string;
+}
+/**
+ * Options for hook generation without writing files.
+ */
+export interface HooksGenerateOptions extends InstallerContext {
+    /** Which hooks to generate (defaults to all supported) */
+    hooks?: HookEvent[];
+    /** Path to vibes binary */
+    vibesPath?: string;
+}
+/**
+ * Result of hook generation.
+ */
+export interface HooksGenerateResult extends InstallResult {
+    hooksDir: string;
+    templates: HookTemplate[];
+}
+/**
+ * Hooks Installer interface
+ */
+export interface HooksInstaller {
+    readonly id: string;
+    /**
+     * Install hooks for a tool
+     */
+    install(options: HooksInstallOptions, target: ExternalInstallTarget): Promise<HooksInstallResult>;
+    /**
+     * Generate hook templates for a tool without writing files.
+     */
+    generate(options: HooksGenerateOptions, roots: ExternalInstallRoots): Promise<HooksGenerateResult>;
+    /**
+     * Uninstall hooks
+     */
+    uninstall(manifest: ExternalHostManifest, global: boolean, target: ExternalInstallTarget, options?: HooksUninstallOptions): Promise<InstallResult>;
+    /**
+     * Get available hook templates for a tool. Templates exec the shared
+     * dispatcher under `roots.vibesHome`, baked in at install.
+     */
+    getTemplates(manifest: ExternalHostManifest, vibesPath: string, roots: ExternalInstallRoots): HookTemplate[];
+    /**
+     * Get the hooks directory path
+     */
+    getHooksDir(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallRoots): string;
+}
+/**
+ * Plugin installer configuration
+ */
+export declare const pluginInstallerConfigSchema: z.ZodObject<{
+    template: z.ZodOptional<z.ZodString>;
+    entryPoint: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type PluginInstallerConfig = z.infer<typeof pluginInstallerConfigSchema>;
+/**
+ * Options for plugin installation
+ */
+export interface PluginInstallOptions extends InstallerContext {
+    /** Path to vibes binary */
+    vibesPath?: string;
+    /** Plugin features to enable */
+    features?: string[];
+}
+/**
+ * Result of plugin installation
+ */
+export interface PluginInstallResult extends InstallResult {
+    pluginDir: string;
+    installedFiles: string[];
+}
+/**
+ * Plugin Installer interface
+ */
+export interface PluginInstaller {
+    readonly id: string;
+    /**
+     * Install a plugin for a tool
+     */
+    install(options: PluginInstallOptions): Promise<PluginInstallResult>;
+    /**
+     * Uninstall a plugin
+     */
+    uninstall(manifest: ExternalHostManifest, projectDir?: string): Promise<InstallResult>;
+    /**
+     * Get the plugin directory path
+     */
+    getPluginDir(manifest: ExternalHostManifest, projectDir?: string): string;
+}
+/**
+ * Installer type discriminator
+ */
+export type InstallerType = 'mcp' | 'hooks' | 'plugin';
+/**
+ * Union type for all installers
+ */
+export type Installer = McpInstaller | HooksInstaller | PluginInstaller;
+/**
+ * Installer registration entry
+ */
+export interface InstallerRegistration {
+    type: InstallerType;
+    installer: Installer;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/installers/types.d.ts.map

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

package/dist/plugins/installers/types.js

@@ -0,0 +1,40 @@
+/**
+ * Installer Types
+ *
+ * Defines interfaces for tool installers that the registry uses.
+ * Installers are registered by ID and manifests reference them.
+ */
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+// MCP Installer
+/**
+ * MCP installer configuration from manifest
+ */
+export const mcpInstallerConfigSchema = z.object({
+    /** Config template for the MCP server entry */
+    configTemplate: z.record(z.string(), JsonValueSchema).optional(),
+    /** Default transport mode */
+    defaultTransport: z.enum(['stdio', 'http', 'sse']).default('stdio'),
+    /** Environment variables to include */
+    envVars: z.record(z.string(), z.string()).optional()
+});
+/**
+ * Hooks installer configuration from manifest
+ */
+export const hooksInstallerConfigSchema = z.object({
+    /** Hook templates by event */
+    templates: z.record(z.string(), z.string()).optional(),
+    /** Directory name for hooks */
+    hooksDir: z.string().default('hooks')
+});
+// Plugin Installer
+/**
+ * Plugin installer configuration
+ */
+export const pluginInstallerConfigSchema = z.object({
+    /** Plugin template content */
+    template: z.string().optional(),
+    /** Entry point filename */
+    entryPoint: z.string().default('index.ts')
+});
+//# sourceMappingURL=types.js.map

package/dist/plugins/installers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/installers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAQ5B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AA6DnE,gBAAgB;AAEhB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,+CAA+C;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;IAChE,6BAA6B;IAC7B,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACnE,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAuGH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,8BAA8B;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CACrC,CAAC,CAAC;AAyGH,mBAAmB;AAEnB;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,2BAA2B;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;CAC1C,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * External Tool Plugin Schemas
+ */
+export { toolCategorySchema, mcpTransportSchema, configFormatSchema, hookLifecycleEventSchema, platformSchema, pathTemplateSchema, configLocationSchema, assetPathsSchema, mcpCapabilitiesSchema, hookCapabilitiesSchema, pluginCapabilitiesSchema, skillsCapabilitiesSchema, detectionConfigSchema, integrationPointsSchema, externalHostManifestSchema, validateManifest, createManifest } from './manifest.ts';
+export type { ToolCategory, McpTransport, ConfigFormat, HookEvent, Platform, PathTemplate, ConfigLocation, AssetPaths, McpCapabilities, HookCapabilities, PluginCapabilities, SkillsCapabilities, DetectionConfig, IntegrationPoints, ExternalHostManifest } from './manifest.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,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,eAAe,CAAC;AAEvB,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,eAAe,CAAC"}

package/dist/plugins/schemas/index.js

@@ -0,0 +1,5 @@
+/**
+ * External Tool Plugin Schemas
+ */
+export { toolCategorySchema, mcpTransportSchema, configFormatSchema, hookLifecycleEventSchema, platformSchema, pathTemplateSchema, configLocationSchema, assetPathsSchema, mcpCapabilitiesSchema, hookCapabilitiesSchema, pluginCapabilitiesSchema, skillsCapabilitiesSchema, detectionConfigSchema, integrationPointsSchema, externalHostManifestSchema, validateManifest, createManifest } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,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,eAAe,CAAC"}