@mgcrea/mcp-apple-maps 1.24.1 → 1.25.0

package/README.md

@@ -36,14 +36,26 @@ client that has not opted in is never told they exist.
 | `apple_maps_add_favorite`    | save a place as a favourite, seeding it through `maps://` |
 | `apple_maps_remove_favorite` | drop a favourite row                                      |
 
+Three more press controls on a place card through Accessibility rather than writing SQL, and are
+registered only when Cupertino.app hosts this server: the grant belongs to the app, so a package
+run from npm has no way to reach them and is never told they exist.
+
+| Tool                            | What                                                       |
+| ------------------------------- | ---------------------------------------------------------- |
+| `apple_maps_save_place`         | add a place to the Places library (not the same as Pinned) |
+| `apple_maps_remove_saved_place` | remove a place from the Places library                     |
+| `apple_maps_add_place_to_guide` | file a place in an existing Guide; Maps cannot confirm it  |
+
+Each opens Maps, brings its window forward and leaves the place in your Recents.
+
 ## What it does not do
 
 It reads what is **saved on this Mac**. It does not search Apple's map of the world, geocode an
 address, give directions or compute a travel time. Those are network calls to Apple's services,
 not data on your disk.
 
-It writes only **favourites**, and only with `APPLE_MAPS_ALLOW_WRITES` set. Everything else here is
-read-only. The store is mirrored to iCloud by `NSPersistentCloudKitContainer`, so a write is an edit
+It writes only with `APPLE_MAPS_ALLOW_WRITES` set: favourites through the store, and the Places
+library and Guide membership through Maps' own interface. Everything else here is read-only. The store is mirrored to iCloud by `NSPersistentCloudKitContainer`, so a write is an edit
 to one replica of a synchronising object graph underneath a running app — a malformed row reaches
 every device on the account. That is why a place record is never fabricated: adding a favourite opens
 `maps://` so that Maps itself mints the record, and only then is it copied. **The place is left in
@@ -61,15 +73,20 @@ If a listing comes back empty, that means you have saved nothing of that kind. R
 
 ## Configuration
 
-| Variable                    | Default    | What                                                   |
-| --------------------------- | ---------- | ------------------------------------------------------ |
-| `APPLE_MAPS_STORE`          | discovered | explicit store path, for tests and forensic copies     |
-| `APPLE_MAPS_INDEX_MODE`     | `auto`     | `auto` / `ro` / `immutable` / `off`                    |
-| `APPLE_MAPS_MAX_RESULTS`    | 50         | default result ceiling                                 |
-| `APPLE_MAPS_EXPOSE_PROMPTS` | on         | register the prompt and `cupertino://maps/*` resources |
-| `APPLE_MAPS_DEBUG`          | off        | verbose logging on stderr                              |
+| Variable                     | Default    | What                                                      |
+| ---------------------------- | ---------- | --------------------------------------------------------- |
+| `APPLE_MAPS_STORE`           | discovered | explicit store path, for tests and forensic copies        |
+| `APPLE_MAPS_INDEX_MODE`      | `auto`     | `auto` / `ro` / `immutable` / `off`                       |
+| `APPLE_MAPS_MAX_RESULTS`     | 50         | default result ceiling                                    |
+| `APPLE_MAPS_SEED_TIMEOUT_MS` | 30000      | how long `add_favorite` waits for Maps to resolve a place |
+| `APPLE_MAPS_EXPOSE_PROMPTS`  | on         | register the prompt and `cupertino://maps/*` resources    |
+| `APPLE_MAPS_DEBUG`           | off        | verbose logging on stderr                                 |
 
