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

package/dist/tools/vibes-context/vibes-context.impl.js

@@ -0,0 +1,207 @@
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { DEFAULT_VIBES_HOME_DIRNAME, getPathRoots } from '@vibesdotdev/paths';
+import { resolveHomePath, resolveVibesBaseDir } from '@vibesdotdev/storage/paths';
+import { resolveProjectRefContext } from '@vibesdotdev/workspace/project-ref';
+import { DEV_WORKSPACE_INDEX_MANIFEST_ID } from '@vibesdotdev/workspace/manifests/workspace.config';
+import { readMcpWorkspaceWarning } from "../../surface-mcp/workspace-warning.js";
+function boundedId(value) {
+    if (value === undefined)
+        return null;
+    return value.trim().length > 0 ? value : null;
+}
+/**
+ * This invocation's bound work session, from the stamped caller only.
+ * A leftover participant→session mapping is not a bind for this connection.
+ */
+export function callerBoundWorkSession(caller) {
+    const sessionId = boundedId(caller?.sessionId);
+    const participantId = boundedId(caller?.participantId);
+    return {
+        boundSessionId: sessionId,
+        boundParticipantId: sessionId ? participantId : null
+    };
+}
+/**
+ * Read-only bound-work-session snapshot. Does not create participants, bind
+ * transports, or open paused/default sessions.
+ */
+export async function snapshotBoundWorkSession(args) {
+    if (!args.manager)
+        return { active: false };
+    let sessionId = args.boundSessionId;
+    if (!sessionId &&
+        args.boundParticipantId &&
+        args.manager.getAuthoritativeParticipantActiveSession) {
+        sessionId = await args.manager.getAuthoritativeParticipantActiveSession(args.boundParticipantId);
+    }
+    if (!sessionId)
+        return { active: false };
+    const session = await args.manager.getSession(sessionId);
+    if (!session?.id)
+        return { active: false };
+    return { active: true, sessionId: session.id };
+}
+/**
+ * This call's workspace: the kernel's one reader (`runtime/workspace-path`),
+ * which answers the invocation's workspace, else the host's binding. An unbound
+ * host fails `NOT_FOUND` `workspace-unbound` with its recovery hint; nothing
+ * here falls back to the process cwd, `/` or the home directory.
+ */
+async function resolveWorkspacePath(runtime) {
+    return runtime.context('runtime/workspace-path');
+}
+async function resolveProjectId(runtime, workspacePath) {
+    const context = await resolveProjectRefContext(runtime);
+    return context.resolve({ cwd: workspacePath })?.projectId ?? null;
+}
+const vibesContextImpl = {
+    async execute(input, runtime, ctx) {
+        const log = getLogger('mcp', runtime);
+        const workspacePath = await resolveWorkspacePath(runtime);
+        const projectId = await resolveProjectId(runtime, workspacePath);
+        const hints = [];
+        if (!projectId) {
+            hints.push('Checkout is unbound: run `vibes projects switch <project-uuid>` before using project-scoped tools.');
+        }
+        // Body-health: the kernel never binds `/` or the home directory (an
+        // unbound host fails above with `workspace-unbound`), so the one
+        // remaining warning is the surface's own.
+        const roots = getPathRoots(runtime);
+        const home = resolveHomePath(roots).replaceAll('\\', '/');
+        const surfaceWarning = await readMcpWorkspaceWarning(runtime);
+        if (surfaceWarning) {
+            hints.unshift(`⚠️ ${surfaceWarning}`);
+        }
+        // Surface which vibes home storage/secrets resolve to. paths/roots owns the
+        // selection (there is no dev-from-source split anymore), so a home that
+        // actually differs from the default <userHome>/.vibes is an explicit
+        // override worth seeing — fragmentation stays visible, not silent. Pinning
+        // VIBES_HOME to the default value (the recommended MCP client config) is
+        // healthy and stays quiet.
+        const baseDir = resolveVibesBaseDir(roots).replaceAll('\\', '/');
+        const defaultVibesHome = `${home}/${DEFAULT_VIBES_HOME_DIRNAME}`;
+        if (baseDir !== defaultVibesHome) {
+            hints.push(`storage/secrets resolve to ${baseDir} (vibes home selected via ${roots.origin}, not the default ${defaultVibesHome}).`);
+        }
+        const output = {
+            workspacePath,
+            projectId,
+            surface: runtime.scope.surface,
+            hardware: runtime.scope.hardware,
+            hints
+        };
+        if (input.includeAtlas !== false && projectId) {
+            const read = await settle(async () => {
+                const atlas = await (await runtime.query('workspace/code-atlas').resolve()).status({ projectId, workspaceRoot: workspacePath });
+                const status = {
+                    exists: atlas.exists,
+                    summary: atlas.exists ? `${atlas.corpusFiles ?? 0} files, ${atlas.corpusSymbols ?? 0} symbols` : undefined,
+                    lastRunCompletedAt: atlas.latestRun?.completedAt ?? undefined,
+                    kind: 'code-atlas',
+                    authorityForSearch: true
+                };
+                return status;
+            });
+            if (read.ok) {
+                output.atlas = read.value;
+                if (!read.value.exists) {
+                    hints.push('No atlas index: run workspace-search with action index-create or wait for auto-index. Atlas, not workspaceIndex, is authoritative for search readiness.');
+                }
+            }
+            else {
+                const failure = valueFreeFailure(read.cause);
+                output.atlasFailure = failure;
+                log.warn('vibes-context: atlas status unavailable', { error: failure });
+                hints.push('Atlas status unavailable (PM/workers may still be starting).');
+            }
+        }
+        if (input.includeWorkspaceIndex !== false) {
+            const read = await settle(async () => {
+                const indexManifest = runtime.hasKind('storage/manifest') &&
+                    runtime.query('storage/manifest').withId(DEV_WORKSPACE_INDEX_MANIFEST_ID).descriptors().length > 0
+                    ? await runtime.query('storage/manifest').withId(DEV_WORKSPACE_INDEX_MANIFEST_ID).resolve()
+                    : null;
+                if (!indexManifest)
+                    return null;
+                const index = await indexManifest.loadIndex(workspacePath);
+                const files = Object.values(index.files);
+                const dirtyCount = files.filter((file) => file.dirty).length;
+                const listed = {
+                    fileCount: files.length,
+                    dirtyCount,
+                    updatedAt: index.updatedAt,
+                    kind: 'workspace-file-index',
+                    authorityForSearch: false
+                };
+                return { listed, atlasExists: output.atlas?.exists === true };
+            });
+            if (!read.ok) {
+                const failure = valueFreeFailure(read.cause);
+                output.workspaceIndexFailure = failure;
+                log.warn('vibes-context: workspace file index unavailable', { error: failure });
+                hints.push('Workspace file index unavailable.');
+            }
+            else if (read.value === null) {
+                hints.push('Workspace file index unavailable.');
+            }
+            else {
+                output.workspaceIndex = read.value.listed;
+                if (read.value.listed.fileCount === 0 && read.value.atlasExists) {
+                    hints.push('workspaceIndex is the dirty-file index (fileCount 0 here does not mean search is empty). Atlas is authoritative for search readiness.');
+                }
+                if (read.value.listed.dirtyCount > 0) {
+                    hints.push(`${read.value.listed.dirtyCount} workspace files marked dirty — sync may be in progress.`);
+                }
+            }
+        }
+        if (input.includeSession !== false) {
+            const read = await settle(async () => {
+                const { tryGetSessionManager } = await import("../../surface-mcp/session-bridge.js");
+                const manager = await tryGetSessionManager(runtime);
+                const managerAvailable = Boolean(manager);
+                let bound = false;
+                let sessionId;
+                if (manager) {
+                    const snapshot = await snapshotBoundWorkSession({
+                        ...callerBoundWorkSession(ctx.caller),
+                        manager
+                    });
+                    bound = snapshot.active;
+                    sessionId = snapshot.sessionId;
+                }
+                let unboundHint;
+                const session = {
+                    active: bound,
+                    sessionId,
+                    source: 'bound-work-session',
+                    managerAvailable
+                };
+                if (manager && !bound) {
+                    const { buildUnboundSessionGuidance, renderUnboundSessionGuidance } = await import('@vibesdotdev/session/mcp/utils/participant');
+                    const unbound = await buildUnboundSessionGuidance(manager, { workspacePath });
+                    session.unbound = unbound;
+                    unboundHint = renderUnboundSessionGuidance(unbound);
+                }
+                return { session, unboundHint };
+            });
+            if (read.ok) {
+                output.session = read.value.session;
+                if (read.value.unboundHint)
+                    hints.unshift(read.value.unboundHint);
+            }
+            else {
+                const failure = valueFreeFailure(read.cause);
+                output.sessionFailure = failure;
+                log.warn('vibes-context: session snapshot unavailable', { error: failure });
+                hints.push('Session snapshot unavailable.');
+            }
+        }
+        if (!hints.length) {
+            hints.push('Use workspace-search action search after index-status shows exists:true.');
+        }
+        return output;
+    }
+};
+export default vibesContextImpl;
+//# sourceMappingURL=vibes-context.impl.js.map

