project-cpu-mcp 0.7.1

package/dist/session/storage.js

@@ -0,0 +1,120 @@
+import { randomBytes } from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { SESSION_DIR_MODE, SESSION_FILE_MODE } from './constants.js';
+import { sessionDataSchema, sessionJsonSchema, sessionPrivateKeySchema, } from './types.js';
+import { SESSION_DIR, SESSION_FILE, SESSION_KEY_FILE } from '../config/constants.js';
+import { errorMessage } from '../utils/error.utils.js';
+export class SessionStorage {
+    homeDir;
+    logger;
+    constructor(homeDir, logger) {
+        this.homeDir = homeDir;
+        this.logger = logger;
+    }
+    exists() {
+        return fs.existsSync(this.sessionFile);
+    }
+    load() {
+        if (!this.exists()) {
+            return null;
+        }
+        try {
+            const json = this.loadJson();
+            const sessionPrivateKey = this.loadKey();
+            return { ...json, sessionPrivateKey };
+        }
+        catch (error) {
+            this.logger.warn('session files are invalid or incompatible; removing and treating as missing', {
+                reason: errorMessage(error),
+            });
+            this.delete();
+            return null;
+        }
+    }
+    save(data) {
+        const validated = sessionDataSchema.parse(data);
+        const { sessionPrivateKey, ...json } = validated;
+        this.ensureDir();
+        this.writeFileAtomic(this.sessionFile, JSON.stringify(json, null, 2));
+        if (sessionPrivateKey !== null) {
+            this.writeFileAtomic(this.sessionKeyFile, sessionPrivateKey);
+        }
+        else {
+            this.wipeAndDeleteKey();
+        }
+    }
+    delete() {
+        this.tryUnlink(this.sessionFile);
+        this.wipeAndDeleteKey();
+    }
+    get sessionDir() {
+        return path.join(this.homeDir, SESSION_DIR);
+    }
+    get sessionFile() {
+        return path.join(this.sessionDir, SESSION_FILE);
+    }
+    get sessionKeyFile() {
+        return path.join(this.sessionDir, SESSION_KEY_FILE);
+    }
+    loadJson() {
+        const raw = fs.readFileSync(this.sessionFile, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const result = sessionJsonSchema.safeParse(parsed);
+        if (!result.success) {
+            const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ');
+            throw new Error(`Invalid session file at ${this.sessionFile}: ${issues}`);
+        }
+        return result.data;
+    }
+    loadKey() {
+        if (!fs.existsSync(this.sessionKeyFile)) {
+            return null;
+        }
+        const raw = fs.readFileSync(this.sessionKeyFile, 'utf-8').trim();
+        const result = sessionPrivateKeySchema.safeParse(raw);
+        if (!result.success) {
+            throw new Error(`Invalid session key file at ${this.sessionKeyFile}`);
+        }
+        return result.data;
+    }
+    ensureDir() {
+        fs.mkdirSync(this.sessionDir, { recursive: true, mode: SESSION_DIR_MODE });
+        fs.chmodSync(this.sessionDir, SESSION_DIR_MODE);
+    }
+    writeFileAtomic(filePath, contents) {
+        const tempFile = `${filePath}.${process.pid}.${randomBytes(4).toString('hex')}.tmp`;
+        fs.writeFileSync(tempFile, contents, { mode: SESSION_FILE_MODE });
+        fs.renameSync(tempFile, filePath);
+        fs.chmodSync(filePath, SESSION_FILE_MODE);
+    }
+    wipeAndDeleteKey() {
+        if (!fs.existsSync(this.sessionKeyFile)) {
+            return;
+        }
+        try {
+            const stats = fs.statSync(this.sessionKeyFile);
+            fs.writeFileSync(this.sessionKeyFile, Buffer.alloc(stats.size), { flag: 'r+' });
+        }
+        catch {
+            // best-effort; continue to unlink
+        }
+        this.tryUnlink(this.sessionKeyFile);
+    }
+    tryUnlink(filePath) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'ENOENT') {
+                return;
+            }
+            this.logger.warn('failed to remove session file', {
+                path: filePath,
+                reason: errorMessage(error),
+            });
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/session/storage.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import type { ILogger } from '../logger/types.js';
+import { WalletMode } from '../types.js';
+export declare const agwSessionConfigSchema: z.ZodObject<{
+    accountAddress: z.ZodString;
+    sessionHash: z.ZodString;
+    policies: z.ZodUnknown;
+    expiresAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    accountAddress: string;
+    sessionHash: string;
+    expiresAt: number;
+    policies?: unknown;
+}, {
+    accountAddress: string;
+    sessionHash: string;
+    expiresAt: number;
+    policies?: unknown;
+}>;
+export declare const sessionDataSchema: z.ZodObject<{
+    walletMode: z.ZodNativeEnum<typeof WalletMode>;
+    address: z.ZodString;
+    sessionPrivateKey: z.ZodNullable<z.ZodString>;
+    jwt: z.ZodNullable<z.ZodString>;
+    sessionConfig: z.ZodNullable<z.ZodObject<{
+        accountAddress: z.ZodString;
+        sessionHash: z.ZodString;
+        policies: z.ZodUnknown;
+        expiresAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    }, {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    }>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    jwt: string | null;
+    walletMode: WalletMode;
+    address: string;
+    sessionPrivateKey: string | null;
+    sessionConfig: {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}, {
+    jwt: string | null;
+    walletMode: WalletMode;
+    address: string;
+    sessionPrivateKey: string | null;
+    sessionConfig: {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export declare const sessionJsonSchema: z.ZodObject<Omit<{
+    walletMode: z.ZodNativeEnum<typeof WalletMode>;
+    address: z.ZodString;
+    sessionPrivateKey: z.ZodNullable<z.ZodString>;
+    jwt: z.ZodNullable<z.ZodString>;
+    sessionConfig: z.ZodNullable<z.ZodObject<{
+        accountAddress: z.ZodString;
+        sessionHash: z.ZodString;
+        policies: z.ZodUnknown;
+        expiresAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    }, {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    }>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "sessionPrivateKey">, "strip", z.ZodTypeAny, {
+    jwt: string | null;
+    walletMode: WalletMode;
+    address: string;
+    sessionConfig: {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}, {
+    jwt: string | null;
+    walletMode: WalletMode;
+    address: string;
+    sessionConfig: {
+        accountAddress: string;
+        sessionHash: string;
+        expiresAt: number;
+        policies?: unknown;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export type SessionJsonData = z.infer<typeof sessionJsonSchema>;
+export declare const sessionPrivateKeySchema: z.ZodString;
+export type AgwSessionConfig = z.infer<typeof agwSessionConfigSchema>;
+export type SessionData = z.infer<typeof sessionDataSchema>;
+export interface ISessionStorage {
+    load(): SessionData | null;
+    save(data: SessionData): void;
+    delete(): void;
+    exists(): boolean;
+}
+export declare enum SessionStatus {
+    Active = "active",
+    Expired = "expired",
+    Missing = "missing"
+}
+export interface SessionManagerOptions {
+    storage: ISessionStorage;
+    walletMode: WalletMode;
+    logger: ILogger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsD,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB,aAE+C,CAAC;AAEpF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC5B,IAAI,IAAI,WAAW,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,OAAO,CAAC;CACrB;AAED,oBAAY,aAAa;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACnB"}

package/dist/session/types.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { WalletMode } from '../types.js';
+export const agwSessionConfigSchema = z.object({
+    accountAddress: z.string(),
+    sessionHash: z.string(),
+    policies: z.unknown(),
+    expiresAt: z.number(),
+});
+export const sessionDataSchema = z.object({
+    walletMode: z.nativeEnum(WalletMode),
+    address: z.string(),
+    sessionPrivateKey: z
+        .string()
+        .regex(/^0x[0-9a-fA-F]{64}$/, 'sessionPrivateKey must be a 32-byte hex string')
+        .nullable(),
+    jwt: z.string().nullable(),
+    sessionConfig: agwSessionConfigSchema.nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const sessionJsonSchema = sessionDataSchema.omit({ sessionPrivateKey: true });
+export const sessionPrivateKeySchema = z
+    .string()
+    .regex(/^0x[0-9a-fA-F]{64}$/, 'sessionPrivateKey must be a 32-byte hex string');
+export var SessionStatus;
+(function (SessionStatus) {
+    SessionStatus["Active"] = "active";
+    SessionStatus["Expired"] = "expired";
+    SessionStatus["Missing"] = "missing";
+})(SessionStatus || (SessionStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,iBAAiB,EAAE,CAAC;SACf,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,gDAAgD,CAAC;SAC9E,QAAQ,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,aAAa,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;AAGrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACnC,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,gDAAgD,CAAC,CAAC;AAYpF,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;AACvB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB"}

package/dist/tools/account/get-balance/constants.d.ts

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

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

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

package/dist/tools/account/get-balance/constants.js

@@ -0,0 +1,6 @@
+export const GET_BALANCE_DESCRIPTION = [
+    "Show the wallet's spendable funds: $CPU (the game currency — paid for reveal, build, craft, transport, and",
+    'trade) and the native gas balance, each a human-readable decimal. Check this before paid actions to avoid',
+    'failed or stranded payments. Requires a configured wallet (no session needed).',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/account/get-balance/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,4GAA4G;IAC5G,2GAA2G;IAC3G,gFAAgF;CACnF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/account/get-balance/get-balance.d.ts

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

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

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

package/dist/tools/account/get-balance/get-balance.js

@@ -0,0 +1,15 @@
+import { GET_BALANCE_DESCRIPTION } from './constants.js';
+export function registerGetBalanceTool(server, context) {
+    server.registerTool('cpu_get_balance', { description: GET_BALANCE_DESCRIPTION, inputSchema: {} }, async () => {
+        const balance = await context.balance.getBalances();
+        const header = `Wallet ${balance.address} on ${balance.network} (chainId ${balance.chainId}): ` +
+            `${balance.cpu} $CPU, ${balance.native} gas.`;
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(balance) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-balance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance.js","sourceRoot":"","sources":["../../../../src/tools/account/get-balance/get-balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAIzD,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,OAAmB;IAC7E,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QACzG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,MAAM,GACR,UAAU,OAAO,CAAC,OAAO,OAAO,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,OAAO,KAAK;YAChF,GAAG,OAAO,CAAC,GAAG,UAAU,OAAO,CAAC,MAAM,OAAO,CAAC;QAElD,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,CAAC,CAAC;AACP,CAAC"}

package/dist/tools/authenticate.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"authenticate.d.ts","sourceRoot":"","sources":["../../src/tools/authenticate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqBhD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAiDzF"}

package/dist/tools/authenticate.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { WalletMode } from '../types.js';
+const DESCRIPTION = [
+    'Create a blockchain session.',
+    'Call this tool when other tools fail with authentication or session errors',
+    '(e.g. "not authenticated", "session expired").',
+    'In EVM mode this signs in via SIWE locally and stores the token.',
+    'In AGW mode it returns a URL the user must open in their browser to approve.',
+    'Once authenticated, subsequent wallet-dependent tools will work automatically.',
+    'Pass force=true to discard the cached session and authenticate from scratch',
+    '(e.g. after the game server was reset and the stored token references a stale user).',
+].join(' ');
+const inputSchema = {
+    force: z
+        .boolean()
+        .nullable()
+        .default(null)
+        .describe('Ignore the stored session and re-run authentication from scratch.'),
+};
+export function registerAuthenticateTool(server, context) {
+    const authService = context.auth;
+    server.registerTool('cpu_authenticate', { description: DESCRIPTION, inputSchema }, async (args) => {
+        const force = args.force ?? false;
+        // EVM mode: SIWE signs locally with the env private key — no browser step.
+        // getAccessToken returns the cached token if still valid; force re-runs SIWE login regardless.
+        if (context.config.WALLET_MODE === WalletMode.EVM) {
+            await (force ? authService.reauthenticate() : authService.getAccessToken());
+            const address = context.wallet.get().getAddress();
+            const suffix = force ? ' (forced fresh SIWE login).' : '.';
+            return {
+                content: [{ type: 'text', text: `Authenticated as ${address}. Session token stored${suffix}` }],
+            };
+        }
+        // AGW mode: Device Authorization flow (asynchronous, browser approval).
+        if (!force && context.session.isAuthenticated()) {
+            return { content: [{ type: 'text', text: 'Already authenticated. Session is active.' }] };
+        }
+        const pending = authService.getPendingAuth();
+        if (pending) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Authentication already in progress. Ask the user to open this URL to approve:\n${pending.verificationUrl}`,
+                    },
+                ],
+            };
+        }
+        const result = await authService.authenticateDevice();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        'Ask the user to open this URL in their browser to approve the session:',
+                        result.verificationUrl,
+                        '',
+                        'Polling for approval in the background...',
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=authenticate.js.map

package/dist/tools/authenticate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticate.js","sourceRoot":"","sources":["../../src/tools/authenticate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,WAAW,GAAG;IAChB,8BAA8B;IAC9B,4EAA4E;IAC5E,gDAAgD;IAChD,kEAAkE;IAClE,8EAA8E;IAC9E,gFAAgF;IAChF,6EAA6E;IAC7E,sFAAsF;CACzF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,WAAW,GAAG;IAChB,KAAK,EAAE,CAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mEAAmE,CAAC;CACrF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAqB,EAAE,OAAmB;IAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjC,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QAElC,2EAA2E;QAC3E,+FAA+F;QAC/F,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;YAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3D,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,OAAO,yBAAyB,MAAM,EAAE,EAAE,CAAC;aAClG,CAAC;QACN,CAAC;QAED,wEAAwE;QACxE,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;YAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2CAA2C,EAAE,CAAC,EAAE,CAAC;QAC9F,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACV,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kFAAkF,OAAO,CAAC,eAAe,EAAE;qBACpH;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,kBAAkB,EAAE,CAAC;QACtD,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACF,wEAAwE;wBACxE,MAAM,CAAC,eAAe;wBACtB,EAAE;wBACF,2CAA2C;qBAC9C,CAAC,IAAI,CAAC,IAAI,CAAC;iBACf;aACJ;SACJ,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/tools/build/build.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/tools/build/build.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CA6BlF"}

package/dist/tools/build/build.js

@@ -0,0 +1,51 @@
+import { formatDistanceStrict } from 'date-fns';
+import { BUILD_DESCRIPTION } from './constants.js';
+import { buildInputSchema } from './types.js';
+import { BuildingKind } from '../../api/types.js';
+import { resourceLabel } from '../../utils/format.utils.js';
+export function registerBuildTool(server, context) {
+    server.registerTool('cpu_build', { description: BUILD_DESCRIPTION, inputSchema: buildInputSchema }, async (args) => {
+        const result = await context.build.build({
+            tokenId: args.tokenId,
+            buildingType: args.buildingType,
+        });
+        const config = await context.appConfig.load();
+        const view = config.buildings.find((b) => b.type === result.buildingType) ?? null;
+        const name = view?.name ?? result.buildingType;
+        const approve = result.approveTxHash !== null ? `approve tx ${result.approveTxHash}; ` : '';
+        const placed = result.alreadyBuilt
+            ? `${name} already in place`
+            : `build tx ${result.buildTxHash} (paid ${result.buildCost} $CPU)`;
+        const header = `Built ${name} on cell ${result.tokenId}: ${approve}${placed}. ` +
+            `The building settles on the map shortly. ${nextStep(view, config, result.tokenId)}`;
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+function nextStep(view, config, tokenId) {
+    if (view === null) {
+        return `Inspect it with cpu_get_cell ${tokenId}.`;
+    }
+    const ready = view.buildTimeSec > 0 ? `Finishes building in ${formatDistanceStrict(0, view.buildTimeSec * 1000)}; ` : '';
+    return ready + action(view, config, tokenId);
+}
+function action(view, config, tokenId) {
+    if (view.kind === BuildingKind.Extractor) {
+        const mines = view.minableResources.map((id) => resourceLabel(config.resources, id)).join(', ');
+        return `once ready, start extraction with cpu_start_mining ${tokenId} (mines: ${mines}).`;
+    }
+    if (view.kind === BuildingKind.Crafter) {
+        const recipes = view.recipes.map((id) => recipeName(config, id)).join(', ');
+        return `once ready, run a recipe with cpu_craft ${tokenId} (recipes: ${recipes}).`;
+    }
+    return `it routes transport and trade. Inspect it with cpu_get_cell ${tokenId}.`;
+}
+function recipeName(config, recipeId) {
+    const recipe = config.recipes.find((r) => r.id === recipeId);
+    return recipe !== undefined ? `${recipe.name} (${recipe.id})` : recipeId;
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build/build.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/build/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QASnB,CAAC;AAEZ,eAAO,MAAM,oBAAoB,QAUtB,CAAC"}

package/dist/tools/build/constants.js

@@ -0,0 +1,22 @@
+export const BUILD_DESCRIPTION = [
+    'Place a building on a revealed Land cell you own (needs a session — `cpu_authenticate` first). Pick a',
+    '`buildingType` from the catalog (`cpu_get_game_config`): an extractor mines a raw deposit, a crafter runs a',
+    'recipe, the hub routes transport/trade. Costs $CPU (some buildings also consume refined resources from the',
+    "cell's warehouse); the tool auto-approves the $CPU spend once, sends the on-chain place, and waits for",
+    'confirmation. Building takes time — it is not usable until it finishes. Once ready, start an extractor with',
+    '`cpu_start_mining` or a crafter with `cpu_craft`. A cell holds one building: re-running build on the same',
+    'building is a safe no-op; to switch buildings `cpu_demolish` first (a just-demolished cell is locked from',
+    'rebuilding until its cooldown ends). Inspect the result with `cpu_get_cell`.',
+].join(' ');
+export const DEMOLISH_DESCRIPTION = [
+    'Remove the building from a Land cell you own, clearing it for a different building. Requires a session —',
+    'call `cpu_authenticate` first. Not free: it burns a fraction of the building’s build cost in $CPU',
+    '(auto-approved) and consumes some of its build materials from the cell’s warehouse (no refund) — see each',
+    "building's `demolishCost` in `cpu_get_game_config` for the exact amounts. The cell must have no active mining",
+    'or craft process — a craft frees its slot once fully claimed, but a mining run only ends when its deposit is',
+    'exhausted, so a mining extractor cannot be demolished mid-run; a `hub` can only be demolished when it is not mid-route or',
+    'anchoring open trade lots. Deposits and other warehouse balances are preserved. Afterward the plot is locked',
+    'from rebuilding until its demolish cooldown ends (its `demolishFinishAt`); `cpu_get_cell`/`cpu_get_attention`',
+    'surface the cooldown.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/build/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,uGAAuG;IACvG,6GAA6G;IAC7G,4GAA4G;IAC5G,wGAAwG;IACxG,6GAA6G;IAC7G,2GAA2G;IAC3G,2GAA2G;IAC3G,8EAA8E;CACjF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,0GAA0G;IAC1G,mGAAmG;IACnG,2GAA2G;IAC3G,+GAA+G;IAC/G,8GAA8G;IAC9G,2HAA2H;IAC3H,8GAA8G;IAC9G,+GAA+G;IAC/G,uBAAuB;CAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/build/demolish.d.ts

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

package/dist/tools/build/demolish.d.ts.map

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

package/dist/tools/build/demolish.js

@@ -0,0 +1,24 @@
+import { DEMOLISH_DESCRIPTION } from './constants.js';
+import { demolishInputSchema } from './types.js';
+import { formatStacks, formatUnixSeconds } from '../../utils/format.utils.js';
+export function registerDemolishTool(server, context) {
+    server.registerTool('cpu_demolish', { description: DEMOLISH_DESCRIPTION, inputSchema: demolishInputSchema }, async (args) => {
+        const result = await context.build.demolish({ tokenId: args.tokenId });
+        const { resources } = await context.appConfig.load();
+        const consumed = formatStacks(resources, result.inputsConsumed);
+        const consumedNote = consumed.length > 0 ? ` plus ${consumed} from its warehouse` : '';
+        const lockNote = result.rebuildUnlockAt !== null
+            ? `The plot is locked from rebuilding until ${formatUnixSeconds(result.rebuildUnlockAt)} ` +
+                `(~${result.rebuildCooldownSec}s).`
+            : 'The plot is locked from rebuilding; the exact demolishFinishAt settles on the map shortly.';
+        const header = `Demolished the ${result.buildingType} on cell ${result.tokenId}: burned ${result.cpuBurned} $CPU` +
+            `${consumedNote}. ${lockNote} tx ${result.txHash} confirmed in block ${result.blockNumber}.`;
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=demolish.js.map

package/dist/tools/build/demolish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demolish.js","sourceRoot":"","sources":["../../../src/tools/build/demolish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,OAAmB;IAC3E,MAAM,CAAC,YAAY,CACf,cAAc,EACd,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,EACvE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,QAAQ,GACV,MAAM,CAAC,eAAe,KAAK,IAAI;YAC3B,CAAC,CAAC,4CAA4C,iBAAiB,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG;gBACxF,KAAK,MAAM,CAAC,kBAAkB,KAAK;YACrC,CAAC,CAAC,4FAA4F,CAAC;QACvG,MAAM,MAAM,GACR,kBAAkB,MAAM,CAAC,YAAY,YAAY,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,SAAS,OAAO;YAClG,GAAG,YAAY,KAAK,QAAQ,OAAO,MAAM,CAAC,MAAM,uBAAuB,MAAM,CAAC,WAAW,GAAG,CAAC;QAEjG,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,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { BuildingType } from '../../api/types.js';
+export declare const buildInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+    buildingType: z.ZodNativeEnum<typeof BuildingType>;
+};
+export declare const demolishInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/build/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,eAAO,MAAM,gBAAgB;;;CAS5B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;CAE/B,CAAC"}

package/dist/tools/build/types.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { BuildingType } from '../../api/types.js';
+import { tokenIdSchema } from '../../geometry/types.js';
+export const buildInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The tokenId of a revealed cell you own to build on.'),
+    buildingType: z
+        .nativeEnum(BuildingType)
+        .describe('Which building to place — see cpu_get_game_config for the full catalog (kind, cost, mine/craft ' +
+        'bindings). An extractor mines a deposit (then start it with cpu_start_mining), a crafter runs a ' +
+        'recipe (cpu_craft), the hub routes transport and trade.'),
+};
+export const demolishInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The tokenId of a cell you own whose building to remove.'),
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/build/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACxG,YAAY,EAAE,CAAC;SACV,UAAU,CAAC,YAAY,CAAC;SACxB,QAAQ,CACL,iGAAiG;QAC7F,kGAAkG;QAClG,yDAAyD,CAChE;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAC/G,CAAC"}

package/dist/tools/config/get-game-config/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const SALE_FEE_STRUCTURAL_BOUND_PERCENT = 100;
+export declare const GET_GAME_CONFIG_DESCRIPTION: string;
+export declare const SELF_SERVICE_RANDOMNESS_SUMMARY: string;
+export declare const PUSH_RANDOMNESS_SUMMARY: string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/config/get-game-config/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,eAAO,MAAM,2BAA2B,QAO7B,CAAC;AAEZ,eAAO,MAAM,+BAA+B,QAIjC,CAAC;AAEZ,eAAO,MAAM,uBAAuB,QAGzB,CAAC"}