@nowline/mcp 0.8.4 → 0.8.6

package/src/index.ts

@@ -15,8 +15,8 @@ import { readFileSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
 import { expandRootPath } from './root-path.js';
 import { createMcpServer } from './server.js';
 
@@ -104,7 +104,7 @@ const server = createMcpServer({
 
 if (port !== undefined) {
     // Streamable HTTP transport — stateless (no session management).
-    const transport = new StreamableHTTPServerTransport({
+    const transport = new NodeStreamableHTTPServerTransport({
         sessionIdGenerator: undefined,
     });
     await server.connect(transport);

package/src/prompts.ts

@@ -1,7 +1,7 @@
 // MCP prompt registrations for @nowline/mcp.
 // Wired into the server via registerPrompts(server).
 
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import { z } from 'zod';
 
 export function registerPrompts(server: McpServer): void {
@@ -13,13 +13,13 @@ export function registerPrompts(server: McpServer): void {
             title: 'Create Roadmap from Description',
             description:
                 'Generate a new .nowline roadmap from a plain-English description. Composes the DSL reference and example files so the LLM has full context.',
-            argsSchema: {
+            argsSchema: z.object({
                 description: z
                     .string()
                     .describe(
                         'Plain-English description of the roadmap you want to create (teams, timeline, key milestones, etc.).',
                     ),
-            },
+            }),
         },
         ({ description }) => ({
             messages: [
@@ -64,7 +64,7 @@ export function registerPrompts(server: McpServer): void {
             title: 'Fix Roadmap Diagnostics',
             description:
                 'Fix validation errors in a .nowline file. Describe the validate→fix→re-validate loop keyed on NL.E#### diagnostic codes.',
-            argsSchema: {
+            argsSchema: z.object({
                 source: z
                     .string()
                     .describe('The .nowline source text that contains validation errors.'),
@@ -74,7 +74,7 @@ export function registerPrompts(server: McpServer): void {
                     .describe(
                         'JSON array of diagnostic objects from the validate tool. Omit to let the LLM call validate itself.',
                     ),
-            },
+            }),
         },
         ({ source, diagnostics }) => {
             const diagSection = diagnostics
@@ -113,7 +113,7 @@ export function registerPrompts(server: McpServer): void {
             title: 'Convert to Nowline',
             description:
                 'Convert a gantt/timeline from another format (Mermaid gantt, MS Project, Excel, Google Sheets, CSV) into Nowline DSL. Uses the conversion guide resource for format-specific rules.',
-            argsSchema: {
+            argsSchema: z.object({
                 source: z
                     .string()
                     .describe('The source content to convert (paste the raw text/CSV/XML here).'),
@@ -130,7 +130,7 @@ export function registerPrompts(server: McpServer): void {
                     .describe(
                         'Source format hint. Use "auto" (default) to let the LLM detect the format.',
                     ),
-            },
+            }),
         },
         ({ source, from }) => {
             const formatHint =

package/src/server.ts

@@ -14,7 +14,7 @@ import {
     registerAppResource,
     registerAppTool,
 } from '@modelcontextprotocol/ext-apps/server';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@modelcontextprotocol/server';
 import { type NowlineFile, parseNowlineJson, printNowlineFile } from '@nowline/core';
 import {
     type ExportFormat,
@@ -616,7 +616,8 @@ export function createMcpServer(opts: McpServerOptions = {}): McpServer {
                     .boolean()
                     .optional()
                     .describe(
-                        'When true, force the in-chat MCP Apps preview. On MCP Apps hosts the preview auto-renders via _meta.ui without this flag.',
+                        'When true, force the in-chat MCP Apps preview; when false, return inline output even on an MCP Apps host. ' +
+                            'Omit to follow the host: on MCP Apps hosts the preview auto-renders via _meta.ui.',
                     ),
             }),
             outputSchema: RenderOutputSchema,
@@ -652,7 +653,8 @@ export function createMcpServer(opts: McpServerOptions = {}): McpServer {
                 pngScale: args.scale,
             };
             const host = createNodeHostEnv(filePath);
-            const appActive = args.preview === true || clientSupportsAppsUi(server);
+            // Explicit true/false wins; undefined follows the host's capabilities.
+            const appActive = args.preview ?? clientSupportsAppsUi(server);
             // Skip the full render when the bytes won't be used: apps host with
             // no write-to-disk path and no review attachment requested.
             const needsRender = !appActive || !!args.output || args.review === true;

package/src/ui/entry.ts

@@ -25,7 +25,7 @@
 declare const __MCP_VERSION__: string;
 
 import { App } from '@modelcontextprotocol/ext-apps';
-import { mountLivePreview } from '@nowline/preview';
+import { type LivePreviewHandle, mountLivePreview } from '@nowline/preview';
 import type { NowOverride, ThemeOverride } from '@nowline/preview-shell';
 import {
     type PreviewPayload,
@@ -59,8 +59,13 @@ function toThemeOverride(theme: string | undefined): ThemeOverride {
 
 let mounted = false;
 let mountedSource: string | undefined;
+let live: LivePreviewHandle | undefined;
 
-function mountFromPayload(payload: PreviewPayload): void {
+function hostTheme(app: App): 'light' | 'dark' | undefined {
+    return app.getHostContext()?.theme;
+}
+
+function mountFromPayload(payload: PreviewPayload, app: App): void {
     const root = document.getElementById('nl-preview-root');
     if (!root || typeof payload.source !== 'string') {
         return;
@@ -72,11 +77,14 @@ function mountFromPayload(payload: PreviewPayload): void {
     // re-invocation on the same iframe) tears down the prior mount first.
     if (mounted) {
         if (payload.source === mountedSource) return;
+        live?.dispose();
+        live = undefined;
         (root as HTMLElement).replaceChildren();
     }
 
-    mountLivePreview(root as HTMLElement, {
+    live = mountLivePreview(root as HTMLElement, {
         source: payload.source,
+        mode: hostTheme(app) ?? 'system',
         initialView: {
             theme: toThemeOverride(payload.theme),
             now: (payload.now ?? 'today') as NowOverride,
@@ -187,7 +195,7 @@ async function bootstrap(): Promise<void> {
     // before the server finishes rendering. Mirrors the official ext-apps examples.
     app.ontoolinput = ({ arguments: args }) => {
         const payload = parsePreviewFromArguments(args as Record<string, unknown> | undefined);
-        if (payload) mountFromPayload(payload);
+        if (payload) mountFromPayload(payload, app);
     };
 
     // Authoritative path: the server-resolved lean preview payload. Reconciles the
@@ -195,11 +203,14 @@ async function bootstrap(): Promise<void> {
     app.ontoolresult = ({ content, isError }) => {
         if (isError) return;
         const payload = parsePreviewFromContent(content);
-        if (payload) mountFromPayload(payload);
+        if (payload) mountFromPayload(payload, app);
     };
 
-    // Re-report when the host changes our width / available height.
-    app.onhostcontextchanged = () => reportHeight(app);
+    // Re-report when the host changes our width / available height / theme.
+    app.onhostcontextchanged = () => {
+        live?.handle.setMode(hostTheme(app) ?? 'system');
+        reportHeight(app);
+    };
 
     await app.connect();
     watchSize(app);
@@ -207,7 +218,7 @@ async function bootstrap(): Promise<void> {
 
     if (!mounted) {
         const fallback = readPayload();
-        if (fallback) mountFromPayload(fallback);
+        if (fallback) mountFromPayload(fallback, app);
     }
 }