nudge-ui 0.2.5 → 0.2.6

package/dist/inspector/agent/McpConnectionDialog.js

@@ -104,12 +104,7 @@ export function McpConnectionContent({ projectId, origin, snapshot, onConnect, o
     }
     return (_jsxs(_Fragment, { children: [showConnectionStatus ? (_jsxs(StatusCallout, { className: "mcp-connection__status", tone: status.tone, "data-test": "mcp-connection-status", children: [_jsx("span", { className: "mcp-connection__status-label", role: "status", children: status.label }), snapshot.error ? (_jsx("span", { className: "mcp-connection__status-detail", children: snapshot.error })) : null, checkError ? _jsx("span", { role: "alert", children: checkError }) : null, snapshot.request?.summary ? (_jsx("span", { className: "mcp-connection__status-detail", children: snapshot.request.summary })) : null, snapshot.request?.error ? (_jsx("span", { className: "mcp-connection__status-detail", children: snapshot.request.error })) : null] })) : null, _jsxs("ol", { className: "mcp-connection__timeline", "data-test": "mcp-connection-timeline", children: [_jsxs(TimelineStep, { number: 1, complete: snapshot.companionReachable || snapshot.listenerActive || snapshot.request !== null, title: "Set up agent", children: [_jsx("p", { className: "mcp-connection__copy", children: "Agent prompt" }), _jsxs("div", { className: "mcp-connection__command-block", children: [_jsx(IconButton, { className: "mcp-connection__copy-button", variant: "quiet", size: "compact", label: copiedPrompt ? "Copied" : "Copy setup instructions", "data-test": "mcp-copy-setup-prompt", onClick: () => void handleCopyPrompt(), children: copiedPrompt ? _jsx(IconCheck, { size: 16, "aria-hidden": "true" }) : _jsx(IconCopy, { size: 16, "aria-hidden": "true" }) }), _jsx("pre", { className: "mcp-connection__command", children: _jsx("code", { "data-test": "mcp-setup-prompt", children: setupPrompt }) })] }), _jsx("p", { className: "mcp-connection__copy", children: "Or, terminal command" }), _jsxs("div", { className: "mcp-connection__command-block", children: [_jsx(IconButton, { className: "mcp-connection__copy-button", variant: "quiet", size: "compact", label: copiedCommand ? "Copied" : "Copy command", "data-test": "mcp-copy-command", onClick: () => void handleCopyCommand(), children: copiedCommand ? _jsx(IconCheck, { size: 16, "aria-hidden": "true" }) : _jsx(IconCopy, { size: 16, "aria-hidden": "true" }) }), _jsx("pre", { className: "mcp-connection__command", children: _jsx("code", { "data-test": "mcp-setup-command", children: setupCommand }) })] })] }), _jsx(TimelineStep, { number: 2, complete: snapshot.listenerActive, title: "Tell agent to listen for instructions", children: _jsx("p", { className: "mcp-connection__copy", children: "Tell your coding agent: \u201CListen to Nudge.\u201D" }) })] }), _jsxs(Disclosure, { className: "mcp-connection__details", title: "Troubleshooting", defaultOpen: true, children: [_jsx("p", { className: "mcp-connection__copy", children: "To diagnose setup" }), _jsxs("div", { className: "mcp-connection__command-block", children: [_jsx(IconButton, { className: "mcp-connection__copy-button", variant: "quiet", size: "compact", label: copiedDoctor ? "Copied" : "Copy diagnostic command", "data-test": "mcp-copy-doctor", onClick: () => void handleCopyDoctor(), children: copiedDoctor ? _jsx(IconCheck, { size: 16, "aria-hidden": "true" }) : _jsx(IconCopy, { size: 16, "aria-hidden": "true" }) }), _jsx("pre", { className: "mcp-connection__command", children: _jsx("code", { children: doctorCommand }) })] }), _jsxs("dl", { className: "mcp-connection__diagnostics", "data-test": "mcp-connection-diagnostics", children: [_jsxs("div", { className: "mcp-connection__diagnostic", children: [_jsx("dt", { children: "Project ID" }), _jsx("dd", { "data-test": "mcp-project-id", children: projectId })] }), _jsxs("div", { className: "mcp-connection__diagnostic", children: [_jsx("dt", { children: "Origin" }), _jsx("dd", { "data-test": "mcp-origin", children: origin })] })] }), _jsxs("div", { className: "mcp-connection__actions", children: [canTakeOver ? (_jsxs(Button, { variant: "primary", "data-test": "mcp-takeover", type: "button", onClick: () => void onTakeOver(), children: [_jsx(IconPlugConnected, { size: "var(--icon-size-small)", stroke: 1.8, "aria-hidden": "true" }), "Take over"] })) : null, canConnect ? (_jsxs(Button, { variant: "primary", "data-test": "mcp-connect", type: "button", onClick: () => void onConnect(), children: [_jsx(IconPlugConnected, { size: "var(--icon-size-small)", stroke: 1.8, "aria-hidden": "true" }), "Connect"] })) : null, _jsxs(Button, { variant: "quiet", "data-test": "mcp-check-again", type: "button", disabled: checking || snapshot.state === "disabled" || snapshot.state === "pairing", onClick: () => void handleCheckAgain(), children: [_jsx(IconRefresh, { size: "var(--icon-size-small)", stroke: 1.8, "aria-hidden": "true" }), checking ? "Checking…" : "Refresh connection"] }), canDisconnect ? (_jsxs(Button, { variant: "danger", "data-test": "mcp-disconnect", type: "button", onClick: onDisconnect, children: [_jsx(IconUnlink, { size: "var(--icon-size-small)", stroke: 1.8, "aria-hidden": "true" }), snapshot.paired ? "Disconnect" : "Forget connection"] })) : null] })] }), copyError ? _jsx("p", { className: "mcp-connection__error", role: "alert", children: copyError }) : null] }));
 }
