@honeybee-ai/incubator 1.1.0

package/dist/integrations/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration config — reads/writes ~/.honeyb/integrations.json
+ * Falls back to legacy ~/.config/honeybee/integrations.json
+ */
+export interface IntegrationEntry {
+    package: string;
+    enabled: boolean;
+    config: Record<string, string>;
+}
+export type IntegrationsConfig = Record<string, IntegrationEntry>;
+export declare function loadIntegrationsConfig(): IntegrationsConfig;
+export declare function saveIntegrationsConfig(config: IntegrationsConfig): void;
+export declare function enableIntegration(name: string, pkg: string, userConfig?: Record<string, string>): void;
+export declare function disableIntegration(name: string): void;
+export declare function removeIntegration(name: string): void;

package/dist/integrations/config.js

@@ -0,0 +1,62 @@
+/**
+ * Integration config — reads/writes ~/.honeyb/integrations.json
+ * Falls back to legacy ~/.config/honeybee/integrations.json
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+function honeybDir() {
+    return join(homedir(), '.honeyb');
+}
+function legacyDir() {
+    return join(homedir(), '.config', 'honeybee');
+}
+function configPath() {
+    const newPath = join(honeybDir(), 'integrations.json');
+    if (existsSync(newPath))
+        return newPath;
+    // Fallback to legacy
+    const legacyPath = join(legacyDir(), 'integrations.json');
+    if (existsSync(legacyPath))
+        return legacyPath;
+    return newPath;
+}
+function writeConfigPath() {
+    return join(honeybDir(), 'integrations.json');
+}
+export function loadIntegrationsConfig() {
+    const path = configPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveIntegrationsConfig(config) {
+    const dir = honeybDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(writeConfigPath(), JSON.stringify(config, null, 2) + '\n');
+}
+export function enableIntegration(name, pkg, userConfig = {}) {
+    const config = loadIntegrationsConfig();
+    config[name] = { package: pkg, enabled: true, config: userConfig };
+    saveIntegrationsConfig(config);
+}
+export function disableIntegration(name) {
+    const config = loadIntegrationsConfig();
+    if (config[name]) {
+        config[name].enabled = false;
+        saveIntegrationsConfig(config);
+    }
+}
+export function removeIntegration(name) {
+    const config = loadIntegrationsConfig();
+    delete config[name];
+    saveIntegrationsConfig(config);
+}
+//# sourceMappingURL=config.js.map

package/dist/integrations/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/integrations/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUlC,SAAS,SAAS;IAChB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,mBAAmB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAC/D,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,aAAa,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAW,EAAE,aAAqC,EAAE;IAClG,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACnE,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,4 @@
+export { IntegrationManager } from './manager.js';
+export { loadIntegrationPackage } from './loader.js';
+export { loadIntegrationsConfig, saveIntegrationsConfig, enableIntegration, disableIntegration, removeIntegration, } from './config.js';
+export type { IntegrationEntry, IntegrationsConfig } from './config.js';

package/dist/integrations/index.js

@@ -0,0 +1,4 @@
+export { IntegrationManager } from './manager.js';
+export { loadIntegrationPackage } from './loader.js';
+export { loadIntegrationsConfig, saveIntegrationsConfig, enableIntegration, disableIntegration, removeIntegration, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/integrations/loader.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dynamic loader for integration npm packages.
+ *
+ * Each integration package must default-export an IntegrationFactory,
+ * or export a named `createIntegration` factory.
+ */
+import type { IntegrationModule } from '@honeybee-ai/hivemind-sdk/integrations';
+export declare function loadIntegrationPackage(packageName: string): Promise<IntegrationModule>;

package/dist/integrations/loader.js

