mcp-codex-subagent 2.0.9 → 2.0.11

package/dist/wave/progress.js

@@ -0,0 +1,176 @@
+/**
+ * GroupProgressCollector — per-group event aggregation for streaming.
+ *
+ * Subscribes to TaskEventBus for each agent's taskId and sends
+ * throttled progress notifications to the MCP client.
+ *
+ * One instance per orchestrate() call (NOT a singleton).
+ */
+import { taskEventBus } from '../event/bus.js';
+import { NotificationThrottle } from '../event/throttle.js';
+import { getStreamVerbosity, } from './types.js';
+export class GroupProgressCollector {
+    groupId;
+    sendProgress;
+    verbosity;
+    aliasMap = new Map(); // taskId → alias
+    unsubscribes = [];
+    throttle;
+    // Aggregate counters
+    commandsRun = 0;
+    filesChanged = 0;
+    errorCount = 0;
+    agentsDone = 0;
+    totalAgents = 0;
+    progressCount = 0;
+    constructor(groupId, sendProgress, totalAgents) {
+        this.groupId = groupId;
+        this.sendProgress = sendProgress;
+        this.totalAgents = totalAgents;
+        this.verbosity = getStreamVerbosity();
+        this.throttle = new NotificationThrottle({
+            intervalMs: 500,
+            send: async () => {
+                await this.emitSummary();
+            },
+        });
+    }
+    /**
+     * Register an agent and subscribe to its TaskEventBus events.
+     */
+    registerAgent(taskId, alias) {
+        this.aliasMap.set(taskId, alias);
+        const unsub = taskEventBus.subscribe(taskId, (taskEvent) => {
+            this.onAgentEvent(taskId, taskEvent.event);
+        });
+        this.unsubscribes.push(unsub);
+    }
+    /**
+     * Send a group-level progress event (e.g., waiting, worktree created).
+     * Not throttled — sent immediately.
+     */
+    async emitGroupEvent(type, detail) {
+        this.progressCount++;
+        const message = detail ? `${type}: ${detail}` : type;
+        await this.sendProgress(message, this.progressCount).catch(() => { });
+    }
+    /**
+     * Send the markdown agent mapping table.
+     */
+    async emitAgentTable(group) {
+        const lines = [
+            `group.agent_table: ${group.id}`,
+            '',
+            '| Agent | Role | Status |',
+            '|-------|------|--------|',
+        ];
+        for (const agent of group.agents) {
+            lines.push(`| ${agent.alias} | ${agent.role ?? '-'} | ${agent.state} |`);
+        }
+        this.progressCount++;
+        await this.sendProgress(lines.join('\n'), this.progressCount).catch(() => { });
+    }
+    /**
+     * Notify that an agent completed (success or failure).
+     * Flushes the throttle immediately for state changes.
+     */
+    agentCompleted(alias, success) {
+        this.agentsDone++;
+        if (!success)
+            this.errorCount++;
+        // Flush immediately on state changes
+        this.throttle.flush().catch(() => { });
+    }
+    /**
+     * Clean up all subscriptions and the throttle timer.
+     */
+    async dispose() {
+        for (const unsub of this.unsubscribes) {
+            unsub();
+        }
+        this.unsubscribes.length = 0;
+        await this.throttle.flush().catch(() => { });
+        this.throttle.dispose();
+    }
+    // -----------------------------------------------------------------------
+    // Private
+    // -----------------------------------------------------------------------
+    onAgentEvent(taskId, event) {
+        const alias = this.aliasMap.get(taskId) ?? taskId;
+        switch (event.type) {
+            case 'command_execution':
+                this.commandsRun++;
+                if (this.verbosity !== 'low') {
+                    const cmd = truncate(String(event.command ?? ''), 100);
+                    this.emitDetailEvent(`agent.tool_call: ${alias}: ${cmd}`);
+                }
+                break;
+            case 'file_change': {
+                const changes = event.changes;
+                if (Array.isArray(changes)) {
+                    this.filesChanged += changes.length;
+                }
+                else {
+                    this.filesChanged++;
+                }
+                if (this.verbosity !== 'low') {
+                    const path = truncate(String(event.file ?? ''), 100);
+                    this.emitDetailEvent(`agent.file_change: ${alias}: ${path}`);
+                }
+                break;
+            }
+            case 'mcp_tool_call':
+                if (this.verbosity !== 'low') {
+                    const tool = String(event.tool ?? '');
+                    this.emitDetailEvent(`agent.tool_call: ${alias}: ${tool}`);
+                }
+                break;
+            case 'error':
+            case 'turn_failed':
+                this.errorCount++;
+                if (this.verbosity !== 'low') {
+                    const msg = truncate(String(event.message ?? ''), 100);
+                    this.emitDetailEvent(`agent.error: ${alias}: ${msg}`);
+                }
+                break;
+            case 'agent_message':
+                if (this.verbosity === 'high') {
+                    const text = truncate(String(event.text ?? ''), 100);
+                    this.emitDetailEvent(`agent.message: ${alias}: ${text}`);
+                }
+                break;
+            case 'reasoning':
+                if (this.verbosity === 'high') {
+                    const text = truncate(String(event.text ??
+                        event.content ??
+                        ''), 100);
+                    this.emitDetailEvent(`agent.reasoning: ${alias}: ${text}`);
+                }
+                break;
+            default:
+                break;
+        }
+        // Trigger throttled summary
+        this.throttle.notify();
+    }
+    emitDetailEvent(message) {
+        this.progressCount++;
+        this.sendProgress(message, this.progressCount).catch(() => { });
+    }
+    async emitSummary() {
+        const running = this.totalAgents - this.agentsDone;
+        const aliases = [...this.aliasMap.values()];
+        const runningAliases = aliases.slice(0, 5).join(', ');
+        const more = aliases.length > 5 ? ` +${aliases.length - 5} more` : '';
+        const summary = `[${this.agentsDone}/${this.totalAgents} done] ` +
+            (running > 0 ? `running: ${runningAliases}${more} | ` : '') +
+            `${this.commandsRun} cmds, ${this.filesChanged} files` +
+            (this.errorCount > 0 ? ` | ${this.errorCount} errors` : '');
+        this.progressCount++;
+        await this.sendProgress(summary, this.progressCount).catch(() => { });
+    }
+}
+function truncate(s, maxLen) {
+    return s.length > maxLen ? s.slice(0, maxLen) + '...' : s;
+}
+//# sourceMappingURL=progress.js.map

