@colin999n9/gworld-agent 0.1.0-alpha.0

package/dist/runner/legal-actions.js

@@ -0,0 +1,171 @@
+import { randomUUID } from 'node:crypto';
+import { AgentError } from '../errors.js';
+import { applyDistanceFactor, adjacent } from '../geometry.js';
+import { protocolConfig } from '../generated/protocol.js';
+function availableAp(observation, policy) {
+    const protocolRemaining = protocolConfig.apRoundSpendCap > observation.agent.spentThisRoundCap
+        ? protocolConfig.apRoundSpendCap - observation.agent.spentThisRoundCap
+        : 0n;
+    const policyRemaining = policy.maxApPerRoundCap > observation.agent.spentThisRoundCap
+        ? policy.maxApPerRoundCap - observation.agent.spentThisRoundCap
+        : 0n;
+    return [observation.agent.apBalanceCap, protocolRemaining, policyRemaining].reduce((minimum, value) => value < minimum ? value : minimum);
+}
+function movementCost(tile) {
+    const move = applyDistanceFactor(protocolConfig.moveCostCap, tile.coord);
+    return tile.ownerAgentId == null ? move : move + move * protocolConfig.tollBps / protocolConfig.bpsBase;
+}
+export class ActionCatalog {
+    ttlMs;
+    now;
+    tickets = new Map();
+    constructor(ttlMs, now = Date.now) {
+        this.ttlMs = ttlMs;
+        this.now = now;
+    }
+    issue(observation, candidates) {
+        this.prune();
+        return candidates.map((candidate) => {
+            const createdAt = this.now();
+            const ticket = {
+                actionId: randomUUID(),
+                ...candidate,
+                chainId: observation.chainId,
+                round: observation.round,
+                nonce: observation.agent.actionNonce,
+                createdAt,
+                expiresAt: createdAt + this.ttlMs,
+            };
+            this.tickets.set(ticket.actionId, ticket);
+            return ticket;
+        });
+    }
+    resolve(actionId, observation) {
+        const ticket = this.tickets.get(actionId);
+        if (!ticket)
+            throw new AgentError('action_not_found', `Unknown actionId: ${actionId}`);
+        if (ticket.expiresAt <= this.now()) {
+            this.tickets.delete(actionId);
+            throw new AgentError('action_expired', 'Action ticket has expired; observe and plan again');
+        }
+        if (ticket.chainId !== observation.chainId || ticket.round !== observation.round || ticket.nonce !== observation.agent.actionNonce) {
+            throw new AgentError('action_stale', 'Action ticket no longer matches current chain, round, or nonce');
+        }
+        if ('agentId' in ticket.action && ticket.action.agentId !== observation.agent.id) {
+            throw new AgentError('action_stale', 'Action ticket no longer matches the selected Agent');
+        }
+        return ticket;
+    }
+    consume(actionId, observation) {
+        const ticket = this.resolve(actionId, observation);
+        this.tickets.delete(actionId);
+        return ticket;
+    }
+    prune() {
+        const now = this.now();
+        for (const [id, ticket] of this.tickets)
+            if (ticket.expiresAt <= now)
+                this.tickets.delete(id);
+    }
+}
+export class LegalActionPlanner {
+    catalog;
+    constructor(catalog) {
+        this.catalog = catalog;
+    }
+    plan(observation, policy) {
+        const candidates = [];
+        const agent = observation.agent;
+        const ap = availableAp(observation, policy);
+        const checkinReady = agent.lastCheckinAt === 0n
+            || agent.blockTimestamp >= agent.lastCheckinAt + protocolConfig.checkinCooldownSeconds;
+        if (checkinReady && agent.apBalanceCap < protocolConfig.apCheckinCap) {
+            candidates.push({ action: { kind: 'checkin', agentId: agent.id }, risk: 'low', reason: 'Check-in is ready and AP is below the faucet threshold.' });
+        }
+        const fragment = observation.fragments.find((item) => item.agentId === agent.id && item.status === 'pending');
+        if (fragment) {
+            candidates.push({
+                action: { kind: 'continueFragmentResolution', agentId: agent.id, maxSteps: protocolConfig.maxFragmentBatchSteps },
+                risk: 'low',
+                reason: `Fragment resolution job ${fragment.jobId} is locking world actions.`,
+            });
+        }
+        if (!fragment && agent.position) {
+            const nearby = observation.tiles.filter((tile) => tile.activated && adjacent(tile.coord, agent.position));
+            for (const tile of nearby) {
+                if (tile.ownerAgentId == null) {
+                    const cost = applyDistanceFactor(protocolConfig.claimCostCap, tile.coord);
+                    if (cost <= ap)
+                        candidates.push({
+                            action: { kind: 'claim', agentId: agent.id, tileKey: tile.key, apCostCap: cost },
+                            risk: 'low',
+                            reason: `Activated neutral tile (${tile.coord.q},${tile.coord.r}) is adjacent and costs ${cost} cAP.`,
+                        });
+                }
+                else if (tile.ownerAgentId !== agent.id) {
+                    const costPerPoint = applyDistanceFactor(protocolConfig.capPerAp, tile.coord);
+                    const apCap = BigInt(tile.effectiveDefense) * costPerPoint;
+                    if (apCap > 0n && apCap <= ap)
+                        candidates.push({
+                            action: { kind: 'attack', agentId: agent.id, tileKey: tile.key, apCap },
+                            risk: 'high',
+                            reason: `Adjacent enemy tile can be captured with an estimated ${apCap} cAP cap.`,
+                        });
+                }
+                const cost = movementCost(tile);
+                if (cost <= ap)
+                    candidates.push({
+                        action: {
+                            kind: 'move', agentId: agent.id, expectedFrom: agent.position,
+                            path: [tile.key], expectedNonce: agent.actionNonce, apCostCap: cost,
+                        },
+                        risk: tile.ownerAgentId != null && tile.ownerAgentId !== agent.id ? 'medium' : 'low',
+                        reason: `Move one step to (${tile.coord.q},${tile.coord.r}) for at most ${cost} cAP including toll.`,
+                    });
+            }
+            const owned = observation.tiles
+                .filter((tile) => tile.ownerAgentId === agent.id && tile.effectiveDefense < Number(protocolConfig.defenseMax))
+                .sort((left, right) => left.effectiveDefense - right.effectiveDefense || Number(left.key - right.key));
+            const target = owned.find((tile) => tile.coord.q === agent.position?.q && tile.coord.r === agent.position?.r) ?? owned[0];
+            if (target) {
+                const local = target.coord.q === agent.position.q && target.coord.r === agent.position.r;
+                const apCap = applyDistanceFactor(local ? protocolConfig.reinforceLocalCap : protocolConfig.reinforceRemoteCap, target.coord);
+                if (apCap <= ap)
+                    candidates.push({
+                        action: { kind: 'reinforce', agentId: agent.id, tileKey: target.key, apCap },
+                        risk: 'low',
+                        reason: `Weakest owned tile has ${target.effectiveDefense} defense; add one defense point for up to ${apCap} cAP.`,
+                    });
+            }
+        }
+        if (observation.marketRequest.state === 'available') {
+            candidates.push({ action: { kind: 'requestMarket' }, risk: 'low', reason: 'This round can request its permissionless market.' });
+        }
+        else if (observation.marketRequest.state === 'finalizable') {
+            candidates.push({ action: { kind: 'finalizeMarket', round: observation.marketRequest.round }, risk: 'low', reason: 'Market randomness is ready to finalize.' });
+        }
+        for (const market of observation.markets) {
+            if (market.status !== 'settled' && observation.round > market.settleRound) {
+                candidates.push({ action: { kind: 'settleMarket', marketId: market.id }, risk: 'low', reason: `Market ${market.id} is permissionlessly settleable.` });
+            }
+            const position = market.walletPosition;
+            if (market.status === 'settled' && position && !position.claimed
+                && (market.refundable || position.optionIndex === market.winningOption)) {
+                candidates.push({ action: { kind: 'claimMarket', marketId: market.id }, risk: 'low', reason: `Market ${market.id} has a claimable wallet position.` });
+            }
+            if (market.status === 'open' && market.writeState === 'current_writable' && !position
+                && policy.allowedActions.includes('bet') && policy.maxGBetPerAction >= protocolConfig.minBetG
+                && policy.maxGSpendPerDay >= protocolConfig.minBetG && observation.walletGBalance >= protocolConfig.minBetG) {
+                const option = [...market.options].sort((left, right) => left.poolG < right.poolG ? -1 : left.poolG > right.poolG ? 1 : Number(left.index - right.index))[0];
+                if (option)
+                    candidates.push({
+                        action: { kind: 'bet', marketId: market.id, agentId: agent.id, optionIndex: option.index, amountG: protocolConfig.minBetG },
+                        risk: 'medium',
+                        reason: `Smallest-pool option ${option.index} is available at the minimum configured stake.`,
+                    });
+            }
+        }
+        return this.catalog.issue(observation, candidates.filter((candidate) => policy.allowedActions.includes(candidate.action.kind)));
+    }
+}
+//# sourceMappingURL=legal-actions.js.map

