@colin999n9/gworld-agent 0.1.0-alpha.0

package/dist/generated/protocol.js

@@ -0,0 +1,132 @@
+// This file is generated by scripts/generate-web-contracts.mjs. Do not edit.
+export const protocolConfig = {
+    activeRadius: 5n,
+    apCheckinCap: 2000n,
+    apRewardMaxCap: 500n,
+    apRewardMinCap: 200n,
+    apRoundSpendCap: 1000n,
+    bpsBase: 10000n,
+    capPerAp: 100n,
+    checkinAmountCap: 200n,
+    checkinCooldownSeconds: 3600n,
+    claimCostCap: 200n,
+    defenseDecayInterval: 3n,
+    defenseFloor: 1n,
+    defenseMax: 20n,
+    distanceFactorBpsPerStep: 5000n,
+    distanceStep: 5n,
+    hexNeighbors: 6n,
+    marketCloseBps: 7500n,
+    maxFragmentBatchSteps: 256n,
+    maxFragmentScan: 1024n,
+    maxMoveSteps: 10n,
+    maxNamedOptions: 7n,
+    maxSpawnPerAction: 6n,
+    maxSyncFragmentScan: 64n,
+    minBetG: 1000000000000000000n,
+    moveCostCap: 100n,
+    reinforceLocalCap: 100n,
+    reinforceRemoteCap: 200n,
+    ringMax: 50n,
+    rngBlockhashWindow: 256n,
+    rngTargetBlockOffset: 1n,
+    settleNMin: 3n,
+    settleNModulo: 6n,
+    tollBps: 1000n,
+    turnBlocks: 100n,
+};
+export const ruleVectors = {
+    attack: [{
+            apCap: 500n,
+            costPerPointCap: 100n,
+            damage: 5n,
+            effectiveDefense: 5n,
+            q: 0,
+            r: 0,
+        }, {
+            apCap: 750n,
+            costPerPointCap: 150n,
+            damage: 5n,
+            effectiveDefense: 5n,
+            q: 5,
+            r: 0,
+        }],
+    claim: [{
+            costCap: 200n,
+            q: 0,
+            r: 0,
+        }, {
+            costCap: 300n,
+            q: 5,
+            r: 0,
+        }],
+    geometry: [{
+            key: 9223372039002259455n,
+            q: -2147483648,
+            r: 2147483647,
+        }, {
+            key: 18446744073709551615n,
+            q: -1,
+            r: -1,
+        }, {
+            key: 0n,
+            q: 0,
+            r: 0,
+        }, {
+            key: 18446744065119617027n,
+            q: -2,
+            r: 3,
+        }],
+    move: [{
+            q: 0,
+            r: 0,
+            stepCostCap: 100n,
+            tollCap: 10n,
+        }, {
+            q: 5,
+            r: 0,
+            stepCostCap: 150n,
+            tollCap: 15n,
+        }],
+    reinforce: [{
+            apCap: 500n,
+            costCap: 500n,
+            effectiveDefense: 3n,
+            local: true,
+            pointsToAdd: 5n,
+            q: 0,
+            r: 0,
+        }, {
+            apCap: 1000n,
+            costCap: 900n,
+            effectiveDefense: 3n,
+            local: false,
+            pointsToAdd: 3n,
+            q: 5,
+            r: 0,
+        }],
+};
+export const protocol = protocolConfig;
+export const protocolGoldenVectors = {
+    int32Edges: {
+        key: 9223372039002259455n,
+        q: -2147483648,
+        r: 2147483647,
+    },
+    negative: {
+        key: 18446744073709551615n,
+        q: -1,
+        r: -1,
+    },
+    origin: {
+        key: 0n,
+        q: 0,
+        r: 0,
+    },
+    selectedTile: {
+        key: 18446744065119617027n,
+        q: -2,
+        r: 3,
+    },
+};
+//# sourceMappingURL=protocol.js.map

package/dist/generated/protocol.js.map

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

package/dist/geometry.d.ts

