@visual-layer/grounding 1.0.0 → 1.1.0

package/dist/gate.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Grounding gate + consensus — the decision layer that turns a ranked
+ * candidate list into a safe-to-act verdict.
+ *
+ * Gate = structure-first confidence + top-1/top-2 gap + warning disqualifiers.
+ * Pure deterministic, no model calls. The vision second-opinion is supplied
+ * out-of-band by the consuming agent (Claude/Codex have native vision) via
+ * confirm_grounding, or by a plugged VisionVerifier; this module only emits the
+ * "look now" signal (status === 'needs_visual_confirm').
+ *
+ * Why a gate at all: the scorer is a heuristic blend (text/role/bbox/source).
+ * Heuristics rank well but cannot prove the top candidate is what the user
+ * meant. The gate refuses to act when structure is ambiguous, and demands a
+ * vision second-opinion — so an action only fires when structure is confident
+ * OR vision confirms it. That is the route to ~100% accuracy on executed
+ * actions: never act on a guess.
+ */
+import { type ScreenGraph, type Warning } from '@visual-layer/core';
+import type { GroundResult, GroundCandidate } from './score.js';
+export type GroundingStatus = 'accepted' | 'needs_visual_confirm' | 'rejected';
+export interface GateOptions {
+    /** Min top-1 confidence to accept without visual confirm. Default 0.85. */
+    acceptConfidence?: number;
+    /** Min gap (top1 - top2 confidence) to accept. Default 0.2 — guards ties. */
+    minGap?: number;
+    /** Min top-1 confidence below which the verdict is rejected outright. Default 0.3. */
+    rejectConfidence?: number;
+    /** Treat duplicate_label among instruction matches as disqualifying. Default true. */
+    duplicateLabelBlocks?: boolean;
+}
+export interface GroundingVerdict {
+    status: GroundingStatus;
+    reason: string;
+    top?: GroundCandidate;
+    runnerUp?: GroundCandidate;
+    gap: number;
+    disqualifyingWarnings: Warning[];
+}
+export declare function gateGrounding(result: GroundResult, graph: ScreenGraph, opts?: GateOptions): GroundingVerdict;
+export interface VisualVerdict {
+    /** Did vision confirm the proposed target is correct? */
+    confirmed: boolean;
+    /** The interactable id vision points at. Overrides gate top when set. */
+    interactableId?: string;
+    confidence?: number;
+    reason?: string;
+}
+export type ConsensusStatus = 'act' | 'blocked' | 'needs_visual_confirm';
+export interface ConsensusResult {
+    status: ConsensusStatus;
+    interactableId?: string;
+    reason: string;
+}
+/**
+ * Combine a gate verdict with an optional vision second-opinion into the final
+ * action decision. accepted → act. rejected → blocked. needs_visual_confirm →
+ * act only if vision confirms (and points at a concrete target), else blocked.
+ */
+export declare function buildConsensus(verdict: GroundingVerdict, visual: VisualVerdict | null): ConsensusResult;
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,sBAAsB,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB,EAAE,OAAO,EAAE,CAAC;CAClC;AAoBD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,WAAgB,GACrB,gBAAgB,CAkElB;AAID,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,aAAa,GAAG,IAAI,GAC3B,eAAe,CAsBjB"}

package/dist/gate.js

