@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/plugin-manager-impl.js

@@ -0,0 +1,343 @@
+/**
+ * PluginManagerImpl — concrete implementation of the PluginManager interface.
+ *
+ * Every method resolves the target adapter from the AdapterRegistry,
+ * checks `AgentCapabilities.supportsPlugins`, and delegates to the
+ * adapter's optional plugin methods.
+ *
+ * @see 09-plugin-manager.md §2
+ */
+import { AgentMuxError, CapabilityError, ValidationError } from './errors.js';
+/**
+ * Concrete implementation of the PluginManager interface.
+ * Delegates all operations to the appropriate agent adapter.
+ */
+export class PluginManagerImpl {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    // ── Helpers ──────────────────────────────────────────────────────────
+    /**
+     * Resolves the adapter and asserts that it supports plugins.
+     * Throws AGENT_NOT_FOUND or CAPABILITY_ERROR as appropriate.
+     */
+    assertPluginCapable(agent) {
+        const adapter = this.registry.get(agent);
+        if (!adapter) {
+            throw new AgentMuxError('AGENT_NOT_FOUND', `Agent '${agent}' is not registered`);
+        }
+        if (!adapter.capabilities.supportsPlugins) {
+            throw new CapabilityError(agent, 'plugins');
+        }
+        return adapter;
+    }
+    defaultFormatForAdapter(adapter) {
+        const format = adapter.capabilities.pluginFormats[0];
+        return this.isPluginFormat(format) ? format : 'npm-package';
+    }
+    isPluginFormat(value) {
+        return value === 'npm-package'
+            || value === 'skill-file'
+            || value === 'skill-directory'
+            || value === 'extension-ts'
+            || value === 'channel-plugin'
+            || value === 'mcp-server';
+    }
+    normalizeDate(value, fallback) {
+        if (value instanceof Date && !Number.isNaN(value.getTime())) {
+            return new Date(value.getTime());
+        }
+        if (typeof value === 'string' || typeof value === 'number') {
+            const parsed = new Date(value);
+            if (!Number.isNaN(parsed.getTime())) {
+                return parsed;
+            }
+        }
+        return new Date(fallback.getTime());
+    }
+    sortInstalledPlugins(plugins) {
+        return [...plugins].sort((a, b) => b.installedAt.getTime() - a.installedAt.getTime());
+    }
+    normalizeInstalledPlugin(agent, adapter, plugin, fallbackInstalledAt = new Date(0)) {
+        return {
+            pluginId: plugin.pluginId,
+            name: plugin.name,
+            version: plugin.version,
+            agent,
+            format: this.isPluginFormat(plugin.format)
+                ? plugin.format
+                : this.defaultFormatForAdapter(adapter),
+            description: typeof plugin.description === 'string'
+                ? plugin.description
+                : undefined,
+            installedAt: this.normalizeDate(plugin.installedAt, fallbackInstalledAt),
+            enabled: typeof plugin.enabled === 'boolean' ? plugin.enabled : true,
+        };
+    }
+    normalizePluginListing(adapter, listing) {
+        const fallbackFormat = this.defaultFormatForAdapter(adapter);
+        const formats = Array.isArray(listing.formats)
+            ? listing.formats.filter((format) => this.isPluginFormat(format))
+            : [];
+        const agents = Array.isArray(listing.agents)
+            ? listing.agents.filter((agent) => typeof agent === 'string' && agent.length > 0)
+            : [];
+        const tags = Array.isArray(listing.tags)
+            ? listing.tags.filter((tag) => typeof tag === 'string')
+            : [];
+        const registry = typeof listing.registry === 'string' && listing.registry.length > 0
+            ? listing.registry
+            : adapter.capabilities.pluginRegistries[0]?.name ?? adapter.agent;
+        return {
+            pluginId: listing.pluginId,
+            name: listing.name,
+            latestVersion: listing.latestVersion,
+            description: typeof listing.description === 'string' ? listing.description : '',
+            author: typeof listing.author === 'string' ? listing.author : registry,
+            weeklyDownloads: typeof listing.weeklyDownloads === 'number'
+                ? listing.weeklyDownloads
+                : undefined,
+            agents: agents.length > 0 ? agents : [adapter.agent],
+            formats: formats.length > 0 ? formats : [fallbackFormat],
+            registry,
+            tags,
+            url: typeof listing.url === 'string' ? listing.url : '',
+        };
+    }
+    normalizePluginDetail(adapter, detail) {
+        const listing = this.normalizePluginListing(adapter, detail);
+        const versions = Array.isArray(detail.versions)
+            ? detail.versions.filter((version) => typeof version === 'string')
+            : [];
+        const dependencies = Array.isArray(detail.dependencies)
+            ? detail.dependencies.filter((dep) => typeof dep === 'string')
+            : undefined;
+        const agentMinVersions = detail.agentMinVersions && typeof detail.agentMinVersions === 'object'
+            ? Object.fromEntries(Object.entries(detail.agentMinVersions).filter(([agent, version]) => typeof agent === 'string' && typeof version === 'string'))
+            : undefined;
+        return {
+            ...listing,
+            readme: typeof detail.readme === 'string' ? detail.readme : undefined,
+            changelog: typeof detail.changelog === 'string' ? detail.changelog : undefined,
+            versions: versions.length > 0 ? versions : [listing.latestVersion],
+            dependencies,
+            agentMinVersions,
+        };
+    }
+    toPluginError(message, error) {
+        if (error instanceof AgentMuxError) {
+            return error;
+        }
+        const suffix = error instanceof Error && error.message
+            ? `: ${error.message}`
+            : '';
+        return new AgentMuxError('PLUGIN_ERROR', `${message}${suffix}`);
+    }
+    assertNonEmptyValue(field, value) {
+        if (value.trim().length > 0) {
+            return;
+        }
+        throw new ValidationError([{
+                field,
+                message: 'must not be empty',
+                received: value,
+                expected: 'non-empty string',
+            }]);
+    }
+    resolveSearchAdapters(agentNames) {
+        const adapters = [];
+        if (agentNames) {
+            for (const name of agentNames) {
+                const adapter = this.registry.get(name);
+                if (adapter && adapter.capabilities.supportsPlugins) {
+                    adapters.push(adapter);
+                }
+            }
+            return adapters;
+        }
+        const allAdapters = this.registry.list();
+        for (const info of allAdapters) {
+            const adapter = this.registry.get(info.agent);
+            if (adapter && adapter.capabilities.supportsPlugins) {
+                adapters.push(adapter);
+            }
+        }
+        return adapters;
+    }
+    async searchAcrossAdapters(query, options, allowEmptyQuery) {
+        if (!allowEmptyQuery) {
+            this.assertNonEmptyValue('query', query);
+        }
+        const adapters = this.resolveSearchAdapters(options?.agents);
+        const allResults = [];
+        const seen = new Set();
+        let attempted = 0;
+        let failed = 0;
+        for (const adapter of adapters) {
+            if (!adapter.searchPlugins) {
+                continue;
+            }
+            attempted += 1;
+            try {
+                const results = await adapter.searchPlugins(query, options);
+                for (const listing of results) {
+                    const normalized = this.normalizePluginListing(adapter, listing);
+                    if (!seen.has(normalized.pluginId)) {
+                        seen.add(normalized.pluginId);
+                        allResults.push(normalized);
+                    }
+                }
+            }
+            catch {
+                failed += 1;
+            }
+        }
+        if (attempted > 0 && failed === attempted) {
+            const operation = allowEmptyQuery ? 'browse plugin registries' : `search plugin registries for '${query}'`;
+            throw new AgentMuxError('PLUGIN_ERROR', `Failed to ${operation}`);
+        }
+        const limit = options?.limit
+            ? Math.min(Math.max(options.limit, 1), 200)
+            : 25;
+        return allResults.slice(0, limit);
+    }
+    // ── PluginManager interface ─────────────────────────────────────────
+    async list(agent) {
+        const adapter = this.assertPluginCapable(agent);
+        if (!adapter.listPlugins) {
+            return [];
+        }
+        try {
+            const plugins = await adapter.listPlugins();
+            return this.sortInstalledPlugins(plugins.map((plugin) => this.normalizeInstalledPlugin(agent, adapter, plugin)));
+        }
+        catch (error) {
+            throw this.toPluginError(`Failed to list plugins for agent '${agent}'`, error);
+        }
+    }
+    async install(agent, pluginId, options) {
+        this.assertNonEmptyValue('pluginId', pluginId);
+        const adapter = this.assertPluginCapable(agent);
+        if (!adapter.installPlugin) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Agent '${agent}' does not implement installPlugin`);
+        }
+        try {
+            const result = await adapter.installPlugin(pluginId, options);
+            return this.normalizeInstalledPlugin(agent, adapter, result, new Date());
+        }
+        catch (error) {
+            throw this.toPluginError(`Failed to install plugin '${pluginId}' for agent '${agent}'`, error);
+        }
+    }
+    async uninstall(agent, pluginId, options) {
+        this.assertNonEmptyValue('pluginId', pluginId);
+        const adapter = this.assertPluginCapable(agent);
+        if (!adapter.uninstallPlugin) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Agent '${agent}' does not implement uninstallPlugin`);
+        }
+        try {
+            await adapter.uninstallPlugin(pluginId, options);
+        }
+        catch (error) {
+            throw this.toPluginError(`Failed to uninstall plugin '${pluginId}' for agent '${agent}'`, error);
+        }
+    }
+    async update(agent, pluginId) {
+        this.assertNonEmptyValue('pluginId', pluginId);
+        const adapter = this.assertPluginCapable(agent);
+        const installedPlugins = await this.list(agent);
+        const currentPlugin = installedPlugins.find((plugin) => plugin.pluginId === pluginId);
+        if (!currentPlugin) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Plugin '${pluginId}' is not installed for agent '${agent}'`);
+        }
+        if (!adapter.installPlugin) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Agent '${agent}' does not implement installPlugin`);
+        }
+        try {
+            const result = await adapter.installPlugin(pluginId);
+            return this.normalizeInstalledPlugin(agent, adapter, result, currentPlugin.installedAt);
+        }
+        catch (error) {
+            throw this.toPluginError(`Failed to update plugin '${pluginId}' for agent '${agent}'`, error);
+        }
+    }
+    async updateAll(agent) {
+        const adapter = this.assertPluginCapable(agent);
+        const plugins = await this.list(agent);
+        if (plugins.length === 0) {
+            return [];
+        }
+        if (!adapter.installPlugin) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Agent '${agent}' does not implement installPlugin`);
+        }
+        const results = [];
+        const failures = [];
+        for (const plugin of plugins) {
+            try {
+                const updated = await adapter.installPlugin(plugin.pluginId);
+                results.push(this.normalizeInstalledPlugin(agent, adapter, updated, plugin.installedAt));
+            }
+            catch {
+                failures.push(plugin.pluginId);
+            }
+        }
+        if (failures.length > 0) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Failed to update plugins for agent '${agent}': ${failures.join(', ')}`);
+        }
+        return this.sortInstalledPlugins(results);
+    }
+    async search(query, options) {
+        return this.searchAcrossAdapters(query, options, false);
+    }
+    async browse(options) {
+        return this.searchAcrossAdapters('', options, true);
+    }
+    async info(pluginId, agent) {
+        this.assertNonEmptyValue('pluginId', pluginId);
+        if (agent) {
+            const adapter = this.assertPluginCapable(agent);
+            if (!adapter.searchPlugins) {
+                throw new AgentMuxError('PLUGIN_ERROR', `Agent '${agent}' does not implement searchPlugins`);
+            }
+            try {
+                const results = await adapter.searchPlugins(pluginId);
+                if (results.length > 0) {
+                    return this.normalizePluginDetail(adapter, results[0]);
+                }
+            }
+            catch (error) {
+                throw this.toPluginError(`Failed to look up plugin '${pluginId}' for agent '${agent}'`, error);
+            }
+            throw new AgentMuxError('PLUGIN_ERROR', `Plugin '${pluginId}' not found for agent '${agent}'`);
+        }
+        const adapters = this.resolveSearchAdapters();
+        let attempted = 0;
+        let failed = 0;
+        for (const adapter of adapters) {
+            if (!adapter.searchPlugins) {
+                continue;
+            }
+            attempted += 1;
+            try {
+                const results = await adapter.searchPlugins(pluginId);
+                if (results.length > 0) {
+                    return this.normalizePluginDetail(adapter, results[0]);
+                }
+            }
+            catch {
+                failed += 1;
+            }
+        }
+        if (attempted > 0 && failed === attempted) {
+            throw new AgentMuxError('PLUGIN_ERROR', `Failed to look up plugin '${pluginId}' in any registry`);
+        }
+        throw new AgentMuxError('PLUGIN_ERROR', `Plugin '${pluginId}' not found in any registry`);
+    }
+    async isInstalled(agent, pluginId) {
+        this.assertNonEmptyValue('pluginId', pluginId);
+        const plugins = await this.list(agent);
+        return plugins.some((p) => p.pluginId === pluginId);
+    }
+}
+//# sourceMappingURL=plugin-manager-impl.js.map