@@ -0,0 +1,24 @@
+import type { Coord } from './domain.js';
+export declare const HEX_DIRECTIONS: readonly [{
+    readonly q: 1;
+    readonly r: 0;
+}, {
+    readonly q: -1;
+    readonly r: 0;
+}, {
+    readonly q: 0;
+    readonly r: 1;
+}, {
+    readonly q: 0;
+    readonly r: -1;
+}, {
+    readonly q: 1;
+    readonly r: -1;
+}, {
+    readonly q: -1;
+    readonly r: 1;
+}];
+export declare function encodeTileKey(q: number, r: number): bigint;
+export declare function hexDistance(left: Coord, right: Coord): number;
+export declare function adjacent(left: Coord, right: Coord): boolean;
+export declare function applyDistanceFactor(baseCostCap: bigint, target: Coord): bigint;

package/dist/geometry.js

@@ -0,0 +1,31 @@
+import { protocolConfig } from './generated/protocol.js';
+export const HEX_DIRECTIONS = [
+    { q: 1, r: 0 },
+    { q: -1, r: 0 },
+    { q: 0, r: 1 },
+    { q: 0, r: -1 },
+    { q: 1, r: -1 },
+    { q: -1, r: 1 },
+];
+export function encodeTileKey(q, r) {
+    if (!Number.isInteger(q) || !Number.isInteger(r))
+        throw new RangeError('Tile coordinates must be integers');
+    return (BigInt.asUintN(32, BigInt(q)) << 32n) | BigInt.asUintN(32, BigInt(r));
+}
+export function hexDistance(left, right) {
+    const dq = left.q - right.q;
+    const dr = left.r - right.r;
+    return Math.max(Math.abs(dq), Math.abs(dr), Math.abs(dq + dr));
+}
+export function adjacent(left, right) {
+    return hexDistance(left, right) === 1;
+}
+export function applyDistanceFactor(baseCostCap, target) {
+    if (baseCostCap === 0n)
+        return 0n;
+    const distance = BigInt(hexDistance(target, { q: 0, r: 0 }));
+    const multiplierInHalves = 2n + distance / protocolConfig.distanceStep;
+    const product = baseCostCap * multiplierInHalves;
+    return product / 2n + product % 2n;
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACd,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACf,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACd,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACf,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACf,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;CACP,CAAC;AAEX,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAC5G,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAW,EAAE,KAAY;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAW,EAAE,KAAY;IAChD,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,MAAa;IACpE,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,EAAE,GAAG,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC;IACvE,MAAM,OAAO,GAAG,WAAW,GAAG,kBAAkB,CAAC;IACjD,OAAO,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,CAAC;AACrC,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,3 @@
+export declare function parseBigInt(value: unknown, label?: string): bigint;
+export declare function jsonSafe<T>(value: T): T;
+export declare function stringifyJson(value: unknown, space?: number): string;

package/dist/json.js

@@ -0,0 +1,14 @@
+const DECIMAL = /^(0|[1-9]\d*)$/;
+export function parseBigInt(value, label = 'bigint') {
+    const normalized = String(value);
+    if (!DECIMAL.test(normalized))
+        throw new TypeError(`${label} must be an unsigned decimal string`);
+    return BigInt(normalized);
+}
+export function jsonSafe(value) {
+    return JSON.parse(JSON.stringify(value, (_key, item) => (typeof item === 'bigint' ? item.toString() : item)));
+}
+export function stringifyJson(value, space) {
+    return JSON.stringify(value, (_key, item) => (typeof item === 'bigint' ? item.toString() : item), space);
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,KAAK,GAAG,QAAQ;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,KAAQ;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,KAAc;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3G,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentRuntime } from '../runner/runtime.js';
+export declare const GWORLD_MCP_TOOLS: readonly ['gworld_status', 'gworld_observe', 'gworld_get_legal_actions', 'gworld_get_activity', 'gworld_get_policy', 'gworld_join', 'gworld_simulate_action', 'gworld_execute_action', 'gworld_set_policy', 'gworld_start', 'gworld_pause'];
+export declare function createGWorldMcpServer(runtime: AgentRuntime): McpServer;

package/dist/mcp/server.js

@@ -0,0 +1,134 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { ALL_ACTIONS } from '../config.js';
+import { jsonSafe, parseBigInt, stringifyJson } from '../json.js';
+import { sanitizedError } from '../errors.js';
+export const GWORLD_MCP_TOOLS = [
+    'gworld_status',
+    'gworld_observe',
+    'gworld_get_legal_actions',
+    'gworld_get_activity',
+    'gworld_get_policy',
+    'gworld_join',
+    'gworld_simulate_action',
+    'gworld_execute_action',
+    'gworld_set_policy',
+    'gworld_start',
+    'gworld_pause',
+];
+const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const writeChain = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true };
+const writeLocal = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+function success(value) {
+    const structuredContent = jsonSafe(value);
+    return { content: [{ type: 'text', text: stringifyJson(structuredContent) }], structuredContent };
+}
+function failure(error) {
+    const safe = sanitizedError(error);
+    return { content: [{ type: 'text', text: stringifyJson(safe) }], isError: true };
+}
+function safeTool(handler) {
+    return async () => {
+        try {
+            return success(await handler());
+        }
+        catch (error) {
+            return failure(error);
+        }
+    };
+}
+export function createGWorldMcpServer(runtime) {
+    const server = new McpServer({ name: 'gworld-agent', version: '0.1.0-alpha.0' }, { instructions: 'Check gworld_status, read the policy, observe, list legal actions, then simulate and execute only by actionId. Never request wallet secrets or arbitrary calldata.' });
+    server.registerTool('gworld_status', {
+        description: 'Read the local GWorld Runner, wallet address, selected Agent, chain, and sync status.',
+        inputSchema: z.object({}), annotations: readOnly,
+    }, safeTool(() => runtime.status()));
+    server.registerTool('gworld_observe', {
+        description: 'Read a compact, current GWorld observation from Indexer data plus strong RPC Agent state.',
+        inputSchema: z.object({}), annotations: readOnly,
+    }, safeTool(() => runtime.observe()));
+    server.registerTool('gworld_get_legal_actions', {
+        description: 'Return short-lived legal action tickets. Only these actionIds may be simulated or executed.',
+        inputSchema: z.object({}), annotations: readOnly,
+    }, safeTool(async () => ({ actions: await runtime.getLegalActions() })));
+    server.registerTool('gworld_get_activity', {
+        description: 'Read sanitized Runner decisions, simulations, transactions, and failures.',
+        inputSchema: z.object({ limit: z.number().int().min(1).max(200).optional() }), annotations: readOnly,
+    }, async ({ limit }) => {
+        try {
+            return success({ events: await runtime.activity(limit) });
+        }
+        catch (error) {
+            return failure(error);
+        }
+    });
+    server.registerTool('gworld_get_policy', {
+        description: 'Read the non-bypassable AP, G, Agent, action, transaction, and risk limits.',
+        inputSchema: z.object({}), annotations: readOnly,
+    }, safeTool(async () => ({ policy: runtime.getPolicy() })));
+    server.registerTool('gworld_join', {
+        description: 'Create or resume this wallet Agent lifecycle, wait for randomness, spawn, and persist the selected Agent.',
+        inputSchema: z.object({}), annotations: writeChain,
+    }, safeTool(() => runtime.join()));
+    server.registerTool('gworld_simulate_action', {
+        description: 'Revalidate policy and simulate a short-lived legal action without signing or broadcasting.',
+        inputSchema: z.object({ actionId: z.string().uuid() }), annotations: readOnly,
+    }, async ({ actionId }) => {
+        try {
+            return success(await runtime.simulateAction(actionId));
+        }
+        catch (error) {
+            return failure(error);
+        }
+    });
+    server.registerTool('gworld_execute_action', {
+        description: 'Revalidate and execute a short-lived legal actionId through policy, simulation, signing, receipt, and indexing.',
+        inputSchema: z.object({ actionId: z.string().uuid() }), annotations: writeChain,
+    }, async ({ actionId }) => {
+        try {
+            return success(await runtime.executeAction(actionId));
+        }
+        catch (error) {
+            return failure(error);
+        }
+    });
+    server.registerTool('gworld_set_policy', {
+        description: 'Replace selected Runner safety limits. Exact G values use base-unit decimal strings.',
+        inputSchema: z.object({
+            maxApPerRoundCap: z.string().regex(/^(0|[1-9]\d*)$/).optional(),
+            maxGBetPerAction: z.string().regex(/^(0|[1-9]\d*)$/).optional(),
+            maxGSpendPerDay: z.string().regex(/^(0|[1-9]\d*)$/).optional(),
+            maxTransactionsPerRound: z.number().int().min(0).max(100).optional(),
+            allowedAgentIds: z.array(z.string().regex(/^[1-9]\d*$/)).optional(),
+            allowedActions: z.array(z.enum(ALL_ACTIONS)).optional(),
+            autoExecuteRisk: z.enum(['low', 'medium', 'high']).optional(),
+        }),
+        annotations: { ...writeLocal, destructiveHint: true },
+    }, async (patch) => {
+        try {
+            const current = runtime.getPolicy();
+            const next = {
+                ...current,
+                ...(patch.maxApPerRoundCap == null ? {} : { maxApPerRoundCap: parseBigInt(patch.maxApPerRoundCap) }),
+                ...(patch.maxGBetPerAction == null ? {} : { maxGBetPerAction: parseBigInt(patch.maxGBetPerAction) }),
+                ...(patch.maxGSpendPerDay == null ? {} : { maxGSpendPerDay: parseBigInt(patch.maxGSpendPerDay) }),
+                ...(patch.maxTransactionsPerRound == null ? {} : { maxTransactionsPerRound: patch.maxTransactionsPerRound }),
+                ...(patch.allowedAgentIds == null ? {} : { allowedAgentIds: patch.allowedAgentIds.map((id) => parseBigInt(id)) }),
+                ...(patch.allowedActions == null ? {} : { allowedActions: patch.allowedActions }),
+                ...(patch.autoExecuteRisk == null ? {} : { autoExecuteRisk: patch.autoExecuteRisk }),
+            };
+            return success({ policy: await runtime.setPolicy(next) });
+        }
+        catch (error) {
+            return failure(error);
+        }
+    });
+    server.registerTool('gworld_start', {
+        description: 'Start the conservative local autonomous Runner loop.', inputSchema: z.object({}), annotations: writeLocal,
+    }, safeTool(() => runtime.start()));
+    server.registerTool('gworld_pause', {
+        description: 'Pause the local autonomous Runner loop without deleting wallet or Agent state.', inputSchema: z.object({}), annotations: writeLocal,
+    }, safeTool(() => runtime.pause()));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function serveMcp(profile?: string): Promise<void>;

package/dist/mcp/stdio.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { pathToFileURL } from 'node:url';
+import { loadConfig } from '../config.js';
+import { createAgentRuntime } from '../factory.js';
+import { loadKeyStore, decryptPrivateKey } from '../wallet/keystore.js';
+import { PasswordManager } from '../wallet/password-store.js';
+import { createGWorldMcpServer } from './server.js';
+export async function serveMcp(profile = 'default') {
+    const config = await loadConfig(profile);
+    const password = await new PasswordManager().unlock(profile, false);
+    const privateKey = await decryptPrivateKey(await loadKeyStore(config.wallet.keystorePath), password);
+    const server = createGWorldMcpServer(createAgentRuntime(config, privateKey));
+    await server.connect(new StdioServerTransport());
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    const profileIndex = process.argv.indexOf('--profile');
+    serveMcp(profileIndex >= 0 ? process.argv[profileIndex + 1] : 'default').catch((error) => {
+        process.stderr.write(`gworld-mcp: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAO,GAAG,SAAS;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runner/audit-store.d.ts

@@ -0,0 +1,27 @@
+import type { ActionKind, AuditEvent } from '../domain.js';
+export interface AuditLog {
+    record(event: Omit<AuditEvent, 'id' | 'at'>): Promise<AuditEvent>;
+    recent(limit?: number): Promise<AuditEvent[]>;
+    gSpentSince(isoTimestamp: string): Promise<bigint>;
+    transactionCount(round: bigint): Promise<number>;
+}
+export declare class FileAuditLog implements AuditLog {
+    private readonly path;
+    private readonly now;
+    constructor(path: string, now?: () => Date);
+    record(event: Omit<AuditEvent, 'id' | 'at'>): Promise<AuditEvent>;
+    recent(limit?: number): Promise<AuditEvent[]>;
+    private readAll;
+    gSpentSince(isoTimestamp: string): Promise<bigint>;
+    transactionCount(round: bigint): Promise<number>;
+}
+export declare class MemoryAuditLog implements AuditLog {
+    readonly events: AuditEvent[];
+    record(event: Omit<AuditEvent, 'id' | 'at'>): Promise<AuditEvent>;
+    recent(limit?: number): Promise<AuditEvent[]>;
+    gSpentSince(isoTimestamp: string): Promise<bigint>;
+    transactionCount(round: bigint): Promise<number>;
+}
+export declare function actionAmountG(action: {
+    kind: ActionKind;
+} & Record<string, unknown>): bigint;

package/dist/runner/audit-store.js

@@ -0,0 +1,61 @@
+import { randomUUID } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { appendPrivateFile } from '../fs.js';
+export class FileAuditLog {
+    path;
+    now;
+    constructor(path, now = () => new Date()) {
+        this.path = path;
+        this.now = now;
+    }
+    async record(event) {
+        const full = { id: randomUUID(), at: this.now().toISOString(), ...event };
+        await appendPrivateFile(this.path, `${JSON.stringify(full)}\n`);
+        return full;
+    }
+    async recent(limit = 50) {
+        return (await this.readAll()).slice(-Math.max(0, Math.min(limit, 500))).reverse();
+    }
+    async readAll() {
+        try {
+            const lines = (await readFile(this.path, 'utf8')).trim().split('\n').filter(Boolean);
+            return lines.map((line) => JSON.parse(line));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+    }
+    async gSpentSince(isoTimestamp) {
+        return (await this.readAll()).reduce((sum, event) => event.type === 'transaction' && event.status === 'complete' && event.at >= isoTimestamp && event.amountG
+            ? sum + BigInt(event.amountG)
+            : sum, 0n);
+    }
+    async transactionCount(round) {
+        return (await this.readAll()).filter((event) => event.type === 'transaction' && event.status === 'complete' && event.round === round.toString()).length;
+    }
+}
+export class MemoryAuditLog {
+    events = [];
+    async record(event) {
+        const full = { id: randomUUID(), at: new Date().toISOString(), ...event };
+        this.events.push(full);
+        return full;
+    }
+    async recent(limit = 50) {
+        return this.events.slice(-limit).reverse();
+    }
+    async gSpentSince(isoTimestamp) {
+        return this.events.reduce((sum, event) => event.type === 'transaction' && event.status === 'complete' && event.at >= isoTimestamp && event.amountG
+            ? sum + BigInt(event.amountG)
+            : sum, 0n);
+    }
+    async transactionCount(round) {
+        return this.events.filter((event) => event.type === 'transaction' && event.status === 'complete' && event.round === String(round)).length;
+    }
+}
+export function actionAmountG(action) {
+    return action.kind === 'bet' && typeof action.amountG === 'bigint' ? action.amountG : 0n;
+}
+//# sourceMappingURL=audit-store.js.map

package/dist/runner/audit-store.js.map

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

package/dist/runner/file-state.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeStateStore } from './runtime.js';
+export declare class FileRuntimeState implements RuntimeStateStore {
+    private readonly path;
+    constructor(path: string);
+    paused(): Promise<boolean>;
+    setPaused(paused: boolean): Promise<void>;
+}

package/dist/runner/file-state.js

@@ -0,0 +1,23 @@
+import { readFile } from 'node:fs/promises';
+import { atomicWritePrivateFile } from '../fs.js';
+export class FileRuntimeState {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async paused() {
+        try {
+            const value = JSON.parse(await readFile(this.path, 'utf8'));
+            return value.paused !== false;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return true;
+            throw error;
+        }
+    }
+    async setPaused(paused) {
+        await atomicWritePrivateFile(this.path, `${JSON.stringify({ version: 1, paused })}\n`);
+    }
+}
+//# sourceMappingURL=file-state.js.map

package/dist/runner/file-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-state.js","sourceRoot":"","sources":["../../src/runner/file-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlD,MAAM,OAAO,gBAAgB;IACE,IAAI;IAAjC,YAA6B,IAAY;oBAAZ,IAAI;IAAW,CAAC;IAE7C,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;YACpF,OAAO,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAe;QAC7B,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC;CACF"}

package/dist/runner/legal-actions.d.ts

@@ -0,0 +1,22 @@
+import type { GameAction, LegalAction, Observation, Risk, RunnerPolicy } from '../domain.js';
+type Candidate = {
+    action: GameAction;
+    risk: Risk;
+    reason: string;
+};
+export declare class ActionCatalog {
+    private readonly ttlMs;
+    private readonly now;
+    private readonly tickets;
+    constructor(ttlMs: number, now?: () => number);
+    issue(observation: Observation, candidates: Candidate[]): LegalAction[];
+    resolve(actionId: string, observation: Observation): LegalAction;
+    consume(actionId: string, observation: Observation): LegalAction;
+    private prune;
+}
+export declare class LegalActionPlanner {
+    private readonly catalog;
+    constructor(catalog: ActionCatalog);
+    plan(observation: Observation, policy: RunnerPolicy): LegalAction[];
+}
+export {};