@stoneforge/smithy 0.1.0

package/dist/providers/opencode/server-manager.js

@@ -0,0 +1,163 @@
+/**
+ * OpenCode Server Manager (Singleton)
+ *
+ * Manages the lifecycle of a single shared OpenCode server process.
+ * Multiple sessions share one server; ref counting shuts it down
+ * when the last session releases.
+ *
+ * @module
+ */
+// ============================================================================
+// Server Manager
+// ============================================================================
+/** Default model for OpenCode provider */
+const OPENCODE_DEFAULT_MODEL = 'opencode/minimax-m2.5-free';
+/**
+ * Manages a single shared OpenCode server instance.
+ *
+ * - `acquire()` starts or reuses the server, increments ref count
+ * - `release()` decrements ref count, stops server at zero
+ * - Concurrent acquire() calls are coalesced into a single startup
+ */
+class OpenCodeServerManager {
+    client = null;
+    server = null;
+    refCount = 0;
+    startPromise = null;
+    async acquire(config) {
+        this.refCount++;
+        if (this.client) {
+            return this.client;
+        }
+        // Coalesce concurrent startup requests
+        if (this.startPromise) {
+            return this.startPromise;
+        }
+        this.startPromise = this.startServer(config);
+        try {
+            const client = await this.startPromise;
+            return client;
+        }
+        catch (error) {
+            this.refCount--;
+            this.startPromise = null;
+            throw error;
+        }
+    }
+    release() {
+        this.refCount = Math.max(0, this.refCount - 1);
+        if (this.refCount === 0) {
+            this.shutdown();
+        }
+    }
+    shutdown() {
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+        this.client = null;
+        this.startPromise = null;
+        this.refCount = 0;
+    }
+    /**
+     * List all available models from OpenCode providers.
+     * Uses provider.list() to get the full catalog (not just configured providers).
+     * Each model ID is formatted as `providerID/modelID`.
+     * @returns Flattened array of models with composite IDs
+     */
+    async listModels(config) {
+        const client = await this.acquire(config);
+        try {
+            const response = await client.provider.list();
+            if (!response.data?.all) {
+                // Fallback to config.providers() if provider.list() is not available
+                return this.listModelsFromConfig(client);
+            }
+            const models = [];
+            for (const provider of response.data.all) {
+                if (!provider.models)
+                    continue;
+                // Handle models as either a Record or an Array
+                const entries = Array.isArray(provider.models)
+                    ? provider.models.map((m) => [m.id, m])
+                    : Object.entries(provider.models);
+                for (const [modelKey, model] of entries) {
+                    // Format ID as providerID/modelID
+                    const id = `${provider.id}/${modelKey}`;
+                    models.push({
+                        id,
+                        displayName: model.name || modelKey,
+                        description: undefined,
+                        providerName: provider.name || provider.id,
+                        ...(id === OPENCODE_DEFAULT_MODEL ? { isDefault: true } : {}),
+                    });
+                }
+            }
+            return models;
+        }
+        finally {
+            this.release();
+        }
+    }
+    /**
+     * Fallback: list models from config.providers() (only configured providers).
+     */
+    async listModelsFromConfig(client) {
+        const response = await client.config.providers();
+        if (!response.data?.providers) {
+            return [];
+        }
+        const models = [];
+        for (const provider of response.data.providers) {
+            if (!provider.models)
+                continue;
+            const entries = Array.isArray(provider.models)
+                ? provider.models.map((m) => [m.id, m])
+                : Object.entries(provider.models);
+            for (const [modelKey, model] of entries) {
+                const id = `${provider.id}/${modelKey}`;
+                models.push({
+                    id,
+                    displayName: model.name || modelKey,
+                    description: undefined,
+                    providerName: provider.name || provider.id,
+                    ...(id === OPENCODE_DEFAULT_MODEL ? { isDefault: true } : {}),
+                });
+            }
+        }
+        return models;
+    }
+    async startServer(config) {
+        const createOpencode = await this.loadSDK();
+        const env = {
+            ...process.env,
+            OPENCODE_PERMISSION: JSON.stringify({ '*': 'allow' }),
+            OPENCODE_CLIENT: 'stoneforge',
+        };
+        if (config?.stoneforgeRoot) {
+            env.STONEFORGE_ROOT = config.stoneforgeRoot;
+        }
+        const result = await createOpencode({
+            port: config?.port ?? 0,
+            cwd: config?.cwd,
+            env,
+        });
+        // The SDK returns richer types; we extract what we need
+        this.client = result.client;
+        this.server = result.server;
+        this.startPromise = null;
+        return this.client;
+    }
+    async loadSDK() {
+        try {
+            const sdk = await import('@opencode-ai/sdk');
+            return sdk.createOpencode;
+        }
+        catch {
+            throw new Error('OpenCode SDK is not installed. Install it with: npm install @opencode-ai/sdk');
+        }
+    }
+}
+/** Singleton instance */
+export const serverManager = new OpenCodeServerManager();
+//# sourceMappingURL=server-manager.js.map