package/dist/plugin-manager-impl.js.map

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

package/dist/plugin-manager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * PluginManager interface for @a5c-ai/agent-mux.
+ *
+ * @see 09-plugin-manager.md §2
+ */
+import type { AgentName } from './types.js';
+import type { InstalledPlugin, PluginListing, PluginDetail, PluginInstallOptions, PluginSearchOptions, PluginBrowseOptions } from './plugin-types.js';
+/**
+ * Unified interface over each agent's native plugin system.
+ *
+ * All methods are capability-gated: calling any method on an agent where
+ * `AgentCapabilities.supportsPlugins` is `false` throws a `CapabilityError`
+ * with `code: 'CAPABILITY_ERROR'` and `capability: 'plugins'`.
+ */
+export interface PluginManager {
+    /**
+     * List all plugins currently installed for an agent.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     */
+    list(agent: AgentName): Promise<InstalledPlugin[]>;
+    /**
+     * Install a plugin for an agent.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if installation fails.
+     */
+    install(agent: AgentName, pluginId: string, options?: PluginInstallOptions): Promise<InstalledPlugin>;
+    /**
+     * Uninstall a plugin from an agent.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if uninstallation fails.
+     */
+    uninstall(agent: AgentName, pluginId: string, options?: {
+        global?: boolean;
+    }): Promise<void>;
+    /**
+     * Update a single installed plugin to its latest version.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if the update fails.
+     */
+    update(agent: AgentName, pluginId: string): Promise<InstalledPlugin>;
+    /**
+     * Update all installed plugins for an agent to their latest versions.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     */
+    updateAll(agent: AgentName): Promise<InstalledPlugin[]>;
+    /**
+     * Search for plugins across registries.
+     *
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if all registries fail.
+     */
+    search(query: string, options?: PluginSearchOptions): Promise<PluginListing[]>;
+    /**
+     * Browse available plugins by agent or category.
+     *
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if all registries fail.
+     */
+    browse(options?: PluginBrowseOptions): Promise<PluginListing[]>;
+    /**
+     * Get detailed information about a specific plugin.
+     *
+     * @throws {AgentMuxError} With code `'PLUGIN_ERROR'` if plugin is not found.
+     */
+    info(pluginId: string, agent?: AgentName): Promise<PluginDetail>;
+    /**
+     * Check whether a plugin is currently installed for an agent.
+     *
+     * @throws {CapabilityError} If `supportsPlugins` is `false` for the agent.
+     * @throws {AgentMuxError} With code `'AGENT_NOT_FOUND'` if agent is not registered.
+     */
+    isInstalled(agent: AgentName, pluginId: string): Promise<boolean>;
+}

