@generacy-ai/agency 0.0.0-preview-20260228204303

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Generacy AI Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/channels/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Channels module for Agency
+ *
+ * Provides inter-plugin communication via pub/sub channels.
+ */
+export type { ChannelDefinition, MessageEnvelope, MessageHandler, Unsubscribe, ChannelState, CreateMessageOptions, PendingResponse, DeliveryResult, } from './types.js';
+export { createMessageEnvelope } from './types.js';
+export { ChannelManager, ChannelErrorCodes, BUILT_IN_CHANNELS } from './manager.js';
+export { isVersionCompatible } from './version.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/channels/index.js

@@ -0,0 +1,9 @@
+/**
+ * Channels module for Agency
+ *
+ * Provides inter-plugin communication via pub/sub channels.
+ */
+export { createMessageEnvelope } from './types.js';
+export { ChannelManager, ChannelErrorCodes, BUILT_IN_CHANNELS } from './manager.js';
+export { isVersionCompatible } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/channels/manager.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Channel Manager for Agency
+ *
+ * Manages inter-plugin communication channels using a pub/sub pattern.
+ * Channels are registered by plugins and can be used for decoupled messaging.
+ */
+import type { ChannelDefinition, MessageEnvelope } from '../plugins/types.js';
+import type { MessageHandler, Unsubscribe, DeliveryResult } from './types.js';
+/**
+ * Channel manager error codes (re-export for convenience)
+ */
+export declare const ChannelErrorCodes: {
+    readonly CHANNEL_NOT_FOUND: "CHANNEL_NOT_FOUND";
+    readonly CHANNEL_ALREADY_EXISTS: "CHANNEL_ALREADY_REGISTERED";
+    readonly CHANNEL_VERSION_MISMATCH: "CHANNEL_VERSION_MISMATCH";
+    readonly CHANNEL_TIMEOUT: "CHANNEL_TIMEOUT";
+    readonly CHANNEL_DELIVERY_FAILED: "CHANNEL_DELIVERY_FAILED";
+};
+/**
+ * Built-in channel definitions
+ */
+export declare const BUILT_IN_CHANNELS: ChannelDefinition[];
+/**
+ * Channel Manager for inter-plugin communication
+ *
+ * Provides a simple pub/sub mechanism for plugins to communicate
+ * without direct coupling.
+ */
+export declare class ChannelManager {
+    private readonly channels;
+    /**
+     * Register a new communication channel
+     *
+     * @param channel Channel definition
+     * @throws AgencyError if channel already exists
+     */
+    registerChannel(channel: ChannelDefinition): void;
+    /**
+     * Unregister a channel
+     *
+     * @param name Channel name to unregister
+     * @returns true if channel was found and removed
+     */
+    unregisterChannel(name: string): boolean;
+    /**
+     * Check if a channel exists
+     *
+     * @param name Channel name
+     * @returns true if channel is registered
+     */
+    hasChannel(name: string): boolean;
+    /**
+     * Get channel definition
+     *
+     * @param name Channel name
+     * @returns Channel definition or undefined
+     */
+    getChannel(name: string): ChannelDefinition | undefined;
+    /**
+     * Get all registered channel names
+     *
+     * @returns Array of channel names
+     */
+    getChannelNames(): string[];
+    /**
+     * Get all registered channel definitions
+     *
+     * @returns Array of channel definitions
+     */
+    getChannels(): ChannelDefinition[];
+    /**
+     * Find a channel by ID with optional version filtering
+     *
+     * @param id Channel ID to find
+     * @param minVersion Minimum required version (optional)
+     * @returns Channel definition if found and version compatible, undefined otherwise
+     */
+    findChannel(id: string, minVersion?: string): ChannelDefinition | undefined;
+    /**
+     * Find channels paired with the given channel
+     *
+     * @param channel Channel to find pairs for
+     * @returns Array of paired channel definitions
+     */
+    findPair(channel: ChannelDefinition): ChannelDefinition[];
+    /**
+     * Subscribe to a channel
+     *
+     * @param channel Channel name
+     * @param handler Message handler function
+     * @returns Unsubscribe function
+     * @throws AgencyError if channel doesn't exist
+     */
+    subscribe<T>(channel: string, handler: MessageHandler<T>): Unsubscribe;
+    /**
+     * Send a message to a channel with async parallel delivery
+     *
+     * @param channel Channel name
+     * @param message Message envelope to send
+     * @returns Delivery result with success count and any errors
+     * @throws AgencyError if channel doesn't exist or all handlers fail
+     */
+    send<T>(channel: string, message: MessageEnvelope<T>): Promise<DeliveryResult>;
+    /**
+     * Convenience method to send a message with auto-generated envelope
+     *
+     * @param channel Channel name
+     * @param sender Sender plugin ID
+     * @param payload Message payload
+     * @param correlationId Optional correlation ID
+     * @returns Delivery result with success count and any errors
+     */
+    sendMessage<T>(channel: string, sender: string, payload: T, correlationId?: string): Promise<DeliveryResult>;
+    /**
+     * Default timeout for sendAndWait in milliseconds
+     */
+    private static readonly DEFAULT_TIMEOUT;
+    /**
+     * Send a message and wait for a response with matching correlation ID
+     *
+     * @param channelId Channel to send to
+     * @param message Message envelope to send
+     * @param timeout Timeout in milliseconds (default: 30000)
+     * @returns Promise that resolves with the response message
+     * @throws AgencyError if channel doesn't exist or timeout occurs
+     */
+    sendAndWait<T, R = unknown>(channelId: string, message: MessageEnvelope<T>, timeout?: number): Promise<MessageEnvelope<R>>;
+    /**
+     * Get the number of subscribers for a channel
+     *
+     * @param channel Channel name
+     * @returns Number of subscribers or 0 if channel doesn't exist
+     */
+    getSubscriberCount(channel: string): number;
+    /**
+     * Get the message count for a channel
+     *
+     * @param channel Channel name
+     * @returns Number of messages sent or 0 if channel doesn't exist
+     */
+    getMessageCount(channel: string): number;
+    /**
+     * Get all channels registered by a specific owner
+     *
+     * @param owner Owner plugin ID
+     * @returns Array of channel definitions
+     */
+    getChannelsByOwner(owner: string): ChannelDefinition[];
+    /**
+     * Unregister all channels owned by a plugin
+     *
+     * @param owner Owner plugin ID
+     * @returns Number of channels removed
+     */
+    unregisterChannelsByOwner(owner: string): number;
+    /**
+     * Clear all channels
+     */
+    clear(): void;
+    /**
+     * Register all built-in Agency channels
+     *
+     * This should be called during Agency initialization to set up
+     * the standard channels for lifecycle, mode, telemetry, and bridging.
+     */
+    registerBuiltInChannels(): void;
+    /**
+     * Get statistics about all channels
+     *
+     * @returns Object with channel statistics
+     */
+    getStats(): {
+        totalChannels: number;
+        totalSubscribers: number;
+        totalMessages: number;
+        channelStats: Array<{
+            name: string;
+            owner: string;
+            subscribers: number;
+            messages: number;
+        }>;
+    };
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/channels/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/channels/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAiC,cAAc,EAAE,MAAM,YAAY,CAAC;AAI7G;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAiChD,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAiBjD;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAIlC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAgB3E;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IA0BzD;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW;IAiBtE;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAwEpF;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EACV,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC;IAU1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEhD;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,MAAuC,GAC/C,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IA0D9B;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIxC;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAMtD;;;;;OAKG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAWhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,uBAAuB,IAAI,IAAI;IAQ/B;;;;OAIG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,KAAK,CAAC;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACJ;CA4BF"}

package/dist/channels/manager.js

@@ -0,0 +1,414 @@
+/**
+ * Channel Manager for Agency
+ *
+ * Manages inter-plugin communication channels using a pub/sub pattern.
+ * Channels are registered by plugins and can be used for decoupled messaging.
+ */
+import { AgencyError, ErrorCodes } from '../errors/index.js';
+import { createMessageEnvelope } from './types.js';
+import { isVersionCompatible } from './version.js';
+/**
+ * Channel manager error codes (re-export for convenience)
+ */
+export const ChannelErrorCodes = {
+    CHANNEL_NOT_FOUND: ErrorCodes.CHANNEL_NOT_FOUND,
+    CHANNEL_ALREADY_EXISTS: ErrorCodes.CHANNEL_ALREADY_REGISTERED,
+    CHANNEL_VERSION_MISMATCH: ErrorCodes.CHANNEL_VERSION_MISMATCH,
+    CHANNEL_TIMEOUT: ErrorCodes.CHANNEL_TIMEOUT,
+    CHANNEL_DELIVERY_FAILED: ErrorCodes.CHANNEL_DELIVERY_FAILED,
+};
+/**
+ * Built-in channel definitions
+ */
+export const BUILT_IN_CHANNELS = [
+    {
+        name: 'agency.lifecycle',
+        version: '1.0.0',
+        description: 'Plugin lifecycle events (start, stop, reload)',
+        owner: '@generacy-ai/agency',
+        messageTypes: ['start', 'stop', 'reload'],
+    },
+    {
+        name: 'agency.mode',
+        version: '1.0.0',
+        description: 'Mode change notifications',
+        owner: '@generacy-ai/agency',
+        messageTypes: ['change'],
+    },
+    {
+        name: 'agency.telemetry',
+        version: '1.0.0',
+        description: 'Telemetry event aggregation',
+        owner: '@generacy-ai/agency',
+        messageTypes: ['event', 'metric'],
+    },
+    {
+        name: 'agency.humancy',
+        version: '1.0.0',
+        description: 'Bridge to Humancy component',
+        owner: '@generacy-ai/agency',
+        messageTypes: ['*'],
+        pairedWith: {
+            component: 'humancy',
+            channelId: 'humancy.agency',
+        },
+    },
+];
+/**
+ * Channel Manager for inter-plugin communication
+ *
+ * Provides a simple pub/sub mechanism for plugins to communicate
+ * without direct coupling.
+ */
+export class ChannelManager {
+    channels = new Map();
+    /**
+     * Register a new communication channel
+     *
+     * @param channel Channel definition
+     * @throws AgencyError if channel already exists
+     */
+    registerChannel(channel) {
+        if (this.channels.has(channel.name)) {
+            throw new AgencyError(ErrorCodes.CHANNEL_ALREADY_REGISTERED, `Channel already exists: ${channel.name}`, { channelName: channel.name, existingOwner: this.channels.get(channel.name)?.definition.owner });
+        }
+        this.channels.set(channel.name, {
+            definition: channel,
+            subscribers: new Set(),
+            messageCount: 0,
+            pendingResponses: new Map(),
+        });
+    }
+    /**
+     * Unregister a channel
+     *
+     * @param name Channel name to unregister
+     * @returns true if channel was found and removed
+     */
+    unregisterChannel(name) {
+        return this.channels.delete(name);
+    }
+    /**
+     * Check if a channel exists
+     *
+     * @param name Channel name
+     * @returns true if channel is registered
+     */
+    hasChannel(name) {
+        return this.channels.has(name);
+    }
+    /**
+     * Get channel definition
+     *
+     * @param name Channel name
+     * @returns Channel definition or undefined
+     */
+    getChannel(name) {
+        return this.channels.get(name)?.definition;
+    }
+    /**
+     * Get all registered channel names
+     *
+     * @returns Array of channel names
+     */
+    getChannelNames() {
+        return [...this.channels.keys()];
+    }
+    /**
+     * Get all registered channel definitions
+     *
+     * @returns Array of channel definitions
+     */
+    getChannels() {
+        return [...this.channels.values()].map((state) => state.definition);
+    }
+    /**
+     * Find a channel by ID with optional version filtering
+     *
+     * @param id Channel ID to find
+     * @param minVersion Minimum required version (optional)
+     * @returns Channel definition if found and version compatible, undefined otherwise
+     */
+    findChannel(id, minVersion) {
+        const state = this.channels.get(id);
+        if (!state) {
+            return undefined;
+        }
+        if (minVersion) {
+            const channelVersion = state.definition.version;
+            if (!channelVersion || !isVersionCompatible(channelVersion, minVersion)) {
+                return undefined;
+            }
+        }
+        return state.definition;
+    }
+    /**
+     * Find channels paired with the given channel
+     *
+     * @param channel Channel to find pairs for
+     * @returns Array of paired channel definitions
+     */
+    findPair(channel) {
+        const pairs = [];
+        for (const state of this.channels.values()) {
+            const def = state.definition;
+            // Check if this channel is paired with the input channel
+            if (def.pairedWith &&
+                def.pairedWith.channelId === channel.name) {
+                pairs.push(def);
+            }
+            // Also check if input channel is paired with this channel
+            if (channel.pairedWith &&
+                channel.pairedWith.channelId === def.name) {
+                if (!pairs.includes(def)) {
+                    pairs.push(def);
+                }
+            }
+        }
+        return pairs;
+    }
+    /**
+     * Subscribe to a channel
+     *
+     * @param channel Channel name
+     * @param handler Message handler function
+     * @returns Unsubscribe function
+     * @throws AgencyError if channel doesn't exist
+     */
+    subscribe(channel, handler) {
+        const state = this.channels.get(channel);
+        if (!state) {
+            throw new AgencyError(ErrorCodes.CHANNEL_NOT_FOUND, `Channel not found: ${channel}`, { channelName: channel });
+        }
+        state.subscribers.add(handler);
+        return () => {
+            state.subscribers.delete(handler);
+        };
+    }
+    /**
+     * Send a message to a channel with async parallel delivery
+     *
+     * @param channel Channel name
+     * @param message Message envelope to send
+     * @returns Delivery result with success count and any errors
+     * @throws AgencyError if channel doesn't exist or all handlers fail
+     */
+    async send(channel, message) {
+        const state = this.channels.get(channel);
+        if (!state) {
+            throw new AgencyError(ErrorCodes.CHANNEL_NOT_FOUND, `Channel not found: ${channel}`, { channelName: channel });
+        }
+        state.messageCount++;
+        // Check for response to pending sendAndWait
+        // Only intercept if this is a RESPONSE (different message ID than the original request)
+        if (message.correlationId) {
+            const pending = state.pendingResponses.get(message.correlationId);
+            // Only resolve if this is a response (different message ID than the original request)
+            if (pending && message.id !== pending.requestMessageId) {
+                clearTimeout(pending.timeoutId);
+                state.pendingResponses.delete(message.correlationId);
+                pending.resolve(message);
+                // Response messages are not delivered to subscribers to avoid infinite loops
+                return { successCount: 0, errors: [] };
+            }
+        }
+        // Parallel delivery to all subscribers
+        const errors = [];
+        let successCount = 0;
+        const results = await Promise.allSettled([...state.subscribers].map(async (handler, index) => {
+            try {
+                await handler(message);
+                return { success: true, index };
+            }
+            catch (error) {
+                return { success: false, index, error: error };
+            }
+        }));
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                if (result.value.success) {
+                    successCount++;
+                }
+                else {
+                    errors.push({
+                        handler: `handler_${result.value.index}`,
+                        error: result.value.error,
+                    });
+                }
+            }
+            else {
+                // Promise.allSettled should not reject, but handle just in case
+                errors.push({
+                    handler: 'unknown',
+                    error: result.reason,
+                });
+            }
+        }
+        // If all handlers failed and there were handlers, throw an aggregate error
+        if (errors.length > 0 && successCount === 0 && state.subscribers.size > 0) {
+            throw new AgencyError(ErrorCodes.CHANNEL_DELIVERY_FAILED, `All message handlers failed for channel: ${channel}`, { channelName: channel, errorCount: errors.length });
+        }
+        return { successCount, errors };
+    }
+    /**
+     * Convenience method to send a message with auto-generated envelope
+     *
+     * @param channel Channel name
+     * @param sender Sender plugin ID
+     * @param payload Message payload
+     * @param correlationId Optional correlation ID
+     * @returns Delivery result with success count and any errors
+     */
+    async sendMessage(channel, sender, payload, correlationId) {
+        const envelope = createMessageEnvelope({
+            channel,
+            sender,
+            payload,
+            correlationId,
+        });
+        return this.send(channel, envelope);
+    }
+    /**
+     * Default timeout for sendAndWait in milliseconds
+     */
+    static DEFAULT_TIMEOUT = 30000;
+    /**
+     * Send a message and wait for a response with matching correlation ID
+     *
+     * @param channelId Channel to send to
+     * @param message Message envelope to send
+     * @param timeout Timeout in milliseconds (default: 30000)
+     * @returns Promise that resolves with the response message
+     * @throws AgencyError if channel doesn't exist or timeout occurs
+     */
+    async sendAndWait(channelId, message, timeout = ChannelManager.DEFAULT_TIMEOUT) {
+        const state = this.channels.get(channelId);
+        if (!state) {
+            throw new AgencyError(ErrorCodes.CHANNEL_NOT_FOUND, `Channel not found: ${channelId}`, { channelName: channelId });
+        }
+        // Ensure message has a correlation ID
+        const correlationId = message.correlationId || crypto.randomUUID();
+        const messageWithCorrelation = {
+            ...message,
+            correlationId,
+        };
+        // Set up response promise and pending entry
+        let resolveFn;
+        let rejectFn;
+        const responsePromise = new Promise((resolve, reject) => {
+            resolveFn = resolve;
+            rejectFn = reject;
+        });
+        const timeoutId = setTimeout(() => {
+            state.pendingResponses.delete(correlationId);
+            rejectFn(new AgencyError(ErrorCodes.CHANNEL_TIMEOUT, `Timeout waiting for response on channel: ${channelId}`, { channelName: channelId, correlationId, timeoutMs: timeout }));
+        }, timeout);
+        const pending = {
+            resolve: resolveFn,
+            reject: rejectFn,
+            timeoutId,
+            requestMessageId: messageWithCorrelation.id,
+        };
+        // Register the pending response BEFORE sending
+        // The send() method will check for this correlation ID only for RESPONSE messages
+        // (those with a different message ID than the original request)
+        state.pendingResponses.set(correlationId, pending);
+        // Send the message - this triggers handlers which may respond
+        // The handler response will use the same correlationId, which will be
+        // caught by the pending response check in send()
+        await this.send(channelId, messageWithCorrelation);
+        // Wait for response
+        return responsePromise;
+    }
+    /**
+     * Get the number of subscribers for a channel
+     *
+     * @param channel Channel name
+     * @returns Number of subscribers or 0 if channel doesn't exist
+     */
+    getSubscriberCount(channel) {
+        return this.channels.get(channel)?.subscribers.size ?? 0;
+    }
+    /**
+     * Get the message count for a channel
+     *
+     * @param channel Channel name
+     * @returns Number of messages sent or 0 if channel doesn't exist
+     */
+    getMessageCount(channel) {
+        return this.channels.get(channel)?.messageCount ?? 0;
+    }
+    /**
+     * Get all channels registered by a specific owner
+     *
+     * @param owner Owner plugin ID
+     * @returns Array of channel definitions
+     */
+    getChannelsByOwner(owner) {
+        return [...this.channels.values()]
+            .filter((state) => state.definition.owner === owner)
+            .map((state) => state.definition);
+    }
+    /**
+     * Unregister all channels owned by a plugin
+     *
+     * @param owner Owner plugin ID
+     * @returns Number of channels removed
+     */
+    unregisterChannelsByOwner(owner) {
+        let count = 0;
+        for (const [name, state] of this.channels) {
+            if (state.definition.owner === owner) {
+                this.channels.delete(name);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear all channels
+     */
+    clear() {
+        this.channels.clear();
+    }
+    /**
+     * Register all built-in Agency channels
+     *
+     * This should be called during Agency initialization to set up
+     * the standard channels for lifecycle, mode, telemetry, and bridging.
+     */
+    registerBuiltInChannels() {
+        for (const channel of BUILT_IN_CHANNELS) {
+            if (!this.channels.has(channel.name)) {
+                this.registerChannel(channel);
+            }
+        }
+    }
+    /**
+     * Get statistics about all channels
+     *
+     * @returns Object with channel statistics
+     */
+    getStats() {
+        let totalSubscribers = 0;
+        let totalMessages = 0;
+        const channelStats = [];
+        for (const [name, state] of this.channels) {
+            totalSubscribers += state.subscribers.size;
+            totalMessages += state.messageCount;
+            channelStats.push({
+                name,
+                owner: state.definition.owner,
+                subscribers: state.subscribers.size,
+                messages: state.messageCount,
+            });
+        }
+        return {
+            totalChannels: this.channels.size,
+            totalSubscribers,
+            totalMessages,
+            channelStats,
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/channels/manager.js.map

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