nudge-ui 0.2.3 → 0.2.5

package/dist/inspector/agent/httpTransport.js

@@ -1,4 +1,4 @@
-import { AGENT_PROTOCOL_VERSION, defaultBridgePort, isAgentPromptRequest, isAgentActivity, } from "./protocol.js";
+import { AGENT_PROTOCOL_VERSION, 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);
@@ -27,8 +27,7 @@ function configuredEndpointInDocument(doc) {
     const target = doc.defaultView;
     if (!target)
         return undefined;
-    const globalConfig = endpointValue(target.__NUDGE_UI_AGENT_BRIDGE__)
-        ?? endpointValue(target.__NUDGE_UI_AGENT__);
+    const globalConfig = endpointValue(target.__NUDGE_UI_AGENT_BRIDGE__);
     if (globalConfig)
         return globalConfig;
     const meta = doc.querySelector('meta[name="nudge-ui-agent-bridge"]');
@@ -75,12 +74,12 @@ function safeUrl(value, origin) {
         return null;
     }
 }
-function endpointUrl(config, projectId, key, fallbackPath, origin) {
+/** Null when the host published no endpoint; the browser never guesses a bridge port. */
+function endpointUrl(config, key, fallbackPath, origin) {
     const explicit = config[key];
     if (explicit && key !== "baseUrl")
         return safeUrl(explicit, origin);
-    const baseValue = config.baseUrl ?? `http://127.0.0.1:${defaultBridgePort(projectId)}`;
-    const base = safeUrl(baseValue, origin);
+    const base = config.baseUrl ? safeUrl(config.baseUrl, origin) : null;
     if (!base)
         return null;
     base.pathname = `${base.pathname.replace(/\/$/, "")}${fallbackPath}`;
@@ -123,83 +122,6 @@ async function readJson(response) {
     }
     return isRecord(payload) ? payload : {};
 }
-function statusPayload(value) {
-    if (!isRecord(value))
-        return null;
-    const status = isRecord(value.status) ? value.status : value;
-    if (typeof status.projectId !== "string"
-        || (status.connection !== "offline"
-            && status.connection !== "listening"
-            && status.connection !== "paired"
-            && status.connection !== "working")
-        || typeof status.listenerActive !== "boolean"
-        || typeof status.paired !== "boolean")
-        return null;
-    if (status.protocolVersion !== undefined && status.protocolVersion !== AGENT_PROTOCOL_VERSION)
-        return null;
-    const rawRequest = status.request;
-    let request = null;
-    if (rawRequest !== null && rawRequest !== undefined) {
-        if (!isRecord(rawRequest)
-            || (rawRequest.status !== "working"
-                && rawRequest.status !== "completed"
-                && rawRequest.status !== "failed"
-                && rawRequest.status !== "interrupted"))
-            return null;
-        const requestCandidate = {
-            requestId: rawRequest.requestId,
-            projectId: rawRequest.projectId,
-            prompt: rawRequest.prompt,
-            ...(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 } : {}),
-        };
-    }
-    return {
-        protocolVersion: AGENT_PROTOCOL_VERSION,
-        projectId: status.projectId,
-        connection: status.connection,
-        listenerActive: status.listenerActive,
-        ...(typeof status.agentClientName === "string" ? { agentClientName: status.agentClientName.slice(0, 120) } : {}),
-        paired: status.paired,
-        request,
-    };
-}
-function eventPayload(value) {
-    if (!isRecord(value))
-        return null;
-    const envelope = value;
-    const event = isRecord(envelope.event) ? envelope.event : value;
-    const type = stringValue(event.type);
-    if (type === "status") {
-        const status = statusPayload(event.status);
-        return status ? { type: "status", status } : null;
-    }
-    if (type === "connected") {
-        const status = statusPayload(event.status);
-        return status ? { type: "connected", status } : null;
-    }
-    if (type === "disconnected") {
-        return { type: "disconnected", ...(stringValue(event.reason) ? { reason: stringValue(event.reason) } : {}) };
-    }
-    if (type === "activity" && isAgentActivity(event.activity))
-        return { type: "activity", activity: event.activity };
-    if (type === "canvas-command" && isRecord(event.command)) {
-        // The Canvas controller owns command validation. Preserve the shared
-        // shape here so the parent stage can consume this event without a second
-        // protocol vocabulary.
-        return { type: "canvas-command", command: event.command };
-    }
-    return null;
-}
 function eventData(event) {
     if (typeof event.data !== "string")
         return event.data;
@@ -223,7 +145,7 @@ export class HttpAgentBridgeTransport {
         this.config = config;
     }
     async discover(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "healthUrl", "/health", pageOrigin());
+        const url = endpointUrl(this.config, "healthUrl", "/health", pageOrigin());
         if (!url || typeof fetch !== "function")
             return null;
         const response = await fetch(withQuery(url, {
@@ -238,10 +160,10 @@ export class HttpAgentBridgeTransport {
             || payload.projectId !== request.projectId
             || (payload.origin !== undefined && payload.origin !== null && payload.origin !== request.origin))
             return null;
-        return statusPayload(payload.status);
+        return decodeAgentStatusSnapshot(payload.status);
     }
     async pair(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "pairUrl", "/pair", pageOrigin());
+        const url = endpointUrl(this.config, "pairUrl", "/pair", pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -250,26 +172,13 @@ export class HttpAgentBridgeTransport {
             body: JSON.stringify(request),
             signal,
         });
-        const payload = await readJson(response);
-        if (payload.protocolVersion !== AGENT_PROTOCOL_VERSION
-            || payload.projectId !== request.projectId
-            || payload.origin !== request.origin
-            || typeof payload.sessionToken !== "string") {
+        const pairing = decodePairingResponse(await readJson(response), request);
+        if (!pairing)
             throw new Error("Agent bridge returned an invalid pairing response.");
-        }
-        const status = statusPayload(payload.status);
-        if (!status)
-            throw new Error("Agent bridge returned an invalid status.");
-        return {
-            protocolVersion: AGENT_PROTOCOL_VERSION,
-            projectId: request.projectId,
-            origin: request.origin,
-            sessionToken: payload.sessionToken,
-            status,
-        };
+        return pairing;
     }
     async takeOver(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "takeoverUrl", "/takeover", pageOrigin());
+        const url = endpointUrl(this.config, "takeoverUrl", "/takeover", pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -278,42 +187,26 @@ export class HttpAgentBridgeTransport {
             body: JSON.stringify(request),
             signal,
         });
-        const payload = await readJson(response);
-        if (payload.protocolVersion !== AGENT_PROTOCOL_VERSION
-            || payload.projectId !== request.projectId
-            || payload.origin !== request.origin
-            || typeof payload.sessionToken !== "string") {
+        const pairing = decodePairingResponse(await readJson(response), request);
+        if (!pairing)
             throw new Error("Agent bridge returned an invalid takeover response.");
-        }
-        const status = statusPayload(payload.status);
-        if (!status)
-            throw new Error("Agent bridge returned an invalid status.");
-        return {
-            protocolVersion: AGENT_PROTOCOL_VERSION,
-            projectId: request.projectId,
-            origin: request.origin,
-            sessionToken: payload.sessionToken,
-            status,
-        };
+        return pairing;
     }
     async restore(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "statusUrl", "/status", pageOrigin());
+        const url = endpointUrl(this.config, "statusUrl", "/status", pageOrigin());
         if (!url || typeof fetch !== "function")
             return null;
         const response = await fetch(withQuery(url, {
             projectId: request.projectId,
             sessionToken: request.sessionToken,
         }), { method: "GET", headers: headers(), signal });
-        const payload = await readJson(response);
-        if (payload.protocolVersion !== AGENT_PROTOCOL_VERSION || payload.projectId !== request.projectId)
-            return null;
-        const status = statusPayload(payload);
-        if (!status || !status.paired)
+        const status = decodeAgentStatusSnapshot(await readJson(response));
+        if (!status || status.projectId !== request.projectId || !status.paired)
             return null;
         return status;
     }
     openEvents(request, handlers) {
-        const url = endpointUrl(this.config, request.projectId, "eventsUrl", "/events", pageOrigin());
+        const url = endpointUrl(this.config, "eventsUrl", "/events", pageOrigin());
         if (!url || typeof EventSource !== "function") {
             queueMicrotask(() => handlers.onDisconnect("Agent event transport is unavailable."));
             return { close: () => undefined };
@@ -325,10 +218,13 @@ export class HttpAgentBridgeTransport {
         const source = new EventSource(eventUrl.href);
         let closed = false;
         const handleMessage = (event) => {
-            const value = eventData(event);
-            if (isRecord(value) && "event" in value && (value.protocolVersion !== AGENT_PROTOCOL_VERSION || value.projectId !== request.projectId || value.sessionToken !== request.sessionToken))
+            const envelope = eventData(event);
+            if (!isRecord(envelope)
+                || envelope.protocolVersion !== AGENT_PROTOCOL_VERSION
+                || envelope.projectId !== request.projectId
+                || envelope.sessionToken !== request.sessionToken)
                 return;
-            const parsed = eventPayload(value);
+            const parsed = decodeBridgeEvent(envelope.event);
             if (parsed)
                 handlers.onEvent(parsed);
         };
@@ -355,7 +251,7 @@ export class HttpAgentBridgeTransport {
         };
     }
     async dispatch(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "promptUrl", "/prompt", pageOrigin());
+        const url = endpointUrl(this.config, "promptUrl", "/prompt", pageOrigin());
         if (!url || typeof fetch !== "function")
             throw new Error("Agent bridge is unavailable.");
         const response = await fetch(url, {
@@ -364,25 +260,13 @@ export class HttpAgentBridgeTransport {
             body: JSON.stringify(request),
             signal,
         });
-        const payload = await readJson(response);
-        if (!isRecord(payload.request) || payload.status !== "working") {
+        const dispatched = decodePromptDispatchResponse(await readJson(response), request.projectId);
+        if (!dispatched)
             throw new Error("Agent bridge returned an invalid prompt response.");
-        }
-        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 }),
-        };
-        if (!isAgentPromptRequest(requestCandidate) || requestCandidate.projectId !== request.projectId) {
-            throw new Error("Agent bridge returned an invalid prompt response.");
-        }
-        return { request: requestCandidate, status: "working" };
+        return dispatched;
     }
     async disconnect(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "disconnectUrl", "/disconnect", pageOrigin());
