@vibesdotdev/session 0.0.0-stage → 1.0.0-rc.2

package/dist/mcp/utils/session-registry.js

@@ -0,0 +1,479 @@
+/**
+ * MCP Session Registry
+ *
+ * Provides transport-scoped handle isolation for HTTP MCP connections.
+ * Durable session, participant, and binding state belongs to SessionManager.
+ *
+ * For stdio transport, one process-local transport context is sufficient.
+ *
+ * Timers (RC07): the registry starts none on construction. Every runtime that
+ * serves MCP transports attaches its lifecycle (`attachLifecycle`). One live
+ * attached runtime at a time owns the expiry sweep and the lease heartbeat as
+ * its lifecycle intervals; when that runtime is disposed (or detaches), the
+ * next live attached runtime takes them over, so a serving runtime is never
+ * left without them because an earlier one went away. A finite host refuses
+ * intervals, so it never owns them; expiry then runs on access, amortized by
+ * the sweep interval, on every host.
+ *
+ * The registry belongs to a root, not the process (`mcpSessionRegistryFor`):
+ * one registry per retained `runtime/client` session owner, so the root, its plugin views,
+ * reload generations and forks share it, and two roots in one process share
+ * nothing — one root's `shutdown()` never clears another root's handles. The
+ * stdio slot is an instance field for the same reason. Each live transport
+ * additionally binds a membership owner whose callback resolves the manager
+ * through that transport's serving runtime. Timer ownership can move without
+ * changing the manager that renews any lease.
+ */
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { assertSessionRuntime, sessionRootStateOf } from "../../client.js";
+import { getLogger } from '@vibesdotdev/logging';
+/**
+ * Registry for MCP session contexts
+ * Provides isolation between HTTP connections and one stdio transport handle.
+ */
+export class McpSessionRegistry {
+    sessions = new Map();
+    /** This registry's stdio transport slot; never shared with another registry. */
+    stdioTransportContext = {
+        clientInfo: null,
+        connectionState: null,
+        participantCache: new Map()
+    };
+    /** When this registry began holding its root's transport state (ms since epoch). */
+    createdAt = Date.now();
+    cleanupIntervalMs = 5 * 60 * 1000; // 5 minutes
+    sessionTimeoutMs = 72 * 60 * 60 * 1000; // 72 hours (match HTTP adapter)
+    heartbeatIntervalMs = 60 * 1000;
+    heartbeatHandler = null;
+    membershipBindings = new Map();
+    membershipOwners = new Set();
+    lifecycleReferences = new Map();
+    /** The owning runtime's timer disposers; empty when no runtime owns them. */
+    stopTimers = [];
+    /** The lifecycle that owns the timers now, if any. */
+    owner = null;
+    /** The runtime whose lifecycle owns the timers: its logger reports heartbeat failures. */
+    ownerRuntime = null;
+    /** Every attached serving runtime's lifecycle, in attach order: the owner's successors. */
+    attached = [];
+    lastSweepAt = Date.now();
+    constructor(options = {}) {
+        this.cleanupIntervalMs = options.cleanupIntervalMs ?? this.cleanupIntervalMs;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? this.heartbeatIntervalMs;
+        this.sessionTimeoutMs = options.sessionTimeoutMs ?? this.sessionTimeoutMs;
+    }
+    /**
+     * Attach a runtime serving MCP transports. The first live attached runtime
+     * whose host admits intervals owns the expiry sweep and the lease heartbeat
+     * as its lifecycle intervals; the others wait as successors. When the owner
+     * begins disposal or detaches, ownership passes to the next live attached
+     * runtime. Returns this runtime's disposer (also run when it begins
+     * disposal). A declared finite host remains attached but never owns
+     * intervals; every refusal from an admitted live host propagates.
+     */
+    attachLifecycle(runtime) {
+        const lifecycle = runtime.lifecycle;
+        if (lifecycle.signal.aborted) {
+            // A disposed runtime owns nothing; the kernel's own refusal says why.
+            lifecycle.interval(() => { }, this.cleanupIntervalMs)();
+        }
+        if (!this.attached.some((entry) => entry.lifecycle === lifecycle))
+            this.attached.push(runtime);
+        this.lifecycleReferences.set(lifecycle, (this.lifecycleReferences.get(lifecycle) ?? 0) + 1);
+        if (!this.owner)
+            this.promote();
+        let attached = true;
+        const detach = () => {
+            if (!attached)
+                return;
+            attached = false;
+            lifecycle.signal.removeEventListener('abort', detach);
+            const references = (this.lifecycleReferences.get(lifecycle) ?? 1) - 1;
+            if (references > 0) {
+                this.lifecycleReferences.set(lifecycle, references);
+                return;
+            }
+            this.lifecycleReferences.delete(lifecycle);
+            this.release(lifecycle);
+        };
+        lifecycle.signal.addEventListener('abort', detach, { once: true });
+        return detach;
+    }
+    /**
+     * Bind each live transport to its serving manager's renewal callback. A
+     * failed renewal retracts that transport immediately, is reported once,
+     * and remains an observable failure of this owner's joined disposal. It
+     * retracts only its own transport: other bound transports keep renewing,
+     * and a transport that connects later is still admitted.
+     */
+    attachMembershipOwner(runtime, heartbeat) {
+        const logger = getLogger('session:mcp-registry', runtime);
+        const lifecycle = runtime.lifecycle;
+        const detachLifecycle = this.attachLifecycle(runtime);
+        const bindings = new Map();
+        const pending = new Set();
+        const failures = [];
+        let live = true;
+        let disposal = null;
+        const retract = (id, binding) => {
+            if (this.membershipBindings.get(id) === binding)
+                this.membershipBindings.delete(id);
+            if (bindings.get(id) === binding)
+                bindings.delete(id);
+        };
+        const stopAdmission = () => {
+            if (!live)
+                return;
+            live = false;
+            for (const [id, binding] of bindings)
+                retract(id, binding);
+            detachLifecycle();
+            this.membershipOwners.delete(stopAdmission);
+            lifecycle.signal.removeEventListener('abort', onAbort);
+        };
+        const dispose = () => {
+            if (disposal)
+                return disposal;
+            stopAdmission();
+            disposal = Promise.allSettled(pending).then(() => {
+                if (failures.length === 1)
+                    throw failures[0];
+                if (failures.length > 1)
+                    throw new AggregateError(failures, 'MCP membership renewal failed.');
+            });
+            return disposal;
+        };
+        const reportDisposal = async () => {
+            try {
+                await dispose();
+            }
+            catch (error) {
+                logger.warn('MCP membership owner disposal failed', { error: valueFreeFailure(CaughtFailureSchema.parse(error)) });
+            }
+        };
+        const onAbort = () => { void reportDisposal(); };
+        this.membershipOwners.add(stopAdmission);
+        lifecycle.signal.addEventListener('abort', onAbort, { once: true });
+        return {
+            bind: (id) => {
+                if (!live)
+                    throw new CapabilityError('The MCP membership owner is disposed.', 'UNAVAILABLE', { reason: 'mcp-membership-owner-disposed' });
+                if (this.membershipBindings.has(id))
+                    throw new CapabilityError('The MCP transport already has a membership owner.', 'CONFLICT', { reason: 'mcp-membership-owner-bound' });
+                if (id !== null)
+                    this.getOrCreate(id);
+                let work = null;
+                const binding = {
+                    retract: () => retract(id, binding),
+                    renew: () => {
+                        if (!live || work || this.membershipBindings.get(id) !== binding)
+                            return null;
+                        const admitted = Promise.resolve().then(async () => {
+                            try {
+                                await heartbeat(id, id === null ? null : this.peek(id));
+                            }
+                            catch (error) {
+                                failures.push(error);
+                                retract(id, binding);
+                                logger.warn('MCP heartbeat renewal failed', { mcpSessionId: id, error: valueFreeFailure(CaughtFailureSchema.parse(error)) });
+                                throw error;
+                            }
+                            finally {
+                                pending.delete(admitted);
+                                work = null;
+                            }
+                        });
+                        work = admitted;
+                        pending.add(admitted);
+                        return admitted;
+                    }
+                };
+                bindings.set(id, binding);
+                this.membershipBindings.set(id, binding);
+                return () => retract(id, binding);
+            },
+            dispose
+        };
+    }
+    /** Drop `lifecycle` from the attached set; if it owned the timers, hand them on. */
+    release(lifecycle) {
+        this.attached = this.attached.filter((entry) => entry.lifecycle !== lifecycle);
+        if (this.owner !== lifecycle)
+            return;
+        this.stopOwnerTimers();
+        this.promote();
+    }
+    /** Give the timers to the first live attached runtime whose host admits intervals. */
+    promote() {
+        for (const runtime of this.attached) {
+            const candidate = runtime.lifecycle;
+            if (candidate.signal.aborted) {
+                this.attached = this.attached.filter((entry) => entry.lifecycle !== candidate);
+                continue;
+            }
+            if (runtime.declaredScope.lifecycle === 'finite')
+                continue;
+            const stopSweep = candidate.interval(() => this.cleanupExpired(), this.cleanupIntervalMs);
+            let stopHeartbeat;
+            try {
+                stopHeartbeat = candidate.interval(() => void this.renewHeartbeats(), this.heartbeatIntervalMs);
+            }
+            catch (error) {
+                try {
+                    stopSweep();
+                }
+                catch (cleanupError) {
+                    throw new AggregateError([error, cleanupError], 'MCP registry timer admission and cleanup failed.');
+                }
+                throw error;
+            }
+            this.stopTimers = [stopSweep, stopHeartbeat];
+            this.owner = candidate;
+            this.ownerRuntime = runtime;
+            return;
+        }
+    }
+    stopOwnerTimers() {
+        for (const stop of this.stopTimers)
+            stop();
+        this.stopTimers = [];
+        this.owner = null;
+        this.ownerRuntime = null;
+    }
+    /** Expiry on access: the first access after each sweep interval sweeps. */
+    expireIfDue() {
+        if (Date.now() - this.lastSweepAt >= this.cleanupIntervalMs)
+            this.cleanupExpired();
+    }
+    /**
+     * Get or create session context for an MCP session ID
+     * Returns null if no mcpSessionId provided (stdio mode - use global)
+     */
+    getOrCreate(mcpSessionId) {
+        if (!mcpSessionId) {
+            return null;
+        }
+        this.expireIfDue();
+        let ctx = this.sessions.get(mcpSessionId);
+        if (!ctx) {
+            ctx = this.createContext(mcpSessionId);
+            this.sessions.set(mcpSessionId, ctx);
+        }
+        ctx.lastActivityAt = Date.now();
+        return ctx;
+    }
+    /**
+     * Get existing session context (does not create)
+     */
+    get(mcpSessionId) {
+        if (!mcpSessionId) {
+            return null;
+        }
+        this.expireIfDue();
+        const ctx = this.sessions.get(mcpSessionId);
+        if (ctx) {
+            ctx.lastActivityAt = Date.now();
+        }
+        return ctx ?? null;
+    }
+    /**
+     * Read a context WITHOUT touching its activity clock. Seat-liveness checks
+     * ("is this participant held by another connection that spoke recently?")
+     * must not refresh the very timestamp they measure, or every probe would
+     * keep a dead connection looking alive.
+     */
+    peek(mcpSessionId) {
+        if (!mcpSessionId)
+            return null;
+        this.expireIfDue();
+        return this.sessions.get(mcpSessionId) ?? null;
+    }
+    /**
+     * Check if a session exists
+     */
+    has(mcpSessionId) {
+        return this.sessions.has(mcpSessionId);
+    }
+    /**
+     * Remove a session context (on disconnect/timeout)
+     */
+    remove(mcpSessionId) {
+        this.membershipBindings.get(mcpSessionId)?.retract();
+        return this.sessions.delete(mcpSessionId);
+    }
+    /**
+     * Install the process-local durable lease heartbeat. The registry owns only
+     * transport handles; the injected callback owns the SessionManager write.
+     */
+    setHeartbeatHandler(handler) {
+        this.heartbeatHandler = handler;
+    }
+    /**
+     * Get connection state for an MCP session
+     */
+    getConnectionState(mcpSessionId) {
+        const ctx = this.get(mcpSessionId);
+        if (ctx) {
+            return ctx.connectionState;
+        }
+        return mcpSessionId ? null : this.stdioTransportContext.connectionState;
+    }
+    /**
+     * Set connection state for an MCP session
+     */
+    setConnectionState(mcpSessionId, state) {
+        const effectiveKey = mcpSessionId || state.connectionId || undefined;
+        const ctx = effectiveKey ? this.getOrCreate(effectiveKey) : null;
+        if (ctx) {
+            ctx.connectionState = state;
+        }
+        // Only the process's own stdio transport (a call with no transport key)
+        // writes the stdio slot. A keyed connection's state never answers an
+        // unkeyed read: mirroring it made the slot "whichever connection bound
+        // last", a process-global identity every unkeyed caller then adopted.
+        if (!mcpSessionId)
+            this.stdioTransportContext.connectionState = state;
+    }
+    /**
+     * Get client info for an MCP session
+     */
+    getClientInfo(mcpSessionId) {
+        const ctx = this.get(mcpSessionId);
+        if (ctx) {
+            return ctx.clientInfo;
+        }
+        return mcpSessionId ? null : this.stdioTransportContext.clientInfo;
+    }
+    /**
+     * Set client info for an MCP session
+     */
+    setClientInfo(mcpSessionId, info) {
+        const effectiveKey = mcpSessionId || info?.connectionId || undefined;
+        const ctx = effectiveKey ? this.getOrCreate(effectiveKey) : null;
+        if (ctx) {
+            ctx.clientInfo = info;
+        }
+        // Same rule as setConnectionState: a keyed connection never writes the stdio slot.
+        if (!mcpSessionId)
+            this.stdioTransportContext.clientInfo = info;
+    }
+    /**
+     * Get participant cache for an MCP session
+     * Returns the session-scoped cache or global cache for stdio
+     */
+    getParticipantCache(mcpSessionId) {
+        const ctx = this.getOrCreate(mcpSessionId);
+        if (ctx) {
+            return ctx.participantCache;
+        }
+        return this.stdioTransportContext.participantCache;
+    }
+    /**
+     * Get all active session IDs
+     */
+    getActiveSessionIds() {
+        this.expireIfDue();
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Get session count
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        this.lastSweepAt = now;
+        const expired = [];
+        for (const [id, ctx] of this.sessions) {
+            if (now - ctx.lastActivityAt > this.sessionTimeoutMs) {
+                expired.push(id);
+            }
+        }
+        for (const id of expired) {
+            this.remove(id);
+        }
+        return expired.length;
+    }
+    /**
+     * Shutdown registry: stop the attached runtime's timers and drop every handle.
+     */
+    shutdown() {
+        for (const stop of this.membershipOwners)
+            stop();
+        this.membershipBindings.clear();
+        this.lifecycleReferences.clear();
+        this.stopOwnerTimers();
+        this.attached = [];
+        this.heartbeatHandler = null;
+        this.sessions.clear();
+        this.stdioTransportContext.clientInfo = null;
+        this.stdioTransportContext.connectionState = null;
+        this.stdioTransportContext.participantCache.clear();
+    }
+    createContext(mcpSessionId) {
+        return {
+            mcpSessionId,
+            clientInfo: null,
+            connectionState: null,
+            participantCache: new Map(),
+            createdAt: Date.now(),
+            lastActivityAt: Date.now()
+        };
+    }
+    async renewHeartbeats() {
+        const owned = [];
+        for (const binding of this.membershipBindings.values()) {
+            const work = binding.renew();
+            if (work)
+                owned.push(work);
+        }
+        await Promise.allSettled(owned);
+        const handler = this.heartbeatHandler;
+        const ownerRuntime = this.ownerRuntime;
+        if (!handler || !ownerRuntime)
+            return;
+        const logger = getLogger('session:mcp-registry', ownerRuntime);
+        const targets = [null, ...this.sessions.values()];
+        // Each call runs inside its own async boundary, so a handler that throws
+        // synchronously is one settled failure, never a rejected sweep.
+        const results = await Promise.allSettled(targets.map(async (context) => (context ? handler(context.mcpSessionId, context) : handler(null, null))));
+        results.forEach((result, index) => {
+            if (result.status !== 'rejected')
+                return;
+            logger.warn('MCP heartbeat renewal failed', {
+                mcpSessionId: targets[index]?.mcpSessionId ?? null,
+                error: valueFreeFailure(CaughtFailureSchema.parse(result.reason))
+            });
+        });
+    }
+}
+/**
+ * Synchronous transport access after the session plugin activates. The
+ * registry is root state: the lifecycle's own client answers when it has one,
+ * and a cold generation or the dispatcher reads its root's state directly. This
+ * bridge never creates a registry.
+ */
+export function mcpSessionRegistryFor(runtime) {
+    assertSessionRuntime(runtime);
+    const transports = tryGetVibesClient('session', runtime)?.transports ??
+        sessionRootStateOf(runtime)?.transports;
+    if (!transports) {
+        throw new CapabilityError('The session client is not active on this runtime.', 'UNAVAILABLE', {
+            reason: 'session-client-unavailable',
+            recoveryHint: 'Activate the session plugin before serving transports.'
+        });
+    }
+    return transports;
+}
+/**
+ * Helper to get MCP session ID from tool context
+ */
+export function getMcpSessionIdFromContext(ctx) {
+    return ctx?.connection?.sessionId;
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/mcp/utils/session-registry.js.map

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

package/dist/mcp/utils/surface-sessions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Surface sessions: the managed participant that owns the sessions an agent
+ * surface (the stdio MCP server) mints for itself, minting one per process,
+ * and reaping the ones a crashed process left `active`.
+ *
+ * Session owns this lifecycle. It moved here from Autoloop's `autoloop.sessions`
+ * client so a public host never mints its session through a premium package.
+ * The participant id is unchanged, so sessions minted before the move are still
+ * recognised by identity and reaped.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { SessionManager } from '../../manager.ts';
+/** The well-known participant that owns surface-minted sessions (stable across the Autoloop move). */
+export declare const SURFACE_SESSIONS_PARTICIPANT_ID = "7ab15969-f594-44fb-a314-adf8f43c2ea5";
+export interface CreateSurfaceSessionOptions {
+    readonly workspacePath?: string;
+    readonly parentSessionId?: string;
+    readonly titleHint?: string;
+    readonly description?: string;
+}
+export interface ReapStaleSurfaceSessionsOptions {
+    /** Sessions idle longer than this are archived. Default 48h. */
+    readonly ttlMs?: number;
+    /** Upper bound on sessions scanned per sweep. Default 1000. */
+    readonly maxScan?: number;
+    /** The caller's own live session, never archived. */
+    readonly excludeSessionId?: string;
+}
+export interface ReapStaleSurfaceSessionsResult {
+    readonly scanned: number;
+    readonly archived: number;
+}
+/** Register the managed surface participant once. */
+export declare function ensureSurfaceParticipant(manager: SessionManager): Promise<void>;
+/** Mint a fresh project session owned by the surface participant; resolves to its id. */
+export declare function createSurfaceSession(runtime: RuntimeRef, manager: SessionManager, options?: CreateSurfaceSessionOptions): Promise<string>;
+/**
+ * Archive surface-owned sessions idle past `ttlMs`. Every stdio connection
+ * mints a fresh session and a clean exit archives it; crashes leak `active`
+ * ones, which this sweep collects. The predicate is identity (owner, status,
+ * idle time), never the title. Ids are collected across pages before any
+ * archive, so archiving cannot shift the status-filtered listing under the
+ * scan. Each archive failure is logged and left for the next sweep.
+ */
+export declare function reapStaleSurfaceSessions(runtime: RuntimeRef, manager: SessionManager, options?: ReapStaleSurfaceSessionsOptions): Promise<ReapStaleSurfaceSessionsResult>;
+/** The surface-session lifecycle bound to one runtime and its SessionManager. */
+export interface SurfaceSessions {
+    readonly participantId: string;
+    ensureParticipant(): Promise<void>;
+    createSession(options: CreateSurfaceSessionOptions): Promise<string>;
+    reapStale(options: ReapStaleSurfaceSessionsOptions): Promise<ReapStaleSurfaceSessionsResult>;
+}
+export declare function surfaceSessions(runtime: RuntimeRef, manager: SessionManager): SurfaceSessions;
+//# sourceMappingURL=surface-sessions.d.ts.map

package/dist/mcp/utils/surface-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-sessions.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/surface-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,sGAAsG;AACtG,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAUtF,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,qDAAqD;AACrD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CASrF;AAeD,yFAAyF;AACzF,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,2BAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,+BAAoC,GAC3C,OAAO,CAAC,8BAA8B,CAAC,CA+BzC;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,SAAS,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC7F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,eAAe,CAO7F"}