@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/geo/exifnote.js

@@ -0,0 +1,243 @@
+/**
+ * The app's own note of when and where, written into the photograph.
+ *
+ * A live capture through `<input capture>` on iOS hands the page a JPEG with
+ * an APP1 stub — orientation and nothing else — while a photo-roll pick
+ * carries the camera's full EXIF (Michael's iPhone 16 Pro, iOS 26.6.2,
+ * 2026-09-19). The page knows the moment and the place anyway: `nowAndHere`
+ * asks the browser as the shutter closes and the envelope carries the
+ * answer. But the oracle's stock before/after gate reads the photographs,
+ * not the envelope, so a live-capture cleanup was refused before any judge
+ * saw it.
+ *
+ * This writes that same note where the gate looks: a minimal, valid
+ * `Exif\0\0` TIFF block with `DateTimeOriginal` (+ its offset), a GPS IFD
+ * when the place is known, and `Software = "openhands-app"` so a reviewer
+ * can tell the app's note from a camera's. It **never overwrites a camera's
+ * own values**: a photograph that already says when and where is left
+ * untouched; one that says only one of the two keeps that value and gains
+ * the other. The orientation tag a stub carries is kept, so the picture
+ * still stands the right way up.
+ *
+ * As with everything EXIF, this is client-assisted evidence and says so:
+ * the note is the phone's testimony about itself, exactly as it was in the
+ * envelope — no more true, no less, only now where the check reads it.
+ *
+ * Little-endian TIFF, offsets relative to the TIFF header, values of four
+ * bytes or fewer inline, the rest in a data area after the IFDs — the shape
+ * `exif.ts` (and the oracle's port of it) reads.
+ */
+import { factsFromJpeg } from "./exif.js";
+import { exifSegment, withExifSegment } from "./exifcarry.js";
+export const NOTE_SOFTWARE = "openhands-app";
+const TAG_ORIENTATION = 0x0112;
+const TAG_SOFTWARE = 0x0131;
+const TAG_EXIF_IFD = 0x8769;
+const TAG_GPS_IFD = 0x8825;
+const TAG_DATE_ORIGINAL = 0x9003;
+const TAG_OFFSET_ORIGINAL = 0x9011;
+const TAG_GPS_VERSION = 0x0000;
+const TAG_LAT_REF = 0x0001;
+const TAG_LAT = 0x0002;
+const TAG_LON_REF = 0x0003;
+const TAG_LON = 0x0004;
+const BYTE = 1;
+const ASCII = 2;
+const SHORT = 3;
+const LONG = 4;
+const RATIONAL = 5;
+const le16 = (value) => [value & 0xff, (value >>> 8) & 0xff];
+const le32 = (value) => [value & 0xff, (value >>> 8) & 0xff, (value >>> 16) & 0xff, (value >>> 24) & 0xff];
+const asciiEntry = (tag, text) => {
+    const bytes = Uint8Array.from([...text].map((ch) => ch.charCodeAt(0) & 0x7f).concat(0));
+    return { tag, type: ASCII, count: bytes.length, data: bytes };
+};
+const shortEntry = (tag, value) => ({ tag, type: SHORT, count: 1, data: Uint8Array.from(le16(value)) });
+const longEntry = (tag, value) => ({ tag, type: LONG, count: 1, data: Uint8Array.from(le32(value)) });
+const bytesEntry = (tag, values) => ({ tag, type: BYTE, count: values.length, data: Uint8Array.from(values) });
+const rationalsEntry = (tag, pairs) => ({
+    tag,
+    type: RATIONAL,
+    count: pairs.length,
+    data: Uint8Array.from(pairs.flatMap(([numerator, denominator]) => [...le32(numerator), ...le32(denominator)]))
+});
+/** Degrees as the three positive rationals EXIF wants; the sign is the caller's letter. */
+export function dms(value) {
+    const abs = Math.abs(value);
+    const degrees = Math.floor(abs);
+    const minutesFull = (abs - degrees) * 60;
+    const minutes = Math.floor(minutesFull);
+    /* Seconds to a ten-thousandth — about three millimetres — as a rational. */
+    const seconds = Math.round((minutesFull - minutes) * 60 * 10_000);
+    return [
+        [degrees, 1, 0],
+        [minutes, 1, 0],
+        [seconds, 10_000, 0]
+    ];
+}
+/** An ISO instant, or a zone-less stamp read as UTC. Null when it is neither. */
+export function instantOf(at) {
+    const text = at.trim();
+    if (!text)
+        return null;
+    const zoned = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(text);
+    const ms = Date.parse(zoned ? text : `${text}Z`);
+    return Number.isFinite(ms) ? ms : null;
+}
+const two = (n) => String(n).padStart(2, "0");
+/** `YYYY:MM:DD HH:MM:SS` in the given offset, and the offset as EXIF writes it. */
+export function exifClock(instantMs, offsetMinutes) {
+    const local = new Date(instantMs + offsetMinutes * 60_000);
+    const stamp = `${local.getUTCFullYear()}:${two(local.getUTCMonth() + 1)}:${two(local.getUTCDate())} ${two(local.getUTCHours())}:${two(local.getUTCMinutes())}:${two(local.getUTCSeconds())}`;
+    const sign = offsetMinutes < 0 ? "-" : "+";
+    const abs = Math.abs(offsetMinutes);
+    return { stamp, offset: `${sign}${two(Math.floor(abs / 60))}:${two(abs % 60)}` };
+}
+/** The orientation a JPEG's existing APP1 carries, if any. */
+export function orientationOf(jpeg) {
+    const segment = exifSegment(jpeg);
+    if (!segment || segment.length < 10 + 8)
+        return null;
+    try {
+        const view = new DataView(segment.buffer, segment.byteOffset + 10, segment.byteLength - 10);
+        const order = view.getUint16(0, false);
+        if (order !== 0x4949 && order !== 0x4d4d)
+            return null;
+        const little = order === 0x4949;
+        const ifd0 = view.getUint32(4, little);
+        if (ifd0 + 2 > view.byteLength)
+            return null;
+        const count = view.getUint16(ifd0, little);
+        if (count > 200)
+            return null;
+        for (let index = 0; index < count; index += 1) {
+            const entry = ifd0 + 2 + index * 12;
+            if (entry + 12 > view.byteLength)
+                return null;
+            if (view.getUint16(entry, little) === TAG_ORIENTATION) {
+                const value = view.getUint16(entry + 8, little);
+                return value >= 1 && value <= 8 ? value : null;
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Serialise IFDs into one TIFF block: header, the tables in order, then every value that did not fit inline. */
+function tiff(ifds) {
+    const HEADER = 8;
+    const sizes = ifds.map((entries) => 2 + entries.length * 12 + 4);
+    const starts = [];
+    let at = HEADER;
+    for (const size of sizes) {
+        starts.push(at);
+        at += size;
+    }
+    const dataStart = at;
+    const data = [];
+    const tables = ifds.map((entries) => {
+        const table = [...le16(entries.length)];
+        for (const entry of [...entries].sort((a, b) => a.tag - b.tag)) {
+            table.push(...le16(entry.tag), ...le16(entry.type), ...le32(entry.count));
+            if (entry.data.length <= 4) {
+                table.push(...entry.data, ...new Array(4 - entry.data.length).fill(0));
+            }
+            else {
+                table.push(...le32(dataStart + data.length));
+                data.push(...entry.data);
+                if (data.length % 2 === 1)
+                    data.push(0);
+            }
+        }
+        table.push(...le32(0));
+        return table;
+    });
+    return Uint8Array.from([0x49, 0x49, ...le16(0x2a), ...le32(HEADER), ...tables.flat(), ...data]);
+}
+/** A complete `FF E1` APP1 segment holding the note. Exported for the tests; `noteJpeg` is the door. */
+export function noteSegment(parts) {
+    const ifd0 = [asciiEntry(TAG_SOFTWARE, parts.software ?? NOTE_SOFTWARE)];
+    if (parts.orientation)
+        ifd0.push(shortEntry(TAG_ORIENTATION, parts.orientation));
+    const ifds = [ifd0];
+    const exif = [];
+    if (parts.stamp)
+        exif.push(asciiEntry(TAG_DATE_ORIGINAL, parts.stamp));
+    if (parts.stamp && parts.offset)
+        exif.push(asciiEntry(TAG_OFFSET_ORIGINAL, parts.offset));
+    const gps = [];
+    if (parts.point) {
+        gps.push(bytesEntry(TAG_GPS_VERSION, [2, 3, 0, 0]));
+        gps.push(asciiEntry(TAG_LAT_REF, parts.point.lat < 0 ? "S" : "N"));
+        gps.push(rationalsEntry(TAG_LAT, dms(parts.point.lat).map(([n, d]) => [n, d])));
+        gps.push(asciiEntry(TAG_LON_REF, parts.point.lon < 0 ? "W" : "E"));
+        gps.push(rationalsEntry(TAG_LON, dms(parts.point.lon).map(([n, d]) => [n, d])));
+    }
+    /* The pointers need the tables' places, which depend only on entry counts. */
+    const HEADER = 8;
+    const ifd0Size = 2 + (ifd0.length + (exif.length ? 1 : 0) + (gps.length ? 1 : 0)) * 12 + 4;
+    let next = HEADER + ifd0Size;
+    if (exif.length) {
+        ifd0.push(longEntry(TAG_EXIF_IFD, next));
+        ifds.push(exif);
+        next += 2 + exif.length * 12 + 4;
+    }
+    if (gps.length) {
+        ifd0.push(longEntry(TAG_GPS_IFD, next));
+        ifds.push(gps);
+    }
+    const block = tiff(ifds);
+    const payload = [0x45, 0x78, 0x69, 0x66, 0, 0, ...block];
+    const length = payload.length + 2;
+    return Uint8Array.from([0xff, 0xe1, (length >>> 8) & 0xff, length & 0xff, ...payload]);
+}
+/**
+ * The note, written into a JPEG that lacks it.
+ *
+ * Untouched when the photograph already says when *and* where — a camera's
+ * word beats the page's. Otherwise the camera's value is kept for whichever
+ * of the two it did give, the note fills the other, and the orientation is
+ * carried over.
+ */
+export function noteJpeg(jpeg, note, options = {}) {
+    if (jpeg.length < 4 || jpeg[0] !== 0xff || jpeg[1] !== 0xd8)
+        return { bytes: jpeg, noted: false, why: "not-jpeg" };
+    const facts = factsFromJpeg(jpeg);
+    if (facts.takenAt && facts.point)
+        return { bytes: jpeg, noted: false, why: "camera-exif" };
+    let stamp;
+    let offset;
+    if (facts.takenAt) {
+        /* The camera's own local stamp, exactly as it wrote it — its offset is unknown and not invented. */
+        const [date, clock] = facts.takenAt.split("T");
+        stamp = `${date.replaceAll("-", ":")} ${clock ?? "00:00:00"}`;
+    }
+    else {
+        const instant = instantOf(note.at);
+        if (instant !== null) {
+            const offsetMinutes = options.offsetMinutes ?? -new Date(instant).getTimezoneOffset();
+            ({ stamp, offset } = exifClock(instant, offsetMinutes));
+        }
+    }
+    const point = facts.point ??
+        (typeof note.lat === "number" && typeof note.lon === "number" && Number.isFinite(note.lat) && Number.isFinite(note.lon) && Math.abs(note.lat) <= 90 && Math.abs(note.lon) <= 180
+            ? { lat: note.lat, lon: note.lon }
+            : null);
+    if (!stamp && !point)
+        return { bytes: jpeg, noted: false, why: "nothing-to-note" };
+    const segment = noteSegment({ stamp, offset, point, orientation: orientationOf(jpeg), software: options.software });
+    return { bytes: withExifSegment(jpeg, segment), noted: true, why: null };
+}
+/** The same, for a browser's `File`. A file that needed no note is returned as it was. */
+export async function noteFile(file, note, options = {}) {
+    if (file.type && !/^image\/jpe?g$/i.test(file.type))
+        return { file, noted: false, why: "not-jpeg" };
+    const bytes = new Uint8Array(await file.arrayBuffer());
+    const result = noteJpeg(bytes, note, options);
+    if (!result.noted)
+        return { file, noted: false, why: result.why };
+    return { file: new File([result.bytes], file.name || "photo.jpg", { type: "image/jpeg", lastModified: file.lastModified }), noted: true, why: null };
+}
+//# sourceMappingURL=exifnote.js.map

package/dist/esm/geo/exifnote.js.map

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

package/dist/esm/geo/mentions.d.ts

@@ -0,0 +1,44 @@
+import { type FoundPlace, type Reach } from "./search.ts";
+/** A word as the comparisons see it: lower case, accents off. "Smokuč" and "smokuc" are one word. */
+export declare const fold: (word: string) => string;
+/**
+ * The phrases a sentence puts after a word like *in* or *at*, in order, with
+ * leading articles and descriptions trimmed — and only those that hold at
+ * least one word that names something. At most three: a sentence that names
+ * more places than that is describing a route, and the first is where it
+ * starts.
+ */
+export declare function placeMentions(sentence: string): string[];
+/** Does a phrase say what kind of place it is, beside its name? "prešeren square" does; "Smokuč Slovenia" does not. */
+export declare const saysWhatItIs: (mention: string) => boolean;
+/**
+ * The first place the map answered that is called by the phrase's naming
+ * words. A town, a street, a park, a venue counts on one shared name. A shop
+ * or a hotel counts only when every naming word matches, and there are at
+ * least two: "Pekarna Kroštl" is somewhere to go; "bloom", in "a tree in
+ * bloom", is a florist in another country.
+ */
+export declare function placeCalled(mention: string, places: FoundPlace[]): FoundPlace | null;
+export interface NamedPlace {
+    /** The phrase as the sentence says it: "ljubljana, prešeren square". */
+    mention: string;
+    /** Where the map put it, when it could: the sheet opens on this. */
+    found: FoundPlace | null;
+}
+/**
+ * The place a sentence names, and whether the answer can be trusted.
+ *
+ * `named` is null when it names none — and null too when the map could not be
+ * asked about a phrase only the map could settle, because a lookup that
+ * failed is not a reason to refuse somebody's ask. `unsure` says which: an
+ * answer given while the map was unreachable is not one to cache. A phrase
+ * that says what it is ("… square") never needs the map to count, only to be
+ * found.
+ */
+export declare function placeIn(sentence: string, reach?: Reach): Promise<{
+    named: NamedPlace | null;
+    unsure: boolean;
+}>;
+/** The place a sentence names, or null. See `placeIn` for when null means "could not tell". */
+export declare const namedPlaceIn: (sentence: string, reach?: Reach) => Promise<NamedPlace | null>;
+//# sourceMappingURL=mentions.d.ts.map

package/dist/esm/geo/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../src/geo/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAwExE,qGAAqG;AACrG,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAIlB,CAAC;AAYnB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCxD;AAED,uHAAuH;AACvH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,OAAoF,CAAC;AAYpI;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAQpF;AAED,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAKD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBzH;AAED,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,EAAE,QAAO,KAAU,KAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAA2C,CAAC"}

package/dist/esm/geo/mentions.js

@@ -0,0 +1,190 @@
+import { searchPlaces } from "./search.js";
+/**
+ * Where a sentence says the work happens.
+ *
+ * Two asks were posted on 2026-10-06 that named a place and carried no
+ * geofence: "take a photo of the notice board in ljubljana, prešeren square"
+ * and "…the village noticeboard in Smokuč Slovenia". The cards said "From
+ * anywhere", truthfully, and the checker could not tell Smokuč from anywhere
+ * else. Peter's rule after it: **if an ask describes a place, a geofence is
+ * needed.** This is how the composer and the MCP find out that it does.
+ *
+ * Reading comes first and costs nothing: the phrase after *in, at, near,
+ * outside…*, kept only if it holds a word that names something rather than
+ * describing it ("Prešeren", "Smokuč", "Trubarjeva" — never "the park",
+ * "the morning", "good light"). A phrase that also holds a place noun
+ * ("square", "trg", "cesta", "street") is named on its face; that is how
+ * "prešeren square" counts, which the geocoder does not know by its English
+ * name. Anything else is asked of the map, at most twice per sentence, and
+ * counts only when the map answers with somewhere called by that word.
+ *
+ * It errs towards asking for a place. A false "this names a place" costs a
+ * poster one tap on a sheet or a reworded sentence; a missed one costs an ask
+ * whose location nobody can check.
+ */
+/** The words that put a place after them. Longest first, so "in front of" is read before "in". */
+const BEFORE = ["in front of", "next to", "outside", "opposite", "beside", "behind", "inside", "around", "along", "across", "near", "in", "at", "on", "by"];
+/**
+ * Words that end a place phrase: a new clause, a purpose, a time. Any word in
+ * `BEFORE` ends it too, and starts the next one. "to" and "from" end a phrase
+ * but never start one: "to check if…" would otherwise ask the map about a
+ * town called Check.
+ */
+const ENDS = new Set("and then to so with where which that who whose showing show for before after when if while from about because but or every each between during until within including plus how what whether as like it its is are was were be been has have had please can could should would will must may might do does did not no take make get go see check count find photograph photo picture snap shoot".split(" "));
+/** Words a place phrase may start with that are not part of the name. */
+const LEADING = new Set("the a an this that these those my your our their his her its some any one of".split(" "));
+/** Nouns that make a phrase a place on their own, beside a word that names it. */
+const PLACE_NOUNS = new Set("square sq trg plaza platz piazza street st cesta ulica ul road rd avenue ave lane boulevard blvd park garden gardens station church cathedral chapel bridge most beach market trznica village vas town mesto city river reka lake jezero castle grad museum school library harbour harbor port pier marina hill hrib mountain gora trail tower gate stadium mall airport cemetery embankment nabrezje promenade quay kino cinema theatre theater".split(" "));
+/**
+ * Words that describe rather than name. A phrase made only of these, articles
+ * and place nouns names nowhere in particular: "the park", "the main square",
+ * "my street", "the morning", "good light".
+ */
+const GENERIC = new Set([
+    ...PLACE_NOUNS,
+    ..."shop store stop corner centre center house home office building area place spot site entrance door window wall room kitchen desk table floor".split(" "),
+    ..."front back side top bottom left right middle north south east west local nearest nearby here there main old new big small little large".split(" "),
+    ..."notice board noticeboard sign bench bin bins tree trees field playground parking lot car bus train tram hospital hotel post bank supermarket pharmacy gym university campus neighbourhood neighborhood district block yard".split(" "),
+    ..."morning afternoon evening night today tonight tomorrow yesterday now weekend week month year hour hours minute minutes moment monday tuesday wednesday thursday friday saturday sunday am pm noon midnight time".split(" "),
+    ..."least most all focus daylight light dark detail english slovene camera hand person total general particular case order line view frame full clear sight public private good bad natural same".split(" "),
+    ..."red orange yellow green blue purple pink brown black white grey gray colour color".split(" "),
+    ..."favourite favorite usual nearest closest high low resolution quality".split(" "),
+    ..."phone camera app screen laptop computer paper website page link internet web email message chat".split(" "),
+    ..."cafe restaurant bar pub kiosk stall queue crowd traffic food drink coffee tea menu paint chalk ink costume dress shirt hat uniform bloom flower flowers rain snow sun shade water glass plastic metal wood stone box bag bottle cup plate stock sale use action motion progress".split(" ")
+]);
+/** Tokens of a sentence: words (letters, digits, apostrophes, hyphens) and the punctuation that ends a phrase. */
+const TOKENS = /[\p{L}\p{N}][\p{L}\p{N}'’-]*|[.,;:!?()"“”]/gu;
+/** A word as the comparisons see it: lower case, accents off. "Smokuč" and "smokuc" are one word. */
+export const fold = (word) => word
+    .normalize("NFD")
+    .replace(/\p{Mn}/gu, "")
+    .toLowerCase();
+const COORDINATES = /^-?\d{1,3}(\.\d+)?$/;
+/** Does this word name something, rather than describe it? */
+const naming = (word) => {
+    const folded = fold(word);
+    if (GENERIC.has(folded) || LEADING.has(folded) || ENDS.has(folded))
+        return false;
+    if (/^\d/.test(folded) || COORDINATES.test(folded))
+        return false;
+    return folded.length >= 3;
+};
+/**
+ * The phrases a sentence puts after a word like *in* or *at*, in order, with
+ * leading articles and descriptions trimmed — and only those that hold at
+ * least one word that names something. At most three: a sentence that names
+ * more places than that is describing a route, and the first is where it
+ * starts.
+ */
+export function placeMentions(sentence) {
+    const tokens = sentence.match(TOKENS) ?? [];
+    const lower = tokens.map(fold);
+    const found = [];
+    let index = 0;
+    while (index < tokens.length && found.length < 3) {
+        const starter = BEFORE.find((words) => {
+            const parts = words.split(" ");
+            return parts.every((part, offset) => lower[index + offset] === part);
+        });
+        if (!starter) {
+            index += 1;
+            continue;
+        }
+        index += starter.split(" ").length;
+        const phrase = [];
+        while (index < tokens.length && phrase.length < 7) {
+            const token = tokens[index];
+            const folded = lower[index];
+            if (/^[.;:!?()"“”]$/.test(token))
+                break;
+            if (ENDS.has(folded))
+                break;
+            if (BEFORE.some((words) => words.split(" ")[0] === folded))
+                break;
+            phrase.push(token);
+            index += 1;
+        }
+        /* "the top of Ljubljana Castle" is Ljubljana Castle; "Smokuč Slovenia," keeps its comma inside, never at the edge. */
+        while (phrase.length && (phrase[0] === "," || (!naming(phrase[0]) && !PLACE_NOUNS.has(fold(phrase[0])))))
+            phrase.shift();
+        while (phrase.length && phrase[phrase.length - 1] === ",")
+            phrase.pop();
+        if (!phrase.some(naming))
+            continue;
+        const text = phrase.join(" ").replace(/\s+,/g, ",");
+        if (!found.some((one) => fold(one) === fold(text)))
+            found.push(text);
+    }
+    return found;
+}
+/** Does a phrase say what kind of place it is, beside its name? "prešeren square" does; "Smokuč Slovenia" does not. */
+export const saysWhatItIs = (mention) => (mention.match(TOKENS) ?? []).some((word) => PLACE_NOUNS.has(fold(word)));
+/** What the map answers with that is not a place a person is sent to: a hotel called Morning, a shop called Bloom. */
+const NOT_A_PLACE = new Set(["tourism", "shop", "office", "craft", "building", "house", "club", "healthcare", "emergency"]);
+/**
+ * Two words are one name when they are equal, or long and share a stem —
+ * the way Slovene bends a name: "Prešeren" and "Prešernov", "Ljubljana" and
+ * "Ljubljani". Short words must be equal: "bloom" is not "Bloomfield".
+ */
+const sameName = (a, b) => a === b || (a.length >= 6 && b.length >= 6 && a.slice(0, 5) === b.slice(0, 5));
+/**
+ * The first place the map answered that is called by the phrase's naming
+ * words. A town, a street, a park, a venue counts on one shared name. A shop
+ * or a hotel counts only when every naming word matches, and there are at
+ * least two: "Pekarna Kroštl" is somewhere to go; "bloom", in "a tree in
+ * bloom", is a florist in another country.
+ */
+export function placeCalled(mention, places) {
+    const names = (mention.match(TOKENS) ?? []).filter(naming).map(fold);
+    for (const place of places) {
+        const called = (`${place.name} ${place.label}`.match(TOKENS) ?? []).map(fold);
+        const matches = (name) => called.some((word) => sameName(word, name));
+        if (NOT_A_PLACE.has(place.kind) ? names.length >= 2 && names.every(matches) : names.some(matches))
+            return place;
+    }
+    return null;
+}
+/** How many questions one sentence may put to the map. Nominatim allows one a second. */
+const ASKS_PER_SENTENCE = 2;
+/**
+ * The place a sentence names, and whether the answer can be trusted.
+ *
+ * `named` is null when it names none — and null too when the map could not be
+ * asked about a phrase only the map could settle, because a lookup that
+ * failed is not a reason to refuse somebody's ask. `unsure` says which: an
+ * answer given while the map was unreachable is not one to cache. A phrase
+ * that says what it is ("… square") never needs the map to count, only to be
+ * found.
+ */
+export async function placeIn(sentence, reach = {}) {
+    let asked = 0;
+    let failed = false;
+    const ask = async (query) => {
+        if (asked >= ASKS_PER_SENTENCE)
+            return [];
+        asked += 1;
+        const answer = await searchPlaces(query, reach);
+        if (answer === null)
+            failed = true;
+        return answer ?? [];
+    };
+    for (const mention of placeMentions(sentence)) {
+        if (saysWhatItIs(mention)) {
+            /* Named on its face. Find it if the map can — the whole phrase, then
+               the part before a comma ("ljubljana", of "ljubljana, prešeren square"),
+               so the sheet at least opens on the town. */
+            let found = placeCalled(mention, await ask(mention));
+            const first = mention.split(",")[0]?.trim();
+            if (!found && first && first !== mention)
+                found = placeCalled(first, await ask(first));
+            return { named: { mention, found }, unsure: false };
+        }
+        const found = placeCalled(mention, await ask(mention));
+        if (found)
+            return { named: { mention, found }, unsure: false };
+    }
+    return { named: null, unsure: failed };
+}
+/** The place a sentence names, or null. See `placeIn` for when null means "could not tell". */
+export const namedPlaceIn = async (sentence, reach = {}) => (await placeIn(sentence, reach)).named;
+//# sourceMappingURL=mentions.js.map

package/dist/esm/geo/mentions.js.map

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

package/dist/esm/geo/osm.d.ts

@@ -0,0 +1,112 @@
+import { type GeoBox } from "./box.ts";
+/**
+ * Reading what actually happened on the map.
+ *
+ * The premise of a verified mapping ask: the evidence is not a photograph, a
+ * phone's idea of where it is, or a sentence — it is **what appeared in
+ * OpenStreetMap**. That is public, it is attributed, and it cannot be faked
+ * by the person being paid without doing the work, which is the only kind of
+ * proof worth escrowing money against.
+ *
+ * Two questions, two APIs, and both are needed:
+ *
+ * - **Who edited here, and how much?** The changesets API. It answers with
+ *   changesets whose own bounding box *intersects* the query — so a huge
+ *   changeset merely grazing the area matches, and `changes_count` counts
+ *   every edit in it, most of them elsewhere. Attribution is trustworthy;
+ *   the edit count is an upper bound and is treated as one.
+ * - **What did the map gain?** Overpass, counting features of a tag newer
+ *   than a date. That is the number that says something happened.
+ *
+ * Neither is ours and both are volunteer-run. Failure is therefore ordinary,
+ * not exceptional: every function here answers `null` for "could not
+ * measure", never throws, and the gate that reads it treats null as *a person
+ * should look* rather than as a rejection. Punishing somebody because a free
+ * API was busy is exactly the unfairness this whole design exists to avoid.
+ */
+export interface Window {
+    from: string;
+    to: string;
+}
+export interface Changeset {
+    id: number;
+    user: string;
+    uid: number;
+    changes: number;
+    closedAt: string;
+    /** The changeset's own bounds, when it declares them. */
+    box: GeoBox | null;
+}
+export interface MapActivity {
+    /** Changesets that closed inside the window and overlap the box. */
+    changesets: Changeset[];
+    /** Distinct OSM usernames among them, lowercased for comparison. */
+    users: string[];
+}
+/** A tag we know how to count. Deliberately short — each is a real question. */
+export type FeatureTag = "building" | "highway";
+/** How the world is reached. Injected so tests never touch a live service. */
+export interface Reach {
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+}
+/**
+ * Who edited inside this box, in this window.
+ *
+ * Null means the API did not answer. An empty `changesets` array means it did
+ * answer and nobody edited — a fact, and a different one.
+ */
+export declare function changesetsIn(box: GeoBox, window: Window, reach?: Reach): Promise<MapActivity | null>;
+/** What one person did here, out of everything that happened. */
+export declare function creditFor(activity: MapActivity, username: string): {
+    changesets: number;
+    edits: number;
+};
+/**
+ * How many features of a tag the box has gained since a date.
+ *
+ * `out count` rather than the features themselves: a populated city block
+ * would otherwise be megabytes of geometry to answer a question about one
+ * integer, and the courtesy owed to a free service is the whole reason this
+ * asks so narrowly.
+ */
+export declare function featureDelta(box: GeoBox, sinceISO: string, tag: FeatureTag, reach?: Reach): Promise<number | null>;
+/**
+ * The whole measurement for a mapping gate: attribution and activity together.
+ *
+ * Both are needed and they answer different doubts. Changesets alone would
+ * pass somebody who edited the right box and changed nothing that matters;
+ * feature counts alone would pass somebody standing next to whoever did the
+ * work. Requiring both is what makes the pair worth escrowing against.
+ */
+export interface MapMeasurement {
+    username: string | null;
+    changesetsByUser: number;
+    editsByUser: number;
+    featureDelta: number | null;
+    users: string[];
+    /** True when either API declined to answer — the gate reads this as "ask a person". */
+    incomplete: boolean;
+}
+export declare function measureMapping(args: {
+    box: GeoBox;
+    window: Window;
+    tag: FeatureTag;
+    username?: string | null;
+}, reach?: Reach): Promise<MapMeasurement>;
+/**
+ * The OpenStreetMap account a worker asks to be credited.
+ *
+ * Read leniently on purpose: this is the one fact the map reading cannot
+ * supply for itself, and a mapper who wrote their name plainly should not
+ * lose a bounty to a format. Any of these is enough —
+ *
+ *   osm: alice        OSM user alice        @alice
+ *   openstreetmap.org/user/alice
+ *
+ * — and nothing else is guessed. A deliverable that names no account fails
+ * the gate rather than crediting whoever happens to have been mapping there,
+ * which would pay the wrong person for real work.
+ */
+export declare function osmUsernameIn(deliverable: string): string | null;
+//# sourceMappingURL=osm.d.ts.map

package/dist/esm/geo/osm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"osm.d.ts","sourceRoot":"","sources":["../../../src/geo/osm.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AA4BhD,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA2C9G;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIxG;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4B5H;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAajK;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAchE"}