package/dist/providers/opencode/server-manager.js.map

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Agent Provider Registry
+ *
+ * Manages registration and lookup of agent providers.
+ * The Claude provider is always registered as the default.
+ *
+ * @module
+ */
+import type { AgentProvider } from './types.js';
+/**
+ * Registry for agent providers.
+ * Claude is registered automatically as the default provider.
+ */
+export declare class AgentProviderRegistry {
+    private readonly providers;
+    private defaultProviderName;
+    constructor();
+    /** Register a provider. Overwrites if name already exists. */
+    register(provider: AgentProvider): void;
+    /** Get a provider by name. Returns undefined if not found. */
+    get(name: string): AgentProvider | undefined;
+    /** Get the default provider. */
+    getDefault(): AgentProvider;
+    /** Set the default provider name. */
+    setDefault(name: string): void;
+    /** List all registered provider names. */
+    list(): string[];
+    /**
+     * Get a provider, throwing a user-friendly error if not found or unavailable.
+     * For non-default providers, includes installation instructions.
+     */
+    getOrThrow(name: string): Promise<AgentProvider>;
+}
+/**
+ * Gets the global provider registry (lazily created).
+ */
+export declare function getProviderRegistry(): AgentProviderRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,mBAAmB,CAAY;;IAWvC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIvC,8DAA8D;IAC9D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C,gCAAgC;IAChC,UAAU,IAAI,aAAa;IAQ3B,qCAAqC;IACrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B,0CAA0C;IAC1C,IAAI,IAAI,MAAM,EAAE;IAIhB;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkBvD;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,CAK3D"}

package/dist/providers/registry.js