@@ -0,0 +1,27 @@
+/**
+ * Dynamic loader for integration npm packages.
+ *
+ * Each integration package must default-export an IntegrationFactory,
+ * or export a named `createIntegration` factory.
+ */
+export async function loadIntegrationPackage(packageName) {
+    // Use string indirection to avoid TS module resolution errors for optional deps
+    const mod = await import(packageName);
+    // Support: default export factory, named createIntegration, or direct module
+    const factory = mod.default?.default ?? // double-default for CJS interop
+        mod.default ??
+        mod.createIntegration;
+    if (typeof factory === 'function') {
+        const integration = factory();
+        if (integration && typeof integration.start === 'function' && typeof integration.stop === 'function') {
+            return integration;
+        }
+    }
+    // Maybe the module IS the integration (already instantiated)
+    if (mod.default && typeof mod.default.start === 'function') {
+        return mod.default;
+    }
+    throw new Error(`Package "${packageName}" does not export a valid IntegrationFactory or IntegrationModule. ` +
+        `Expected default export function returning { name, start, stop }.`);
+}
+//# sourceMappingURL=loader.js.map

package/dist/integrations/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/integrations/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB;IAC9D,gFAAgF;IAChF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEtC,6EAA6E;IAC7E,MAAM,OAAO,GACX,GAAG,CAAC,OAAO,EAAE,OAAO,IAAK,iCAAiC;QAC1D,GAAG,CAAC,OAAO;QACX,GAAG,CAAC,iBAAiB,CAAC;IAExB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC;QAC9B,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrG,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC3D,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,YAAY,WAAW,qEAAqE;QAC5F,mEAAmE,CACpE,CAAC;AACJ,CAAC"}

package/dist/integrations/manager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * IntegrationManager — lifecycle, event routing, tool aggregation.
+ *
+ * Loads integration packages, calls start(ctx)/stop(), subscribes onEvent()
+ * to NotificationBus, and aggregates getTools() for MCP registration.
+ */
+import type { ToolDefinition } from '@honeybee-ai/hivemind-sdk/integrations';
+import type { NotificationBus } from '../bus.js';
+import type { IEventStore } from '../stores/interfaces.js';
+import type { IntegrationEntry } from './config.js';
+export declare class IntegrationManager {
+    private integrations;
+    private bus?;
+    private namespace;
+    private eventStore?;
+    private verbose;
+    constructor(opts: {
+        namespace?: string;
+        bus?: NotificationBus;
+        eventStore?: IEventStore;
+        verbose?: boolean;
+    });
+    loadFromConfig(entries: Record<string, IntegrationEntry>): Promise<void>;
+    load(name: string, packageName: string, config?: Record<string, string>): Promise<void>;
+    getTools(): ToolDefinition[];
+    getLoadedNames(): string[];
+    stopAll(): Promise<void>;
+    private createLogger;
+}

package/dist/integrations/manager.js