+        const url = endpointUrl(this.config, "disconnectUrl", "/disconnect", pageOrigin());
         if (!url || typeof fetch !== "function")
             return;
         await fetch(url, {
@@ -393,7 +277,7 @@ export class HttpAgentBridgeTransport {
         });
     }
     async acknowledgeCanvasCommand(request, signal) {
-        const url = endpointUrl(this.config, request.projectId, "canvasAckUrl", "/canvas/ack", pageOrigin());
+        const url = endpointUrl(this.config, "canvasAckUrl", "/canvas/ack", pageOrigin());
         if (!url || typeof fetch !== "function")
             return;
         await fetch(url, {

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

@@ -7,7 +7,7 @@ import type { AgentActivity, AgentStatusSnapshot, CanvasCommand, CanvasCommandAc
  * 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, 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, 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;

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, 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, 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";

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

@@ -1,5 +1,5 @@
 import { type DraftTarget } from "../drafts/model.js";
-import { type ChangeRecord } from "../changes/changesLog.js";
+import { type ChangeRecord } from "../changes/types.js";
 import { type StructuralChange } from "../projection/structuralProjection.js";
 export interface HandoffOwner {
     readonly draftId: string;
@@ -13,12 +13,6 @@ export interface HandoffSnapshot {
     readonly changes: readonly ChangeRecord[];
     readonly structuralChanges: readonly StructuralChange[];
 }
-/**
- * User-facing agent completion state, named once.
- * "completed" means the agent finished; "verified" means completed work was
- * positively reconciled against source-rendered output.
- */
-export type AgentCompletionStatus = "completed" | "verified";
 /** Stable, preview-metadata-free identity for one prompt handoff record. */
 export declare function handoffChangeFingerprint(change: ChangeRecord): string;
 /** Stable identity for one structural record included in a prompt handoff. */
@@ -43,6 +37,10 @@ export declare function getAgentDispatchSize(revision: number): number;
  */
 export declare function verifyAndReconcileHandoff(snapshot: HandoffSnapshot, doc?: Document | null): Promise<number>;
 export declare function documentBelongsToHandoff(doc: Document, owner: HandoffOwner): boolean;
+/** Returns the records captured for one dispatch until it is reconciled. */
+export declare function getAgentDispatch(revision: number): HandoffSnapshot | null;
+/** Records in the owner draft that still equal what a handoff sent. */
+export declare function unchangedHandoffRecords(snapshot: HandoffSnapshot): Pick<HandoffSnapshot, "changes" | "structuralChanges">;
 /** 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

@@ -1,13 +1,14 @@
-import { draftIdForCard } from "../drafts/store.js";
+import { draftIdForCard, getActiveDraftChanges, getDraftChanges, reconcileDraftChanges } from "../drafts/store.js";
 import { getCanvasCards } from "../canvas/canvasStore.js";
 import { getRegisteredFrames, getCanvasCardIdForDocument } from "../canvas/projection.js";
 import { applicationTarget, targetFromKey, targetKey } from "../drafts/model.js";
 import { changeKey, tokenReference } from "../changes/model.js";
 import { selectorForManagedChange } from "../changes/managedStyleProjection.js";
-import { getActiveDraftChanges, getDraftChanges, reconcileDraftChanges } from "../changes/draftChanges.js";
-import { isComponentChange, isTextContentChange, isTokenChange, } from "../changes/changesLog.js";
+import { isComponentChange, isTextContentChange, isTokenChange, } from "../changes/types.js";
 import { verifyPreview } from "../projection/managedStylesheet.js";
-import { resolveRenderedInstance } from "../projection/renderedInstance.js";
+import { resolveMovedRenderedInstance } from "../projection/renderedInstance.js";
+import { relocateSourceSite, sourceSiteSelector } from "../selection/sourceSite.js";
+import { boundRuntimeEvidence, normalizeRuntimeTag } from "../runtime/staticHtmlRuntimeIdentity.js";
 import { documentStateKey, } from "../projection/structuralProjection.js";
 import { resolveTextProjectionTarget, resolveTextProjectionTextNode, } from "../projection/textProjection.js";
 import { applyHostDraftProjection, compileDraftProjection, } from "../projection/draftProjection.js";
@@ -48,32 +49,60 @@ function requestedStyleValue(change) {
         return tokenReference(change.newToken);
     return change.rawValue ?? "";
 }
-function verifyStyle(change, doc) {
-    if (!isTokenChange(change) && (change.state ?? "base") !== "base")
-        return false;
-    const selector = selectorForManagedChange(change);
+function queryTargets(doc, selector) {
     if (!selector)
-        return false;
-    let targets;
+        return [];
     try {
-        targets = Array.from(doc.querySelectorAll(selector));
+        return Array.from(doc.querySelectorAll(selector));
     }
     catch {
-        return false;
+        return [];
     }
+}
+/** Resolves current style targets, following a source site whose position shifted. */
+function styleTargets(change, doc) {
+    if (isTokenChange(change))
+        return queryTargets(doc, change.selector);
+    // The projection marker is lifted for verification; evidence names the instance.
+    if (change.scope === "rendered-instance") {
+        const resolved = change.instanceOverride
+            ? resolveMovedRenderedInstance(doc, change.instanceOverride.target)
+            : null;
+        return resolved?.status === "resolved" ? [resolved.element] : [];
+    }
+    const targets = queryTargets(doc, selectorForManagedChange(change));
+    const evidence = change.sourceEvidence;
+    if (targets.length > 0 || !evidence || change.column === undefined)
+        return targets;
+    const site = relocateSourceSite(doc, { cid: change.cid, src: `${change.file}:${change.line}:${change.column}` }, (element) => normalizeRuntimeTag(element.tagName) === evidence.tagName
+        && boundRuntimeEvidence(element.getAttribute("data-cprops")) === evidence.props);
+    return site ? queryTargets(doc, sourceSiteSelector(site.cid, site.src)) : [];
+}
+function verifyStyle(change, doc) {
+    if (!isTokenChange(change) && (change.state ?? "base") !== "base")
+        return false;
+    const targets = styleTargets(change, doc);
     const requested = requestedStyleValue(change);
     return requested.length > 0
         && targets.length > 0
         && targets.every((target) => verifyPreview(target, change.property, requested).status === "applied");
 }
 function verifyText(change, doc) {
-    const resolved = resolveTextProjectionTarget(doc, change.target, change.after);
+    let target = change.target;
+    let resolved = resolveTextProjectionTarget(doc, target, change.after);
+    if (resolved.status === "missing") {
+        const sourceSite = relocateSourceSite(doc, target.sourceSite, (element) => element.getAttribute("data-cprops") === target.props && element.getAttribute("aria-label") === target.ariaLabel);
+        if (sourceSite) {
+            target = { ...target, sourceSite };
+            resolved = resolveTextProjectionTarget(doc, target, change.after);
+        }
+    }
     if (resolved.status !== "resolved")
         return false;
-    const node = resolveTextProjectionTextNode(resolved.element, change.target, change.after);
+    const node = resolveTextProjectionTextNode(resolved.element, target, change.after);
     if (node)
         return node.nodeValue === change.after;
-    return change.target.textNodePath === undefined
+    return target.textNodePath === undefined
         && change.after.length === 0
         && (resolved.element.textContent ?? "") === "";
 }
@@ -97,7 +126,7 @@ function verifyStructuralDelete(change, doc) {
     }
     return currentRoute === change.route
         && documentStateKey(doc) === change.state
-        && resolveRenderedInstance(doc, change.target).status === "missing";
+        && resolveMovedRenderedInstance(doc, change.target).status === "missing";
 }
 /**
  * A move verifies when the element sits at its recorded destination without
@@ -106,17 +135,17 @@ function verifyStructuralDelete(change, doc) {
  * stay unverified instead of trusting rendered placement alone.
  */
 function verifyStructuralMove(change, doc) {
-    const target = resolveRenderedInstance(doc, change.target);
+    const target = resolveMovedRenderedInstance(doc, change.target);
     if (target.status !== "resolved")
         return false;
-    const parent = resolveRenderedInstance(doc, change.destination.parent);
+    const parent = resolveMovedRenderedInstance(doc, change.destination.parent);
     if (parent.status !== "resolved")
         return false;
     if (target.element.parentElement !== parent.element)
         return false;
     if (!change.destination.before)
         return target.element.nextElementSibling === null;
-    const before = resolveRenderedInstance(doc, change.destination.before);
+    const before = resolveMovedRenderedInstance(doc, change.destination.before);
     return before.status === "resolved" && target.element.nextElementSibling === before.element;
 }
 function verifiedStructuralChangeIds(eligible, doc) {
@@ -253,10 +282,14 @@ export async function verifyAndReconcileHandoff(snapshot, doc = handoffDocument(
     finally {
         // Reconciliation reapplies the canonical set. If it was unable to write
         // (for example, a read-only Canvas lease), restore the untouched set here.
+        // A Canvas restore settles on the renderer's acknowledgement: that
+        // acknowledgement invalidates the frame's stylesheet revision, and a
+        // caller still inside this verification must not mistake it for a source
+        // change and schedule another verification.
         if (doc === document)
             await applyProjection(getActiveDraftChanges());
         else
-            restoreCanonicalFrameProjection(doc);
+            await restoreCanonicalFrameProjection(doc);
     }
 }
 export function documentBelongsToHandoff(doc, owner) {
@@ -278,6 +311,20 @@ function handoffDocument(owner) {
     }
     return owner.target.kind === "application" && !isEditorShellDocument() ? document : null;
 }
+/** Returns the records captured for one dispatch until it is reconciled. */
+export function getAgentDispatch(revision) {
+    return dispatches.get(revision) ?? null;
+}
+/** Records in the owner draft that still equal what a handoff sent. */
+export function unchangedHandoffRecords(snapshot) {
+    const sent = new Set(snapshot.changes.map(handoffChangeFingerprint));
+    const sentStructural = new Set(snapshot.structuralChanges.map(handoffStructuralFingerprint));
+    const current = getDraftChanges(snapshot.owner.draftId);
+    return {
+        changes: current.changes.filter((change) => sent.has(handoffChangeFingerprint(change))),
+        structuralChanges: current.structuralChanges.filter((change) => sentStructural.has(handoffStructuralFingerprint(change))),
+    };
+}
 /** Reconciles the captured records for one completed connected-agent request. */
 export async function verifyAndReconcileAgentDispatch(revision) {
     const snapshot = dispatches.get(revision);

package/dist/inspector/boot.d.ts

@@ -0,0 +1,3 @@
+export declare function bootstrapNudgeUi(inspectorHost: HTMLElement): void;
+export declare function mountInspector(host: HTMLElement): void;
+export declare function unmountInspector(): void;