@your-world/cli 0.1.0

package/dist/runtime/settlement-sync.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementSync = void 0;
+class SettlementSync {
+    store;
+    client;
+    constructor(store, client) {
+        this.store = store;
+        this.client = client;
+    }
+    async syncLatestSettlement() {
+        const lastAction = await this.store.readLastAction();
+        if (!lastAction || lastAction.response.startTick === undefined) {
+            return null;
+        }
+        const existing = await this.store.readLastSettlement();
+        if (existing && existing.actionId === lastAction.actionId) {
+            return existing;
+        }
+        const result = await this.client.getEvents(Math.max(-1, lastAction.response.startTick - 1), 200);
+        const actionEvents = result.events.filter((event) => event.actionId === lastAction.actionId);
+        if (actionEvents.length === 0) {
+            return null;
+        }
+        const settlement = summarizeSettlement(lastAction.action.verb, lastAction.actionId, actionEvents);
+        await this.store.writeLastSettlement(settlement);
+        return settlement;
+    }
+}
+exports.SettlementSync = SettlementSync;
+function summarizeSettlement(verb, actionId, events) {
+    const rejected = events.find((event) => event.type === 'action_rejected');
+    if (rejected) {
+        const code = typeof rejected.data.code === 'string' ? rejected.data.code : undefined;
+        const reason = typeof rejected.data.reason === 'string' ? rejected.data.reason : undefined;
+        return {
+            tick: rejected.tick,
+            actionId,
+            status: 'rejected',
+            verb,
+            summary: reason ? `${verb} rejected: ${reason}` : `${verb} rejected`,
+            code,
+            reason,
+        };
+    }
+    const accepted = events.find((event) => event.type === 'action_accepted');
+    const detailEvent = events.find((event) => event.type !== 'action_accepted');
+    return {
+        tick: (detailEvent ?? accepted ?? events[0]).tick,
+        actionId,
+        status: 'accepted',
+        verb,
+        summary: detailEvent ? summarizeAcceptedEvent(detailEvent) : `${verb} accepted`,
+    };
+}
+function summarizeAcceptedEvent(event) {
+    switch (event.type) {
+        case 'move': {
+            const x = typeof event.data.toX === 'number' ? event.data.toX : undefined;
+            const y = typeof event.data.toY === 'number' ? event.data.toY : undefined;
+            return x === undefined || y === undefined ? 'move succeeded' : `move to (${x}, ${y}) succeeded`;
+        }
+        case 'gather': {
+            const itemId = typeof event.data.itemId === 'string' ? event.data.itemId : 'item';
+            const amount = typeof event.data.amount === 'number' ? event.data.amount : 1;
+            return `gathered ${amount} ${itemId}`;
+        }
+        case 'process': {
+            const recipeId = typeof event.data.recipeId === 'string' ? event.data.recipeId : 'recipe';
+            return `processed ${recipeId}`;
+        }
+        case 'build': {
+            const structureType = typeof event.data.structureType === 'string' ? event.data.structureType : 'structure';
+            return `built ${structureType}`;
+        }
+        default:
+            return `${event.type} succeeded`;
+    }
+}
+//# sourceMappingURL=settlement-sync.js.map

package/dist/runtime/settlement-sync.js.map

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

package/dist/runtime/turn-orchestrator.d.ts

@@ -0,0 +1,10 @@
+import { WorldClientLike } from '../types';
+import { PlayerRuntimeSession, TickInboxRecord, TurnSnapshot } from './runtime-types';
+import { SessionStore } from './session-store';
+export declare class TurnOrchestrator {
+    private readonly store;
+    private readonly client;
+    constructor(store: SessionStore, client: WorldClientLike);
+    prefetchTick(tick: number): Promise<TickInboxRecord>;
+    buildTurnSnapshot(session: PlayerRuntimeSession, runId: string, tickInbox: TickInboxRecord): Promise<TurnSnapshot>;
+}

package/dist/runtime/turn-orchestrator.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnOrchestrator = void 0;
+class TurnOrchestrator {
+    store;
+    client;
+    constructor(store, client) {
+        this.store = store;
+        this.client = client;
+    }
+    async prefetchTick(tick) {
+        const [observe, events] = await Promise.all([this.client.observe(tick), this.client.getEvents(Math.max(-1, tick - 10), 50)]);
+        return {
+            tick,
+            observe,
+            events: events.events,
+            recordedAt: new Date().toISOString(),
+        };
+    }
+    async buildTurnSnapshot(session, runId, tickInbox) {
+        const [lastAction, lastSettlement] = await Promise.all([this.store.readLastAction(), this.store.readLastSettlement()]);
+        return {
+            runId,
+            contextTick: tickInbox.tick,
+            goal: session.goal,
+            agentId: session.agentId,
+            serverUrl: session.serverUrl,
+            tickIntervalMs: session.tickPollIntervalMs,
+            observeSummary: tickInbox.observe,
+            recentEvents: tickInbox.events,
+            lastAction,
+            lastSettlement,
+            submissionState: {
+                hasSubmitted: session.runState === 'submitted',
+                activeRunId: session.activeRunId,
+                runState: session.runState,
+            },
+            latestObservedTickAtStart: session.latestObservedTick,
+        };
+    }
+}
+exports.TurnOrchestrator = TurnOrchestrator;
+//# sourceMappingURL=turn-orchestrator.js.map