@@ -0,0 +1,108 @@
+/**
+ * IntegrationManager — lifecycle, event routing, tool aggregation.
+ *
+ * Loads integration packages, calls start(ctx)/stop(), subscribes onEvent()
+ * to NotificationBus, and aggregates getTools() for MCP registration.
+ */
+import { loadIntegrationPackage } from './loader.js';
+export class IntegrationManager {
+    integrations = [];
+    bus;
+    namespace;
+    eventStore;
+    verbose;
+    constructor(opts) {
+        this.namespace = opts.namespace ?? 'default';
+        this.bus = opts.bus;
+        this.eventStore = opts.eventStore;
+        this.verbose = opts.verbose ?? false;
+    }
+    async loadFromConfig(entries) {
+        const enabled = Object.entries(entries).filter(([, e]) => e.enabled);
+        for (const [name, entry] of enabled) {
+            try {
+                await this.load(name, entry.package, entry.config);
+            }
+            catch (err) {
+                console.error(`[integrations] Failed to load "${name}": ${err.message}`);
+            }
+        }
+    }
+    async load(name, packageName, config = {}) {
+        const module = await loadIntegrationPackage(packageName);
+        const logger = this.createLogger(module.name);
+        const ctx = {
+            namespace: this.namespace,
+            config,
+            logger,
+            publishEvent: async (type, data) => {
+                if (this.eventStore) {
+                    await this.eventStore.publish(type, data, `integration:${module.name}`);
+                }
+            },
+        };
+        await module.start(ctx);
+        logger.info('Started');
+        // Subscribe to bus events if integration has onEvent
+        let unsubscribe;
+        if (module.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(),
+                };
+                module.onEvent(integrationEvent).catch((err) => {
+                    logger.error(`onEvent error: ${err.message}`);
+                });
+            });
+        }
+        this.integrations.push({ name, module, unsubscribe });
+    }
+    getTools() {
+        const tools = [];
+        for (const { module } of this.integrations) {
+            if (module.getTools) {
+                tools.push(...module.getTools());
+            }
+        }
+        return tools;
+    }
+    getLoadedNames() {
+        return this.integrations.map((i) => i.name);
+    }
+    async stopAll() {
+        for (const integration of this.integrations) {
+            try {
+                if (integration.unsubscribe)
+                    integration.unsubscribe();
+                await integration.module.stop();
+                if (this.verbose) {
+                    console.error(`[integrations] Stopped: ${integration.name}`);
+                }
+            }
+            catch (err) {
+                console.error(`[integrations] Error stopping "${integration.name}": ${err.message}`);
+            }
+        }
+        this.integrations = [];
+    }
+    createLogger(name) {
+        const prefix = `[int:${name}]`;
+        return {
+            info: (msg, ...args) => {
+                if (this.verbose)
+                    console.error(`${prefix} ${msg}`, ...args);
+            },
+            warn: (msg, ...args) => {
+                console.error(`${prefix} WARN: ${msg}`, ...args);
+            },
+            error: (msg, ...args) => {
+                console.error(`${prefix} ERROR: ${msg}`, ...args);
+            },
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/integrations/manager.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structured logging utility for the incubator.
+ *
+ * Supports two formats:
+ *   - text (default): Human-readable ANSI output to stderr
+ *   - json: JSONL output to stderr (machine-parseable)
+ *
+ * Set via --log-format=json flag.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogFormat = 'text' | 'json';
+export declare function setLogFormat(format: LogFormat): void;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function setLogPrefix(p: string): void;
+export declare function getLogFormat(): LogFormat;
+/** Log a message at the given level. In JSON mode, outputs JSONL to stderr. */
+export declare function log(level: LogLevel, msg: string, data?: Record<string, unknown>): void;
+/** Convenience: info-level log */
+export declare function logInfo(msg: string, data?: Record<string, unknown>): void;
+/** Convenience: warn-level log */
+export declare function logWarn(msg: string, data?: Record<string, unknown>): void;
+/** Convenience: error-level log */
+export declare function logError(msg: string, data?: Record<string, unknown>): void;
+/** Convenience: debug-level log */
+export declare function logDebug(msg: string, data?: Record<string, unknown>): void;

package/dist/log.js

@@ -0,0 +1,67 @@
+/**
+ * Structured logging utility for the incubator.
+ *
+ * Supports two formats:
+ *   - text (default): Human-readable ANSI output to stderr
+ *   - json: JSONL output to stderr (machine-parseable)
+ *
+ * Set via --log-format=json flag.
+ */
+let currentFormat = 'text';
+let currentLevel = 'info';
+let prefix = '[incubator]';
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export function setLogFormat(format) {
+    currentFormat = format;
+}
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function setLogPrefix(p) {
+    prefix = p;
+}
+export function getLogFormat() {
+    return currentFormat;
+}
+/** Log a message at the given level. In JSON mode, outputs JSONL to stderr. */
+export function log(level, msg, data) {
+    if (LEVEL_ORDER[level] < LEVEL_ORDER[currentLevel])
+        return;
+    if (currentFormat === 'json') {
+        const entry = {
+            ts: new Date().toISOString(),
+            level,
+            source: 'incubator',
+            msg,
+        };
+        if (data)
+            entry.data = data;
+        console.error(JSON.stringify(entry));
+    }
+    else {
+        const ts = new Date().toISOString().slice(11, 23);
+        console.error(`${prefix} ${ts} ${msg}`);
+    }
+}
+/** Convenience: info-level log */
+export function logInfo(msg, data) {
+    log('info', msg, data);
+}
+/** Convenience: warn-level log */
+export function logWarn(msg, data) {
+    log('warn', msg, data);
+}
+/** Convenience: error-level log */
+export function logError(msg, data) {
+    log('error', msg, data);
+}
+/** Convenience: debug-level log */
+export function logDebug(msg, data) {
+    log('debug', msg, data);
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,IAAI,aAAa,GAAc,MAAM,CAAC;AACtC,IAAI,YAAY,GAAa,MAAM,CAAC;AACpC,IAAI,MAAM,GAAG,aAAa,CAAC;AAE3B,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,MAAM,GAAG,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,GAAW,EAAE,IAA8B;IAC9E,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC;QAAE,OAAO;IAE3D,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,KAAK,GAA4B;YACrC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,KAAK;YACL,MAAM,EAAE,WAAW;YACnB,GAAG;SACJ,CAAC;QACF,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAA8B;IACjE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAA8B;IACjE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAA8B;IAClE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAA8B;IAClE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/namespaces.d.ts

@@ -0,0 +1,28 @@
+import { type BackendConfig } from './stores/backend.js';
+import { type Guard } from './guard.js';
+import type { Stores } from './stores/interfaces.js';
+import type { NotificationBus } from './bus.js';
+import type { ProtocolSpec } from '@agentcoordinationprotocol/spec';
+import { TopicRouter, type TopicRouterOptions } from './honeycomb.js';
+export declare class NamespaceRegistry {
+    private namespaces;
+    private protocols;
+    private guard?;
+    private verbose?;
+    private telemetry?;
+    private backendConfig;
+    private bus?;
+    private router?;
+    constructor(backendConfig?: BackendConfig);
+    setGuard(guard: Guard, verbose?: boolean, telemetry?: {
+        record(type: string, meta: Record<string, unknown>): void;
+    }): void;
+    setBus(bus: NotificationBus, routerOptions?: TopicRouterOptions): void;
+    getRouter(): TopicRouter | undefined;
+    get(namespace: string): Stores;
+    list(): string[];
+    delete(namespace: string): boolean;
+    has(namespace: string): boolean;
+    setProtocol(namespace: string, spec: ProtocolSpec): void;
+    getProtocol(namespace: string): ProtocolSpec | undefined;
+}

package/dist/namespaces.js

@@ -0,0 +1,100 @@
+import { createBackend } from './stores/backend.js';
+import { createGuardedStores } from './guard.js';
+import { TopicRouter } from './honeycomb.js';
+const RESERVED_NAMES = new Set(['_ns']);
+function installNotifications(stores, bus, namespace) {
+    // Patch the event store's publish method IN PLACE so that claims/discoveries
+    // (which hold a direct reference to this same event store instance) also
+    // trigger bus notifications for their internal events (claim.acquired, etc.)
+    const original = stores.events.publish.bind(stores.events);
+    stores.events.publish = async (type, data, agentId) => {
+        const event = await original(type, data, agentId);
+        bus.publish(namespace, event);
+        return event;
+    };
+}
+export class NamespaceRegistry {
+    namespaces = new Map();
+    protocols = new Map();
+    guard;
+    verbose;
+    telemetry;
+    backendConfig;
+    bus;
+    router;
+    constructor(backendConfig) {
+        this.backendConfig = backendConfig ?? { type: 'memory' };
+    }
+    setGuard(guard, verbose, telemetry) {
+        this.guard = guard;
+        this.verbose = verbose;
+        this.telemetry = telemetry;
+    }
+    setBus(bus, routerOptions) {
+        this.bus = bus;
+        this.router = new TopicRouter((ns) => this.get(ns), bus, routerOptions);
+        // Re-register protocols loaded before the bus was set
+        for (const [ns, spec] of this.protocols) {
+            if (spec.topics) {
+                this.router.registerProtocol(ns, spec);
+            }
+        }
+    }
+    getRouter() {
+        return this.router;
+    }
+    get(namespace) {
+        if (RESERVED_NAMES.has(namespace)) {
+            throw new Error(`'${namespace}' is a reserved name and cannot be used as a namespace`);
+        }
+        // Validate namespace name
+        if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(namespace)) {
+            throw new Error(`Invalid namespace: must match /^[a-z0-9][a-z0-9_-]{0,63}$/`);
+        }
+        let stores = this.namespaces.get(namespace);
+        if (stores)
+            return stores;
+        // Cap total namespace count
+        if (this.namespaces.size >= 100) {
+            throw new Error('Maximum namespace count (100) reached');
+        }
+        stores = createBackend({ ...this.backendConfig, namespace });
+        if (this.bus) {
+            // Install BEFORE guard wrapping — patches the raw event store that
+            // claims/discoveries hold a direct reference to, so their internal
+            // events (claim.acquired, discovery.published) also notify the bus.
+            installNotifications(stores, this.bus, namespace);
+        }
+        if (this.guard) {
+            stores = createGuardedStores(stores, this.guard, this.verbose, this.telemetry);
+        }
+        this.namespaces.set(namespace, stores);
+        // Watch this namespace for cross-namespace topic routing
+        if (this.router) {
+            this.router.watch(namespace);
+        }
+        return stores;
+    }
+    list() {
+        return [...this.namespaces.keys()];
+    }
+    delete(namespace) {
+        if (this.router) {
+            this.router.clearNamespace(namespace);
+        }
+        return this.namespaces.delete(namespace);
+    }
+    has(namespace) {
+        return this.namespaces.has(namespace);
+    }
+    setProtocol(namespace, spec) {
+        this.protocols.set(namespace, spec);
+        if (this.router && spec.topics) {
+            this.router.registerProtocol(namespace, spec);
+        }
+    }
+    getProtocol(namespace) {
+        return this.protocols.get(namespace);
+    }
+}
+//# sourceMappingURL=namespaces.js.map

package/dist/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAc,MAAM,YAAY,CAAC;AAK7D,OAAO,EAAE,WAAW,EAA2B,MAAM,gBAAgB,CAAC;AAEtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAExC,SAAS,oBAAoB,CAAC,MAAc,EAAE,GAAoB,EAAE,SAAiB;IACnF,6EAA6E;IAC7E,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAE,OAAe,EAA2B,EAAE;QACtG,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,iBAAiB;IACpB,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,KAAK,CAAS;IACd,OAAO,CAAW;IAClB,SAAS,CAAiE;IAC1E,aAAa,CAAgB;IAC7B,GAAG,CAAmB;IACtB,MAAM,CAAe;IAE7B,YAAY,aAA6B;QACvC,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,KAAY,EAAE,OAAiB,EAAE,SAAyE;QACjH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAoB,EAAE,aAAkC;QAC7D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QAExE,sDAAsD;QACtD,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,IAAI,SAAS,wDAAwD,CAAC,CAAC;QACzF,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,4BAA4B;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,mEAAmE;YACnE,mEAAmE;YACnE,oEAAoE;YACpE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEvC,yDAAyD;QACzD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,IAAkB;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,119 @@
+import type { NotificationBus } from './bus.js';
+import type { Stores, IRunStore } from './stores/interfaces.js';
+import type { NamespaceRegistry } from './namespaces.js';
+import type { DanceModule } from './dances.js';
+import type { TelemetryReporter } from '@honeybee-ai/hivemind-sdk/telemetry';
+import type { PluginManager } from './plugins/index.js';
+export interface MockAction {
+    tool: string;
+    args: Record<string, unknown>;
+    response?: string;
+}
+export interface MockBehavior {
+    actions: MockAction[];
+    maxIterations?: number;
+    iterationDelay?: number;
+}
+export interface AgentSpec {
+    role: string;
+    count?: number;
+    /** 'worker' = in-process tools (default), 'drone' = MCP tools, 'claude' = Claude Code instance, 'mock' = scripted test agent */
+    type?: 'worker' | 'drone' | 'claude' | 'mock';
+    tools?: string[] | 'all';
+    coordination?: string | string[];
+    modelHint?: string | null;
+    /** Custom prompt for claude agents. */
+    prompt?: string | null;
+    /** Path to a Claude Code plugin directory (--plugin-dir). */
+    pluginDir?: string | null;
+    startOn?: {
+        conditions: Array<{
+            event: string;
+            count: number;
+        }>;
+        timeout: number;
+    } | null;
+    wakeOn?: {
+        types?: string[] | null;
+        timeout?: number;
+        maxWakes?: number;
+    } | null;
+    /** Mock behavior for type: 'mock' agents. */
+    mock?: MockBehavior | null;
+}
+export interface AgentsConfig {
+    provider: string;
+    stagger: number;
+    noAcp: boolean;
+    propolisPort: number;
+    worktree: string;
+    /** When true, use https:// for INCUBATOR_URL. */
+    tls?: boolean;
+    /** Unified hive entry point (replaces droneEntry + propolisEntry) */
+    hiveEntry: string;
+    /** @deprecated Use hiveEntry. Kept for backwards compat with older CLI. */
+    droneEntry?: string;
+    /** @deprecated Use hiveEntry. Kept for backwards compat with older CLI. */
+    propolisEntry?: string;
+    protocolPath?: string;
+    agents: AgentSpec[];
+    models?: Record<string, string>;
+    env?: Record<string, string>;
+}
+export interface AgentInfo {
+    pid?: number;
+    agentId: string;
+    role: string;
+    type: 'propolis' | 'drone' | 'worker' | 'claude';
+    inProcess?: boolean;
+}
+/**
+ * Spawns and manages agent child processes within a single hive.
+ *
+ * Worker agents: run in-process via AgentPool (no child process).
+ * Drone agents: propolis process + drone processes (MCP tools over HTTP).
+ * Claude agents: Claude Code instances as child processes.
+ */
+export declare class BroodOrchestrator {
+    private config;
+    private incubatorPort;
+    private bus?;
+    private runs?;
+    private verbose;
+    private stores?;
+    private registry?;
+    private danceModule?;
+    private telemetry?;
+    private pluginManager?;
+    private children;
+    private childInfo;
+    private propolisPid?;
+    private pool?;
+    constructor(config: AgentsConfig, incubatorPort: number, bus?: NotificationBus | undefined, runs?: IRunStore | undefined, verbose?: boolean, stores?: Stores | undefined, registry?: NamespaceRegistry | undefined, danceModule?: DanceModule | undefined, telemetry?: TelemetryReporter | undefined, pluginManager?: PluginManager | undefined);
+    private log;
+    /** Resolve hive entry point (supports old droneEntry/propolisEntry for backwards compat) */
+    private get hiveEntry();
+    /** Resolve propolis entry (from hive package or legacy propolisEntry) */
+    private get propolisEntry();
+    start(): Promise<void>;
+    private spawnPropolis;
+    /** Check if in-process mode is available (stores injected). */
+    private get canRunInProcess();
+    private spawnAgents;
+    /**
+     * Start a Claude agent using the Agent SDK (programmatic, no subprocess).
+     * Returns true if SDK was available and agent was started, false to fall back.
+     */
+    private startClaudeAgent;
+    /**
+     * Spawn a Claude Code instance with ACP coordination env vars.
+     * Claude Code's native tools handle the env side; the ACP plugin handles coordination.
+     */
+    private spawnClaude;
+    /** Get info about all agents (in-process + child processes). */
+    getAgents(): AgentInfo[];
+    /** Kill a specific agent. Pool agents: runner.stop(). Child processes: SIGTERM. */
+    killAgent(agentId: string): Promise<void>;
+    /** Graceful shutdown: stop pool agents → SIGTERM child processes → propolis. */
+    shutdown(): Promise<void>;
+}