package/dist/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../src/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnD;;;;;;OAMG;IACH,OAAO,CACL,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7F;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAErE;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAExD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE/E;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE"}

package/dist/plugin-manager.js

@@ -0,0 +1,7 @@
+/**
+ * PluginManager interface for @a5c-ai/agent-mux.
+ *
+ * @see 09-plugin-manager.md §2
+ */
+export {};
+//# sourceMappingURL=plugin-manager.js.map

package/dist/plugin-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../src/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/plugin-types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Plugin types for @a5c-ai/agent-mux.
+ *
+ * @see 09-plugin-manager.md §3–§8
+ */
+import type { AgentName, PluginFormat } from './types.js';
+/**
+ * Descriptor of a plugin currently installed for a specific agent.
+ *
+ * The `pluginId` is the canonical identifier used in `install()`,
+ * `uninstall()`, and `update()` calls. Its format is agent-specific.
+ */
+export interface InstalledPlugin {
+    /** Canonical plugin identifier. */
+    pluginId: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Installed version string. Follows semver where applicable. */
+    version: string;
+    /** The agent this plugin is installed for. */
+    agent: AgentName;
+    /** The structural format of this plugin. */
+    format: PluginFormat;
+    /** Short description of the plugin's purpose. */
+    description?: string;
+    /** Timestamp when the plugin was installed. */
+    installedAt: Date;
+    /** Whether the plugin is currently enabled. */
+    enabled: boolean;
+}
+/**
+ * A plugin listing from a registry search or browse result.
+ */
+export interface PluginListing {
+    /** Canonical plugin identifier. */
+    pluginId: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Latest available version in the registry. */
+    latestVersion: string;
+    /** Short description of the plugin. */
+    description: string;
+    /** Author name or organization. */
+    author: string;
+    /** Weekly download count from the registry. */
+    weeklyDownloads?: number;
+    /** Agents that this plugin supports. */
+    agents: AgentName[];
+    /** The plugin formats this listing is available in. */
+    formats: PluginFormat[];
+    /** The registry this listing was sourced from. */
+    registry: string;
+    /** Searchable tags / keywords. */
+    tags: string[];
+    /** URL to the plugin's homepage or registry page. */
+    url: string;
+}
+/**
+ * Detailed information about a specific plugin. Extends PluginListing
+ * with full content and metadata.
+ */
+export interface PluginDetail extends PluginListing {
+    /** Full README content (Markdown). */
+    readme?: string;
+    /** Changelog content (Markdown or plain text). */
+    changelog?: string;
+    /** All published versions, sorted newest-first. */
+    versions: string[];
+    /** Runtime dependencies of the plugin. */
+    dependencies?: string[];
+    /** Minimum agent CLI version required, keyed by agent name. */
+    agentMinVersions?: Record<AgentName, string>;
+}
+/**
+ * Options for plugin installation.
+ */
+export interface PluginInstallOptions {
+    /** Pin to a specific version (semver string or range). */
+    version?: string;
+    /** Install globally (true) vs. project-local (false). */
+    global?: boolean;
+    /** Skip plugin integrity/signature verification. */
+    skipVerify?: boolean;
+}
+/**
+ * Options for filtering plugin search results.
+ */
+export interface PluginSearchOptions {
+    /** Filter results to plugins that support one or more of these agents. */
+    agents?: AgentName[];
+    /** Filter results to a specific plugin format. */
+    format?: PluginFormat;
+    /** Restrict the search to a specific registry by name. */
+    registry?: string;
+    /**
+     * Maximum number of results to return.
+     * Values < 1 are clamped to 1, values > 200 are clamped to 200.
+     * @default 25
+     */
+    limit?: number;
+}
+/**
+ * Options for browsing plugin listings by category and sort order.
+ * Extends PluginSearchOptions, inheriting all filter fields.
+ */
+export interface PluginBrowseOptions extends PluginSearchOptions {
+    /** Browse by category. Category values are registry-defined. */
+    category?: string;
+    /**
+     * Sort order for browse results.
+     * @default 'downloads'
+     */
+    sortBy?: 'downloads' | 'updated' | 'name';
+}