package/dist/runtime/turn-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-orchestrator.js","sourceRoot":"","sources":["../../src/runtime/turn-orchestrator.ts"],"names":[],"mappings":";;;AAIA,MAAa,gBAAgB;IAEJ;IACA;IAFrB,YACqB,KAAmB,EACnB,MAAuB;QADvB,UAAK,GAAL,KAAK,CAAc;QACnB,WAAM,GAAN,MAAM,CAAiB;IACzC,CAAC;IAEJ,KAAK,CAAC,YAAY,CAAC,IAAY;QAC3B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7H,OAAO;YACH,IAAI;YACJ,OAAO;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAA6B,EAAE,KAAa,EAAE,SAA0B;QAC5F,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QAEvH,OAAO;YACH,KAAK;YACL,WAAW,EAAE,SAAS,CAAC,IAAI;YAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,kBAAkB;YAC1C,cAAc,EAAE,SAAS,CAAC,OAAO;YACjC,YAAY,EAAE,SAAS,CAAC,MAAM;YAC9B,UAAU;YACV,cAAc;YACd,eAAe,EAAE;gBACb,YAAY,EAAE,OAAO,CAAC,QAAQ,KAAK,WAAW;gBAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC7B;YACD,yBAAyB,EAAE,OAAO,CAAC,kBAAkB;SACxD,CAAC;IACN,CAAC;CACJ;AAvCD,4CAuCC"}

package/dist/runtime/workspace-manager.d.ts

@@ -0,0 +1,9 @@
+import { PlayerRuntimeSession, TickInboxRecord, TurnSnapshot } from './runtime-types';
+import { SessionStore } from './session-store';
+export declare class WorkspaceManager {
+    private readonly store;
+    constructor(store: SessionStore);
+    ensureWorkspace(session: PlayerRuntimeSession): Promise<void>;
+    writeInbox(record: TickInboxRecord): Promise<void>;
+    writeTurn(runId: string, snapshot: TurnSnapshot): Promise<void>;
+}

package/dist/runtime/workspace-manager.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceManager = void 0;
+const promises_1 = require("node:fs/promises");
+const agents_template_1 = require("../prompting/agents-template");
+const turn_summary_1 = require("../prompting/turn-summary");
+class WorkspaceManager {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async ensureWorkspace(session) {
+        await this.store.ensureWorkspace();
+        await (0, promises_1.writeFile)(this.store.paths.agents, (0, agents_template_1.renderAgentsTemplate)({
+            profile: session.profile,
+            goal: session.goal,
+            workDir: session.workDir,
+        }), 'utf8');
+    }
+    async writeInbox(record) {
+        await this.store.writeInboxTick(record);
+    }
+    async writeTurn(runId, snapshot) {
+        await this.store.writeTurnSnapshot(runId, snapshot, (0, turn_summary_1.renderTurnSummary)(snapshot));
+    }
+}
+exports.WorkspaceManager = WorkspaceManager;
+//# sourceMappingURL=workspace-manager.js.map

package/dist/runtime/workspace-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.js","sourceRoot":"","sources":["../../src/runtime/workspace-manager.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAE7C,kEAAoE;AACpE,4DAA8D;AAI9D,MAAa,gBAAgB;IACI;IAA7B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEpD,KAAK,CAAC,eAAe,CAAC,OAA6B;QAC/C,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QACnC,MAAM,IAAA,oBAAS,EACX,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EACvB,IAAA,sCAAoB,EAAC;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B,CAAC,EACF,MAAM,CACT,CAAC;IACN,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAuB;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,QAAsB;QACjD,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAA,gCAAiB,EAAC,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC;CACJ;AAvBD,4CAuBC"}

package/dist/types.d.ts

