@nuanu-ai/agentbrowse 0.2.7 → 0.2.8

package/dist/commands/observe-persistence.d.ts

@@ -0,0 +1,14 @@
+import type { BrowseSession } from '../session.js';
+import type { SurfaceDescriptor, TargetDescriptor } from '../runtime-state.js';
+import type { DomObservedTarget } from './observe-inventory.js';
+export declare function toDomDescriptor(pageRef: string, target: DomObservedTarget, surfaceRefMap: ReadonlyMap<string, string>): Omit<TargetDescriptor, 'ref'>;
+export declare function attachObservedTargetOwners(domTargets: ReadonlyArray<DomObservedTarget>, targets: TargetDescriptor[]): void;
+export declare function persistObservedSurfacesForPage(session: BrowseSession, pageRef: string, targets: ReadonlyArray<DomObservedTarget>, options?: {
+    allSurfaceInputs?: ReadonlyArray<Omit<SurfaceDescriptor, 'ref'>>;
+    explicitSurfaceIds?: ReadonlySet<string>;
+}): {
+    observedScopes: SurfaceDescriptor[];
+    surfaceRefMap: Map<string, string>;
+};
+export declare function reconcileObservedTargetsForPage(session: BrowseSession, pageRef: string, observedTargets: ReadonlyArray<Pick<TargetDescriptor, 'ref'>>): void;
+//# sourceMappingURL=observe-persistence.d.ts.map

package/dist/commands/observe-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-persistence.d.ts","sourceRoot":"","sources":["../../src/commands/observe-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,OAAO,KAAK,EAAoB,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAmF/B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,OAAO,EAAE,gBAAgB,EAAE,GAC1B,IAAI,CAYN;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,OAAO,CAAC,EAAE;IACR,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC;IACjE,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C,GACA;IACD,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAgEA;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,GAC5D,IAAI,CAsBN"}

package/dist/commands/observe-persistence.js