package/dist/runner/legal-actions.js.map

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

package/dist/runner/observation.d.ts

@@ -0,0 +1,12 @@
+import type { Address, Observation } from '../domain.js';
+import type { AgentIndexerClient } from '../data/indexer-client.js';
+import type { AgentRpcReader } from '../data/rpc-reader.js';
+export declare class ObservationService {
+    private readonly chainId;
+    private readonly wallet;
+    private readonly radius;
+    private readonly indexer;
+    private readonly rpc;
+    constructor(chainId: number, wallet: Address, radius: number, indexer: AgentIndexerClient, rpc: AgentRpcReader);
+    observe(agentId: bigint): Promise<Observation>;
+}

package/dist/runner/observation.js

@@ -0,0 +1,47 @@
+import { AgentError } from '../errors.js';
+export class ObservationService {
+    chainId;
+    wallet;
+    radius;
+    indexer;
+    rpc;
+    constructor(chainId, wallet, radius, indexer, rpc) {
+        this.chainId = chainId;
+        this.wallet = wallet;
+        this.radius = radius;
+        this.indexer = indexer;
+        this.rpc = rpc;
+    }
+    async observe(agentId) {
+        await this.rpc.assertNetwork();
+        const [indexedAgent, strong] = await Promise.all([this.indexer.getAgent(agentId), this.rpc.agent(agentId)]);
+        if (strong.owner !== this.wallet || indexedAgent.owner !== this.wallet) {
+            throw new AgentError('not_agent_owner', `Wallet ${this.wallet} does not own Agent ${agentId}`);
+        }
+        if (!strong.active || !strong.position)
+            throw new AgentError('agent_pending', `Agent ${agentId} is not active`);
+        const [world, asset] = await Promise.all([
+            this.indexer.world(strong.position, this.radius),
+            this.rpc.walletAsset(this.wallet),
+        ]);
+        const [markets, marketRequest] = await Promise.all([
+            this.indexer.markets(this.wallet),
+            this.indexer.marketRequest(strong.currentRound),
+        ]);
+        return {
+            chainId: this.chainId,
+            wallet: this.wallet,
+            round: strong.currentRound,
+            asOfBlock: world.asOfBlock,
+            sync: world.sync,
+            walletGBalance: asset.balance,
+            agent: { ...indexedAgent, ...strong, id: agentId, owner: this.wallet, lifecycle: 'active', position: strong.position },
+            agents: world.agents,
+            tiles: world.tiles,
+            fragments: world.fragments,
+            markets,
+            marketRequest,
+        };
+    }
+}
+//# sourceMappingURL=observation.js.map