@@ -0,0 +1,273 @@
+export interface Action {
+    actionId?: string;
+    verb: string;
+    target?: string | number | Record<string, unknown>;
+    params?: Record<string, unknown>;
+    reason?: string;
+}
+export interface ActRequest extends Action {
+    basedOnTick?: number;
+    intendedStartTick?: number;
+}
+export interface InventoryItem {
+    itemId: string;
+    amount: number;
+    tags?: string[];
+    toolType?: 'axe' | 'pickaxe' | 'drill';
+    miningPower?: number;
+    durability?: number;
+    maxDurability?: number;
+}
+export interface NearbyResource {
+    resourceId: string;
+    resourceTypeId?: string;
+    nodeArchetypeId?: string;
+    itemId?: string;
+    miningDifficulty?: number;
+    position?: {
+        x: number;
+        y: number;
+    };
+    amount?: number;
+    distance?: number;
+}
+export interface NearbyStructure {
+    structureId: string;
+    type?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    hp?: number;
+    passable?: boolean;
+    gateOpen?: boolean;
+    distance?: number;
+}
+export interface NearbyAgent {
+    agentId: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    hunger?: number;
+    stamina?: number;
+    talents?: Record<string, {
+        baseLevel: number;
+        level: number;
+        xp: number;
+        practiceCapLevel: number;
+    }>;
+    distance?: number;
+}
+export interface VisibleTrade {
+    tradeId: string;
+    creatorAgentId: string;
+    toAgentId?: string;
+    status?: 'open' | 'accepted' | 'cancelled' | string;
+    createdAtTick?: number;
+    expiresAtTick?: number;
+    ticksUntilExpire?: number;
+    give?: InventoryItem[];
+    receive?: InventoryItem[];
+    canAccept?: boolean;
+    canCancel?: boolean;
+    acceptRequirementsMet?: boolean;
+}
+export interface ObserveResponse {
+    tick: number;
+    map?: {
+        width: number;
+        height: number;
+    };
+    position?: {
+        x: number;
+        y: number;
+    };
+    hunger?: number;
+    stamina?: number;
+    inventory?: InventoryItem[];
+    talents?: Record<string, {
+        baseLevel: number;
+        level: number;
+        xp: number;
+        practiceCapLevel: number;
+    }>;
+    nearbyResources?: NearbyResource[];
+    nearbyStructures?: NearbyStructure[];
+    nearbyAgents?: NearbyAgent[];
+    visibleTrades?: VisibleTrade[];
+    adjacentTiles?: Array<{
+        x: number;
+        y: number;
+        withinMap: boolean;
+        terrain?: string;
+        occupiedBy?: {
+            kind: 'resource' | 'structure' | 'agent';
+            id: string;
+            type?: string;
+        };
+        canMove: boolean;
+        canBuild: boolean;
+    }>;
+    buildableAdjacentTargets?: Array<{
+        x: number;
+        y: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface TickSignal {
+    tick: number;
+    tickIntervalMs?: number;
+    nextTickAt?: string;
+    serverTime?: string;
+    [key: string]: unknown;
+}
+export interface TickInfoResponse {
+    currentTick: number;
+    tickIntervalMs: number;
+    nextTickAt: string;
+    serverTime: string;
+}
+export interface JoinRequest {
+    agentId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface JoinResponse {
+    agentId: string;
+    acceptedAtTick?: number;
+    [key: string]: unknown;
+}
+export interface PlayerInitRequest {
+    playerName?: string;
+}
+export interface PlayerInitResponse {
+    playerId: string;
+    playerCredential: string;
+}
+export interface PlayerAgentCreateRequest {
+    agentName?: string;
+}
+export interface PlayerAgentCreateResponse {
+    playerId: string;
+    agentId: string;
+    agentToken: string;
+}
+export interface ActResponse {
+    accepted?: boolean;
+    reason?: string;
+    startTick?: number;
+    duplicate?: boolean;
+    currentTick?: number;
+    basedOnTick?: number;
+    intendedStartTick?: number;
+    lateSubmission?: boolean;
+    [key: string]: unknown;
+}
+export interface WorldEvent {
+    eventId: string;
+    tick: number;
+    type: string;
+    actorId?: string;
+    actionId?: string;
+    data: Record<string, unknown>;
+}
+export interface EventQueryResult {
+    events: WorldEvent[];
+    nextCursor: number;
+}
+export type ToolQueryValue = string | number | boolean | undefined;
+export interface ToolQuery {
+    [key: string]: ToolQueryValue;
+}
+export interface ConditionalRequestOptions {
+    etag?: string;
+    version?: string;
+}
+export interface ToolReadResponse<T> {
+    status: number;
+    etag?: string;
+    version?: string;
+    body?: T;
+}
+export interface WorldClientRoutes {
+    playerInit: string;
+    playerAgents: string;
+    join: string;
+    observe: string;
+    act: string;
+    nextTick: string;
+    tickInfo: string;
+    events: string;
+    catalog: string;
+    rules: string;
+}
+export interface WorldClientOptions {
+    baseUrl: string;
+    agentId?: string;
+    token?: string;
+    routes?: Partial<WorldClientRoutes>;
+    fetchImpl?: typeof fetch;
+}
+export interface Logger {
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+}
+export interface CatalogTools {
+    getArchetype(id: string): Promise<unknown>;
+    searchArchetypes(query: string): Promise<unknown>;
+    getRecipe(id: string): Promise<unknown>;
+    searchRecipes(query: string): Promise<unknown>;
+}
+export interface RulesTools {
+    getVerbSpec(verb: string): Promise<unknown>;
+    explainError(code: string): Promise<unknown>;
+}
+export interface AgentTools {
+    observe(): Promise<ObserveResponse>;
+    events(afterTick?: number, limit?: number): Promise<EventQueryResult>;
+    catalog: CatalogTools;
+    rules: RulesTools;
+}
+export interface CacheEntry<T> {
+    etag?: string;
+    version?: string;
+    value: T;
+}
+export interface ToolCacheStore {
+    catalog: Map<string, CacheEntry<unknown>>;
+    rules: Map<string, CacheEntry<unknown>>;
+}
+export interface TickContext {
+    readonly tick: number;
+    readonly goal: string;
+    readonly agentId: string;
+    readonly tools: AgentTools;
+    observe(): Promise<ObserveResponse>;
+    remember(key: string, value: unknown): void;
+    recall<T = unknown>(key: string): T | undefined;
+    hasCommitted(): boolean;
+    commit(action: Action): Promise<void>;
+}
+export type Policy = (context: TickContext) => Promise<Action | null | void> | Action | null | void;
+export interface TickRunnerOptions {
+    client: WorldClientLike;
+    policy: Policy;
+    goal: string;
+    logger?: Logger;
+    pollIntervalMs?: number;
+}
+export interface WorldClientLike {
+    readonly agentId?: string;
+    playerInit(input: PlayerInitRequest): Promise<PlayerInitResponse>;
+    createPlayerAgent(playerCredential: string, input: PlayerAgentCreateRequest): Promise<PlayerAgentCreateResponse>;
+    join(input?: JoinRequest): Promise<JoinResponse>;
+    observe(asOfTick?: number): Promise<ObserveResponse>;
+    act(action: ActRequest): Promise<ActResponse>;
+    getTickInfo(): Promise<TickInfoResponse>;
+    getCatalog(params: ToolQuery, options?: ConditionalRequestOptions): Promise<ToolReadResponse<unknown>>;
+    getRules(params: ToolQuery, options?: ConditionalRequestOptions): Promise<ToolReadResponse<unknown>>;
+    getEvents(afterTick?: number, limit?: number): Promise<EventQueryResult>;
+    waitForNextTick(afterTick: number, pollIntervalMs?: number, signal?: AbortSignal): Promise<TickSignal>;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/world-client.d.ts

@@ -0,0 +1,31 @@
+import { ActRequest, ActResponse, ConditionalRequestOptions, EventQueryResult, JoinRequest, JoinResponse, ObserveResponse, PlayerAgentCreateRequest, PlayerAgentCreateResponse, PlayerInitRequest, PlayerInitResponse, TickInfoResponse, TickSignal, ToolQuery, ToolReadResponse, WorldClientOptions } from './types';
+export declare class WorldClientError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, status: number, code?: string, details?: unknown);
+}
+export declare class WorldClient {
+    private readonly baseUrl;
+    private readonly token?;
+    private readonly fetchImpl;
+    private readonly routes;
+    private _agentId?;
+    constructor(options: WorldClientOptions);
+    get agentId(): string | undefined;
+    playerInit(input: PlayerInitRequest): Promise<PlayerInitResponse>;
+    createPlayerAgent(playerCredential: string, input: PlayerAgentCreateRequest): Promise<PlayerAgentCreateResponse>;
+    join(input?: JoinRequest): Promise<JoinResponse>;
+    observe(asOfTick?: number): Promise<ObserveResponse>;
+    act(action: ActRequest): Promise<ActResponse>;
+    getTickInfo(): Promise<TickInfoResponse>;
+    getCatalog(params: ToolQuery, options?: ConditionalRequestOptions): Promise<ToolReadResponse<unknown>>;
+    getRules(params: ToolQuery, options?: ConditionalRequestOptions): Promise<ToolReadResponse<unknown>>;
+    getEvents(afterTick?: number, limit?: number): Promise<EventQueryResult>;
+    nextTick(afterTick: number): Promise<TickSignal>;
+    waitForNextTick(afterTick: number, pollIntervalMs?: number, signal?: AbortSignal): Promise<TickSignal>;
+    private request;
+    private conditionalRead;
+    private requestRaw;
+    private buildUrl;
+}