@@ -0,0 +1,170 @@
+import { ensureRuntimeState, markSurfaceLifecycle, markTargetLifecycle, replaceSurfacesForPage, setSurfaceAvailability, setTargetAvailability, } from '../runtime-state.js';
+import { collectSurfaceDescriptors, pushUniqueLocatorCandidate, surfaceReplacementKey } from './observe-surfaces.js';
+export function toDomDescriptor(pageRef, target, surfaceRefMap) {
+    const locatorCandidates = [];
+    if (target.role && target.label) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'role',
+            value: target.role,
+            name: target.label,
+        });
+    }
+    if (target.label) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'label',
+            value: target.label,
+        });
+    }
+    if (target.placeholder) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'placeholder',
+            value: target.placeholder,
+        });
+    }
+    if (target.text) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'text',
+            value: target.text,
+        });
+    }
+    if (target.title) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'title',
+            value: target.title,
+        });
+    }
+    if (target.testId) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: 'testId',
+            value: target.testId,
+            attribute: target.testIdAttribute,
+        });
+    }
+    if (target.selector) {
+        pushUniqueLocatorCandidate(locatorCandidates, {
+            strategy: target.selector.startsWith('xpath=') ? 'xpath' : 'css',
+            value: target.selector,
+            scope: 'root',
+        });
+    }
+    return {
+        pageRef,
+        framePath: target.framePath,
+        frameUrl: target.frameUrl,
+        kind: target.kind,
+        label: target.label ?? target.text ?? target.placeholder ?? target.title,
+        displayLabel: target.displayLabel,
+        placeholder: target.placeholder,
+        inputName: target.inputName,
+        inputType: target.inputType,
+        autocomplete: target.autocomplete,
+        validation: target.validation,
+        locatorCandidates,
+        semantics: target.role || target.label || target.states
+            ? {
+                role: target.role,
+                name: target.label,
+                states: target.states,
+                source: 'dom',
+            }
+            : undefined,
+        structure: target.structure,
+        context: target.context,
+        capability: target.capability ?? 'actionable',
+        lifecycle: 'live',
+        availability: target.availability ?? { state: 'available' },
+        allowedActions: target.allowedActions ?? [],
+        acceptancePolicy: target.acceptancePolicy,
+        surfaceRef: target.surfaceRef ? surfaceRefMap.get(target.surfaceRef) : undefined,
+        createdAt: Date.now(),
+        pageSignature: target.pageSignature,
+        domSignature: target.domSignature,
+    };
+}
+export function attachObservedTargetOwners(domTargets, targets) {
+    for (const [index, observedTarget] of domTargets.entries()) {
+        if (typeof observedTarget.ownerIndex !== 'number') {
+            continue;
+        }
+        const ownerSlot = domTargets.findIndex((candidate) => candidate.ordinal === observedTarget.ownerIndex);
+        if (ownerSlot >= 0 && targets[ownerSlot]) {
+            targets[index].ownerRef = targets[ownerSlot].ref;
+        }
+    }
+}
+export function persistObservedSurfacesForPage(session, pageRef, targets, options) {
+    const runtime = ensureRuntimeState(session);
+    const derivedSurfaces = collectSurfaceDescriptors(pageRef, targets);
+    const descriptors = new Map();
+    for (const surface of derivedSurfaces) {
+        descriptors.set(surface.surfaceId, surface);
+    }
+    for (const surface of options?.allSurfaceInputs ?? []) {
+        if (!options?.explicitSurfaceIds?.has(surface.surfaceId)) {
+            continue;
+        }
+        if (!descriptors.has(surface.surfaceId)) {
+            descriptors.set(surface.surfaceId, surface);
+        }
+    }
+    const observedScopes = replaceSurfacesForPage(session, pageRef, [...descriptors.values()], {
+        preserveExistingOnEmpty: false,
+        preserveExisting: true,
+    });
+    const activeSurfaceRefs = new Set(observedScopes.map((scope) => scope.ref));
+    const activeSurfaceSlots = new Set(observedScopes.map((scope) => surfaceReplacementKey(scope)));
+    for (const surface of Object.values(runtime.surfaces)) {
+        if (surface.pageRef !== pageRef)
+            continue;
+        if (activeSurfaceRefs.has(surface.ref)) {
+            markSurfaceLifecycle(session, surface.ref, 'live');
+            setSurfaceAvailability(session, surface.ref, 'available');
+        }
+        else if (activeSurfaceSlots.has(surfaceReplacementKey(surface))) {
+            markSurfaceLifecycle(session, surface.ref, 'invalidated', 'surface-replaced');
+            setSurfaceAvailability(session, surface.ref, 'hidden', 'surface-replaced');
+        }
+        else {
+            setSurfaceAvailability(session, surface.ref, 'hidden', 'surface-not-observed');
+        }
+    }
+    for (const target of Object.values(runtime.targets)) {
+        if (target.pageRef !== pageRef || !target.surfaceRef)
+            continue;
+        if (activeSurfaceRefs.has(target.surfaceRef)) {
+            continue;
+        }
+        const linkedSurface = runtime.surfaces[target.surfaceRef];
+        if (linkedSurface?.lifecycle === 'invalidated') {
+            markTargetLifecycle(session, target.ref, 'invalidated', linkedSurface.lifecycleReason);
+            setTargetAvailability(session, target.ref, 'hidden', linkedSurface.lifecycleReason ?? 'surface-replaced');
+        }
+        else {
+            setTargetAvailability(session, target.ref, 'surface-inactive', 'surface-not-observed');
+        }
+    }
+    return {
+        observedScopes,
+        surfaceRefMap: new Map(observedScopes.map((scope) => [scope.surfaceId, scope.ref])),
+    };
+}
+export function reconcileObservedTargetsForPage(session, pageRef, observedTargets) {
+    const runtime = ensureRuntimeState(session);
+    const activeTargetRefs = new Set(observedTargets.map((target) => target.ref));
+    for (const target of Object.values(runtime.targets)) {
+        if (target.pageRef !== pageRef || activeTargetRefs.has(target.ref)) {
+            continue;
+        }
+        const linkedSurface = target.surfaceRef ? runtime.surfaces[target.surfaceRef] : null;
+        if (linkedSurface) {
+            if (linkedSurface.lifecycle === 'invalidated') {
+                continue;
+            }
+            if (linkedSurface.availability.state !== 'available') {
+                continue;
+            }
+        }
+        markTargetLifecycle(session, target.ref, 'stale', 'target-not-observed');
+        setTargetAvailability(session, target.ref, 'hidden', 'target-not-observed');
+    }
+}

package/dist/commands/observe-projection.d.ts

