nudge-ui 0.2.0 → 0.2.1

package/dist/inspector/agent/httpTransport.js

@@ -1,4 +1,5 @@
-import { AGENT_PROTOCOL_VERSION, defaultBridgePort, } from "./protocol.js";
+import { AGENT_PROTOCOL_VERSION, defaultBridgePort, isAgentPromptRequest, } from "./protocol.js";
+import { getActiveCanvasDocument } from "../canvas/activeCanvasDocument.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -17,21 +18,35 @@ function endpointValue(value) {
         statusUrl: stringValue(value.statusUrl),
         canvasAckUrl: stringValue(value.canvasAckUrl),
         disconnectUrl: stringValue(value.disconnectUrl),
+        ...(value.autoConnect === true ? { autoConnect: true } : {}),
     };
     return Object.values(config).some((entry) => entry !== undefined) ? config : undefined;
 }
-function configuredEndpoint() {
-    if (typeof window === "undefined")
+function configuredEndpointInDocument(doc) {
+    const target = doc.defaultView;
+    if (!target)
         return undefined;
-    const target = window;
     const globalConfig = endpointValue(target.__NUDGE_UI_AGENT_BRIDGE__)
         ?? endpointValue(target.__NUDGE_UI_AGENT__);
     if (globalConfig)
         return globalConfig;
-    const meta = document.querySelector('meta[name="nudge-ui-agent-bridge"]');
+    const meta = doc.querySelector('meta[name="nudge-ui-agent-bridge"]');
     const content = meta?.content.trim();
     return content ? { baseUrl: content } : undefined;
 }
+function configuredEndpoint() {
+    if (typeof document === "undefined")
+        return undefined;
+    const controllerConfig = configuredEndpointInDocument(document);
+    if (controllerConfig)
+        return controllerConfig;
+    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;
+}
 function isLoopback(hostname) {
     const normalized = hostname.toLowerCase();
     return normalized === "localhost"
@@ -114,20 +129,24 @@ function statusPayload(value) {
     let request = null;
     if (rawRequest !== null && rawRequest !== undefined) {
         if (!isRecord(rawRequest)
-            || typeof rawRequest.requestId !== "string"
-            || typeof rawRequest.projectId !== "string"
-            || typeof rawRequest.prompt !== "string"
             || (rawRequest.status !== "working"
                 && rawRequest.status !== "completed"
                 && rawRequest.status !== "failed"
                 && rawRequest.status !== "interrupted"))
             return null;
-        request = {
+        const requestCandidate = {
             requestId: rawRequest.requestId,
             projectId: rawRequest.projectId,
             prompt: rawRequest.prompt,
-            status: rawRequest.status,
             ...(typeof rawRequest.changeRevision === "number" ? { changeRevision: rawRequest.changeRevision } : {}),
+            ...(rawRequest.clientDispatchId === undefined ? {} : { clientDispatchId: rawRequest.clientDispatchId }),
+            ...(rawRequest.sketches === undefined ? {} : { sketches: rawRequest.sketches }),
+        };
+        if (!isAgentPromptRequest(requestCandidate))
+            return null;
+        request = {
+            ...requestCandidate,
+            status: rawRequest.status,
             ...(typeof rawRequest.summary === "string" ? { summary: rawRequest.summary } : {}),
             ...(typeof rawRequest.error === "string" ? { error: rawRequest.error } : {}),
         };
@@ -299,20 +318,21 @@ export class HttpAgentBridgeTransport {
             signal,
         });
         const payload = await readJson(response);
-        if (!isRecord(payload.request)
-            || typeof payload.request.requestId !== "string"
-            || typeof payload.request.projectId !== "string"
-            || typeof payload.request.prompt !== "string"
-            || payload.status !== "working") {
+        if (!isRecord(payload.request) || payload.status !== "working") {
             throw new Error("Agent bridge returned an invalid prompt response.");
         }
-        const requestBody = {
+        const requestCandidate = {
             requestId: payload.request.requestId,
             projectId: payload.request.projectId,
             prompt: payload.request.prompt,
             ...(typeof payload.request.changeRevision === "number" ? { changeRevision: payload.request.changeRevision } : {}),
+            ...(payload.request.clientDispatchId === undefined ? {} : { clientDispatchId: payload.request.clientDispatchId }),
+            ...(payload.request.sketches === undefined ? {} : { sketches: payload.request.sketches }),
         };
-        return { request: requestBody, status: "working" };
+        if (!isAgentPromptRequest(requestCandidate) || requestCandidate.projectId !== request.projectId) {
+            throw new Error("Agent bridge returned an invalid prompt response.");
+        }
+        return { request: requestCandidate, status: "working" };
     }
     async disconnect(request, signal) {
         const url = endpointUrl(this.config, request.projectId, "disconnectUrl", "/disconnect", pageOrigin());

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

@@ -1,4 +1,4 @@
-import type { AgentStatusSnapshot, CanvasCommand, CanvasCommandAcknowledgement, CanvasCommandResult, PairingResponse, PromptDispatchResponse } from "../../internal/agent-protocol.js";
+import type { AgentStatusSnapshot, CanvasCommand, CanvasCommandAcknowledgement, CanvasCommandResult, AgentSketchAttachment, PairingResponse, PromptDispatchResponse } from "../../internal/agent-protocol.js";
 /**
  * Browser transport port for the shared Nudge agent protocol.
  *
@@ -7,8 +7,8 @@ import type { AgentStatusSnapshot, CanvasCommand, CanvasCommandAcknowledgement,
  * 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, defaultBridgePort, CANVAS_COMMAND_TYPES, canonicalOrigin, isAgentPromptRequest, isAgentStatusUpdate, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateRoutes, } from "../../internal/agent-protocol.js";
-export type { AgentConnectionState, AgentProjectIdentity, AgentPromptRequest, 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 { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, defaultBridgePort, CANVAS_COMMAND_TYPES, canonicalOrigin, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";
+export type { 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;
     readonly healthUrl?: string;
@@ -18,6 +18,8 @@ export interface AgentBridgeEndpointConfig {
     readonly statusUrl?: string;
     readonly canvasAckUrl?: string;
     readonly disconnectUrl?: string;
+    /** Pair automatically when this endpoint came from the trusted dev host. */
+    readonly autoConnect?: boolean;
 }
 export interface AgentDiscoveryRequest {
     readonly projectId: string;
@@ -43,6 +45,8 @@ export interface AgentPromptDispatch {
     readonly sessionToken: string;
     readonly prompt: string;
     readonly changeRevision?: number;
+    readonly clientDispatchId?: string;
+    readonly attachments?: readonly AgentSketchAttachment[];
 }
 export interface AgentDisconnectRequest {
     readonly projectId: string;
@@ -90,6 +94,7 @@ export interface AgentClientOptions {
     readonly origin?: string;
     readonly transport?: AgentBridgeTransport;
     readonly endpoint?: AgentBridgeEndpointConfig;
+    readonly autoConnect?: boolean;
     readonly discoveryIntervalMs?: number;
     readonly canvasCommandHandler?: (command: CanvasCommand) => CanvasCommandResult | Promise<CanvasCommandResult>;
 }

package/dist/inspector/agent/protocol.js

@@ -6,4 +6,4 @@
  * 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, defaultBridgePort, CANVAS_COMMAND_TYPES, canonicalOrigin, isAgentPromptRequest, isAgentStatusUpdate, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateRoutes, } from "../../internal/agent-protocol.js";
+export { AGENT_PROTOCOL_LIMITS, AGENT_PROTOCOL_VERSION, defaultBridgePort, CANVAS_COMMAND_TYPES, canonicalOrigin, isAgentPromptRequest, isAgentSketchAttachment, isAgentSketchAnnotation, isAgentSketchCaptureMetadata, isAgentSketchMetadata, isAgentStatusUpdate, isAllowedOrigin, isCanvasCommand, isCanvasGroup, isCanvasState, isCanonicalOrigin, isProjectIdentity, isSameOriginRoute, protocolError, validateSketchAttachments, validateRoutes, } from "../../internal/agent-protocol.js";

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

@@ -32,7 +32,7 @@ export declare function getAgentDispatchSize(revision: number): number;
  * observable after removing Nudge's own preview. Newer edits and ambiguous
  * records are preserved.
  */
-export declare function verifyAndReconcileHandoff(snapshot: HandoffSnapshot): Promise<number>;
+export declare function verifyAndReconcileHandoff(snapshot: HandoffSnapshot, doc?: Document | null): Promise<number>;
 /** Reconciles the captured records for one completed connected-agent request. */
 export declare function verifyAndReconcileAgentDispatch(revision: number): Promise<number>;
 /** Test/session reset for in-memory dispatch snapshots. */

package/dist/inspector/agent/verification.js

@@ -4,9 +4,13 @@ import { getWorkspaceChanges } from "../changes/workspaceChanges.js";
 import { getChangesList, isComponentChange, isTextContentChange, isTokenChange, reconcileVerifiedWorkspaceChanges, } from "../changes/changesLog.js";
 import { verifyPreview } from "../projection/managedStylesheet.js";
 import { resolveRenderedInstance } from "../projection/renderedInstance.js";
-import { getStructuralChanges, } from "../projection/structuralProjection.js";
+import { documentStateKey, getStructuralChanges, } from "../projection/structuralProjection.js";
 import { resolveTextProjectionTarget, resolveTextProjectionTextNode, } from "../projection/textProjection.js";
 import { applyHostWorkspaceProjection, compileWorkspaceProjection, } from "../projection/workspaceProjection.js";
+import { isCanvasProjectionRevisionCurrent, projectWorkspaceSnapshotToDocument, } from "../canvas/projection.js";
+import { getActiveCanvasDocument } from "../canvas/activeCanvasDocument.js";
+import { getSelectedElement } from "../selection/selectionStore.js";
+import { isEditorShellDocument } from "../runtime/editorShell.js";
 const dispatches = new Map();
 function stableJsonValue(value) {
     if (Array.isArray(value))
@@ -72,7 +76,20 @@ function verifyText(change, doc) {
  * verifies.
  */
 function verifyStructuralDelete(change, doc) {
-    return resolveRenderedInstance(doc, change.target).status === "missing";
+    if (!change.route || !change.state || !doc.location)
+        return false;
+    let currentRoute;
+    try {
+        const url = new URL(doc.location.href);
+        url.hash = "";
+        currentRoute = url.href;
+    }
+    catch {
+        return false;
+    }
+    return currentRoute === change.route
+        && documentStateKey(doc) === change.state
+        && resolveRenderedInstance(doc, change.target).status === "missing";
 }
 /**
  * A move verifies when the element sits at its recorded destination without
@@ -142,11 +159,26 @@ export function getAgentDispatchSize(revision) {
         return 0;
     return snapshot.changes.length + snapshot.structuralChanges.length;
 }
-function afterBrowserPaint() {
-    if (typeof requestAnimationFrame !== "function")
+function afterBrowserPaint(doc) {
+    const ownerWindow = doc.defaultView;
+    const requestFrame = ownerWindow?.requestAnimationFrame.bind(ownerWindow);
+    if (!ownerWindow || !requestFrame)
         return Promise.resolve();
     return new Promise((resolve) => {
-        requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve();
+        };
+        const timeout = setTimeout(finish, 250);
+        requestFrame(() => {
+            if (doc.defaultView !== ownerWindow)
+                return finish();
+            requestFrame(finish);
+        });
     });
 }
 /**
@@ -154,7 +186,18 @@ function afterBrowserPaint() {
  * observable after removing Nudge's own preview. Newer edits and ambiguous
  * records are preserved.
  */
-export async function verifyAndReconcileHandoff(snapshot) {
+export async function verifyAndReconcileHandoff(snapshot, doc = activeVerificationDocument()) {
+    if (!doc)
+        return 0;
+    const applyProjection = async (snapshot) => {
+        if (doc === document && !isEditorShellDocument(doc)) {
+            applyHostWorkspaceProjection(compileWorkspaceProjection(snapshot));
+            return "host";
+        }
+        if (doc === document)
+            return null;
+        return projectWorkspaceSnapshotToDocument(doc, snapshot);
+    };
     const sentByKey = new Map(snapshot.changes.map((change) => [changeKey(change), handoffChangeFingerprint(change)]));
     const current = getChangesList();
     const eligible = current.filter((change) => sentByKey.get(changeKey(change)) === handoffChangeFingerprint(change));
@@ -169,14 +212,19 @@ export async function verifyAndReconcileHandoff(snapshot) {
     const remainingStructural = currentStructural.filter((change) => !eligibleStructuralIds.has(change.id));
     try {
         const currentWorkspace = getWorkspaceChanges();
-        applyHostWorkspaceProjection(compileWorkspaceProjection({
+        const previewRevision = await applyProjection({
             revision: currentWorkspace.revision,
             changes: remaining,
             structuralChanges: remainingStructural,
-        }));
-        await afterBrowserPaint();
-        const verified = verifiedChangeKeys(eligible);
-        const verifiedStructural = verifiedStructuralChangeIds(eligibleStructural, document);
+        });
+        if (previewRevision === null)
+            return 0;
+        await afterBrowserPaint(doc);
+        if (typeof previewRevision === "number"
+            && !isCanvasProjectionRevisionCurrent(doc, previewRevision))
+            return 0;
+        const verified = verifiedChangeKeys(eligible, doc);
+        const verifiedStructural = verifiedStructuralChangeIds(eligibleStructural, doc);
         // A user can make another inspector edit while the two-frame verification
         // window is open. Recheck byte identity immediately before reconciliation
         // so a newer value at the same key can never be removed.
@@ -184,15 +232,24 @@ export async function verifyAndReconcileHandoff(snapshot) {
         const stillVerified = new Set([...verified].filter((key) => currentByKey.get(key) === sentByKey.get(key)));
         const currentStructuralById = new Map(getStructuralChanges().map((change) => [change.id, handoffStructuralFingerprint(change)]));
         const stillVerifiedStructural = new Set([...verifiedStructural].filter((id) => currentStructuralById.get(id) === sentStructural.get(id)));
+        if (typeof previewRevision === "number"
+            && !isCanvasProjectionRevisionCurrent(doc, previewRevision))
+            return 0;
         return reconcileVerifiedWorkspaceChanges(stillVerified, stillVerifiedStructural);
     }
     finally {
         // Reconciliation reapplies the canonical set. If it was unable to write
         // (for example, a read-only Canvas lease), restore the untouched set here.
         const canonicalWorkspace = getWorkspaceChanges();
-        applyHostWorkspaceProjection(compileWorkspaceProjection(canonicalWorkspace));
+        await applyProjection(canonicalWorkspace);
     }
 }
+function activeVerificationDocument() {
+    const selectedDocument = getSelectedElement()?.domElement.ownerDocument;
+    if (selectedDocument && selectedDocument !== document)
+        return selectedDocument;
+    return getActiveCanvasDocument() ?? (isEditorShellDocument() ? null : document);
+}
 /** Reconciles the captured records for one completed connected-agent request. */
 export async function verifyAndReconcileAgentDispatch(revision) {
     const snapshot = dispatches.get(revision);

package/dist/inspector/canvas/CanvasCard.d.ts

@@ -1,10 +1,12 @@
 import { type ReactElement } from "react";
-import { type CanvasCard } from "./canvasStore.js";
+import { type CanvasCard, type CanvasPresentation } from "./canvasStore.js";
 import type { InspectorSession } from "../session/sessionFactory.js";
 interface CanvasCardProps {
     card: CanvasCard;
-    onEdit?: (card: CanvasCard) => void;
+    presentation?: CanvasPresentation;
+    presentationCard?: boolean;
+    onShowFocus?: (cardId: string) => void;
     documentOwner?: InspectorSession;
 }
-export declare function CanvasCard({ card, onEdit, documentOwner }: CanvasCardProps): ReactElement;
+export declare function CanvasCard({ card, presentation, presentationCard, onShowFocus, documentOwner }: CanvasCardProps): ReactElement;
 export {};