@@ -0,0 +1,82 @@
+/**
+ * Agent Provider Registry
+ *
+ * Manages registration and lookup of agent providers.
+ * The Claude provider is always registered as the default.
+ *
+ * @module
+ */
+import { ClaudeAgentProvider } from './claude/index.js';
+import { OpenCodeAgentProvider } from './opencode/index.js';
+import { CodexAgentProvider } from './codex/index.js';
+/**
+ * Registry for agent providers.
+ * Claude is registered automatically as the default provider.
+ */
+export class AgentProviderRegistry {
+    providers = new Map();
+    defaultProviderName = 'claude';
+    constructor() {
+        // Always register the Claude provider as the default
+        this.register(new ClaudeAgentProvider());
+        // Register OpenCode as an alternative provider
+        this.register(new OpenCodeAgentProvider());
+        // Register Codex as an alternative provider
+        this.register(new CodexAgentProvider());
+    }
+    /** Register a provider. Overwrites if name already exists. */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /** Get a provider by name. Returns undefined if not found. */
+    get(name) {
+        return this.providers.get(name);
+    }
+    /** Get the default provider. */
+    getDefault() {
+        const provider = this.providers.get(this.defaultProviderName);
+        if (!provider) {
+            throw new Error(`Default provider '${this.defaultProviderName}' is not registered`);
+        }
+        return provider;
+    }
+    /** Set the default provider name. */
+    setDefault(name) {
+        if (!this.providers.has(name)) {
+            throw new Error(`Provider '${name}' is not registered`);
+        }
+        this.defaultProviderName = name;
+    }
+    /** List all registered provider names. */
+    list() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+     * Get a provider, throwing a user-friendly error if not found or unavailable.
+     * For non-default providers, includes installation instructions.
+     */
+    async getOrThrow(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            const available = this.list().join(', ');
+            throw new Error(`Provider '${name}' is not registered. Available providers: ${available}`);
+        }
+        const isAvailable = await provider.isAvailable();
+        if (!isAvailable) {
+            throw new Error(`Provider '${name}' is not available. ${provider.getInstallInstructions()}`);
+        }
+        return provider;
+    }
+}
+/** Singleton registry instance. */
+let defaultRegistry;
+/**
+ * Gets the global provider registry (lazily created).
+ */
+export function getProviderRegistry() {
+    if (!defaultRegistry) {
+        defaultRegistry = new AgentProviderRegistry();
+    }
+    return defaultRegistry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACf,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACtD,mBAAmB,GAAG,QAAQ,CAAC;IAEvC;QACE,qDAAqD;QACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QACzC,+CAA+C;QAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;QAC3C,4CAA4C;QAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,8DAA8D;IAC9D,QAAQ,CAAC,QAAuB;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,8DAA8D;IAC9D,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,gCAAgC;IAChC,UAAU;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,mBAAmB,qBAAqB,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,qBAAqB,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAClC,CAAC;IAED,0CAA0C;IAC1C,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,6CAA6C,SAAS,EAAE,CAC1E,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,uBAAuB,QAAQ,CAAC,sBAAsB,EAAE,EAAE,CAC5E,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,mCAAmC;AACnC,IAAI,eAAkD,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Agent Provider Types
+ *
+ * Defines the provider abstraction layer that enables drop-in replacement
+ * of the underlying agent CLI/SDK (e.g., Claude Code, OpenCode) without
+ * changing orchestration logic.
+ *
+ * @module
+ */
+/** Provider-agnostic session ID (replaces Claude-specific session IDs) */
+export type ProviderSessionId = string;
+/** Configuration for an agent provider */
+export interface AgentProviderConfig {
+    /** Path to CLI executable (e.g., 'claude', 'opencode') */
+    readonly executablePath?: string;
+    /** Working directory */
+    readonly workingDirectory?: string;
+    /** Environment variables */
+    readonly environmentVariables?: Record<string, string>;
+    /** Timeout in ms */
+    readonly timeout?: number;
+    /** Stoneforge root directory */
+    readonly stoneforgeRoot?: string;
+    /** Provider-specific options */
+    readonly providerOptions?: Record<string, unknown>;
+}
+/** Provider-agnostic message from the agent */
+export interface AgentMessage {
+    readonly type: 'system' | 'assistant' | 'user' | 'tool_use' | 'tool_result' | 'result' | 'error';
+    readonly subtype?: string;
+    readonly sessionId?: string;
+    readonly content?: string;
+    readonly tool?: {
+        readonly name?: string;
+        readonly id?: string;
+        readonly input?: unknown;
+    };
+    /** Raw provider-specific message data */
+    readonly raw: unknown;
+}
+/** Handle for a running headless agent session */
+export interface HeadlessSession {
+    /** Send a user message to the agent */
+    sendMessage(content: string): void;
+    /** Iterate over agent messages */
+    [Symbol.asyncIterator](): AsyncIterator<AgentMessage>;
+    /** Interrupt the current operation */
+    interrupt(): Promise<void>;
+    /** Close the session */
+    close(): void;
+}
+/** Options for spawning a headless session */
+export interface HeadlessSpawnOptions {
+    readonly workingDirectory: string;
+    readonly initialPrompt?: string;
+    readonly resumeSessionId?: ProviderSessionId;
+    readonly environmentVariables?: Record<string, string>;
+    readonly stoneforgeRoot?: string;
+    readonly timeout?: number;
+    /** Model identifier to use (e.g., 'claude-sonnet-4-20250514'). If not set, uses provider default. */
+    readonly model?: string;
+}
+/** Headless agent provider (SDK/API-based) */
+export interface HeadlessProvider {
+    readonly name: string;
+    /** Spawn a new headless session */
+    spawn(options: HeadlessSpawnOptions): Promise<HeadlessSession>;
+    /** Check if provider is available (e.g., SDK installed) */
+    isAvailable(): Promise<boolean>;
+}
+/** Handle for a running interactive (PTY) agent session */
+export interface InteractiveSession {
+    /** PTY process PID */
+    readonly pid?: number;
+    /** Write data to the PTY */
+    write(data: string): void;
+    /** Resize the terminal */
+    resize(cols: number, rows: number): void;
+    /** Kill the PTY */
+    kill(): void;
+    /** Event: data from the PTY */
+    onData(callback: (data: string) => void): void;
+    /** Event: PTY exit */
+    onExit(callback: (code: number, signal?: number) => void): void;
+    /** Extract provider session ID from output (if available) */
+    getSessionId(): ProviderSessionId | undefined;
+}
+/** Options for spawning an interactive session */
+export interface InteractiveSpawnOptions {
+    readonly workingDirectory: string;
+    readonly initialPrompt?: string;
+    readonly resumeSessionId?: ProviderSessionId;
+    readonly environmentVariables?: Record<string, string>;
+    readonly stoneforgeRoot?: string;
+    readonly cols?: number;
+    readonly rows?: number;
+    /** Model identifier to use (e.g., 'claude-sonnet-4-20250514'). If not set, uses provider default. */
+    readonly model?: string;
+}
+/** Interactive (PTY) agent provider */
+export interface InteractiveProvider {
+    readonly name: string;
+    /** Spawn a new interactive session */
+    spawn(options: InteractiveSpawnOptions): Promise<InteractiveSession>;
+    /** Check if provider is available (e.g., CLI installed) */
+    isAvailable(): Promise<boolean>;
+}
+/** Information about an available model */
+export interface ModelInfo {
+    /** Model identifier (e.g., 'claude-sonnet-4-20250514') */
+    readonly id: string;
+    /** Human-readable display name (e.g., 'Claude Sonnet 4') */
+    readonly displayName: string;
+    /** Optional description of the model's capabilities */
+    readonly description?: string;
+    /** Whether this is the provider's default model */
+    readonly isDefault?: boolean;
+    /** Provider name for disambiguation (e.g., 'anthropic', 'openai') */
+    readonly providerName?: string;
+}
+/** Combined provider that supports both headless and interactive modes */
+export interface AgentProvider {
+    readonly name: string;
+    readonly headless: HeadlessProvider;
+    readonly interactive: InteractiveProvider;
+    /** Check if provider is available (CLI installed, SDK importable, etc.) */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Human-readable installation instructions shown when provider is not available.
+     * e.g., "Install OpenCode SDK: npm install @opencode-ai/sdk"
+     */
+    getInstallInstructions(): string;
+    /** List available models for this provider */
+    listModels(): Promise<ModelInfo[]>;
+}
+/**
+ * Error thrown when a provider operation fails (e.g., SDK crash, auth failure).
+ * Route handlers can catch this to return 503 instead of 500.
+ */
+export declare class ProviderError extends Error {
+    readonly providerName: string;
+    constructor(message: string, providerName: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

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

package/dist/providers/types.js

@@ -0,0 +1,25 @@
+/**
+ * Agent Provider Types
+ *
+ * Defines the provider abstraction layer that enables drop-in replacement
+ * of the underlying agent CLI/SDK (e.g., Claude Code, OpenCode) without
+ * changing orchestration logic.
+ *
+ * @module
+ */
+// ============================================================================
+// Provider Errors
+// ============================================================================
+/**
+ * Error thrown when a provider operation fails (e.g., SDK crash, auth failure).
+ * Route handlers can catch this to return 503 instead of 500.
+ */
+export class ProviderError extends Error {
+    providerName;
+    constructor(message, providerName) {
+        super(message);
+        this.name = 'ProviderError';
+        this.providerName = providerName;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8KH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,YAAY,CAAS;IAE9B,YAAY,OAAe,EAAE,YAAoB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF"}

package/dist/runtime/event-utils.d.ts

@@ -0,0 +1,8 @@
+import type { EventEmitter } from 'events';
+/**
+ * Add event listeners to an emitter and dynamically raise its maxListeners
+ * limit to prevent false MaxListenersExceededWarning. Returns a cleanup
+ * function that removes the listeners and lowers the limit back down.
+ */
+export declare function trackListeners(emitter: EventEmitter, listeners: Record<string, (...args: any[]) => void>): () => void;
+//# sourceMappingURL=event-utils.d.ts.map

package/dist/runtime/event-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-utils.d.ts","sourceRoot":"","sources":["../../src/runtime/event-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,GAClD,MAAM,IAAI,CAeZ"}

package/dist/runtime/event-utils.js

@@ -0,0 +1,23 @@
+/**
+ * Add event listeners to an emitter and dynamically raise its maxListeners
+ * limit to prevent false MaxListenersExceededWarning. Returns a cleanup
+ * function that removes the listeners and lowers the limit back down.
+ */
+export function trackListeners(emitter, listeners) {
+    const count = Object.keys(listeners).length;
+    emitter.setMaxListeners(emitter.getMaxListeners() + count);
+    for (const [event, handler] of Object.entries(listeners)) {
+        emitter.on(event, handler);
+    }
+    let cleaned = false;
+    return () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        for (const [event, handler] of Object.entries(listeners)) {
+            emitter.off(event, handler);
+        }
+        emitter.setMaxListeners(Math.max(0, emitter.getMaxListeners() - count));
+    };
+}
+//# sourceMappingURL=event-utils.js.map

package/dist/runtime/event-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-utils.js","sourceRoot":"","sources":["../../src/runtime/event-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAqB,EACrB,SAAmD;IAEnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC,CAAC;IAC3D,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,EAAE;QACV,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}