@dromney/mapthis 0.1.0 → 0.2.0

package/README.md

@@ -6,50 +6,131 @@ Open-source location intelligence toolkit. Parse freeform text, HTML, and URLs i
 npm install @dromney/mapthis
 ```
 
-## Subpath exports
+You'll also want one or more optional peer deps (see [Subpath exports](#subpath-exports)):
 
-`@dromney/mapthis` ships a root entry plus focused subpaths so consumers only load what they use.
+```bash
+# pick what you use:
+npm install openai js-tiktoken                       # @dromney/mapthis/ai (OpenAI)
+npm install @anthropic-ai/sdk js-tiktoken            # @dromney/mapthis/ai (Anthropic)
+npm install @googlemaps/google-maps-services-js      # @dromney/mapthis/geocoding
+npm install html-to-text                             # @dromney/mapthis/scrape
+npm install react react-dom @vis.gl/react-google-maps  # @dromney/mapthis/react
+```
 
-| Subpath | What it contains | Status |
-|---|---|---|
-| `@dromney/mapthis` | Re-exports types + utils (lightweight only) | 0.1 |
-| `@dromney/mapthis/types` | Zod schemas and plain TS domain types (`PlaceMap`, `Place`, `PlaceGroup`, `Partner`, `ParsedLocation`, ...) | 0.1 |
-| `@dromney/mapthis/utils` | Pure helpers: text, color, numbers, geo, stopwatch | 0.1 |
-| `@dromney/mapthis/scrape` | `getHtmlFromUrl`, `htmlToText`, `getTextFromUrl` | 0.1 |
-| `@dromney/mapthis/search` | `createSearchClient` (Google Custom Search) | 0.1 |
-| `@dromney/mapthis/ai` | `createLocationParser`, `createOpenAiBackend`, `summarizeText`, prompts | 0.1 |
-| `@dromney/mapthis/geocoding` | `createGeocoder` (Google Maps) with pluggable `GeocodingProvider` | 0.1 |
-| `@dromney/mapthis/generate` | `createMapGenerator` — composes parser + geocoder into a pure orchestrator | 0.1 |
-| `@dromney/mapthis/react` | `MapProvider`, `GoogleMapsViewer`, `PlaceMarker`, autofit, browser autocomplete | 0.1 |
-
-## Usage
+## Quick start
 
 ```ts
-import { cities } from "@dromney/mapthis/utils"
-import { placesFromUrl, type Coordinates } from "@dromney/mapthis/types"
-
 import { createLocationParser } from "@dromney/mapthis/ai"
 import { createGeocoder } from "@dromney/mapthis/geocoding"
 import { createMapGenerator } from "@dromney/mapthis/generate"
 
 const generator = createMapGenerator({
-  parser: createLocationParser({ apiKey: process.env.OPENAI_API_KEY! }),
-  geocoder: createGeocoder({ provider: "google", apiKey: process.env.GOOGLE_MAPS_KEY! }),
+    parser: createLocationParser({ apiKey: process.env.OPENAI_API_KEY! }),
+    geocoder: createGeocoder({ provider: "google", apiKey: process.env.GOOGLE_MAPS_KEY! }),
 })
 
 const result = await generator.generateFromSource({
-  sourceType: "url",
-  source: "https://example.com/best-restaurants-tokyo",
+    sourceType: "url",
+    source: "https://example.com/best-restaurants-tokyo",
 })