package/dist/wave/progress.js.map

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

package/dist/wave/registry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * GroupRegistry — single authoritative source for group state.
+ *
+ * Module-level singleton with JSONL persistence at
+ * ~/.mcp-codex-subagent/groups/<groupId>.jsonl
+ *
+ * Mirrors TaskStore patterns: explicit state machine, bounded,
+ * deterministic transitions.
+ */
+import { type GroupState, type AgentState, type GroupRecord, type AgentRecord, type AgentSpec } from './types.js';
+export interface CreateGroupOptions {
+    agents: AgentSpec[];
+    baseCwd: string;
+    dependsOn: string[];
+    groupName?: string;
+}
+export declare class GroupRegistry {
+    private readonly groups;
+    createGroup(opts: CreateGroupOptions): GroupRecord;
+    transitionGroup(id: string, newState: GroupState, opts?: {
+        error?: string;
+        commitSha?: string;
+        baseCommit?: string;
+    }): boolean;
+    transitionAgent(groupId: string, alias: string, newState: AgentState, opts?: {
+        error?: string;
+        taskId?: string;
+        pid?: number;
+    }): boolean;
+    /**
+     * Increment the attempt counter for an agent.
+     */
+    incrementAttempts(groupId: string, alias: string): void;
+    getGroup(id: string): GroupRecord | undefined;
+    getAllGroups(): GroupRecord[];
+    getAllNonTerminal(): GroupRecord[];
+    getAgent(groupId: string, alias: string): AgentRecord | undefined;
+    /**
+     * Check if all agents in a group have reached terminal states.
+     */
+    allAgentsTerminal(groupId: string): boolean;
+    /**
+     * Check whether all dependencies are met for a group.
+     * Returns 'met' if all dep groups are done_success,
+     * 'failed' if any dep group is done_failed or done_timeout,
+     * 'pending' if any dep group is still running.
+     */
+    areDependenciesMet(dependsOn: string[]): 'met' | 'pending' | 'failed';
+    /**
+     * Check if all agents that completed successfully.
+     */
+    allAgentsSucceeded(groupId: string): boolean;
+    /**
+     * Write the group record to disk as JSONL.
+     * Full rewrite (groups are small; simpler than append-only).
+     */
+    persist(id: string): void;
+    /**
+     * Load all group records from disk on startup.
+     */
+    loadAll(): void;
+    resetForTesting(): void;
+    private generateUniqueId;
+}
+export declare const groupRegistry: GroupRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/wave/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EAMf,MAAM,YAAY,CAAC;AAoBpB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAMzD,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW;IA0ClD,eAAe,CACb,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,OAAO;IAwBV,eAAe,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GACA,OAAO;IA2BV;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWvD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,YAAY,IAAI,WAAW,EAAE;IAI7B,iBAAiB,IAAI,WAAW,EAAE;IAIlC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAM3C;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ;IAgBrE;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAU5C;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAuDzB;;OAEG;IACH,OAAO,IAAI,IAAI;IA0Ef,eAAe,IAAI,IAAI;IASvB,OAAO,CAAC,gBAAgB;CAYzB;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/wave/registry.js

