@colin999n9/gworld-agent 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,127 @@
+# @colin999n9/gworld-agent
+
+> Preview package: this personal-scope package is the temporary testing entrypoint. It is not the final Galxe-owned package. The production release will be published separately as `@galxe/gworld-agent`; npm cannot transfer a scoped package between scopes. After that release, this package will be deprecated with a migration notice.
+
+Local-first GWorld Agent Runner, stdio MCP server, and installable Agent Skill. It is the only first-party browser-independent component that signs game transactions; the Web remains read-only.
+
+## What it protects
+
+- A dedicated wallet is stored as a `scrypt` + AES-256-GCM keystore with `0600` permissions.
+- Interactive users choose a recovery password they know. macOS Keychain can cache it for normal Runner unlocks; headless hosts can use a `0600` password file.
+- MCP never receives a private key, password, arbitrary calldata, raw transaction, contract function, or unrestricted RPC method.
+- Private-key import/export is deliberately local CLI-only. Export requires an interactive confirmation bound to the wallet address and is audit-recorded.
+- Writes require a fresh short-lived legal `actionId`, policy validation, `eth_call` simulation, signing, receipt confirmation, Indexer confirmation, and an audit event.
+- A per-profile OS file lock prevents separate CLI/MCP processes from signing concurrently; a crashed process lock is recovered only after its PID is no longer alive.
+- World writes fail closed while the Indexer is rebuilding, more than one block behind, or reports a persisted cursor ahead of the current chain head. Autonomous failures use bounded exponential backoff and sanitized audit messages.
+- Default policy permits only low-risk, zero-G-spend actions and at most three transactions per round.
+
+Use a new low-balance wallet for GWorld. Never import a primary wallet.
+
+## One-command onboarding
+
+After the package is published:
+
+```bash
+npx @colin999n9/gworld-agent@0.1.0-alpha.0 join --network testnet --client auto
+```
+
+The command creates/unlocks the local encrypted wallet, completes the Agent spawn lifecycle, installs the GWorld Skill, and registers the pinned MCP command with detected Codex and/or Claude clients.
+
+`--client` selects where the local integration is installed; it does not select a wallet, AI model, browser, or in-game Agent:
+
+- `--client auto`: detect Codex CLI and Claude CLI on `PATH`, install the shared Skill, and register the pinned `gworld` MCP command with every detected client.
+- `--client codex`: configure Codex only.
+- `--client claude`: configure Claude only.
+- omit `--client`: join GWorld only; do not install the Skill or register MCP.
+
+`auto` fails with a clear error when neither supported client is detected.
+
+The Gravity Testnet preset is generated from the checked-in deployment and includes the official RPC, Router, confirmations, and hosted Indexer at `https://gworld-indexer.gravity.xyz`. Normal users must not provide `--indexer-url`; the flag remains available only as an explicit developer/self-hosted override.
+
+For a completely custom network, provide the full boundary:
+
+```bash
+gworld-agent join --network custom \
+  --chain-id 12345 \
+  --rpc-url https://rpc.example \
+  --indexer-url https://indexer.example \
+  --router-address 0x0000000000000000000000000000000000000001 \
+  --confirmations 2 \
+  --client auto
+```
+
+Unknown network names fail closed unless every field above is supplied. The Runner uses the trusted testnet preset by default while retaining individual flags only as explicit developer/self-hosted overrides.
+
+## Develop from this repository
+
+```bash
+npm --prefix agent ci
+npm --prefix agent run build
+
+# Start local Anvil + contracts + Indexer in another terminal.
+GWORLD_KEYSTORE_PASSWORD_FILE=/secure/path/password \
+  node agent/dist/cli.js wallet create --profile local
+node agent/dist/cli.js join --profile local --client auto
+```
+
+`GWORLD_KEYSTORE_PASSWORD_FILE` must be mode `0600`. Interactive macOS use normally needs no password environment because the password is generated into Keychain.
+
+To import a dedicated wallet, use the hidden prompt:
+
+```bash
+gworld-agent wallet import --profile default
+```
+
+Automation may pipe the key to `wallet import --stdin`; there is deliberately no `--private-key` option.
+
+To recover or migrate a wallet, export its private key only from a trusted local terminal:
+
+```bash
+gworld-agent wallet export --profile default
+```
+
+The CLI prints a warning, requires the exact confirmation `EXPORT <wallet-address>`, and then forces the user to re-enter the recovery password instead of reading Keychain or environment credentials. On macOS/Linux it can instead create a new mode-`0600` file and refuses to overwrite an existing target:
+
+```bash
+gworld-agent wallet export --profile default --output ./gworld-private-key.txt
+```
+
+Treat either form as highly sensitive. The export command is never registered with MCP and must never be run through an Agent or pasted into chat.
+
+Windows users can reveal the key in the trusted interactive terminal. Raw `--output` file export is disabled on Windows until owner-only ACL enforcement is implemented; this avoids treating POSIX `0600` as if it protected an NTFS file.
+
+## CLI
+
+```text
+wallet create|import|export  create, import, or explicitly recover a dedicated wallet
+join                   create/resume/spawn Agent and optionally install clients
+status                 inspect wallet, Agent, chain, Runner, and sync state
+observe                read current indexed world plus strong RPC Agent state
+actions                create short-lived legal action tickets
+act --kind ACTION      select and execute one currently legal action kind
+activity               read sanitized local audit events
+run                     start the conservative autonomous loop
+pause                   stop autonomous execution without deleting state
+mcp                     serve the stdio MCP protocol
+```
+
+Profiles live under `~/.gworld/profiles/<profile>/` unless `GWORLD_HOME` is set. Config, state, wallet, and audit files are private atomic writes.
+
+## MCP contract
+
+Read tools: `gworld_status`, `gworld_observe`, `gworld_get_legal_actions`, `gworld_get_activity`, and `gworld_get_policy`.
+
+Controlled writes: `gworld_join`, `gworld_simulate_action`, `gworld_execute_action`, `gworld_set_policy`, `gworld_start`, and `gworld_pause`.
+
+External agents must call status → policy → observe → legal actions. Execution accepts only the returned UUID `actionId`; after any state change or stale/expired error, request a new action list.
+
+## Verification
+
+```bash
+npm --prefix agent run typecheck
+npm --prefix agent test
+npm --prefix agent run build
+npm --prefix agent run test:e2e
+```
+
+The E2E starts a temporary Anvil and Ponder Indexer, deploys contracts, imports an Anvil-only test key through stdin, creates/spawns an Agent, checks in, claims a tile, and verifies receipt, indexing, and audit data.

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { type AgentConfig } from './config.js';
+import type { Address, PrivateKey } from './domain.js';
+import { PasswordManager } from './wallet/password-store.js';
+export declare function applyNetworkOverrides(config: AgentConfig, values: Record<string, unknown>): AgentConfig;
+type ExportPasswordUnlocker = Pick<PasswordManager, 'unlockForExport'>;
+export declare function exportWalletPrivateKey(config: AgentConfig, confirmation: string, passwordManager?: ExportPasswordUnlocker): Promise<{
+    address: Address;
+    privateKey: PrivateKey;
+}>;
+export declare function assertPrivateKeyExportOutputSupported(output: string | undefined, platform?: NodeJS.Platform): void;
+export {};