@@ -0,0 +1,84 @@
+import type { SurfaceDescriptor, TargetDescriptor, TargetValidationEvidence } from '../runtime-state.js';
+import type { PersistedFillableForm, ProtectedBindingValueHint } from '../secrets/types.js';
+import type { DomObservedTarget, ObservedPageSignal } from './observe-inventory.js';
+export type GoalObserveScopeCandidate = {
+    goalInventoryType: 'scope';
+    goalSurfaceId: string;
+    kind?: string;
+    label?: string;
+    capability: 'scope';
+    surfaceRef?: string;
+    surfacePriority?: number;
+    framePath?: string[];
+    frameUrl?: string;
+    pageSignature?: string;
+    context?: TargetDescriptor['context'];
+    structure?: TargetDescriptor['structure'];
+};
+export type GoalObserveTargetCandidate = DomObservedTarget & {
+    goalInventoryType: 'target';
+    goalTargetKey: string;
+};
+export type GoalObserveInventoryCandidate = GoalObserveTargetCandidate | GoalObserveScopeCandidate;
+export declare function compactTargets(targets: ReadonlyArray<Pick<TargetDescriptor, 'ref' | 'kind' | 'label' | 'displayLabel' | 'placeholder' | 'inputName' | 'inputType' | 'autocomplete' | 'validation' | 'context' | 'semantics' | 'structure' | 'capability' | 'availability'>>): Array<{
+    ref: string;
+    kind?: string;
+    label?: string;
+    displayLabel?: string;
+    placeholder?: string;
+    inputName?: string;
+    inputType?: string;
+    autocomplete?: string;
+    validation?: TargetValidationEvidence;
+    context?: string;
+    state?: Record<string, string | boolean | number>;
+    structure?: TargetDescriptor['structure'];
+    capability?: TargetDescriptor['capability'];
+    availability?: string;
+    availabilityReason?: string;
+    source?: 'dom' | 'stagehand' | 'aria-snapshot' | 'cdp-ax';
+}>;
+export declare function compactScopes(scopes: ReadonlyArray<Pick<SurfaceDescriptor, 'ref' | 'kind' | 'label' | 'availability'>>): Array<{
+    ref: string;
+    kind?: string;
+    label?: string;
+    capability: 'scope';
+    availability?: string;
+    availabilityReason?: string;
+    source: 'dom';
+}>;
+export declare function compactFillableForms(forms: ReadonlyArray<PersistedFillableForm>): Array<{
+    fillRef: string;
+    scopeRef?: string;
+    purpose: string;
+    recommendedTiming?: 'late';
+    fields: Array<{
+        fieldKey: string;
+        targetRef: string;
+        label?: string;
+        required?: boolean;
+        valueHint?: ProtectedBindingValueHint;
+    }>;
+    storedSecretCandidates: Array<{
+        storedSecretRef: string;
+        kind: string;
+        scope: string;
+        displayName: string;
+        matchConfidence: 'high' | 'medium' | 'low';
+        intentRequired: boolean;
+    }>;
+}>;
+export declare function compactSignals(signals: ReadonlyArray<ObservedPageSignal>): Array<{
+    kind: ObservedPageSignal['kind'];
+    text: string;
+    framePath?: string[];
+    source: 'dom';
+}>;
+export declare function buildGoalObserveInventoryCandidates(targets: ReadonlyArray<DomObservedTarget>, surfaces: ReadonlyArray<Omit<SurfaceDescriptor, 'ref'>>): GoalObserveInventoryCandidate[];
+export declare function selectTargetsForGoalMatches(allTargets: ReadonlyArray<DomObservedTarget>, rerankedCandidates: ReadonlyArray<GoalObserveInventoryCandidate>): {
+    targets: DomObservedTarget[];
+    selectedSurfaceIds: Set<string>;
+};
+export declare function buildExplicitScopeRefs(selectedSurfaceIds: ReadonlySet<string>, surfaceRefMap: ReadonlyMap<string, string>): Set<string>;
+export declare function projectPersistedTargetsForGoal(domTargets: ReadonlyArray<DomObservedTarget>, persistedTargets: ReadonlyArray<TargetDescriptor>, selectedTargets: ReadonlyArray<DomObservedTarget>): TargetDescriptor[];
+//# sourceMappingURL=observe-projection.d.ts.map

package/dist/commands/observe-projection.d.ts.map

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

package/dist/commands/observe-projection.js