@@ -0,0 +1,340 @@
+/**
+ * GroupRegistry — single authoritative source for group state.
+ *
+ * Module-level singleton with JSONL persistence at
+ * ~/.mcp-codex-subagent/groups/<groupId>.jsonl
+ *
+ * Mirrors TaskStore patterns: explicit state machine, bounded,
+ * deterministic transitions.
+ */
+import { mkdirSync, writeFileSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { CONFIG_HOME } from '../types.js';
+import { generateTaskId, normalizeTaskId } from '../utils/task-id-generator.js';
+import { isValidGroupTransition, isGroupTerminal, isValidAgentTransition, isAgentTerminal, DEFAULT_MAX_ATTEMPTS, } from './types.js';
+const GROUPS_DIR = join(CONFIG_HOME, 'groups');
+// Ensure groups directory exists
+let groupsDirReady = false;
+function ensureGroupsDir() {
+    if (groupsDirReady)
+        return;
+    try {
+        mkdirSync(GROUPS_DIR, { recursive: true });
+        groupsDirReady = true;
+    }
+    catch {
+        // Best-effort
+    }
+}
+// ---------------------------------------------------------------------------
+// GroupRegistry Class
+// ---------------------------------------------------------------------------
+export class GroupRegistry {
+    groups = new Map();
+    // -----------------------------------------------------------------------
+    // Group creation
+    // -----------------------------------------------------------------------
+    createGroup(opts) {
+        const id = this.generateUniqueId();
+        const groupName = opts.groupName || id;
+        const branch = `sub-agent/${id}`;
+        const worktreePath = join(opts.baseCwd, '.worktree', `${id}-${groupName}`);
+        const agents = opts.agents.map((spec) => ({
+            alias: spec.alias,
+            state: 'pending',
+            prompt: spec.prompt.length > 200
+                ? spec.prompt.slice(0, 200) + '...'
+                : spec.prompt,
+            role: spec.role,
+            specialization: spec.specialization,
+            dependsOn: spec.depends_on ?? [],
+            attempts: 0,
+            maxAttempts: spec.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,
+        }));
+        const group = {
+            id,
+            state: 'waiting_deps',
+            agents,
+            branch,
+            worktreePath,
+            baseCwd: opts.baseCwd,
+            baseCommit: '', // set during worktree creation
+            dependsOn: opts.dependsOn,
+            groupName,
+            createdAt: new Date().toISOString(),
+        };
+        this.groups.set(normalizeTaskId(id), group);
+        this.persist(id);
+        return group;
+    }
+    // -----------------------------------------------------------------------
+    // Group state transitions
+    // -----------------------------------------------------------------------
+    transitionGroup(id, newState, opts) {
+        const group = this.getGroup(id);
+        if (!group)
+            return false;
+        if (!isValidGroupTransition(group.state, newState))
+            return false;
+        group.state = newState;
+        if (opts?.error)
+            group.error = opts.error;
+        if (opts?.commitSha)
+            group.commitSha = opts.commitSha;
+        if (opts?.baseCommit)
+            group.baseCommit = opts.baseCommit;
+        if (isGroupTerminal(newState)) {
+            group.completedAt = new Date().toISOString();
+        }
+        this.persist(id);
+        return true;
+    }
+    // -----------------------------------------------------------------------
+    // Agent state transitions
+    // -----------------------------------------------------------------------
+    transitionAgent(groupId, alias, newState, opts) {
+        const group = this.getGroup(groupId);
+        if (!group)
+            return false;
+        const agent = group.agents.find((a) => a.alias === alias);
+        if (!agent)
+            return false;
+        if (!isValidAgentTransition(agent.state, newState))
+            return false;
+        agent.state = newState;
+        if (opts?.error)
+            agent.error = opts.error;
+        if (opts?.taskId)
+            agent.taskId = opts.taskId;
+        if (opts?.pid)
+            agent.pid = opts.pid;
+        if (newState === 'running' && !agent.startedAt) {
+            agent.startedAt = new Date().toISOString();
+        }
+        if (isAgentTerminal(newState)) {
+            agent.completedAt = new Date().toISOString();
+        }
+        // Don't persist on every agent transition (too frequent)
+        // Caller can call persist() explicitly when needed
+        return true;
+    }
+    /**
+     * Increment the attempt counter for an agent.
+     */
+    incrementAttempts(groupId, alias) {
+        const group = this.getGroup(groupId);
+        if (!group)
+            return;
+        const agent = group.agents.find((a) => a.alias === alias);
+        if (agent)
+            agent.attempts++;
+    }
+    // -----------------------------------------------------------------------
+    // Queries
+    // -----------------------------------------------------------------------
+    getGroup(id) {
+        return this.groups.get(normalizeTaskId(id));
+    }
+    getAllGroups() {
+        return [...this.groups.values()];
+    }
+    getAllNonTerminal() {
+        return [...this.groups.values()].filter((g) => !isGroupTerminal(g.state));
+    }
+    getAgent(groupId, alias) {
+        return this.getGroup(groupId)?.agents.find((a) => a.alias === alias);
+    }
+    /**
+     * Check if all agents in a group have reached terminal states.
+     */
+    allAgentsTerminal(groupId) {
+        const group = this.getGroup(groupId);
+        if (!group)
+            return true;
+        return group.agents.every((a) => isAgentTerminal(a.state));
+    }
+    /**
+     * Check whether all dependencies are met for a group.
+     * Returns 'met' if all dep groups are done_success,
+     * 'failed' if any dep group is done_failed or done_timeout,
+     * 'pending' if any dep group is still running.
+     */
+    areDependenciesMet(dependsOn) {
+        if (dependsOn.length === 0)
+            return 'met';
+        for (const depId of dependsOn) {
+            const dep = this.getGroup(depId);
+            if (!dep)
+                return 'failed'; // dep doesn't exist
+            if (dep.state === 'done_success')
+                continue;
+            if (dep.state === 'done_failed' || dep.state === 'done_timeout') {
+                return 'failed';
+            }
+            return 'pending'; // still running
+        }
+        return 'met';
+    }
+    /**
+     * Check if all agents that completed successfully.
+     */
+    allAgentsSucceeded(groupId) {
+        const group = this.getGroup(groupId);
+        if (!group)
+            return false;
+        return group.agents.every((a) => a.state === 'done_success');
+    }
+    // -----------------------------------------------------------------------
+    // Persistence (JSONL)
+    // -----------------------------------------------------------------------
+    /**
+     * Write the group record to disk as JSONL.
+     * Full rewrite (groups are small; simpler than append-only).
+     */
+    persist(id) {
+        const group = this.getGroup(id);
+        if (!group)
+            return;
+        ensureGroupsDir();
+        const lines = [];
+        // Meta line (group-level state without agent details)
+        const meta = {
+            type: 'meta',
+            id: group.id,
+            state: group.state,
+            branch: group.branch,
+            worktreePath: group.worktreePath,
+            baseCwd: group.baseCwd,
+            baseCommit: group.baseCommit,
+            dependsOn: group.dependsOn,
+            groupName: group.groupName,
+            createdAt: group.createdAt,
+            completedAt: group.completedAt,
+            commitSha: group.commitSha,
+            error: group.error,
+        };
+        lines.push(JSON.stringify(meta));
+        // Agent lines
+        for (const agent of group.agents) {
+            const agentLine = {
+                type: 'agent',
+                alias: agent.alias,
+                state: agent.state,
+                taskId: agent.taskId,
+                prompt: agent.prompt,
+                role: agent.role,
+                specialization: agent.specialization,
+                dependsOn: agent.dependsOn,
+                attempts: agent.attempts,
+                maxAttempts: agent.maxAttempts,
+                error: agent.error,
+                startedAt: agent.startedAt,
+                completedAt: agent.completedAt,
+                pid: agent.pid,
+            };
+            lines.push(JSON.stringify(agentLine));
+        }
+        try {
+            const filePath = join(GROUPS_DIR, `${group.id}.jsonl`);
+            writeFileSync(filePath, lines.join('\n') + '\n', 'utf-8');
+        }
+        catch {
+            // Best-effort persistence
+        }
+    }
+    /**
+     * Load all group records from disk on startup.
+     */
+    loadAll() {
+        ensureGroupsDir();
+        let files;
+        try {
+            files = readdirSync(GROUPS_DIR).filter((f) => f.endsWith('.jsonl'));
+        }
+        catch {
+            return;
+        }
+        for (const file of files) {
+            try {
+                const content = readFileSync(join(GROUPS_DIR, file), 'utf-8');
+                const lines = content.split('\n').filter((l) => l.trim());
+                let group = null;
+                const agents = [];
+                for (const line of lines) {
+                    try {
+                        const parsed = JSON.parse(line);
+                        if (parsed.type === 'meta') {
+                            group = {
+                                id: parsed.id,
+                                state: parsed.state,
+                                agents: [], // filled below
+                                branch: parsed.branch,
+                                worktreePath: parsed.worktreePath,
+                                baseCwd: parsed.baseCwd,
+                                baseCommit: parsed.baseCommit ?? '',
+                                dependsOn: parsed.dependsOn ?? [],
+                                groupName: parsed.groupName,
+                                createdAt: parsed.createdAt,
+                                completedAt: parsed.completedAt,
+                                commitSha: parsed.commitSha,
+                                error: parsed.error,
+                            };
+                        }
+                        else if (parsed.type === 'agent') {
+                            agents.push({
+                                alias: parsed.alias,
+                                state: parsed.state,
+                                taskId: parsed.taskId,
+                                prompt: parsed.prompt ?? '',
+                                role: parsed.role,
+                                specialization: parsed.specialization,
+                                dependsOn: parsed.dependsOn ?? [],
+                                attempts: parsed.attempts ?? 0,
+                                maxAttempts: parsed.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,
+                                error: parsed.error,
+                                startedAt: parsed.startedAt,
+                                completedAt: parsed.completedAt,
+                                pid: parsed.pid,
+                            });
+                        }
+                    }
+                    catch {
+                        // Skip malformed lines
+                    }
+                }
+                if (group) {
+                    group.agents = agents;
+                    this.groups.set(normalizeTaskId(group.id), group);
+                }
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Testing
+    // -----------------------------------------------------------------------
+    resetForTesting() {
+        this.groups.clear();
+        groupsDirReady = false;
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    generateUniqueId() {
+        let id = generateTaskId();
+        let attempts = 0;
+        while (this.groups.has(normalizeTaskId(id)) && attempts < 20) {
+            id = generateTaskId();
+            attempts++;
+        }
+        if (this.groups.has(normalizeTaskId(id))) {
+            id = `group-${Date.now()}-${Math.floor(Math.random() * 1000)}`;
+        }
+        return id;
+    }
+}
+// Module-level singleton
+export const groupRegistry = new GroupRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/wave/registry.js.map

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

package/dist/wave/semaphore.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Async counting semaphore with FIFO fairness for global concurrency control.
+ *
+ * Module-level singleton shared across all groups.
+ * Supports AbortSignal for timeout/shutdown cancellation.
+ */
+export declare class AsyncSemaphore {
+    private permits;
+    readonly maxPermits: number;
+    private readonly queue;
+    private disposed;
+    constructor(maxPermits?: number);
+    /**
+     * Acquire a permit. Resolves immediately if available,
+     * otherwise FIFO-queues until a permit is released.
+     *
+     * Rejects if:
+     * - The semaphore has been disposed
+     * - The provided AbortSignal fires while queued
+     */
+    acquire(signal?: AbortSignal): Promise<void>;
+    /**
+     * Release a permit. Wakes the oldest queued waiter (FIFO)
+     * or increments the available permit count.
+     */
+    release(): void;
+    /**
+     * Dispose the semaphore: reject all queued waiters and prevent
+     * future acquisitions. Called on server shutdown.
+     */
+    dispose(): void;
+    /** Number of permits currently available. */
+    get available(): number;
+    /** Number of waiters currently queued. */
+    get waiting(): number;
+    /** Whether the semaphore has been disposed. */
+    get isDisposed(): boolean;
+    /** Reset for testing. */
+    resetForTesting(): void;
+}
+export declare const concurrencySemaphore: AsyncSemaphore;
+//# sourceMappingURL=semaphore.d.ts.map

package/dist/wave/semaphore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../src/wave/semaphore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,CAAC,EAAE,MAAM;IAK/B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC5C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAef;;;OAGG;IACH,OAAO,IAAI,IAAI;IAYf,6CAA6C;IAC7C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0CAA0C;IAC1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,yBAAyB;IACzB,eAAe,IAAI,IAAI;CAWxB;AAGD,eAAO,MAAM,oBAAoB,gBAAuB,CAAC"}