package/dist/tools/vibes-context/vibes-context.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-context.impl.js","sourceRoot":"","sources":["../../../src/tools/vibes-context/vibes-context.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mDAAmD,CAAC;AAGpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAOjF,SAAS,SAAS,CAAC,KAAyB;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAyC;IAC/E,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvD,OAAO;QACN,cAAc,EAAE,SAAS;QACzB,kBAAkB,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;KACpD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAI9C;IACA,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5C,IAAI,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC;IACpC,IACC,CAAC,SAAS;QACV,IAAI,CAAC,kBAAkB;QACvB,IAAI,CAAC,OAAO,CAAC,wCAAwC,EACpD,CAAC;QACF,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,oBAAoB,CAAC,OAAqB;IACxD,OAAO,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,OAAqB,EAAE,aAAqB;IAC3E,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AACnE,CAAC;AAED,MAAM,gBAAgB,GAAG;IACxB,KAAK,CAAC,OAAO,CACZ,KAAwB,EACxB,OAAqB,EACrB,GAAoB;QAEpB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CACT,oGAAoG,CACpG,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,iEAAiE;QACjE,0CAA0C;QAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,cAAc,EAAE,CAAC;YACpB,KAAK,CAAC,OAAO,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,4EAA4E;QAC5E,wEAAwE;QACxE,qEAAqE;QACrE,2EAA2E;QAC3E,yEAAyE;QACzE,2BAA2B;QAC3B,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAG,GAAG,IAAI,IAAI,0BAA0B,EAAE,CAAC;QACjE,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CACT,8BAA8B,OAAO,6BAA6B,KAAK,CAAC,MAAM,qBAAqB,gBAAgB,IAAI,CACvH,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAuB;YAClC,aAAa;YACb,SAAS;YACT,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;YAC9B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;YAChC,KAAK;SACL,CAAC;QAEF,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK,IAAI,SAAS,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACpC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,OAAO,CAAC,KAAK,CAA+B,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;gBAC9J,MAAM,MAAM,GAA6C;oBACxD,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,WAAW,KAAK,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBAC1G,kBAAkB,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,SAAS;oBAC7D,IAAI,EAAE,YAAY;oBAClB,kBAAkB,EAAE,IAAI;iBACxB,CAAC;gBACF,OAAO,MAAM,CAAC;YACf,CAAC,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CACT,yJAAyJ,CACzJ,CAAC;gBACH,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7C,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACxE,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC5E,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACpC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC;oBACxD,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,GAAG,CAAC;oBAClG,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAA4C,kBAAkB,CAAC,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,OAAO,EAAE;oBACtI,CAAC,CAAC,IAAI,CAAC;gBACR,IAAI,CAAC,aAAa;oBAAE,OAAO,IAAI,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;gBAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;gBAC7D,MAAM,MAAM,GAAsD;oBACjE,SAAS,EAAE,KAAK,CAAC,MAAM;oBACvB,UAAU;oBACV,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,IAAI,EAAE,sBAAsB;oBAC5B,kBAAkB,EAAE,KAAK;iBACzB,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;YAC/D,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7C,MAAM,CAAC,qBAAqB,GAAG,OAAO,CAAC;gBACvC,GAAG,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBACjE,KAAK,CAAC,IAAI,CACT,uIAAuI,CACvI,CAAC;gBACH,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CACT,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,0DAA0D,CACzF,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACpC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;gBACrF,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACpD,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,KAAK,GAAG,KAAK,CAAC;gBAClB,IAAI,SAA6B,CAAC;gBAClC,IAAI,OAAO,EAAE,CAAC;oBACb,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC;wBAC/C,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC;wBACrC,OAAO;qBACP,CAAC,CAAC;oBACH,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;oBACxB,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;gBAChC,CAAC;gBACD,IAAI,WAA+B,CAAC;gBACpC,MAAM,OAAO,GAA+C;oBAC3D,MAAM,EAAE,KAAK;oBACb,SAAS;oBACT,MAAM,EAAE,oBAAoB;oBAC5B,gBAAgB;iBAChB,CAAC;gBACF,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;oBACvB,MAAM,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,GAAG,MAAM,MAAM,CACjF,4CAA4C,CAC5C,CAAC;oBACF,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;oBAC9E,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;oBAC1B,WAAW,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBACpC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW;oBAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnE,CAAC;iBAAM,CAAC;gBACP,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7C,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,6CAA6C,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;CACD,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/tui/index.d.ts

