mesurer-solid 0.2.3-beta.9 → 0.2.3

package/AGENT_INTEGRATION.md

@@ -218,16 +218,16 @@ See [Direct text editing and Typography](../../docs/TEXT_EDITING.md).
 
 ## Annotation and context review
 
-A saved annotation carries target-bound intent and an immutable baseline:
+A saved annotation carries target-bound intent and an immutable baseline. Its original note remains unchanged as replies are added, edited, or deleted; resolution status is open by default and can be explicitly reopened:
 
 ```js
 const context = await window.__MESURER__.context({ annotation: annotationId })
 ```
 
-Saved annotation UI is source-linked presentation, not the durable state itself. Saved annotations survive a same-tab reload and conservatively rebind through their stored selector/fingerprint identity; ambiguous targets remain unresolved rather than attaching to a different element. Add Note, its composer, saved markers and panels, and the ownership edge move with their target through window and nested scrolling. A saved panel keeps its target-relative page point and may leave the viewport with its source. Several notes on one target keep separate nearby markers, and Add Note remains available while an existing note is open.
+Saved annotation UI is source-linked presentation, not the durable state itself. Saved annotations and replies survive a same-tab reload and conservatively rebind through their stored selector/fingerprint identity; ambiguous targets remain unresolved rather than attaching to a different element. Read `annotations()` and annotation-scoped `context()` to consume the original note and all replies. Resolved notes remain readable and are excluded from bulk Codex delivery; explicitly requesting one note's Context still works. Add Note, its composer, saved markers and panels, and the ownership edge move with their target through window and nested scrolling. A saved panel keeps its target-relative page point and may leave the viewport with its source. Several notes on one target keep separate nearby markers, and Add Note remains available while an existing note is open.
 The composer is a compact auto-growing text field with an in-field Send button. Enter sends, Shift+Enter inserts a newline, and Escape discards. The first outside click on a non-empty draft prompts rather than discarding it; a second outside click closes it.
 
-Do not infer that an annotation disappeared because its card or marker is currently offscreen. Read `annotations()` and annotation-scoped `context()` instead. When a note is highlighted, the temporary ownership emphasis uses one exact target boundary rather than a second fill, glow, or rounded frame.
+Do not infer that an annotation disappeared because its card or marker is currently offscreen. Read `annotations()` and annotation-scoped `context()` instead. These reads are non-destructive: they never open Responsive, reveal a saved target, scroll the page, or change the user's presentation. The human can explicitly use the Notes toolbar list to reveal a saved note. When a note is highlighted, the temporary ownership emphasis uses one exact target boundary rather than a second fill, glow, or rounded frame.
 
 Context cards are Mesurer inspector UI. Live Select hover and selection evidence must paint underneath the composer and saved panels, including when the outer Mesurer host is in the browser top layer. Agents should treat the cards as interaction boundaries rather than attempting to select page content through them.
 

package/dist/context-plugin.d.ts

@@ -14,7 +14,10 @@ export type MesurerContextService = {
     select(selectors: string | readonly string[]): Promise<MesurerContextV1>;
     annotations(): Promise<MesurerAnnotation[]>;
     /** Remove one saved annotation after a trusted workflow has completed it. */
-    removeAnnotation(annotationId: string): Promise<void>;
+    removeAnnotation(annotationId: string, expectedContent?: {
+        note: string;
+        replies: NonNullable<MesurerAnnotation["replies"]>;
+    }): Promise<void>;
     review(annotationId?: string): Promise<MesurerReviewV1 | MesurerReviewV1[]>;
     capturePlan(request?: MesurerContextRequest): Promise<MesurerCapturePlanV1>;
     prepareCapture(): Promise<void>;

package/dist/context.d.ts

@@ -134,6 +134,12 @@ export type MesurerAnnotationBaseline = {
         } | null;
     }>;
 };
+export type MesurerAnnotationReply = {
+    id: string;
+    text: string;
+    createdAt: number;
+};
+export type MesurerAnnotationStatus = "open" | "resolved";
 export type MesurerAnnotation = {
     id: string;
     note: string;
@@ -147,6 +153,13 @@ export type MesurerAnnotation = {
         rect: MesurerContextRect;
     };
     baseline: MesurerAnnotationBaseline;
+    replies?: Array<{
+        id: string;
+        text: string;
+        createdAt: number;
+    }>;
+    status?: "open" | "resolved";
+    resolvedAt?: number;
 };
 export type MesurerContextTarget = {
     ref: string;
@@ -210,6 +223,13 @@ export type MesurerContextV1 = {
         kind: "annotation";
         annotationId: string;
         note: string;
+        replies?: Array<{
+            id: string;
+            text: string;
+            createdAt: number;
+        }>;
+        status?: "open" | "resolved";
+        resolvedAt?: number;
         targetStatus: "connected" | "partial" | "stale";
     };
     page: {

package/dist/index.d.ts

@@ -254,7 +254,7 @@ export { MESURER_VERSION } from "./version";
 export type { AgentDistance, AgentEdges, AgentElementInspection, AgentFeedbackSnapshot, AgentRect, AgentViewportSnapshot, CreateMesurerAgentHarnessOptions, MesurerAgentHarness, MesurerTextEditIntent, MesurerTextEditService, MesurerTextStyleChange, MesurerTextStyleProperty, } from "./agent";
 export type { ArrangeCapturePlan, ArrangeIntent, ArrangeOffset, ArrangePresentation, ArrangeRect, ArrangeReview, ArrangeReviewTarget, ArrangeTarget, MesurerArrangeService, EditCapturePlan, EditIntent, EditOffset, EditPresentation, EditRect, EditReview, EditReviewTarget, EditTarget, MesurerEditService, } from "./arrange";
 export { captureMesurerContext, copyTextToClipboard, createMesurerCapturePlan, formatMesurerContext, reviewMesurerAnnotation, } from "./context";
-export type { MesurerAnnotation, MesurerAnnotationBaseline, MesurerAnnotationTarget, MesurerCapturePlanV1, MesurerContextDistance, MesurerContextEdges, MesurerContextGuide, MesurerContextLayoutGuide, MesurerContextMeasurement, MesurerContextRect, MesurerContextRequest, MesurerContextTarget, MesurerContextV1, MesurerElementFingerprint, MesurerElementInspection, MesurerReviewChange, MesurerReviewMetricChange, MesurerReviewPresenceChange, MesurerReviewV1, } from "./context";
+export type { MesurerAnnotation, MesurerAnnotationBaseline, MesurerAnnotationReply, MesurerAnnotationStatus, MesurerAnnotationTarget, MesurerCapturePlanV1, MesurerContextDistance, MesurerContextEdges, MesurerContextGuide, MesurerContextLayoutGuide, MesurerContextMeasurement, MesurerContextRect, MesurerContextRequest, MesurerContextTarget, MesurerContextV1, MesurerElementFingerprint, MesurerElementInspection, MesurerReviewChange, MesurerReviewMetricChange, MesurerReviewPresenceChange, MesurerReviewV1, } from "./context";
 export { createMesurerPluginHost, createMesurerRuntime, defineMesurerPlugin } from "./core";
 export type { CommandHandler as MesurerCommandHandler, MesurerPlugin, MesurerPluginContext, MesurerPluginDescription, MesurerPluginHost, OverlayContribution, Registration as MesurerRegistration, SettingsContribution, StateSliceDefinition, ToolContribution, ToolbarMode, } from "./core";
 export type { MesurerHostLayerMode } from "./host-layer";