-// result.title, result.places[].data?.lat, result.usage.inputTokens, ...
+
+console.log(result.title)
+for (const p of result.places) {
+    if (p.data) console.log(p.data.name, p.data.lat, p.data.lng)
+    else console.warn("could not geocode", p.input.address, "—", p.error)
+}
 ```
 
+`sourceType` accepts `"url"`, `"text"`, or `"list"`. For `"list"`, each newline-separated entry is geocoded directly with no LLM call (and no LLM cost).
+
+## Subpath exports
+
+`@dromney/mapthis` ships a root entry plus focused subpaths so consumers only load what they use.
+
+| Subpath | What it contains | Optional peer deps |
+|---|---|---|
+| `@dromney/mapthis` | Re-exports types + utils (lightweight only) | — |
+| `@dromney/mapthis/types` | Zod schemas + TS domain types (`PlaceMap`, `Place`, `PlaceGroup`, `Partner`, `ParsedLocation`, `Coordinates`, …) | — |
+| `@dromney/mapthis/utils` | Pure helpers: text, color, numbers, geo, stopwatch | — |
+| `@dromney/mapthis/scrape` | `getHtmlFromUrl`, `htmlToText`, `getTextFromUrl` | `html-to-text` |
+| `@dromney/mapthis/search` | `createSearchClient` (Google Custom Search) | — |
+| `@dromney/mapthis/ai` | `createLocationParser`, `createOpenAiBackend`, `createAnthropicBackend`, `summarizeText`, prompts | `openai` or `@anthropic-ai/sdk`, plus `js-tiktoken` |
+| `@dromney/mapthis/geocoding` | `createGeocoder` (Google Maps) with pluggable `GeocodingProvider` | `@googlemaps/google-maps-services-js` |
+| `@dromney/mapthis/generate` | `createMapGenerator` — composes parser + geocoder into a pure orchestrator | — (transitively whatever parser/geocoder use) |
+| `@dromney/mapthis/react` | `MapProvider`, `GoogleMapsViewer`, `PlaceMarker`, `autofit`, `browserAutocomplete` | `react`, `react-dom`, `@vis.gl/react-google-maps` |
+
+## Choosing an LLM backend
+
+`createLocationParser` accepts either an OpenAI config, an Anthropic config, or a bring-your-own backend implementing the [`LlmBackend`](./src/ai/backend.ts) interface.
+
+```ts
+// OpenAI (default)
+createLocationParser({ apiKey: process.env.OPENAI_API_KEY! })
+createLocationParser({ provider: "openai", apiKey: ..., model: "gpt-4o-mini" })
+
+// Anthropic
+createLocationParser({
+    provider: "anthropic",
+    apiKey: process.env.ANTHROPIC_API_KEY!,
+    model: "claude-haiku-4-5-20251001",
+})
+
+// Bring-your-own (e.g. an Azure/Bedrock adapter or a deterministic test fake)
+createLocationParser({ backend: myCustomBackend })
+```
+
+Both bundled backends implement the same two-stage pipeline: a chunked summarization pass to fit the model's context window, followed by a structured-output call (OpenAI function calling, Anthropic tool use) to extract the location list.
+
+## Persisting results
+
+`createMapGenerator` is intentionally pure — it returns a plain object and never touches a database. Wire the result into your own persistence layer:
+
+```ts
+const result = await generator.generateFromSource({ sourceType: "url", source: url })
+
+await db.$transaction(async (tx) => {
+    const map = await tx.map.create({ data: { title: result.title /* … */ } })
+    const group = await tx.placeGroup.create({ data: { mapId: map.id /* … */ } })
+    await tx.place.createMany({
+        data: result.places.map((p, i) => ({
+            mapId: map.id,
+            groupId: group.id,
+            position: i,
+            query: p.input.address,
+            description: p.input.description,
+            name: p.data?.name,
+            address: p.data?.address,
+            lat: p.data?.lat,
+            lon: p.data?.lng,
+            provider: p.data?.provider,
+            providerId: p.data?.providerId,
+            error: p.error,
+            locationPromptVersion: result.locationPromptVersion,
+            summaryPromptVersion: result.summaryPromptVersion,
+        })),
+    })
+})
+```
+
+## Error handling
+
+Every error thrown by the package extends `MapthisError` (`@dromney/mapthis/types`). Domain-specific subclasses let callers handle the failure modes that matter to their UX:
+
+| Class | Subpath | When |
+|---|---|---|
+| `InvalidUrlError`, `ScrapeError` | `/scrape` | URL was unreachable or returned non-HTML |
+| `NoSearchResultsError`, `SearchError` | `/search` | Google CSE returned zero usable results |
+| `NoLocationsFoundError`, `AiInputLengthError`, `AiOutputLengthError`, `AiResponseJsonError`, `InvalidJsonSchemaError`, `SummarizeTextError`, `AiError` | `/ai` | LLM stage failed |
+| `GeocodingError` | `/geocoding` | Geocoder threw (per-input failures resolve, not throw) |
+
+Per-input geocoder failures are *not* thrown — `geocodeMany` returns a `PlaceQueryResult` with `data: null` and `error: string` so one bad address can't fail an entire batch.
+
 ## Design principles
 
-- **No `process.env` reads.** All secrets (OpenAI, Google Maps, Google CSE) are passed to factory functions by the consumer. This keeps the package portable and testable.
-- **Framework-agnostic.** The core modules are pure TypeScript. React components live behind the `@dromney/mapthis/react` subpath so server-side consumers can skip them.
-- **Plain domain types.** Types are hand-rolled TS (with matching Zod schemas) so consumers are not forced into a particular ORM. Adapter functions between your ORM models and these types stay in your app.
-- **Optional peer deps for heavy things.** `openai`, `js-tiktoken`, `html-to-text`, `@googlemaps/google-maps-services-js`, `react`, `react-dom`, and `@vis.gl/react-google-maps` are optional peer dependencies. Install only what the subpaths you use need.
+- **No `process.env` reads.** All secrets are passed to factory functions by the consumer. Keeps the package portable and testable.
+- **Framework-agnostic.** Core modules are pure TypeScript. React components live behind the `@dromney/mapthis/react` subpath so server-only consumers skip them entirely.
+- **Plain domain types.** Hand-rolled TS with matching Zod schemas. Consumers aren't locked to a particular ORM — write adapter functions between your DB models and these types in your app.
+- **Optional peer deps for heavy things.** Every SDK is an optional peer dependency. Install only what the subpaths you use need.
 
 ## License
 

package/dist/ai/index.cjs

@@ -4,10 +4,12 @@ var zod = require('zod');
 var htmlToText$1 = require('html-to-text');
 var jsTiktoken = require('js-tiktoken');
 var OpenAI = require('openai');
+var Anthropic = require('@anthropic-ai/sdk');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var OpenAI__default = /*#__PURE__*/_interopDefault(OpenAI);
+var Anthropic__default = /*#__PURE__*/_interopDefault(Anthropic);
 
 // src/types/errors.ts
 var MapthisError = class extends Error {
@@ -437,10 +439,108 @@ function createOpenAiBackend(config) {
     }
   };
 }
+var DEFAULT_ANTHROPIC_MODEL = "claude-haiku-4-5-20251001";
+var DEFAULT_ANTHROPIC_TOKEN_LIMIT = 2e5;
+var DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS = 4096;
+function resolveEncoding2(model) {
+  try {
+    return jsTiktoken.encodingForModel(model);
+  } catch {
+    return jsTiktoken.getEncoding("cl100k_base");
+  }
+}
+function createAnthropicBackend(config) {
+  const model = config.model ?? DEFAULT_ANTHROPIC_MODEL;
+  const tokenLimit = config.tokenLimit ?? DEFAULT_ANTHROPIC_TOKEN_LIMIT;
+  const maxOutputTokens = config.maxOutputTokens ?? DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS;
+  const client = new Anthropic__default.default({
+    apiKey: config.apiKey,
+    ...config.baseURL ? { baseURL: config.baseURL } : {}
+  });
+  const encoding = resolveEncoding2(model);
+  return {
+    model,
+    tokenLimit,
+    countTokens(text) {
+      return encoding.encode(text).length;
+    },
+    async chatCompletion(content) {
+      const response = await client.messages.create({
+        model,
+        max_tokens: maxOutputTokens,
+        messages: [{ role: "user", content }]
+      });
+      const text = response.content.filter((b) => b.type === "text").map((b) => b.text).join("");
+      return {
+        output: text,
+        inputTokens: response.usage.input_tokens,
+        outputTokens: response.usage.output_tokens
+      };
+    },
+    async chatFunctionJson(systemMessage, userMessage, schema, functionName) {
+      try {
+        const response = await client.messages.create({
+          model,
+          max_tokens: maxOutputTokens,
+          system: systemMessage,
+          tools: [
+            {
+              name: functionName,
+              description: `Return structured output matching the ${functionName} schema.`,
+              input_schema: schema
+            }
+          ],
+          tool_choice: { type: "tool", name: functionName },
+          messages: [{ role: "user", content: userMessage }]
+        });
+        const toolUse = response.content.find(
+          (b) => b.type === "tool_use"
+        );
+        if (!toolUse) {
+          throw new AiResponseJsonError("No tool use in Anthropic response");
+        }
+        if (response.stop_reason === "max_tokens") {
+          throw new AiOutputLengthError(
+            `Anthropic hit max_tokens (${maxOutputTokens}) before completing tool call`
+          );
+        }
+        return {
+          output: toolUse.input,
+          inputTokens: response.usage.input_tokens,
+          outputTokens: response.usage.output_tokens
+        };
+      } catch (error) {
+        if (error instanceof AiError) throw error;
+        if (error instanceof Anthropic__default.default.APIError) {
+          const msg = (error.message ?? "").toLowerCase();
+          if (msg.includes("prompt is too long") || msg.includes("max_tokens")) {
+            throw new AiInputLengthError(`Text too long: ${error.message}`, {
+              cause: error
+            });
+          }
+          if (msg.includes("invalid") && msg.includes("schema")) {
+            throw new InvalidJsonSchemaError(`Invalid schema: ${error.message}`, {
+              cause: error
+            });
+          }
+          throw new AiError(`Anthropic error: ${error.message}`, { cause: error });
+        }
+        throw new AiError("Anthropic error (unknown)", {
+          cause: error instanceof Error ? error : void 0
+        });
+      }
+    }
+  };
+}
 
 // src/ai/parser.ts
+function resolveBackend(config) {
+  if ("backend" in config) return config.backend;
+  if (config.provider === "anthropic") return createAnthropicBackend(config);
+  return createOpenAiBackend(config);
+}
 function createLocationParser(config) {
-  const backend = createOpenAiBackend(config);
+  const backend = resolveBackend(config);
   return {
     parseLocationsFromText: (text) => parseLocationsFromText(backend, text),
     parseLocationsFromHtml: (html) => parseLocationsFromHtml(backend, html),
@@ -452,6 +552,9 @@ exports.AiError = AiError;
 exports.AiInputLengthError = AiInputLengthError;
 exports.AiOutputLengthError = AiOutputLengthError;
 exports.AiResponseJsonError = AiResponseJsonError;
+exports.DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS = DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS;
+exports.DEFAULT_ANTHROPIC_MODEL = DEFAULT_ANTHROPIC_MODEL;
+exports.DEFAULT_ANTHROPIC_TOKEN_LIMIT = DEFAULT_ANTHROPIC_TOKEN_LIMIT;
 exports.DEFAULT_MODEL = DEFAULT_MODEL;
 exports.DEFAULT_TOKEN_LIMIT = DEFAULT_TOKEN_LIMIT;
 exports.InvalidJsonSchemaError = InvalidJsonSchemaError;
@@ -464,6 +567,7 @@ exports.NoLocationsFoundError = NoLocationsFoundError;
 exports.SUMMARIZATION_PROMPT = SUMMARIZATION_PROMPT;
 exports.SUMMARIZE_PROMPT_VERSION = SUMMARIZE_PROMPT_VERSION;
 exports.SummarizeTextError = SummarizeTextError;
+exports.createAnthropicBackend = createAnthropicBackend;
 exports.createLocationParser = createLocationParser;
 exports.createOpenAiBackend = createOpenAiBackend;
 exports.parseLocationsFromHtml = parseLocationsFromHtml;

package/dist/ai/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/errors.ts","../../src/ai/errors.ts","../../src/ai/prompts.ts","../../src/scrape/errors.ts","../../src/scrape/html.ts","../../src/scrape/text.ts","../../src/ai/summarize.ts","../../src/ai/locations.ts","../../src/ai/openai.ts","../../src/ai/parser.ts"],"names":["z","convert","encodingForModel","getEncoding","OpenAI"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base error class for every error thrown by the mapthis package.\n *\n * All feature-specific error classes (scrape, search, ai, geocoding) extend\n * this, so consumers can do `catch (e) { if (e instanceof MapthisError) ... }`\n * to distinguish library errors from other exceptions.\n */\nexport class MapthisError extends Error {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"MapthisError\"\n    }\n}\n","import { MapthisError } from \"../types/errors\"\n\nexport class AiError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiError\"\n    }\n}\n\n/**\n * The LLM returned zero locations after deduplication.\n */\nexport class NoLocationsFoundError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message ?? \"No locations found in input\", options)\n        this.name = \"NoLocationsFoundError\"\n    }\n}\n\n/**\n * Summarization pipeline failed (one of the chunk calls rejected).\n */\nexport class SummarizeTextError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"SummarizeTextError\"\n    }\n}\n\n/**\n * A JSON schema passed to the LLM was rejected as invalid by the provider.\n */\nexport class InvalidJsonSchemaError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"InvalidJsonSchemaError\"\n    }\n}\n\n/**\n * The LLM response could not be parsed as JSON (typically because the output\n * was truncated or malformed).\n */\nexport class AiResponseJsonError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiResponseJsonError\"\n    }\n}\n\n/**\n * Input text exceeded the model's context window.\n */\nexport class AiInputLengthError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiInputLengthError\"\n    }\n}\n\n/**\n * The LLM hit the output token limit before completing its JSON response.\n */\nexport class AiOutputLengthError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiOutputLengthError\"\n    }\n}\n","import type { JSONSchema7Object } from \"json-schema\"\n\n/**\n * Semantic version of the location-extraction system prompt. Stored alongside\n * each place record in the private app so results can be re-run when the\n * prompt is updated. Bump when you change {@link LOCATIONS_SYSTEM_MESSAGE} or\n * {@link LOCATIONS_SCHEMA} in a way that meaningfully changes output.\n */\nexport const LOCATIONS_PROMPT_VERSION = \"0.0.1\"\n\nexport const LOCATIONS_FUNCTIONS_NAME = \"get_places\"\n\nexport const LOCATIONS_SYSTEM_MESSAGE = `You parse a list of place addresses, corresponding brief one-sentence descriptions, and a descriptive title (preferably directly quoted) from text. These addresses might be countries, cities, attractions, parks, bars, etc.\nIf the text seems to be listing places that are all within a single parent place, you don't return the parent place, but you do add it to all the childrens' addresses.\nFor example, for an article about places in greece, you would not return \"greece\", but if the Acropolis was mentioned, you would return \"Acropolis, Athens, Greece\"\n\nYou ignore extraneous text, such as recommended articles, advertisments, etc.\n`\n\nexport const LOCATIONS_SCHEMA: JSONSchema7Object = {\n    type: \"object\",\n    required: [\"locations\", \"title\"],\n    properties: {\n        locations: {\n            type: \"array\",\n            items: {\n                type: \"object\",\n                required: [\"address\", \"description\"],\n                properties: {\n                    address: { type: \"string\" },\n                    description: { type: \"string\" },\n                },\n            },\n        },\n        title: { type: \"string\" },\n    },\n}\n\nexport const LOCATIONS_MAX_OUTPUT_TOKENS = 500\n\n/**\n * Semantic version of the summarization prompt. Bump when meaningful changes\n * are made to {@link SUMMARIZATION_PROMPT}.\n */\nexport const SUMMARIZE_PROMPT_VERSION = \"0.0.1\"\n\nexport const SUMMARIZATION_PROMPT = `Summarize the given text. The summary must reduce the number of characters from the original text by at least a factor of {RATIO}.\nFor example, text of 1000 characters must output a summary less than {EXAMPLE} characters.\nThis summary will be used to extract a list of locations and addresses, so keep any text that seems to be a list of locations/places, a location and paragraph describing it, or otherwise clearly a location name or address.\nHere is the text:\n`\n","import { MapthisError } from \"../types/errors\"\n\nexport class ScrapeError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ScrapeError\"\n    }\n}\n\n/**\n * Thrown when a provided URL fails validation or cannot be parsed by `fetch`.\n */\nexport class InvalidUrlError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"InvalidUrlError\"\n    }\n}\n\n/**\n * Thrown when a remote server returns 401 or 403 for an HTML fetch, meaning\n * the page does not permit anonymous scraping.\n */\nexport class HtmlUnauthorizedError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"HtmlUnauthorizedError\"\n    }\n}\n\n/**\n * Thrown when the underlying `html-to-text` conversion fails.\n */\nexport class HtmlToTextError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"HtmlToTextError\"\n    }\n}\n","import { z } from \"zod\"\nimport { HtmlUnauthorizedError, InvalidUrlError, ScrapeError } from \"./errors\"\n\nconst withHttps = (url: string): string => {\n    const hasHttp = /^http?:\\/\\//i.test(url)\n    const hasHttps = /^https?:\\/\\//i.test(url)\n    if (!hasHttp && !hasHttps) return `https://${url}`\n    return url\n}\n\n/**\n * Fetch the raw HTML of a URL, performing light validation first.\n *\n * - URLs without a scheme are prefixed with `https://`.\n * - URL shape is validated via Zod before the network call.\n * - 401/403 responses throw {@link HtmlUnauthorizedError}.\n * - Other non-OK responses throw {@link ScrapeError} with the status text.\n * - `TypeError` from `fetch` (typically malformed URL) is rethrown as\n *   {@link InvalidUrlError}.\n *\n * This function does not set any special headers, user agent, or cookies.\n * Sites with aggressive bot-detection may return empty bodies or errors; the\n * caller is responsible for retry / user-agent rotation strategies if needed.\n */\nexport async function getHtmlFromUrl(url: string): Promise<string> {\n    const urlFixed = withHttps(url.toLowerCase())\n    const isUrl = z.string().url().safeParse(urlFixed)\n    if (!isUrl.success) throw new InvalidUrlError(`Invalid URL: ${url}`)\n\n    try {\n        const response = await fetch(urlFixed)\n        const html = await response.text()\n        if (response.status === 403 || response.status === 401) {\n            throw new HtmlUnauthorizedError(\n                `${response.status} Not authorized to scrape this website`,\n            )\n        }\n        if (!response.ok) {\n            throw new ScrapeError(\n                `Bad response when getting HTML. Status: ${response.status} ${response.statusText}`,\n            )\n        }\n        return html\n    } catch (error) {\n        if (error instanceof TypeError) {\n            throw new InvalidUrlError(`Invalid URL. Original error: ${error.message}`)\n        }\n        throw error\n    }\n}\n","import { convert } from \"html-to-text\"\nimport { HtmlToTextError } from \"./errors\"\nimport { getHtmlFromUrl } from \"./html\"\n\nconst SKIP_SELECTORS = [\n    \"img\",\n    \"header\",\n    \"footer\",\n    \"audio\",\n    \"button\",\n    \"canvas\",\n    \"code\",\n    \"nav\",\n    \"#nav\",\n    \"figure\",\n    \"figcaption\",\n    \".comment\",\n    \".comments\",\n    \"#comments\",\n    \"#related-posts\",\n    \"#related\",\n    \".related\",\n    \".related-posts\",\n] as const\n\n/**\n * Convert raw HTML to plain text suitable for LLM consumption.\n *\n * The converter is configured to:\n * - strip anchor hrefs when they duplicate the link text;\n * - skip navigation, footer, comments, related-post widgets, images, and\n *   other non-content elements;\n * - collapse repeated blank lines and double spaces so token count doesn't\n *   balloon from whitespace.\n */\nexport function htmlToText(html: string): string {\n    try {\n        let out = convert(html, {\n            wordwrap: false,\n            selectors: [\n                {\n                    selector: \"a\",\n                    options: {\n                        ignoreHref: true,\n                        hideLinkHrefIfSameAsText: true,\n                    },\n                },\n                ...SKIP_SELECTORS.map((tag) => ({ selector: tag, format: \"skip\" })),\n            ],\n        })\n        out = out.replaceAll(\"\\r\\n\", \"\\n\")\n        // Iteratively collapse blank lines and double spaces. 20 passes is\n        // overkill for any realistic input but cheap and bounds worst case.\n        for (let i = 0; i < 20; i++) {\n            out = out.replaceAll(\"\\n\\n\\n\", \"\\n\\n\")\n            out = out.replaceAll(\"  \", \" \")\n        }\n        return out\n    } catch (error) {\n        if (error instanceof Error) {\n            throw new HtmlToTextError(`HTML to text conversion failed: ${error.message}`, {\n                cause: error,\n            })\n        }\n        throw new HtmlToTextError(\"HTML to text conversion failed\")\n    }\n}\n\n/**\n * Convenience: fetch a URL and convert its HTML to plain text in one call.\n *\n * Equivalent to `htmlToText(await getHtmlFromUrl(url))`.\n */\nexport async function getTextFromUrl(url: string): Promise<string> {\n    const html = await getHtmlFromUrl(url)\n    return htmlToText(html)\n}\n","import { SummarizeTextError } from \"./errors\"\nimport type { OpenAiBackend } from \"./openai\"\nimport { SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION } from \"./prompts\"\nimport type { SummarizedText } from \"./types\"\n\n/**\n * Reduce a large text to a summary that will fit inside the model's context\n * window alongside a known downstream prompt (e.g. the location-extraction\n * call).\n *\n * Algorithm overview\n * ------------------\n * We need to fit both the summary and a downstream \"final\" prompt into the\n * model's context window. Given:\n *\n * - `token_limit` — model context window (with a safety factor)\n * - `text_tokens` — size of the input text\n * - `summarize_prompt_tokens` — size of the summarization prompt itself\n * - `final_prompt_tokens` — size of the downstream prompt\n * - `final_output_tokens` — expected size of the downstream response\n *\n * We split the input into chunks, summarize each in parallel, and concatenate\n * the results. The per-chunk size is chosen so that the combined summary\n * leaves room for the downstream prompt:\n *\n *     final_input_tokens    = token_limit - final_output_tokens\n *     summary_output_tokens = final_input_tokens - final_prompt_tokens\n *     num_chunks            = ceil((text_tokens + summary_output_tokens)\n *                                  / (token_limit - summarize_prompt_tokens))\n *     chunk_output_tokens   = summary_output_tokens / num_chunks\n *     chunk_input_tokens    = token_limit - summarize_prompt_tokens - chunk_output_tokens\n *\n * A safety factor is applied to chunk output sizes because LLMs routinely\n * overshoot explicit length instructions.\n */\nexport async function summarizeText(\n    backend: OpenAiBackend,\n    text: string,\n    finalPrompt = \"\",\n    finalOutputTokens = 0,\n    chunkOutputSafetyFactor = 0.3,\n    tokenLimitSafetyFactor = 0.02,\n): Promise<SummarizedText> {\n    const tokenLimit = backend.tokenLimit * (1 - tokenLimitSafetyFactor)\n    const textTokens = backend.countTokens(text)\n    const summarizePromptTokens = backend.countTokens(SUMMARIZATION_PROMPT)\n    const finalPromptTokens = backend.countTokens(finalPrompt)\n\n    const finalInputTokens = tokenLimit - finalOutputTokens\n    const summaryOutputTokens = finalInputTokens - finalPromptTokens\n\n    const numChunks = Math.max(\n        1,\n        Math.ceil((textTokens + summaryOutputTokens) / (tokenLimit - summarizePromptTokens)),\n    )\n    const chunkOutputTokens = Math.floor(\n        (summaryOutputTokens / numChunks) * (1 - chunkOutputSafetyFactor),\n    )\n    const chunkInputTokens = Math.floor(tokenLimit - summarizePromptTokens - chunkOutputTokens)\n    const summaryRatio = chunkOutputTokens / chunkInputTokens\n\n    // Split the text into chunks that each fit inside `chunkInputTokens`.\n    // Lines longer than a single chunk are force-split by token, not by\n    // character, so UTF-8 multibyte characters aren't corrupted.\n    const textLines = text.split(\"\\n\")\n    const chunks: string[] = []\n\n    let currentChunk = \"\"\n    let currentChunkTokens = 0\n    const nextChunk = (): void => {\n        if (currentChunk) chunks.push(currentChunk)\n        currentChunk = \"\"\n        currentChunkTokens = 0\n    }\n\n    // We need an encoder for the force-split path. The backend's countTokens\n    // gives us length but not the encoded array; for force-splitting we only\n    // need to chunk by an approximate token count using the same rounding.\n    // To keep this function backend-agnostic, we fall back to character-based\n    // splitting for over-long lines (rare edge case in practice).\n    for (const line of textLines) {\n        const numLineTokens = backend.countTokens(line) + 1 // +1 for the newline\n\n        if (numLineTokens > chunkInputTokens) {\n            // Long line: flush current chunk, then split this line by\n            // approximate token ratio into sub-chunks.\n            nextChunk()\n            const charsPerToken = line.length / Math.max(1, backend.countTokens(line))\n            const charsPerChunk = Math.max(1, Math.floor(chunkInputTokens * charsPerToken))\n            for (let i = 0; i < line.length; i += charsPerChunk) {\n                chunks.push(line.slice(i, i + charsPerChunk))\n            }\n            continue\n        }\n\n        if (currentChunkTokens + numLineTokens > chunkInputTokens) {\n            nextChunk()\n        }\n        currentChunkTokens += numLineTokens\n        currentChunk += line + \"\\n\"\n    }\n    nextChunk()\n\n    try {\n        const ratioText = (Math.ceil(summaryRatio * 10) / 10).toFixed(1)\n        const exampleText = Math.ceil(1000 / Math.max(summaryRatio, 0.01)).toFixed(0)\n        const summaryPrompt = SUMMARIZATION_PROMPT.replace(\"{RATIO}\", ratioText).replace(\n            \"{EXAMPLE}\",\n            exampleText,\n        )\n\n        let inputTokens = 0\n        let outputTokens = 0\n        const summaries = await Promise.all(\n            chunks.map(async (chunk) => {\n                const response = await backend.chatCompletion(summaryPrompt + chunk)\n                inputTokens += response.inputTokens\n                outputTokens += response.outputTokens\n                return response.output\n            }),\n        )\n\n        const summarized = summaries.join(\"\\n\")\n        const summarizedTokens = backend.countTokens(summarized)\n\n        return {\n            text,\n            textTokens,\n            summarized,\n            summarizedTokens,\n            inputTokens,\n            outputTokens,\n            chunks: chunks.length,\n            summarizePromptVersion: SUMMARIZE_PROMPT_VERSION,\n        }\n    } catch (error) {\n        if (error instanceof Error) {\n            throw new SummarizeTextError(`Failed to summarize text: ${error.message}`, {\n                cause: error,\n            })\n        }\n        throw new SummarizeTextError(\"Failed to summarize text (unknown error)\")\n    }\n}\n","import { getHtmlFromUrl } from \"../scrape/html\"\nimport { htmlToText } from \"../scrape/text\"\nimport type { ParsedLocations } from \"../types/domain\"\nimport { NoLocationsFoundError } from \"./errors\"\nimport type { OpenAiBackend } from \"./openai\"\nimport {\n    LOCATIONS_FUNCTIONS_NAME,\n    LOCATIONS_MAX_OUTPUT_TOKENS,\n    LOCATIONS_PROMPT_VERSION,\n    LOCATIONS_SCHEMA,\n    LOCATIONS_SYSTEM_MESSAGE,\n} from \"./prompts\"\nimport { summarizeText } from \"./summarize\"\nimport type { GetLocationsResponse } from \"./types\"\n\nconst FINAL_PROMPT = LOCATIONS_SYSTEM_MESSAGE + JSON.stringify(LOCATIONS_SCHEMA) + LOCATIONS_FUNCTIONS_NAME\n\nasync function callLocationExtraction(backend: OpenAiBackend, text: string) {\n    const out = await backend.chatFunctionJson<ParsedLocations>(\n        LOCATIONS_SYSTEM_MESSAGE,\n        text,\n        LOCATIONS_SCHEMA,\n        LOCATIONS_FUNCTIONS_NAME,\n    )\n\n    // LLM frequently returns the same address twice across different prompts.\n    // Dedupe by address string.\n    const seen = new Set<string>()\n    const unique = out.output.locations.filter((loc) => {\n        if (seen.has(loc.address)) return false\n        seen.add(loc.address)\n        return true\n    })\n    if (unique.length === 0) throw new NoLocationsFoundError()\n    out.output.locations = unique\n\n    return out\n}\n\n/**\n * Parse locations from freeform text. Two-stage: summarize to fit the context\n * window, then a function-calling JSON completion for extraction.\n */\nexport async function parseLocationsFromText(\n    backend: OpenAiBackend,\n    text: string,\n): Promise<GetLocationsResponse> {\n    const {\n        summarized,\n        inputTokens: sumIn,\n        outputTokens: sumOut,\n        textTokens,\n        summarizedTokens,\n        summarizePromptVersion,\n    } = await summarizeText(backend, text, FINAL_PROMPT, LOCATIONS_MAX_OUTPUT_TOKENS)\n\n    const {\n        output,\n        inputTokens: locIn,\n        outputTokens: locOut,\n    } = await callLocationExtraction(backend, summarized)\n\n    return {\n        output,\n        locationInputTokens: locIn,\n        locationOutputTokens: locOut,\n        summaryInputTokens: sumIn,\n        summaryOutputTokens: sumOut,\n        inputTokens: sumIn + locIn,\n        outputTokens: sumOut + locOut,\n        textTokens,\n        summarizedTokens,\n        summaryPromptVersion: summarizePromptVersion,\n        locationPromptVersion: LOCATIONS_PROMPT_VERSION,\n    }\n}\n\n/**\n * Parse locations from HTML. Equivalent to `htmlToText` followed by\n * {@link parseLocationsFromText}.\n */\nexport async function parseLocationsFromHtml(\n    backend: OpenAiBackend,\n    html: string,\n): Promise<GetLocationsResponse> {\n    return parseLocationsFromText(backend, htmlToText(html))\n}\n\n/**\n * Parse locations from a URL. Equivalent to fetching the HTML, converting to\n * text, and calling {@link parseLocationsFromText}. Throws any scrape errors\n * unchanged.\n */\nexport async function parseLocationsFromUrl(\n    backend: OpenAiBackend,\n    url: string,\n): Promise<GetLocationsResponse> {\n    const html = await getHtmlFromUrl(url)\n    return parseLocationsFromHtml(backend, html)\n}\n","import { encodingForModel, getEncoding, type Tiktoken, type TiktokenModel } from \"js-tiktoken\"\nimport OpenAI from \"openai\"\nimport type { JSONSchema7Object } from \"json-schema\"\nimport {\n    AiInputLengthError,\n    AiOutputLengthError,\n    AiResponseJsonError,\n    AiError,\n    InvalidJsonSchemaError,\n} from \"./errors\"\nimport type { OpenAIOutput } from \"./types\"\n\nexport const DEFAULT_MODEL = \"gpt-4o-mini\"\nexport const DEFAULT_TOKEN_LIMIT = 128000\n\n/**\n * An OpenAI-backed inference context shared by the summarizer and location\n * parser. Instances are produced by {@link createOpenAiBackend} so API keys\n * and model choices live in the consumer's code, never in module-level state.\n */\nexport interface OpenAiBackend {\n    readonly model: string\n    readonly tokenLimit: number\n    countTokens(text: string): number\n    chatCompletion(content: string): Promise<OpenAIOutput<string>>\n    chatFunctionJson<T>(\n        systemMessage: string,\n        userMessage: string,\n        schema: JSONSchema7Object,\n        functionName: string,\n    ): Promise<OpenAIOutput<T>>\n}\n\nexport interface OpenAiBackendConfig {\n    /** OpenAI API key. Passed directly to the SDK. */\n    apiKey: string\n    /** Model name passed to the completions API. Defaults to `gpt-4o-mini`. */\n    model?: string\n    /** Context-window budget used by the summarizer. Defaults to 128k. */\n    tokenLimit?: number\n    /**\n     * Optional base URL for the OpenAI API. Use this to route through an\n     * OpenAI-compatible gateway (Azure, Together, etc.).\n     */\n    baseURL?: string\n}\n\nfunction resolveEncoding(model: string): Tiktoken {\n    try {\n        return encodingForModel(model as TiktokenModel)\n    } catch {\n        // Fallback for models tiktoken does not recognize by name.\n        return getEncoding(\"cl100k_base\")\n    }\n}\n\n/**\n * Construct an {@link OpenAiBackend} bound to a specific API key and model.\n */\nexport function createOpenAiBackend(config: OpenAiBackendConfig): OpenAiBackend {\n    const model = config.model ?? DEFAULT_MODEL\n    const tokenLimit = config.tokenLimit ?? DEFAULT_TOKEN_LIMIT\n    const openai = new OpenAI({\n        apiKey: config.apiKey,\n        ...(config.baseURL ? { baseURL: config.baseURL } : {}),\n    })\n    const encoding = resolveEncoding(model)\n\n    return {\n        model,\n        tokenLimit,\n\n        countTokens(text: string): number {\n            return encoding.encode(text).length\n        },\n\n        async chatCompletion(content: string): Promise<OpenAIOutput<string>> {\n            const response = await openai.chat.completions.create({\n                messages: [{ role: \"user\", content }],\n                model,\n            })\n            return {\n                output: response.choices[0]?.message.content ?? \"\",\n                inputTokens: response.usage?.prompt_tokens ?? 0,\n                outputTokens: response.usage?.completion_tokens ?? 0,\n            }\n        },\n\n        async chatFunctionJson<T>(\n            systemMessage: string,\n            userMessage: string,\n            schema: JSONSchema7Object,\n            functionName: string,\n        ): Promise<OpenAIOutput<T>> {\n            try {\n                const completion = await openai.chat.completions.create({\n                    model,\n                    messages: [\n                        { role: \"system\", content: systemMessage },\n                        { role: \"user\", content: userMessage },\n                    ],\n                    functions: [{ name: functionName, parameters: schema }],\n                    function_call: { name: functionName },\n                })\n\n                const functionCall = completion.choices[0]?.message.function_call\n                if (!functionCall) {\n                    throw new AiResponseJsonError(\"No function call in OpenAI response\")\n                }\n\n                const inputTokens = completion.usage?.prompt_tokens ?? 0\n                const outputTokens = completion.usage?.completion_tokens ?? 0\n\n                try {\n                    const output = JSON.parse(functionCall.arguments) as T\n                    return { output, inputTokens, outputTokens }\n                } catch (error) {\n                    if (error instanceof SyntaxError) {\n                        const msg = error.message.toLowerCase()\n                        if (\n                            msg.includes(\"unexpected end of json input\") ||\n                            msg.includes(\"unterminated string in js\")\n                        ) {\n                            throw new AiOutputLengthError(\n                                `Output tokens exceeded: ${error.message}`,\n                                { cause: error },\n                            )\n                        }\n                        throw new AiResponseJsonError(\n                            `Failed to parse JSON from OpenAI response: ${error.message}`,\n                            { cause: error },\n                        )\n                    }\n                    throw new AiResponseJsonError(\n                        \"Failed to parse JSON from OpenAI response (unknown reason)\",\n                    )\n                }\n            } catch (error) {\n                if (error instanceof AiError) throw error\n                if (error instanceof OpenAI.APIError) {\n                    const msg = error.message.toLowerCase()\n                    if (msg.includes(\"maximum context\")) {\n                        throw new AiInputLengthError(`Text too long: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    if (msg.includes(\"invalid schema\")) {\n                        throw new InvalidJsonSchemaError(`Invalid schema: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    throw new AiError(`OpenAI error: ${error.message}`, { cause: error })\n                }\n                throw new AiError(\"OpenAI error (unknown)\", {\n                    cause: error instanceof Error ? error : undefined,\n                })\n            }\n        },\n    }\n}\n","import {\n    parseLocationsFromHtml,\n    parseLocationsFromText,\n    parseLocationsFromUrl,\n} from \"./locations\"\nimport { createOpenAiBackend, type OpenAiBackendConfig } from \"./openai\"\nimport type { GetLocationsResponse } from \"./types\"\n\n/**\n * A configured location-extraction pipeline. Hold onto one of these for the\n * lifetime of your app — it wraps an OpenAI client and a tiktoken encoder.\n */\nexport interface LocationParser {\n    parseLocationsFromText(text: string): Promise<GetLocationsResponse>\n    parseLocationsFromHtml(html: string): Promise<GetLocationsResponse>\n    parseLocationsFromUrl(url: string): Promise<GetLocationsResponse>\n}\n\nexport type LocationParserConfig = OpenAiBackendConfig\n\n/**\n * Create a {@link LocationParser} bound to an OpenAI API key.\n *\n * @example\n * ```ts\n * const parser = createLocationParser({\n *   apiKey: process.env.OPENAI_API_KEY!,\n *   model: \"gpt-4o-mini\",\n * })\n * const { output } = await parser.parseLocationsFromUrl(\n *   \"https://example.com/best-restaurants-tokyo\",\n * )\n * console.log(output.title, output.locations)\n * ```\n */\nexport function createLocationParser(config: LocationParserConfig): LocationParser {\n    const backend = createOpenAiBackend(config)\n    return {\n        parseLocationsFromText: (text) => parseLocationsFromText(backend, text),\n        parseLocationsFromHtml: (html) => parseLocationsFromHtml(backend, html),\n        parseLocationsFromUrl: (url) => parseLocationsFromUrl(backend, url),\n    }\n}\n"]}
+{"version":3,"sources":["../../src/types/errors.ts","../../src/ai/errors.ts","../../src/ai/prompts.ts","../../src/scrape/errors.ts","../../src/scrape/html.ts","../../src/scrape/text.ts","../../src/ai/summarize.ts","../../src/ai/locations.ts","../../src/ai/openai.ts","../../src/ai/anthropic.ts","../../src/ai/parser.ts"],"names":["z","convert","encodingForModel","getEncoding","OpenAI","resolveEncoding","Anthropic"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base error class for every error thrown by the mapthis package.\n *\n * All feature-specific error classes (scrape, search, ai, geocoding) extend\n * this, so consumers can do `catch (e) { if (e instanceof MapthisError) ... }`\n * to distinguish library errors from other exceptions.\n */\nexport class MapthisError extends Error {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"MapthisError\"\n    }\n}\n","import { MapthisError } from \"../types/errors\"\n\nexport class AiError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiError\"\n    }\n}\n\n/**\n * The LLM returned zero locations after deduplication.\n */\nexport class NoLocationsFoundError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message ?? \"No locations found in input\", options)\n        this.name = \"NoLocationsFoundError\"\n    }\n}\n\n/**\n * Summarization pipeline failed (one of the chunk calls rejected).\n */\nexport class SummarizeTextError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"SummarizeTextError\"\n    }\n}\n\n/**\n * A JSON schema passed to the LLM was rejected as invalid by the provider.\n */\nexport class InvalidJsonSchemaError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"InvalidJsonSchemaError\"\n    }\n}\n\n/**\n * The LLM response could not be parsed as JSON (typically because the output\n * was truncated or malformed).\n */\nexport class AiResponseJsonError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiResponseJsonError\"\n    }\n}\n\n/**\n * Input text exceeded the model's context window.\n */\nexport class AiInputLengthError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiInputLengthError\"\n    }\n}\n\n/**\n * The LLM hit the output token limit before completing its JSON response.\n */\nexport class AiOutputLengthError extends AiError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"AiOutputLengthError\"\n    }\n}\n","import type { JSONSchema7Object } from \"json-schema\"\n\n/**\n * Semantic version of the location-extraction system prompt. Stored alongside\n * each place record in the private app so results can be re-run when the\n * prompt is updated. Bump when you change {@link LOCATIONS_SYSTEM_MESSAGE} or\n * {@link LOCATIONS_SCHEMA} in a way that meaningfully changes output.\n */\nexport const LOCATIONS_PROMPT_VERSION = \"0.0.1\"\n\nexport const LOCATIONS_FUNCTIONS_NAME = \"get_places\"\n\nexport const LOCATIONS_SYSTEM_MESSAGE = `You parse a list of place addresses, corresponding brief one-sentence descriptions, and a descriptive title (preferably directly quoted) from text. These addresses might be countries, cities, attractions, parks, bars, etc.\nIf the text seems to be listing places that are all within a single parent place, you don't return the parent place, but you do add it to all the childrens' addresses.\nFor example, for an article about places in greece, you would not return \"greece\", but if the Acropolis was mentioned, you would return \"Acropolis, Athens, Greece\"\n\nYou ignore extraneous text, such as recommended articles, advertisments, etc.\n`\n\nexport const LOCATIONS_SCHEMA: JSONSchema7Object = {\n    type: \"object\",\n    required: [\"locations\", \"title\"],\n    properties: {\n        locations: {\n            type: \"array\",\n            items: {\n                type: \"object\",\n                required: [\"address\", \"description\"],\n                properties: {\n                    address: { type: \"string\" },\n                    description: { type: \"string\" },\n                },\n            },\n        },\n        title: { type: \"string\" },\n    },\n}\n\nexport const LOCATIONS_MAX_OUTPUT_TOKENS = 500\n\n/**\n * Semantic version of the summarization prompt. Bump when meaningful changes\n * are made to {@link SUMMARIZATION_PROMPT}.\n */\nexport const SUMMARIZE_PROMPT_VERSION = \"0.0.1\"\n\nexport const SUMMARIZATION_PROMPT = `Summarize the given text. The summary must reduce the number of characters from the original text by at least a factor of {RATIO}.\nFor example, text of 1000 characters must output a summary less than {EXAMPLE} characters.\nThis summary will be used to extract a list of locations and addresses, so keep any text that seems to be a list of locations/places, a location and paragraph describing it, or otherwise clearly a location name or address.\nHere is the text:\n`\n","import { MapthisError } from \"../types/errors\"\n\nexport class ScrapeError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ScrapeError\"\n    }\n}\n\n/**\n * Thrown when a provided URL fails validation or cannot be parsed by `fetch`.\n */\nexport class InvalidUrlError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"InvalidUrlError\"\n    }\n}\n\n/**\n * Thrown when a remote server returns 401 or 403 for an HTML fetch, meaning\n * the page does not permit anonymous scraping.\n */\nexport class HtmlUnauthorizedError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"HtmlUnauthorizedError\"\n    }\n}\n\n/**\n * Thrown when the underlying `html-to-text` conversion fails.\n */\nexport class HtmlToTextError extends ScrapeError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"HtmlToTextError\"\n    }\n}\n","import { z } from \"zod\"\nimport { HtmlUnauthorizedError, InvalidUrlError, ScrapeError } from \"./errors\"\n\nconst withHttps = (url: string): string => {\n    const hasHttp = /^http?:\\/\\//i.test(url)\n    const hasHttps = /^https?:\\/\\//i.test(url)\n    if (!hasHttp && !hasHttps) return `https://${url}`\n    return url\n}\n\n/**\n * Fetch the raw HTML of a URL, performing light validation first.\n *\n * - URLs without a scheme are prefixed with `https://`.\n * - URL shape is validated via Zod before the network call.\n * - 401/403 responses throw {@link HtmlUnauthorizedError}.\n * - Other non-OK responses throw {@link ScrapeError} with the status text.\n * - `TypeError` from `fetch` (typically malformed URL) is rethrown as\n *   {@link InvalidUrlError}.\n *\n * This function does not set any special headers, user agent, or cookies.\n * Sites with aggressive bot-detection may return empty bodies or errors; the\n * caller is responsible for retry / user-agent rotation strategies if needed.\n */\nexport async function getHtmlFromUrl(url: string): Promise<string> {\n    const urlFixed = withHttps(url.toLowerCase())\n    const isUrl = z.string().url().safeParse(urlFixed)\n    if (!isUrl.success) throw new InvalidUrlError(`Invalid URL: ${url}`)\n\n    try {\n        const response = await fetch(urlFixed)\n        const html = await response.text()\n        if (response.status === 403 || response.status === 401) {\n            throw new HtmlUnauthorizedError(\n                `${response.status} Not authorized to scrape this website`,\n            )\n        }\n        if (!response.ok) {\n            throw new ScrapeError(\n                `Bad response when getting HTML. Status: ${response.status} ${response.statusText}`,\n            )\n        }\n        return html\n    } catch (error) {\n        if (error instanceof TypeError) {\n            throw new InvalidUrlError(`Invalid URL. Original error: ${error.message}`)\n        }\n        throw error\n    }\n}\n","import { convert } from \"html-to-text\"\nimport { HtmlToTextError } from \"./errors\"\nimport { getHtmlFromUrl } from \"./html\"\n\nconst SKIP_SELECTORS = [\n    \"img\",\n    \"header\",\n    \"footer\",\n    \"audio\",\n    \"button\",\n    \"canvas\",\n    \"code\",\n    \"nav\",\n    \"#nav\",\n    \"figure\",\n    \"figcaption\",\n    \".comment\",\n    \".comments\",\n    \"#comments\",\n    \"#related-posts\",\n    \"#related\",\n    \".related\",\n    \".related-posts\",\n] as const\n\n/**\n * Convert raw HTML to plain text suitable for LLM consumption.\n *\n * The converter is configured to:\n * - strip anchor hrefs when they duplicate the link text;\n * - skip navigation, footer, comments, related-post widgets, images, and\n *   other non-content elements;\n * - collapse repeated blank lines and double spaces so token count doesn't\n *   balloon from whitespace.\n */\nexport function htmlToText(html: string): string {\n    try {\n        let out = convert(html, {\n            wordwrap: false,\n            selectors: [\n                {\n                    selector: \"a\",\n                    options: {\n                        ignoreHref: true,\n                        hideLinkHrefIfSameAsText: true,\n                    },\n                },\n                ...SKIP_SELECTORS.map((tag) => ({ selector: tag, format: \"skip\" })),\n            ],\n        })\n        out = out.replaceAll(\"\\r\\n\", \"\\n\")\n        // Iteratively collapse blank lines and double spaces. 20 passes is\n        // overkill for any realistic input but cheap and bounds worst case.\n        for (let i = 0; i < 20; i++) {\n            out = out.replaceAll(\"\\n\\n\\n\", \"\\n\\n\")\n            out = out.replaceAll(\"  \", \" \")\n        }\n        return out\n    } catch (error) {\n        if (error instanceof Error) {\n            throw new HtmlToTextError(`HTML to text conversion failed: ${error.message}`, {\n                cause: error,\n            })\n        }\n        throw new HtmlToTextError(\"HTML to text conversion failed\")\n    }\n}\n\n/**\n * Convenience: fetch a URL and convert its HTML to plain text in one call.\n *\n * Equivalent to `htmlToText(await getHtmlFromUrl(url))`.\n */\nexport async function getTextFromUrl(url: string): Promise<string> {\n    const html = await getHtmlFromUrl(url)\n    return htmlToText(html)\n}\n","import type { LlmBackend } from \"./backend\"\nimport { SummarizeTextError } from \"./errors\"\nimport { SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION } from \"./prompts\"\nimport type { SummarizedText } from \"./types\"\n\n/**\n * Reduce a large text to a summary that will fit inside the model's context\n * window alongside a known downstream prompt (e.g. the location-extraction\n * call).\n *\n * Algorithm overview\n * ------------------\n * We need to fit both the summary and a downstream \"final\" prompt into the\n * model's context window. Given:\n *\n * - `token_limit` — model context window (with a safety factor)\n * - `text_tokens` — size of the input text\n * - `summarize_prompt_tokens` — size of the summarization prompt itself\n * - `final_prompt_tokens` — size of the downstream prompt\n * - `final_output_tokens` — expected size of the downstream response\n *\n * We split the input into chunks, summarize each in parallel, and concatenate\n * the results. The per-chunk size is chosen so that the combined summary\n * leaves room for the downstream prompt:\n *\n *     final_input_tokens    = token_limit - final_output_tokens\n *     summary_output_tokens = final_input_tokens - final_prompt_tokens\n *     num_chunks            = ceil((text_tokens + summary_output_tokens)\n *                                  / (token_limit - summarize_prompt_tokens))\n *     chunk_output_tokens   = summary_output_tokens / num_chunks\n *     chunk_input_tokens    = token_limit - summarize_prompt_tokens - chunk_output_tokens\n *\n * A safety factor is applied to chunk output sizes because LLMs routinely\n * overshoot explicit length instructions.\n */\nexport async function summarizeText(\n    backend: LlmBackend,\n    text: string,\n    finalPrompt = \"\",\n    finalOutputTokens = 0,\n    chunkOutputSafetyFactor = 0.3,\n    tokenLimitSafetyFactor = 0.02,\n): Promise<SummarizedText> {\n    const tokenLimit = backend.tokenLimit * (1 - tokenLimitSafetyFactor)\n    const textTokens = backend.countTokens(text)\n    const summarizePromptTokens = backend.countTokens(SUMMARIZATION_PROMPT)\n    const finalPromptTokens = backend.countTokens(finalPrompt)\n\n    const finalInputTokens = tokenLimit - finalOutputTokens\n    const summaryOutputTokens = finalInputTokens - finalPromptTokens\n\n    const numChunks = Math.max(\n        1,\n        Math.ceil((textTokens + summaryOutputTokens) / (tokenLimit - summarizePromptTokens)),\n    )\n    const chunkOutputTokens = Math.floor(\n        (summaryOutputTokens / numChunks) * (1 - chunkOutputSafetyFactor),\n    )\n    const chunkInputTokens = Math.floor(tokenLimit - summarizePromptTokens - chunkOutputTokens)\n    const summaryRatio = chunkOutputTokens / chunkInputTokens\n\n    // Split the text into chunks that each fit inside `chunkInputTokens`.\n    // Lines longer than a single chunk are force-split by token, not by\n    // character, so UTF-8 multibyte characters aren't corrupted.\n    const textLines = text.split(\"\\n\")\n    const chunks: string[] = []\n\n    let currentChunk = \"\"\n    let currentChunkTokens = 0\n    const nextChunk = (): void => {\n        if (currentChunk) chunks.push(currentChunk)\n        currentChunk = \"\"\n        currentChunkTokens = 0\n    }\n\n    // We need an encoder for the force-split path. The backend's countTokens\n    // gives us length but not the encoded array; for force-splitting we only\n    // need to chunk by an approximate token count using the same rounding.\n    // To keep this function backend-agnostic, we fall back to character-based\n    // splitting for over-long lines (rare edge case in practice).\n    for (const line of textLines) {\n        const numLineTokens = backend.countTokens(line) + 1 // +1 for the newline\n\n        if (numLineTokens > chunkInputTokens) {\n            // Long line: flush current chunk, then split this line by\n            // approximate token ratio into sub-chunks.\n            nextChunk()\n            const charsPerToken = line.length / Math.max(1, backend.countTokens(line))\n            const charsPerChunk = Math.max(1, Math.floor(chunkInputTokens * charsPerToken))\n            for (let i = 0; i < line.length; i += charsPerChunk) {\n                chunks.push(line.slice(i, i + charsPerChunk))\n            }\n            continue\n        }\n\n        if (currentChunkTokens + numLineTokens > chunkInputTokens) {\n            nextChunk()\n        }\n        currentChunkTokens += numLineTokens\n        currentChunk += line + \"\\n\"\n    }\n    nextChunk()\n\n    try {\n        const ratioText = (Math.ceil(summaryRatio * 10) / 10).toFixed(1)\n        const exampleText = Math.ceil(1000 / Math.max(summaryRatio, 0.01)).toFixed(0)\n        const summaryPrompt = SUMMARIZATION_PROMPT.replace(\"{RATIO}\", ratioText).replace(\n            \"{EXAMPLE}\",\n            exampleText,\n        )\n\n        let inputTokens = 0\n        let outputTokens = 0\n        const summaries = await Promise.all(\n            chunks.map(async (chunk) => {\n                const response = await backend.chatCompletion(summaryPrompt + chunk)\n                inputTokens += response.inputTokens\n                outputTokens += response.outputTokens\n                return response.output\n            }),\n        )\n\n        const summarized = summaries.join(\"\\n\")\n        const summarizedTokens = backend.countTokens(summarized)\n\n        return {\n            text,\n            textTokens,\n            summarized,\n            summarizedTokens,\n            inputTokens,\n            outputTokens,\n            chunks: chunks.length,\n            summarizePromptVersion: SUMMARIZE_PROMPT_VERSION,\n        }\n    } catch (error) {\n        if (error instanceof Error) {\n            throw new SummarizeTextError(`Failed to summarize text: ${error.message}`, {\n                cause: error,\n            })\n        }\n        throw new SummarizeTextError(\"Failed to summarize text (unknown error)\")\n    }\n}\n","import { getHtmlFromUrl } from \"../scrape/html\"\nimport { htmlToText } from \"../scrape/text\"\nimport type { ParsedLocations } from \"../types/domain\"\nimport type { LlmBackend } from \"./backend\"\nimport { NoLocationsFoundError } from \"./errors\"\nimport {\n    LOCATIONS_FUNCTIONS_NAME,\n    LOCATIONS_MAX_OUTPUT_TOKENS,\n    LOCATIONS_PROMPT_VERSION,\n    LOCATIONS_SCHEMA,\n    LOCATIONS_SYSTEM_MESSAGE,\n} from \"./prompts\"\nimport { summarizeText } from \"./summarize\"\nimport type { GetLocationsResponse } from \"./types\"\n\nconst FINAL_PROMPT = LOCATIONS_SYSTEM_MESSAGE + JSON.stringify(LOCATIONS_SCHEMA) + LOCATIONS_FUNCTIONS_NAME\n\nasync function callLocationExtraction(backend: LlmBackend, text: string) {\n    const out = await backend.chatFunctionJson<ParsedLocations>(\n        LOCATIONS_SYSTEM_MESSAGE,\n        text,\n        LOCATIONS_SCHEMA,\n        LOCATIONS_FUNCTIONS_NAME,\n    )\n\n    // LLM frequently returns the same address twice across different prompts.\n    // Dedupe by address string.\n    const seen = new Set<string>()\n    const unique = out.output.locations.filter((loc) => {\n        if (seen.has(loc.address)) return false\n        seen.add(loc.address)\n        return true\n    })\n    if (unique.length === 0) throw new NoLocationsFoundError()\n    out.output.locations = unique\n\n    return out\n}\n\n/**\n * Parse locations from freeform text. Two-stage: summarize to fit the context\n * window, then a function-calling JSON completion for extraction.\n */\nexport async function parseLocationsFromText(\n    backend: LlmBackend,\n    text: string,\n): Promise<GetLocationsResponse> {\n    const {\n        summarized,\n        inputTokens: sumIn,\n        outputTokens: sumOut,\n        textTokens,\n        summarizedTokens,\n        summarizePromptVersion,\n    } = await summarizeText(backend, text, FINAL_PROMPT, LOCATIONS_MAX_OUTPUT_TOKENS)\n\n    const {\n        output,\n        inputTokens: locIn,\n        outputTokens: locOut,\n    } = await callLocationExtraction(backend, summarized)\n\n    return {\n        output,\n        locationInputTokens: locIn,\n        locationOutputTokens: locOut,\n        summaryInputTokens: sumIn,\n        summaryOutputTokens: sumOut,\n        inputTokens: sumIn + locIn,\n        outputTokens: sumOut + locOut,\n        textTokens,\n        summarizedTokens,\n        summaryPromptVersion: summarizePromptVersion,\n        locationPromptVersion: LOCATIONS_PROMPT_VERSION,\n    }\n}\n\n/**\n * Parse locations from HTML. Equivalent to `htmlToText` followed by\n * {@link parseLocationsFromText}.\n */\nexport async function parseLocationsFromHtml(\n    backend: LlmBackend,\n    html: string,\n): Promise<GetLocationsResponse> {\n    return parseLocationsFromText(backend, htmlToText(html))\n}\n\n/**\n * Parse locations from a URL. Equivalent to fetching the HTML, converting to\n * text, and calling {@link parseLocationsFromText}. Throws any scrape errors\n * unchanged.\n */\nexport async function parseLocationsFromUrl(\n    backend: LlmBackend,\n    url: string,\n): Promise<GetLocationsResponse> {\n    const html = await getHtmlFromUrl(url)\n    return parseLocationsFromHtml(backend, html)\n}\n","import { encodingForModel, getEncoding, type Tiktoken, type TiktokenModel } from \"js-tiktoken\"\nimport OpenAI from \"openai\"\nimport type { JSONSchema7Object } from \"json-schema\"\nimport {\n    AiInputLengthError,\n    AiOutputLengthError,\n    AiResponseJsonError,\n    AiError,\n    InvalidJsonSchemaError,\n} from \"./errors\"\nimport type { LlmBackend } from \"./backend\"\nimport type { OpenAIOutput } from \"./types\"\n\nexport const DEFAULT_MODEL = \"gpt-4o-mini\"\nexport const DEFAULT_TOKEN_LIMIT = 128000\n\n/**\n * @deprecated Use {@link LlmBackend} instead. Kept as an alias so existing\n * consumers that import `OpenAiBackend` keep compiling.\n */\nexport type OpenAiBackend = LlmBackend\n\nexport interface OpenAiBackendConfig {\n    /** OpenAI API key. Passed directly to the SDK. */\n    apiKey: string\n    /** Model name passed to the completions API. Defaults to `gpt-4o-mini`. */\n    model?: string\n    /** Context-window budget used by the summarizer. Defaults to 128k. */\n    tokenLimit?: number\n    /**\n     * Optional base URL for the OpenAI API. Use this to route through an\n     * OpenAI-compatible gateway (Azure, Together, etc.).\n     */\n    baseURL?: string\n}\n\nfunction resolveEncoding(model: string): Tiktoken {\n    try {\n        return encodingForModel(model as TiktokenModel)\n    } catch {\n        // Fallback for models tiktoken does not recognize by name.\n        return getEncoding(\"cl100k_base\")\n    }\n}\n\n/**\n * Construct an {@link LlmBackend} bound to a specific OpenAI API key and model.\n */\nexport function createOpenAiBackend(config: OpenAiBackendConfig): LlmBackend {\n    const model = config.model ?? DEFAULT_MODEL\n    const tokenLimit = config.tokenLimit ?? DEFAULT_TOKEN_LIMIT\n    const openai = new OpenAI({\n        apiKey: config.apiKey,\n        ...(config.baseURL ? { baseURL: config.baseURL } : {}),\n    })\n    const encoding = resolveEncoding(model)\n\n    return {\n        model,\n        tokenLimit,\n\n        countTokens(text: string): number {\n            return encoding.encode(text).length\n        },\n\n        async chatCompletion(content: string): Promise<OpenAIOutput<string>> {\n            const response = await openai.chat.completions.create({\n                messages: [{ role: \"user\", content }],\n                model,\n            })\n            return {\n                output: response.choices[0]?.message.content ?? \"\",\n                inputTokens: response.usage?.prompt_tokens ?? 0,\n                outputTokens: response.usage?.completion_tokens ?? 0,\n            }\n        },\n\n        async chatFunctionJson<T>(\n            systemMessage: string,\n            userMessage: string,\n            schema: JSONSchema7Object,\n            functionName: string,\n        ): Promise<OpenAIOutput<T>> {\n            try {\n                const completion = await openai.chat.completions.create({\n                    model,\n                    messages: [\n                        { role: \"system\", content: systemMessage },\n                        { role: \"user\", content: userMessage },\n                    ],\n                    functions: [{ name: functionName, parameters: schema }],\n                    function_call: { name: functionName },\n                })\n\n                const functionCall = completion.choices[0]?.message.function_call\n                if (!functionCall) {\n                    throw new AiResponseJsonError(\"No function call in OpenAI response\")\n                }\n\n                const inputTokens = completion.usage?.prompt_tokens ?? 0\n                const outputTokens = completion.usage?.completion_tokens ?? 0\n\n                try {\n                    const output = JSON.parse(functionCall.arguments) as T\n                    return { output, inputTokens, outputTokens }\n                } catch (error) {\n                    if (error instanceof SyntaxError) {\n                        const msg = error.message.toLowerCase()\n                        if (\n                            msg.includes(\"unexpected end of json input\") ||\n                            msg.includes(\"unterminated string in js\")\n                        ) {\n                            throw new AiOutputLengthError(\n                                `Output tokens exceeded: ${error.message}`,\n                                { cause: error },\n                            )\n                        }\n                        throw new AiResponseJsonError(\n                            `Failed to parse JSON from OpenAI response: ${error.message}`,\n                            { cause: error },\n                        )\n                    }\n                    throw new AiResponseJsonError(\n                        \"Failed to parse JSON from OpenAI response (unknown reason)\",\n                    )\n                }\n            } catch (error) {\n                if (error instanceof AiError) throw error\n                if (error instanceof OpenAI.APIError) {\n                    const msg = error.message.toLowerCase()\n                    if (msg.includes(\"maximum context\")) {\n                        throw new AiInputLengthError(`Text too long: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    if (msg.includes(\"invalid schema\")) {\n                        throw new InvalidJsonSchemaError(`Invalid schema: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    throw new AiError(`OpenAI error: ${error.message}`, { cause: error })\n                }\n                throw new AiError(\"OpenAI error (unknown)\", {\n                    cause: error instanceof Error ? error : undefined,\n                })\n            }\n        },\n    }\n}\n","import Anthropic from \"@anthropic-ai/sdk\"\nimport { encodingForModel, getEncoding, type Tiktoken, type TiktokenModel } from \"js-tiktoken\"\nimport type { JSONSchema7Object } from \"json-schema\"\nimport {\n    AiError,\n    AiInputLengthError,\n    AiOutputLengthError,\n    AiResponseJsonError,\n    InvalidJsonSchemaError,\n} from \"./errors\"\nimport type { LlmBackend } from \"./backend\"\nimport type { OpenAIOutput } from \"./types\"\n\nexport const DEFAULT_ANTHROPIC_MODEL = \"claude-haiku-4-5-20251001\"\nexport const DEFAULT_ANTHROPIC_TOKEN_LIMIT = 200_000\nexport const DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS = 4096\n\nexport interface AnthropicBackendConfig {\n    /** Anthropic API key. Passed directly to the SDK. */\n    apiKey: string\n    /** Model name. Defaults to {@link DEFAULT_ANTHROPIC_MODEL}. */\n    model?: string\n    /** Context-window budget used by the summarizer. Defaults to 200k. */\n    tokenLimit?: number\n    /** Optional override for max_tokens on each request. Defaults to 4096. */\n    maxOutputTokens?: number\n    /**\n     * Optional base URL for an Anthropic-compatible gateway (Bedrock, Vertex\n     * proxy, etc.).\n     */\n    baseURL?: string\n}\n\n/**\n * Token counting fallback. The Anthropic SDK exposes a remote\n * `messages.countTokens` endpoint, but the summarizer calls `countTokens`\n * thousands of times during chunking — making it a network hop would be\n * prohibitive. We approximate with cl100k_base, which matches GPT-4-class\n * tokenizers closely enough for chunk sizing (which already has a 30%\n * safety factor applied).\n */\nfunction resolveEncoding(model: string): Tiktoken {\n    try {\n        return encodingForModel(model as TiktokenModel)\n    } catch {\n        return getEncoding(\"cl100k_base\")\n    }\n}\n\n/**\n * Construct an {@link LlmBackend} backed by Anthropic's Messages API. Use this\n * when wiring up {@link createLocationParser} or as a drop-in replacement for\n * {@link createOpenAiBackend} in any consumer that holds the interface.\n */\nexport function createAnthropicBackend(config: AnthropicBackendConfig): LlmBackend {\n    const model = config.model ?? DEFAULT_ANTHROPIC_MODEL\n    const tokenLimit = config.tokenLimit ?? DEFAULT_ANTHROPIC_TOKEN_LIMIT\n    const maxOutputTokens = config.maxOutputTokens ?? DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS\n    const client = new Anthropic({\n        apiKey: config.apiKey,\n        ...(config.baseURL ? { baseURL: config.baseURL } : {}),\n    })\n    const encoding = resolveEncoding(model)\n\n    return {\n        model,\n        tokenLimit,\n\n        countTokens(text: string): number {\n            return encoding.encode(text).length\n        },\n\n        async chatCompletion(content: string): Promise<OpenAIOutput<string>> {\n            const response = await client.messages.create({\n                model,\n                max_tokens: maxOutputTokens,\n                messages: [{ role: \"user\", content }],\n            })\n            const text = response.content\n                .filter((b): b is Anthropic.TextBlock => b.type === \"text\")\n                .map((b) => b.text)\n                .join(\"\")\n            return {\n                output: text,\n                inputTokens: response.usage.input_tokens,\n                outputTokens: response.usage.output_tokens,\n            }\n        },\n\n        async chatFunctionJson<T>(\n            systemMessage: string,\n            userMessage: string,\n            schema: JSONSchema7Object,\n            functionName: string,\n        ): Promise<OpenAIOutput<T>> {\n            try {\n                const response = await client.messages.create({\n                    model,\n                    max_tokens: maxOutputTokens,\n                    system: systemMessage,\n                    tools: [\n                        {\n                            name: functionName,\n                            description: `Return structured output matching the ${functionName} schema.`,\n                            input_schema: schema as Anthropic.Tool.InputSchema,\n                        },\n                    ],\n                    tool_choice: { type: \"tool\", name: functionName },\n                    messages: [{ role: \"user\", content: userMessage }],\n                })\n\n                const toolUse = response.content.find(\n                    (b): b is Anthropic.ToolUseBlock => b.type === \"tool_use\",\n                )\n                if (!toolUse) {\n                    throw new AiResponseJsonError(\"No tool use in Anthropic response\")\n                }\n                if (response.stop_reason === \"max_tokens\") {\n                    throw new AiOutputLengthError(\n                        `Anthropic hit max_tokens (${maxOutputTokens}) before completing tool call`,\n                    )\n                }\n\n                return {\n                    output: toolUse.input as T,\n                    inputTokens: response.usage.input_tokens,\n                    outputTokens: response.usage.output_tokens,\n                }\n            } catch (error) {\n                if (error instanceof AiError) throw error\n                if (error instanceof Anthropic.APIError) {\n                    const msg = (error.message ?? \"\").toLowerCase()\n                    if (msg.includes(\"prompt is too long\") || msg.includes(\"max_tokens\")) {\n                        throw new AiInputLengthError(`Text too long: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    if (msg.includes(\"invalid\") && msg.includes(\"schema\")) {\n                        throw new InvalidJsonSchemaError(`Invalid schema: ${error.message}`, {\n                            cause: error,\n                        })\n                    }\n                    throw new AiError(`Anthropic error: ${error.message}`, { cause: error })\n                }\n                throw new AiError(\"Anthropic error (unknown)\", {\n                    cause: error instanceof Error ? error : undefined,\n                })\n            }\n        },\n    }\n}\n","import type { LlmBackend } from \"./backend\"\nimport {\n    parseLocationsFromHtml,\n    parseLocationsFromText,\n    parseLocationsFromUrl,\n} from \"./locations\"\nimport { createOpenAiBackend, type OpenAiBackendConfig } from \"./openai\"\nimport { createAnthropicBackend, type AnthropicBackendConfig } from \"./anthropic\"\nimport type { GetLocationsResponse } from \"./types\"\n\n/**\n * A configured location-extraction pipeline. Hold onto one of these for the\n * lifetime of your app — it wraps an LLM client and a tiktoken encoder.\n */\nexport interface LocationParser {\n    parseLocationsFromText(text: string): Promise<GetLocationsResponse>\n    parseLocationsFromHtml(html: string): Promise<GetLocationsResponse>\n    parseLocationsFromUrl(url: string): Promise<GetLocationsResponse>\n}\n\n/**\n * Configuration for {@link createLocationParser}.\n *\n * - `{ provider: \"openai\", apiKey, ... }` — uses OpenAI's chat completions API\n *   with function-calling for structured output (default if omitted).\n * - `{ provider: \"anthropic\", apiKey, ... }` — uses Anthropic's Messages API\n *   with tool-use for structured output.\n * - `{ backend }` — pass any object satisfying {@link LlmBackend} directly,\n *   useful for testing or for adapters that aren't bundled here.\n *\n * For backwards compatibility a bare {@link OpenAiBackendConfig} (no\n * `provider` field) is treated as `{ provider: \"openai\", ... }`.\n */\nexport type LocationParserConfig =\n    | ({ provider?: \"openai\" } & OpenAiBackendConfig)\n    | ({ provider: \"anthropic\" } & AnthropicBackendConfig)\n    | { backend: LlmBackend }\n\nfunction resolveBackend(config: LocationParserConfig): LlmBackend {\n    if (\"backend\" in config) return config.backend\n    if (config.provider === \"anthropic\") return createAnthropicBackend(config)\n    return createOpenAiBackend(config)\n}\n\n/**\n * Create a {@link LocationParser} bound to an LLM backend.\n *\n * @example OpenAI (default)\n * ```ts\n * const parser = createLocationParser({\n *   apiKey: process.env.OPENAI_API_KEY!,\n *   model: \"gpt-4o-mini\",\n * })\n * ```\n *\n * @example Anthropic\n * ```ts\n * const parser = createLocationParser({\n *   provider: \"anthropic\",\n *   apiKey: process.env.ANTHROPIC_API_KEY!,\n *   model: \"claude-haiku-4-5-20251001\",\n * })\n * ```\n *\n * @example Bring-your-own backend\n * ```ts\n * const parser = createLocationParser({ backend: myCustomBackend })\n * ```\n */\nexport function createLocationParser(config: LocationParserConfig): LocationParser {\n    const backend = resolveBackend(config)\n    return {\n        parseLocationsFromText: (text) => parseLocationsFromText(backend, text),\n        parseLocationsFromHtml: (html) => parseLocationsFromHtml(backend, html),\n        parseLocationsFromUrl: (url) => parseLocationsFromUrl(backend, url),\n    }\n}\n"]}

package/dist/ai/index.d.cts

@@ -1,9 +1,9 @@
 import { M as MapthisError } from '../errors-Bw97z_4m.cjs';
-import { O as OpenAiBackend, S as SummarizedText, G as GetLocationsResponse } from '../parser-CzXzpmVv.cjs';
-export { D as DEFAULT_MODEL, a as DEFAULT_TOKEN_LIMIT, b as GenericAIJsonRequest, L as LocationParser, c as LocationParserConfig, d as OpenAIOutput, e as OpenAiBackendConfig, f as createLocationParser, g as createOpenAiBackend } from '../parser-CzXzpmVv.cjs';
+import { a as LlmBackend, S as SummarizedText, G as GetLocationsResponse } from '../parser-DsIwIsHK.cjs';
+export { A as AnthropicBackendConfig, D as DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS, b as DEFAULT_ANTHROPIC_MODEL, c as DEFAULT_ANTHROPIC_TOKEN_LIMIT, d as DEFAULT_MODEL, e as DEFAULT_TOKEN_LIMIT, f as GenericAIJsonRequest, L as LocationParser, g as LocationParserConfig, O as OpenAIOutput, h as OpenAiBackend, i as OpenAiBackendConfig, j as createAnthropicBackend, k as createLocationParser, l as createOpenAiBackend } from '../parser-DsIwIsHK.cjs';
 import { JSONSchema7Object } from 'json-schema';
-import '../domain-Dc1wSTkf.cjs';
-import '../schemas-Dy5coqXo.cjs';
+import '../domain-CL4ro2YW.cjs';
+import '../schemas-CZao45EU.cjs';
 import 'zod';
 
 declare class AiError extends MapthisError {
@@ -95,23 +95,23 @@ declare const SUMMARIZATION_PROMPT = "Summarize the given text. The summary must
  * A safety factor is applied to chunk output sizes because LLMs routinely
  * overshoot explicit length instructions.
  */
-declare function summarizeText(backend: OpenAiBackend, text: string, finalPrompt?: string, finalOutputTokens?: number, chunkOutputSafetyFactor?: number, tokenLimitSafetyFactor?: number): Promise<SummarizedText>;
+declare function summarizeText(backend: LlmBackend, text: string, finalPrompt?: string, finalOutputTokens?: number, chunkOutputSafetyFactor?: number, tokenLimitSafetyFactor?: number): Promise<SummarizedText>;
 
 /**
  * Parse locations from freeform text. Two-stage: summarize to fit the context
  * window, then a function-calling JSON completion for extraction.
  */
-declare function parseLocationsFromText(backend: OpenAiBackend, text: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromText(backend: LlmBackend, text: string): Promise<GetLocationsResponse>;
 /**
  * Parse locations from HTML. Equivalent to `htmlToText` followed by
  * {@link parseLocationsFromText}.
  */
-declare function parseLocationsFromHtml(backend: OpenAiBackend, html: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromHtml(backend: LlmBackend, html: string): Promise<GetLocationsResponse>;
 /**
  * Parse locations from a URL. Equivalent to fetching the HTML, converting to
  * text, and calling {@link parseLocationsFromText}. Throws any scrape errors
  * unchanged.
  */
-declare function parseLocationsFromUrl(backend: OpenAiBackend, url: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromUrl(backend: LlmBackend, url: string): Promise<GetLocationsResponse>;
 
-export { AiError, AiInputLengthError, AiOutputLengthError, AiResponseJsonError, GetLocationsResponse, InvalidJsonSchemaError, LOCATIONS_FUNCTIONS_NAME, LOCATIONS_MAX_OUTPUT_TOKENS, LOCATIONS_PROMPT_VERSION, LOCATIONS_SCHEMA, LOCATIONS_SYSTEM_MESSAGE, NoLocationsFoundError, OpenAiBackend, SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION, SummarizeTextError, SummarizedText, parseLocationsFromHtml, parseLocationsFromText, parseLocationsFromUrl, summarizeText };
+export { AiError, AiInputLengthError, AiOutputLengthError, AiResponseJsonError, GetLocationsResponse, InvalidJsonSchemaError, LOCATIONS_FUNCTIONS_NAME, LOCATIONS_MAX_OUTPUT_TOKENS, LOCATIONS_PROMPT_VERSION, LOCATIONS_SCHEMA, LOCATIONS_SYSTEM_MESSAGE, LlmBackend, NoLocationsFoundError, SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION, SummarizeTextError, SummarizedText, parseLocationsFromHtml, parseLocationsFromText, parseLocationsFromUrl, summarizeText };

package/dist/ai/index.d.ts

@@ -1,9 +1,9 @@
 import { M as MapthisError } from '../errors-Bw97z_4m.js';
-import { O as OpenAiBackend, S as SummarizedText, G as GetLocationsResponse } from '../parser-N7-fNxeu.js';
-export { D as DEFAULT_MODEL, a as DEFAULT_TOKEN_LIMIT, b as GenericAIJsonRequest, L as LocationParser, c as LocationParserConfig, d as OpenAIOutput, e as OpenAiBackendConfig, f as createLocationParser, g as createOpenAiBackend } from '../parser-N7-fNxeu.js';
+import { a as LlmBackend, S as SummarizedText, G as GetLocationsResponse } from '../parser-CrG1A6dD.js';
+export { A as AnthropicBackendConfig, D as DEFAULT_ANTHROPIC_MAX_OUTPUT_TOKENS, b as DEFAULT_ANTHROPIC_MODEL, c as DEFAULT_ANTHROPIC_TOKEN_LIMIT, d as DEFAULT_MODEL, e as DEFAULT_TOKEN_LIMIT, f as GenericAIJsonRequest, L as LocationParser, g as LocationParserConfig, O as OpenAIOutput, h as OpenAiBackend, i as OpenAiBackendConfig, j as createAnthropicBackend, k as createLocationParser, l as createOpenAiBackend } from '../parser-CrG1A6dD.js';
 import { JSONSchema7Object } from 'json-schema';
-import '../domain-CZ-L-ntu.js';
-import '../schemas-Dy5coqXo.js';
+import '../domain-Dh8cPBVp.js';
+import '../schemas-CZao45EU.js';
 import 'zod';
 
 declare class AiError extends MapthisError {
@@ -95,23 +95,23 @@ declare const SUMMARIZATION_PROMPT = "Summarize the given text. The summary must
  * A safety factor is applied to chunk output sizes because LLMs routinely
  * overshoot explicit length instructions.
  */
-declare function summarizeText(backend: OpenAiBackend, text: string, finalPrompt?: string, finalOutputTokens?: number, chunkOutputSafetyFactor?: number, tokenLimitSafetyFactor?: number): Promise<SummarizedText>;
+declare function summarizeText(backend: LlmBackend, text: string, finalPrompt?: string, finalOutputTokens?: number, chunkOutputSafetyFactor?: number, tokenLimitSafetyFactor?: number): Promise<SummarizedText>;
 
 /**
  * Parse locations from freeform text. Two-stage: summarize to fit the context
  * window, then a function-calling JSON completion for extraction.
  */
-declare function parseLocationsFromText(backend: OpenAiBackend, text: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromText(backend: LlmBackend, text: string): Promise<GetLocationsResponse>;
 /**
  * Parse locations from HTML. Equivalent to `htmlToText` followed by
  * {@link parseLocationsFromText}.
  */
-declare function parseLocationsFromHtml(backend: OpenAiBackend, html: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromHtml(backend: LlmBackend, html: string): Promise<GetLocationsResponse>;
 /**
  * Parse locations from a URL. Equivalent to fetching the HTML, converting to
  * text, and calling {@link parseLocationsFromText}. Throws any scrape errors
  * unchanged.
  */
-declare function parseLocationsFromUrl(backend: OpenAiBackend, url: string): Promise<GetLocationsResponse>;
+declare function parseLocationsFromUrl(backend: LlmBackend, url: string): Promise<GetLocationsResponse>;
 
-export { AiError, AiInputLengthError, AiOutputLengthError, AiResponseJsonError, GetLocationsResponse, InvalidJsonSchemaError, LOCATIONS_FUNCTIONS_NAME, LOCATIONS_MAX_OUTPUT_TOKENS, LOCATIONS_PROMPT_VERSION, LOCATIONS_SCHEMA, LOCATIONS_SYSTEM_MESSAGE, NoLocationsFoundError, OpenAiBackend, SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION, SummarizeTextError, SummarizedText, parseLocationsFromHtml, parseLocationsFromText, parseLocationsFromUrl, summarizeText };
+export { AiError, AiInputLengthError, AiOutputLengthError, AiResponseJsonError, GetLocationsResponse, InvalidJsonSchemaError, LOCATIONS_FUNCTIONS_NAME, LOCATIONS_MAX_OUTPUT_TOKENS, LOCATIONS_PROMPT_VERSION, LOCATIONS_SCHEMA, LOCATIONS_SYSTEM_MESSAGE, LlmBackend, NoLocationsFoundError, SUMMARIZATION_PROMPT, SUMMARIZE_PROMPT_VERSION, SummarizeTextError, SummarizedText, parseLocationsFromHtml, parseLocationsFromText, parseLocationsFromUrl, summarizeText };