@@ -0,0 +1,4 @@
+export { default } from './mcp-tui.plugin.ts';
+export { isMcpBodyStale } from './mcp-health.ts';
+export { describeMcpHealth } from './mcp.tui-state.descriptor.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/tui/index.js

@@ -0,0 +1,4 @@
+export { default } from "./mcp-tui.plugin.js";
+export { isMcpBodyStale } from "./mcp-health.js";
+export { describeMcpHealth } from "./mcp.tui-state.descriptor.js";
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/tui/mcp-health.d.ts

@@ -0,0 +1,7 @@
+import type { BuildProvenance } from '../surface-mcp/build-provenance.ts';
+export interface McpBodyStaleness {
+    stale: boolean;
+    reason: string | null;
+}
+export declare function isMcpBodyStale(provenance: Pick<BuildProvenance, 'distStale' | 'sourceRefKind' | 'provenanceString'>): McpBodyStaleness;
+//# sourceMappingURL=mcp-health.d.ts.map

package/dist/tui/mcp-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-health.d.ts","sourceRoot":"","sources":["../../src/tui/mcp-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,cAAc,CAC7B,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,eAAe,GAAG,kBAAkB,CAAC,GACnF,gBAAgB,CAclB"}

package/dist/tui/mcp-health.js

@@ -0,0 +1,16 @@
+export function isMcpBodyStale(provenance) {
+    if (provenance.distStale === true) {
+        return { stale: true, reason: 'dist is older than source' };
+    }
+    if (provenance.sourceRefKind === 'unknown' || provenance.provenanceString.includes('source@unknown')) {
+        return { stale: true, reason: 'executable source@unknown' };
+    }
+    // The third arm used to be `sourceWorkspaceDiverged` — the source ref not
+    // equalling the USER PROJECT's ref. Those are two different repositories, so
+    // under a thin host that fired on every healthy body. Deleted in WU-11; the
+    // nerve that answers "did this body's code move" is
+    // `adapters/mcp/stale-body.consumer.ts` (executable + graph), which reads
+    // the lockfile under R rather than an unrelated checkout's HEAD.
+    return { stale: false, reason: null };
+}
+//# sourceMappingURL=mcp-health.js.map