-`APPLE_MAPS_ALLOW_WRITES` is accepted and ignored: there is no mutating tool for it to gate.
+`APPLE_MAPS_ALLOW_WRITES` (off) registers the tools under [What it writes](#what-it-writes).
 
 See [docs/maps.md](../../docs/maps.md) for the phase-0 measurements, including the three separate
 occasions on which this store was declared not to exist.
+
+## Licence
+
+[MIT](LICENSE).

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as MAPS_SURFACE, N as BUILD_INFO, a as loadConfig, r as createServer } from "./server-Cos6wXAu.js";
+import { C as MAPS_SURFACE, N as BUILD_INFO, a as loadConfig, r as createServer } from "./server-CO_d1_6b.js";
 import { runStdioServer } from "@mgcrea/mcp-apple-core";
 //#region src/cli.ts
 const LOG_PREFIX = "apple-maps-mcp";
@@ -18,7 +18,7 @@ runStdioServer({
 		const rows = (k) => caps?.entities?.[k]?.rows ?? 0;
 		return {
 			server,
-			banner: `read-only, store=${status.store.opened ? status.store.mode ?? "open" : "UNREADABLE"}, favorites=${rows("favorites")}, collections=${rows("collections")}, recents=${rows("history")}, index=${config.indexMode}`
+			banner: `writes=${config.allowWrites ? "ENABLED" : "disabled"}, store=${status.store.opened ? status.store.mode ?? "open" : "UNREADABLE"}, favorites=${rows("favorites")}, collections=${rows("collections")}, recents=${rows("history")}, index=${config.indexMode}`
 		};
 	}
 }).catch((err) => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { runStdioServer } from \"@mgcrea/mcp-apple-core\";\n\nimport { BUILD_INFO } from \"./build-info.js\";\nimport { MAPS_SURFACE } from \"./client/errors.js\";\nimport { loadConfig } from \"./config.js\";\nimport { createServer } from \"./server.js\";\n\nconst LOG_PREFIX = \"apple-maps-mcp\";\n\nrunStdioServer({\n  build: BUILD_INFO,\n  surface: MAPS_SURFACE,\n  logPrefix: LOG_PREFIX,\n  start: async (logger) => {\n    const config = loadConfig();\n    const { server, client } = createServer({ config, logger });\n    const status = client.status();\n    const caps = status.capabilities as { entities?: Record<string, { rows?: number }> } | null;\n    const rows = (k: string): number => caps?.entities?.[k]?.rows ?? 0;\n    return {\n      server,\n      // No writes= line: this surface has no mutating tool, and printing a flag\n      // that gates nothing would imply one exists. The counts are named because\n      // \"store=open\" alone cannot distinguish a working server from one pointed\n      // at an empty replica — which is exactly what the device-local cache is.\n      banner:\n        `read-only, ` +\n        `store=${status.store.opened ? (status.store.mode ?? \"open\") : \"UNREADABLE\"}, ` +\n        `favorites=${rows(\"favorites\")}, ` +\n        `collections=${rows(\"collections\")}, ` +\n        `recents=${rows(\"history\")}, ` +\n        `index=${config.indexMode}`,\n    };\n  },\n}).catch((err: unknown) => {\n  console.error(`[${LOG_PREFIX}] fatal:`, err);\n  process.exit(1);\n});\n"],"mappings":";;;;AAQA,MAAM,aAAa;AAEnB,eAAe;CACb,OAAO;CACP,SAAS;CACT,WAAW;CACX,OAAO,OAAO,WAAW;EACvB,MAAM,SAAS,WAAW;EAC1B,MAAM,EAAE,QAAQ,WAAW,aAAa;GAAE;GAAQ;EAAO,CAAC;EAC1D,MAAM,SAAS,OAAO,OAAO;EAC7B,MAAM,OAAO,OAAO;EACpB,MAAM,QAAQ,MAAsB,MAAM,WAAW,EAAE,EAAE,QAAQ;EACjE,OAAO;GACL;GAKA,QACE,oBACS,OAAO,MAAM,SAAU,OAAO,MAAM,QAAQ,SAAU,aAAa,cAC/D,KAAK,WAAW,EAAE,gBAChB,KAAK,aAAa,EAAE,YACxB,KAAK,SAAS,EAAE,UAClB,OAAO;EACpB;CACF;AACF,CAAC,CAAC,CAAC,OAAO,QAAiB;CACzB,QAAQ,MAAM,IAAI,WAAW,WAAW,GAAG;CAC3C,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { runStdioServer } from \"@mgcrea/mcp-apple-core\";\n\nimport { BUILD_INFO } from \"./build-info.js\";\nimport { MAPS_SURFACE } from \"./client/errors.js\";\nimport { loadConfig } from \"./config.js\";\nimport { createServer } from \"./server.js\";\n\nconst LOG_PREFIX = \"apple-maps-mcp\";\n\nrunStdioServer({\n  build: BUILD_INFO,\n  surface: MAPS_SURFACE,\n  logPrefix: LOG_PREFIX,\n  start: async (logger) => {\n    const config = loadConfig();\n    const { server, client } = createServer({ config, logger });\n    const status = client.status();\n    const caps = status.capabilities as { entities?: Record<string, { rows?: number }> } | null;\n    const rows = (k: string): number => caps?.entities?.[k]?.rows ?? 0;\n    return {\n      server,\n      // The counts are named because \"store=open\" alone cannot distinguish a\n      // working server from one pointed at an empty replica — which is exactly\n      // what the device-local cache is.\n      banner:\n        `writes=${config.allowWrites ? \"ENABLED\" : \"disabled\"}, ` +\n        `store=${status.store.opened ? (status.store.mode ?? \"open\") : \"UNREADABLE\"}, ` +\n        `favorites=${rows(\"favorites\")}, ` +\n        `collections=${rows(\"collections\")}, ` +\n        `recents=${rows(\"history\")}, ` +\n        `index=${config.indexMode}`,\n    };\n  },\n}).catch((err: unknown) => {\n  console.error(`[${LOG_PREFIX}] fatal:`, err);\n  process.exit(1);\n});\n"],"mappings":";;;;AAQA,MAAM,aAAa;AAEnB,eAAe;CACb,OAAO;CACP,SAAS;CACT,WAAW;CACX,OAAO,OAAO,WAAW;EACvB,MAAM,SAAS,WAAW;EAC1B,MAAM,EAAE,QAAQ,WAAW,aAAa;GAAE;GAAQ;EAAO,CAAC;EAC1D,MAAM,SAAS,OAAO,OAAO;EAC7B,MAAM,OAAO,OAAO;EACpB,MAAM,QAAQ,MAAsB,MAAM,WAAW,EAAE,EAAE,QAAQ;EACjE,OAAO;GACL;GAIA,QACE,UAAU,OAAO,cAAc,YAAY,WAAW,UAC7C,OAAO,MAAM,SAAU,OAAO,MAAM,QAAQ,SAAU,aAAa,cAC/D,KAAK,WAAW,EAAE,gBAChB,KAAK,aAAa,EAAE,YACxB,KAAK,SAAS,EAAE,UAClB,OAAO;EACpB;CACF;AACF,CAAC,CAAC,CAAC,OAAO,QAAiB;CACzB,QAAQ,MAAM,IAAI,WAAW,WAAW,GAAG;CAC3C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AppleAutomationError, AppleAutomationError as AppleMapsError, BuildInfo, CORE_DATA_EPOCH_OFFSET, FileFacts, IndexUnavailableError, InterferenceWatch, Logger, ReadOnlyMode, SchemaDriftError, StoreFacts, SurfaceContext } from "@mgcrea/mcp-apple-core";
