@mapbox/mcp-server 0.12.7 → 0.13.0

package/dist/esm/tools/union-tool/UnionTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"UnionTool.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,iBAAiB,EAElB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,OAAO,SAAU,SAAQ,QAG9B;IACU,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,6DAA6D;QAC7D,uFAAuF;QACvF,kEAAkE;QAClE,kCAAkC,CAAC;IAE5B,WAAW,GAAG;QACrB,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;QACE,KAAK,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAiB;QACzB,MAAM,WAAW,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,OAAO,CAAC,IAAI,CACvB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EACjD,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAE/C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5D,4DAA4D;gBAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAE9D,MAAM,MAAM,GAAgB;oBAC1B,QAAQ,EAAE,MAAM,CAAC,QAA8C;oBAC/D,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;iBAC3B,CAAC;gBAEF,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAgB,CAAC;gBAE7D,MAAM,IAAI,GACR,YAAY,KAAK,CAAC,QAAQ,CAAC,MAAM,uBAAuB;oBACxD,gBAAgB,SAAS,CAAC,IAAI,IAAI;oBAClC,sBAAsB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAEtE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxD,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAEvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;oBAC1C,iBAAiB,EAAE,SAAS;oBAC5B,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,IAAI,EAAE,cAAc,CAAC,KAAK;oBAC1B,OAAO,EAAE,YAAY;iBACtB,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,YAAY,EAAE,EAAE;qBAC9D;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"UnionTool.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/union-tool/UnionTool.output.schema.d.ts

@@ -2,6 +2,9 @@ import { z } from 'zod';
 export declare const UnionOutputSchema: z.ZodObject<{
     geometry: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     type: z.ZodString;
-}, z.core.$strip>;
+    mapboxRender: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
 export type UnionOutput = z.infer<typeof UnionOutputSchema>;
 //# sourceMappingURL=UnionTool.output.schema.d.ts.map

package/dist/esm/tools/union-tool/UnionTool.output.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnionTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"UnionTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;iBAUd,CAAC;AAEjB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/esm/tools/union-tool/UnionTool.output.schema.js

@@ -1,10 +1,14 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 import { z } from 'zod';
-export const UnionOutputSchema = z.object({
+import { MapAppRefSchema } from '../../utils/storeMapPayload.js';
+export const UnionOutputSchema = z
+    .object({
     geometry: z
         .record(z.string(), z.unknown())
         .describe('GeoJSON geometry of the merged polygon (Polygon or MultiPolygon)'),
-    type: z.string().describe('Geometry type: Polygon or MultiPolygon')
-});
+    type: z.string().describe('Geometry type: Polygon or MultiPolygon'),
+    mapboxRender: MapAppRefSchema.optional()
+})
+    .passthrough();
 //# sourceMappingURL=UnionTool.output.schema.js.map