package/dist/tui/mcp-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-health.js","sourceRoot":"","sources":["../../src/tui/mcp-health.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,cAAc,CAC7B,UAAqF;IAErF,IAAI,UAAU,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,IAAI,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACtG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC7D,CAAC;IACD,0EAA0E;IAC1E,6EAA6E;IAC7E,4EAA4E;IAC5E,oDAAoD;IACpD,0EAA0E;IAC1E,iEAAiE;IACjE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare const mcpTuiPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default mcpTuiPlugin;
+//# sourceMappingURL=mcp-tui.plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tui.plugin.d.ts","sourceRoot":"","sources":["../../src/tui/mcp-tui.plugin.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY,6CAUvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tui/mcp-tui.plugin.js

@@ -0,0 +1,18 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import mcpAppDescriptor from "./mcp.tui-app.descriptor.js";
+import mcpStateDescriptor from "./mcp.tui-state.descriptor.js";
+const TUI_APP = { kind: 'tui/app' };
+const TUI_STATE = { kind: 'tui/state' };
+export const mcpTuiPlugin = createRuntimePlugin({
+    id: 'mcp.tui',
+    name: 'MCP TUI Surface',
+    description: 'Operator inspector for MCP body freshness and tool ping.',
+    dependencies: ['tui'],
+    descriptors: [mcpAppDescriptor, mcpStateDescriptor],
+    loaders: [
+        loader('mcp.health', TUI_APP, () => import("./mcp.tui-app.impl.consumer.js")),
+        loader('mcp.health', TUI_STATE, () => import("./mcp.tui-state.impl.consumer.js"))
+    ]
+});
+export default mcpTuiPlugin;
+//# sourceMappingURL=mcp-tui.plugin.js.map

