project-cpu-mcp 0.7.1

package/dist/tools/map/attention/constants.js

@@ -0,0 +1,21 @@
+export const GET_ATTENTION_DESCRIPTION = [
+    'Owner-scoped roll-up of cells worth attention, most time-sensitive first — so you skip scanning the whole',
+    'map. Flags, each with a severity: stalled mining/craft (the output box has room for less than one whole',
+    'cycle, so nothing settles and the wait burns); a reveal request of yours still open long after the client',
+    'should have settled it in the background, and a cell locked by a reveal request opened at a randomness',
+    'source the chain config has since replaced — that one no call of yours can clear, only an admin cleanup of',
+    'the contracts (critical); a near-full warehouse on an actively-produced',
+    'resource, a job that has run its scheduled cycles and now idles the cell until claimed, an arrived delivery',
+    'ready to finalize, an extractor on a depleted deposit, or one of your open lots frozen because the hub',
+    'raised its live sale fee above your tolerance (buys revert; cancel stays fee-free) (warning);',
+    'revealed-but-unbuilt cells, cells in a post-demolish rebuild cooldown, and an open lot whose live sale fee',
+    'now sits exactly at your tolerance so the next hike freezes it (info — on a `demolish_cooldown` item',
+    '`arrivalAt` marks when rebuild reopens). A finished job loses nothing by waiting, unlike a stall — it only',
+    'holds the cell idle. Items are purely descriptive (cell, resource, used/cap breakdown, deposit, delivery,',
+    'and for a lot its `lotId`, hub cell and a `message`, for a reveal request its `requestId` and `requestedAt`)',
+    'and suggest no action — you decide. Lot and reveal-request flags cover your own wallet only. Your own cells',
+    'need an authenticated wallet; pass `owner` to scout another player read-only (all data is public).',
+    '`minSeverity` filters by urgency. If the deliveries, lots or open-reveal-request lookup is down, the',
+    'remaining items still return and a `note` says so.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/map/attention/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/map/attention/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,2GAA2G;IAC3G,yGAAyG;IACzG,2GAA2G;IAC3G,wGAAwG;IACxG,4GAA4G;IAC5G,yEAAyE;IACzE,6GAA6G;IAC7G,wGAAwG;IACxG,+FAA+F;IAC/F,4GAA4G;IAC5G,sGAAsG;IACtG,4GAA4G;IAC5G,2GAA2G;IAC3G,8GAA8G;IAC9G,6GAA6G;IAC7G,oGAAoG;IACpG,sGAAsG;IACtG,oDAAoD;CACvD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/map/attention/types.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { AttentionSeverity } from '../../../map/types.js';
+export declare const getAttentionInputSchema: {
+    minSeverity: z.ZodDefault<z.ZodNullable<z.ZodNativeEnum<typeof AttentionSeverity>>>;
+    owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/map/attention/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/attention/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;CAcnC,CAAC"}

package/dist/tools/map/attention/types.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { AttentionSeverity } from '../../../map/types.js';
+export const getAttentionInputSchema = {
+    minSeverity: z
+        .nativeEnum(AttentionSeverity)
+        .nullable()
+        .default(null)
+        .describe('Only return items at or above this urgency (critical > warning > info). Default: all.'),
+    owner: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe('Scout another player: their wallet address to inspect their cells (read-only intel — the map is ' +
+        'public). Omit to get your own to-do list. Deliveries are only surfaced for yourself.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/map/attention/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/map/attention/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,WAAW,EAAE,CAAC;SACT,UAAU,CAAC,iBAAiB,CAAC;SAC7B,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,uFAAuF,CAAC;IACtG,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,kGAAkG;QAC9F,sFAAsF,CAC7F;CACR,CAAC"}

package/dist/tools/map/get-cell/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const GET_CELL_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/map/get-cell/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,QAOtB,CAAC"}

package/dist/tools/map/get-cell/constants.js

@@ -0,0 +1,9 @@
+export const GET_CELL_DESCRIPTION = [
+    'Inspect one cell in depth (any owner — the map is public). Returns the cell, its neighbours expanded as full',
+    'cell states (the immediate surroundings of a target), and `distanceFromMine` — the grid distance (BFS steps)',
+    'to your nearest cell (null if your wallet is unknown or it is farther than 50 steps). Each resource carries a',
+    '`storage` box (used/cap/reserved/full) and the active process a `stalled` flag — true once the room holds',
+    'less than one whole cycle of its output, which halts production before the box reads `full`, until you',
+    'offload. For broader situational awareness use `cpu_get_map`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/map/get-cell/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,8GAA8G;IAC9G,8GAA8G;IAC9G,+GAA+G;IAC/G,2GAA2G;IAC3G,wGAAwG;IACxG,+DAA+D;CAClE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/map/get-cell/get-cell.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import type { ToolRegistrar } from '../../types.js';
+export declare function registerGetCellTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=get-cell.d.ts.map

package/dist/tools/map/get-cell/get-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cell.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/get-cell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAiCpF"}

package/dist/tools/map/get-cell/get-cell.js

@@ -0,0 +1,33 @@
+import { GET_CELL_DESCRIPTION } from './constants.js';
+import { getCellInputSchema } from './types.js';
+import { demolishCooldownEnd } from '../../../map/map.utils.js';
+import { formatUnixSeconds } from '../../../utils/format.utils.js';
+import { labelCell, priceOutputs } from '../label.utils.js';
+import { getWalletAddress } from '../wallet.utils.js';
+export function registerGetCellTool(server, context) {
+    server.registerTool('cpu_get_cell', { description: GET_CELL_DESCRIPTION, inputSchema: getCellInputSchema }, async (args) => {
+        const inspection = await context.mapReader.inspectCell(args.tokenId, getWalletAddress(context));
+        if (inspection === null) {
+            throw new Error(`Cell ${args.tokenId} is not in the current map.`);
+        }
+        const { cell, neighbors } = inspection;
+        const { resources, buildings } = await context.appConfig.load();
+        const cooldownEnd = demolishCooldownEnd(cell, context.mapReader.getServerTime());
+        const cooldownNote = cooldownEnd !== null
+            ? ` · demolition cooldown until ${formatUnixSeconds(cooldownEnd)} (no rebuild yet)`
+            : '';
+        const header = `Cell ${cell.tokenId} · ${neighbors.length} neighbours${cooldownNote}`;
+        const labeled = {
+            ...inspection,
+            cell: { ...labelCell(cell, resources), outputs: priceOutputs(cell, buildings, resources) },
+            neighbors: neighbors.map((neighbor) => labelCell(neighbor, resources)),
+        };
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(labeled) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-cell.js.map

package/dist/tools/map/get-cell/get-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cell.js","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/get-cell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,UAAU,mBAAmB,CAAC,MAAqB,EAAE,OAAmB;IAC1E,MAAM,CAAC,YAAY,CACf,cAAc,EACd,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,kBAAkB,EAAE,EACtE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAChG,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,6BAA6B,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QACvC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;QACjF,MAAM,YAAY,GACd,WAAW,KAAK,IAAI;YAChB,CAAC,CAAC,gCAAgC,iBAAiB,CAAC,WAAW,CAAC,mBAAmB;YACnF,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,OAAO,MAAM,SAAS,CAAC,MAAM,cAAc,YAAY,EAAE,CAAC;QAEtF,MAAM,OAAO,GAAG;YACZ,GAAG,UAAU;YACb,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YAC1F,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;SACzE,CAAC;QAEF,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;aAClD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/map/get-cell/types.d.ts

@@ -0,0 +1,4 @@
+export declare const getCellInputSchema: {
+    tokenId: import("zod").ZodEffects<import("zod").ZodNumber, string, number>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/map/get-cell/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/types.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;;CAE9B,CAAC"}

package/dist/tools/map/get-cell/types.js

@@ -0,0 +1,5 @@
+import { tokenIdSchema } from '../../../geometry/types.js';
+export const getCellInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The cell tokenId to inspect.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/map/get-cell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/map/get-cell/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACpF,CAAC"}

package/dist/tools/map/get-changes/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const GET_CHANGES_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/map/get-changes/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAOzB,CAAC"}

package/dist/tools/map/get-changes/constants.js

@@ -0,0 +1,9 @@
+export const GET_CHANGES_DESCRIPTION = [
+    'Get only the cells that changed since a given version — react to other players without re-reading the whole',
+    'map. Pass the `version` from a previous map response; the reply carries a new `version` for next time. Omit',
+    'sinceVersion (or 0) to get everything. Also carries `server: { reachable }`: false means the API is',
+    'unreachable, so any action (build/reveal/transport/trade) will fail — keep polling `cpu_get_changes` rather',
+    'than retrying actions; the client reconnects in the background, and once reachable flips true you can act',
+    'again (after an outage, call once with sinceVersion 0 for the full picture).',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/map/get-changes/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,6GAA6G;IAC7G,6GAA6G;IAC7G,qGAAqG;IACrG,6GAA6G;IAC7G,2GAA2G;IAC3G,8EAA8E;CACjF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/map/get-changes/get-changes.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import type { ToolRegistrar } from '../../types.js';
+export declare function registerGetChangesTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=get-changes.d.ts.map

package/dist/tools/map/get-changes/get-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-changes.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/get-changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CA2BvF"}

package/dist/tools/map/get-changes/get-changes.js

@@ -0,0 +1,26 @@
+import { labelCell } from '../label.utils.js';
+import { getWalletAddress } from '../wallet.utils.js';
+import { GET_CHANGES_DESCRIPTION } from './constants.js';
+import { getChangesInputSchema } from './types.js';
+export function registerGetChangesTool(server, context) {
+    server.registerTool('cpu_get_changes', { description: GET_CHANGES_DESCRIPTION, inputSchema: getChangesInputSchema }, async (args) => {
+        const health = context.api.getServerHealth();
+        const since = args.sinceVersion ?? 0;
+        const changes = await context.mapReader.getChanges(since, getWalletAddress(context));
+        const { resources } = await context.appConfig.load();
+        const serverTag = health.reachable ? 'server=up' : 'server=DOWN';
+        const header = `Changes since v${since}: ${changes.changedCount} cells · now v${changes.version} · ${serverTag}`;
+        const labeled = {
+            ...changes,
+            changed: changes.changed.map((cell) => labelCell(cell, resources)),
+            server: { reachable: health.reachable, reason: health.reason },
+        };
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(labeled) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-changes.js.map

package/dist/tools/map/get-changes/get-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-changes.js","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/get-changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,OAAmB;IAC7E,MAAM,CAAC,YAAY,CACf,iBAAiB,EACjB,EAAE,WAAW,EAAE,uBAAuB,EAAE,WAAW,EAAE,qBAAqB,EAAE,EAC5E,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QACrF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;QACjE,MAAM,MAAM,GAAG,kBAAkB,KAAK,KAAK,OAAO,CAAC,YAAY,iBAAiB,OAAO,CAAC,OAAO,MAAM,SAAS,EAAE,CAAC;QAEjH,MAAM,OAAO,GAAG;YACZ,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAClE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACjE,CAAC;QAEF,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;aAClD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/map/get-changes/types.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const getChangesInputSchema: {
+    sinceVersion: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/map/get-changes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;CAQjC,CAAC"}

package/dist/tools/map/get-changes/types.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export const getChangesInputSchema = {
+    sinceVersion: z
+        .number()
+        .int()
+        .min(0)
+        .nullable()
+        .default(null)
+        .describe('The "version" (epoch ms) from a previous map response. Omit or 0 to return every cell.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/map/get-changes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/map/get-changes/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,wFAAwF,CAAC;CAC1G,CAAC"}

package/dist/tools/map/get-map/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const GET_MAP_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/map/get-map/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-map/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QASrB,CAAC"}

package/dist/tools/map/get-map/constants.js

@@ -0,0 +1,11 @@
+export const GET_MAP_DESCRIPTION = [
+    'Read the live game world (public, background-synced). The world is a finite sphere of 48,990 cells keyed by',
+    'tokenId — no coordinates: navigate via each cell’s `neighbors` (6 adjacent, 5 next to a pentagon vertex;',
+    'owned/other/empty, empty = unminted) and `cpu_next_hops`; `pos {face,i,j}` is only a rough hint (wraps at',
+    'face seams). Returns a `summary`, a `resourceIndex` of your cells, and per-resource `storage`',
+    '(used/cap/full; a box with room for less than one whole cycle halts that resource’s production, cap null',
+    '= uncapped). Scopes: mine | around',
+    '(grid radius from aroundTokenId) | cells | all | summary. version/updated are epoch ms, serverTime/startAt',
+    'unix seconds. `server.reachable` false means actions will fail; your to-do list is `cpu_get_attention`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/map/get-map/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/map/get-map/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,6GAA6G;IAC7G,0GAA0G;IAC1G,2GAA2G;IAC3G,+FAA+F;IAC/F,0GAA0G;IAC1G,oCAAoC;IACpC,4GAA4G;IAC5G,yGAAyG;CAC5G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/map/get-map/get-map.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import type { ToolRegistrar } from '../../types.js';
+export declare function registerGetMapTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=get-map.d.ts.map

package/dist/tools/map/get-map/get-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-map.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-map/get-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAoCnF"}

package/dist/tools/map/get-map/get-map.js

@@ -0,0 +1,34 @@
+import { labelCell } from '../label.utils.js';
+import { getWalletAddress } from '../wallet.utils.js';
+import { GET_MAP_DESCRIPTION } from './constants.js';
+import { buildMapQuery, resolveScope } from './get-map.utils.js';
+import { getMapInputSchema } from './types.js';
+export function registerGetMapTool(server, context) {
+    server.registerTool('cpu_get_map', { description: GET_MAP_DESCRIPTION, inputSchema: getMapInputSchema }, async (args) => {
+        const ownerAddress = getWalletAddress(context);
+        const scope = resolveScope(args.scope, ownerAddress);
+        const result = await context.mapReader.query(buildMapQuery(scope, args, ownerAddress));
+        const { resources } = await context.appConfig.load();
+        const health = context.api.getServerHealth();
+        const serverTag = health.reachable ? 'server=up' : 'server=DOWN';
+        const stalledTag = result.summary.stalledCells !== null && result.summary.stalledCells > 0
+            ? ` · stalled ${result.summary.stalledCells}`
+            : '';
+        const header = `Map v${result.summary.version} · ${result.summary.totalCells} cells · ` +
+            `scope=${result.scope} · returned ${result.returnedCells} · ${serverTag}${stalledTag}`;
+        // Resolve resource ids to names: inline on each cell, plus a legend for the resourceIndex keys.
+        const labeled = {
+            ...result,
+            cells: result.cells.map((cell) => labelCell(cell, resources)),
+            resourceNames: resources,
+            server: { reachable: health.reachable, reason: health.reason },
+        };
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(labeled) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-map.js.map

package/dist/tools/map/get-map/get-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-map.js","sourceRoot":"","sources":["../../../../src/tools/map/get-map/get-map.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,OAAmB;IACzE,MAAM,CAAC,YAAY,CACf,aAAa,EACb,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,iBAAiB,EAAE,EACpE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACvF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;QACjE,MAAM,UAAU,GACZ,MAAM,CAAC,OAAO,CAAC,YAAY,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC;YACnE,CAAC,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,MAAM,GACR,QAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,WAAW;YACxE,SAAS,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,aAAa,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAE3F,gGAAgG;QAChG,MAAM,OAAO,GAAG;YACZ,GAAG,MAAM;YACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7D,aAAa,EAAE,SAAS;YACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACjE,CAAC;QAEF,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;aAClD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/map/get-map/get-map.utils.d.ts

@@ -0,0 +1,5 @@
+import type { GetMapArgs } from './types.js';
+import { type MapQuery, MapScope } from '../../../map/types.js';
+export declare function resolveScope(requested: MapScope | null, ownerAddress: string | null): MapScope;
+export declare function buildMapQuery(scope: MapScope, args: GetMapArgs, ownerAddress: string | null): MapQuery;
+//# sourceMappingURL=get-map.utils.d.ts.map

package/dist/tools/map/get-map/get-map.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-map.utils.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-map/get-map.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAoB,KAAK,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAElF,wBAAgB,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAK9F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAkBtG"}

package/dist/tools/map/get-map/get-map.utils.js

@@ -0,0 +1,25 @@
+import { DEFAULT_AROUND_RADIUS } from '../../../map/constants.js';
+import { MapScope } from '../../../map/types.js';
+export function resolveScope(requested, ownerAddress) {
+    if (requested !== null) {
+        return requested;
+    }
+    return ownerAddress !== null ? MapScope.Mine : MapScope.Summary;
+}
+export function buildMapQuery(scope, args, ownerAddress) {
+    if (scope === MapScope.Mine && ownerAddress === null) {
+        throw new Error('scope="mine" needs a ready wallet — run the authenticate tool first.');
+    }
+    let around = null;
+    if (scope === MapScope.Around) {
+        if (args.aroundTokenId === null) {
+            throw new Error('scope="around" requires aroundTokenId.');
+        }
+        around = { tokenId: String(args.aroundTokenId), radius: args.radius ?? DEFAULT_AROUND_RADIUS };
+    }
+    if (scope === MapScope.Cells && (args.tokenIds === null || args.tokenIds.length === 0)) {
+        throw new Error('scope="cells" requires a non-empty tokenIds array.');
+    }
+    return { scope, tokenIds: args.tokenIds, around, ownerAddress };
+}
+//# sourceMappingURL=get-map.utils.js.map

package/dist/tools/map/get-map/get-map.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-map.utils.js","sourceRoot":"","sources":["../../../../src/tools/map/get-map/get-map.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAmC,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,UAAU,YAAY,CAAC,SAA0B,EAAE,YAA2B;IAChF,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,IAAgB,EAAE,YAA2B;IACxF,IAAI,KAAK,KAAK,QAAQ,CAAC,IAAI,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,MAAM,GAAuB,IAAI,CAAC;IACtC,IAAI,KAAK,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACnG,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC"}

package/dist/tools/map/get-map/types.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { MapScope } from '../../../map/types.js';
+export declare const getMapInputSchema: {
+    scope: z.ZodDefault<z.ZodNullable<z.ZodNativeEnum<typeof MapScope>>>;
+    tokenIds: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    aroundTokenId: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    radius: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+};
+export interface GetMapArgs {
+    scope: MapScope | null;
+    tokenIds: Array<string> | null;
+    aroundTokenId: number | null;
+    radius: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/map/get-map/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/map/get-map/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,eAAO,MAAM,iBAAiB;;;;;CAsB7B,CAAC;AAEF,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/tools/map/get-map/types.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { tokenIdSchema } from '../../../geometry/types.js';
+import { DEFAULT_AROUND_RADIUS, MAX_AROUND_RADIUS } from '../../../map/constants.js';
+import { MapScope } from '../../../map/types.js';
+export const getMapInputSchema = {
+    scope: z
+        .nativeEnum(MapScope)
+        .nullable()
+        .default(null)
+        .describe('mine | around | cells | all | summary. Omit to default to "mine" (or "summary" if no wallet).'),
+    tokenIds: z
+        .array(z.string())
+        .nullable()
+        .default(null)
+        .describe('Required for scope="cells": the cell tokenIds to return.'),
+    aroundTokenId: tokenIdSchema.nullable().default(null).describe('Center cell tokenId for scope="around".'),
+    radius: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_AROUND_RADIUS)
+        .nullable()
+        .default(null)
+        .describe(`Grid radius (BFS steps) for scope="around" (default ${DEFAULT_AROUND_RADIUS}, max ${MAX_AROUND_RADIUS}).`),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/map/get-map/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/map/get-map/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,KAAK,EAAE,CAAC;SACH,UAAU,CAAC,QAAQ,CAAC;SACpB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,+FAA+F,CAAC;IAC9G,QAAQ,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0DAA0D,CAAC;IACzE,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACzG,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,iBAAiB,CAAC;SACtB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,uDAAuD,qBAAqB,SAAS,iBAAiB,IAAI,CAC7G;CACR,CAAC"}

package/dist/tools/map/label.utils.d.ts

@@ -0,0 +1,23 @@
+import { CellProcessKind, type CellResource, type Cell } from '../../map/types.js';
+import type { CatalogBuildingView, CellOutputView } from '../../services/types.js';
+import { type ResourceNames } from '../../utils/format.utils.js';
+type LabeledResource = CellResource & {
+    resourceName: string;
+};
+export declare function labelCell<T extends Cell>(cell: T, resources: ResourceNames): T & {
+    resources: LabeledResource[];
+    process: import("../../map/types.js").CellProcessCraftView | {
+        resourceName: string;
+        kind: CellProcessKind.Mining;
+        resource: number;
+        durationSec: number;
+        yieldPerCycle: number;
+        batches: number;
+        claimedBatches: number;
+        startAt: number;
+        stalled: boolean;
+    } | null;
+};
+export declare function priceOutputs<T extends Cell>(cell: T, buildings: Array<CatalogBuildingView>, resources: ResourceNames): Array<CellOutputView> | null;
+export {};
+//# sourceMappingURL=label.utils.d.ts.map

package/dist/tools/map/label.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/map/label.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAwB,KAAK,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE/E,KAAK,eAAe,GAAG,YAAY,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAgB/D,wBAAgB,SAAS,CAAC,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa;;;;;;;;;;;;;EAM1E;AAGD,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,EACvC,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,EACrC,SAAS,EAAE,aAAa,GACzB,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAS9B"}

package/dist/tools/map/label.utils.js

@@ -0,0 +1,34 @@
+import { buildingMode, outputsFor } from '../../map/mode.utils.js';
+import { CellProcessKind } from '../../map/types.js';
+import { resourceName } from '../../utils/format.utils.js';
+function labelResource(resources, resource) {
+    return { ...resource, resourceName: resourceName(resources, resource.resourceId) };
+}
+function labelProcess(resources, process) {
+    if (process === null) {
+        return null;
+    }
+    if (process.kind === CellProcessKind.Mining) {
+        return { ...process, resourceName: resourceName(resources, process.resource) };
+    }
+    return process;
+}
+export function labelCell(cell, resources) {
+    return {
+        ...cell,
+        resources: cell.resources.map((resource) => labelResource(resources, resource)),
+        process: labelProcess(resources, cell.process),
+    };
+}
+// Map-derived and advisory: the paid start paths re-price against the chain before they send.
+export function priceOutputs(cell, buildings, resources) {
+    if (cell.building === null) {
+        return null;
+    }
+    const view = buildings.find((b) => b.type === cell.building?.type) ?? null;
+    if (view === null) {
+        return null;
+    }
+    return outputsFor(view, buildingMode(cell.building), resources);
+}
+//# sourceMappingURL=label.utils.js.map

package/dist/tools/map/label.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.utils.js","sourceRoot":"","sources":["../../../src/tools/map/label.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAsD,MAAM,oBAAoB,CAAC;AAEzG,OAAO,EAAE,YAAY,EAAsB,MAAM,6BAA6B,CAAC;AAI/E,SAAS,aAAa,CAAC,SAAwB,EAAE,QAAsB;IACnE,OAAO,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,YAAY,CAAC,SAAwB,EAAE,OAA+B;IAC3E,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS,CAAiB,IAAO,EAAE,SAAwB;IACvE,OAAO;QACH,GAAG,IAAI;QACP,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;KACjD,CAAC;AACN,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CACxB,IAAO,EACP,SAAqC,EACrC,SAAwB;IAExB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;IAC3E,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC"}

package/dist/tools/map/wallet.utils.d.ts

@@ -0,0 +1,3 @@
+import type { AppContext } from '../../types.js';
+export declare function getWalletAddress(context: AppContext): string | null;
+//# sourceMappingURL=wallet.utils.d.ts.map

package/dist/tools/map/wallet.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/map/wallet.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAUnE"}

package/dist/tools/map/wallet.utils.js

@@ -0,0 +1,16 @@
+import { errorMessage } from '../../utils/error.utils.js';
+// Returns null instead of throwing when the wallet isn't usable yet, so map reads still work
+// pre-authentication (the map is public) — only the owner-scoped figures are then unavailable.
+export function getWalletAddress(context) {
+    if (!context.wallet.isReady()) {
+        return null;
+    }
+    try {
+        return context.wallet.get().getAddress();
+    }
+    catch (error) {
+        context.logger.warn('failed to read wallet address', { error: errorMessage(error) });
+        return null;
+    }
+}
+//# sourceMappingURL=wallet.utils.js.map

package/dist/tools/map/wallet.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.utils.js","sourceRoot":"","sources":["../../../src/tools/map/wallet.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,6FAA6F;AAC7F,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/tools/mining/claim/claim-mining.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import type { ToolRegistrar } from '../../types.js';
+export declare function registerClaimMiningTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=claim-mining.d.ts.map

package/dist/tools/mining/claim/claim-mining.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-mining.d.ts","sourceRoot":"","sources":["../../../../src/tools/mining/claim/claim-mining.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAgBxF"}

package/dist/tools/mining/claim/claim-mining.js

@@ -0,0 +1,16 @@
+import { summarizeMiningClaim } from '../format.utils.js';
+import { claimMiningInputSchema } from '../types.js';
+import { CLAIM_MINING_DESCRIPTION } from './constants.js';
+export function registerClaimMiningTool(server, context) {
+    server.registerTool('cpu_claim_mining', { description: CLAIM_MINING_DESCRIPTION, inputSchema: claimMiningInputSchema }, async (args) => {
+        const result = await context.mining.claim(args.tokenId);
+        const { resources } = await context.appConfig.load();
+        return {
+            content: [
+                { type: 'text', text: summarizeMiningClaim(result, resources) },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=claim-mining.js.map

package/dist/tools/mining/claim/claim-mining.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-mining.js","sourceRoot":"","sources":["../../../../src/tools/mining/claim/claim-mining.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,UAAU,uBAAuB,CAAC,MAAqB,EAAE,OAAmB;IAC9E,MAAM,CAAC,YAAY,CACf,kBAAkB,EAClB,EAAE,WAAW,EAAE,wBAAwB,EAAE,WAAW,EAAE,sBAAsB,EAAE,EAC9E,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;gBAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/mining/claim/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const CLAIM_MINING_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/mining/claim/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/mining/claim/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAQ1B,CAAC"}

package/dist/tools/mining/claim/constants.js

@@ -0,0 +1,10 @@
+export const CLAIM_MINING_DESCRIPTION = [
+    'Bank every matured mining cycle an extractor has produced on a cell you own into its resource balance.',
+    'Requires a session — call `cpu_authenticate` first. With an active job, claiming when nothing new',
+    'has matured is a harmless no-op; claiming on a cell that has no extractor is an error. A cycle in progress',
+    'matures nothing until it completes, and only whole cycles settle — if a full cycle of output does not fit,',
+    'nothing banks and the wait resets. Claiming does not stop a running job. Claiming one that has run its',
+    'schedule (or drained its deposit) retires it and frees the process slot, so the cell can take another job',
+    'or a craft. Check what is available first with `cpu_get_mining_status`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/mining/claim/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/mining/claim/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,wGAAwG;IACxG,mGAAmG;IACnG,4GAA4G;IAC5G,4GAA4G;IAC5G,wGAAwG;IACxG,2GAA2G;IAC3G,yEAAyE;CAC5E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/mining/format.utils.d.ts

@@ -0,0 +1,6 @@
+import type { MiningClaimResult, MiningStatusResult, StartMiningResult } from '../../services/types.js';
+import { type ResourceNames } from '../../utils/format.utils.js';
+export declare function summarizeMiningStart(r: StartMiningResult, resources: ResourceNames): string;
+export declare function summarizeMiningStatus(s: MiningStatusResult, resources: ResourceNames): string;
+export declare function summarizeMiningClaim(r: MiningClaimResult, resources: ResourceNames): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/tools/mining/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/mining/format.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxG,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAY3F;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CA2B7F;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAY3F"}