@@ -0,0 +1,140 @@
+import { observedTargetKey } from './observe-semantics.js';
+import { summarizeContext } from './observe-surfaces.js';
+export function compactTargets(targets) {
+    return targets.map((target) => ({
+        ref: target.ref,
+        kind: target.kind,
+        label: target.label,
+        displayLabel: target.displayLabel,
+        placeholder: target.placeholder,
+        inputName: target.inputName,
+        inputType: target.inputType,
+        autocomplete: target.autocomplete,
+        validation: target.validation,
+        context: summarizeContext(target.context),
+        state: target.semantics?.states,
+        structure: target.structure,
+        capability: target.capability,
+        availability: target.availability?.state,
+        availabilityReason: target.availability?.reason,
+        source: target.semantics?.source,
+    }));
+}
+export function compactScopes(scopes) {
+    return scopes.map((scope) => ({
+        ref: scope.ref,
+        kind: scope.kind,
+        label: scope.label,
+        capability: 'scope',
+        availability: scope.availability?.state,
+        availabilityReason: scope.availability?.reason,
+        source: 'dom',
+    }));
+}
+export function compactFillableForms(forms) {
+    return forms.map((form) => ({
+        fillRef: form.fillRef,
+        scopeRef: form.scopeRef,
+        purpose: form.purpose,
+        recommendedTiming: form.recommendedTiming,
+        fields: form.fields.map((field) => ({
+            fieldKey: field.fieldKey,
+            targetRef: field.targetRef,
+            label: field.label,
+            required: field.required,
+            valueHint: field.valueHint,
+        })),
+        storedSecretCandidates: form.storedSecretCandidates.map((candidate) => ({
+            storedSecretRef: candidate.storedSecretRef,
+            kind: candidate.kind,
+            scope: candidate.scope,
+            displayName: candidate.displayName,
+            matchConfidence: candidate.matchConfidence,
+            intentRequired: candidate.intentRequired,
+        })),
+    }));
+}
+export function compactSignals(signals) {
+    return signals.map((signal) => ({
+        kind: signal.kind,
+        text: signal.text,
+        framePath: signal.framePath,
+        source: signal.source,
+    }));
+}
+export function buildGoalObserveInventoryCandidates(targets, surfaces) {
+    const targetCandidates = targets.map((target) => ({
+        ...target,
+        goalInventoryType: 'target',
+        goalTargetKey: observedTargetKey(target),
+    }));
+    const scopeCandidates = surfaces.map((surface) => {
+        const linkedTargets = targets.filter((target) => target.surfaceRef === surface.surfaceId);
+        const primaryLinkedTarget = linkedTargets[0];
+        return {
+            goalInventoryType: 'scope',
+            goalSurfaceId: surface.surfaceId,
+            kind: surface.kind,
+            label: surface.label,
+            capability: 'scope',
+            surfaceRef: `scope:${surface.surfaceId}`,
+            surfacePriority: linkedTargets.reduce((best, target) => Math.max(best, target.surfacePriority ?? 0), 0) ||
+                undefined,
+            framePath: surface.framePath,
+            frameUrl: surface.frameUrl,
+            pageSignature: surface.pageSignature,
+            context: primaryLinkedTarget?.context,
+            structure: primaryLinkedTarget?.structure,
+        };
+    });
+    return [...targetCandidates, ...scopeCandidates];
+}
+function isGoalObserveTargetCandidate(candidate) {
+    return candidate.goalInventoryType === 'target';
+}
+function isGoalObserveScopeCandidate(candidate) {
+    return candidate.goalInventoryType === 'scope';
+}
+export function selectTargetsForGoalMatches(allTargets, rerankedCandidates) {
+    const directTargetOrdinals = new Set(rerankedCandidates
+        .filter(isGoalObserveTargetCandidate)
+        .map((candidate) => candidate.ordinal)
+        .filter((value) => typeof value === 'number'));
+    const directTargetKeys = new Set(rerankedCandidates
+        .filter(isGoalObserveTargetCandidate)
+        .map((candidate) => candidate.goalTargetKey)
+        .filter((value) => typeof value === 'string' && value.length > 0));
+    const selectedSurfaceIds = new Set(rerankedCandidates
+        .filter(isGoalObserveScopeCandidate)
+        .map((candidate) => candidate.goalSurfaceId));
+    const mergedTargets = allTargets.filter((target) => {
+        const directMatch = typeof target.ordinal === 'number' && directTargetOrdinals.has(target.ordinal);
+        const directKeyMatch = directTargetKeys.has(observedTargetKey(target));
+        const scopeMatch = target.surfaceRef ? selectedSurfaceIds.has(target.surfaceRef) : false;
+        return directMatch || directKeyMatch || scopeMatch;
+    });
+    return {
+        targets: mergedTargets,
+        selectedSurfaceIds,
+    };
+}
+export function buildExplicitScopeRefs(selectedSurfaceIds, surfaceRefMap) {
+    return new Set([...selectedSurfaceIds]
+        .map((surfaceId) => surfaceRefMap.get(surfaceId))
+        .filter((value) => typeof value === 'string' && value.length > 0));
+}
+export function projectPersistedTargetsForGoal(domTargets, persistedTargets, selectedTargets) {
+    const selectedOrdinals = new Set(selectedTargets
+        .map((target) => target.ordinal)
+        .filter((value) => typeof value === 'number'));
+    const selectedKeys = new Set(selectedTargets.map((target) => observedTargetKey(target)));
+    return persistedTargets.filter((target, index) => {
+        const domTarget = domTargets[index];
+        if (!domTarget) {
+            return false;
+        }
+        const ordinalMatch = typeof domTarget.ordinal === 'number' && selectedOrdinals.has(domTarget.ordinal);
+        const keyMatch = selectedKeys.has(observedTargetKey(domTarget));
+        return ordinalMatch || keyMatch;
+    });
+}