package/dist/tui/mcp-tui.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tui.plugin.js","sourceRoot":"","sources":["../../src/tui/mcp-tui.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAC3D,OAAO,kBAAkB,MAAM,+BAA+B,CAAC;AAE/D,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAW,CAAC;AAC7C,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,WAAW,EAAW,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;IAC/C,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,0DAA0D;IACvE,YAAY,EAAE,CAAC,KAAK,CAAC;IACrB,WAAW,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IACnD,OAAO,EAAE;QACR,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gCAAiC,CAAC,CAAC;QAC9E,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;KACjF;CACD,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tui/mcp.tui-app.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { TuiAppDescriptor } from '@vibesdotdev/tui/schemas/tui-app';
+declare const descriptor: TuiAppDescriptor;
+export default descriptor;
+//# sourceMappingURL=mcp.tui-app.descriptor.d.ts.map

package/dist/tui/mcp.tui-app.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-app.descriptor.d.ts","sourceRoot":"","sources":["../../src/tui/mcp.tui-app.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,QAAA,MAAM,UAAU,EAAE,gBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/tui/mcp.tui-app.descriptor.js

@@ -0,0 +1,19 @@
+const descriptor = {
+    kind: 'tui/app',
+    id: 'mcp.health',
+    title: 'MCP',
+    description: 'Body freshness and tool ping. Not a marketplace.',
+    icon: '⌁',
+    category: 'System',
+    audience: 'ops',
+    order: 27,
+    route: '/mcp',
+    states: ['mcp.health'],
+    embeddable: false,
+    minSize: { width: 72, height: 20 },
+    surfaces: ['tui'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=mcp.tui-app.descriptor.js.map

package/dist/tui/mcp.tui-app.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-app.descriptor.js","sourceRoot":"","sources":["../../src/tui/mcp.tui-app.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAqB;IACpC,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,CAAC,YAAY,CAAC;IACtB,UAAU,EAAE,KAAK;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAClC,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/tui/mcp.tui-app.impl.consumer.d.ts

@@ -0,0 +1,4 @@
+import type { TuiAppImplementation } from '@vibesdotdev/tui/kinds/tui-app';
+declare const impl: TuiAppImplementation;
+export default impl;
+//# sourceMappingURL=mcp.tui-app.impl.consumer.d.ts.map

package/dist/tui/mcp.tui-app.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-app.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/tui/mcp.tui-app.impl.consumer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,gCAAgC,CAAC;AAmFxF,QAAA,MAAM,IAAI,EAAE,oBAEX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tui/mcp.tui-app.impl.consumer.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
+import { useCallback, useEffect } from 'react';
+import { useTuiState, useTuiDispatch } from '@vibesdotdev/tui/state/hooks';
+import { VStack } from '@vibesdotdev/tui/components/layout';
+import { DSButton, DSText, Panel, DSEmptyState } from '@vibesdotdev/tui/components/content';
+import { PageHeader, PageLayout } from '@vibesdotdev/tui/components/page';
+import { useKeyboardLayer } from '@vibesdotdev/tui/input';
+import { useContributeScreenStatus } from '@vibesdotdev/tui/shell';
+import { describeMcpHealth } from "./mcp.tui-state.descriptor.js";
+import { mcpHealthStateKey } from "./mcp.tui-state.key.js";
+function McpPage({ embedded }) {
+    const state = useTuiState(mcpHealthStateKey);
+    const dispatch = useTuiDispatch(mcpHealthStateKey);
+    const refresh = useCallback(() => {
+        void dispatch({ type: 'REFRESH' });
+    }, [dispatch]);
+    useEffect(() => {
+        if (!state?.loaded && !state?.loading)
+            refresh();
+    }, [state?.loaded, state?.loading, refresh]);
+    useKeyboardLayer('zone', (key) => {
+        if (key.name === 'r' && !key.ctrl && !key.meta) {
+            refresh();
+            return true;
+        }
+        return false;
+    }, { deps: [refresh] });
+    const summary = state ? describeMcpHealth(state) : 'checking mcp…';
+    useContributeScreenStatus('mcp.health', {
+        facts: [
+            {
+                slot: 'context',
+                value: summary,
+                priority: 2,
+                tone: state?.stale || state?.error ? 'warning' : 'default'
+            }
+        ],
+        hints: [{ keys: 'r', label: 'refresh', priority: 1 }]
+    });
+    return (_jsxs(PageLayout, { children: [embedded ? undefined : (_jsx(PageHeader, { title: "MCP", description: "Body freshness and a read-safe tool ping. Not a catalog editor." })), _jsxs(VStack, { gap: 1, children: [state?.error ? (_jsxs(Panel, { bordered: true, status: "warning", padding: "md", gap: "sm", children: [_jsx(DSText, { children: state.error }), _jsx(DSButton, { id: "mcp-retry", label: "Retry", onClick: refresh })] })) : null, !state?.error && !state?.loaded ? _jsx(DSText, { variant: "muted", children: "Checking MCP body\u2026" }) : null, state?.stale ? (_jsx(Panel, { bordered: true, status: "warning", padding: "md", children: _jsx(DSText, { children: state.staleReason ?? 'Stale MCP body' }) })) : null, state?.loaded && !state.error ? (_jsxs(Panel, { bordered: true, padding: "md", gap: "sm", children: [_jsx(DSText, { children: summary }), _jsx(DSText, { variant: "muted", children: state.pingId
+                                    ? `ping ${state.pingId}: ${state.pingOk ? 'ok' : 'failed'}${state.pingDetail ? ` (${state.pingDetail})` : ''}`
+                                    : 'no tool to ping' }), state.provenance ? _jsx(DSText, { variant: "muted", children: state.provenance }) : null] })) : null, state?.loaded && !state.error && state.toolCount === 0 ? (_jsx(DSEmptyState, { title: "No MCP tools", description: "Compose a tools plugin, then refresh." })) : null] })] }));
+}
+const impl = {
+    component: (props) => _jsx(McpPage, { ...props })
+};
+export default impl;
+//# sourceMappingURL=mcp.tui-app.impl.consumer.js.map

package/dist/tui/mcp.tui-app.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-app.impl.consumer.js","sourceRoot":"","sources":["../../src/tui/mcp.tui-app.impl.consumer.tsx"],"names":[],"mappings":"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"}

package/dist/tui/mcp.tui-state.descriptor.d.ts

@@ -0,0 +1,8 @@
+import type { TuiStateDescriptor } from '@vibesdotdev/tui/schemas/tui-state';
+import type { McpHealthState } from './mcp.tui-state.key.ts';
+export type { McpHealthState } from './mcp.tui-state.key.ts';
+export declare const defaultMcpHealthState: McpHealthState;
+export declare function describeMcpHealth(state: McpHealthState): string;
+declare const descriptor: TuiStateDescriptor;
+export default descriptor;
+//# sourceMappingURL=mcp.tui-state.descriptor.d.ts.map

package/dist/tui/mcp.tui-state.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-state.descriptor.d.ts","sourceRoot":"","sources":["../../src/tui/mcp.tui-state.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,qBAAqB,EAAE,cAcnC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAM/D;AAED,QAAA,MAAM,UAAU,EAAE,kBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/tui/mcp.tui-state.descriptor.js

@@ -0,0 +1,37 @@
+export const defaultMcpHealthState = {
+    runningHint: 'unknown',
+    stale: false,
+    staleReason: null,
+    provenance: '',
+    toolCount: 0,
+    pingId: null,
+    pingOk: null,
+    pingDetail: null,
+    loaded: false,
+    loading: false,
+    error: null,
+    failure: null,
+    lastUpdated: null
+};
+export function describeMcpHealth(state) {
+    if (state.error)
+        return 'mcp unavailable';
+    if (!state.loaded)
+        return 'checking mcp…';
+    if (state.stale)
+        return state.staleReason ?? 'stale body';
+    if (state.pingOk === false)
+        return `ping failed (${state.pingId ?? 'tool'})`;
+    return `${state.toolCount} tools · body fresh`;
+}
+const descriptor = {
+    kind: 'tui/state',
+    id: 'mcp.health',
+    capabilityId: 'dev.mcp.status',
+    defaultValue: defaultMcpHealthState,
+    refreshInterval: 0,
+    persist: false,
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=mcp.tui-state.descriptor.js.map

package/dist/tui/mcp.tui-state.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-state.descriptor.js","sourceRoot":"","sources":["../../src/tui/mcp.tui-state.descriptor.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACpD,WAAW,EAAE,SAAS;IACtB,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;CACjB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACtD,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,iBAAiB,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,eAAe,CAAC;IAC1C,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,WAAW,IAAI,YAAY,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,gBAAgB,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC;IAC7E,OAAO,GAAG,KAAK,CAAC,SAAS,qBAAqB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,GAAuB;IACtC,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,YAAY;IAChB,YAAY,EAAE,gBAAgB;IAC9B,YAAY,EAAE,qBAAqB;IACnC,eAAe,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/tui/mcp.tui-state.impl.consumer.d.ts

@@ -0,0 +1,5 @@
+import type { TuiStateImplementation } from '@vibesdotdev/tui/kinds/tui-state';
+import type { McpHealthState } from './mcp.tui-state.descriptor.ts';
+declare const impl: TuiStateImplementation<McpHealthState>;
+export default impl;
+//# sourceMappingURL=mcp.tui-state.impl.consumer.d.ts.map

package/dist/tui/mcp.tui-state.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-state.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/tui/mcp.tui-state.impl.consumer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGX,sBAAsB,EACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAoDpE,QAAA,MAAM,IAAI,EAAE,sBAAsB,CAAC,cAAc,CA0ChD,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tui/mcp.tui-state.impl.consumer.js

@@ -0,0 +1,97 @@
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getMcpBuildProvenance } from "../surface-mcp/build-provenance.js";
+import { isMcpBodyStale } from "./mcp-health.js";
+import { defaultMcpHealthState } from "./mcp.tui-state.descriptor.js";
+import { mcpHealthStateKey } from "./mcp.tui-state.key.js";
+const scratch = new WeakMap();
+const PING_CANDIDATES = ['brain', 'presence', 'workspace-fs'];
+async function pingTool(runtime, id) {
+    try {
+        const resolved = await runtime.query('tools/tool').withId(id).resolve();
+        return resolved == null
+            ? { ok: false, detail: 'descriptor present, implementation did not resolve', failure: null }
+            : { ok: true, detail: 'resolved', failure: null };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            detail: err instanceof Error ? err.message : String(err),
+            failure: valueFreeFailure(CaughtFailureSchema.parse(err))
+        };
+    }
+}
+async function buildState(runtime) {
+    // The host's bound workspace; an unbound host fails with `workspace-unbound`.
+    const provenance = await getMcpBuildProvenance(runtime, await runtime.context('runtime/workspace-path'));
+    const stale = isMcpBodyStale(provenance);
+    const tools = runtime.hasKind('tools/tool') ? runtime.assets('tools/tool').descriptors() : [];
+    const enabledIds = new Set(tools.flatMap((tool) => (tool.id.length > 0 ? [tool.id] : [])));
+    const pingId = PING_CANDIDATES.find((id) => enabledIds.has(id)) ?? [...enabledIds][0] ?? null;
+    const ping = pingId && runtime.hasKind('tools/tool') ? await pingTool(runtime, pingId) : null;
+    return {
+        runningHint: stale.stale ? 'stale' : 'fresh',
+        stale: stale.stale,
+        staleReason: stale.reason,
+        provenance: provenance.provenanceString,
+        toolCount: enabledIds.size,
+        pingId,
+        pingOk: ping ? ping.ok : null,
+        pingDetail: ping?.detail ?? null,
+        loaded: true,
+        loading: false,
+        error: runtime.hasKind('tools/tool') ? null : 'tools/tool kind is not registered in this runtime.',
+        failure: ping?.failure ?? null,
+        lastUpdated: Date.now()
+    };
+}
+const impl = {
+    key: mcpHealthStateKey,
+    async init(ctx) {
+        const runtime = ctx.runtime;
+        const refresh = async () => {
+            if (!scratch.has(ctx))
+                return;
+            try {
+                const next = await buildState(runtime);
+                if (!scratch.has(ctx))
+                    return;
+                ctx.setState(() => next);
+            }
+            catch (err) {
+                const failure = valueFreeFailure(CaughtFailureSchema.parse(err));
+                if (scratch.has(ctx)) {
+                    ctx.setState((prev) => ({
+                        ...prev,
+                        loaded: true,
+                        error: err instanceof Error ? err.message : String(err),
+                        failure
+                    }));
+                }
+                return failure;
+            }
+        };
+        scratch.set(ctx, { refresh });
+        try {
+            return await buildState(runtime);
+        }
+        catch (err) {
+            return {
+                ...defaultMcpHealthState,
+                loaded: true,
+                error: err instanceof Error ? err.message : String(err),
+                failure: valueFreeFailure(CaughtFailureSchema.parse(err))
+            };
+        }
+    },
+    reduce(state, action, ctx) {
+        if (action.type === 'REFRESH')
+            void (ctx ? scratch.get(ctx) : undefined)?.refresh();
+        return state;
+    },
+    dispose(ctx) {
+        if (ctx)
+            scratch.delete(ctx);
+    }
+};
+export default impl;
+//# sourceMappingURL=mcp.tui-state.impl.consumer.js.map

package/dist/tui/mcp.tui-state.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tui-state.impl.consumer.js","sourceRoot":"","sources":["../../src/tui/mcp.tui-state.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAGhB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAGxB,CAAC;AACJ,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAIvE,KAAK,UAAU,QAAQ,CAAC,OAAqB,EAAE,EAAU;IACxD,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACxE,OAAO,QAAQ,IAAI,IAAI;YACtB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oDAAoD,EAAE,OAAO,EAAE,IAAI,EAAE;YAC5F,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO;YACN,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACxD,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACzD,CAAC;IACH,CAAC;AACF,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAqB;IAC9C,8EAA8E;IAC9E,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC,CAAC;IACjH,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC9F,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,OAAO;QACN,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,UAAU,EAAE,UAAU,CAAC,gBAAgB;QACvC,SAAS,EAAE,UAAU,CAAC,IAAI;QAC1B,MAAM;QACN,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAC7B,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;QAChC,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oDAAoD;QAClG,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC9B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAA2C;IACpD,GAAG,EAAE,iBAAiB;IACtB,KAAK,CAAC,IAAI,CAAC,GAAoC;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,IAAsC,EAAE;YAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO;gBAC9B,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjE,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACvB,GAAG,IAAI;wBACP,MAAM,EAAE,IAAI;wBACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;wBACvD,OAAO;qBACP,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,OAAO,CAAC;YAChB,CAAC;QACF,CAAC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC;YACJ,OAAO,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO;gBACN,GAAG,qBAAqB;gBACxB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aACzD,CAAC;QACH,CAAC;IACF,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,MAAsB,EAAE,GAAqC;QAC1E,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAqC;QAC5C,IAAI,GAAG;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACD,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tui/mcp.tui-state.key.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The `mcp.health` tui/state key: the MCP host's health the MCP TUI shows,
+ * with the schema every value written to it is parsed by.
+ */
+import * as z from 'zod/v4';
+export declare const McpHealthStateSchema: z.ZodObject<{
+    runningHint: z.ZodString;
+    stale: z.ZodBoolean;
+    staleReason: z.ZodNullable<z.ZodString>;
+    provenance: z.ZodString;
+    toolCount: z.ZodNumber;
+    pingId: z.ZodNullable<z.ZodString>;
+    pingOk: z.ZodNullable<z.ZodBoolean>;
+    pingDetail: z.ZodNullable<z.ZodString>;
+    loaded: z.ZodBoolean;
+    loading: z.ZodBoolean;
+    error: z.ZodNullable<z.ZodString>;
+    failure: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    lastUpdated: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type McpHealthState = z.infer<typeof McpHealthStateSchema>;
+export declare const mcpHealthStateKey: import("@vibesdotdev/tui/kinds/tui-state").TuiStateKey<{
+    runningHint: string;
+    stale: boolean;
+    staleReason: string | null;
+    provenance: string;
+    toolCount: number;
+    pingId: string | null;
+    pingOk: boolean | null;
+    pingDetail: string | null;
+    loaded: boolean;
+    loading: boolean;
+    error: string | null;
+    failure: {
+        name: string;
+        code?: string | undefined;
+        reason?: string | undefined;
+    } | null;
+    lastUpdated: number | null;
+}>;
+//# sourceMappingURL=mcp.tui-state.key.d.ts.map