project-cpu-mcp 0.14.0 → 1.0.0

package/dist/tools/onboarding/constants.js

@@ -0,0 +1,211 @@
+import { COMPLETE_ONBOARDING_STEP_TOOL_NAME, RESTART_ONBOARDING_TOOL_NAME, SKIP_ONBOARDING_TOOL_NAME, } from '../../onboarding/constants.js';
+import { OnboardingStep } from '../../onboarding/types.js';
+export const ONBOARDING_TOOL_DESCRIPTION = [
+    'Where the player stands in the six-step introduction to the game, and what to cover next. No input.',
+    'Answers with the step (N/6) and its phase, whether the introduction is finished or was skipped, and the',
+    'brief for the current step: the theses to cover, what closes the step and which tool closes it. Call it',
+    'right after `cpu_authenticate` for a player you have not walked through yet, and again whenever you are',
+    'unsure what they already know. The brief is a set of notes for you — put it in your own words, in the',
+    'language of the player, and never read it out. The steps that are pure explanation — `intro`,',
+    '`wallet_and_cell` and `tour` — are closed in the same turn they are delivered, with no confirmation',
+    'asked of the player.',
+].join(' ');
+export const COMPLETE_ONBOARDING_STEP_TOOL_DESCRIPTION = [
+    'Mark one step of the introduction as closed. Use it for the steps that are pure explanation — `intro`,',
+    '`wallet_and_cell` and `tour` — once the player has actually had them, and for a step the player had',
+    'already done before the introduction began: a cell already revealed, a building already standing, a job',
+    'already running. Do not close a step whose action has not happened — `cpu_reveal`, `cpu_build` and',
+    '`cpu_start_mining` close their own steps when the action succeeds. Close an explanation step in the same',
+    'turn you delivered it, without asking the player for permission to go on. Closing the sixth step ends the',
+    'introduction. Answers with the new state and the next brief.',
+].join(' ');
+export const SKIP_ONBOARDING_TOOL_DESCRIPTION = [
+    'Close the whole introduction because the player asked to skip it. `playerRequest` carries their own',
+    'words, quoted, and it must not be empty. Never call this on your own initiative: not because the',
+    'introduction feels slow, not to unblock a tool that refused, not to save a few turns. Without an',
+    'explicit request from the player this call is out of bounds. It closes all six steps with that reason',
+    'and opens every game tool.',
+].join(' ');
+export const RESTART_ONBOARDING_TOOL_DESCRIPTION = [
+    'Run the introduction again because the player asked for it. `playerRequest` carries their own words,',
+    'quoted, and it must not be empty. Never call this on your own initiative — it resets the state to step 1',
+    'and the game tools refuse again until `intro` is closed, so only an explicit request from the player',
+    'justifies it.',
+].join(' ');
+const PACING_RULE = [
+    'Never ask the player for permission to go on and never end on "say next": a step that is pure',
+    `explanation you close at once with \`${COMPLETE_ONBOARDING_STEP_TOOL_NAME}\` and deliver the next brief in`,
+    'the same reply. Hand the turn back only where the step needs something from the player — money to spend,',
+    'a choice to make, a cell to move — and then name exactly that one thing at the end.',
+].join(' ');
+export const ONBOARDING_BRIEF_RULES = [
+    'Four or five sentences at most per step, counted per step even when two steps share one reply.',
+    'Only the terms this step needs; another mechanic only when the player asks about it.',
+    PACING_RULE,
+    'Your own words, in the language the player writes in — the theses are notes, never a text to read out.',
+    'A step that spends real money runs only after the player has said yes to it.',
+];
+const GAME_LOOP_THESIS = [
+    'the loop: mine the deposits, craft what they feed, forge wCPU in the CPU Forge, cash wCPU out 1:1 as',
+    'onchain $CPU',
+].join(' ');
+const EMISSION_BUDGET_THESIS = [
+    'the Emission budget — the onchain $CPU reserve those cash-outs draw on — is finite, and every reveal',
+    'deepens the $CPU market',
+].join(' ');
+const CELL_SOURCES_THESIS = [
+    'two roads to a first cell: a transfer from the own wallet of the player to the agent address, or a',
+    'purchase — `cpu_buy_cell` on the land market, or `cpu_quote_mint` then `cpu_mint_cell` on the primary',
+    'drop',
+].join(' ');
+const REVEAL_FUNDING_THESIS = [
+    'the reveal that comes next is paid in ETH from the agent address, so check it with `cpu_get_balance`',
+    'before promising anything',
+].join(' ');
+const EXTRACTOR_CATALOG_THESIS = [
+    '`cpu_get_cell` names the deposits, `cpu_find_buildings` and `cpu_get_building` name the extractor that',
+    'mines them',
+].join(' ');
+const MINING_SIZE_THESIS = [
+    '`cpu_start_mining` books a fixed number of cycles and there is no cancel, so size it against the cycle',
+    'length in `cpu_get_game_config` and the deposit in `cpu_get_cell`',
+].join(' ');
+const CLAIM_THESIS = [
+    'claim is a mechanic, not a wait: the job banks on its own schedule and `cpu_claim_mining` collects',
+    'whenever the player comes back',
+].join(' ');
+const WCPU_PATH_THESIS = [
+    'the road out: raw output, then recipes with `cpu_craft`, then wCPU from the CPU Forge, then',
+    '`cpu_withdraw` turning wCPU into onchain $CPU, 1:1',
+].join(' ');
+const NETWORK_THESIS = [
+    'a holding is more than one cell: `cpu_transport` moves goods between cells, and hubs carry lots for',
+    'trade — `cpu_list_lots`, `cpu_create_lot`',
+].join(' ');
+const SYNDICATE_THESIS = [
+    'a Syndicate is an onchain alliance of land owners with shared fee terms; trading or shipping through the',
+    'hub of a fellow member simply costs less, and that discount is the one reason worth naming',
+].join(' ');
+const REVEAL_CLOSES = [
+    'a completed `cpu_reveal` closes it by itself; mark it by hand only when the cell was revealed before',
+    'this walkthrough',
+].join(' ');
+export const ONBOARDING_STEP_BRIEFS = {
+    [OnboardingStep.Intro]: {
+        explain: [
+            'Project CPU is an onchain industrial game; land cells are NFTs and one cell is the whole entry ticket',
+            'a cell hides its deposits until a reveal rolls them',
+            GAME_LOOP_THESIS,
+            EMISSION_BUDGET_THESIS,
+            'this walkthrough can be skipped: one word from the player and it stops',
+            'the wallet check comes right now, in this same reply, and not after a confirmation from the player',
+        ],
+        closes: [
+            'at once — mark it and move straight into the wallet check in the same reply; nothing happens',
+            'onchain and nothing is waited for',
+        ].join(' '),
+        nextTool: COMPLETE_ONBOARDING_STEP_TOOL_NAME,
+    },
+    [OnboardingStep.WalletAndCell]: {
+        explain: [
+            'this agent signs from its own wallet, which is not the main wallet of the player',
+            'a cell has to sit on that agent address before the agent can do anything with it',
+            'a cell carries its whole game state when it moves; ETH and $CPU on a wallet do not travel with it',
+            CELL_SOURCES_THESIS,
+            REVEAL_FUNDING_THESIS,
+        ],
+        closes: [
+            'at once when a cell already sits on the agent address — the facts below count them: mark it and move',
+            'on to the reveal in the same reply; otherwise the one thing for the player is to get a cell onto the',
+            'agent address, and the turn ends there',
+        ].join(' '),
+        nextTool: COMPLETE_ONBOARDING_STEP_TOOL_NAME,
+    },
+    [OnboardingStep.Reveal]: {
+        explain: [
+            'a reveal rolls the deposits of one cell, and a cell without deposits produces nothing',
+            'it is paid: ETH with the transaction plus gas; the first reveal of a cell burns no $CPU',
+            'ask the player before sending it — `cpu_reveal` spends real money, so no reveal without a yes',
+            'on some networks the draw lands a moment later; `cpu_get_cell` shows the deposits once it does',
+        ],
+        closes: REVEAL_CLOSES,
+        nextTool: 'cpu_reveal',
+    },
+    [OnboardingStep.BuildExtractor]: {
+        explain: [
+            'an extractor is the building that pulls a deposit out of the ground',
+            'a cell holds one building, so match the extractor to a deposit the cell actually holds',
+            EXTRACTOR_CATALOG_THESIS,
+            'building burns $CPU and takes time to finish: ask the player first, then wait out the construction',
+        ],
+        closes: 'a successful `cpu_build` closes it by itself; mark it by hand only when a building stands',
+        nextTool: 'cpu_build',
+    },
+    [OnboardingStep.StartMining]: {
+        explain: [
+            'a finished extractor stands idle until a job is started on it',
+            MINING_SIZE_THESIS,
+            'a cycle takes hours: say roughly when the job ends instead of asking the player to sit and wait',
+            'matured cycles are banked later with `cpu_claim_mining`, and nothing is lost by coming back late',
+        ],
+        closes: 'a successful `cpu_start_mining` closes it by itself; mark it by hand only when a job runs',
+        nextTool: 'cpu_start_mining',
+    },
+    [OnboardingStep.Tour]: {
+        explain: [
+            CLAIM_THESIS,
+            WCPU_PATH_THESIS,
+            NETWORK_THESIS,
+            SYNDICATE_THESIS,
+            'end with an open door: any mechanic, in any depth, whenever the player asks',
+        ],
+        closes: 'at once — pure explanation: mark it in the same reply, and that mark ends the whole walkthrough',
+        nextTool: COMPLETE_ONBOARDING_STEP_TOOL_NAME,
+    },
+};
+export const EMPTY_ONBOARDING_FACTS = { walletAddress: null, cellCount: null, walletMode: null };
+export const ONBOARDING_STATUS_PREFIX = 'Onboarding:';
+export const ONBOARDING_STATUS_SEPARATOR = ' · ';
+export const ONBOARDING_STATUS_FINISHED = 'finished';
+export const ONBOARDING_STATUS_SKIPPED = 'finished (skipped at the request of the player)';
+export const ONBOARDING_STATUS_UNAVAILABLE = 'unavailable';
+export const ONBOARDING_STATUS_NO_SESSION = 'no session yet';
+export const ONBOARDING_RULES_HEADING = 'How to deliver this step:';
+export const ONBOARDING_EXPLAIN_HEADING = 'Explain (theses, not sentences to reuse):';
+export const ONBOARDING_CLOSES_LABEL = 'Closes:';
+export const ONBOARDING_NEXT_TOOL_LABEL = 'Next tool:';
+export const ONBOARDING_FACTS_HEADING = 'Facts you already hold:';
+export const ONBOARDING_ADDRESS_LABEL = 'Agent wallet address';
+export const ONBOARDING_CELLS_LABEL = 'Cells on that address';
+export const ONBOARDING_WALLET_MODE_LABEL = 'Wallet mode';
+export const ONBOARDING_UNKNOWN_FACT = 'unknown';
+export const ONBOARDING_BULLET = '- ';
+export const ONBOARDING_LINE_SEPARATOR = '\n';
+export const ONBOARDING_SECTION_SEPARATOR = '\n\n';
+export const ONBOARDING_SKIP_REMINDER = [
+    'The player may stop this at any point. Only on their own explicit words, call',
+    `\`${SKIP_ONBOARDING_TOOL_NAME}\` and quote them.`,
+].join(' ');
+export const ONBOARDING_FINISHED_TEXT = [
+    'The introduction is over: no step is open and no reminder follows it.',
+    `Run it again only when the player explicitly asks — \`${RESTART_ONBOARDING_TOOL_NAME}\`, quoting them.`,
+].join(' ');
+export const ONBOARDING_SKIPPED_TEXT = 'The player skipped the introduction.';
+export const ONBOARDING_UNAVAILABLE_TEXT = [
+    'The introduction is unavailable right now. Nothing is blocked: the player can play as usual, and you',
+    'answer their questions from what you know about the game.',
+].join(' ');
+export const ONBOARDING_NO_SESSION_TEXT = [
+    'No game session yet, and the introduction belongs to the wallet rather than to this client.',
+    'Call `cpu_authenticate` first, then ask again.',
+].join(' ');
+export const ONBOARDING_STEP_CLOSED_PREFIX = 'Closed onboarding step';
+export const ONBOARDING_SKIP_DONE_TEXT = [
+    'Onboarding closed at the request of the player. Every game tool is open now and no onboarding reminder',
+    'follows.',
+].join(' ');
+export const ONBOARDING_RESTART_DONE_TEXT = [
+    'Onboarding restarted at the request of the player. It begins again at step 1, and the game tools refuse',
+    'until `intro` is closed.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

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

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

package/dist/tools/onboarding/facts.utils.d.ts

@@ -0,0 +1,5 @@
+import type { OnboardingFacts } from './types.js';
+import { type OnboardingStatus } from '../../onboarding/types.js';
+import type { AppContext } from '../../types.js';
+export declare function readOnboardingFacts(context: AppContext, status: OnboardingStatus): Promise<OnboardingFacts>;
+//# sourceMappingURL=facts.utils.d.ts.map

package/dist/tools/onboarding/facts.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding/facts.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyBjD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAUjH"}

package/dist/tools/onboarding/facts.utils.js

@@ -0,0 +1,38 @@
+import { EMPTY_ONBOARDING_FACTS } from './constants.js';
+import { MapScope } from '../../map/types.js';
+import { currentOnboardingStep } from '../../onboarding/onboarding.utils.js';
+import { OnboardingStep } from '../../onboarding/types.js';
+import { getWalletAddress } from '../map/wallet.utils.js';
+function readAddress(context) {
+    try {
+        return getWalletAddress(context);
+    }
+    catch {
+        return null;
+    }
+}
+async function readCellCount(context, ownerAddress) {
+    try {
+        const result = await context.mapReader.query({
+            scope: MapScope.Summary,
+            tokenIds: null,
+            around: null,
+            ownerAddress,
+        });
+        return result.summary.myCells;
+    }
+    catch {
+        return null;
+    }
+}
+export async function readOnboardingFacts(context, status) {
+    const state = status.state;
+    const step = state === null ? null : currentOnboardingStep(state);
+    if (step !== OnboardingStep.WalletAndCell) {
+        return EMPTY_ONBOARDING_FACTS;
+    }
+    const walletAddress = readAddress(context);
+    const cellCount = walletAddress === null ? null : await readCellCount(context, walletAddress);
+    return { walletAddress, cellCount, walletMode: context.config.WALLET_MODE };
+}
+//# sourceMappingURL=facts.utils.js.map

package/dist/tools/onboarding/facts.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.utils.js","sourceRoot":"","sources":["../../../src/tools/onboarding/facts.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAyB,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,SAAS,WAAW,CAAC,OAAmB;IACpC,IAAI,CAAC;QACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,OAAmB,EAAE,YAAoB;IAClE,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YACzC,KAAK,EAAE,QAAQ,CAAC,OAAO;YACvB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,YAAY;SACf,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAmB,EAAE,MAAwB;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,cAAc,CAAC,aAAa,EAAE,CAAC;QACxC,OAAO,sBAAsB,CAAC;IAClC,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC9F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;AAChF,CAAC"}

package/dist/tools/onboarding/onboarding.d.ts

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

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

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

package/dist/tools/onboarding/onboarding.js

@@ -0,0 +1,12 @@
+import { ONBOARDING_TOOL_DESCRIPTION } from './constants.js';
+import { readOnboardingFacts } from './facts.utils.js';
+import { onboardingReport } from './render.utils.js';
+import { ONBOARDING_TOOL_NAME } from '../../onboarding/constants.js';
+export function registerOnboardingTool(server, context) {
+    server.registerTool(ONBOARDING_TOOL_NAME, { description: ONBOARDING_TOOL_DESCRIPTION, inputSchema: {} }, async () => {
+        const status = await context.onboarding.state();
+        const facts = await readOnboardingFacts(context, status);
+        return { content: onboardingReport(status, facts, null) };
+    });
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/tools/onboarding/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/tools/onboarding/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAIrE,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,OAAmB;IAC7E,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB,EAAE,WAAW,EAAE,2BAA2B,EAAE,WAAW,EAAE,EAAE,EAAE,EAC7D,KAAK,IAAI,EAAE;QACP,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEzD,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IAC9D,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/onboarding/render.utils.d.ts

@@ -0,0 +1,9 @@
+import type { OnboardingFacts } from './types.js';
+import { type OnboardingStatus } from '../../onboarding/types.js';
+export declare function onboardingStatusLine(status: OnboardingStatus): string;
+export declare function onboardingBody(status: OnboardingStatus, facts: OnboardingFacts): string;
+export declare function onboardingReport(status: OnboardingStatus, facts: OnboardingFacts, lead: string | null): Array<{
+    type: 'text';
+    text: string;
+}>;
+//# sourceMappingURL=render.utils.d.ts.map

package/dist/tools/onboarding/render.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding/render.utils.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAGH,KAAK,gBAAgB,EAExB,MAAM,2BAA2B,CAAC;AAwCnC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqBrE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAkBvF;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GACpB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAOvC"}

package/dist/tools/onboarding/render.utils.js

@@ -0,0 +1,79 @@
+import { ONBOARDING_ADDRESS_LABEL, ONBOARDING_BRIEF_RULES, ONBOARDING_BULLET, ONBOARDING_CELLS_LABEL, ONBOARDING_CLOSES_LABEL, ONBOARDING_EXPLAIN_HEADING, ONBOARDING_FACTS_HEADING, ONBOARDING_FINISHED_TEXT, ONBOARDING_LINE_SEPARATOR, ONBOARDING_NEXT_TOOL_LABEL, ONBOARDING_NO_SESSION_TEXT, ONBOARDING_RULES_HEADING, ONBOARDING_SECTION_SEPARATOR, ONBOARDING_SKIP_REMINDER, ONBOARDING_SKIPPED_TEXT, ONBOARDING_STATUS_FINISHED, ONBOARDING_STATUS_NO_SESSION, ONBOARDING_STATUS_PREFIX, ONBOARDING_STATUS_SEPARATOR, ONBOARDING_STATUS_SKIPPED, ONBOARDING_STATUS_UNAVAILABLE, ONBOARDING_STEP_BRIEFS, ONBOARDING_UNAVAILABLE_TEXT, ONBOARDING_UNKNOWN_FACT, ONBOARDING_WALLET_MODE_LABEL, } from './constants.js';
+import { ONBOARDING_STEP_ORDER } from '../../onboarding/constants.js';
+import { currentOnboardingStep, isOnboardingFinished, onboardingPhaseOf } from '../../onboarding/onboarding.utils.js';
+import { OnboardingAvailability, OnboardingStep, } from '../../onboarding/types.js';
+function readyState(status) {
+    return status.availability === OnboardingAvailability.Ready ? status.state : null;
+}
+function bullet(line) {
+    return `${ONBOARDING_BULLET}${line}`;
+}
+function factsBlock(step, facts) {
+    if (step !== OnboardingStep.WalletAndCell) {
+        return null;
+    }
+    return [
+        ONBOARDING_FACTS_HEADING,
+        bullet(`${ONBOARDING_ADDRESS_LABEL}: ${facts.walletAddress ?? ONBOARDING_UNKNOWN_FACT}`),
+        bullet(`${ONBOARDING_CELLS_LABEL}: ${facts.cellCount ?? ONBOARDING_UNKNOWN_FACT}`),
+        bullet(`${ONBOARDING_WALLET_MODE_LABEL}: ${facts.walletMode ?? ONBOARDING_UNKNOWN_FACT}`),
+    ].join(ONBOARDING_LINE_SEPARATOR);
+}
+function briefBlock(step, facts) {
+    const brief = ONBOARDING_STEP_BRIEFS[step];
+    const sections = [
+        [ONBOARDING_RULES_HEADING, ...ONBOARDING_BRIEF_RULES.map(bullet)].join(ONBOARDING_LINE_SEPARATOR),
+        [ONBOARDING_EXPLAIN_HEADING, ...brief.explain.map(bullet)].join(ONBOARDING_LINE_SEPARATOR),
+        [`${ONBOARDING_CLOSES_LABEL} ${brief.closes}`, `${ONBOARDING_NEXT_TOOL_LABEL} \`${brief.nextTool}\``].join(ONBOARDING_LINE_SEPARATOR),
+    ];
+    const known = factsBlock(step, facts);
+    if (known !== null) {
+        sections.push(known);
+    }
+    sections.push(ONBOARDING_SKIP_REMINDER);
+    return sections.join(ONBOARDING_SECTION_SEPARATOR);
+}
+export function onboardingStatusLine(status) {
+    if (status.availability === OnboardingAvailability.Unauthenticated) {
+        return `${ONBOARDING_STATUS_PREFIX} ${ONBOARDING_STATUS_NO_SESSION}`;
+    }
+    const state = readyState(status);
+    if (state === null) {
+        return `${ONBOARDING_STATUS_PREFIX} ${ONBOARDING_STATUS_UNAVAILABLE}`;
+    }
+    const step = currentOnboardingStep(state);
+    if (isOnboardingFinished(state) || step === null) {
+        const mark = state.skippedAt === null ? ONBOARDING_STATUS_FINISHED : ONBOARDING_STATUS_SKIPPED;
+        return `${ONBOARDING_STATUS_PREFIX} ${mark}`;
+    }
+    const position = ONBOARDING_STEP_ORDER.indexOf(step) + 1;
+    return [
+        `${ONBOARDING_STATUS_PREFIX} step ${position}/${ONBOARDING_STEP_ORDER.length} \`${step}\``,
+        `phase ${onboardingPhaseOf(step)}`,
+    ].join(ONBOARDING_STATUS_SEPARATOR);
+}
+export function onboardingBody(status, facts) {
+    if (status.availability === OnboardingAvailability.Unauthenticated) {
+        return ONBOARDING_NO_SESSION_TEXT;
+    }
+    const state = readyState(status);
+    if (state === null) {
+        return ONBOARDING_UNAVAILABLE_TEXT;
+    }
+    const step = currentOnboardingStep(state);
+    if (isOnboardingFinished(state) || step === null) {
+        return state.skippedAt === null
+            ? ONBOARDING_FINISHED_TEXT
+            : [ONBOARDING_SKIPPED_TEXT, ONBOARDING_FINISHED_TEXT].join(' ');
+    }
+    return briefBlock(step, facts);
+}
+export function onboardingReport(status, facts, lead) {
+    const statusLine = onboardingStatusLine(status);
+    const header = lead === null ? statusLine : [lead, statusLine].join(ONBOARDING_LINE_SEPARATOR);
+    return [
+        { type: 'text', text: header },
+        { type: 'text', text: onboardingBody(status, facts) },
+    ];
+}
+//# sourceMappingURL=render.utils.js.map

package/dist/tools/onboarding/render.utils.js.map

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

package/dist/tools/onboarding/restart-onboarding.d.ts

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

package/dist/tools/onboarding/restart-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-onboarding.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding/restart-onboarding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAW9F"}

package/dist/tools/onboarding/restart-onboarding.js

@@ -0,0 +1,13 @@
+import { ONBOARDING_RESTART_DONE_TEXT, RESTART_ONBOARDING_TOOL_DESCRIPTION } from './constants.js';
+import { readOnboardingFacts } from './facts.utils.js';
+import { onboardingReport } from './render.utils.js';
+import { restartOnboardingInputSchema } from './types.js';
+import { RESTART_ONBOARDING_TOOL_NAME } from '../../onboarding/constants.js';
+export function registerRestartOnboardingTool(server, context) {
+    server.registerTool(RESTART_ONBOARDING_TOOL_NAME, { description: RESTART_ONBOARDING_TOOL_DESCRIPTION, inputSchema: restartOnboardingInputSchema }, async (args) => {
+        const status = await context.onboarding.restart(args.playerRequest);
+        const facts = await readOnboardingFacts(context, status);
+        return { content: onboardingReport(status, facts, ONBOARDING_RESTART_DONE_TEXT) };
+    });
+}
+//# sourceMappingURL=restart-onboarding.js.map

package/dist/tools/onboarding/restart-onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-onboarding.js","sourceRoot":"","sources":["../../../src/tools/onboarding/restart-onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAI7E,MAAM,UAAU,6BAA6B,CAAC,MAAqB,EAAE,OAAmB;IACpF,MAAM,CAAC,YAAY,CACf,4BAA4B,EAC5B,EAAE,WAAW,EAAE,mCAAmC,EAAE,WAAW,EAAE,4BAA4B,EAAE,EAC/F,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEzD,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,4BAA4B,CAAC,EAAE,CAAC;IACtF,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/onboarding/skip-onboarding.d.ts

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

package/dist/tools/onboarding/skip-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-onboarding.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding/skip-onboarding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAW3F"}

package/dist/tools/onboarding/skip-onboarding.js

@@ -0,0 +1,13 @@
+import { ONBOARDING_SKIP_DONE_TEXT, SKIP_ONBOARDING_TOOL_DESCRIPTION } from './constants.js';
+import { readOnboardingFacts } from './facts.utils.js';
+import { onboardingReport } from './render.utils.js';
+import { skipOnboardingInputSchema } from './types.js';
+import { SKIP_ONBOARDING_TOOL_NAME } from '../../onboarding/constants.js';
+export function registerSkipOnboardingTool(server, context) {
+    server.registerTool(SKIP_ONBOARDING_TOOL_NAME, { description: SKIP_ONBOARDING_TOOL_DESCRIPTION, inputSchema: skipOnboardingInputSchema }, async (args) => {
+        const status = await context.onboarding.skip(args.playerRequest);
+        const facts = await readOnboardingFacts(context, status);
+        return { content: onboardingReport(status, facts, ONBOARDING_SKIP_DONE_TEXT) };
+    });
+}
+//# sourceMappingURL=skip-onboarding.js.map

package/dist/tools/onboarding/skip-onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-onboarding.js","sourceRoot":"","sources":["../../../src/tools/onboarding/skip-onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAI1E,MAAM,UAAU,0BAA0B,CAAC,MAAqB,EAAE,OAAmB;IACjF,MAAM,CAAC,YAAY,CACf,yBAAyB,EACzB,EAAE,WAAW,EAAE,gCAAgC,EAAE,WAAW,EAAE,yBAAyB,EAAE,EACzF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEzD,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,yBAAyB,CAAC,EAAE,CAAC;IACnF,CAAC,CACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { OnboardingStep } from '../../onboarding/types.js';
+import type { WalletMode } from '../../types.js';
+export interface OnboardingStepBrief {
+    explain: ReadonlyArray<string>;
+    closes: string;
+    nextTool: string;
+}
+export interface OnboardingFacts {
+    walletAddress: string | null;
+    cellCount: number | null;
+    walletMode: WalletMode | null;
+}
+export declare const completeOnboardingStepInputSchema: {
+    step: z.ZodNativeEnum<typeof OnboardingStep>;
+};
+export declare const skipOnboardingInputSchema: {
+    playerRequest: z.ZodString;
+};
+export declare const restartOnboardingInputSchema: {
+    playerRequest: z.ZodString;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,iCAAiC;;CAI7C,CAAC;AAEF,eAAO,MAAM,yBAAyB;;CAMrC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;CAMxC,CAAC"}

package/dist/tools/onboarding/types.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { OnboardingStep } from '../../onboarding/types.js';
+export const completeOnboardingStepInputSchema = {
+    step: z
+        .nativeEnum(OnboardingStep)
+        .describe('The step to mark as closed. Only a step whose content the player has actually had.'),
+};
+export const skipOnboardingInputSchema = {
+    playerRequest: z
+        .string()
+        .trim()
+        .min(1)
+        .describe('The words of the player asking to skip, quoted. Required, and never your own paraphrase.'),
+};
+export const restartOnboardingInputSchema = {
+    playerRequest: z
+        .string()
+        .trim()
+        .min(1)
+        .describe('The words of the player asking for a rerun, quoted. Required, and never your own paraphrase.'),
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/onboarding/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAe3D,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC7C,IAAI,EAAE,CAAC;SACF,UAAU,CAAC,cAAc,CAAC;SAC1B,QAAQ,CAAC,oFAAoF,CAAC;CACtG,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,aAAa,EAAE,CAAC;SACX,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0FAA0F,CAAC;CAC5G,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IACxC,aAAa,EAAE,CAAC;SACX,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,8FAA8F,CAAC;CAChH,CAAC"}

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

@@ -1 +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,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAwDhE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAwBnF"}
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../../src/tools/reveal/reveal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAwDhE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CA4BnF"}

package/dist/tools/reveal/reveal.js

@@ -1,5 +1,7 @@
 import { REVEAL_DESCRIPTION } from './constants.js';
 import { revealInputSchema } from './types.js';
+import { closeOnboardingStep } from '../../onboarding/onboarding.autoclose.js';
+import { OnboardingStep } from '../../onboarding/types.js';
 import { ToolEventType } from '../types.js';
 function requestLine(result) {
     if (result.requestTxHash === null) {
@@ -52,6 +54,9 @@ export function registerRevealTool(server, context) {
         const header = [requestLine(result), requestIdLine(result), outcomeLine(result)]
             .filter((line) => line !== null)
             .join(' ');
+        if (result.fulfilled) {
+            await closeOnboardingStep(context, OnboardingStep.Reveal);
+        }
         return {
             content: [
                 { type: 'text', text: header },

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

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

package/dist/types.d.ts

@@ -3,6 +3,7 @@ import type { EnvConfig } from './config/types.js';
 import type { ILogger } from './logger/types.js';
 import type { MapReader } from './map/reader.js';
 import type { MapSync } from './map/sync.js';
+import type { IOnboardingService } from './onboarding/types.js';
 import type { AppConfigService } from './services/app-config.service.js';
 import type { AuthService } from './services/auth.service.js';
 import type { BalanceService } from './services/balance.service.js';
@@ -63,6 +64,7 @@ export interface AppContext {
     withdraw: WithdrawService;
     mapSync: MapSync;
     mapReader: MapReader;
+    onboarding: IOnboardingService;
     backendVersion: IBackendVersionSignal;
     packageVersion: IPackageVersionSignal;
     logger: ILogger;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,oBAAY,UAAU;IAClB,GAAG,QAAQ;IACX,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,oBAAoB,CAAC;IACpC,aAAa,EAAE,qBAAqB,CAAC;IACrC,WAAW,EAAE,mBAAmB,CAAC;IACjC,cAAc,EAAE,sBAAsB,CAAC;IACvC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,EAAE,qBAAqB,CAAC;IACtC,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,oBAAY,UAAU;IAClB,GAAG,QAAQ;IACX,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,oBAAoB,CAAC;IACpC,aAAa,EAAE,qBAAqB,CAAC;IACrC,WAAW,EAAE,mBAAmB,CAAC;IACjC,cAAc,EAAE,sBAAsB,CAAC;IACvC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,EAAE,qBAAqB,CAAC;IACtC,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,yBAAW,CAAA;IACX,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,yBAAW,CAAA;IACX,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "project-cpu-mcp",
-    "version": "0.14.0",
+    "version": "1.0.0",
     "description": "MCP server for Project CPU — AI agents interact with the game on behalf of players",
     "keywords": [
         "mcp",