package/dist/cli.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { access } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { getAddress } from 'viem';
+import { generatePrivateKey } from 'viem/accounts';
+import { ALL_ACTIONS, loadConfig, networkPreset, saveConfig } from './config.js';
+import { AgentError, sanitizedError } from './errors.js';
+import { createAgentRuntime } from './factory.js';
+import { stringifyJson } from './json.js';
+import { ClientInstaller } from './client-installer.js';
+import { FileAuditLog } from './runner/audit-store.js';
+import { FileRuntimeState } from './runner/file-state.js';
+import { decryptPrivateKey, encryptPrivateKey, loadKeyStore, saveKeyStore, savePrivateKeyExport } from './wallet/keystore.js';
+import { PasswordManager, promptHidden, promptText } from './wallet/password-store.js';
+import { serveMcp } from './mcp/stdio.js';
+const HELP = `GWorld Agent Kit
+
+Usage:
+  gworld-agent wallet create|import|export [--profile NAME] [--output PATH]
+  gworld-agent join [--profile NAME] [--client auto|codex|claude]
+  gworld-agent status [--profile NAME]
+  gworld-agent observe [--profile NAME]
+  gworld-agent actions [--profile NAME]
+  gworld-agent act --kind ACTION [--profile NAME]
+  gworld-agent activity [--profile NAME] [--limit COUNT]
+  gworld-agent run [--profile NAME]
+  gworld-agent pause [--profile NAME]
+  gworld-agent mcp [--profile NAME]
+
+Custom network (all fields required when changing networks):
+  --network NAME --chain-id ID --rpc-url URL --indexer-url URL --router-address ADDRESS --confirmations COUNT
+
+Private keys are accepted only through the hidden wallet import prompt or --stdin, never command arguments.
+Private-key export is local CLI-only, requires an interactive address-bound confirmation, and is never exposed through MCP.
+`;
+function print(value) {
+    process.stdout.write(`${stringifyJson(value, 2)}\n`);
+}
+export function applyNetworkOverrides(config, values) {
+    const requestedName = values.network == null ? config.network.name : String(values.network);
+    const selected = requestedName === config.network.name ? config.network : networkPreset(requestedName);
+    const required = [
+        ['chain-id', 'chainId'],
+        ['rpc-url', 'rpcUrl'],
+        ['indexer-url', 'indexerUrl'],
+        ['router-address', 'routerAddress'],
+        ['confirmations', 'confirmations'],
+    ];
+    const missing = required
+        .filter(([option, property]) => values[option] == null && (selected == null || selected[property] == null))
+        .map(([option]) => option);
+    if (missing.length > 0) {
+        const reason = selected == null
+            ? `Unknown network ${requestedName}; provide all network fields`
+            : `Network preset ${requestedName} is incomplete`;
+        throw new AgentError('config_invalid', `${reason} (missing: ${missing.join(', ')})`);
+    }
+    const network = {
+        ...config.network,
+        ...(selected ?? {}),
+        name: requestedName,
+        ...(values['chain-id'] ? { chainId: Number(values['chain-id']) } : {}),
+        ...(values['rpc-url'] ? { rpcUrl: String(values['rpc-url']) } : {}),
+        ...(values['indexer-url'] ? { indexerUrl: String(values['indexer-url']) } : {}),
+        ...(values['router-address'] ? { routerAddress: getAddress(String(values['router-address'])).toLowerCase() } : {}),
+        ...(values.confirmations != null ? { confirmations: Number(values.confirmations) } : {}),
+    };
+    return { ...config, network };
+}
+async function withOverrides(config, values) {
+    const next = applyNetworkOverrides(config, values);
+    await saveConfig(next);
+    return next;
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function createWallet(config, profile, imported) {
+    if (await exists(config.wallet.keystorePath))
+        throw new AgentError('wallet_corrupt', 'Wallet already exists; refusing to overwrite it');
+    const password = await new PasswordManager().create(profile);
+    const privateKey = imported ?? generatePrivateKey();
+    const store = await encryptPrivateKey(privateKey, password);
+    await saveKeyStore(config.wallet.keystorePath, store);
+    await saveConfig(config);
+    return store.address;
+}
+async function unlocked(config, profile, interactive = true) {
+    const password = await new PasswordManager().unlock(profile, interactive);
+    const privateKey = await decryptPrivateKey(await loadKeyStore(config.wallet.keystorePath), password);
+    return createAgentRuntime(config, privateKey);
+}
+async function ensureWallet(config, profile) {
+    if (!(await exists(config.wallet.keystorePath)))
+        await createWallet(config, profile);
+}
+async function readPrivateKeyFromStdin() {
+    let value = '';
+    for await (const chunk of process.stdin)
+        value += chunk.toString();
+    value = value.trim();
+    if (!/^0x[0-9a-fA-F]{64}$/.test(value))
+        throw new AgentError('wallet_corrupt', 'Private key must be 32-byte hex');
+    return value;
+}
+export async function exportWalletPrivateKey(config, confirmation, passwordManager = new PasswordManager()) {
+    const store = await loadKeyStore(config.wallet.keystorePath);
+    const expected = `EXPORT ${store.address}`;
+    if (confirmation !== expected) {
+        throw new AgentError('policy_denied', `Private-key export confirmation must exactly match: ${expected}`);
+    }
+    const password = await passwordManager.unlockForExport();
+    return { address: store.address, privateKey: await decryptPrivateKey(store, password) };
+}
+export function assertPrivateKeyExportOutputSupported(output, platform = process.platform) {
+    if (output && platform === 'win32') {
+        throw new AgentError('unsupported', 'Raw file export is disabled on Windows until owner-only ACL support is available; omit --output to reveal it in a trusted terminal');
+    }
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        strict: true,
+        options: {
+            profile: { type: 'string', default: 'default' },
+            client: { type: 'string' },
+            network: { type: 'string' },
+            'chain-id': { type: 'string' },
+            'rpc-url': { type: 'string' },
+            'indexer-url': { type: 'string' },
+            'router-address': { type: 'string' },
+            confirmations: { type: 'string' },
+            stdin: { type: 'boolean' },
+            output: { type: 'string' },
+            kind: { type: 'string' },
+            limit: { type: 'string' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    if (values.help || positionals.length === 0) {
+        process.stdout.write(HELP);
+        return;
+    }
+    const profile = values.profile;
+    let config = await loadConfig(profile);
+    config = await withOverrides(config, values);
+    const command = positionals[0];
+    if (command === 'wallet') {
+        const operation = positionals[1];
+        if (operation === 'create')
+            return print({ wallet: await createWallet(config, profile), profile });
+        if (operation === 'import') {
+            const privateKey = values.stdin ? await readPrivateKeyFromStdin() : await readPrivateKeyFromStdinIfTty();
+            return print({ wallet: await createWallet(config, profile, privateKey), profile });
+        }
+        if (operation === 'export') {
+            assertPrivateKeyExportOutputSupported(values.output);
+            if (!values.output && !process.stdout.isTTY) {
+                throw new AgentError('unsupported', 'Terminal private-key export requires an interactive stdout; use a real terminal or --output PATH');
+            }
+            const store = await loadKeyStore(config.wallet.keystorePath);
+            process.stderr.write('WARNING: Anyone with this private key controls the GWorld wallet. Never paste it into an Agent or chat.\n');
+            const confirmation = await promptText(`Type EXPORT ${store.address} to continue: `);
+            const exported = await exportWalletPrivateKey(config, confirmation);
+            if (values.output) {
+                const outputPath = resolve(values.output);
+                await savePrivateKeyExport(outputPath, exported.privateKey);
+                await new FileAuditLog(config.auditPath).record({
+                    type: 'lifecycle',
+                    status: 'wallet_private_key_exported',
+                    detail: { address: exported.address, destination: 'file' },
+                });
+                return print({ wallet: exported.address, exportedTo: outputPath, profile });
+            }
+            process.stdout.write(`${exported.privateKey}\n`);
+            await new FileAuditLog(config.auditPath).record({
+                type: 'lifecycle',
+                status: 'wallet_private_key_exported',
+                detail: { address: exported.address, destination: 'terminal' },
+            });
+            return;
+        }
+        throw new AgentError('config_invalid', 'wallet command requires create, import, or export');
+    }
+    if (command === 'mcp')
+        return serveMcp(profile);
+    if (command === 'pause') {
+        await new FileRuntimeState(config.statePath).setPaused(true);
+        return print({ state: 'paused', profile });
+    }
+    await ensureWallet(config, profile);
+    const runtime = await unlocked(config, profile);
+    if (command === 'join') {
+        const result = await runtime.join();
+        let installation;
+        if (values.client) {
+            if (!['auto', 'codex', 'claude'].includes(values.client))
+                throw new AgentError('config_invalid', '--client must be auto, codex, or claude');
+            installation = await new ClientInstaller().install(values.client, profile);
+        }
+        return print({ ...result, installation });
+    }
+    if (command === 'status')
+        return print(await runtime.status());
+    if (command === 'observe')
+        return print(await runtime.observe());
+    if (command === 'actions')
+        return print({ actions: await runtime.getLegalActions() });
+    if (command === 'act') {
+        if (!values.kind || !ALL_ACTIONS.includes(values.kind)) {
+            throw new AgentError('config_invalid', `--kind must be one of: ${ALL_ACTIONS.join(', ')}`);
+        }
+        const action = (await runtime.getLegalActions()).find((candidate) => candidate.action.kind === values.kind);
+        if (!action)
+            throw new AgentError('action_not_found', `No currently legal ${values.kind} action`);
+        return print(await runtime.executeAction(action.actionId));
+    }
+    if (command === 'activity') {
+        const limit = values.limit == null ? 50 : Number(values.limit);
+        if (!Number.isInteger(limit) || limit < 1 || limit > 500)
+            throw new AgentError('config_invalid', '--limit must be 1..500');
+        return print({ activity: await runtime.activity(limit) });
+    }
+    if (command === 'run') {
+        print(await runtime.start());
+        await new Promise((resolve) => {
+            const stop = async () => { await runtime.pause(); resolve(); };
+            process.once('SIGINT', stop);
+            process.once('SIGTERM', stop);
+        });
+        return;
+    }
+    throw new AgentError('config_invalid', `Unknown command: ${command}`);
+}
+async function readPrivateKeyFromStdinIfTty() {
+    const value = await promptHidden('Import dedicated GWorld private key: ');
+    if (!/^0x[0-9a-fA-F]{64}$/.test(value))
+        throw new AgentError('wallet_corrupt', 'Private key must be 32-byte hex');
+    return value;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main().catch((error) => {
+        const safe = sanitizedError(error);
+        process.stderr.write(`gworld-agent [${safe.code}]: ${safe.message}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client-installer.d.ts

@@ -0,0 +1,20 @@
+export type AgentClient = 'codex' | 'claude';
+type Run = (command: string, args: string[], inherit?: boolean) => {
+    status: number | null;
+};
+export declare class ClientInstaller {
+    private readonly run;
+    private readonly skillsHome;
+    private readonly skillSource;
+    constructor(run?: Run, skillsHome?: string, skillSource?: string);
+    detected(): AgentClient[];
+    installSkill(): Promise<string>;
+    installMcp(client: AgentClient, profile: string): 'installed' | 'already_configured';
+    install(client: AgentClient | 'auto', profile: string): Promise<{
+        skillPath: string;
+        clients: {
+            [k: string]: "already_configured" | "installed";
+        };
+    }>;
+}
+export {};

package/dist/client-installer.js

@@ -0,0 +1,48 @@
+import { cp, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import { AgentError } from './errors.js';
+function defaultRun(command, args, inherit = false) {
+    return spawnSync(command, args, { stdio: inherit ? 'inherit' : 'ignore' });
+}
+export class ClientInstaller {
+    run;
+    skillsHome;
+    skillSource;
+    constructor(run = defaultRun, skillsHome = join(homedir(), '.agents', 'skills'), skillSource = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'skill', 'gworld')) {
+        this.run = run;
+        this.skillsHome = skillsHome;
+        this.skillSource = skillSource;
+    }
+    detected() {
+        return ['codex', 'claude'].filter((client) => this.run(client, ['--version']).status === 0);
+    }
+    async installSkill() {
+        const target = join(this.skillsHome, 'gworld');
+        await mkdir(this.skillsHome, { recursive: true });
+        await cp(this.skillSource, target, { recursive: true, force: true });
+        return target;
+    }
+    installMcp(client, profile) {
+        if (this.run(client, ['mcp', 'get', 'gworld']).status === 0)
+            return 'already_configured';
+        const launch = ['npx', '--yes', '@colin999n9/gworld-agent@0.1.0-alpha.0', 'mcp', '--profile', profile];
+        const args = client === 'codex'
+            ? ['mcp', 'add', 'gworld', '--', ...launch]
+            : ['mcp', 'add', '--scope', 'user', 'gworld', '--', ...launch];
+        const result = this.run(client, args, true);
+        if (result.status !== 0)
+            throw new AgentError('unsupported', `Unable to register GWorld MCP with ${client}`);
+        return 'installed';
+    }
+    async install(client, profile) {
+        const skillPath = await this.installSkill();
+        const clients = client === 'auto' ? this.detected() : [client];
+        if (clients.length === 0)
+            throw new AgentError('unsupported', 'No supported Codex or Claude client was detected');
+        return { skillPath, clients: Object.fromEntries(clients.map((name) => [name, this.installMcp(name, profile)])) };
+    }
+}
+//# sourceMappingURL=client-installer.js.map

package/dist/client-installer.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+import type { ActionKind, Address, RunnerPolicy } from './domain.js';
+export type NetworkConfig = {
+    name: string;
+    chainId: number;
+    rpcUrl: string;
+    indexerUrl: string;
+    routerAddress: Address;
+    confirmations: number;
+};
+export type NetworkPresetConfig = Pick<NetworkConfig, 'name' | 'chainId' | 'rpcUrl' | 'routerAddress' | 'confirmations'> & Partial<Pick<NetworkConfig, 'indexerUrl'>>;
+export type AgentConfig = {
+    version: 1;
+    profile: string;
+    network: NetworkConfig;
+    wallet: {
+        keystorePath: string;
+    };
+    runner: {
+        agentId: bigint | null;
+        mapRadius: number;
+        pollIntervalMs: number;
+        actionTtlMs: number;
+        indexingTimeoutMs: number;
+    };
+    policy: RunnerPolicy;
+    auditPath: string;
+    statePath: string;
+};
+export declare const ALL_ACTIONS: ActionKind[];
+export declare const DEFAULT_ALLOWED_ACTIONS: ActionKind[];
+export declare function gworldHome(): string;
+export declare function configPath(profile?: string): string;
+export declare function networkPreset(name: string): NetworkPresetConfig | null;
+export declare function defaultConfig(profile?: string): AgentConfig;
+export declare function parseConfig(value: unknown): AgentConfig;
+export declare function loadConfig(profile?: string): Promise<AgentConfig>;
+export declare function saveConfig(config: AgentConfig): Promise<void>;