@@ -0,0 +1,131 @@
+/**
+ * Grounding gate + consensus — the decision layer that turns a ranked
+ * candidate list into a safe-to-act verdict.
+ *
+ * Gate = structure-first confidence + top-1/top-2 gap + warning disqualifiers.
+ * Pure deterministic, no model calls. The vision second-opinion is supplied
+ * out-of-band by the consuming agent (Claude/Codex have native vision) via
+ * confirm_grounding, or by a plugged VisionVerifier; this module only emits the
+ * "look now" signal (status === 'needs_visual_confirm').
+ *
+ * Why a gate at all: the scorer is a heuristic blend (text/role/bbox/source).
+ * Heuristics rank well but cannot prove the top candidate is what the user
+ * meant. The gate refuses to act when structure is ambiguous, and demands a
+ * vision second-opinion — so an action only fires when structure is confident
+ * OR vision confirms it. That is the route to ~100% accuracy on executed
+ * actions: never act on a guess.
+ */
+import {} from '@visual-layer/core';
+const DEFAULTS = {
+    acceptConfidence: 0.85,
+    minGap: 0.2,
+    rejectConfidence: 0.3,
+    duplicateLabelBlocks: true,
+};
+/**
+ * Structural warning codes (from the captured graph) that make the whole graph
+ * unsafe to act on: incomplete bbox enrichment or no interactables at all.
+ */
+const STRUCTURAL_DISQUALIFY = new Set(['interactive_nodes_missing_bbox', 'no_interactables']);
+/**
+ * Instruction-scoped warning codes (from the grounding result) that flag
+ * ambiguity for THIS instruction specifically.
+ */
+const AMBIGUITY_DISQUALIFY = new Set(['duplicate_label', 'low_confidence']);
+export function gateGrounding(result, graph, opts = {}) {
+    const o = { ...DEFAULTS, ...opts };
+    const candidates = result.candidates;
+    if (candidates.length === 0) {
+        return {
+            status: 'rejected',
+            reason: 'no candidates matched the instruction',
+            gap: 0,
+            disqualifyingWarnings: [],
+        };
+    }
+    const top = candidates[0];
+    const runnerUp = candidates[1];
+    const gap = runnerUp ? round3(top.confidence - runnerUp.confidence) : 1;
+    // Disqualifiers split by scope:
+    //  - structural (graph.warnings): always disqualify — the data is incomplete.
+    //  - ambiguity (result.warnings): only disqualify when duplicateLabelBlocks.
+    const structural = graph.warnings.filter((w) => STRUCTURAL_DISQUALIFY.has(w.code));
+    const ambiguity = result.warnings.filter((w) => {
+        if (!AMBIGUITY_DISQUALIFY.has(w.code))
+            return false;
+        if (w.code === 'duplicate_label')
+            return o.duplicateLabelBlocks;
+        return true;
+    });
+    const disqualifying = [...structural, ...ambiguity];
+    if (top.confidence < o.rejectConfidence) {
+        return {
+            status: 'rejected',
+            reason: `top confidence ${top.confidence.toFixed(2)} < reject floor ${o.rejectConfidence}`,
+            top,
+            runnerUp,
+            gap,
+            disqualifyingWarnings: disqualifying,
+        };
+    }
+    const confidenceOk = top.confidence >= o.acceptConfidence;
+    const gapOk = gap >= o.minGap;
+    const warningsOk = disqualifying.length === 0;
+    if (confidenceOk && gapOk && warningsOk) {
+        return {
+            status: 'accepted',
+            reason: 'structure confident and unambiguous',
+            top,
+            runnerUp,
+            gap,
+            disqualifyingWarnings: disqualifying,
+        };
+    }
+    const reasons = [];
+    if (!confidenceOk)
+        reasons.push(`confidence ${top.confidence.toFixed(2)} < ${o.acceptConfidence}`);
+    if (!gapOk)
+        reasons.push(`gap ${gap.toFixed(2)} < ${o.minGap} (tie)`);
+    if (!warningsOk)
+        reasons.push(`${disqualifying.length} disqualifier(s): ${disqualifying.map((w) => w.code).join(', ')}`);
+    return {
+        status: 'needs_visual_confirm',
+        reason: reasons.join('; '),
+        top,
+        runnerUp,
+        gap,
+        disqualifyingWarnings: disqualifying,
+    };
+}
+/**
+ * Combine a gate verdict with an optional vision second-opinion into the final
+ * action decision. accepted → act. rejected → blocked. needs_visual_confirm →
+ * act only if vision confirms (and points at a concrete target), else blocked.
+ */
+export function buildConsensus(verdict, visual) {
+    if (verdict.status === 'accepted') {
+        return { status: 'act', interactableId: verdict.top?.interactableId, reason: 'structure accepted' };
+    }
+    if (verdict.status === 'rejected') {
+        return { status: 'blocked', reason: verdict.reason };
+    }
+    // needs_visual_confirm — vision is mandatory before acting.
+    if (!visual) {
+        return { status: 'needs_visual_confirm', reason: verdict.reason };
+    }
+    if (!visual.confirmed) {
+        return { status: 'blocked', reason: `vision rejected: ${visual.reason ?? 'no reason given'}` };
+    }
+    // Gate was ambiguous, so vision MUST name the target — do not silently fall
+    // back to the (ambiguous) structural top. The agent always has the candidate
+    // list with bboxes, so requiring an explicit id is safe and prevents acting
+    // on the very tie the gate flagged.
+    if (!visual.interactableId) {
+        return { status: 'blocked', reason: 'vision confirmed but named no target id' };
+    }
+    return { status: 'act', interactableId: visual.interactableId, reason: 'vision confirmed structure' };
+}
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+//# sourceMappingURL=gate.js.map

