project-cpu-mcp 0.7.1

package/dist/tools/mining/format.utils.js

@@ -0,0 +1,45 @@
+import { formatDistanceStrict } from 'date-fns';
+import { resourceLabel } from '../../utils/format.utils.js';
+export function summarizeMiningStart(r, resources) {
+    const job = r.yieldPerCycle !== null && r.durationSec !== null && r.batches !== null
+        ? ` ${r.batches} cycle${r.batches === 1 ? '' : 's'} of ${r.yieldPerCycle} every ` +
+            `${formatDistanceStrict(0, r.durationSec * 1000)}`
+        : '';
+    return (`Started mining ${resourceLabel(resources, r.targetResourceId)}${job} on cell ${r.tokenId}: ` +
+        `tx ${r.txHash} confirmed in block ${r.blockNumber}. The job ends itself once those cycles are done ` +
+        `(or the deposit runs out) — there is no cancel. Track it with cpu_get_mining_status ${r.tokenId} and ` +
+        `bank matured cycles with cpu_claim_mining.`);
+}
+export function summarizeMiningStatus(s, resources) {
+    if (!s.active || s.targetResourceId === null) {
+        return `Cell ${s.tokenId} has no active mining (no extractor, or its last job ended).`;
+    }
+    const cycle = s.yieldPerCycle !== null && s.durationSec !== null
+        ? `${s.yieldPerCycle} per ${formatDistanceStrict(0, s.durationSec * 1000)} cycle. `
+        : '';
+    const schedule = `${s.completedBatches}/${s.batches} cycles done`;
+    const next = s.nextBatchAtSec !== null
+        ? `, next in ${formatDistanceStrict(0, Math.max(0, s.nextBatchAtSec - s.serverTime) * 1000)}`
+        : '';
+    const finished = s.isFinished
+        ? ` Job FINISHED — claim to bank it and free the cell for its next job or a craft.`
+        : '';
+    const depleted = s.depositRemaining === '0' ? ' Deposit depleted.' : '';
+    const stalled = s.stalled && !s.isFinished
+        ? ` STALLED: the warehouse (${s.warehouseUsed}/${s.warehouseCap}) has room for less than one cycle, ` +
+            `so nothing settles and the wait is burnt; offload to resume.`
+        : '';
+    return (`Cell ${s.tokenId} mining ${resourceLabel(resources, s.targetResourceId)}: ${cycle}` +
+        `${s.claimable} claimable now (${s.claimableBatches} cycle${s.claimableBatches === 1 ? '' : 's'}, ` +
+        `${schedule})${next}. ${s.depositRemaining} left in deposit.${finished}${depleted}${stalled}`);
+}
+export function summarizeMiningClaim(r, resources) {
+    const claimed = BigInt(r.claimedAmount);
+    if (claimed > 0n && r.resourceId !== null) {
+        return (`Claimed ${r.claimedAmount} ${resourceLabel(resources, r.resourceId)} from cell ${r.tokenId}: ` +
+            `tx ${r.txHash} confirmed in block ${r.blockNumber}.`);
+    }
+    return (`Nothing newly matured to claim on cell ${r.tokenId} (tx ${r.txHash}); the job runs until its scheduled ` +
+        `cycles are done or the deposit runs out.`);
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/mining/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../../src/tools/mining/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAsB,MAAM,6BAA6B,CAAC;AAEhF,MAAM,UAAU,oBAAoB,CAAC,CAAoB,EAAE,SAAwB;IAC/E,MAAM,GAAG,GACL,CAAC,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;QACpE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,aAAa,SAAS;YAC/E,GAAG,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE;QACpD,CAAC,CAAC,EAAE,CAAC;IACb,OAAO,CACH,kBAAkB,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,OAAO,IAAI;QAC7F,MAAM,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAC,WAAW,mDAAmD;QACrG,uFAAuF,CAAC,CAAC,OAAO,OAAO;QACvG,4CAA4C,CAC/C,CAAC;AACN,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAqB,EAAE,SAAwB;IACjF,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,CAAC,OAAO,8DAA8D,CAAC;IAC3F,CAAC;IACD,MAAM,KAAK,GACP,CAAC,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI;QAC9C,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,QAAQ,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU;QACnF,CAAC,CAAC,EAAE,CAAC;IACb,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,OAAO,cAAc,CAAC;IAClE,MAAM,IAAI,GACN,CAAC,CAAC,cAAc,KAAK,IAAI;QACrB,CAAC,CAAC,aAAa,oBAAoB,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,EAAE;QAC7F,CAAC,CAAC,EAAE,CAAC;IACb,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU;QACzB,CAAC,CAAC,iFAAiF;QACnF,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,QAAQ,GAAG,CAAC,CAAC,gBAAgB,KAAK,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,OAAO,GACT,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU;QACtB,CAAC,CAAC,4BAA4B,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,sCAAsC;YACnG,8DAA8D;QAChE,CAAC,CAAC,EAAE,CAAC;IACb,OAAO,CACH,QAAQ,CAAC,CAAC,OAAO,WAAW,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,KAAK,EAAE;QACpF,GAAG,CAAC,CAAC,SAAS,mBAAmB,CAAC,CAAC,gBAAgB,SAAS,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;QACnG,GAAG,QAAQ,IAAI,IAAI,KAAK,CAAC,CAAC,gBAAgB,oBAAoB,QAAQ,GAAG,QAAQ,GAAG,OAAO,EAAE,CAChG,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAoB,EAAE,SAAwB;IAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,OAAO,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CACH,WAAW,CAAC,CAAC,aAAa,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,OAAO,IAAI;YAC/F,MAAM,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAC,WAAW,GAAG,CACxD,CAAC;IACN,CAAC;IACD,OAAO,CACH,0CAA0C,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,sCAAsC;QACzG,0CAA0C,CAC7C,CAAC;AACN,CAAC"}

package/dist/tools/mining/get-status/constants.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/mining/get-status/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,QAY/B,CAAC"}

package/dist/tools/mining/get-status/constants.js

@@ -0,0 +1,14 @@
+export const GET_MINING_STATUS_DESCRIPTION = [
+    "Read a cell's mining job: whether an extractor is active, which resource it mines, its yield per cycle and",
+    'cycle length, how far through its schedule it is (`completedBatches` of `batches`), the units and whole',
+    'cycles claimable right now, when the next cycle matures and when the job ends, the remaining deposit, and',
+    'whether it is stalled. Mining matures in whole cycles — a cycle in progress banks nothing until it',
+    'completes — and settles in whole cycles too: if one full cycle of output does not fit, nothing settles.',
+    'That is a stall, and it begins before the box reads full. A stall burns time (the schedule survives, the',
+    'wait does not), so offload to resume — transport it out, sell via create_lot, craft with it, or withdraw',
+    'wCPU; a null cap means the warehouse is uncapped. `isFinished` means the job has run its schedule and will',
+    'produce nothing more: claim it to bank the rest and free the cell for another job or a craft. Timestamps',
+    'are unix seconds on the same clock as `serverTime`. Public — works for any cell, no session required. The',
+    'owner banks matured cycles with `cpu_claim_mining`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/mining/get-status/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IACzC,4GAA4G;IAC5G,yGAAyG;IACzG,2GAA2G;IAC3G,oGAAoG;IACpG,yGAAyG;IACzG,0GAA0G;IAC1G,0GAA0G;IAC1G,4GAA4G;IAC5G,0GAA0G;IAC1G,2GAA2G;IAC3G,qDAAqD;CACxD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/mining/get-status/get-mining-status.d.ts

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

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

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

package/dist/tools/mining/get-status/get-mining-status.js

@@ -0,0 +1,16 @@
+import { summarizeMiningStatus } from '../format.utils.js';
+import { miningStatusInputSchema } from '../types.js';
+import { GET_MINING_STATUS_DESCRIPTION } from './constants.js';
+export function registerGetMiningStatusTool(server, context) {
+    server.registerTool('cpu_get_mining_status', { description: GET_MINING_STATUS_DESCRIPTION, inputSchema: miningStatusInputSchema }, async (args) => {
+        const status = await context.mining.getStatus(args.tokenId);
+        const { resources } = await context.appConfig.load();
+        return {
+            content: [
+                { type: 'text', text: summarizeMiningStatus(status, resources) },
+                { type: 'text', text: JSON.stringify(status) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-mining-status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-mining-status.js","sourceRoot":"","sources":["../../../../src/tools/mining/get-status/get-mining-status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,2BAA2B,CAAC,MAAqB,EAAE,OAAmB;IAClF,MAAM,CAAC,YAAY,CACf,uBAAuB,EACvB,EAAE,WAAW,EAAE,6BAA6B,EAAE,WAAW,EAAE,uBAAuB,EAAE,EACpF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,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,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;gBAChE,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/start/constants.d.ts

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

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

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

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

@@ -0,0 +1,18 @@
+export const START_MINING_DESCRIPTION = [
+    'Start a bounded extraction job on a cell you own that holds a finished extractor. Requires a session —',
+    'call `cpu_authenticate` first. Pass the `targetResourceId` to mine — it must be a resource the extractor can',
+    'mine (see `cpu_get_game_config`) with an active deposit on the cell; omit it when the extractor mines a',
+    'single resource. Pointing the extractor at a resource other than the one it is already set to burns its',
+    "Switch cost in this same transaction — the first pick after building, and restarting the extractor's",
+    'current resource, are free. Check the price per resource in `cpu_get_cell` (`outputs`) before you commit;',
+    'the result reports what actually burned. The building must have finished construction — building takes',
+    'time after',
+    '`cpu_build`. `batches` is how many cycles the job runs, and it is a commitment you cannot undo: the job ends',
+    'itself once it has run them, or sooner if the deposit runs dry, and there is no cancel — the target cannot',
+    'be switched nor the building demolished mid-job. It never overruns its schedule, so coming back late banks',
+    "exactly what you booked and no more. Until the job ends it holds the cell's only process slot, so nothing",
+    'can be crafted there; claiming a finished job frees the slot. Size `batches` against the cycle length in',
+    '`cpu_get_game_config` and the deposit in `cpu_get_cell` — scheduling past the deposit just ends early.',
+    'Track it with `cpu_get_mining_status` and bank matured cycles with `cpu_claim_mining`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/mining/start/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,wGAAwG;IACxG,8GAA8G;IAC9G,yGAAyG;IACzG,yGAAyG;IACzG,sGAAsG;IACtG,2GAA2G;IAC3G,wGAAwG;IACxG,YAAY;IACZ,8GAA8G;IAC9G,4GAA4G;IAC5G,4GAA4G;IAC5G,2GAA2G;IAC3G,0GAA0G;IAC1G,wGAAwG;IACxG,wFAAwF;CAC3F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,20 @@
+import { START_MINING_DESCRIPTION } from './constants.js';
+import { summarizeMiningStart } from '../format.utils.js';
+import { startMiningInputSchema } from '../types.js';
+export function registerStartMiningTool(server, context) {
+    server.registerTool('cpu_start_mining', { description: START_MINING_DESCRIPTION, inputSchema: startMiningInputSchema }, async (args) => {
+        const result = await context.mining.startMining({
+            tokenId: args.tokenId,
+            targetResourceId: args.targetResourceId,
+            batches: args.batches,
+        });
+        const { resources } = await context.appConfig.load();
+        return {
+            content: [
+                { type: 'text', text: summarizeMiningStart(result, resources) },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=start-mining.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-mining.js","sourceRoot":"","sources":["../../../../src/tools/mining/start/start-mining.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,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,WAAW,CAAC;YAC5C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,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/types.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const miningStatusInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+};
+export declare const startMiningInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+    targetResourceId: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    batches: z.ZodNumber;
+};
+export declare const claimMiningInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/mining/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,uBAAuB;;CAEnC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;CAsBlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAIlC,CAAC"}

package/dist/tools/mining/types.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { MAX_BATCHES_PER_PROCESS } from '../../config/constants.js';
+import { tokenIdSchema } from '../../geometry/types.js';
+export const miningStatusInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The tokenId of the cell to inspect mining for.'),
+};
+export const startMiningInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The tokenId of a cell you own holding a finished extractor.'),
+    targetResourceId: z
+        .number()
+        .int()
+        .nullable()
+        .default(null)
+        .describe('Resource id to extract — must be one the extractor can mine and have a live deposit on the cell. ' +
+        'Omit (null) to auto-pick when the extractor mines a single resource.'),
+    batches: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_BATCHES_PER_PROCESS)
+        .describe(`How many cycles to run, 1..${MAX_BATCHES_PER_PROCESS}. The job stops itself after these — it ` +
+        'never produces past them, so arriving late banks exactly what was scheduled, no more. There ' +
+        'is no cancel: restarting costs a claim plus a new start. Read the cycle length from ' +
+        'cpu_get_game_config and size the run to how long you want the cell committed.'),
+};
+export const claimMiningInputSchema = {
+    tokenId: tokenIdSchema
+        .transform(String)
+        .describe('The tokenId of a cell you own with an extractor, to bank its matured mining cycles.'),
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/mining/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACtG,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IAChH,gBAAgB,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,mGAAmG;QAC/F,sEAAsE,CAC7E;IACL,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,uBAAuB,CAAC;SAC5B,QAAQ,CACL,8BAA8B,uBAAuB,0CAA0C;QAC3F,8FAA8F;QAC9F,sFAAsF;QACtF,+EAA+E,CACtF;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,OAAO,EAAE,aAAa;SACjB,SAAS,CAAC,MAAM,CAAC;SACjB,QAAQ,CAAC,qFAAqF,CAAC;CACvG,CAAC"}

package/dist/tools/mint/constants.d.ts

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

package/dist/tools/mint/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/mint/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAOvB,CAAC;AAEZ,eAAO,MAAM,sBAAsB,QAKxB,CAAC"}

package/dist/tools/mint/constants.js

@@ -0,0 +1,15 @@
+export const MINT_CELL_DESCRIPTION = [
+    'Mint new land cells on the primary market, straight from the collection’s OpenSea SeaDrop public drop —',
+    'paid in native ETH, no $CPU involved. `quantity` cells are minted to your connected wallet at the',
+    'on-chain drop price; preview the exact ETH cost first with `cpu_quote_mint`. The mint is submitted on-chain',
+    'and this waits for confirmation. Check `cpu_get_balance` for enough ETH (mint price × quantity, plus gas)',
+    'before calling. For existing cells on the secondary market, use OpenSea listings instead (see the',
+    '`land` contract link in the server instructions).',
+].join(' ');
+export const QUOTE_MINT_DESCRIPTION = [
+    'Preview a primary-market land mint without committing: reads the live OpenSea SeaDrop public drop and',
+    'returns the per-cell ETH price and the total for `quantity` cells, plus the drop window and per-wallet',
+    'limit. It has no side effects — no transaction. Use it before `cpu_mint_cell` to size the buy and confirm',
+    'the drop is active.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/mint/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,yGAAyG;IACzG,mGAAmG;IACnG,6GAA6G;IAC7G,2GAA2G;IAC3G,mGAAmG;IACnG,mDAAmD;CACtD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,uGAAuG;IACvG,wGAAwG;IACxG,2GAA2G;IAC3G,qBAAqB;CACxB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { MintQuote, MintResult } from '../../services/types.js';
+export declare function summarizeMintQuote(q: MintQuote): string;
+export declare function summarizeMint(r: MintResult): string;
+//# sourceMappingURL=format.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/mint/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAKvD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAKnD"}

package/dist/tools/mint/format.utils.js

@@ -0,0 +1,9 @@
+export function summarizeMintQuote(q) {
+    return (`Quote: mint ${q.quantity} land cell(s) at ${q.mintPrice} ETH each → ${q.total} ETH total ` +
+        `(plus gas). Per-wallet limit ${q.maxTotalMintableByWallet}. Commit with mint_cell.`);
+}
+export function summarizeMint(r) {
+    return (`Minted ${r.quantity} land cell(s) for ${r.total} ETH: mint tx ${r.txHash} confirmed in block ` +
+        `${r.blockNumber}. New cells appear shortly — use get_map to find them.`);
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/mint/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../../src/tools/mint/format.utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,CAAY;IAC3C,OAAO,CACH,eAAe,CAAC,CAAC,QAAQ,oBAAoB,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,KAAK,aAAa;QAC3F,gCAAgC,CAAC,CAAC,wBAAwB,0BAA0B,CACvF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAa;IACvC,OAAO,CACH,UAAU,CAAC,CAAC,QAAQ,qBAAqB,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,MAAM,sBAAsB;QAC/F,GAAG,CAAC,CAAC,WAAW,wDAAwD,CAC3E,CAAC;AACN,CAAC"}

package/dist/tools/mint/mint-cell.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint-cell.d.ts","sourceRoot":"","sources":["../../../src/tools/mint/mint-cell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAerF"}

package/dist/tools/mint/mint-cell.js

@@ -0,0 +1,15 @@
+import { MINT_CELL_DESCRIPTION } from './constants.js';
+import { summarizeMint } from './format.utils.js';
+import { mintInputSchema } from './types.js';
+export function registerMintCellTool(server, context) {
+    server.registerTool('cpu_mint_cell', { description: MINT_CELL_DESCRIPTION, inputSchema: mintInputSchema }, async (args) => {
+        const result = await context.mint.mint({ quantity: args.quantity });
+        return {
+            content: [
+                { type: 'text', text: summarizeMint(result) },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=mint-cell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint-cell.js","sourceRoot":"","sources":["../../../src/tools/mint/mint-cell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,OAAmB;IAC3E,MAAM,CAAC,YAAY,CACf,eAAe,EACf,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,EACpE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEpE,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;gBAC7C,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/mint/quote/quote-mint.d.ts

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

package/dist/tools/mint/quote/quote-mint.d.ts.map

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

package/dist/tools/mint/quote/quote-mint.js

@@ -0,0 +1,15 @@
+import { QUOTE_MINT_DESCRIPTION } from '../constants.js';
+import { summarizeMintQuote } from '../format.utils.js';
+import { quoteMintInputSchema } from '../types.js';
+export function registerQuoteMintTool(server, context) {
+    server.registerTool('cpu_quote_mint', { description: QUOTE_MINT_DESCRIPTION, inputSchema: quoteMintInputSchema }, async (args) => {
+        const quote = await context.mint.quote({ quantity: args.quantity });
+        return {
+            content: [
+                { type: 'text', text: summarizeMintQuote(quote) },
+                { type: 'text', text: JSON.stringify(quote) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=quote-mint.js.map

package/dist/tools/mint/quote/quote-mint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-mint.js","sourceRoot":"","sources":["../../../../src/tools/mint/quote/quote-mint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,OAAmB;IAC5E,MAAM,CAAC,YAAY,CACf,gBAAgB,EAChB,EAAE,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,oBAAoB,EAAE,EAC1E,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEpE,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE;gBACjD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;aAChD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/mint/types.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const mintInputSchema: {
+    quantity: z.ZodDefault<z.ZodString>;
+};
+export declare const quoteMintInputSchema: {
+    quantity: z.ZodDefault<z.ZodString>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/mint/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;CAM3B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;CAAkB,CAAC"}

package/dist/tools/mint/types.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export const mintInputSchema = {
+    quantity: z
+        .string()
+        .regex(/^[1-9]\d*$/)
+        .default('1')
+        .describe('Number of land cells to mint, as a positive integer string (e.g. "1"). Default "1".'),
+};
+export const quoteMintInputSchema = mintInputSchema;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/mint/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,CAAC;SACnB,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,qFAAqF,CAAC;CACvG,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC"}

package/dist/tools/reveal/constants.d.ts

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

package/dist/tools/reveal/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/reveal/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAOpB,CAAC;AAEZ,eAAO,MAAM,0BAA0B,QAQ5B,CAAC"}

package/dist/tools/reveal/constants.js

@@ -0,0 +1,18 @@
+export const REVEAL_DESCRIPTION = [
+    'Reveal the deposits of a cell you own (call `cpu_authenticate` first). Sends an on-chain Cell tx requesting',
+    'randomness, paying the source fee in ETH — keep some ETH. First reveal is free; a re-reveal needs',
+    'all deposits depleted and costs $CPU (auto-approved once). How the draw arrives depends on the network’s',
+    'randomness mode — see `cpu_get_game_config`. On a self-service network this call also settles the draw and',
+    'returns the deposits it rolled; call it again on a cell whose reveal is still pending to finish that one,',
+    'which costs no new fee.',
+].join(' ');
+export const FULFILL_REVEAL_DESCRIPTION = [
+    'Finish reveal requests you already opened that have not delivered their draw yet (call `cpu_authenticate`',
+    'first). Where the network’s randomness mode leaves delivery to the player — see `cpu_get_game_config` — this',
+    'sends the missing draw on-chain: it costs gas but no new reveal fee. With no arguments it works through every',
+    'open request you own; pass `tokenIds` to settle only those cells. If a request you know exists is not listed,',
+    'name it directly with `requestId` plus `source` and it is settled without that list. Requests already settled',
+    'are reported as such, not as errors. On a network where the randomness source delivers draws itself this call',
+    'refuses — there is nothing to settle by hand there.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/reveal/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,6GAA6G;IAC7G,mGAAmG;IACnG,0GAA0G;IAC1G,4GAA4G;IAC5G,2GAA2G;IAC3G,yBAAyB;CAC5B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACtC,2GAA2G;IAC3G,8GAA8G;IAC9G,+GAA+G;IAC/G,+GAA+G;IAC/G,+GAA+G;IAC/G,+GAA+G;IAC/G,qDAAqD;CACxD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/reveal/fulfill-reveal.d.ts

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

package/dist/tools/reveal/fulfill-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfill-reveal.d.ts","sourceRoot":"","sources":["../../../src/tools/reveal/fulfill-reveal.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2CjD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAmB1F"}

package/dist/tools/reveal/fulfill-reveal.js

@@ -0,0 +1,50 @@
+import { FULFILL_REVEAL_DESCRIPTION } from './constants.js';
+import { fulfillRevealInputSchema } from './types.js';
+import { RevealFulfilmentOutcome, } from '../../services/types.js';
+const OUTCOME_LABEL = {
+    [RevealFulfilmentOutcome.Settled]: 'settled',
+    [RevealFulfilmentOutcome.AlreadyDone]: 'already settled',
+    [RevealFulfilmentOutcome.Busy]: 'left to the call already settling it',
+    [RevealFulfilmentOutcome.RetiredSource]: 'skipped, retired randomness source',
+    [RevealFulfilmentOutcome.NotReady]: 'still open',
+    [RevealFulfilmentOutcome.Failed]: 'failed',
+};
+function countOf(report, outcome) {
+    return report.requests.filter((entry) => entry.outcome === outcome).length;
+}
+function entryLine(entry) {
+    const cell = entry.tokenId === null ? '' : ` (cell ${entry.tokenId})`;
+    const tx = entry.fulfillTxHash === null ? '' : ` Fulfil tx ${entry.fulfillTxHash}.`;
+    return `Request ${entry.requestId}${cell}: ${OUTCOME_LABEL[entry.outcome]} — ${entry.note}${tx}`;
+}
+function emptyLine(tokenIds) {
+    if (tokenIds !== null && tokenIds.length > 0) {
+        return (`None of the cells you named (${tokenIds.join(', ')}) has an open reveal request the game API ` +
+            `lists, so nothing was settled.`);
+    }
+    return 'You have no open reveal request the game API lists, so nothing was settled.';
+}
+function summaryLine(report) {
+    const settled = countOf(report, RevealFulfilmentOutcome.Settled);
+    const done = countOf(report, RevealFulfilmentOutcome.AlreadyDone);
+    const left = report.requests.length - settled - done;
+    const already = done > 0 ? `, ${done} already carried the draw` : '';
+    const open = left > 0 ? `, ${left} still open` : '';
+    return (`Settled ${settled} of ${report.requests.length} reveal requests at randomness source ` +
+        `${report.source}${already}${open}.`);
+}
+export function registerFulfillRevealTool(server, context) {
+    server.registerTool('cpu_fulfill_reveal', { description: FULFILL_REVEAL_DESCRIPTION, inputSchema: fulfillRevealInputSchema }, async (args) => {
+        const report = await context.revealFulfilment.fulfill(args);
+        const header = report.requests.length === 0
+            ? emptyLine(args.tokenIds)
+            : [summaryLine(report), ...report.requests.map(entryLine)].join(' ');
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(report) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=fulfill-reveal.js.map

package/dist/tools/reveal/fulfill-reveal.js.map

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

package/dist/tools/reveal/reveal.d.ts

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

package/dist/tools/reveal/reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../../src/tools/reveal/reveal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoDjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAkBnF"}

package/dist/tools/reveal/reveal.js

@@ -0,0 +1,59 @@
+import { REVEAL_DESCRIPTION } from './constants.js';
+import { revealInputSchema } from './types.js';
+function requestLine(result) {
+    if (result.requestTxHash === null) {
+        return `Cell ${result.tokenId} already carried a reveal request, so nothing new was requested and no $CPU was spent.`;
+    }
+    const cost = result.genesis ? 'first reveal (free)' : `re-reveal (burned ${result.reRevealCost} $CPU)`;
+    const approve = result.approveTxHash !== null ? ` approve tx ${result.approveTxHash},` : '';
+    return (`Requested reveal for cell ${result.tokenId} — ${cost}, paid ${result.fee} ETH fee.${approve} ` +
+        `request tx ${result.requestTxHash} confirmed in block ${result.blockNumber}.`);
+}
+function requestIdLine(result) {
+    if (result.requestId === null) {
+        return null;
+    }
+    const round = result.round !== null ? `, settled by beacon round ${result.round}` : '';
+    const fulfil = result.fulfillTxHash !== null ? ` fulfil tx ${result.fulfillTxHash}.` : '';
+    return `Reveal request ${result.requestId} at randomness source ${result.source}${round}.${fulfil}`;
+}
+function drawLine(result) {
+    if (result.deposits === null) {
+        return result.note === null
+            ? `Deposits are revealed — read them with get_cell ${result.tokenId}.`
+            : `Read the draw with get_cell ${result.tokenId} once the map has caught up.`;
+    }
+    if (result.deposits.length === 0) {
+        return `Deposits are revealed — the draw rolled nothing on cell ${result.tokenId}, which has no deposits to mine.`;
+    }
+    const drawn = result.deposits
+        .map((deposit) => {
+        const name = deposit.resourceName ?? 'resource';
+        return `${deposit.amount} ${name} (#${deposit.resourceId}) at strength ${deposit.strength}`;
+    })
+        .join(', ');
+    return `Deposits are revealed — cell ${result.tokenId} drew ${drawn}.`;
+}
+function outcomeLine(result) {
+    if (!result.fulfilled) {
+        return (result.note ??
+            `Deposits are drawn asynchronously by the randomness source and were not ready yet — poll get_cell ` +
+                `${result.tokenId} shortly.`);
+    }
+    return result.note === null ? drawLine(result) : `${result.note} ${drawLine(result)}`;
+}
+export function registerRevealTool(server, context) {
+    server.registerTool('cpu_reveal', { description: REVEAL_DESCRIPTION, inputSchema: revealInputSchema }, async (args) => {
+        const result = await context.reveal.reveal(args.tokenId);
+        const header = [requestLine(result), requestIdLine(result), outcomeLine(result)]
+            .filter((line) => line !== null)
+            .join(' ');
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=reveal.js.map

package/dist/tools/reveal/reveal.js.map

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

package/dist/tools/reveal/types.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const revealInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+};
+export declare const fulfillRevealInputSchema: {
+    tokenIds: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodEffects<z.ZodNumber, string, number>, "many">>>;
+    requestId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    source: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/reveal/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;CAmBpC,CAAC"}