package/dist/commands/observe-protected.d.ts

@@ -0,0 +1,5 @@
+import type { BrowseSession } from '../session.js';
+import type { TargetDescriptor } from '../runtime-state.js';
+export declare function persistProtectedFillableFormsForPage(session: BrowseSession, pageRef: string, pageUrl: string, targets: ReadonlyArray<TargetDescriptor>, observedAt: string): Promise<import("../secrets/types.js").PersistedFillableForm[]>;
+export declare function clearProtectedFillableFormsForPage(session: BrowseSession, pageRef: string): import("../secrets/types.js").PersistedFillableForm[];
+//# sourceMappingURL=observe-protected.d.ts.map

package/dist/commands/observe-protected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-protected.d.ts","sourceRoot":"","sources":["../../src/commands/observe-protected.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,EACxC,UAAU,EAAE,MAAM,kEAWnB;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,yDAIzF"}

package/dist/commands/observe-protected.js

@@ -0,0 +1,18 @@
+import { getSecretCatalog, replaceFillableFormsForPage } from '../runtime-state.js';
+import { tryResolveCatalogHost } from '../secrets/catalog-sync.js';
+import { matchStoredSecretsToObservedTargets } from '../secrets/form-matcher.js';
+export async function persistProtectedFillableFormsForPage(session, pageRef, pageUrl, targets, observedAt) {
+    const host = tryResolveCatalogHost(pageUrl);
+    const catalog = host ? getSecretCatalog(session, host) : null;
+    const matchedForms = await matchStoredSecretsToObservedTargets(pageRef, targets, catalog, {
+        observedAt,
+    });
+    return replaceFillableFormsForPage(session, pageRef, matchedForms, {
+        preserveExistingOnEmpty: false,
+    });
+}
+export function clearProtectedFillableFormsForPage(session, pageRef) {
+    return replaceFillableFormsForPage(session, pageRef, [], {
+        preserveExistingOnEmpty: false,
+    });
+}

package/dist/commands/observe-semantics.d.ts

@@ -0,0 +1,10 @@
+import type { DomObservedTarget } from './observe-inventory.js';
+export declare function normalizeSemanticDuplicateLabel(target: DomObservedTarget): string;
+export declare function isPrimaryFormControlTarget(target: DomObservedTarget): boolean;
+export declare function formGroupingKeyOf(target: DomObservedTarget): string | undefined;
+export declare function observedTargetKey(target: DomObservedTarget): string;
+export declare function expandRerankedFormTargets(targets: ReadonlyArray<DomObservedTarget>, selectedTargets: ReadonlyArray<DomObservedTarget>): DomObservedTarget[];
+export declare function compressSemanticallyDuplicateTargets(targets: ReadonlyArray<DomObservedTarget>): DomObservedTarget[];
+export declare function annotateDomTargets(targets: ReadonlyArray<DomObservedTarget>): DomObservedTarget[];
+export declare function orderBySurfaceCompetition(targets: ReadonlyArray<DomObservedTarget>): DomObservedTarget[];
+//# sourceMappingURL=observe-semantics.d.ts.map

package/dist/commands/observe-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-semantics.d.ts","sourceRoot":"","sources":["../../src/commands/observe-semantics.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAYjF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CA6B7E;AAgBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAQ/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAMnE;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,eAAe,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAChD,iBAAiB,EAAE,CAyCrB;AAqBD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACxC,iBAAiB,EAAE,CAuBrB;AAkGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAAE,CAmDjG;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACxC,iBAAiB,EAAE,CAsFrB"}