nudge-ui 0.2.4 → 0.2.5

package/dist/hosts/next/wrapper.js

@@ -138,13 +138,7 @@ function instrumentConfig(config, options) {
     });
     const nextConfig = { ...source };
     // --- transpilePackages -------------------------------------------------
-    // Workspace Nudge UI packages ship raw TypeScript that SWC refuses to
-    // compile from node_modules unless listed (see feature-plan appendix).
-    const nudgeUiPackages = [
-        "nudge-ui",
-        "../../inspector/index.ts",
-        "../../css/index.ts",
-    ];
+    const nudgeUiPackages = ["nudge-ui"];
     const userTranspile = Array.isArray(source.transpilePackages)
         ? source.transpilePackages
         : [];

package/dist/hosts/projectBridge.js

@@ -6,10 +6,10 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname, join, parse } from "node:path";
+import { join } from "node:path";
 import { pathToFileURL } from "node:url";
+import { findProjectMcpRoot } from "../project/mcpPackage.js";
 const runningBridges = new Map();
 /** Starts the optional project bridge installed beside the host application. */
 export async function startOptionalProjectBridge(input) {
@@ -28,7 +28,7 @@ export async function startOptionalProjectBridge(input) {
 async function launchOptionalProjectBridge(input, key) {
     let modulePath;
     try {
-        if (!isPnpRuntime() && !hasProjectInstalledMcp(input.appRoot)) {
+        if (findProjectMcpRoot(input.appRoot) === null) {
             runningBridges.delete(key);
             return null;
         }
@@ -73,20 +73,6 @@ async function launchOptionalProjectBridge(input, key) {
         return null;
     }
 }
-function isPnpRuntime() {
-    return typeof process.versions.pnp === "string";
-}
-function hasProjectInstalledMcp(appRoot) {
-    let directory = appRoot;
-    const root = parse(directory).root;
-    for (;;) {
-        if (existsSync(join(directory, "node_modules", "@nudge-ui", "mcp", "package.json")))
-            return true;
-        if (directory === root)
-            return false;
-        directory = dirname(directory);
-    }
-}
 /** Returns the browser origin for a loopback HTTP server address. */
 export function loopbackOrigin(address, protocol = "http") {
     const host = address.address === "::" || address.address === "::1"

package/dist/inspector/agent/McpConnectionDialog.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useMemo, useRef, useState } from "react";
 import { Dialog } from "@base-ui/react/dialog";
 import { IconCheck, IconCopy, IconPlugConnected, IconRefresh, IconUnlink, IconX, } from "@tabler/icons-react";
-import { getAgentConnectionStatus } from "./connectionStatus.js";
+import { useAgentConnectionStatus } from "./connectionStatus.js";
 import { copyToClipboard } from "../prompt/copyToClipboard.js";
 import { Button } from "../ui/Button.js";
 import { Disclosure } from "../ui/Disclosure.js";
@@ -35,20 +35,24 @@ export function McpConnectionContent({ projectId, origin, snapshot, onConnect, o
         "Start the application normally. Reload the agent if needed, then listen to Nudge.",
     ].join("\n"), [setupCommand]);
     const doctorCommand = "nudge-ui agent doctor";
-    const status = getAgentConnectionStatus(snapshot);
+    const status = useAgentConnectionStatus(snapshot);
     const showConnectionStatus = status.kind !== "not-found"
         || Boolean(snapshot.error || checkError || snapshot.request?.summary || snapshot.request?.error);
     const canConnect = snapshot.companionReachable
         && !snapshot.paired
         && !snapshot.pairedElsewhere
         && snapshot.state !== "pairing"
+        && snapshot.state !== "delivered"
         && snapshot.state !== "working"
+        && snapshot.request?.status !== "delivered"
         && snapshot.request?.status !== "working";
-    const canDisconnect = snapshot.paired || snapshot.request?.status === "working";
+    const canDisconnect = snapshot.paired || snapshot.request?.status === "working" || snapshot.request?.status === "delivered";
     const canTakeOver = snapshot.companionReachable
         && snapshot.pairedElsewhere
         && snapshot.state !== "pairing"
+        && snapshot.state !== "delivered"
         && snapshot.state !== "working"
+        && snapshot.request?.status !== "delivered"
         && snapshot.request?.status !== "working";
     async function handleCheckAgain() {
         if (checking)

package/dist/inspector/agent/activity.d.ts

@@ -12,7 +12,7 @@ export interface AgentActivitySnapshot {
 /** Pins submitted frames before dispatch. Activity never selects or edits a draft. */
 export declare function beginActivityDispatch(projectId: string, dispatchId: string, targets: readonly string[], target?: DraftTarget): void;
 /** Dispatch and status are the only authority for the layer's lifetime. */
-export declare function synchronizeAgentActivity(projectId: string, requestId: string | undefined, working: boolean, dispatchId?: string): void;
+export declare function synchronizeAgentActivity(projectId: string, requestId: string | undefined, working: boolean, dispatchId?: string, awaitingAcknowledgment?: boolean): void;
 export declare function reportAgentActivity(projectId: string, activity: AgentActivity): void;
 export declare function getAgentActivity(projectId: string): AgentActivitySnapshot;
 export declare function useAgentActivity(projectId: string): AgentActivitySnapshot;

package/dist/inspector/agent/activity.js

@@ -19,13 +19,14 @@ export function beginActivityDispatch(projectId, dispatchId, targets, target) {
     project(projectId).dispatch = { id: dispatchId, targets: [...targets], target };
 }
 /** Dispatch and status are the only authority for the layer's lifetime. */
-export function synchronizeAgentActivity(projectId, requestId, working, dispatchId) {
+export function synchronizeAgentActivity(projectId, requestId, working, dispatchId, awaitingAcknowledgment = false) {
     const state = project(projectId);
     if (!working || !requestId) {
         if (state.timer)
             clearTimeout(state.timer);
         state.timer = undefined;
-        state.dispatch = undefined;
+        if (!awaitingAcknowledgment)
+            state.dispatch = undefined;
         if (state.snapshot !== EMPTY)
             publish(state, EMPTY);
         return;

package/dist/inspector/agent/client.d.ts

@@ -1,5 +1,5 @@
 import { type AgentBridgeTransport, type AgentClientOptions, type AgentSketchAttachment, type AgentSketchMetadata, type AgentRequestStatus, type AgentStatusSnapshot, type PromptDispatchResponse } from "./protocol.js";
-export type AgentClientState = "disabled" | "disconnected" | "available" | "pairing" | "connected" | "working" | "completed" | "failed" | "interrupted";
+export type AgentClientState = "disabled" | "disconnected" | "available" | "pairing" | "connected" | "delivered" | "working" | "completed" | "failed" | "interrupted";
 export interface AgentRequestSnapshot {
     readonly requestId: string;
     readonly changeRevision?: number;
@@ -80,7 +80,7 @@ export declare class AgentClient {
     private pairWith;
     private openEvents;
     /**
-     * Dispatches one immutable prompt revision. The request enters `working`
+     * Dispatches one immutable prompt revision. The request enters `delivered`
      * synchronously, before the transport promise resolves, so the UI cannot
      * issue a second prompt while the first one is in flight.
      */

package/dist/inspector/agent/client.js

@@ -3,7 +3,7 @@ import { useEffect, useMemo, useSyncExternalStore } from "react";
 import { isNudgeUiDev } from "../runtime/devFlag.js";
 import { isDemoRuntime } from "../runtime/runtimeConfig.js";
 import { AgentBridgeHttpError, HttpAgentBridgeTransport, shouldAutoConnectAgentBridge, } from "./httpTransport.js";
-import { AGENT_PROTOCOL_VERSION, } from "./protocol.js";
+import { AGENT_PROTOCOL_VERSION, deriveConnectionState, } from "./protocol.js";
 const DISABLED_SNAPSHOT = Object.freeze({
     state: "disabled",
     connection: "offline",
@@ -96,15 +96,6 @@ function setAutoConnectDisabled(projectId, disabled) {
         // the explicit disconnect preference in memory.
     }
 }
-function statusForConnection(status) {
-    if (status.connection === "working" || status.request?.status === "working")
-        return "working";
-    if (status.paired)
-        return "paired";
-    if (status.listenerActive)
-        return "listening";
-    return "offline";
-}
 function hashRevision(value) {
     // FNV-1a is sufficient here: the revision is an opaque, bounded identity
     // used to prevent a later browser edit from being mistaken for the sent
@@ -316,7 +307,7 @@ export class AgentClient {
             return false;
         this.autoConnectSuppressed = false;
         setAutoConnectDisabled(this.projectId, false);
-        if (this.connection === "working" || this.activeRequest?.status === "working")
+        if (this.connection === "working" || this.connection === "delivered" || this.activeRequest?.status === "working" || this.activeRequest?.status === "delivered")
             return false;
         const idleListenerActive = this.listenerActive;
         const idleCompanionReachable = this.companionReachable;
@@ -398,14 +389,14 @@ export class AgentClient {
         }
     }
     /**
-     * Dispatches one immutable prompt revision. The request enters `working`
+     * Dispatches one immutable prompt revision. The request enters `delivered`
      * synchronously, before the transport promise resolves, so the UI cannot
      * issue a second prompt while the first one is in flight.
      */
     async dispatchPrompt(prompt, changeRevision, options = {}) {
         if (!this.enabled || !this.started || !this.paired || !this.listenerActive || !this.sessionToken)
             return null;
-        if (!prompt || this.activeRequest?.status === "working")
+        if (!prompt || this.activeRequest?.status === "working" || this.activeRequest?.status === "delivered")
             return null;
         const localRequestId = randomId("request");
         const request = {
@@ -424,9 +415,9 @@ export class AgentClient {
             ...(changeRevision === undefined ? {} : { changeRevision }),
             ...(options.clientDispatchId === undefined ? {} : { clientDispatchId: options.clientDispatchId }),
             ...(sketches === undefined ? {} : { sketches }),
-            status: "working",
+            status: "delivered",
         };
-        this.connection = "working";
+        this.connection = "delivered";
         this.lastError = undefined;
         this.publish();
         const abortController = new AbortController();
@@ -445,8 +436,9 @@ export class AgentClient {
                     }
                     : this.activeRequest;
             }
-            if (response?.status && response.status !== "working") {
+            if (response?.status) {
                 this.applyRequestStatus(response.status, response.request.requestId);
+                this.publish();
             }
             return response ?? null;
         }
@@ -471,7 +463,7 @@ export class AgentClient {
             setAutoConnectDisabled(this.projectId, true);
         const token = this.sessionToken;
         const active = this.activeRequest;
-        if (active?.status === "working") {
+        if (active?.status === "working" || active?.status === "delivered") {
             this.activeRequest = { ...active, status: "interrupted", error: reason };
         }
         this.dispatchAbort?.abort();
@@ -518,7 +510,7 @@ export class AgentClient {
                 }
                 else {
                     this.companionReachable = true;
-                    if (this.connection !== "paired" && this.connection !== "working" && !this.pairingAbort) {
+                    if (this.connection !== "paired" && this.connection !== "working" && this.connection !== "delivered" && !this.pairingAbort) {
                         // Discovery is unauthenticated. Another browser tab can own the
                         // pairing, so do not adopt `paired` until this tab restores the
                         // shared token. The next poll runs restore first in case a sibling
@@ -538,7 +530,7 @@ export class AgentClient {
                     }
                 }
             }
-            else if (this.connection !== "paired" && this.connection !== "working" && !this.pairingAbort) {
+            else if (this.connection !== "paired" && this.connection !== "working" && this.connection !== "delivered" && !this.pairingAbort) {
                 this.connection = "offline";
                 this.listenerActive = false;
                 this.companionReachable = false;
@@ -549,7 +541,7 @@ export class AgentClient {
             }
         }
         catch (error) {
-            if (!abortController.signal.aborted && this.started && this.connection !== "paired" && this.connection !== "working" && !this.pairingAbort) {
+            if (!abortController.signal.aborted && this.started && this.connection !== "paired" && this.connection !== "working" && this.connection !== "delivered" && !this.pairingAbort) {
                 this.connection = "offline";
                 this.listenerActive = false;
                 this.companionReachable = false;
@@ -658,7 +650,7 @@ export class AgentClient {
         this.agentClientName = status.agentClientName;
         this.paired = status.paired;
         this.pairedElsewhere = pairedElsewhere;
-        this.connection = statusForConnection(status);
+        this.connection = deriveConnectionState(status);
         if (status.paired && this.discoveryTimer !== null) {
             clearTimeout(this.discoveryTimer);
             this.discoveryTimer = null;
@@ -666,16 +658,16 @@ export class AgentClient {
         if (status.request) {
             this.applyRequestStatus(status.request.status, status.request.requestId, status.request.summary, status.request.error, status.request.changeRevision, status.request.clientDispatchId, status.request.sketches);
         }
-        else if (status.listenerActive && status.paired && this.activeRequest?.status !== "working") {
+        else if (status.listenerActive && status.paired && this.activeRequest?.status !== "working" && this.activeRequest?.status !== "delivered") {
             // A re-armed MCP listen call is the lifecycle boundary for the previous
             // terminal request. Drop only that terminal status; newer edits remain
             // in the inspector's canonical change log.
             this.activeRequest = null;
         }
-        else if (this.activeRequest?.status === "working" && status.connection !== "working") {
+        else if ((this.activeRequest?.status === "working" || this.activeRequest?.status === "delivered") && status.connection !== this.activeRequest.status) {
             // The bridge may omit a request during a brief re-arm transition. Do
             // not mark a local request interrupted until the stream disconnects.
-            this.connection = "working";
+            this.connection = this.activeRequest.status;
         }
         if (!status.paired && this.sessionToken) {
             this.handleDisconnect("The agent bridge pairing expired.");
@@ -695,10 +687,15 @@ export class AgentClient {
     }
     applyRequestStatus(status, requestId, summary, error, changeRevision, clientDispatchId, sketches) {
         const active = this.activeRequest;
+        // A dispatch response can arrive after an SSE acknowledgment or outcome.
+        if (status === "delivered" && active && active.status !== "delivered") {
+            this.connection = active.status === "working" ? "working" : this.paired ? "paired" : "offline";
+            return;
+        }
         if (active && active.requestId !== requestId && active.localRequestId !== requestId) {
             // A fresh server id can arrive before the POST response. Associate it
-            // with the one local request that was just marked working.
-            if (active.status !== "working")
+            // with the one local request awaiting acknowledgment.
+            if (active.status !== "working" && active.status !== "delivered")
                 return;
             this.activeRequest = { ...active, requestId };
         }
@@ -727,8 +724,8 @@ export class AgentClient {
                 ...(error === undefined ? {} : { error }),
             };
         }
-        if (status === "working")
-            this.connection = "working";
+        if (status === "working" || status === "delivered")
+            this.connection = status;
         else if (this.paired)
             this.connection = "paired";
     }
@@ -784,6 +781,8 @@ export class AgentClient {
             return "disconnected";
         if (this.connection === "listening")
             return "available";
+        if (this.connection === "delivered" || this.activeRequest?.status === "delivered")
+            return "delivered";
         if (this.connection === "working" || this.activeRequest?.status === "working")
             return "working";
         if (this.activeRequest?.status === "completed")
@@ -796,7 +795,7 @@ export class AgentClient {
     }
     publish(stateOverride) {
         this.snapshot = Object.freeze(this.makeSnapshot(stateOverride));
-        synchronizeAgentActivity(this.projectId, this.snapshot.request?.requestId, this.snapshot.paired && this.snapshot.request?.status === "working", this.snapshot.request?.clientDispatchId);
+        synchronizeAgentActivity(this.projectId, this.snapshot.request?.requestId, this.snapshot.paired && this.snapshot.request?.status === "working", this.snapshot.request?.clientDispatchId, this.snapshot.paired && this.snapshot.request?.status === "delivered");
         for (const listener of this.listeners)
             listener();
     }

package/dist/inspector/agent/connectionStatus.d.ts

@@ -1,5 +1,5 @@
 import type { AgentClientSnapshot } from "./client.js";
-export type AgentConnectionStatusKind = "unavailable" | "connecting" | "working-disconnected" | "working" | "paired-elsewhere" | "not-found" | "ready-to-connect" | "connected-not-listening" | "listening";
+export type AgentConnectionStatusKind = "unavailable" | "connecting" | "delivered" | "delivered-disconnected" | "working-disconnected" | "working" | "paired-elsewhere" | "not-found" | "ready-to-connect" | "connected" | "connected-not-listening" | "listening";
 export interface AgentConnectionStatus {
     readonly kind: AgentConnectionStatusKind;
     readonly label: string;
@@ -11,3 +11,5 @@ export interface AgentConnectionStatus {
 }
 /** Returns the user-facing connection state shared by the prompt UI and MCP panel. */
 export declare function getAgentConnectionStatus(snapshot: AgentClientSnapshot): AgentConnectionStatus;
+/** Gives the agent time to rearm after completing a request before showing a reminder. */
+export declare function useAgentConnectionStatus(snapshot: AgentClientSnapshot): AgentConnectionStatus;

package/dist/inspector/agent/connectionStatus.js

@@ -1,3 +1,4 @@
+import { useEffect, useState } from "react";
 /** Returns the user-facing connection state shared by the prompt UI and MCP panel. */
 export function getAgentConnectionStatus(snapshot) {
     if (snapshot.state === "disabled") {
@@ -14,6 +15,11 @@ export function getAgentConnectionStatus(snapshot) {
             action: { kind: "takeover", label: "Take over" },
         };
     }
+    if (snapshot.state === "delivered" || snapshot.request?.status === "delivered") {
+        return snapshot.paired
+            ? { kind: "delivered", label: "Connected · Awaiting agent acknowledgment", tone: "accent" }
+            : { kind: "delivered-disconnected", label: "Disconnected · Agent acknowledgment unknown", tone: "warning" };
+    }
     if (!snapshot.paired && (snapshot.state === "working" || snapshot.request?.status === "working")) {
         return { kind: "working-disconnected", label: "Disconnected · Last work status unknown", tone: "warning" };
     }
@@ -40,3 +46,22 @@ export function getAgentConnectionStatus(snapshot) {
         action: { kind: "connect", label: "Connect" },
     };
 }
+/** Gives the agent time to rearm after completing a request before showing a reminder. */
+export function useAgentConnectionStatus(snapshot) {
+    const status = getAgentConnectionStatus(snapshot);
+    const completedRequestId = status.kind === "connected-not-listening" && snapshot.request?.status === "completed"
+        ? snapshot.request.requestId
+        : undefined;
+    const [reminderRequestId, setReminderRequestId] = useState();
+    useEffect(() => {
+        setReminderRequestId(undefined);
+        if (!completedRequestId)
+            return;
+        const timeout = setTimeout(() => setReminderRequestId(completedRequestId), 5_000);
+        return () => clearTimeout(timeout);
+    }, [completedRequestId]);
+    if (completedRequestId && reminderRequestId !== completedRequestId) {
+        return { kind: "connected", label: "MCP connected", tone: "accent" };
+    }
+    return status;
+}