package/dist/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,5 +4,6 @@
 export * from './score.js';
 export * from './compare.js';
 export * from './eval.js';
+export * from './gate.js';
 export declare const GROUNDING_VERSION = "0.1.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,iBAAiB,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,iBAAiB,UAAU,CAAC"}

package/dist/index.js

@@ -4,5 +4,6 @@
 export * from './score.js';
 export * from './compare.js';
 export * from './eval.js';
+export * from './gate.js';
 export const GROUNDING_VERSION = '0.1.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAE1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC"}

package/dist/score.d.ts

@@ -19,6 +19,21 @@ export interface GroundOptions {
     minScore?: number;
     /** Weights for the composite blend. Need not sum to 1. */
     weights?: Partial<Record<keyof ScoreBreakdown, number>>;
+    /**
+     * Additive confidence bonus applied when a candidate is the SOLE token match
+     * for the instruction (no sibling shares a content token). Breaks ties where
+     * one element matches and the rest don't; identical-label duplicates stay tied
+     * (both match → neither unique → bonus 0 → gate escalates, as it should).
+     * Default 0.2.
+     */
+    uniqueBonus?: number;
+    /**
+     * Symmetric boost/penalty for ordinal/spatial cues ("top/bottom/left/right/
+     * first/last/2nd <label>"). When the cue resolves an ambiguous token-match
+     * set, the picked candidate gets +spatialBonus and its token-matcher siblings
+     * get -spatialBonus — opens the gate gap. Default 0.15.
+     */
+    spatialBonus?: number;
 }
 export interface GroundResult {
     candidates: GroundCandidate[];

package/dist/score.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAaD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAqEjH"}
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,cAAc,EAQpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAaD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CA+HjH"}

package/dist/score.js

@@ -3,7 +3,7 @@
  * instruction using structure-first signals: text similarity, role match, bbox
  * visibility, source confidence. No model calls (§5 grounding responsibilities).
  */
-import { compareText, contains as bboxContains, hasArea, blendConfidence, warn, } from '@visual-layer/core';
+import { compareText, tokenizeText, contains as bboxContains, hasArea, blendConfidence, clampConfidence, warn, } from '@visual-layer/core';
 const DEFAULT_WEIGHTS = { text: 0.6, role: 0.15, bbox: 0.1, source: 0.15 };
 const ROLE_HINTS = [
     { re: /\b(click|press|tap|hit)\b/i, roles: ['button', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'tab', 'treeitem'] },
@@ -25,33 +25,86 @@ export function groundInstruction(graph, instruction, opts = {}) {
         };
     }
     const hintedRoles = roleHintsFor(instruction);
+    const uniqueBonus = opts.uniqueBonus ?? 0.2;
+    const instrContent = contentTokens(instruction);
+    // Token-match set: candidates whose label shares ≥1 content token with the
+    // instruction (verbs/articles excluded so "click Save" matches on "save", not
+    // "click"). When exactly one candidate matches, it is the unique target.
+    const matchedIds = new Set();
+    for (const i of graph.interactables) {
+        const labelContent = contentTokens(labelFor(i));
+        for (const t of labelContent) {
+            if (instrContent.has(t)) {
+                matchedIds.add(i.id);
+                break;
+            }
+        }
+    }
+    const isUniqueTokenMatch = matchedIds.size === 1;
+    // Ordinal/spatial cue — resolves identical-label ties that uniqueness cannot
+    // (e.g. two "Save changes" buttons + "click the top Save"). Only engaged when
+    // the token-match set is ambiguous (≥2 matchers); a unique match is already
+    // resolved by the uniqueness bonus.
+    const spatialBonus = opts.spatialBonus ?? 0.15;
+    const cue = parseSpatialCue(instruction);
+    const tokenMatchers = graph.interactables.filter((i) => matchedIds.has(i.id));
+    const spatialPickId = cue && tokenMatchers.length > 1 ? pickSpatialId(tokenMatchers, cue) : null;
     const scored = graph.interactables.map((i) => {
         const label = labelFor(i);
         const text = compareText(instruction, label);
         const role = roleScore(i, hintedRoles);
         const bbox = bboxScore(i, graph.viewport);
         const source = sourceScore(i);
-        const confidence = blendConfidence([
+        const unique = isUniqueTokenMatch && matchedIds.has(i.id) ? 1 : 0;
+        let spatialDelta = 0;
+        let spatial = 0;
+        if (spatialPickId) {
+            if (i.id === spatialPickId) {
+                spatialDelta = spatialBonus;
+                spatial = 1;
+            }
+            else if (matchedIds.has(i.id)) {
+                // suppress the cue-losing siblings so the pick's lead clears minGap
+                spatialDelta = -spatialBonus;
+            }
+        }
+        const confidence = clampConfidence(blendConfidence([
             { value: text, weight: weights.text ?? 0 },
             { value: role, weight: weights.role ?? 0 },
             { value: bbox, weight: weights.bbox ?? 0 },
             { value: source, weight: weights.source ?? 0 },
-        ]);
-        return { inter: i, confidence, breakdown: { text, role, bbox, source } };
+        ]) +
+            unique * uniqueBonus +
+            spatialDelta);
+        return {
+            inter: i,
+            confidence,
+            unique,
+            spatial,
+            breakdown: { text, role, bbox, source, unique, spatial },
+        };
     });
     scored.sort((a, b) => b.confidence - a.confidence);
-    // duplicate-label detection among high scorers
+    // duplicate-label detection — scoped to token matches. Two unrelated
+    // elements that merely share a label (e.g. two "Save changes" buttons on the
+    // page) only matter when the instruction actually targets that label; a
+    // duplicate that the instruction does not reference must not block a unique
+    // match elsewhere (e.g. "click Cancel" with two Saves present). A spatial cue
+    // that resolves the tie ("click the top Save") suppresses the warning — the
+    // ambiguity is no longer unresolved.
     const labelCounts = new Map();
     for (const s of scored) {
-        if (s.confidence >= minScore) {
+        if (matchedIds.has(s.inter.id)) {
             const l = labelFor(s.inter);
             if (l)
                 labelCounts.set(l, (labelCounts.get(l) ?? 0) + 1);
         }
     }
-    for (const [label, count] of labelCounts) {
-        if (count > 1)
-            warnings.push(warn('duplicate_label', `"${label}" matched ${count}x`, undefined));
+    if (!spatialPickId) {
+        for (const [label, count] of labelCounts) {
+            if (count > 1)
+                warnings.push(warn('duplicate_label', `"${label}" matched ${count}x`, undefined));
+        }
     }
     const candidates = scored
         .filter((s) => s.confidence >= minScore)
@@ -67,6 +120,8 @@ export function groundInstruction(graph, instruction, opts = {}) {
             role: round3(s.breakdown.role),
             bbox: round3(s.breakdown.bbox),
             source: round3(s.breakdown.source),
+            unique: round3(s.unique),
+            spatial: round3(s.spatial),
         },
         sources: s.inter.source,
     }));
