@framers/agentos 0.1.0

package/dist/core/streaming/StreamingManager.d.ts

@@ -0,0 +1,242 @@
+/**
+ * @fileoverview Implements the StreamingManager, a core component responsible for
+ * managing real-time data streams within AgentOS. It handles the lifecycle of streams,
+ * registration of clients to streams, and distribution of data chunks to subscribed clients.
+ * This manager is designed for robustness, scalability (conceptual), and clear error handling.
+ *
+ * @module backend/core/streaming/StreamingManager
+ * @see ./IStreamClient.ts For the client contract.
+ * @see ../../api/types/AgentOSResponse.ts For the data chunk structure.
+ */
+import { AgentOSResponse } from '../../api/types/AgentOSResponse';
+import { IStreamClient, StreamClientId } from './IStreamClient';
+import { GMIError, GMIErrorCode } from '../../utils/errors';
+/**
+ * Represents a unique identifier for a data stream.
+ * @typedef {string} StreamId
+ */
+export type StreamId = string;
+/**
+ * Configuration options for the StreamingManager.
+ * @interface StreamingManagerConfig
+ */
+export interface StreamingManagerConfig {
+    /**
+     * Maximum number of concurrent active streams allowed.
+     * If set to 0 or a negative number, it implies no limit (not recommended for production).
+     * @type {number}
+     * @default 1000
+     */
+    maxConcurrentStreams?: number;
+    /**
+     * Default timeout in milliseconds for a stream if no activity is detected.
+     * If set to 0, streams do not time out automatically. (Conceptual, requires active tracking)
+     * @type {number}
+     * @default 300000 (5 minutes)
+     */
+    defaultStreamInactivityTimeoutMs?: number;
+    /**
+     * Maximum number of clients allowed to subscribe to a single stream.
+     * If set to 0 or a negative number, it implies no limit.
+     * @type {number}
+     * @default 10
+     */
+    maxClientsPerStream?: number;
+    /**
+     * Optional: Defines the behavior when trying to push a chunk to a client whose `sendChunk` method fails.
+     * - 'log_and_continue': Logs the error and continues sending to other clients. (Default)
+     * - 'deregister_client': Logs the error, attempts to deregister the failing client, and continues.
+     * - 'throw': Throws an error, potentially stopping the push operation for the current chunk to other clients.
+     * @type {'log_and_continue' | 'deregister_client' | 'throw'}
+     * @default 'log_and_continue'
+     */
+    onClientSendErrorBehavior?: 'log_and_continue' | 'deregister_client' | 'throw';
+}
+/**
+ * Custom error class for errors originating from the StreamingManager.
+ * @class StreamError
+ * @extends {GMIError}
+ */
+export declare class StreamError extends GMIError {
+    /**
+     * The ID of the stream involved in the error, if applicable.
+     * @public
+     * @readonly
+     * @type {StreamId | undefined}
+     */
+    readonly streamId?: StreamId;
+    /**
+     * The ID of the client involved in the error, if applicable.
+     * @public
+     * @readonly
+     * @type {StreamClientId | undefined}
+     */
+    readonly clientId?: StreamClientId;
+    /**
+     * Creates an instance of StreamError.
+     * @param {string} message - The human-readable error message.
+     * @param {GMIErrorCode | string} code - A specific error code (can be from GMIErrorCode or custom).
+     * @param {StreamId} [streamId] - The ID of the stream involved.
+     * @param {StreamClientId} [clientId] - The ID of the client involved.
+     * @param {any} [details] - Optional additional context or the underlying error.
+     */
+    constructor(message: string, code: GMIErrorCode | string, streamId?: StreamId, clientId?: StreamClientId, details?: any);
+}
+/**
+ * @interface IStreamingManager
+ * @description Defines the contract for the StreamingManager service.
+ * This service is responsible for creating, managing, and terminating data streams,
+ * as well as handling client subscriptions and data distribution.
+ */
+export interface IStreamingManager {
+    /**
+     * Initializes the StreamingManager with its configuration.
+     * This method must be called successfully before any other operations.
+     *
+     * @public
+     * @async
+     * @param {StreamingManagerConfig} config - The configuration for the manager.
+     * @returns {Promise<void>} A promise that resolves upon successful initialization.
+     * @throws {GMIError} If configuration is invalid or initialization fails.
+     */
+    initialize(config: StreamingManagerConfig): Promise<void>;
+    /**
+     * Creates a new data stream and returns its unique ID.
+     *
+     * @public
+     * @param {StreamId} [requestedStreamId] - Optional. If provided, attempts to use this ID.
+     * If not provided or if the ID already exists, a new unique ID will be generated.
+     * @returns {Promise<StreamId>} A promise resolving to the unique ID of the created stream.
+     * @throws {StreamError} If the maximum number of concurrent streams is reached,
+     * or if a `requestedStreamId` is provided but already in use (and regeneration is not supported/fails).
+     */
+    createStream(requestedStreamId?: StreamId): Promise<StreamId>;
+    /**
+     * Registers a client to a specific stream to receive data chunks.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream to subscribe to.
+     * @param {IStreamClient} client - The client instance that implements `IStreamClient`.
+     * @returns {Promise<void>} A promise that resolves when the client is successfully registered.
+     * @throws {StreamError} If the stream does not exist, if the client is already registered,
+     * or if the maximum number of clients for the stream is reached.
+     */
+    registerClient(streamId: StreamId, client: IStreamClient): Promise<void>;
+    /**
+     * Deregisters a client from a specific stream.
+     * The client will no longer receive data chunks for this stream.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream to unsubscribe from.
+     * @param {StreamClientId} clientId - The ID of the client to deregister.
+     * @returns {Promise<void>} A promise that resolves when the client is successfully deregistered.
+     * @throws {StreamError} If the stream or client does not exist within that stream.
+     */
+    deregisterClient(streamId: StreamId, clientId: StreamClientId): Promise<void>;
+    /**
+     * Pushes a data chunk to all clients currently subscribed to the specified stream.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream to push data to.
+     * @param {AgentOSResponse} chunk - The data chunk to distribute.
+     * @returns {Promise<void>} A promise that resolves when the chunk has been pushed to all
+     * active clients of the stream (or attempted, based on `onClientSendErrorBehavior`).
+     * @throws {StreamError} If the stream does not exist, or if `onClientSendErrorBehavior` is 'throw'
+     * and a client send fails.
+     */
+    pushChunk(streamId: StreamId, chunk: AgentOSResponse): Promise<void>;
+    /**
+     * Closes a specific stream. All subscribed clients will be notified and subsequently deregistered.
+     * No further data can be pushed to a closed stream.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream to close.
+     * @param {string} [reason] - An optional reason for closing the stream.
+     * @returns {Promise<void>} A promise that resolves when the stream is closed and clients are notified.
+     * @throws {StreamError} If the stream does not exist.
+     */
+    closeStream(streamId: StreamId, reason?: string): Promise<void>;
+    /**
+     * Handles an error that occurred on a specific stream.
+     * This might involve notifying clients with an error chunk and/or closing the stream.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream where the error occurred.
+     * @param {Error} error - The error object.
+     * @param {boolean} [terminateStream=true] - If true, the stream will be closed after processing the error.
+     * @returns {Promise<void>} A promise that resolves when the error has been handled.
+     * @throws {StreamError} If the stream does not exist.
+     */
+    handleStreamError(streamId: StreamId, error: Error, terminateStream?: boolean): Promise<void>;
+    /**
+     * Retrieves a list of IDs for all currently active streams.
+     *
+     * @public
+     * @returns {Promise<StreamId[]>} A promise resolving to an array of active stream IDs.
+     */
+    getActiveStreamIds(): Promise<StreamId[]>;
+    /**
+     * Retrieves the number of clients currently subscribed to a specific stream.
+     *
+     * @public
+     * @async
+     * @param {StreamId} streamId - The ID of the stream.
+     * @returns {Promise<number>} A promise resolving to the number of clients.
+     * @throws {StreamError} If the stream does not exist.
+     */
+    getClientCountForStream(streamId: StreamId): Promise<number>;
+    /**
+     * Gracefully shuts down the StreamingManager, closing all active streams
+     * and releasing any resources.
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>} A promise that resolves when shutdown is complete.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * @class StreamingManager
+ * @implements {IStreamingManager}
+ * Manages real-time data streams for AgentOS, handling client subscriptions
+ * and chunk distribution.
+ */
+export declare class StreamingManager implements IStreamingManager {
+    private config;
+    private activeStreams;
+    private isInitialized;
+    readonly managerId: string;
+    constructor();
+    /** @inheritdoc */
+    initialize(config: StreamingManagerConfig): Promise<void>;
+    /**
+     * Ensures the manager has been properly initialized before any operations.
+     * @private
+     * @throws {StreamError} If the engine is not initialized.
+     */
+    private ensureInitialized;
+    /** @inheritdoc */
+    createStream(requestedStreamId?: StreamId): Promise<StreamId>;
+    /** @inheritdoc */
+    registerClient(streamId: StreamId, client: IStreamClient): Promise<void>;
+    /** @inheritdoc */
+    deregisterClient(streamId: StreamId, clientId: StreamClientId): Promise<void>;
+    /** @inheritdoc */
+    pushChunk(streamId: StreamId, chunk: AgentOSResponse): Promise<void>;
+    /** @inheritdoc */
+    closeStream(streamId: StreamId, reason?: string): Promise<void>;
+    /** @inheritdoc */
+    handleStreamError(streamId: StreamId, error: Error, terminateStream?: boolean): Promise<void>;
+    /** @inheritdoc */
+    getActiveStreamIds(): Promise<StreamId[]>;
+    /** @inheritdoc */
+    getClientCountForStream(streamId: StreamId): Promise<number>;
+    /** @inheritdoc */
+    shutdown(isReinitializing?: boolean): Promise<void>;
+}
+//# sourceMappingURL=StreamingManager.d.ts.map

package/dist/core/streaming/StreamingManager.d.ts.map

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

package/dist/core/streaming/StreamingManager.js

@@ -0,0 +1,282 @@
+// File: src/core/streaming/StreamingManager.ts
+/**
+ * @fileoverview Implements the StreamingManager, a core component responsible for
+ * managing real-time data streams within AgentOS. It handles the lifecycle of streams,
+ * registration of clients to streams, and distribution of data chunks to subscribed clients.
+ * This manager is designed for robustness, scalability (conceptual), and clear error handling.
+ *
+ * @module backend/core/streaming/StreamingManager
+ * @see ./IStreamClient.ts For the client contract.
+ * @see ../../api/types/AgentOSResponse.ts For the data chunk structure.
+ */
+import { uuidv4 } from '../../utils/uuid.js';
+import { AgentOSResponseChunkType } from '../../api/types/AgentOSResponse.js';
+import { GMIError, GMIErrorCode } from '../../utils/errors.js'; // Corrected path
+/**
+ * Custom error class for errors originating from the StreamingManager.
+ * @class StreamError
+ * @extends {GMIError}
+ */
+export class StreamError extends GMIError {
+    /**
+     * Creates an instance of StreamError.
+     * @param {string} message - The human-readable error message.
+     * @param {GMIErrorCode | string} code - A specific error code (can be from GMIErrorCode or custom).
+     * @param {StreamId} [streamId] - The ID of the stream involved.
+     * @param {StreamClientId} [clientId] - The ID of the client involved.
+     * @param {any} [details] - Optional additional context or the underlying error.
+     */
+    constructor(message, code, streamId, clientId, details) {
+        super(message, code, details);
+        this.name = 'StreamError'; // This is standard for custom errors extending Error
+        this.streamId = streamId;
+        this.clientId = clientId;
+        Object.setPrototypeOf(this, StreamError.prototype);
+    }
+}
+/**
+ * @class StreamingManager
+ * @implements {IStreamingManager}
+ * Manages real-time data streams for AgentOS, handling client subscriptions
+ * and chunk distribution.
+ */
+export class StreamingManager {
+    constructor() {
+        this.isInitialized = false;
+        this.managerId = `streaming-mgr-${uuidv4()}`;
+        this.activeStreams = new Map();
+    }
+    /** @inheritdoc */
+    async initialize(config) {
+        if (this.isInitialized) {
+            console.warn(`StreamingManager (ID: ${this.managerId}) already initialized. Re-initializing.`);
+            await this.shutdown(true);
+        }
+        this.config = Object.freeze({
+            maxConcurrentStreams: config.maxConcurrentStreams === undefined || config.maxConcurrentStreams <= 0 ? Infinity : config.maxConcurrentStreams,
+            defaultStreamInactivityTimeoutMs: config.defaultStreamInactivityTimeoutMs === undefined ? 300000 : config.defaultStreamInactivityTimeoutMs,
+            maxClientsPerStream: config.maxClientsPerStream === undefined || config.maxClientsPerStream <= 0 ? Infinity : config.maxClientsPerStream,
+            onClientSendErrorBehavior: config.onClientSendErrorBehavior || 'log_and_continue',
+        });
+        this.isInitialized = true;
+        console.log(`StreamingManager (ID: ${this.managerId}) initialized. Config:`, JSON.stringify(this.config));
+    }
+    /**
+     * Ensures the manager has been properly initialized before any operations.
+     * @private
+     * @throws {StreamError} If the engine is not initialized.
+     */
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new StreamError(`StreamingManager (ID: ${this.managerId}) is not initialized. Call initialize() first.`, GMIErrorCode.NOT_INITIALIZED);
+        }
+    }
+    /** @inheritdoc */
+    async createStream(requestedStreamId) {
+        this.ensureInitialized();
+        if (this.activeStreams.size >= this.config.maxConcurrentStreams) {
+            throw new StreamError('Maximum number of concurrent streams reached.', GMIErrorCode.RATE_LIMIT_EXCEEDED, undefined, undefined, { maxStreams: this.config.maxConcurrentStreams });
+        }
+        let streamId = requestedStreamId || uuidv4();
+        if (this.activeStreams.has(streamId)) {
+            if (requestedStreamId) {
+                throw new StreamError(`Stream with requested ID '${streamId}' already exists.`, GMIErrorCode.RESOURCE_ALREADY_EXISTS, streamId);
+            }
+            streamId = uuidv4();
+        }
+        const now = Date.now();
+        const newStream = {
+            id: streamId,
+            clients: new Map(),
+            createdAt: now,
+            lastActivityAt: now,
+            metadata: {}, // Initialize empty metadata
+        };
+        this.activeStreams.set(streamId, newStream);
+        console.log(`StreamingManager (ID: ${this.managerId}): Stream '${streamId}' created.`);
+        return streamId;
+    }
+    /** @inheritdoc */
+    async registerClient(streamId, client) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            throw new StreamError(`Stream with ID '${streamId}' not found. Cannot register client.`, GMIErrorCode.RESOURCE_NOT_FOUND, streamId);
+        }
+        if (stream.clients.has(client.id)) {
+            console.warn(`StreamingManager (ID: ${this.managerId}): Client '${client.id}' is already registered to stream '${streamId}'. Ignoring.`);
+            return;
+        }
+        if (stream.clients.size >= this.config.maxClientsPerStream) {
+            throw new StreamError(`Maximum number of clients reached for stream '${streamId}'.`, GMIErrorCode.RATE_LIMIT_EXCEEDED, streamId, client.id, { maxClients: this.config.maxClientsPerStream });
+        }
+        stream.clients.set(client.id, client);
+        stream.lastActivityAt = Date.now();
+        console.log(`StreamingManager (ID: ${this.managerId}): Client '${client.id}' registered to stream '${streamId}'. Total clients: ${stream.clients.size}.`);
+    }
+    /** @inheritdoc */
+    async deregisterClient(streamId, clientId) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            console.warn(`StreamingManager (ID: ${this.managerId}): Stream '${streamId}' not found during deregisterClient for client '${clientId}'. Client is effectively deregistered.`);
+            return;
+        }
+        if (!stream.clients.has(clientId)) {
+            console.warn(`StreamingManager (ID: ${this.managerId}): Client '${clientId}' not found in stream '${streamId}' during deregistration attempt.`);
+            return;
+        }
+        const clientInstance = stream.clients.get(clientId);
+        stream.clients.delete(clientId);
+        stream.lastActivityAt = Date.now();
+        console.log(`StreamingManager (ID: ${this.managerId}): Client '${clientId}' deregistered from stream '${streamId}'. Remaining clients: ${stream.clients.size}.`);
+        if (clientInstance?.close && typeof clientInstance.close === 'function') {
+            try {
+                await clientInstance.close('Deregistered by StreamingManager.');
+            }
+            catch (closeError) {
+                console.error(`StreamingManager (ID: ${this.managerId}): Error closing client '${clientId}' during deregistration: ${closeError.message}`, closeError);
+            }
+        }
+    }
+    /** @inheritdoc */
+    async pushChunk(streamId, chunk) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            console.warn(`StreamingManager (ID: ${this.managerId}): Attempted to push chunk to closed/non-existent stream '${streamId}'. Chunk type=${chunk.type}.`);
+            return;
+        }
+        stream.lastActivityAt = Date.now();
+        // Update stream metadata if chunk contains relevant info (e.g., GMI instance ID)
+        if (chunk.gmiInstanceId && stream.metadata && !stream.metadata.gmiInstanceId) {
+            stream.metadata.gmiInstanceId = chunk.gmiInstanceId;
+        }
+        if (chunk.personaId && stream.metadata && !stream.metadata.personaId) {
+            stream.metadata.personaId = chunk.personaId;
+        }
+        const deliveryPromises = [];
+        const failedClientIds = [];
+        for (const [clientId, client] of stream.clients.entries()) {
+            if (client.isActive()) {
+                const sendPromise = client.sendChunk(chunk)
+                    .catch(async (error) => {
+                    console.error(`StreamingManager (ID: ${this.managerId}): Failed to send chunk to client '${clientId}' on stream '${streamId}'. Behavior: '${this.config.onClientSendErrorBehavior}'. Error: ${error.message}`, error);
+                    failedClientIds.push(clientId);
+                    if (this.config.onClientSendErrorBehavior === 'throw') {
+                        throw new StreamError(`Failed to send chunk to client '${clientId}'. Original error: ${error.message}`, GMIErrorCode.STREAM_ERROR, streamId, clientId, error);
+                    }
+                });
+                deliveryPromises.push(sendPromise);
+            }
+            else {
+                console.warn(`StreamingManager (ID: ${this.managerId}): Client '${clientId}' on stream '${streamId}' is inactive. Marking for potential deregistration.`);
+                failedClientIds.push(clientId);
+            }
+        }
+        await Promise.allSettled(deliveryPromises);
+        if ((this.config.onClientSendErrorBehavior === 'deregister_client' || this.config.onClientSendErrorBehavior === 'log_and_continue') && failedClientIds.length > 0) {
+            for (const clientId of failedClientIds) {
+                if (stream.clients.has(clientId)) {
+                    console.log(`StreamingManager (ID: ${this.managerId}): Deregistering client '${clientId}' from stream '${streamId}' due to send error/inactivity.`);
+                    await this.deregisterClient(streamId, clientId).catch(deregError => {
+                        console.error(`StreamingManager (ID: ${this.managerId}): Error auto-deregistering client '${clientId}': ${deregError.message}`, deregError);
+                    });
+                }
+            }
+        }
+    }
+    /** @inheritdoc */
+    async closeStream(streamId, reason) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            console.warn(`StreamingManager (ID: ${this.managerId}): Attempted to close non-existent stream '${streamId}'.`);
+            return;
+        }
+        console.log(`StreamingManager (ID: ${this.managerId}): Closing stream '${streamId}'. Reason: ${reason || 'N/A'}. Notifying ${stream.clients.size} clients.`);
+        const clientNotificationPromises = [];
+        for (const client of stream.clients.values()) {
+            clientNotificationPromises.push(client.notifyStreamClosed(reason)
+                .catch(error => console.error(`StreamingManager (ID: ${this.managerId}): Error notifying client '${client.id}' about stream '${streamId}' closure: ${error.message}`, error)));
+            if (client.close && typeof client.close === 'function') {
+                clientNotificationPromises.push(client.close(`Stream '${streamId}' closed: ${reason || 'No reason provided.'}`)
+                    .catch(closeError => console.error(`StreamingManager (ID: ${this.managerId}): Error closing client connection '${client.id}' for stream '${streamId}': ${closeError.message}`, closeError)));
+            }
+        }
+        await Promise.allSettled(clientNotificationPromises);
+        this.activeStreams.delete(streamId);
+        console.log(`StreamingManager (ID: ${this.managerId}): Stream '${streamId}' and its client references removed.`);
+    }
+    /** @inheritdoc */
+    async handleStreamError(streamId, error, terminateStream = true) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            console.error(`StreamingManager (ID: ${this.managerId}): Received error for non-existent stream '${streamId}'. Error: ${error.message}`, error);
+            return;
+        }
+        console.error(`StreamingManager (ID: ${this.managerId}): Handling error on stream '${streamId}'. Error: ${error.message}. Terminate: ${terminateStream}`, error);
+        const errorChunk = {
+            type: AgentOSResponseChunkType.ERROR,
+            streamId: streamId,
+            gmiInstanceId: stream.metadata?.gmiInstanceId || 'unknown_gmi',
+            personaId: stream.metadata?.personaId || 'unknown_persona',
+            isFinal: true,
+            timestamp: new Date().toISOString(),
+            // Accessing error.code is fine if error is GMIError, but not if it's a base Error.
+            // The type guard correctly handles this.
+            code: (error instanceof GMIError) ? error.code : GMIErrorCode.STREAM_ERROR,
+            message: error.message,
+            // Accessing error.details is fine if error is GMIError.
+            // The type guard handles this. The fallback for details for a generic Error is also fine.
+            details: (error instanceof GMIError) ? error.details : { name: error.name, stack: error.stack },
+        };
+        try {
+            await this.pushChunk(streamId, errorChunk);
+        }
+        catch (pushError) {
+            console.error(`StreamingManager (ID: ${this.managerId}): Failed to push error chunk to clients of stream '${streamId}'. Push error: ${pushError.message}`, pushError);
+        }
+        if (terminateStream) {
+            await this.closeStream(streamId, `Stream terminated due to error: ${error.message}`);
+        }
+    }
+    /** @inheritdoc */
+    async getActiveStreamIds() {
+        this.ensureInitialized();
+        return Array.from(this.activeStreams.keys());
+    }
+    /** @inheritdoc */
+    async getClientCountForStream(streamId) {
+        this.ensureInitialized();
+        const stream = this.activeStreams.get(streamId);
+        if (!stream) {
+            throw new StreamError(`Stream with ID '${streamId}' not found.`, GMIErrorCode.RESOURCE_NOT_FOUND, streamId);
+        }
+        return stream.clients.size;
+    }
+    /** @inheritdoc */
+    async shutdown(isReinitializing = false) {
+        if (!this.isInitialized && !isReinitializing) {
+            console.warn(`StreamingManager (ID: ${this.managerId}) shutdown called but was not initialized or already shut down.`);
+            return;
+        }
+        console.log(`StreamingManager (ID: ${this.managerId}): Shutting down... Closing ${this.activeStreams.size} active streams.`);
+        const streamIdsToClose = Array.from(this.activeStreams.keys());
+        for (const streamId of streamIdsToClose) {
+            try {
+                await this.closeStream(streamId, 'StreamingManager is shutting down.');
+            }
+            catch (error) {
+                console.error(`StreamingManager (ID: ${this.managerId}): Error closing stream '${streamId}' during shutdown: ${error.message}`, error);
+            }
+        }
+        this.activeStreams.clear();
+        if (!isReinitializing) {
+            this.isInitialized = false;
+        }
+        console.log(`StreamingManager (ID: ${this.managerId}): Shutdown complete. All streams closed and cache cleared.`);
+    }
+}
+//# sourceMappingURL=StreamingManager.js.map

package/dist/core/streaming/StreamingManager.js.map

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