package/dist/runner/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../src/runner/observation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,OAAO,kBAAkB;IAEV,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,GAAG;IALtB,YACmB,OAAe,EACf,MAAe,EACf,MAAc,EACd,OAA2B,EAC3B,GAAmB;uBAJnB,OAAO;sBACP,MAAM;sBACN,MAAM;uBACN,OAAO;mBACP,GAAG;IACnB,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5G,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACvE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,UAAU,IAAI,CAAC,MAAM,uBAAuB,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,SAAS,OAAO,gBAAgB,CAAC,CAAC;QAChH,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC;SAChD,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,cAAc,EAAE,KAAK,CAAC,OAAO;YAC7B,KAAK,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;YACtH,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO;YACP,aAAa;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/runner/policy.d.ts

@@ -0,0 +1,10 @@
+import type { LegalAction, Observation, RunnerPolicy } from '../domain.js';
+import type { AuditLog } from './audit-store.js';
+export declare class PolicyEngine {
+    private readonly policy;
+    private readonly audit;
+    private readonly now;
+    constructor(policy: RunnerPolicy, audit: AuditLog, now?: () => Date);
+    current(): RunnerPolicy;
+    assertAllowed(ticket: LegalAction, observation: Observation, automatic?: boolean): Promise<void>;
+}