+import { AppleAutomationError, AppleAutomationError as AppleMapsError, BuildInfo, CORE_DATA_EPOCH_OFFSET, Epoch, FileFacts, IndexUnavailableError, InterferenceWatch, Logger, ReadOnlyMode, SchemaDriftError, StoreFacts, SurfaceContext } from "@mgcrea/mcp-apple-core";
 import { DatabaseSync } from "node:sqlite";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -6,20 +6,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 declare const BUILD_INFO: BuildInfo;
 //#endregion
 //#region src/client/dates.d.ts
-/**
- * How this store's timestamps map onto real time.
- *
- * `confident` is the field that matters. `detectEpoch` always returns an offset
- * — it falls back to unix when nothing fits — so the offset alone cannot
- * distinguish "measured as unix" from "gave up and assumed unix". Rendering the
- * second as though it were the first is the failure this module exists to
- * prevent, so the two are kept apart.
- */
-type Epoch = {
-  offset: number;
-  reason: string;
-  confident: boolean;
-};
 declare const resolveEpoch: (maxTimestamp: number | null, now?: number) => Epoch;
 /** The expectation docs/maps.md carries, used only where no store is open. */
 declare const APPLE_SECONDS: Epoch;
@@ -120,7 +106,6 @@ declare const ConfigSchema: z.ZodObject<{
   allowWrites: z.ZodDefault<z.ZodBoolean>;
   exposePrompts: z.ZodDefault<z.ZodBoolean>;
   lazyTools: z.ZodDefault<z.ZodBoolean>;
-  debug: z.ZodDefault<z.ZodBoolean>;
   osascriptPath: z.ZodDefault<z.ZodString>;
   osascriptTimeoutMs: z.ZodDefault<z.ZodNumber>;
   maxResults: z.ZodDefault<z.ZodNumber>;
@@ -131,6 +116,7 @@ declare const ConfigSchema: z.ZodObject<{
     off: "off";
     ro: "ro";
   }>>;
+  seedTimeoutMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 type Config = z.infer<typeof ConfigSchema>;
 declare const loadConfig: (env?: NodeJS.ProcessEnv) => Config;
@@ -488,7 +474,7 @@ declare const decodeCollectionRef: (raw: string) => EntityKey;
 //#endregion
 //#region src/client/write.d.ts
 /** Injected so tests never launch an application. */
-type OpenUrl = (url: string) => void;
+type OpenUrl = (url: string) => void | Promise<void>;
 type AddFavoriteInput = {
   /** What to search for. A name; a bare coordinate does NOT open a place card. */
   query: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/dates.ts","../src/client/errors.ts","../src/client/locate.ts","../src/config.ts","../src/client/ax.ts","../src/client/store.ts","../src/client/ref.ts","../src/client/write.ts","../src/client/maps.ts","../src/server.ts","../src/tools/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/dates.ts","../src/client/errors.ts","../src/client/locate.ts","../src/config.ts","../src/client/ax.ts","../src/client/store.ts","../src/client/ref.ts","../src/client/write.ts","../src/client/maps.ts","../src/server.ts","../src/tools/index.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { A as fromStoreTime, C as MAPS_SURFACE, D as UndatableStoreError, E as SchemaDriftError, M as resolveEpoch, N as BUILD_INFO, O as APPLE_SECONDS, S as MAPS_BUNDLE_ID, T as PlaceNotFoundError, _ as defaultDirectory, a as loadConfig, b as AppleMapsError, c as introspect, d as InvalidMapsRefError, f as PLACE_REF_VERSION, g as encodePlaceRef, h as encodeCollectionRef, i as registerTools, j as renderInstant, k as CORE_DATA_EPOCH_OFFSET, l as openStore, m as decodePlaceRef, n as SERVER_VERSION, o as AppleMapsClient, p as decodeCollectionRef, r as createServer, s as MapsStore, t as SERVER_NAME, u as COLLECTION_REF_VERSION, v as defaultStorePath, w as MapsStoreUnavailableError, x as IndexUnavailableError, y as locateStore } from "./server-Cos6wXAu.js";
+import { A as fromStoreTime, C as MAPS_SURFACE, D as UndatableStoreError, E as SchemaDriftError, M as resolveEpoch, N as BUILD_INFO, O as APPLE_SECONDS, S as MAPS_BUNDLE_ID, T as PlaceNotFoundError, _ as defaultDirectory, a as loadConfig, b as AppleMapsError, c as introspect, d as InvalidMapsRefError, f as PLACE_REF_VERSION, g as encodePlaceRef, h as encodeCollectionRef, i as registerTools, j as renderInstant, k as CORE_DATA_EPOCH_OFFSET, l as openStore, m as decodePlaceRef, n as SERVER_VERSION, o as AppleMapsClient, p as decodeCollectionRef, r as createServer, s as MapsStore, t as SERVER_NAME, u as COLLECTION_REF_VERSION, v as defaultStorePath, w as MapsStoreUnavailableError, x as IndexUnavailableError, y as locateStore } from "./server-CO_d1_6b.js";
 export { APPLE_SECONDS, AppleMapsClient, AppleMapsError, BUILD_INFO, COLLECTION_REF_VERSION, CORE_DATA_EPOCH_OFFSET, IndexUnavailableError, InvalidMapsRefError, MAPS_BUNDLE_ID, MAPS_SURFACE, MapsStore, MapsStoreUnavailableError, PLACE_REF_VERSION, PlaceNotFoundError, SERVER_NAME, SERVER_VERSION, SchemaDriftError, UndatableStoreError, createServer, decodeCollectionRef, decodePlaceRef, defaultDirectory, defaultStorePath, encodeCollectionRef, encodePlaceRef, fromStoreTime, introspect, loadConfig, locateStore, openStore, registerTools, renderInstant, resolveEpoch };

package/dist/{server-Cos6wXAu.js → server-CO_d1_6b.js}

@@ -1,10 +1,11 @@
-import { AppleAutomationError, AppleAutomationError as AppleMapsError, BaseConfigSchema, CORE_DATA_EPOCH_OFFSET, IndexUnavailableError, SchemaDriftError, SchemaDriftError as SchemaDriftError$1, columnsOf, compact, describeStore, detectEpoch, escapeLike, fail, fingerprintSchema, inspectFile, interferenceNote, limitArg, ok, openAxChannel, openReadOnly, parseBool, parseConfig, parseIntOpt, promptArg, readPackageIdentity, registerSurfaceResources, registerWorkflowPrompt, resolveLimit, trimmed, watchInterference, withLazyTools, wrap, wrapResult } from "@mgcrea/mcp-apple-core";
+import { AppleAutomationError, AppleAutomationError as AppleMapsError, BaseConfigSchema, CORE_DATA_EPOCH_OFFSET, IndexUnavailableError, SchemaDriftError, SchemaDriftError as SchemaDriftError$1, buildBaseDiagnostics, columnsOf, compact, confirmArg, describeStore, detectEpoch, escapeLike, fail, fingerprintSchema, inspectFile, interferenceNote, limitArg, ok, openAxChannel, openReadOnly, parseBool, parseConfig, parseIntOpt, promptArg, readPackageIdentity, registerSurfaceResources, registerWorkflowPrompt, resolveLimit, trimmed, watchInterference, withLazyTools, wrap, wrapResult } from "@mgcrea/mcp-apple-core";
 import { readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { execFileSync } from "node:child_process";
+import { execFile, execFileSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { DatabaseSync } from "node:sqlite";
+import { promisify } from "node:util";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region src/build-info.ts
@@ -15,8 +16,8 @@ const pkg = readPackageIdentity(new URL("../package.json", import.meta.url), {
 const BUILD_INFO = {
 	name: pkg.name,
 	version: pkg.version,
-	gitCommit: "26f4045",
-	gitCommitDate: "2026-09-29T16:31:42+02:00"
+	gitCommit: "782cb1c",
+	gitCommitDate: "2026-10-03T15:37:05+02:00"
 };
 //#endregion
 //#region src/client/dates.ts
@@ -46,16 +47,7 @@ const BUILD_INFO = {
 * arrived at after a probe misread its own column — adopted here rather than
 * re-derived.
 */
-/** What `detectEpoch` says when it has matched nothing. Same shape as Safari's. */
-const GAVE_UP = /^(no dated rows|neither epoch)/;
-const resolveEpoch = (maxTimestamp, now = Date.now()) => {
-	const { offset, reason } = detectEpoch(maxTimestamp, now);
-	return {
-		offset,
-		reason,
-		confident: !GAVE_UP.test(reason)
-	};
-};
+const resolveEpoch = (maxTimestamp, now = Date.now()) => detectEpoch(maxTimestamp, now);
 /** The expectation docs/maps.md carries, used only where no store is open. */
 const APPLE_SECONDS = {
 	offset: CORE_DATA_EPOCH_OFFSET,
@@ -1359,11 +1351,8 @@ const progress = (message) => {
 var MapsWriteError = class extends AppleAutomationError {
 	name = "MapsWriteError";
 };
-const defaultOpenUrl = (url) => {
-	execFileSync("/usr/bin/open", ["-g", url], {
-		timeout: 1e4,
-		stdio: "ignore"
-	});
+const defaultOpenUrl = async (url) => {
+	await promisify(execFile)("/usr/bin/open", ["-g", url], { timeout: 1e4 });
 };
 const uuidBytes = () => Uint8Array.from(Buffer.from(randomUUID().replaceAll("-", ""), "hex"));
 const uuidOf = (bytes) => {
@@ -1565,7 +1554,7 @@ var MapsWriter = class {
 		if (!donor) {
 			const url = `maps://?q=${encodeURIComponent(input.query)}`;
 			progress(`asking Maps to resolve ${JSON.stringify(input.query)}…`);
-			this.#openUrl(url);
+			await this.#openUrl(url);
 			seeded = true;
 			progress(`opened, waiting up to ${Math.round(this.#seedTimeoutMs / 1e3)}s for a record`);
 			const deadline = Date.now() + this.#seedTimeoutMs;
@@ -1740,6 +1729,7 @@ var AppleMapsClient = class {
 		if (!located.readable || !located.storePath) throw new MapsStoreUnavailableError(located.reason ?? "Maps' store could not be opened.");
 		return new MapsWriter({
 			storePath: located.storePath,
+			seedTimeoutMs: this.#config.seedTimeoutMs,
 			...openUrl ? { openUrl } : {}
 		});
 	}
@@ -1916,18 +1906,24 @@ const ConfigSchema = BaseConfigSchema.extend({
 		"ro",
 		"immutable",
 		"off"
-	]).default("auto")
+	]).default("auto"),
+	/**
+	* How long `add_favorite` waits for Maps to resolve a place it does not know.
+	* Tens of seconds is normal — Maps goes to the network — and a slow link
+	* needs more; this is the one timeout in the bundle that was not a setting.
+	*/
+	seedTimeoutMs: z.number().int().min(1e3).max(6e5).default(3e4)
 }).strict();
 const loadConfig = (env = process.env) => parseConfig(ConfigSchema, {
 	allowWrites: parseBool(env.APPLE_MAPS_ALLOW_WRITES),
 	exposePrompts: parseBool(env.APPLE_MAPS_EXPOSE_PROMPTS),
 	lazyTools: parseBool(env.APPLE_MAPS_LAZY_TOOLS),
-	debug: parseBool(env.APPLE_MAPS_DEBUG),
 	storePath: trimmed(env.APPLE_MAPS_STORE),
 	indexMode: trimmed(env.APPLE_MAPS_INDEX_MODE),
 	osascriptPath: trimmed(env.APPLE_MAPS_OSASCRIPT_PATH),
 	osascriptTimeoutMs: parseIntOpt(env.APPLE_MAPS_OSASCRIPT_TIMEOUT_MS),
-	maxResults: parseIntOpt(env.APPLE_MAPS_MAX_RESULTS)
+	maxResults: parseIntOpt(env.APPLE_MAPS_MAX_RESULTS),
+	seedTimeoutMs: parseIntOpt(env.APPLE_MAPS_SEED_TIMEOUT_MS)
 });
 //#endregion
 //#region src/guide.ts
@@ -2060,12 +2056,17 @@ const queryArg = z.string().min(1).describe("Text to look for in a place's name,
 const buildDiagnostics = async (client) => {
 	const status = client.status();
 	const located = status.located;
+	const base = buildBaseDiagnostics({
+		build: BUILD_INFO,
+		config: client.config,
+		allowWrites: client.config.allowWrites
+	});
 	return {
-		server: {
-			name: BUILD_INFO.name,
-			version: BUILD_INFO.version
+		...base,
+		settings: {
+			...base.settings,
+			seedTimeoutMs: client.config.seedTimeoutMs
 		},
-		settings: { exposePrompts: client.config.exposePrompts },
 		lanes: {
 			summary: "Maps has ONE lane. Maps.app ships no scripting dictionary — there is no .sdef in the bundle, checked directly — so there is no Apple Events fallback. Without Full Disk Access this server cannot read anything at all, and it says so rather than returning empty lists.",
 			fileLane: {
@@ -2187,8 +2188,11 @@ const registerAxWriteTools = (server, lane) => {
 		}) : fail(`"${args.query}" was pressed through the save sheet but its card does not report it as saved, so this MUST NOT be reported as done. Check Maps.` + await disturbed());
 	}));
 	server.registerTool("apple_maps_remove_saved_place", {
-		description: "Remove a place from Maps' Places library, through the card's overflow menu. This does NOT touch favourites — use apple_maps_remove_favorite for those. SIDE EFFECTS: opens Maps, brings its window forward, and leaves the place in the user's Recents. Syncs to the user's other Apple devices. Needs Accessibility for Cupertino.",
-		inputSchema: place,
+		description: "Remove a place from Maps' Places library, through the card's overflow menu. This does NOT touch favourites — use apple_maps_remove_favorite for those. SIDE EFFECTS: opens Maps, brings its window forward, and leaves the place in the user's Recents. Syncs to the user's other Apple devices. Needs Accessibility for Cupertino, and an explicit confirm: the removal is not undoable from here.",
+		inputSchema: {
+			...place,
+			confirm: confirmArg
+		},
 		annotations: {
 			readOnlyHint: false,
 			destructiveHint: true,
@@ -2473,8 +2477,11 @@ const registerWriteTools = (server, client) => {
 		}));
 	}));
 	server.registerTool("apple_maps_remove_favorite", {
-		description: "Remove a place from Maps' favourites, by a ref from apple_maps_list_favorites. This deletes the favourite on the user's other Apple devices too, through iCloud. It does not affect Guides, Recents, or anything else that references the same place. Needs Full Disk Access.",
-		inputSchema: { ref: placeRefArg },
+		description: "Remove a place from Maps' favourites, by a ref from apple_maps_list_favorites. This deletes the favourite on the user's other Apple devices too, through iCloud. It does not affect Guides, Recents, or anything else that references the same place. Needs Full Disk Access, and an explicit confirm: the deletion is not undoable from here.",
+		inputSchema: {
+			ref: placeRefArg,
+			confirm: confirmArg
+		},
 		annotations: {
 			readOnlyHint: false,
 			idempotentHint: true,
@@ -2556,4 +2563,4 @@ const createServer = (opts) => {
 //#endregion
 export { fromStoreTime as A, MAPS_SURFACE as C, UndatableStoreError as D, SchemaDriftError$1 as E, resolveEpoch as M, BUILD_INFO as N, APPLE_SECONDS as O, MAPS_BUNDLE_ID as S, PlaceNotFoundError as T, defaultDirectory as _, loadConfig as a, AppleMapsError as b, introspect as c, InvalidMapsRefError as d, PLACE_REF_VERSION as f, encodePlaceRef as g, encodeCollectionRef as h, registerTools as i, renderInstant as j, CORE_DATA_EPOCH_OFFSET as k, openStore as l, decodePlaceRef as m, SERVER_VERSION as n, AppleMapsClient as o, decodeCollectionRef as p, createServer as r, MapsStore as s, SERVER_NAME as t, COLLECTION_REF_VERSION as u, defaultStorePath as v, MapsStoreUnavailableError as w, IndexUnavailableError as x, locateStore as y };
 
-//# sourceMappingURL=server-Cos6wXAu.js.map
+//# sourceMappingURL=server-CO_d1_6b.js.map