@honeybee-ai/incubator 1.1.0

package/dist/plugins/loader.js

@@ -0,0 +1,122 @@
+/**
+ * Unified plugin/integration loader.
+ *
+ * Handles both new IncubatorPlugin and legacy IntegrationModule patterns.
+ * Detection order: createPlugin factory > default export factory > direct module.
+ */
+/**
+ * Load a package and return an IncubatorPlugin.
+ * If the package exports a legacy IntegrationModule, wraps it automatically.
+ */
+export async function loadPlugin(packageName, config) {
+    const mod = await import(packageName);
+    // 1. New plugin factory: named export createPlugin(config?)
+    const pluginFactory = mod.createPlugin ??
+        mod.default?.createPlugin;
+    if (typeof pluginFactory === 'function') {
+        const plugin = pluginFactory(config);
+        if (plugin && typeof plugin.start === 'function' && typeof plugin.stop === 'function' && plugin.name) {
+            return plugin;
+        }
+    }
+    // 2. Default export plugin factory
+    const defaultFactory = mod.default?.default ?? // CJS interop
+        mod.default;
+    if (typeof defaultFactory === 'function') {
+        const instance = defaultFactory(config);
+        if (instance && typeof instance.start === 'function' && typeof instance.stop === 'function') {
+            // Check if it's a full IncubatorPlugin (has getToolEntries)
+            if (typeof instance.getToolEntries === 'function') {
+                return instance;
+            }
+            // Legacy IntegrationModule — wrap it
+            return wrapIntegration(instance);
+        }
+    }
+    // 3. Direct module (already instantiated)
+    if (mod.default && typeof mod.default.start === 'function') {
+        if (typeof mod.default.getToolEntries === 'function') {
+            return mod.default;
+        }
+        return wrapIntegration(mod.default);
+    }
+    // 4. TOOL_DEFS export (propolis legacy path — wrap into plugin)
+    if (typeof mod.TOOL_DEFS === 'function') {
+        return wrapToolDefs(packageName, mod);
+    }
+    throw new Error(`Package "${packageName}" does not export a valid PluginFactory, IntegrationModule, or TOOL_DEFS. ` +
+        `Expected createPlugin(), default export factory, or TOOL_DEFS function.`);
+}
+/**
+ * Wrap a legacy IntegrationModule into an IncubatorPlugin.
+ * getTools() results get auto-converted to ToolEntry[] with wrapped handlers.
+ */
+function wrapIntegration(module) {
+    return {
+        name: module.name,
+        async start(ctx) {
+            await module.start(ctx);
+        },
+        async stop() {
+            await module.stop();
+        },
+        onEvent: module.onEvent
+            ? async (event) => { await module.onEvent(event); }
+            : undefined,
+        getTools: module.getTools
+            ? () => module.getTools()
+            : undefined,
+        getToolEntries: module.getTools
+            ? () => convertToolDefinitions(module.getTools())
+            : undefined,
+    };
+}
+/**
+ * Wrap a module with TOOL_DEFS (propolis legacy) into an IncubatorPlugin.
+ */
+function wrapToolDefs(packageName, mod) {
+    const name = packageName.replace(/^@[^/]+\//, '');
+    return {
+        name,
+        async start() { },
+        async stop() { },
+        getToolEntries(ctx) {
+            return mod.TOOL_DEFS(ctx.workDir, ctx.guard, ctx.verbose);
+        },
+        destroy: mod.destroyAllPtySessions
+            ? () => { mod.destroyAllPtySessions(); }
+            : undefined,
+    };
+}
+/**
+ * Convert simple ToolDefinition[] (from IntegrationModule.getTools()) to ToolEntry[].
+ */
+function convertToolDefinitions(tools) {
+    return tools.map(tool => ({
+        def: {
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: {
+                    type: 'object',
+                    properties: tool.inputSchema.properties,
+                    required: tool.inputSchema.required ?? [],
+                },
+            },
+        },
+        schema: {},
+        handler: async (args) => {
+            const result = await tool.handler(args);
+            // If handler already returns ToolResult shape, pass through
+            if (result && typeof result === 'object' && 'content' in result) {
+                return result;
+            }
+            // Wrap raw result as text
+            return {
+                content: [{ type: 'text', text: typeof result === 'string' ? result : JSON.stringify(result) }],
+            };
+        },
+    }));
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/manager.d.ts

@@ -0,0 +1,76 @@
+/**
+ * PluginManager — unified plugin lifecycle, tool aggregation, auto-discovery.
+ *
+ * Replaces both IntegrationManager and tool-loader.ts with a single system.
+ * Propolis auto-loads if installed. Legacy IntegrationModule packages are
+ * wrapped automatically via the loader.
+ */
+import type { ToolEntry, ToolResult } from '@honeybee-ai/hivemind-sdk/integrations';
+import type { NotificationBus } from '../bus.js';
+import type { IEventStore } from '../stores/interfaces.js';
+import type { IntegrationEntry } from '../integrations/config.js';
+export interface BroodPluginEntry {
+    package: string;
+    config?: Record<string, string>;
+}
+export interface PluginManagerOptions {
+    /** Try to auto-discover propolis on init(). Default: true. */
+    autoDiscover?: boolean;
+    /** Plugin packages passed via --plugin= CLI flags. */
+    cliPlugins?: string[];
+    /** Plugin entries from brood.yaml. */
+    broodPlugins?: BroodPluginEntry[];
+    /** Legacy integration entries (from integrations.json). */
+    integrations?: Record<string, IntegrationEntry>;
+    /** CLI-specified integration names (--integration= flags). */
+    cliIntegrations?: string[];
+}
+type EnvHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
+export declare class PluginManager {
+    private plugins;
+    private _toolNameSet;
+    private _handlerMap;
+    private _allToolEntries;
+    private verbose;
+    private namespace;
+    private bus?;
+    private eventStore?;
+    constructor(opts?: {
+        verbose?: boolean;
+        namespace?: string;
+        bus?: NotificationBus;
+        eventStore?: IEventStore;
+    });
+    /**
+     * Initialize the plugin system.
+     * Auto-discovers propolis, loads CLI/brood plugins, wraps legacy integrations.
+     */
+    init(opts?: PluginManagerOptions): Promise<void>;
+    /**
+     * Load a single plugin by package name.
+     * Deduplicates by name — loading the same name twice is a no-op.
+     */
+    load(name: string, packageName: string, config?: Record<string, string>): Promise<void>;
+    /**
+     * Build tool entries from all plugins for the given context.
+     * Must be called after init() and before getHandlerMap()/getToolEntries().
+     */
+    buildToolEntries(workDir: string, guard: unknown, verbose: boolean): void;
+    /** All tool entries across all plugins. */
+    getToolEntries(): ToolEntry[];
+    /** Handler map (tool name → handler) for compound tool dispatch. */
+    getHandlerMap(): Map<string, EnvHandler>;
+    /** Set of all available tool names (for ENV_ACTIONS replacement). */
+    getToolNames(): Set<string>;
+    /** Whether any plugins provide tool entries. */
+    hasToolEntries(): boolean;
+    /** Names of all loaded plugins. */
+    getLoadedNames(): string[];
+    /** Tool count across all plugins. */
+    getToolCount(): number;
+    /** Graceful shutdown: stop all plugins, destroy resources. */
+    destroyAll(): Promise<void>;
+    private buildContext;
+    private log;
+}
+export {};

package/dist/plugins/manager.js

@@ -0,0 +1,238 @@
+/**
+ * PluginManager — unified plugin lifecycle, tool aggregation, auto-discovery.
+ *
+ * Replaces both IntegrationManager and tool-loader.ts with a single system.
+ * Propolis auto-loads if installed. Legacy IntegrationModule packages are
+ * wrapped automatically via the loader.
+ */
+import { loadPlugin } from './loader.js';
+export class PluginManager {
+    plugins = [];
+    _toolNameSet = new Set();
+    _handlerMap = new Map();
+    _allToolEntries = [];
+    verbose;
+    namespace;
+    bus;
+    eventStore;
+    constructor(opts) {
+        this.verbose = opts?.verbose ?? false;
+        this.namespace = opts?.namespace ?? 'default';
+        this.bus = opts?.bus;
+        this.eventStore = opts?.eventStore;
+    }
+    /**
+     * Initialize the plugin system.
+     * Auto-discovers propolis, loads CLI/brood plugins, wraps legacy integrations.
+     */
+    async init(opts) {
+        const autoDiscover = opts?.autoDiscover ?? true;
+        // 1. Auto-discover propolis
+        if (autoDiscover) {
+            try {
+                await this.load('propolis', '@honeybee-ai/propolis');
+            }
+            catch {
+                this.log('No plugins auto-discovered');
+            }
+        }
+        // 2. CLI plugins (--plugin=)
+        if (opts?.cliPlugins) {
+            for (const pkg of opts.cliPlugins) {
+                try {
+                    await this.load(pkg, pkg);
+                }
+                catch (err) {
+                    console.error(`[plugins] Failed to load "${pkg}": ${err.message}`);
+                }
+            }
+        }
+        // 3. Brood.yaml plugins
+        if (opts?.broodPlugins) {
+            for (const entry of opts.broodPlugins) {
+                // Skip propolis if already auto-discovered
+                if (entry.package === '@honeybee-ai/propolis' && this.plugins.some(p => p.name === 'propolis')) {
+                    continue;
+                }
+                try {
+                    const name = entry.package.replace(/^@[^/]+\//, '');
+                    await this.load(name, entry.package, entry.config);
+                }
+                catch (err) {
+                    console.error(`[plugins] Failed to load "${entry.package}": ${err.message}`);
+                }
+            }
+        }
+        // 4. Legacy integrations
+        if (opts?.integrations) {
+            const cliIntNames = opts?.cliIntegrations ?? [];
+            if (cliIntNames.length > 0) {
+                // Load only CLI-specified integrations
+                for (const name of cliIntNames) {
+                    const entry = opts.integrations[name];
+                    if (entry) {
+                        try {
+                            await this.load(name, entry.package, entry.config);
+                        }
+                        catch (err) {
+                            console.error(`[plugins] Failed to load integration "${name}": ${err.message}`);
+                        }
+                    }
+                    else {
+                        // Treat name as npm package name
+                        try {
+                            await this.load(name, name);
+                        }
+                        catch (err) {
+                            console.error(`[plugins] Failed to load integration "${name}": ${err.message}`);
+                        }
+                    }
+                }
+            }
+            else {
+                // Load all enabled integrations
+                for (const [name, entry] of Object.entries(opts.integrations)) {
+                    if (!entry.enabled)
+                        continue;
+                    try {
+                        await this.load(name, entry.package, entry.config);
+                    }
+                    catch (err) {
+                        console.error(`[plugins] Failed to load integration "${name}": ${err.message}`);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Load a single plugin by package name.
+     * Deduplicates by name — loading the same name twice is a no-op.
+     */
+    async load(name, packageName, config) {
+        // Deduplicate
+        if (this.plugins.some(p => p.name === name))
+            return;
+        const plugin = await loadPlugin(packageName, config);
+        // Start the plugin with a minimal context for lifecycle
+        const ctx = this.buildContext(config);
+        await plugin.start(ctx);
+        // Subscribe to bus events if plugin has onEvent
+        let unsubscribe;
+        if (plugin.onEvent && this.bus) {
+            unsubscribe = this.bus.subscribe(this.namespace, (event) => {
+                const integrationEvent = {
+                    type: event.type,
+                    data: event.data,
+                    agentId: event.publishedBy,
+                    namespace: this.namespace,
+                    timestamp: Date.now(),
+                };
+                plugin.onEvent(integrationEvent).catch((err) => {
+                    console.error(`[plugins:${plugin.name}] onEvent error: ${err.message}`);
+                });
+            });
+        }
+        this.plugins.push({ name, plugin, unsubscribe, toolEntries: [] });
+        this.log(`Loaded: ${plugin.name}`);
+    }
+    /**
+     * Build tool entries from all plugins for the given context.
+     * Must be called after init() and before getHandlerMap()/getToolEntries().
+     */
+    buildToolEntries(workDir, guard, verbose) {
+        this._allToolEntries = [];
+        this._handlerMap.clear();
+        this._toolNameSet.clear();
+        const ctx = {
+            ...this.buildContext(),
+            workDir,
+            guard,
+            verbose,
+        };
+        for (const loaded of this.plugins) {
+            if (loaded.plugin.getToolEntries) {
+                const entries = loaded.plugin.getToolEntries(ctx);
+                loaded.toolEntries = entries;
+                for (const entry of entries) {
+                    const name = entry.def.function.name;
+                    if (this._toolNameSet.has(name)) {
+                        console.error(`[plugins] Tool name collision: "${name}" from "${loaded.name}" — skipping duplicate`);
+                        continue;
+                    }
+                    this._toolNameSet.add(name);
+                    this._handlerMap.set(name, entry.handler);
+                    this._allToolEntries.push(entry);
+                }
+            }
+        }
+    }
+    /** All tool entries across all plugins. */
+    getToolEntries() {
+        return this._allToolEntries;
+    }
+    /** Handler map (tool name → handler) for compound tool dispatch. */
+    getHandlerMap() {
+        return this._handlerMap;
+    }
+    /** Set of all available tool names (for ENV_ACTIONS replacement). */
+    getToolNames() {
+        return this._toolNameSet;
+    }
+    /** Whether any plugins provide tool entries. */
+    hasToolEntries() {
+        return this._allToolEntries.length > 0;
+    }
+    /** Names of all loaded plugins. */
+    getLoadedNames() {
+        return this.plugins.map(p => p.name);
+    }
+    /** Tool count across all plugins. */
+    getToolCount() {
+        return this._allToolEntries.length;
+    }
+    /** Graceful shutdown: stop all plugins, destroy resources. */
+    async destroyAll() {
+        for (const loaded of this.plugins) {
+            try {
+                if (loaded.unsubscribe)
+                    loaded.unsubscribe();
+                await loaded.plugin.stop();
+                if (loaded.plugin.destroy)
+                    loaded.plugin.destroy();
+            }
+            catch (err) {
+                console.error(`[plugins] Error stopping "${loaded.name}": ${err.message}`);
+            }
+        }
+        this.plugins = [];
+        this._allToolEntries = [];
+        this._handlerMap.clear();
+        this._toolNameSet.clear();
+    }
+    buildContext(config) {
+        return {
+            namespace: this.namespace,
+            config: config ?? {},
+            logger: {
+                info: (msg) => { if (this.verbose)
+                    console.error(`[plugins] ${msg}`); },
+                warn: (msg) => { console.error(`[plugins] WARN: ${msg}`); },
+                error: (msg) => { console.error(`[plugins] ERROR: ${msg}`); },
+            },
+            publishEvent: async (type, data) => {
+                if (this.eventStore) {
+                    await this.eventStore.publish(type, data, 'plugin');
+                }
+            },
+            workDir: process.cwd(),
+            guard: null,
+            verbose: this.verbose,
+        };
+    }
+    log(msg) {
+        if (this.verbose) {
+            console.error(`[plugins] ${msg}`);
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

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

package/dist/propolis/guard.d.ts

@@ -0,0 +1,23 @@
+interface ScanResult {
+    pass: boolean;
+    score: number;
+    action: 'PASS' | 'LOG' | 'WARN' | 'BLOCK';
+    findings: Array<{
+        category: string;
+        severity: string;
+        description: string;
+    }>;
+    summary: string;
+}
+export interface Guard {
+    scan(message: string): ScanResult;
+}
+/**
+ * Load Carapace scanner. Returns null if not installed.
+ */
+export declare function loadGuard(verbose?: boolean): Guard | null;
+/**
+ * Scan input fields with Carapace. Returns an error message if blocked, null if clean.
+ */
+export declare function scanInput(guard: Guard | null, fields: (string | undefined)[], verbose?: boolean): string | null;
+export {};

package/dist/propolis/guard.js

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+let cachedGuard;
+/**
+ * Load Carapace scanner. Returns null if not installed.
+ */
+export function loadGuard(verbose) {
+    if (cachedGuard !== undefined)
+        return cachedGuard;
+    try {
+        const require = createRequire(import.meta.url);
+        const mod = require('@honeybee-ai/carapace');
+        cachedGuard = mod;
+        if (verbose) {
+            console.error('[propolis] Carapace loaded');
+        }
+        return cachedGuard;
+    }
+    catch {
+        cachedGuard = null;
+        if (verbose) {
+            console.error('[propolis] Carapace not installed — guard disabled');
+        }
+        return null;
+    }
+}
+/**
+ * Scan input fields with Carapace. Returns an error message if blocked, null if clean.
+ */
+export function scanInput(guard, fields, verbose) {
+    if (!guard)
+        return null;
+    const text = fields.filter(Boolean).join('\n');
+    if (!text)
+        return null;
+    const result = guard.scan(text);
+    if (verbose && result.findings.length > 0) {
+        const ts = new Date().toISOString().slice(11, 23);
+        console.error(`  ${ts} [carapace] score=${result.score} action=${result.action} findings=${result.findings.length}`);
+    }
+    if (result.action === 'BLOCK') {
+        return `Blocked by security policy: ${result.summary}`;
+    }
+    if (result.action === 'WARN' && verbose) {
+        const ts = new Date().toISOString().slice(11, 23);
+        console.error(`  ${ts} [carapace] WARN: ${result.summary}`);
+    }
+    return null;
+}
+//# sourceMappingURL=guard.js.map

package/dist/propolis/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/propolis/guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5C,IAAI,WAAqC,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAiB;IACzC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC7C,WAAW,GAAG,GAAY,CAAC;QAC3B,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,IAAI,CAAC;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAmB,EAAE,MAA8B,EAAE,OAAiB;IAC9F,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,qBAAqB,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,+BAA+B,MAAM,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,qBAAqB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/propolis/tools/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Re-export canonical tool types from SDK.
+ * Kept for backward compatibility — internal code imports from here.
+ */
+export type { ToolResult } from '@honeybee-ai/hivemind-sdk/integrations';
+/** Helper: wrap data as a ToolResult. */
+export declare function textResult(data: unknown): import('@honeybee-ai/hivemind-sdk/integrations').ToolResult;
+/** Helper: wrap error message as a ToolResult. */
+export declare function errorResult(msg: string): import('@honeybee-ai/hivemind-sdk/integrations').ToolResult;

package/dist/propolis/tools/types.js

@@ -0,0 +1,9 @@
+/** Helper: wrap data as a ToolResult. */
+export function textResult(data) {
+    return { content: [{ type: 'text', text: typeof data === 'string' ? data : JSON.stringify(data) }] };
+}
+/** Helper: wrap error message as a ToolResult. */
+export function errorResult(msg) {
+    return textResult({ error: msg });
+}
+//# sourceMappingURL=types.js.map

package/dist/propolis/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/propolis/tools/types.ts"],"names":[],"mappings":"AAMA,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAChH,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/rest.d.ts

@@ -0,0 +1,4 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { NamespaceRegistry } from './namespaces.js';
+import type { DanceSupport } from './ws.js';
+export declare function handleRestRequest(req: IncomingMessage, res: ServerResponse, registry: NamespaceRegistry, verbose: boolean, danceSupport?: DanceSupport): Promise<boolean>;