@@ -111,6 +166,97 @@ function sourceScore(i) {
         return 0.9;
     return 0.8;
 }
+/* ---------- uniqueness signal ---------- */
+// Instruction tokens that carry no target meaning (verbs/articles). Excluded
+// from the uniqueness match so a verb like "click" cannot make a verb-named
+// element ("Click counter") look like a target match.
+const STOPWORD_TOKENS = new Set([
+    'click', 'press', 'tap', 'hit', 'type', 'enter', 'input', 'fill', 'write',
+    'open', 'follow', 'visit', 'go', 'select', 'choose', 'pick', 'check', 'uncheck', 'toggle',
+    'the', 'a', 'an', 'and', 'or', 'to', 'on', 'in', 'at', 'of', 'for', 'with',
+    'it', 'this', 'that', 'please', 'me',
+]);
+function contentTokens(text) {
+    const out = new Set();
+    for (const t of tokenizeText(text)) {
+        if (!STOPWORD_TOKENS.has(t))
+            out.add(t);
+    }
+    return out;
+}
+/**
+ * Parse an ordinal/spatial cue from a natural-language instruction. Returns the
+ * first cue found (an instruction rarely carries two). Lowercased, word-boundary
+ * matched so "bottom" does not fire inside "bottomless".
+ */
+function parseSpatialCue(instruction) {
+    const t = ` ${instruction.toLowerCase()} `;
+    const nth = t.match(/\b(\d+)(?:st|nd|rd|th)\b/);
+    if (nth)
+        return { type: 'nth', n: parseInt(nth[1], 10) };
+    if (/\b(first|1st)\b/.test(t))
+        return { type: 'first' };
+    if (/\b(second|2nd)\b/.test(t))
+        return { type: 'nth', n: 2 };
+    if (/\b(third|3rd)\b/.test(t))
+        return { type: 'nth', n: 3 };
+    if (/\b(last|final)\b/.test(t))
+        return { type: 'last' };
+    if (/\b(top|topmost|upper)/.test(t))
+        return { type: 'top' };
+    if (/\b(bottom|bottommost|lower)/.test(t))
+        return { type: 'bottom' };
+    if (/\b(left|leftmost)/.test(t))
+        return { type: 'left' };
+    if (/\b(right|rightmost)/.test(t))
+        return { type: 'right' };
+    return null;
+}
+/**
+ * Pick the candidate id matching the spatial cue among the given matchers.
+ * Reading order = sort by top edge (y), then left edge (x). Returns null when
+ * an ordinal index exceeds the available count (cue unresolvable → stays tied).
+ */
+function pickSpatialId(matchers, cue) {
+    switch (cue.type) {
+        case 'top':
+            return extremaId(matchers, (i) => i.bbox[1], true);
+        case 'bottom':
+            return extremaId(matchers, (i) => i.bbox[1], false);
+        case 'left':
+            return extremaId(matchers, (i) => i.bbox[0], true);
+        case 'right':
+            return extremaId(matchers, (i) => i.bbox[0], false);
+        case 'first':
+            return readingOrder(matchers)[0]?.id ?? null;
+        case 'last': {
+            const order = readingOrder(matchers);
+            return order[order.length - 1]?.id ?? null;
+        }
+        case 'nth': {
+            const order = readingOrder(matchers);
+            return cue.n >= 1 && cue.n <= order.length ? order[cue.n - 1].id : null;
+        }
+    }
+}
+/** id of the element minimizing (min=true) or maximizing (min=false) `score`. */
+function extremaId(items, score, min) {
+    if (items.length === 0)
+        return null;
+    let pick = items[0];
+    let best = score(pick);
+    for (const i of items.slice(1)) {
+        const v = score(i);
+        if ((min && v < best) || (!min && v > best)) {
+            best = v;
+            pick = i;
+        }
+    }
+    return pick.id;
+}
+function readingOrder(items) {
+    return [...items].sort((a, b) => a.bbox[1] - b.bbox[1] || a.bbox[0] - b.bbox[0]);
+}
 function round3(n) {
     return Math.round(n * 1000) / 1000;
 }

package/dist/score.js.map

@@ -1 +1 @@
-{"version":3,"file":"score.js","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visual-layer/grounding",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Deterministic grounding scorer, compare_graphs, eval_grounding",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,7 @@
     "dist"
   ],
   "dependencies": {
-    "@visual-layer/core": "1.0.0"
+    "@visual-layer/core": "1.0.1"
   },
   "scripts": {
     "build": "tsc -b",