-/**
- * Explains and controls the project-scoped MCP companion connection.
- *
- * This compatibility wrapper keeps the existing standalone MCP surface while
- * the shared content is also embedded in the general settings modal.
- */
+/** Compatibility wrapper: the shared content is also embedded in the general settings modal. */
 export function McpConnectionDialog({ open, projectId, origin, snapshot, onOpenChange, onConnect, onTakeOver, onDisconnect, onCheckAgain, }) {
     const closeRef = useRef(null);
     return (_jsx(Dialog.Root, { open: open, onOpenChange: onOpenChange, children: _jsxs(Dialog.Portal, { container: portalContainer(), children: [_jsx(Dialog.Backdrop, { className: "mcp-connection__backdrop", "data-test": "mcp-connection-backdrop" }), _jsxs(Dialog.Popup, { className: "mcp-connection__popup", "data-test": "mcp-connection-dialog", initialFocus: closeRef, children: [_jsxs("div", { className: "mcp-connection__header", children: [_jsxs("div", { children: [_jsx(Dialog.Title, { className: "mcp-connection__title", children: "Connect MCP" }), _jsx(Dialog.Description, { className: "mcp-connection__description", children: "Set up your coding agent once, then ask it to listen to Nudge in this worktree." })] }), _jsx(Dialog.Close, { ref: closeRef, className: "icon-button icon-button--quiet mcp-connection__close", "aria-label": "Close MCP connection", "data-test": "mcp-connection-close", type: "button", children: _jsx(IconX, { size: "var(--icon-size-small)", stroke: 1.8, "aria-hidden": "true" }) })] }), _jsx(McpConnectionContent, { projectId: projectId, origin: origin, snapshot: snapshot, onConnect: onConnect, onTakeOver: onTakeOver, onDisconnect: onDisconnect, onCheckAgain: onCheckAgain })] })] }) }));

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

@@ -9,7 +9,7 @@ export interface AgentActivitySnapshot {
     readonly target?: DraftTarget;
     readonly files: readonly ActivityFile[];
 }
-/** Pins submitted frames before dispatch. Activity never selects or edits a draft. */
+/** 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, awaitingAcknowledgment?: boolean): void;

package/dist/inspector/agent/activity.js

@@ -14,7 +14,7 @@ function publish(state, snapshot) {
     for (const listener of state.listeners)
         listener();
 }
-/** Pins submitted frames before dispatch. Activity never selects or edits a draft. */
+/** Pins submitted frames before dispatch; activity never selects or edits a draft. */
 export function beginActivityDispatch(projectId, dispatchId, targets, target) {
     project(projectId).dispatch = { id: dispatchId, targets: [...targets], target };
 }

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

@@ -16,23 +16,14 @@ export interface AgentClientSnapshot {
     readonly connection: AgentStatusSnapshot["connection"];
     readonly listenerActive: boolean;
     readonly agentClientName?: string;
-    /** Whether the last valid discovery response came from the local companion. */
     readonly companionReachable: boolean;
     readonly paired: boolean;
-    /** Whether another browser currently owns this project's pairing. */
     readonly pairedElsewhere: boolean;
     readonly request: AgentRequestSnapshot | null;
     readonly error?: string;
 }
-/** Creates a stable numeric revision for one prompt snapshot. */
 export declare function createPromptRevision(changes: readonly unknown[], structuralChanges?: readonly unknown[], sketches?: readonly unknown[]): number;
-/**
- * Browser-side companion client.
- *
- * Discovery is deliberately started by `start()`, which is guarded by the
- * dev-only flag. Constructing this class never opens a socket or performs a
- * network request, so importing the inspector remains inert in production.
- */
+/** Construction never touches the network; discovery starts only from the dev-flag-guarded start(). */
 export declare class AgentClient {
     readonly projectId: string;
     readonly origin: string;
@@ -60,35 +51,23 @@ export declare class AgentClient {
     private readonly autoConnect;
     private autoConnectSuppressed;
     constructor(options: AgentClientOptions);
-    /** Installs the controller callback used to acknowledge Canvas commands. */
     setCanvasCommandHandler(handler: AgentClientOptions["canvasCommandHandler"]): void;
     getSnapshot: () => AgentClientSnapshot;
     subscribe: (listener: () => void) => (() => void);
-    /** Starts loopback discovery. Calling it repeatedly is idempotent. */
     start(): void;
-    /** Stops discovery and closes the browser event stream. */
     stop(): void;
     private restoreOrDiscover;
-    /** Runs an immediate authenticated restore or companion discovery probe. */
     checkConnection(): Promise<void>;
-    /** Triggers a new discovery probe after a connection loss. */
     reconnect(): void;
-    /** Pairs the browser with a reachable companion, including an idle agent. */
     connect(): Promise<boolean>;
-    /** Replaces an existing browser pairing after an explicit user action. */
     takeOver(): Promise<boolean>;
     private pairWith;
     private openEvents;
-    /**
-     * 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.
-     */
+    /** Enters `delivered` synchronously so the UI cannot dispatch a second prompt while the first is in flight. */
     dispatchPrompt(prompt: string, changeRevision?: number, options?: {
         readonly clientDispatchId?: string;
         readonly attachments?: readonly AgentSketchAttachment[];
     }): Promise<PromptDispatchResponse | null>;
-    /** Interrupts local request state and asks the companion to revoke pairing. */
     disconnect(reason?: string): void;
     private discover;
     private scheduleDiscovery;
@@ -103,11 +82,8 @@ export declare class AgentClient {
     private deriveState;
     private publish;
 }
-/** Sets a host/test transport for subsequently created project clients. */
 export declare function configureAgentBridgeTransport(transport: AgentBridgeTransport | undefined): void;
-/** Clears cached clients and their active streams. */
 export declare function resetAgentClients(): void;
 export declare function createAgentClient(options: AgentClientOptions): AgentClient;
 export declare function getAgentClient(projectId: string, options?: Omit<AgentClientOptions, "projectId">): AgentClient;
-/** React hook used by the inspector handoff control. */
 export declare function useAgentClient(projectId: string, suppliedClient?: AgentClient): AgentClientSnapshot;

package/dist/inspector/agent/client.js

@@ -57,8 +57,7 @@ function writeStoredSession(session) {
         localStorage.setItem(sessionStorageKey(session.projectId), JSON.stringify(session));
     }
     catch {
-        // Storage can be disabled by browser privacy settings. The in-memory
-        // pairing remains valid for this document in that case.
+        // Storage can be disabled by browser privacy settings; the in-memory pairing stays valid.
     }
 }
 function clearStoredSession(projectId) {
@@ -92,15 +91,11 @@ function setAutoConnectDisabled(projectId, disabled) {
             localStorage.removeItem(key);
     }
     catch {
-        // Privacy settings can disable storage. The current document still keeps
-        // the explicit disconnect preference in memory.
+        // Storage can be disabled; the disconnect preference stays in memory for this document.
     }
 }
 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
-    // canonical change set. Keep it in the safe-integer range accepted by the
-    // companion protocol.
+    // Opaque bounded identity, kept in the safe-integer range the companion protocol accepts.
     let hash = 2_166_136_261;
     for (let index = 0; index < value.length; index += 1) {
         hash ^= value.charCodeAt(index);
@@ -108,7 +103,6 @@ function hashRevision(value) {
     }
     return (hash >>> 0) & 0x7fff_ffff;
 }
-/** Creates a stable numeric revision for one prompt snapshot. */
 export function createPromptRevision(changes, structuralChanges = [], sketches = []) {
     let serialized;
     try {
@@ -119,13 +113,7 @@ export function createPromptRevision(changes, structuralChanges = [], sketches =
     }
     return hashRevision(serialized);
 }
-/**
- * Browser-side companion client.
- *
- * Discovery is deliberately started by `start()`, which is guarded by the
- * dev-only flag. Constructing this class never opens a socket or performs a
- * network request, so importing the inspector remains inert in production.
- */
+/** Construction never touches the network; discovery starts only from the dev-flag-guarded start(). */
 export class AgentClient {
     projectId;
     origin;
@@ -160,12 +148,10 @@ export class AgentClient {
         this.canvasCommandHandler = options.canvasCommandHandler;
         this.autoConnect = options.autoConnect ?? shouldAutoConnectAgentBridge();
         this.autoConnectSuppressed = this.autoConnect && autoConnectDisabled(this.projectId);
-        // The public demo renders the real inspector but intentionally keeps the
-        // local MCP/agent bridge inert.
+        // The public demo renders the real inspector but intentionally keeps the local MCP/agent bridge inert.
         this.enabled = isNudgeUiDev() && !isDemoRuntime();
         this.snapshot = this.enabled ? this.makeSnapshot() : DISABLED_SNAPSHOT;
     }
-    /** Installs the controller callback used to acknowledge Canvas commands. */
     setCanvasCommandHandler(handler) {
         this.canvasCommandHandler = handler;
     }
@@ -174,14 +160,12 @@ export class AgentClient {
         this.listeners.add(listener);
         return () => this.listeners.delete(listener);
     };
-    /** Starts loopback discovery. Calling it repeatedly is idempotent. */
     start() {
         if (!this.enabled || this.started)
             return;
         this.started = true;
         void this.restoreOrDiscover();
     }
-    /** Stops discovery and closes the browser event stream. */
     stop() {
         if (!this.started && !this.eventSubscription)
             return;
@@ -198,10 +182,7 @@ export class AgentClient {
         this.dispatchAbort = null;
         this.eventSubscription?.close();
         this.eventSubscription = null;
-        // `stop` is used by React effect cleanup and page remounts. Keep the
-        // request and ephemeral token in memory/storage so a still-running
-        // companion can be resumed; explicit `disconnect()` is the revocation
-        // and interruption path.
+        // Keep the request and token so a remount can resume; disconnect() is the revocation path.
         this.connection = "offline";
         this.listenerActive = false;
         this.companionReachable = false;
@@ -240,8 +221,7 @@ export class AgentClient {
             catch (error) {
                 if (abortController.signal.aborted || !this.started)
                     return;
-                // A stale or revoked token is not a connection error. Clearing it
-                // lets the normal listener discovery path offer a fresh pairing.
+                // A stale or revoked token is not a connection error; clearing it lets discovery offer a fresh pairing.
                 clearStoredSession(this.projectId);
                 this.sessionToken = null;
                 this.resetForDiscovery();
@@ -254,7 +234,6 @@ export class AgentClient {
         }
         await this.discover();
     }
-    /** Runs an immediate authenticated restore or companion discovery probe. */
     async checkConnection() {
         if (!this.enabled)
             return;
@@ -270,7 +249,6 @@ export class AgentClient {
         this.publish();
         await this.restoreOrDiscover();
     }
-    /** Triggers a new discovery probe after a connection loss. */
     reconnect() {
         if (!this.enabled)
             return;
@@ -292,11 +270,9 @@ export class AgentClient {
         this.publish();
         void this.restoreOrDiscover();
     }
-    /** Pairs the browser with a reachable companion, including an idle agent. */
     async connect() {
         return this.pairWith((request, signal) => this.transport.pair(request, signal));
     }
-    /** Replaces an existing browser pairing after an explicit user action. */
     async takeOver() {
         if (!this.transport.takeOver)
             return false;
@@ -388,11 +364,7 @@ export class AgentClient {
             this.handleDisconnect(errorMessage(error, "The agent event stream could not be opened."));
         }
     }
-    /**
-     * 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.
-     */
+    /** Enters `delivered` synchronously so the UI cannot dispatch a second prompt while the first is in flight. */
     async dispatchPrompt(prompt, changeRevision, options = {}) {
         if (!this.enabled || !this.started || !this.paired || !this.listenerActive || !this.sessionToken)
             return null;
@@ -456,7 +428,6 @@ export class AgentClient {
                 this.dispatchAbort = null;
         }
     }
-    /** Interrupts local request state and asks the companion to revoke pairing. */
     disconnect(reason = "browser_disconnected") {
         this.autoConnectSuppressed = true;
         if (this.autoConnect)
@@ -511,10 +482,7 @@ export class AgentClient {
                 else {
                     this.companionReachable = true;
                     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
-                        // tab has just stored that token.
+                        // Discovery is unauthenticated; do not adopt `paired` until this tab restores the shared token.
                         const pairedElsewhere = status.paired && !this.sessionToken;
                         this.applyStatus(status.paired ? {
                             ...status,
@@ -547,8 +515,7 @@ export class AgentClient {
                 this.companionReachable = false;
                 this.paired = false;
                 this.pairedElsewhere = false;
-                // Discovery failures are expected while the companion is not running;
-                // retain a quiet disconnected state rather than flashing an error.
+                // Discovery failures are expected while the companion is down; stay quietly disconnected.
                 this.lastError = undefined;
                 this.publish();
             }
@@ -616,10 +583,7 @@ export class AgentClient {
                 },
             };
         }
-        // Every tab with the shared browser session receives the SSE command, but
-        // only the Canvas lease owner may answer it. A read-only tab reports this
-        // local sentinel; leave the command pending for the owning tab instead of
-        // racing its acknowledgement with a false failure.
+        // Every tab receives the SSE command but only the Canvas lease owner may answer; leave it pending for that tab.
         if (!acknowledgement.ok && acknowledgement.error?.code === "workspace-locked")
             return;
         if (acknowledgement.commandId !== command.commandId) {
@@ -639,8 +603,7 @@ export class AgentClient {
             await this.transport.acknowledgeCanvasCommand(request);
         }
         catch {
-            // A command acknowledgement is best effort. The companion owns the
-            // bounded timeout and reports any expired command to its agent host.
+            // Acknowledgement is best effort; the companion owns the timeout.
         }
     }
     applyStatus(status, pairedElsewhere = false) {
@@ -659,14 +622,11 @@ export class AgentClient {
             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" && 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.
+            // A re-armed listen call ends the previous terminal request; newer edits stay in the canonical change log.
             this.activeRequest = null;
         }
         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.
+            // A brief re-arm can omit the request; do not mark it interrupted until the stream disconnects.
             this.connection = this.activeRequest.status;
         }
         if (!status.paired && this.sessionToken) {
@@ -693,8 +653,7 @@ export class AgentClient {
             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 awaiting acknowledgment.
+            // A fresh server id can arrive before the POST response; associate it with the local request.
             if (active.status !== "working" && active.status !== "delivered")
                 return;
             this.activeRequest = { ...active, requestId };
@@ -732,9 +691,7 @@ export class AgentClient {
     handleDisconnect(reason = "The agent connection was lost.") {
         this.eventSubscription?.close();
         this.eventSubscription = null;
-        // An SSE disconnect is not proof that the coding request stopped. Keep
-        // its last known state until an authenticated status restore says
-        // otherwise. Explicit browser disconnect remains the interruption path.
+        // An SSE disconnect is not proof the request stopped; keep its last known state until an authenticated restore says otherwise.
         this.connection = "offline";
         this.listenerActive = false;
         this.companionReachable = false;
@@ -742,8 +699,7 @@ export class AgentClient {
         this.pairedElsewhere = false;
         this.lastError = reason;
         if (reason === "browser_disconnected") {
-            // A remote takeover deliberately invalidates this browser's token. Do
-            // not immediately race the new browser by auto-pairing again.
+            // A remote takeover invalidates this token; do not race the new browser by auto-pairing.
             this.autoConnectSuppressed = true;
             if (this.autoConnect)
                 setAutoConnectDisabled(this.projectId, true);
@@ -803,7 +759,6 @@ export class AgentClient {
 let configuredTransport;
 const clients = new Map();
 const consumerCounts = new Map();
-/** Sets a host/test transport for subsequently created project clients. */
 export function configureAgentBridgeTransport(transport) {
     for (const client of clients.values())
         client.stop();
@@ -811,7 +766,6 @@ export function configureAgentBridgeTransport(transport) {
     consumerCounts.clear();
     configuredTransport = transport;
 }
-/** Clears cached clients and their active streams. */
 export function resetAgentClients() {
     for (const client of clients.values())
         client.stop();
@@ -846,7 +800,6 @@ export function getAgentClient(projectId, options = {}) {
     }
     return client;
 }
-/** React hook used by the inspector handoff control. */
 export function useAgentClient(projectId, suppliedClient) {
     const client = useMemo(() => suppliedClient ?? getAgentClient(projectId), [projectId, suppliedClient]);
     useEffect(() => {

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

@@ -9,7 +9,6 @@ export interface AgentConnectionStatus {
         readonly label: "Connect" | "Take over";
     };
 }
-/** 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,5 +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") {
         return { kind: "unavailable", label: "Unavailable in this build", tone: "neutral" };

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

@@ -1,18 +1,10 @@
 import { type AgentBridgeTransport, type AgentBridgeEndpointConfig, type AgentDiscoveryRequest, type AgentEventHandlers, type AgentEventSubscription, type AgentEventsRequest, type AgentPairRequest, type AgentPromptDispatch, type AgentDisconnectRequest, type AgentCanvasAcknowledgementRequest, type AgentSessionRequest, type AgentStatusSnapshot, type PairingResponse, type PromptDispatchResponse } from "./protocol.js";
-/** Returns whether the dev host supplied a trusted project bridge endpoint. */
 export declare function shouldAutoConnectAgentBridge(): boolean;
 export declare class AgentBridgeHttpError extends Error {
     readonly status: number;
     readonly code?: string;
     constructor(status: number, message: string, code?: string);
 }
-/**
- * HTTP/SSE browser adapter for the companion's canonical endpoints.
- *
- * The adapter is inert when no endpoint is configured. A host can publish an
- * endpoint with `window.__NUDGE_UI_AGENT_BRIDGE__` or the meta tag named
- * `nudge-ui-agent-bridge`; tests can inject a transport directly instead.
- */
 export declare class HttpAgentBridgeTransport implements AgentBridgeTransport {
     private readonly config;
     constructor(config?: AgentBridgeEndpointConfig);

package/dist/inspector/agent/httpTransport.js

@@ -1,4 +1,4 @@
-import { AGENT_PROTOCOL_VERSION, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, } from "./protocol.js";
+import { AGENT_PROTOCOL_VERSION, BRIDGE_ENDPOINTS, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, } from "./protocol.js";
 import { getActiveCanvasDocument } from "../canvas/activeCanvasDocument.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -43,7 +43,6 @@ function configuredEndpoint() {
     const previewDocument = getActiveCanvasDocument();
     return previewDocument ? configuredEndpointInDocument(previewDocument) : undefined;
 }
-/** Returns whether the dev host supplied a trusted project bridge endpoint. */
 export function shouldAutoConnectAgentBridge() {
     return configuredEndpoint()?.autoConnect === true;
 }
@@ -64,8 +63,7 @@ function safeUrl(value, origin) {
         const url = new URL(value, origin);
         if (url.protocol !== "http:" && url.protocol !== "https:")
             return null;
-        // A same-origin reverse proxy is valid; a separately hosted bridge must
-        // remain loopback-only to match ADR-0013.
+        // A separately hosted bridge must remain loopback-only; a same-origin reverse proxy is valid.
         if (url.origin !== origin && !isLoopback(url.hostname))
             return null;
         return url;
@@ -107,45 +105,23 @@ export class AgentBridgeHttpError extends Error {
     }
 }
 async function readJson(response) {
-    let payload;
-    try {
-        payload = await response.json();
-    }
-    catch {
-        payload = {};
-    }
+    const body = await response.json().catch(() => null);
+    const payload = isRecord(body) ? body : {};
     if (!response.ok) {
-        const error = isRecord(payload) && isRecord(payload.error) ? payload.error : payload;
+        const error = isRecord(payload.error) ? payload.error : payload;
         const message = isRecord(error) ? stringValue(error.message) : undefined;
         const code = isRecord(error) ? stringValue(error.code) : undefined;
         throw new AgentBridgeHttpError(response.status, message ?? `Agent bridge request failed (${response.status}).`, code);
     }
-    return isRecord(payload) ? payload : {};
+    return payload;
 }
-function eventData(event) {
-    if (typeof event.data !== "string")
-        return event.data;
-    try {
-        return JSON.parse(event.data);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * HTTP/SSE browser adapter for the companion's canonical endpoints.
- *
- * The adapter is inert when no endpoint is configured. A host can publish an
- * endpoint with `window.__NUDGE_UI_AGENT_BRIDGE__` or the meta tag named
- * `nudge-ui-agent-bridge`; tests can inject a transport directly instead.
- */
 export class HttpAgentBridgeTransport {
     config;
     constructor(config = configuredEndpoint() ?? {}) {
         this.config = config;
     }
     async discover(request, signal) {
-        const url = endpointUrl(this.config, "healthUrl", "/health", pageOrigin());
+        const url = endpointUrl(this.config, "healthUrl", BRIDGE_ENDPOINTS.health, pageOrigin());
         if (!url || typeof fetch !== "function")
             return null;
         const response = await fetch(withQuery(url, {
@@ -163,7 +139,7 @@ export class HttpAgentBridgeTransport {
         return decodeAgentStatusSnapshot(payload.status);
     }
     async pair(request, signal) {
-        const url = endpointUrl(this.config, "pairUrl", "/pair", pageOrigin());
+        const url = endpointUrl(this.config, "pairUrl", BRIDGE_ENDPOINTS.pair, pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -178,7 +154,7 @@ export class HttpAgentBridgeTransport {
         return pairing;
     }
     async takeOver(request, signal) {
-        const url = endpointUrl(this.config, "takeoverUrl", "/takeover", pageOrigin());
+        const url = endpointUrl(this.config, "takeoverUrl", BRIDGE_ENDPOINTS.takeover, pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -193,7 +169,7 @@ export class HttpAgentBridgeTransport {
         return pairing;
     }
     async restore(request, signal) {
-        const url = endpointUrl(this.config, "statusUrl", "/status", pageOrigin());
+        const url = endpointUrl(this.config, "statusUrl", BRIDGE_ENDPOINTS.status, pageOrigin());
         if (!url || typeof fetch !== "function")
             return null;
         const response = await fetch(withQuery(url, {
@@ -206,7 +182,7 @@ export class HttpAgentBridgeTransport {
         return status;
     }
     openEvents(request, handlers) {
-        const url = endpointUrl(this.config, "eventsUrl", "/events", pageOrigin());
+        const url = endpointUrl(this.config, "eventsUrl", BRIDGE_ENDPOINTS.events, pageOrigin());
         if (!url || typeof EventSource !== "function") {
             queueMicrotask(() => handlers.onDisconnect("Agent event transport is unavailable."));
             return { close: () => undefined };
@@ -218,7 +194,13 @@ export class HttpAgentBridgeTransport {
         const source = new EventSource(eventUrl.href);
         let closed = false;
         const handleMessage = (event) => {
-            const envelope = eventData(event);
+            let envelope;
+            try {
+                envelope = JSON.parse(event.data);
+            }
+            catch {
+                return;
+            }
             if (!isRecord(envelope)
                 || envelope.protocolVersion !== AGENT_PROTOCOL_VERSION
                 || envelope.projectId !== request.projectId
@@ -251,7 +233,7 @@ export class HttpAgentBridgeTransport {
         };
     }
     async dispatch(request, signal) {
-        const url = endpointUrl(this.config, "promptUrl", "/prompt", pageOrigin());
+        const url = endpointUrl(this.config, "promptUrl", BRIDGE_ENDPOINTS.prompt, pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -266,7 +248,7 @@ export class HttpAgentBridgeTransport {
         return dispatched;
     }
     async disconnect(request, signal) {
-        const url = endpointUrl(this.config, "disconnectUrl", "/disconnect", pageOrigin());
+        const url = endpointUrl(this.config, "disconnectUrl", BRIDGE_ENDPOINTS.disconnect, pageOrigin());
         if (!url || typeof fetch !== "function")
             return;
         await fetch(url, {
@@ -277,7 +259,7 @@ export class HttpAgentBridgeTransport {
         });
     }
     async acknowledgeCanvasCommand(request, signal) {
-        const url = endpointUrl(this.config, "canvasAckUrl", "/canvas/ack", pageOrigin());
+        const url = endpointUrl(this.config, "canvasAckUrl", BRIDGE_ENDPOINTS.canvasAcknowledgement, pageOrigin());
         if (!url || typeof fetch !== "function")
             return;
         await fetch(url, {

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

@@ -1,13 +1,5 @@
 import type { AgentActivity, AgentStatusSnapshot, CanvasCommand, CanvasCommandAcknowledgement, CanvasCommandResult, AgentSketchAttachment, PairingResponse, PromptDispatchResponse } from "../../internal/agent-protocol.js";
-/**
- * Browser transport port for the shared Nudge agent protocol.
- *
- * Domain messages come from the private shared protocol module; this file only
- * adds the browser's injectable HTTP/SSE transport boundary. Keeping that
- * boundary local lets inspector tests use a deterministic fake while the
- * companion remains the owner of MCP and Node-specific code.
- */
-export { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, CANVAS_COMMAND_TYPES, canonicalOrigin, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, deriveConnectionState, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAgentActivity, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";
+export { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, BRIDGE_ENDPOINTS, CANVAS_COMMAND_TYPES, canonicalOrigin, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, deriveConnectionState, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAgentActivity, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";
 export type { AgentActivity, BridgeActivityEvent, AgentConnectionState, AgentProjectIdentity, AgentPromptRequest, AgentDeliveredPrompt, AgentSketchAttachment, AgentSketchAnnotation, AgentSketchCaptureMetadata, AgentSketchMetadata, AgentRequestOutcome, AgentRequestStatus, AgentRoute, AgentStatusSnapshot, AgentStatusUpdate, BridgeCanvasCommandEvent, BridgeConnectedEvent, BridgeDisconnectedEvent, BridgeEnvelope, BridgeEvent, BridgeEventType, BridgeStatusEvent, CanvasCommand, CanvasCommandAcknowledgement, CanvasCommandError, CanvasCommandResult, CanvasGroup, CanvasGroupOwner, CanvasState, FitCanvasCommand, FocusCanvasGroupCommand, PairingRequest, PairingResponse, PresentRoutesCommand, PromptDispatchRequest, PromptDispatchResponse, ReadCanvasStateCommand, RemoveCanvasGroupCommand, StatusEventRequest, AgentProtocolVersion, } from "../../internal/agent-protocol.js";
 export interface AgentBridgeEndpointConfig {
     readonly baseUrl?: string;
@@ -67,7 +59,6 @@ export interface AgentEventHandlers {
 export interface AgentEventSubscription {
     readonly close: () => void;
 }
-/** Events delivered by the companion's SSE stream. */
 export type AgentBridgeEvent = {
     readonly type: "activity";
     readonly activity: AgentActivity;

package/dist/inspector/agent/protocol.js

@@ -1,9 +1 @@
-/**
- * Browser transport port for the shared Nudge agent protocol.
- *
- * Domain messages come from the private shared protocol module; this file only
- * adds the browser's injectable HTTP/SSE transport boundary. Keeping that
- * boundary local lets inspector tests use a deterministic fake while the
- * companion remains the owner of MCP and Node-specific code.
- */
-export { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, CANVAS_COMMAND_TYPES, canonicalOrigin, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, deriveConnectionState, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAgentActivity, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";
+export { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, BRIDGE_ENDPOINTS, CANVAS_COMMAND_TYPES, canonicalOrigin, decodeAgentStatusSnapshot, decodeBridgeEvent, decodePairingResponse, decodePromptDispatchResponse, deriveConnectionState, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAgentActivity, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";