package/dist/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM1D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IAEjB,4CAA4C;IAC5C,MAAM,EAAE,YAAY,CAAC;IAErB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,WAAW,EAAE,IAAI,CAAC;IAElB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,uDAAuD;IACvD,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;CAC9C;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,kDAAkD;IAClD,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;CAC3C"}

package/dist/plugin-types.js

@@ -0,0 +1,7 @@
+/**
+ * Plugin types for @a5c-ai/agent-mux.
+ *
+ * @see 09-plugin-manager.md §3–§8
+ */
+export {};
+//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.js","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/process-tracker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ProcessTracker singleton for zombie prevention.
+ *
+ * Maintains a set of all active subprocess PIDs and their metadata.
+ * On Node.js exit, all tracked processes are forcefully terminated.
+ *
+ * Per spec §6.4: handlers are installed once, on first register() call.
+ */
+export interface ProcessTracker {
+    /** Register a spawned process. Called by RunHandle during spawn. */
+    register(pid: number, groupId: number, runId: string): void;
+    /** Unregister a process after it exits. Called on process exit. */
+    unregister(pid: number): void;
+    /** Kill all tracked processes. Sends SIGTERM then SIGKILL after grace period. */
+    killAll(): void;
+    /** Number of currently tracked processes. */
+    readonly activeCount: number;
+}
+/** Global ProcessTracker singleton. */
+export declare const processTracker: ProcessTracker;

package/dist/process-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tracker.d.ts","sourceRoot":"","sources":["../src/process-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5D,mEAAmE;IACnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,iFAAiF;IACjF,OAAO,IAAI,IAAI,CAAC;IAEhB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AA2GD,uCAAuC;AACvC,eAAO,MAAM,cAAc,EAAE,cAAyC,CAAC"}