@vibesdotdev/mcp 0.0.0-stage → 1.0.0-rc.0

package/dist/surface-mcp/serve-lifecycle.js

@@ -0,0 +1,343 @@
+/**
+ * MCP serve lifecycle (consumer): PM/worker ensure + progressive atlas auto-index.
+ *
+ * Each step here is optional for the transport: a failure never stops the MCP
+ * server, and it is logged at warn level through the `mcp` logger, never
+ * swallowed. Only `workspace-unbound` means "no workspace".
+ */
+import { CapabilityError, CaughtFailureSchema, settle, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { resolveProjectRefContext } from '@vibesdotdev/workspace/project-ref';
+import { optionalCodeAtlas } from '@vibesdotdev/workspace/code-atlas';
+import { tryResolveWorkspaceEnvironment, workspaceEnvironmentKind } from '@vibesdotdev/workspace/environment';
+import { loadSurfaceSessions, tryGetSessionManager } from "./session-bridge.js";
+import { requireMcpClient } from "../client.js";
+import { bindRuntimeSessionScope } from '@vibesdotdev/session/events/session.bound';
+/** An optional serve step failed: the transport keeps serving, and the failure is logged on the handed runtime. */
+function warnOptionalStep(runtime, step, failure) {
+    const delivered = settleNow(() => getLogger('mcp', runtime).warn(`MCP serve: ${step} failed; the transport continues without it`, {
+        error: failure
+    }));
+    if (!delivered.ok)
+        runtime.diagnostics.error('MCP serve diagnostic failed', { scope: 'mcp:serve', plugin: 'mcp', error: delivered.cause });
+}
+function warnBackground(runtime, logger, message, details) {
+    const delivered = settleNow(() => logger.warn(message, details));
+    if (!delivered.ok)
+        runtime.diagnostics.error('MCP serve background diagnostic failed', { scope: 'mcp:serve', plugin: 'mcp', error: delivered.cause });
+}
+/**
+ * The host's bound workspace, or undefined when the failure's reason is
+ * `workspace-unbound`. Any other failure is rethrown.
+ */
+async function boundWorkspacePath(runtime) {
+    const read = await settle(() => runtime.context('runtime/workspace-path'));
+    if (read.ok)
+        return read.value;
+    if (valueFreeFailure(read.cause).reason === 'workspace-unbound')
+        return undefined;
+    throw read.cause;
+}
+/** The bound on one root's background service start (PM daemon + worker runtime). */
+const BACKGROUND_SERVICES_TIMEOUT_MS = 120_000;
+/** The bound on the auto-index trigger (imports, project binding, the trigger call). */
+const AUTO_INDEX_TRIGGER_TIMEOUT_MS = 300_000;
+/** One background-service start per root: every serve path and generation shares it. */
+/**
+ * Start the consumer host's background services (PM daemon, worker runtime)
+ * once per root. Optional steps report their failure on the handed runtime
+ * and never reject; a finite or non-consumer host starts nothing.
+ */
+export function ensureConsumerBackgroundServices(runtime) {
+    if (runtime.scope.hardware !== 'consumer' || runtime.scope.lifecycle === 'finite')
+        return Promise.resolve();
+    const client = requireMcpClient(runtime);
+    return client.backgroundServiceStart ??= startBackgroundServices(runtime);
+}
+async function startBackgroundServices(runtime) {
+    const pm = await settle(() => runtime.context('pm/client'));
+    if (!pm.ok) {
+        warnOptionalStep(runtime, 'resolving the PM client', valueFreeFailure(pm.cause));
+        return;
+    }
+    const [daemon, workers] = await Promise.allSettled([
+        pm.value.ensureDaemonRunning?.(),
+        pm.value.ensureWorkerRuntime?.()
+    ]);
+    if (daemon.status === 'rejected') {
+        warnOptionalStep(runtime, 'starting the PM daemon', valueFreeFailure(CaughtFailureSchema.parse(daemon.reason)));
+    }
+    if (workers.status === 'rejected') {
+        warnOptionalStep(runtime, 'starting the worker runtime', valueFreeFailure(CaughtFailureSchema.parse(workers.reason)));
+    }
+}
+/**
+ * Run `work` as background work the runtime owns: bounded by `timeoutMs`,
+ * aborted when disposal begins, and joined by `dispose()` (RC07). A failure
+ * is reported once on `logger`; disposal's own abort is not a failure.
+ */
+async function runOwnedBackgroundWork(runtime, logger, reason, timeoutMs, work) {
+    const read = await settle(() => runtime.lifecycle.wait(work, { timeoutMs, reason }));
+    if (read.ok)
+        return;
+    const failure = valueFreeFailure(read.cause);
+    if (runtime.lifecycle.phase !== 'live' && failure.code === 'CANCELLED')
+        return;
+    warnBackground(runtime, logger, `MCP serve background work failed: ${reason}`, { error: failure });
+}
+/**
+ * Start the consumer host's background services as runtime-owned work.
+ * Answers the owned promise (it never rejects) so a caller may join it.
+ */
+export function startConsumerBackgroundServices(runtime, logger) {
+    if (runtime.scope.hardware !== 'consumer' || runtime.scope.lifecycle === 'finite')
+        return Promise.resolve();
+    return runOwnedBackgroundWork(runtime, logger, 'mcp-serve-background-services', BACKGROUND_SERVICES_TIMEOUT_MS, () => ensureConsumerBackgroundServices(runtime));
+}
+/**
+ * Trigger Atlas auto-indexing as runtime-owned background work (joined at
+ * disposal). Answers the owned promise, which never rejects.
+ */
+export function triggerProgressiveIndexingInBackground(runtime, logger) {
+    if (runtime.scope.hardware !== 'consumer' || runtime.scope.lifecycle === 'finite')
+        return Promise.resolve();
+    return runOwnedBackgroundWork(runtime, logger, 'mcp-serve-auto-index', AUTO_INDEX_TRIGGER_TIMEOUT_MS, async () => {
+        await ensureConsumerBackgroundServices(runtime);
+        const atlas = await optionalCodeAtlas(runtime);
+        if (!atlas)
+            return;
+        const workspacePath = await boundWorkspacePath(runtime);
+        if (!workspacePath)
+            return;
+        const project = await settle(async () => {
+            const projectRefContext = await resolveProjectRefContext(runtime);
+            return projectRefContext.resolve({ cwd: workspacePath });
+        });
+        if (!project.ok) {
+            warnBackground(runtime, logger, 'Atlas auto-index skipped: ProjectRef unavailable', { workspacePath, error: valueFreeFailure(project.cause) });
+            return;
+        }
+        if (!project.value) {
+            warnBackground(runtime, logger, 'Atlas auto-index skipped: checkout has no ProjectRef binding', { workspacePath });
+            return;
+        }
+        const result = await atlas.maintain({ workspaceRoot: workspacePath, projectId: project.value.projectId });
+        if (result.status === 'error') {
+            warnBackground(runtime, logger, 'Atlas startup maintenance failed', { phase: result.phase, error: result.failure });
+        }
+    });
+}
+/**
+ * Re-bind workspace environment using the active session id when session tools
+ * have initialized a participant (replaces the generic `mcp-session` placeholder).
+ */
+export async function rebindWorkspaceEnvironmentForActiveSession(runtime, projectRoot) {
+    if (runtime.scope.hardware !== 'consumer')
+        return;
+    const rebound = await settle(async () => {
+        const manager = await tryGetSessionManager(runtime);
+        const session = await manager?.getActiveSession();
+        const sessionId = session?.id;
+        if (!sessionId)
+            return;
+        await rebindWorkspaceEnvironmentForSession(runtime, sessionId, projectRoot);
+    });
+    if (!rebound.ok)
+        warnOptionalStep(runtime, 'rebinding the workspace to the active session', valueFreeFailure(rebound.cause));
+}
+/**
+ * Re-bind the MCP workspace to one exact session identity.
+ *
+ * Callers that just minted or adopted a session must pass that id through;
+ * re-querying a process-global "active" session here lets a concurrent bind
+ * steal the body between create and workspace binding.
+ */
+export async function rebindWorkspaceEnvironmentForSession(runtime, sessionId, projectRoot) {
+    if (runtime.scope.hardware !== 'consumer' || !sessionId)
+        return;
+    const bound = await settle(async () => {
+        const workspace = await import('@vibesdotdev/workspace/environment/node');
+        // The session a workspace is bound for lives in the workspace package's
+        // runtime-local environment, never the declared scope (group D).
+        const previousWorkspaceSessionId = runtime.hasKind(workspaceEnvironmentKind.id)
+            ? (await tryResolveWorkspaceEnvironment(runtime))?.sessionId
+            : undefined;
+        if (previousWorkspaceSessionId && previousWorkspaceSessionId !== sessionId) {
+            // Fail closed during a session handoff: an unsuccessful new bind must
+            // not leave workspace tools attached to the previous session's state.
+            workspace.clearWorkspaceEnvironmentBinding(runtime);
+            // The session is identity: it goes to the session registry, which
+            // feeds each invocation's actor, never the declared scope (Q4).
+            bindRuntimeSessionScope(runtime, sessionId);
+        }
+        // The host's bound workspace (the kernel's one binding); a caller's
+        // explicit root answers only for a host bound to none.
+        const root = (await boundWorkspacePath(runtime)) ?? projectRoot;
+        if (!root) {
+            throw new CapabilityError('This MCP host is bound to no workspace.', 'NOT_FOUND', {
+                reason: 'workspace-unbound',
+                recoveryHint: 'Start the MCP server inside a workspace, or pass --workspace-root <dir>.'
+            });
+        }
+        const projectRefContext = await resolveProjectRefContext(runtime);
+        const projectRef = projectRefContext.resolve({ cwd: root });
+        const { default: workspaceStatePlugin } = await import('@vibesdotdev/workspace/state.plugin');
+        if (!runtime.hasPlugin(workspaceStatePlugin.id))
+            await runtime.registerPlugin(workspaceStatePlugin);
+        await workspace.bindWorkspaceEnvironment(runtime, {
+            sessionId,
+            target: 'local',
+            root,
+            projectId: projectRef?.projectId
+        });
+        bindRuntimeSessionScope(runtime, sessionId);
+    });
+    if (!bound.ok) {
+        // Workspace binding is optional for transport startup. session.bound still
+        // commits the canonical session binding before subscriber fanout.
+        warnOptionalStep(runtime, `binding the workspace for session ${sessionId}`, valueFreeFailure(bound.cause));
+    }
+}
+/**
+ * The session THIS process minted for its stdio connection (L-03).
+ *
+ * One stdio process = one external agent = ONE session: the guard makes
+ * re-entry (transport restarts, duplicated init paths) rebind instead of
+ * re-mint, and remembers the id so shutdown can archive it — before this
+ * lifecycle existed every spawn leaked a permanently-`active` session into
+ * the workspace store (740+ accumulated).
+ */
+/** Return the exact session receipt owned by this runtime's stdio process, if any. */
+export function getBoundStdioSessionId(runtime) {
+    return requireMcpClient(runtime).stdioBoundSessionId;
+}
+/**
+ * Bind a FRESH session for a stdio MCP connection.
+ *
+ * stdio = one external agent (Claude Code / opencode / codex) per server
+ * process. We must NOT adopt the workspace's persisted default/active session
+ * — that would cross-contaminate parallel instances sharing the same workspace
+ * (see `session/src/mcp/utils/participant.ts:676-677`). `createSession()` marks
+ * the new session default-active + owner-active, so the subsequent
+ * `rebindWorkspaceEnvironmentForActiveSession` picks it up.
+ *
+ * Per-process mint guard (L-03): repeated calls return the already-bound
+ * session instead of minting again.
+ *
+ * Returns the bound session id (for logging and shutdown archival), or
+ * `undefined` if the session bridge is unavailable.
+ */
+export async function bindFreshStdioSession(runtime) {
+    if (runtime.scope.hardware !== 'consumer')
+        return undefined;
+    const existing = requireMcpClient(runtime).stdioBoundSessionId;
+    if (existing)
+        return existing;
+    const sessions = await loadSurfaceSessions(runtime);
+    if (!sessions) {
+        getLogger('mcp', runtime).warn('MCP serve: minting the stdio session failed; this host composes no session/manager');
+        return undefined;
+    }
+    const minted = await settle(async () => {
+        const workspacePath = await boundWorkspacePath(runtime);
+        return sessions.createSession({ workspacePath });
+    });
+    if (!minted.ok) {
+        warnOptionalStep(runtime, 'minting the stdio session', valueFreeFailure(minted.cause));
+        return undefined;
+    }
+    requireMcpClient(runtime).stdioBoundSessionId = minted.value;
+    return minted.value;
+}
+/**
+ * Close-half of {@link bindFreshStdioSession} (L-03): archive the session this
+ * process minted, so a clean stdio teardown leaves no permanently-`active`
+ * session behind. Crash leaks are covered by Session's `reapStaleSurfaceSessions`
+ * (kicked off at startup). Best-effort — never blocks teardown.
+ */
+export async function archiveBoundStdioSession(runtime) {
+    const sessionId = requireMcpClient(runtime).stdioBoundSessionId;
+    if (!sessionId)
+        return;
+    requireMcpClient(runtime).stdioBoundSessionId = undefined;
+    const archived = await settle(async () => {
+        const manager = await tryGetSessionManager(runtime);
+        await manager?.archiveSession(sessionId);
+    });
+    if (!archived.ok) {
+        // The startup reaper covers what this misses.
+        warnOptionalStep(runtime, `archiving stdio session ${sessionId}`, valueFreeFailure(archived.cause));
+    }
+}
+/**
+ * Fire the runtime-native `session.bound` event for an exact supplied session,
+ * or the active session for compatibility callers that do not have a receipt.
+ *
+ * Call AFTER the surface's create-or-adopt + workspace rebind. A single emit
+ * fans out runtime-natively to the scope-publish subscription (sets
+ * `scope.qualifiers.sessionId` → `brain.pulse` stops returning `"ephemeral"`)
+ * and the awareness `turn.start` subscription — no per-harness code.
+ */
+export async function announceSessionBound(runtime, options) {
+    const announced = await settle(async () => {
+        const manager = await tryGetSessionManager(runtime);
+        const session = options.sessionId
+            ? await manager?.getSession(options.sessionId)
+            : await manager?.getActiveSession();
+        const sessionId = options.sessionId ?? session?.id;
+        if (!sessionId)
+            return;
+        const { emitSessionBound } = await import('@vibesdotdev/session/events/session.bound');
+        const participantId = options.participantId ??
+            session?.ownerParticipant ??
+            (await loadSurfaceSessions(runtime))?.participantId;
+        if (!participantId) {
+            getLogger('mcp', runtime).warn(`MCP serve: announcing session.bound failed; no participant owns session ${sessionId} and this host composes no session/manager`);
+            return;
+        }
+        await emitSessionBound({
+            runtime,
+            sessionId,
+            participantId,
+            surface: options.surface
+        });
+    });
+    if (!announced.ok)
+        warnOptionalStep(runtime, 'announcing session.bound', valueFreeFailure(announced.cause));
+}
+/**
+ * Fire the runtime-native `session.unbound` event as the surface tears down.
+ *
+ * The close-half of {@link announceSessionBound}: a single emit fans out to the
+ * awareness `turn.end` subscription (and any future close subscribers) — no
+ * per-harness code. Best-effort; never blocks shutdown.
+ */
+export async function announceSessionUnbound(runtime, options) {
+    const announced = await settle(async () => {
+        const manager = await tryGetSessionManager(runtime);
+        const session = options.sessionId
+            ? await manager?.getSession(options.sessionId)
+            : await manager?.getActiveSession();
+        const sessionId = options.sessionId ?? session?.id;
+        if (!sessionId)
+            return;
+        const { emitSessionUnbound } = await import('@vibesdotdev/session/events/session.unbound');
+        const participantId = options.participantId ??
+            session?.ownerParticipant ??
+            (await loadSurfaceSessions(runtime))?.participantId;
+        if (!participantId) {
+            getLogger('mcp', runtime).warn(`MCP serve: announcing session.unbound failed; no participant owns session ${sessionId} and this host composes no session/manager`);
+            return;
+        }
+        await emitSessionUnbound({
+            runtime,
+            sessionId,
+            participantId,
+            surface: options.surface,
+            reason: options.reason
+        });
+    });
+    if (!announced.ok)
+        warnOptionalStep(runtime, 'announcing session.unbound', valueFreeFailure(announced.cause));
+}
+//# sourceMappingURL=serve-lifecycle.js.map

package/dist/surface-mcp/serve-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-lifecycle.js","sourceRoot":"","sources":["../../src/surface-mcp/serve-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAA4C,MAAM,qBAAqB,CAAC;AAC1J,OAAO,EAAE,SAAS,EAA6B,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAE9G,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,mHAAmH;AACnH,SAAS,gBAAgB,CAAC,OAAqB,EAAE,IAAY,EAAE,OAAyB;IACvF,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,6CAA6C,EAAE;QACjI,KAAK,EAAE,OAAO;KACd,CAAC,CAAC,CAAC;IACJ,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;AAC5I,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB,EAAE,MAA0C,EAAE,OAAe,EAAE,OAAqD;IAChK,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;AACvJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC,CAAC;IACnF,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC/B,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAClF,MAAM,IAAI,CAAC,KAAK,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAC/C,wFAAwF;AACxF,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAE9C,wFAAwF;AAExF;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAqB;IACrE,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5G,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,sBAAsB,KAAK,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC3E,CAAC;AAOD,KAAK,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAqB,WAAW,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACZ,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACjF,OAAO;IACR,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QAClD,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE;QAChC,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE;KAChC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAClC,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,gBAAgB,CAAC,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvH,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,sBAAsB,CACpC,OAAqB,EACrB,MAA0C,EAC1C,MAAc,EACd,SAAiB,EACjB,IAA4C;IAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrF,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO;IACpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO;IAC/E,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,qCAAqC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAqB,EAAE,MAA0C;IAChH,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5G,OAAO,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,GAAG,EAAE,CACpH,gCAAgC,CAAC,OAAO,CAAC,CACzC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sCAAsC,CACrD,OAAqB,EACrB,MAA4B;IAE5B,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAE5G,OAAO,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAChH,MAAM,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,aAAa;YAAE,OAAO;QAC3B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAClE,OAAO,iBAAiB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YACjB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,kDAAkD,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/I,OAAO;QACR,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACpB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,8DAA8D,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;YACnH,OAAO;QACR,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1G,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC/B,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrH,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0CAA0C,CAC/D,OAAqB,EACrB,WAAoB;IAEpB,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO;IAElD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,oCAAoC,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,OAAO,EAAE,+CAA+C,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9H,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACzD,OAAqB,EACrB,SAAiB,EACjB,WAAoB;IAEpB,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,SAAS;QAAE,OAAO;IAEhE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC;QAC1E,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC9E,CAAC,CAAC,CAAC,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS;YAC5D,CAAC,CAAC,SAAS,CAAC;QACb,IAAI,0BAA0B,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;YAC5E,sEAAsE;YACtE,sEAAsE;YACtE,SAAS,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC;YACpD,kEAAkE;YAClE,gEAAgE;YAChE,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,oEAAoE;QACpE,uDAAuD;QACvD,MAAM,IAAI,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC;QAChE,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CAAC,yCAAyC,EAAE,WAAW,EAAE;gBACjF,MAAM,EAAE,mBAAmB;gBAC3B,YAAY,EAAE,0EAA0E;aACxF,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5D,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;QAC9F,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAAE,MAAM,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACpG,MAAM,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE;YACjD,SAAS;YACT,MAAM,EAAE,OAAO;YACf,IAAI;YACJ,SAAS,EAAE,UAAU,EAAE,SAAS;SAChC,CAAC,CAAC;QAEH,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACf,2EAA2E;QAC3E,kEAAkE;QAClE,gBAAgB,CAAC,OAAO,EAAE,qCAAqC,SAAS,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5G,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AAEH,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,OAAqB;IAC3D,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAqB;IAChE,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC;IAC/D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAC7B,oFAAoF,CACpF,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACtC,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QAChB,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,gBAAgB,CAAC,OAAO,CAAC,CAAC,mBAAmB,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAqB;IACnE,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACxC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,8CAA8C;QAC9C,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,SAAS,EAAE,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACrG,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAAqB,EACrB,OAAwE;IAExE,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACzC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS;YAChC,CAAC,CAAC,MAAM,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;YAC9C,CAAC,CAAC,MAAM,OAAO,EAAE,gBAAgB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;QACvF,MAAM,aAAa,GAClB,OAAO,CAAC,aAAa;YACrB,OAAO,EAAE,gBAAgB;YACzB,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;YACpB,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAC7B,2EAA2E,SAAS,4CAA4C,CAChI,CAAC;YACF,OAAO;QACR,CAAC;QACD,MAAM,gBAAgB,CAAC;YACtB,OAAO;YACP,SAAS;YACT,aAAa;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,gBAAgB,CAAC,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,OAAqB,EACrB,OAAyF;IAEzF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACzC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS;YAChC,CAAC,CAAC,MAAM,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;YAC9C,CAAC,CAAC,MAAM,OAAO,EAAE,gBAAgB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,6CAA6C,CAAC,CAAC;QAC3F,MAAM,aAAa,GAClB,OAAO,CAAC,aAAa;YACrB,OAAO,EAAE,gBAAgB;YACzB,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;YACpB,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAC7B,6EAA6E,SAAS,4CAA4C,CAClI,CAAC;YACF,OAAO;QACR,CAAC;QACD,MAAM,kBAAkB,CAAC;YACxB,OAAO;YACP,SAAS;YACT,aAAa;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACtB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,gBAAgB,CAAC,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/G,CAAC"}

package/dist/surface-mcp/session-bridge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Session bridge for the MCP surface.
+ *
+ * The SessionManager is a framework context (`session/manager`). The surface's
+ * own session lifecycle (the managed participant, one minted session per stdio
+ * process, the stale sweep) is Session's `surface-sessions`. Both lookups are
+ * declared-optional: an absent manager is logged with its value-free failure
+ * and reported as `null`.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { SessionManager } from '@vibesdotdev/session/manager';
+import { type SurfaceSessions } from '@vibesdotdev/session/mcp/utils/surface-sessions';
+export type { SurfaceSessions } from '@vibesdotdev/session/mcp/utils/surface-sessions';
+/** The runtime's SessionManager, or `null` (logged) when the host does not compose one. */
+export declare function tryGetSessionManager(runtime: VibesRuntime): Promise<SessionManager | null>;
+/** The surface-session lifecycle on the runtime's SessionManager, or `null` when the host composes none. */
+export declare function loadSurfaceSessions(runtime: VibesRuntime): Promise<SurfaceSessions | null>;
+//# sourceMappingURL=session-bridge.d.ts.map

package/dist/surface-mcp/session-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bridge.d.ts","sourceRoot":"","sources":["../../src/surface-mcp/session-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAExG,YAAY,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAEvF,2FAA2F;AAC3F,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAKhG;AAED,4GAA4G;AAC5G,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGhG"}

package/dist/surface-mcp/session-bridge.js

@@ -0,0 +1,26 @@
+/**
+ * Session bridge for the MCP surface.
+ *
+ * The SessionManager is a framework context (`session/manager`). The surface's
+ * own session lifecycle (the managed participant, one minted session per stdio
+ * process, the stale sweep) is Session's `surface-sessions`. Both lookups are
+ * declared-optional: an absent manager is logged with its value-free failure
+ * and reported as `null`.
+ */
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { surfaceSessions } from '@vibesdotdev/session/mcp/utils/surface-sessions';
+/** The runtime's SessionManager, or `null` (logged) when the host does not compose one. */
+export async function tryGetSessionManager(runtime) {
+    const read = await settle(() => runtime.context('session/manager'));
+    if (read.ok)
+        return read.value;
+    getLogger('mcp', runtime).debug('session bridge: session/manager unavailable', { error: valueFreeFailure(read.cause) });
+    return null;
+}
+/** The surface-session lifecycle on the runtime's SessionManager, or `null` when the host composes none. */
+export async function loadSurfaceSessions(runtime) {
+    const manager = await tryGetSessionManager(runtime);
+    return manager ? surfaceSessions(runtime, manager) : null;
+}
+//# sourceMappingURL=session-bridge.js.map

package/dist/surface-mcp/session-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bridge.js","sourceRoot":"","sources":["../../src/surface-mcp/session-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAwB,MAAM,iDAAiD,CAAC;AAIxG,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAqB;IAC/D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAiB,iBAAiB,CAAC,CAAC,CAAC;IACpF,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC/B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,6CAA6C,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxH,OAAO,IAAI,CAAC;AACb,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IAC9D,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC"}

package/dist/surface-mcp/subscriptions/session.bound.workspace.descriptor.d.ts

@@ -0,0 +1,13 @@
+/** Keep the MCP workspace environment on the exact session just announced. */
+declare const _default: {
+    kind: "runtime/subscription";
+    id: string;
+    name: string;
+    description: string;
+    event: string;
+    handler: string;
+    handlerType: string;
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=session.bound.workspace.descriptor.d.ts.map

package/dist/surface-mcp/subscriptions/session.bound.workspace.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.bound.workspace.descriptor.d.ts","sourceRoot":"","sources":["../../../src/surface-mcp/subscriptions/session.bound.workspace.descriptor.ts"],"names":[],"mappings":"AAEA,8EAA8E;;;;;;;;;;;AAC9E,wBAUG"}

package/dist/surface-mcp/subscriptions/session.bound.workspace.descriptor.js

@@ -0,0 +1,13 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+/** Keep the MCP workspace environment on the exact session just announced. */
+export default createRuntimeAsset({
+    kind: 'runtime/subscription',
+    id: 'runtime-surface-mcp.subscriptions.on-session-bound-workspace',
+    name: 'MCP Session Bound — Rebind Workspace',
+    description: 'On session.bound, rebind the MCP workspace environment using the event session id rather than ambient active-session state.',
+    event: 'session.bound',
+    handler: 'inline',
+    handlerType: 'inline',
+    enabled: true
+});
+//# sourceMappingURL=session.bound.workspace.descriptor.js.map

package/dist/surface-mcp/subscriptions/session.bound.workspace.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.bound.workspace.descriptor.js","sourceRoot":"","sources":["../../../src/surface-mcp/subscriptions/session.bound.workspace.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,8EAA8E;AAC9E,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,8DAA8D;IAClE,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EACV,6HAA6H;IAC9H,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.d.ts

@@ -0,0 +1,11 @@
+import { rebindWorkspaceEnvironmentForSession } from '../serve-lifecycle.ts';
+type RebindWorkspace = typeof rebindWorkspaceEnvironmentForSession;
+export declare class SessionBoundWorkspaceHandler {
+    private rebindWorkspace;
+    /** A handler whose rebind step is `rebind` (tests replace the far boundary). */
+    static withRebind(rebind: RebindWorkspace): SessionBoundWorkspaceHandler;
+    handle(payload: unknown): Promise<void>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof SessionBoundWorkspaceHandler>;
+export default _default;
+//# sourceMappingURL=session.bound.workspace.impl.consumer.d.ts.map

package/dist/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.bound.workspace.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAC;AAE7E,KAAK,eAAe,GAAG,OAAO,oCAAoC,CAAC;AAEnE,qBAAa,4BAA4B;IAGxC,OAAO,CAAC,eAAe,CAAyD;IAEhF,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,4BAA4B;IAMlE,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAa7C;;AAED,wBAIG"}

package/dist/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.js

@@ -0,0 +1,36 @@
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
+import { SessionBoundEventSchema } from '@vibesdotdev/session/events/session.bound';
+import { tryResolveWorkspaceEnvironment, workspaceEnvironmentKind } from '@vibesdotdev/workspace/environment';
+import { rebindWorkspaceEnvironmentForSession } from "../serve-lifecycle.js";
+export class SessionBoundWorkspaceHandler {
+    // The runtime constructs implementations with its kind context as the first
+    // argument, so the rebind seam is not a constructor parameter.
+    rebindWorkspace = rebindWorkspaceEnvironmentForSession;
+    /** A handler whose rebind step is `rebind` (tests replace the far boundary). */
+    static withRebind(rebind) {
+        const handler = new SessionBoundWorkspaceHandler();
+        handler.rebindWorkspace = rebind;
+        return handler;
+    }
+    async handle(payload) {
+        const parsed = SessionBoundEventSchema.safeParse(payload);
+        if (!parsed.success || parsed.data.bindingScope === 'request')
+            return;
+        const event = parsed.data;
+        // The session a workspace is bound for lives in the workspace package's
+        // runtime-local environment, never the declared scope (group D).
+        const runtime = event.runtime;
+        const bound = runtime.hasKind(workspaceEnvironmentKind.id)
+            ? await tryResolveWorkspaceEnvironment(runtime)
+            : undefined;
+        if (bound?.sessionId === event.sessionId)
+            return;
+        await this.rebindWorkspace(runtime, event.sessionId);
+    }
+}
+export default createRuntimeImplementation({
+    kind: 'runtime/subscription',
+    id: 'runtime-surface-mcp.subscriptions.on-session-bound-workspace',
+    implementation: SessionBoundWorkspaceHandler
+});
+//# sourceMappingURL=session.bound.workspace.impl.consumer.js.map

package/dist/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.bound.workspace.impl.consumer.js","sourceRoot":"","sources":["../../../src/surface-mcp/subscriptions/session.bound.workspace.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAE9G,OAAO,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAC;AAI7E,MAAM,OAAO,4BAA4B;IACxC,4EAA4E;IAC5E,+DAA+D;IACvD,eAAe,GAAoB,oCAAoC,CAAC;IAEhF,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAuB;QACxC,MAAM,OAAO,GAAG,IAAI,4BAA4B,EAAE,CAAC;QACnD,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC;QACjC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC5B,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO;QACtE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1B,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,CAAC;YACzD,CAAC,CAAC,MAAM,8BAA8B,CAAC,OAAO,CAAC;YAC/C,CAAC,CAAC,SAAS,CAAC;QACb,IAAI,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS;YAAE,OAAO;QACjD,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC;IAC1C,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,8DAA8D;IAClE,cAAc,EAAE,4BAA4B;CAC5C,CAAC,CAAC"}

package/dist/surface-mcp/workspace-warning.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The MCP surface's workspace-health signal as a runtime context.
+ *
+ * When the MCP host cannot resolve a workspace root confidently it anchors to a
+ * fallback, and agent-facing tools (session init, vibes-context) surface that
+ * to the operator. The signal is runtime-local data published by the surface
+ * at boot, never a write to the ambient environment: a host environment captures its env
+ * once, so a later process write would be invisible to it anyway.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare const MCP_WORKSPACE_WARNING_CONTEXT_ID: "mcp/workspace-warning";
+/** Publish this runtime's workspace warning (null clears it). */
+export declare function publishMcpWorkspaceWarning(runtime: RuntimeRef, warning: string | null): void;
+/** The warning the MCP surface published for this runtime, or null. */
+export declare function readMcpWorkspaceWarning(runtime: Pick<RuntimeRef, 'hasContext' | 'context'>): Promise<string | null>;
+//# sourceMappingURL=workspace-warning.d.ts.map

package/dist/surface-mcp/workspace-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-warning.d.ts","sourceRoot":"","sources":["../../src/surface-mcp/workspace-warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI/E,eAAO,MAAM,gCAAgC,EAAG,uBAAgC,CAAC;AAWjF,iEAAiE;AACjE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAW5F;AAED,uEAAuE;AACvE,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB"}

package/dist/surface-mcp/workspace-warning.js

@@ -0,0 +1,44 @@
+/**
+ * The MCP surface's workspace-health signal as a runtime context.
+ *
+ * When the MCP host cannot resolve a workspace root confidently it anchors to a
+ * fallback, and agent-facing tools (session init, vibes-context) surface that
+ * to the operator. The signal is runtime-local data published by the surface
+ * at boot, never a write to the ambient environment: a host environment captures its env
+ * once, so a later process write would be invisible to it anyway.
+ */
+import { createContextDescriptor } from '@vibesdotdev/kernel';
+import { requireMcpClient } from "../client.js";
+import * as z from 'zod/v4';
+export const MCP_WORKSPACE_WARNING_CONTEXT_ID = 'mcp/workspace-warning';
+const McpWorkspaceWarningSchema = z.string().nullable();
+const mcpWorkspaceWarningContextDescriptor = createContextDescriptor({
+    id: MCP_WORKSPACE_WARNING_CONTEXT_ID,
+    description: 'Why the MCP host anchored its workspace to a fallback root, or null when the root resolved confidently.',
+    valueSchema: McpWorkspaceWarningSchema
+});
+/** Publish this runtime's workspace warning (null clears it). */
+export function publishMcpWorkspaceWarning(runtime, warning) {
+    const client = requireMcpClient(runtime);
+    client.workspaceWarning = McpWorkspaceWarningSchema.parse(warning);
+    if (client.workspaceWarningContextRegistered)
+        return;
+    runtime.registerDescriptor('context', mcpWorkspaceWarningContextDescriptor);
+    runtime.registerLoader('context', MCP_WORKSPACE_WARNING_CONTEXT_ID, async () => ({
+        impl: {
+            provide: () => client.workspaceWarning
+        }
+    }));
+    client.workspaceWarningContextRegistered = true;
+}
+/** The warning the MCP surface published for this runtime, or null. */
+export async function readMcpWorkspaceWarning(runtime) {
+    if (!runtime.hasContext(MCP_WORKSPACE_WARNING_CONTEXT_ID))
+        return null;
+    const warning = McpWorkspaceWarningSchema.parse(await runtime.context(MCP_WORKSPACE_WARNING_CONTEXT_ID));
+    if (warning === null)
+        return null;
+    const trimmed = warning.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=workspace-warning.js.map

package/dist/surface-mcp/workspace-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-warning.js","sourceRoot":"","sources":["../../src/surface-mcp/workspace-warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAmB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAgC,CAAC;AAEjF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;AAExD,MAAM,oCAAoC,GAAG,uBAAuB,CAAC;IACpE,EAAE,EAAE,gCAAgC;IACpC,WAAW,EACV,yGAAyG;IAC1G,WAAW,EAAE,yBAAyB;CACtC,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,UAAU,0BAA0B,CAAC,OAAmB,EAAE,OAAsB;IACrF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,iCAAiC;QAAE,OAAO;IACrD,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;IAC5E,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,gCAAgC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChF,IAAI,EAAE;YACL,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB;SACtC;KACD,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,iCAAiC,GAAG,IAAI,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,OAAmD;IAEnD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gCAAgC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,CAAC;IACzG,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @vibesdotdev/mcp/svelte
+ *
+ * Designed Kit ToolCard for the MCP-owned `vibes-context` orientation tool.
+ * Importing the root does NOT register the widget; hosts import
+ * `@vibesdotdev/mcp/svelte/plugin` (or `/svelte/tool-widgets`) so Chat
+ * discovers the card through `tools/ui`.
+ */
+export { default as mcpSveltePlugin } from './mcp-svelte.plugin.ts';
+export { default as VibesContextToolCard } from './tool-widgets/VibesContextToolCard.svelte';
+export { summarizeVibesContextPayload, workspaceBasename, type VibesContextSummary, type VibesContextSummaryRow, type VibesContextSummaryTone } from './tool-widgets/summary.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EACN,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,MAAM,2BAA2B,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,11 @@
+/**
+ * @vibesdotdev/mcp/svelte
+ *
+ * Designed Kit ToolCard for the MCP-owned `vibes-context` orientation tool.
+ * Importing the root does NOT register the widget; hosts import
+ * `@vibesdotdev/mcp/svelte/plugin` (or `/svelte/tool-widgets`) so Chat
+ * discovers the card through `tools/ui`.
+ */
+export { default as mcpSveltePlugin } from "./mcp-svelte.plugin.js";
+export { default as VibesContextToolCard } from './tool-widgets/VibesContextToolCard.svelte';
+export { summarizeVibesContextPayload, workspaceBasename } from "./tool-widgets/summary.js";

package/dist/svelte/mcp-svelte.plugin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runtime plugin (browser/chat parity).
+ *
+ * `vibes-context` is MCP-owned. Its designed Kit ToolCard lives here so Chat
+ * hosts discover it through `tools/ui`, not a host-local card table. The MCP
+ * protocol plugin (`./plugin`) must not import this graph.
+ */
+export declare const mcpSveltePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default mcpSveltePlugin;
+//# sourceMappingURL=mcp-svelte.plugin.d.ts.map

package/dist/svelte/mcp-svelte.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-svelte.plugin.d.ts","sourceRoot":"","sources":["../../src/svelte/mcp-svelte.plugin.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,6CAW1B,CAAC;AAEH,eAAe,eAAe,CAAC"}