package/dist/runner/policy.js

@@ -0,0 +1,68 @@
+import { AgentError } from '../errors.js';
+import { protocolConfig } from '../generated/protocol.js';
+const RISK_SCORE = { low: 0, medium: 1, high: 2 };
+function agentIdOf(action) {
+    return 'agentId' in action ? action.agentId : null;
+}
+function apCost(action) {
+    switch (action.kind) {
+        case 'claim':
+        case 'move':
+            return action.apCostCap;
+        case 'attack':
+        case 'reinforce':
+            return action.apCap;
+        default:
+            return 0n;
+    }
+}
+export class PolicyEngine {
+    policy;
+    audit;
+    now;
+    constructor(policy, audit, now = () => new Date()) {
+        this.policy = policy;
+        this.audit = audit;
+        this.now = now;
+    }
+    current() {
+        return structuredClone(this.policy);
+    }
+    async assertAllowed(ticket, observation, automatic = true) {
+        const action = ticket.action;
+        if (!this.policy.allowedActions.includes(action.kind)) {
+            throw new AgentError('policy_denied', `${action.kind} is not allowed by Runner policy`);
+        }
+        if (automatic && RISK_SCORE[ticket.risk] > RISK_SCORE[this.policy.autoExecuteRisk]) {
+            throw new AgentError('policy_denied', `${ticket.risk} risk exceeds ${this.policy.autoExecuteRisk} auto-execution policy`);
+        }
+        const agentId = agentIdOf(action);
+        if (agentId != null && this.policy.allowedAgentIds.length > 0 && !this.policy.allowedAgentIds.includes(agentId)) {
+            throw new AgentError('policy_denied', `Agent ${agentId} is not in the allowed Agent list`);
+        }
+        const cost = apCost(action);
+        const roundLimit = this.policy.maxApPerRoundCap < protocolConfig.apRoundSpendCap
+            ? this.policy.maxApPerRoundCap
+            : protocolConfig.apRoundSpendCap;
+        if (observation.agent.spentThisRoundCap + cost > roundLimit) {
+            throw new AgentError('policy_denied', `Action would exceed the ${roundLimit} cAP per-round policy`);
+        }
+        if (cost > observation.agent.apBalanceCap)
+            throw new AgentError('policy_denied', 'Action would exceed the Agent AP balance');
+        if (await this.audit.transactionCount(observation.round) >= this.policy.maxTransactionsPerRound) {
+            throw new AgentError('policy_denied', 'Per-round transaction limit is exhausted');
+        }
+        if (action.kind === 'bet') {
+            if (action.amountG > this.policy.maxGBetPerAction)
+                throw new AgentError('policy_denied', 'Bet exceeds the per-action G limit');
+            const since = new Date(this.now());
+            since.setUTCHours(0, 0, 0, 0);
+            const spent = await this.audit.gSpentSince(since.toISOString());
+            if (spent + action.amountG > this.policy.maxGSpendPerDay)
+                throw new AgentError('policy_denied', 'Bet exceeds the daily G limit');
+            if (action.amountG > observation.walletGBalance)
+                throw new AgentError('policy_denied', 'Bet exceeds wallet G balance');
+        }
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/runner/policy.js.map

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

package/dist/runner/runtime.d.ts

@@ -0,0 +1,73 @@
+import type { AgentConfig } from '../config.js';
+import type { Address, AuditEvent, LegalAction, Observation, RunnerPolicy, TransactionResult } from '../domain.js';
+import type { AgentIndexerClient } from '../data/indexer-client.js';
+import type { AgentRpcReader } from '../data/rpc-reader.js';
+import type { AuditLog } from './audit-store.js';
+import type { TransactionExecutor } from './transaction-executor.js';
+export type RunnerStatus = {
+    state: 'not_joined' | 'pending' | 'ready' | 'running' | 'paused';
+    chainId: number;
+    wallet: Address;
+    agentId: bigint | null;
+    blockNumber: bigint;
+    sync?: Observation['sync'];
+};
+export type JoinResult = {
+    wallet: Address;
+    agentId: bigint;
+    lifecycle: 'active';
+    position: {
+        q: number;
+        r: number;
+    };
+    transactionHashes: string[];
+};
+export type RuntimeStateStore = {
+    paused(): Promise<boolean>;
+    setPaused(paused: boolean): Promise<void>;
+};
+export declare class MemoryRuntimeState implements RuntimeStateStore {
+    private value;
+    paused(): Promise<boolean>;
+    setPaused(paused: boolean): Promise<void>;
+}
+export declare class AgentRuntime {
+    readonly wallet: Address;
+    private readonly indexer;
+    private readonly rpc;
+    private readonly executor;
+    private readonly audit;
+    private readonly state;
+    private readonly persistConfig;
+    private readonly sleep;
+    private config;
+    private policy;
+    private readonly catalog;
+    private readonly planner;
+    private readonly observation;
+    private loop;
+    private loopInFlight;
+    private consecutiveLoopFailures;
+    constructor(config: AgentConfig, wallet: Address, indexer: AgentIndexerClient, rpc: AgentRpcReader, executor: TransactionExecutor, audit: AuditLog, state?: RuntimeStateStore, persistConfig?: (config: AgentConfig) => Promise<void>, sleep?: (milliseconds: number) => Promise<void>);
+    status(): Promise<RunnerStatus>;
+    private selectAgent;
+    private waitForBlock;
+    join(): Promise<JoinResult>;
+    private requireAgentId;
+    observe(): Promise<Observation>;
+    getLegalActions(): Promise<LegalAction[]>;
+    private assertIndexerUsable;
+    simulateAction(actionId: string): Promise<{
+        action: LegalAction;
+        steps: string[];
+        deferredUntilApproval: boolean;
+    }>;
+    executeAction(actionId: string): Promise<TransactionResult>;
+    getPolicy(): RunnerPolicy;
+    setPolicy(next: RunnerPolicy): Promise<RunnerPolicy>;
+    activity(limit?: number): Promise<AuditEvent[]>;
+    runOnce(): Promise<TransactionResult | null>;
+    start(): Promise<RunnerStatus>;
+    pause(): Promise<RunnerStatus>;
+    private scheduleLoop;
+}

package/dist/runner/runtime.js

@@ -0,0 +1,236 @@
+import { parseConfig, saveConfig } from '../config.js';
+import { AgentError, sanitizedError } from '../errors.js';
+import { stringifyJson } from '../json.js';
+import { ActionCatalog, LegalActionPlanner } from './legal-actions.js';
+import { ObservationService } from './observation.js';
+import { PolicyEngine } from './policy.js';
+import { conservativeAction } from './strategy.js';
+export class MemoryRuntimeState {
+    value = true;
+    async paused() { return this.value; }
+    async setPaused(paused) { this.value = paused; }
+}
+export class AgentRuntime {
+    wallet;
+    indexer;
+    rpc;
+    executor;
+    audit;
+    state;
+    persistConfig;
+    sleep;
+    config;
+    policy;
+    catalog;
+    planner;
+    observation;
+    loop = null;
+    loopInFlight = false;
+    consecutiveLoopFailures = 0;
+    constructor(config, wallet, indexer, rpc, executor, audit, state = new MemoryRuntimeState(), persistConfig = saveConfig, sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds))) {
+        this.wallet = wallet;
+        this.indexer = indexer;
+        this.rpc = rpc;
+        this.executor = executor;
+        this.audit = audit;
+        this.state = state;
+        this.persistConfig = persistConfig;
+        this.sleep = sleep;
+        this.config = structuredClone(config);
+        this.policy = new PolicyEngine(this.config.policy, audit);
+        this.catalog = new ActionCatalog(this.config.runner.actionTtlMs);
+        this.planner = new LegalActionPlanner(this.catalog);
+        this.observation = new ObservationService(config.network.chainId, wallet, config.runner.mapRadius, indexer, rpc);
+    }
+    async status() {
+        await this.rpc.assertNetwork();
+        const block = await this.rpc.block();
+        const agents = await this.indexer.walletAgents(this.wallet);
+        const selected = this.selectAgent(agents);
+        if (!selected)
+            return { state: 'not_joined', chainId: this.config.network.chainId, wallet: this.wallet, agentId: null, blockNumber: block.number };
+        if (selected.lifecycle === 'pending')
+            return { state: 'pending', chainId: this.config.network.chainId, wallet: this.wallet, agentId: selected.id, blockNumber: block.number };
+        const paused = await this.state.paused();
+        return {
+            state: this.loop && !paused ? 'running' : paused ? 'paused' : 'ready',
+            chainId: this.config.network.chainId,
+            wallet: this.wallet,
+            agentId: selected.id,
+            blockNumber: block.number,
+            sync: await this.indexer.status(),
+        };
+    }
+    selectAgent(agents) {
+        if (this.config.runner.agentId != null)
+            return agents.find((agent) => agent.id === this.config.runner.agentId);
+        return agents.find((agent) => agent.lifecycle === 'active') ?? agents[0];
+    }
+    async waitForBlock(target) {
+        while ((await this.rpc.block()).number <= target)
+            await this.sleep(this.config.runner.pollIntervalMs);
+    }
+    async join() {
+        await this.rpc.assertNetwork();
+        const hashes = [];
+        let agents = await this.indexer.walletAgents(this.wallet);
+        if (agents.length === 0) {
+            const created = await this.executor.execute({ kind: 'createAgent' });
+            hashes.push(...created.hashes);
+            agents = await this.indexer.walletAgents(this.wallet);
+        }
+        let selected = this.selectAgent(agents) ?? agents[0];
+        if (!selected)
+            throw new AgentError('agent_missing', 'Agent creation completed but Indexer returned no wallet Agent');
+        while (selected.lifecycle === 'pending') {
+            const pending = (await this.indexer.getAgent(selected.id)).pendingRequest;
+            if (!pending)
+                throw new AgentError('agent_pending', `Pending Agent ${selected.id} has no randomness request`);
+            if (pending.state === 'expired') {
+                const refreshed = await this.executor.execute({ kind: 'refreshSpawnRandomness', agentId: selected.id });
+                hashes.push(...refreshed.hashes);
+            }
+            else if (pending.state === 'waiting') {
+                await this.waitForBlock(pending.targetBlock);
+            }
+            else {
+                const spawned = await this.executor.execute({ kind: 'spawnAgent', agentId: selected.id });
+                hashes.push(...spawned.hashes);
+            }
+            selected = await this.indexer.getAgent(selected.id);
+        }
+        this.config = { ...this.config, runner: { ...this.config.runner, agentId: selected.id } };
+        if (this.config.policy.allowedAgentIds.length === 0) {
+            this.config = { ...this.config, policy: { ...this.config.policy, allowedAgentIds: [selected.id] } };
+            this.policy = new PolicyEngine(this.config.policy, this.audit);
+        }
+        await this.persistConfig(this.config);
+        await this.audit.record({ type: 'lifecycle', action: undefined, status: 'joined', detail: { agentId: selected.id.toString() } });
+        const observed = await this.observation.observe(selected.id);
+        return { wallet: this.wallet, agentId: selected.id, lifecycle: 'active', position: observed.agent.position, transactionHashes: hashes };
+    }
+    requireAgentId() {
+        if (this.config.runner.agentId == null)
+            throw new AgentError('agent_missing', 'Runner has not joined GWorld');
+        return this.config.runner.agentId;
+    }
+    observe() {
+        return this.observation.observe(this.requireAgentId());
+    }
+    async getLegalActions() {
+        const observation = await this.observe();
+        this.assertIndexerUsable(observation);
+        const actions = this.planner.plan(observation, this.config.policy);
+        const allowed = [];
+        for (const action of actions) {
+            try {
+                await this.policy.assertAllowed(action, observation);
+                allowed.push(action);
+            }
+            catch (error) {
+                if (!(error instanceof AgentError) || error.code !== 'policy_denied')
+                    throw error;
+            }
+        }
+        return allowed;
+    }
+    assertIndexerUsable(observation) {
+        const lag = observation.sync.chainHeadBlock > observation.sync.indexedBlock
+            ? observation.sync.chainHeadBlock - observation.sync.indexedBlock
+            : 0n;
+        const ahead = observation.sync.indexedBlock > observation.sync.chainHeadBlock
+            ? observation.sync.indexedBlock - observation.sync.chainHeadBlock
+            : 0n;
+        if (observation.sync.state === 'rebuilding' || lag > 1n || ahead > 0n) {
+            const distance = ahead > 0n ? `${ahead} block(s) ahead` : `${lag} block(s) behind`;
+            throw new AgentError('indexer_lagging', `Indexer is ${observation.sync.state} and ${distance}; writes are paused`);
+        }
+    }
+    async simulateAction(actionId) {
+        const observation = await this.observe();
+        this.assertIndexerUsable(observation);
+        const ticket = this.catalog.resolve(actionId, observation);
+        await this.policy.assertAllowed(ticket, observation);
+        const simulation = await this.executor.simulate(ticket.action);
+        await this.audit.record({ type: 'simulation', actionId, action: ticket.action.kind, round: observation.round.toString(), status: 'passed' });
+        return { action: ticket, ...simulation };
+    }
+    async executeAction(actionId) {
+        const observation = await this.observe();
+        this.assertIndexerUsable(observation);
+        const ticket = this.catalog.resolve(actionId, observation);
+        await this.policy.assertAllowed(ticket, observation);
+        this.catalog.consume(actionId, observation);
+        try {
+            const result = await this.executor.execute(ticket.action);
+            await this.audit.record({
+                type: 'transaction', actionId, action: ticket.action.kind, round: observation.round.toString(),
+                amountG: ticket.action.kind === 'bet' ? ticket.action.amountG.toString() : undefined,
+                status: 'complete', detail: { hashes: result.hashes, blockNumber: result.blockNumber.toString(), indexing: result.indexing },
+            });
+            return result;
+        }
+        catch (error) {
+            await this.audit.record({ type: 'error', actionId, action: ticket.action.kind, round: observation.round.toString(), status: 'failed' });
+            throw error;
+        }
+    }
+    getPolicy() {
+        return this.policy.current();
+    }
+    async setPolicy(next) {
+        const validated = parseConfig(JSON.parse(stringifyJson({ ...this.config, policy: next })));
+        await this.persistConfig(validated);
+        this.config = validated;
+        this.policy = new PolicyEngine(validated.policy, this.audit);
+        await this.audit.record({ type: 'policy', status: 'updated' });
+        return this.getPolicy();
+    }
+    activity(limit) {
+        return this.audit.recent(limit);
+    }
+    async runOnce() {
+        if (await this.state.paused())
+            throw new AgentError('runner_paused', 'Runner is paused');
+        const action = conservativeAction(await this.getLegalActions());
+        return action ? this.executeAction(action.actionId) : null;
+    }
+    async start() {
+        await this.state.setPaused(false);
+        if (!this.loop)
+            this.scheduleLoop(0);
+        return this.status();
+    }
+    async pause() {
+        await this.state.setPaused(true);
+        if (this.loop)
+            clearTimeout(this.loop);
+        this.loop = null;
+        return this.status();
+    }
+    scheduleLoop(delay) {
+        this.loop = setTimeout(async () => {
+            if (this.loopInFlight || await this.state.paused())
+                return;
+            this.loopInFlight = true;
+            let nextDelay = this.config.runner.pollIntervalMs;
+            try {
+                await this.runOnce();
+                this.consecutiveLoopFailures = 0;
+            }
+            catch (error) {
+                this.consecutiveLoopFailures += 1;
+                const safe = sanitizedError(error);
+                nextDelay = Math.min(this.config.runner.pollIntervalMs * (2 ** Math.min(this.consecutiveLoopFailures, 8)), 60_000);
+                await this.audit.record({ type: 'error', status: 'loop_failed', detail: { code: safe.code, message: safe.message, retryInMs: nextDelay } });
+            }
+            finally {
+                this.loopInFlight = false;
+                if (!(await this.state.paused()))
+                    this.scheduleLoop(nextDelay);
+            }
+        }, delay);
+        this.loop.unref?.();
+    }
+}
+//# sourceMappingURL=runtime.js.map