package/dist/esm/tools/union-tool/UnionTool.output.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"UnionTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CACP,kEAAkE,CACnE;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACpE,CAAC,CAAC"}
+{"version":3,"file":"UnionTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CACP,kEAAkE,CACnE;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACnE,YAAY,EAAE,eAAe,CAAC,QAAQ,EAAE;CACzC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/esm/tools/union-tool/buildPolygonOpsMapPayload.d.ts

@@ -0,0 +1,21 @@
+import type { MapAppPayload } from '../../utils/mapAppPayload.js';
+export type PolygonOperation = 'union' | 'intersect' | 'difference';
+/**
+ * Build a `MapAppPayload` for the offline polygon-op tools
+ * (union/intersect/difference). Renders input polygons in muted blue and the
+ * result in an operation-keyed color. Used by all three tools — color and
+ * summary are the only operation-dependent fields.
+ */
+export declare function buildPolygonOpsMapPayload(params: {
+    operation: PolygonOperation;
+    inputs: Array<{
+        type: 'Feature';
+        geometry: unknown;
+    }>;
+    result: {
+        type: 'Feature';
+        geometry: unknown;
+    } | null;
+    summary: string;
+}): MapAppPayload | null;
+//# sourceMappingURL=buildPolygonOpsMapPayload.d.ts.map

package/dist/esm/tools/union-tool/buildPolygonOpsMapPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPolygonOpsMapPayload.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/buildPolygonOpsMapPayload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAQpE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,MAAM,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,GAAG,IAAI,CAyDvB"}

package/dist/esm/tools/union-tool/buildPolygonOpsMapPayload.js

@@ -0,0 +1,69 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+const RESULT_COLORS = {
+    union: '#22c55e', // green
+    intersect: '#8b5cf6', // purple
+    difference: '#f97316' // orange
+};
+/**
+ * Build a `MapAppPayload` for the offline polygon-op tools
+ * (union/intersect/difference). Renders input polygons in muted blue and the
+ * result in an operation-keyed color. Used by all three tools — color and
+ * summary are the only operation-dependent fields.
+ */
+export function buildPolygonOpsMapPayload(params) {
+    const { operation, inputs, result, summary } = params;
+    if (inputs.length === 0)
+        return null;
+    const resultColor = RESULT_COLORS[operation];
+    const layers = [];
+    inputs.forEach((feature, i) => {
+        layers.push({
+            id: `input-fill-${i}`,
+            type: 'fill',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data: feature,
+            paint: { 'fill-color': '#3b82f6', 'fill-opacity': 0.25 }
+        });
+        layers.push({
+            id: `input-line-${i}`,
+            type: 'line',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data: feature,
+            paint: {
+                'line-color': '#3b82f6',
+                'line-width': 2,
+                'line-opacity': 0.7
+            },
+            layout: { 'line-join': 'round', 'line-cap': 'round' }
+        });
+    });
+    if (result && result.geometry) {
+        layers.push({
+            id: 'result-fill',
+            type: 'fill',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data: result,
+            paint: { 'fill-color': resultColor, 'fill-opacity': 0.45 }
+        });
+        layers.push({
+            id: 'result-line',
+            type: 'line',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data: result,
+            paint: { 'line-color': resultColor, 'line-width': 3 },
+            layout: { 'line-join': 'round', 'line-cap': 'round' }
+        });
+    }
+    return {
+        summary,
+        layers,
+        legend: [
+            { label: 'Inputs', color: '#3b82f6', opacity: 0.35 },
+            ...(result
+                ? [{ label: `${operation} result`, color: resultColor, opacity: 0.7 }]
+                : [])
+        ]
+    };
+}
+//# sourceMappingURL=buildPolygonOpsMapPayload.js.map

package/dist/esm/tools/union-tool/buildPolygonOpsMapPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPolygonOpsMapPayload.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/buildPolygonOpsMapPayload.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAMlC,MAAM,aAAa,GAAqC;IACtD,KAAK,EAAE,SAAS,EAAE,QAAQ;IAC1B,SAAS,EAAE,SAAS,EAAE,SAAS;IAC/B,UAAU,EAAE,SAAS,CAAC,SAAS;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAKzC;IACC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,cAAc,CAAC,EAAE;YACrB,IAAI,EAAE,MAAM;YACZ,8DAA8D;YAC9D,IAAI,EAAE,OAAc;YACpB,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE;SACzD,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,cAAc,CAAC,EAAE;YACrB,IAAI,EAAE,MAAM;YACZ,8DAA8D;YAC9D,IAAI,EAAE,OAAc;YACpB,KAAK,EAAE;gBACL,YAAY,EAAE,SAAS;gBACvB,YAAY,EAAE,CAAC;gBACf,cAAc,EAAE,GAAG;aACpB;YACD,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;SACtD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,MAAM;YACZ,8DAA8D;YAC9D,IAAI,EAAE,MAAa;YACnB,KAAK,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE;SAC3D,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,MAAM;YACZ,8DAA8D;YAC9D,IAAI,EAAE,MAAa;YACnB,KAAK,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE;YACrD,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM;QACN,MAAM,EAAE;YACN,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACpD,GAAG,CAAC,MAAM;gBACR,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;gBACtE,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/utils/computeRef.d.ts

@@ -0,0 +1,38 @@
+import type { MapAppPayload } from './mapAppPayload.js';
+export type PolygonOperation = 'union' | 'intersect' | 'difference';
+type ComputeFeature = {
+    type: 'Feature';
+    geometry: unknown;
+};
+/**
+ * Stateless alternative to `storeMapPayload` for the offline polygon-op
+ * tools (union/intersect/difference). Those tools compute their result from
+ * `@turf/turf` given only the caller's own input polygons — there is no
+ * external API response to cache and no reason a ref should depend on
+ * server-side state at all.
+ *
+ * Instead of storing the *computed result* behind an opaque UUID (which is
+ * lost on every process restart — see the mapbox://temp/ 30-min-TTL-in-
+ * memory-store issue this was built to avoid), the ref itself carries the
+ * *inputs* (already present in the tool's own call arguments, so no bigger
+ * than what the LLM already emitted to call union/intersect/difference in
+ * the first place). `resolveComputeRef` re-derives the result by re-running
+ * the same turf operation. This makes the ref:
+ *  - immune to server restarts (nothing to lose — it's a pure function of
+ *    the URI's own contents),
+ *  - safe under horizontal scaling (any instance can resolve any ref; no
+ *    server affinity, unlike an in-memory store keyed by process),
+ *  - safe across accounts (no owner check needed — the ref only ever
+ *    contains geometry the caller already had).
+ */
+export declare function buildComputeRef(operation: PolygonOperation, inputs: ComputeFeature[]): string;
+/**
+ * Re-derive the `MapAppPayload` for a `mapbox://compute/...` ref by
+ * re-running the encoded turf operation. Returns null if the ref isn't a
+ * compute ref, the operation is unrecognized, or the encoded data doesn't
+ * decode to a valid input array.
+ */
+export declare function resolveComputeRef(uri: string): MapAppPayload | null;
+export declare function isComputeRef(uri: string): boolean;
+export {};
+//# sourceMappingURL=computeRef.d.ts.map

package/dist/esm/utils/computeRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeRef.d.ts","sourceRoot":"","sources":["../../../src/utils/computeRef.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAIpE,KAAK,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,cAAc,EAAE,GACvB,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoEnE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/esm/utils/computeRef.js

@@ -0,0 +1,111 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { union, intersect, difference, featureCollection } from '@turf/turf';
+import { buildPolygonOpsMapPayload } from '../tools/union-tool/buildPolygonOpsMapPayload.js';
+const COMPUTE_URI_PREFIX = 'mapbox://compute/';
+/**
+ * Stateless alternative to `storeMapPayload` for the offline polygon-op
+ * tools (union/intersect/difference). Those tools compute their result from
+ * `@turf/turf` given only the caller's own input polygons — there is no
+ * external API response to cache and no reason a ref should depend on
+ * server-side state at all.
+ *
+ * Instead of storing the *computed result* behind an opaque UUID (which is
+ * lost on every process restart — see the mapbox://temp/ 30-min-TTL-in-
+ * memory-store issue this was built to avoid), the ref itself carries the
+ * *inputs* (already present in the tool's own call arguments, so no bigger
+ * than what the LLM already emitted to call union/intersect/difference in
+ * the first place). `resolveComputeRef` re-derives the result by re-running
+ * the same turf operation. This makes the ref:
+ *  - immune to server restarts (nothing to lose — it's a pure function of
+ *    the URI's own contents),
+ *  - safe under horizontal scaling (any instance can resolve any ref; no
+ *    server affinity, unlike an in-memory store keyed by process),
+ *  - safe across accounts (no owner check needed — the ref only ever
+ *    contains geometry the caller already had).
+ */
+export function buildComputeRef(operation, inputs) {
+    const data = Buffer.from(JSON.stringify(inputs), 'utf8').toString('base64url');
+    return `${COMPUTE_URI_PREFIX}${operation}?data=${data}`;
+}
+/**
+ * Re-derive the `MapAppPayload` for a `mapbox://compute/...` ref by
+ * re-running the encoded turf operation. Returns null if the ref isn't a
+ * compute ref, the operation is unrecognized, or the encoded data doesn't
+ * decode to a valid input array.
+ */
+export function resolveComputeRef(uri) {
+    if (!uri.startsWith(COMPUTE_URI_PREFIX))
+        return null;
+    let operation;
+    let encoded;
+    try {
+        const parsed = new URL(uri);
+        // The operation is the path segment, not the hostname: for
+        // `mapbox://compute/union?...` the WHATWG URL parser treats `compute`
+        // as the hostname and `/union` as the pathname.
+        operation = parsed.pathname.replace(/^\//, '');
+        encoded = parsed.searchParams.get('data');
+    }
+    catch {
+        return null;
+    }
+    if (!encoded)
+        return null;
+    let inputs;
+    try {
+        inputs = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(inputs) || inputs.length === 0)
+        return null;
+    // `inputs` came from base64-decoded JSON built by buildComputeRef, which
+    // only ever writes `{ type: 'Feature', geometry }` (no `properties`) —
+    // turf doesn't require it at runtime, so cast past the stricter
+    // `Feature<Polygon | MultiPolygon>` shape rather than adding a field
+    // nothing reads.
+    const fc = featureCollection(inputs);
+    switch (operation) {
+        case 'union': {
+            const result = union(fc);
+            if (!result)
+                return null;
+            return buildPolygonOpsMapPayload({
+                operation: 'union',
+                inputs,
+                result,
+                summary: `Union of ${inputs.length} polygons`
+            });
+        }
+        case 'intersect': {
+            const result = intersect(fc);
+            return buildPolygonOpsMapPayload({
+                operation: 'intersect',
+                inputs,
+                result: result ?? null,
+                summary: result
+                    ? 'Intersection of two polygons'
+                    : 'Polygons do not intersect'
+            });
+        }
+        case 'difference': {
+            const result = difference(fc);
+            return buildPolygonOpsMapPayload({
+                operation: 'difference',
+                inputs,
+                result: result ?? null,
+                summary: result
+                    ? 'Difference of two polygons (polygon1 minus polygon2)'
+                    : 'polygon2 fully covers polygon1 (no difference)'
+            });
+        }
+        default:
+            return null;
+    }
+}
+export function isComputeRef(uri) {
+    return uri.startsWith(COMPUTE_URI_PREFIX);
+}
+//# sourceMappingURL=computeRef.js.map

package/dist/esm/utils/computeRef.js.map

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

package/dist/esm/utils/inlinePayloadRef.d.ts

@@ -0,0 +1,32 @@
+import type { MapAppPayload } from './mapAppPayload.js';
+/**
+ * Self-describing counterpart to `storeMapPayload` for `render_map_tool`'s
+ * own merged output. The whole resolved payload is base64'd directly into
+ * the ref — no server-side store, no TTL, no owner.
+ *
+ * Why this exists: `render_map_tool` used to *always* call `storeMapPayload`
+ * for its merged output, even when every input was already a self-
+ * describing `mapbox://compute/...` or `mapbox://selffetch/...` ref (see
+ * computeRef.ts / selfFetchRef.ts). That meant Claude Desktop — which
+ * strips `structuredContent` and depends entirely on `resources/read`
+ * against the sentinel-embedded ref — was still vulnerable to the exact
+ * restart/rehydration bug those refs were built to eliminate, because the
+ * *final* hop (render_map_tool's own ref) was still ephemeral regardless of
+ * how the inputs got there. ChatGPT was unaffected (it reads the payload
+ * straight out of `structuredContent`, never touching the ref), which is
+ * why the gap wasn't obvious from that side.
+ *
+ * Only used when the merged payload is small enough to inline (see
+ * `MAX_INLINE_PAYLOAD_BYTES` in storeMapPayload.ts) — a payload backed by a
+ * genuinely large upstream `mapbox://temp/...` resource still needs the
+ * real store and keeps the existing TTL behavior.
+ */
+export declare function buildInlinePayloadRef(payload: MapAppPayload): string;
+export declare function isInlinePayloadRef(uri: string): boolean;
+/**
+ * Unwrap a `mapbox://inline/payload?data=...` ref back into its
+ * `MapAppPayload`. Returns null if the ref isn't this scheme or its data
+ * doesn't decode.
+ */
+export declare function resolveInlinePayloadRef(uri: string): MapAppPayload | null;
+//# sourceMappingURL=inlinePayloadRef.d.ts.map

package/dist/esm/utils/inlinePayloadRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlinePayloadRef.d.ts","sourceRoot":"","sources":["../../../src/utils/inlinePayloadRef.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAKpE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CASzE"}

package/dist/esm/utils/inlinePayloadRef.js

@@ -0,0 +1,51 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+const INLINE_PAYLOAD_URI_PREFIX = 'mapbox://inline/payload?data=';
+/**
+ * Self-describing counterpart to `storeMapPayload` for `render_map_tool`'s
+ * own merged output. The whole resolved payload is base64'd directly into
+ * the ref — no server-side store, no TTL, no owner.
+ *
+ * Why this exists: `render_map_tool` used to *always* call `storeMapPayload`
+ * for its merged output, even when every input was already a self-
+ * describing `mapbox://compute/...` or `mapbox://selffetch/...` ref (see
+ * computeRef.ts / selfFetchRef.ts). That meant Claude Desktop — which
+ * strips `structuredContent` and depends entirely on `resources/read`
+ * against the sentinel-embedded ref — was still vulnerable to the exact
+ * restart/rehydration bug those refs were built to eliminate, because the
+ * *final* hop (render_map_tool's own ref) was still ephemeral regardless of
+ * how the inputs got there. ChatGPT was unaffected (it reads the payload
+ * straight out of `structuredContent`, never touching the ref), which is
+ * why the gap wasn't obvious from that side.
+ *
+ * Only used when the merged payload is small enough to inline (see
+ * `MAX_INLINE_PAYLOAD_BYTES` in storeMapPayload.ts) — a payload backed by a
+ * genuinely large upstream `mapbox://temp/...` resource still needs the
+ * real store and keeps the existing TTL behavior.
+ */
+export function buildInlinePayloadRef(payload) {
+    const data = Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url');
+    return `${INLINE_PAYLOAD_URI_PREFIX}${data}`;
+}
+export function isInlinePayloadRef(uri) {
+    return uri.startsWith(INLINE_PAYLOAD_URI_PREFIX);
+}
+/**
+ * Unwrap a `mapbox://inline/payload?data=...` ref back into its
+ * `MapAppPayload`. Returns null if the ref isn't this scheme or its data
+ * doesn't decode.
+ */
+export function resolveInlinePayloadRef(uri) {
+    if (!isInlinePayloadRef(uri))
+        return null;
+    const encoded = uri.slice(INLINE_PAYLOAD_URI_PREFIX.length);
+    if (!encoded)
+        return null;
+    try {
+        return JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=inlinePayloadRef.js.map

package/dist/esm/utils/inlinePayloadRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlinePayloadRef.js","sourceRoot":"","sources":["../../../src/utils/inlinePayloadRef.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAIlC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAChE,WAAW,CACZ,CAAC;IACF,OAAO,GAAG,yBAAyB,GAAG,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/utils/mapAppPayload.d.ts

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+/**
+ * Payload format for the generic Mapbox MCP App (`ui://mapbox/map-app/...`).
+ *
+ * Tools that want to render their result on a live Mapbox GL JS map produce
+ * a `MapAppPayload` and attach it to the tool result at `_meta.ui.payload`.
+ * The shared iframe template reads it and translates each entry into
+ * `map.addSource`/`map.addLayer`/`new mapboxgl.Marker` calls.
+ *
+ * The payload is intentionally a thin pass-through to Mapbox Style spec
+ * `paint` and `layout` objects rather than its own DSL — the iframe just
+ * forwards them to GL JS. That keeps the spec surface small and avoids
+ * reinventing a chunk of the style spec over postMessage.
+ */
+export type Geometry = {
+    type: 'Point';
+    coordinates: [number, number];
+} | {
+    type: 'LineString';
+    coordinates: [number, number][];
+} | {
+    type: 'Polygon';
+    coordinates: [number, number][][];
+} | {
+    type: 'MultiPolygon';
+    coordinates: [number, number][][][];
+};
+export type Feature = {
+    type: 'Feature';
+    geometry: Geometry;
+    properties?: Record<string, unknown>;
+};
+export type FeatureCollection = {
+    type: 'FeatureCollection';
+    features: Feature[];
+};
+export interface MapAppLayer {
+    /** Unique within the payload — used as both source id and layer id. */
+    id: string;
+    type: 'fill' | 'line' | 'circle' | 'symbol';
+    data: Feature | FeatureCollection;
+    /** Mapbox Style spec paint object, passed through to addLayer. */
+    paint?: Record<string, unknown>;
+    /** Mapbox Style spec layout object, passed through to addLayer. */
+    layout?: Record<string, unknown>;
+}
+export interface MapAppMarker {
+    coordinates: [number, number];
+    /**
+     * Visual style:
+     *   - `pin`: default Mapbox marker
+     *   - `numbered`: circular badge containing `label` (e.g. visit order)
+     *   - `start`/`end`: green/red circular badge (route endpoints)
+     */
+    style?: 'pin' | 'numbered' | 'start' | 'end';
+    /** Required when style === 'numbered'. */
+    label?: string;
+    /** Optional CSS color override; defaults are style-derived. */
+    color?: string;
+    /** Popup text (optional). */
+    popup?: string;
+}
+export interface MapAppLegendEntry {
+    label: string;
+    color: string;
+    opacity?: number;
+}
+export interface MapAppCamera {
+    center?: [number, number];
+    zoom?: number;
+    /** If set, takes precedence over center/zoom and over auto-fit. */
+    bounds?: [[number, number], [number, number]];
+}
+/**
+ * For responses >50KB where the geometry is offloaded to a temp resource:
+ * the iframe will fetch this URI via `resources/read` (host bridge) and
+ * merge the returned GeoJSON into the named layer.
+ */
+export interface MapAppDeferredLayer {
+    resourceUri: string;
+    layerId: string;
+}
+/**
+ * A layer the iframe must fetch and build *itself*, directly from the
+ * Mapbox API using its own public token — rather than server-computed
+ * geometry passed through a ref. Used by tools whose geometry is a single
+ * Mapbox API call away from the tool's own input params (e.g. directions,
+ * isochrone, map matching, search, category search, trip optimization),
+ * so the map preview never depends on server-side storage that a process
+ * restart or a conversation rehydration could invalidate. See
+ * `src/utils/selfFetchRef.ts` and the `selffetch` handling in
+ * `mapAppHtml.ts`.
+ */
+export interface MapAppSelfFetch {
+    tool: 'directions' | 'isochrone' | 'map_matching' | 'search' | 'category_search' | 'optimization' | 'ground_location';
+    params: Record<string, unknown>;
+}
+export interface MapAppPayload {
+    /** Short header chip shown in the top-left of the iframe. */
+    summary?: string;
+    /** Layers to add to the map (in order). */
+    layers: MapAppLayer[];
+    markers?: MapAppMarker[];
+    /** Bottom-left legend rows (color swatch + label). */
+    legend?: MapAppLegendEntry[];
+    /** Optional initial camera; otherwise auto-fits to the union of all data. */
+    camera?: MapAppCamera;
+    /** Optional fetch-on-render hook for large geometries. */
+    defer?: MapAppDeferredLayer;
+    /** Layers the iframe fetches and builds itself, post-initial-render. */
+    selfFetch?: MapAppSelfFetch[];
+}
+export declare const MapAppPayloadSchema: z.ZodObject<{
+    summary: z.ZodOptional<z.ZodString>;
+    layers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            symbol: "symbol";
+            fill: "fill";
+            line: "line";
+            circle: "circle";
+        }>;
+        data: z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"Feature">;
+            geometry: z.ZodObject<{
+                type: z.ZodEnum<{
+                    Point: "Point";
+                    LineString: "LineString";
+                    Polygon: "Polygon";
+                    MultiPolygon: "MultiPolygon";
+                }>;
+                coordinates: z.ZodUnknown;
+            }, z.core.$strip>;
+            properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"FeatureCollection">;
+            features: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"Feature">;
+                geometry: z.ZodObject<{
+                    type: z.ZodEnum<{
+                        Point: "Point";
+                        LineString: "LineString";
+                        Polygon: "Polygon";
+                        MultiPolygon: "MultiPolygon";
+                    }>;
+                    coordinates: z.ZodUnknown;
+                }, z.core.$strip>;
+                properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>;
+        paint: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        layout: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    markers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        style: z.ZodOptional<z.ZodEnum<{
+            start: "start";
+            pin: "pin";
+            numbered: "numbered";
+            end: "end";
+        }>>;
+        label: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        popup: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    legend: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        color: z.ZodString;
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        zoom: z.ZodOptional<z.ZodNumber>;
+        bounds: z.ZodOptional<z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>], null>>;
+    }, z.core.$strip>>;
+    selfFetch: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tool: z.ZodEnum<{
+            search: "search";
+            directions: "directions";
+            isochrone: "isochrone";
+            map_matching: "map_matching";
+            category_search: "category_search";
+            optimization: "optimization";
+            ground_location: "ground_location";
+        }>;
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Decode a Mapbox polyline string (precision 5 by default) to a GeoJSON
+ * LineString. Used tool-side so the iframe never has to do this — the
+ * generic renderer only ever sees GeoJSON.
+ *
+ * Returns null if the decoded coordinates fall outside lng/lat bounds,
+ * which can happen if the precision is wrong (the Directions API can emit
+ * polyline6 when `geometries=polyline6`). Callers should try precision 6
+ * as a fallback.
+ */
+export declare function decodePolyline(str: string, precision?: number): [number, number][] | null;
+/**
+ * Convenience: decode polyline with precision-5 then precision-6 fallback.
+ * If both produce out-of-range coordinates, returns null and the caller
+ * should skip emitting a map-app payload (the geometry can't be drawn).
+ */
+export declare function decodePolylineWithFallback(str: string): [number, number][] | null;
+//# sourceMappingURL=mapAppPayload.d.ts.map

package/dist/esm/utils/mapAppPayload.d.ts.map

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