@your-world/cli 0.1.8 → 0.1.10

package/dist/generated/common/types.d.ts

@@ -0,0 +1,1102 @@
+import { AgentTalents, AgentTalentViews, TalentId } from './talents';
+export type Direction = 'north' | 'east' | 'south' | 'west';
+export type WorldVerb = 'move' | 'gather' | 'plant' | 'harvest' | 'consume' | 'process' | 'build' | 'supply' | 'construct' | 'transfer' | 'execute_contract' | 'trade_create' | 'trade_accept' | 'trade_cancel' | 'attack' | 'create_organization' | 'invite_to_organization' | 'accept_organization_invite' | 'set_recipe' | 'set_contract' | 'start_work' | 'stop_work';
+export declare const WORLD_VERBS: readonly ["move", "gather", "plant", "harvest", "consume", "process", "build", "supply", "construct", "transfer", "execute_contract", "trade_create", "trade_accept", "trade_cancel", "attack", "create_organization", "invite_to_organization", "accept_organization_invite", "set_recipe", "set_contract", "start_work", "stop_work"];
+export declare function isWorldVerb(input: string): input is WorldVerb;
+export type WithdrawLevel = 'owner' | 'organization' | 'public';
+export type OwnerRef = {
+    kind: 'agent';
+    agentId: string;
+} | {
+    kind: 'organization';
+    organizationId: string;
+};
+export type PartyRef = OwnerRef;
+export interface AssetOwnership {
+    ownerRef: OwnerRef;
+    withdrawLevel: WithdrawLevel;
+}
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface Footprint {
+    width: number;
+    height: number;
+}
+export type TerrainType = 'forest' | 'plain' | 'mountain' | 'water';
+export declare const TERRAIN_TYPES: readonly ["forest", "plain", "mountain", "water"];
+export declare function isTerrainType(value: string): value is TerrainType;
+export interface StructureTraversal {
+    passable: boolean;
+}
+export interface StorageSpec {
+    capacityGrams: number;
+}
+export interface StructureCapabilities {
+    canProcess?: boolean;
+    canBuildStarter?: boolean;
+    canTransfer?: boolean;
+}
+export type StructureBehavior = {
+    kind: 'static';
+} | {
+    kind: 'gate';
+    defaultOpen: boolean;
+    openPassable: boolean;
+    closedPassable: boolean;
+};
+export interface StructureRender {
+    tileId?: number;
+    connectionGroup?: string;
+    variant?: 'default' | 'wall' | 'gate';
+}
+export type StructureRuntimeState = {
+    kind: 'static';
+} | {
+    kind: 'gate';
+    open: boolean;
+};
+export interface ItemStack {
+    itemId: string;
+    amount: number;
+    tags?: string[];
+    toolType?: 'axe' | 'pickaxe' | 'drill';
+    gatherBonus?: number;
+    miningPower?: number;
+    durability?: number;
+    maxDurability?: number;
+}
+export interface AgentState {
+    agentId: string;
+    position: Position;
+    hunger: number;
+    stamina: number;
+    inventory: ItemStack[];
+    talents: AgentTalents;
+}
+export interface ResourceNode {
+    resourceId: string;
+    resourceTypeId: string;
+    nodeArchetypeId: string;
+    itemId: string;
+    miningDifficulty?: number;
+    position: Position;
+    amount: number;
+    maxAmount: number;
+    regenPerTick: number;
+    regenIntervalTicks?: number;
+    renderTileId?: number;
+}
+export type CropStageId = 'growing' | 'mature';
+export declare const CROP_STAGE_IDS: readonly ["growing", "mature"];
+export declare function isCropStageId(value: string): value is CropStageId;
+export interface CropState {
+    cropId: string;
+    cropTypeId: string;
+    position: Position;
+    plantedTick: number;
+    matureTick: number;
+    stage: CropStageId;
+}
+export interface StructureState {
+    structureId: string;
+    structureTypeId: string;
+    origin: Position;
+    footprint: Footprint;
+    position: Position;
+    sourceBuildRecipeId?: string;
+    builderAgentId?: string;
+    ownerAgentId?: string;
+    ownerRef?: OwnerRef;
+    withdrawLevel?: WithdrawLevel;
+    hp: number;
+    inventory: ItemStack[];
+    state?: StructureRuntimeState;
+}
+export type BuildingProjectStage = 'frame' | 'supplied' | 'completed' | 'expired';
+export interface BuildingProject {
+    projectId: string;
+    recipeId: string;
+    targetStructureTypeId: string;
+    origin: Position;
+    footprint: Footprint;
+    requiredInputs: ItemStack[];
+    deliveredInputs: ItemStack[];
+    requiredWork: number;
+    currentWork: number;
+    stage: BuildingProjectStage;
+    createdAtTick: number;
+    lastUpdatedTick: number;
+    builderAgentId: string;
+    ownerRef?: OwnerRef;
+    withdrawLevel?: WithdrawLevel;
+    frameReservationTicks: number;
+    reservedUntilTick: number;
+    completedStructureId?: string;
+}
+export type OrganizationRole = 'owner' | 'member';
+export interface Organization {
+    organizationId: string;
+    name: string;
+    ownerAgentId: string;
+    createdAtTick: number;
+    memberAgentIds: string[];
+}
+export interface OrganizationMember {
+    organizationId: string;
+    agentId: string;
+    role: OrganizationRole;
+    joinedAtTick: number;
+}
+export interface OrganizationInvite {
+    organizationId: string;
+    targetAgentId: string;
+    invitedByAgentId: string;
+    createdAtTick: number;
+}
+export interface FactoryWorkerAssignment {
+    agentId: string;
+    startedAtTick: number;
+    contractId?: string;
+    partyRef?: PartyRef;
+}
+export interface Factory {
+    factoryId: string;
+    ownerRef: OwnerRef;
+    structureTypeId: string;
+    activeRecipeId?: string;
+    activeContractDefinitionIds: string[];
+    minWorkersToRun: number;
+    maxWorkers: number;
+    assignedWorkerAgentIds: string[];
+    workerAssignments?: Record<string, FactoryWorkerAssignment>;
+    lastProcessedTick?: number;
+    lastTickRuns?: number;
+    lastTickConsumed?: ItemStack[];
+    lastTickProduced?: ItemStack[];
+    pendingRecipeId?: string | null;
+    pendingWorkerAssignments?: Record<string, FactoryWorkerAssignment>;
+}
+export type ContractKind = 'supply' | 'employment';
+export type ContractDefinitionStatus = 'draft' | 'open' | 'paused' | 'closed';
+export type ContractInstanceStatus = 'fulfilled' | 'failed';
+export interface EndpointRef {
+    endpointId: string;
+}
+export interface DeliverClause {
+    kind: 'deliver';
+    itemId: string;
+    amount: number;
+    source: EndpointRef;
+    destination: EndpointRef;
+    deliveryWindow: {
+        startTick: number;
+        endTick: number;
+    };
+}
+export interface PayClause {
+    kind: 'pay';
+    itemId: string;
+    amount: number;
+    from: EndpointRef;
+    to: EndpointRef;
+}
+export interface WorkClause {
+    kind: 'work';
+    workType: 'factory-operator';
+    targetFactoryId: string;
+}
+export type ContractClause = DeliverClause | PayClause | WorkClause;
+export interface ContractDefinition {
+    contractId: string;
+    kind: ContractKind;
+    status: ContractDefinitionStatus;
+    issuer: PartyRef;
+    createdAtTick: number;
+    clauses: ContractClause[];
+    linkedFactoryId?: string;
+}
+export interface ContractInstance {
+    contractInstanceId: string;
+    contractId: string;
+    kind: ContractKind;
+    status: ContractInstanceStatus;
+    requester: PartyRef;
+    provider: PartyRef;
+    createdAtTick: number;
+    settledAtTick: number;
+    linkedFactoryId?: string;
+    executionMode: 'explicit' | 'work-tick';
+    failureReason?: string;
+}
+export interface TradeOffer {
+    tradeId: string;
+    creatorAgentId: string;
+    toAgentId?: string;
+    give: ItemStack[];
+    receive: ItemStack[];
+    lockedGive: ItemStack[];
+    status: 'open' | 'accepted' | 'cancelled';
+    createdAtTick: number;
+    expiresAtTick?: number;
+    acceptedAtTick?: number;
+    acceptedByAgentId?: string;
+    cancelledAtTick?: number;
+}
+export interface WorldState {
+    worldId: string;
+    seed: number;
+    rngState: number;
+    catalogBaselineVersion?: string;
+    mapWidth: number;
+    mapHeight: number;
+    terrain: TerrainType[][];
+    tick: number;
+    nextAgentSeq: number;
+    nextStructureSeq: number;
+    nextProjectSeq: number;
+    nextTradeSeq: number;
+    nextCropSeq: number;
+    agents: Record<string, AgentState>;
+    resources: Record<string, ResourceNode>;
+    crops: Record<string, CropState>;
+    structures: Record<string, StructureState>;
+    buildingProjects: Record<string, BuildingProject>;
+    trades: Record<string, TradeOffer>;
+    organizations: Record<string, Organization>;
+    organizationInvites: Record<string, OrganizationInvite>;
+    factories: Record<string, Factory>;
+    contractDefinitions: Record<string, ContractDefinition>;
+    contractInstances: Record<string, ContractInstance>;
+    seenActionIds: Record<string, number>;
+}
+export type ActionObjectTarget = object;
+export type ActionPrimitiveTarget = string | number;
+export type ActionTarget = ActionPrimitiveTarget | ActionObjectTarget;
+export type ActionParams = object;
+interface ActionBase<Verb extends string, Target = never, Params = never> {
+    actionId?: string;
+    verb: Verb;
+    target?: Target;
+    params?: Params;
+    reason?: string;
+}
+export type MoveAction = ActionBase<'move', Position>;
+export type GatherAction = ActionBase<'gather', string | {
+    resourceId?: string;
+}>;
+export type PlantAction = ActionBase<'plant', Position, {
+    cropTypeId?: string;
+}>;
+export type HarvestAction = ActionBase<'harvest', string | Position | {
+    cropId?: string;
+}>;
+export type ConsumeAction = ActionBase<'consume', never, {
+    itemId?: string;
+    amount?: number;
+}>;
+export type ProcessAction = ActionBase<'process', string | {
+    structureId?: string;
+}, {
+    structureId?: string;
+    recipeId?: string;
+    amount?: number;
+}>;
+export type BuildAction = ActionBase<'build', Position, {
+    origin?: Position;
+    recipeId?: string;
+    ownerRef?: OwnerRef;
+    withdrawLevel?: WithdrawLevel;
+}>;
+export type SupplyAction = ActionBase<'supply', string | {
+    projectId?: string;
+}, {
+    projectId?: string;
+    stacks?: ItemStack[];
+}>;
+export type ConstructAction = ActionBase<'construct', string | {
+    projectId?: string;
+}, {
+    projectId?: string;
+}>;
+export type TransferAction = ActionBase<'transfer', string | {
+    structureId?: string;
+}, {
+    structureId?: string;
+    direction?: 'deposit' | 'withdraw';
+    itemId?: string;
+    amount?: number;
+    contractId?: string;
+    partyRef?: PartyRef;
+}>;
+export type ExecuteContractAction = ActionBase<'execute_contract', string | {
+    structureId?: string;
+}, {
+    factoryId?: string;
+    contractId?: string;
+    partyRef?: PartyRef;
+}>;
+export type CreateOrganizationAction = ActionBase<'create_organization', never, {
+    organizationId?: string;
+    name?: string;
+}>;
+export type InviteToOrganizationAction = ActionBase<'invite_to_organization', never, {
+    organizationId?: string;
+    targetAgentId?: string;
+}>;
+export type AcceptOrganizationInviteAction = ActionBase<'accept_organization_invite', never, {
+    organizationId?: string;
+}>;
+export type SetRecipeAction = ActionBase<'set_recipe', string | {
+    structureId?: string;
+}, {
+    factoryId?: string;
+    recipeId?: string;
+}>;
+export interface DeliverClauseInput {
+    kind: 'deliver';
+    itemId?: string;
+    amount?: number;
+    source?: {
+        endpointId?: string;
+    };
+    destination?: {
+        endpointId?: string;
+    };
+    deliveryWindow?: {
+        startTick?: number;
+        endTick?: number;
+    };
+}
+export interface PayClauseInput {
+    kind: 'pay';
+    itemId?: string;
+    amount?: number;
+    from?: {
+        endpointId?: string;
+    };
+    to?: {
+        endpointId?: string;
+    };
+}
+export interface WorkClauseInput {
+    kind: 'work';
+    workType?: 'factory-operator';
+    targetFactoryId?: string;
+}
+export type ContractClauseInput = DeliverClauseInput | PayClauseInput | WorkClauseInput;
+export interface ContractDefinitionInput {
+    contractId?: string;
+    kind?: ContractKind;
+    status?: ContractDefinitionStatus;
+    clauses?: ContractClauseInput[];
+}
+export type SetContractAction = ActionBase<'set_contract', string | {
+    structureId?: string;
+}, {
+    factoryId?: string;
+    definition?: ContractDefinitionInput;
+} & ContractDefinitionInput>;
+export type StartWorkAction = ActionBase<'start_work', string | {
+    structureId?: string;
+}, {
+    factoryId?: string;
+    contractId?: string;
+    partyRef?: PartyRef;
+}>;
+export type StopWorkAction = ActionBase<'stop_work', string | {
+    structureId?: string;
+}, {
+    factoryId?: string;
+}>;
+export type TradeCreateAction = ActionBase<'trade_create', never, {
+    give?: ItemStack[];
+    receive?: ItemStack[];
+    toAgentId?: string;
+    tradeId?: string;
+}>;
+export type TradeAcceptAction = ActionBase<'trade_accept', string | {
+    tradeId?: string;
+}, {
+    tradeId?: string;
+}>;
+export type TradeCancelAction = ActionBase<'trade_cancel', string | {
+    tradeId?: string;
+}, {
+    tradeId?: string;
+}>;
+export type AttackAction = ActionBase<'attack', string | {
+    agentId?: string;
+}>;
+export type KnownAction = MoveAction | GatherAction | PlantAction | HarvestAction | ConsumeAction | ProcessAction | BuildAction | SupplyAction | ConstructAction | TransferAction | ExecuteContractAction | CreateOrganizationAction | InviteToOrganizationAction | AcceptOrganizationInviteAction | SetRecipeAction | SetContractAction | StartWorkAction | StopWorkAction | TradeCreateAction | TradeAcceptAction | TradeCancelAction | AttackAction;
+export type Action = KnownAction;
+export type ActionInput = ActionBase<string, ActionTarget, ActionParams>;
+export interface QueuedAction {
+    actorId: string;
+    submitTick: number;
+    startTick: number;
+    action: Action;
+}
+export declare const WORLD_EVENT_TYPES: readonly ["agent_joined", "action_accepted", "action_ignored", "action_rejected", "move", "gather", "plant", "harvest", "process", "build", "frame_placed", "project_supply_progress", "project_supplied", "construction_progress", "construction_completed", "project_expired", "transfer", "execute_contract", "trade_create", "trade_accept", "trade_cancel", "attack", "crop_grow", "consume", "organization_created", "organization_member_added", "organization_member_role_changed", "asset_withdraw_denied", "factory_created", "factory_recipe_changed", "factory_contract_set", "factory_work_started", "factory_work_stopped", "factory_processed_tick", "contract_definition_created", "contract_definition_opened", "contract_definition_paused", "contract_definition_closed", "contract_instance_created", "contract_instance_settled", "contract_instance_failed", "tick_summary"];
+export type WorldEventType = (typeof WORLD_EVENT_TYPES)[number];
+export declare function isWorldEventType(input: string): input is WorldEventType;
+type EventDataBase = Record<string, unknown>;
+interface WorldEventBase<Type extends WorldEventType, Data extends EventDataBase = EventDataBase> {
+    eventId: string;
+    tick: number;
+    type: Type;
+    actorId?: string;
+    actionId?: string;
+    data: Data;
+}
+export type AgentJoinedEvent = WorldEventBase<'agent_joined', {
+    position: Position;
+    hunger: number;
+    stamina: number;
+    talents: AgentTalentViews;
+} & EventDataBase>;
+export type ActionAcceptedEvent = WorldEventBase<'action_accepted', {
+    verb: WorldVerb;
+} & EventDataBase>;
+export type ActionIgnoredEvent = WorldEventBase<'action_ignored', {
+    verb: WorldVerb;
+    reason: string;
+    factoryId?: string;
+} & EventDataBase>;
+export type ActionRejectedEvent = WorldEventBase<'action_rejected', {
+    code: string;
+    reason: string;
+} & EventDataBase>;
+export type MoveEvent = WorldEventBase<'move', {
+    from: Position;
+    to: Position;
+} & EventDataBase>;
+export type GatherEvent = WorldEventBase<'gather', {
+    resourceId: string;
+    resourceTypeId: string;
+    itemId: string;
+    miningDifficulty: number;
+    amount: number;
+    resourceRemaining: number;
+    position: Position;
+    toolItemId?: string;
+    toolType?: ItemStack['toolType'];
+    toolMiningPower?: number;
+    toolDurabilityAfter?: number;
+    bonusSeed: number;
+    bonusItemId?: string;
+} & EventDataBase>;
+export type PlantEvent = WorldEventBase<'plant', {
+    cropId: string;
+    cropTypeId: string;
+    position: Position;
+    matureTick: number;
+} & EventDataBase>;
+export type HarvestEvent = WorldEventBase<'harvest', {
+    cropId: string;
+    cropTypeId: string;
+    position: Position;
+    outputs: ItemStack[];
+} & EventDataBase>;
+export type ConsumeEvent = WorldEventBase<'consume', {
+    itemId: string;
+    amount: number;
+    consumedAmount: number;
+    spawnedItems: ItemStack[];
+    hungerAfter: number;
+    staminaAfter: number;
+} & EventDataBase>;
+export type ProcessEvent = WorldEventBase<'process', {
+    recipeId: string;
+    amount: number;
+    structureId?: string;
+    inputs: ItemStack[];
+    outputs: ItemStack[];
+    structureTypeId?: string;
+} & EventDataBase>;
+export type TransferEvent = WorldEventBase<'transfer', {
+    structureId: string;
+    direction: 'deposit' | 'withdraw';
+    itemId: string;
+    amount: number;
+    structureInventoryWeightGrams: number;
+} & EventDataBase>;
+export type TradeCreateEvent = WorldEventBase<'trade_create', {
+    tradeId: string;
+    toAgentId?: string;
+    give: ItemStack[];
+    receive: ItemStack[];
+    expiresAtTick?: number;
+} & EventDataBase>;
+export type TradeAcceptEvent = WorldEventBase<'trade_accept', {
+    tradeId: string;
+    creatorAgentId: string;
+    acceptedByAgentId: string;
+    give: ItemStack[];
+    receive: ItemStack[];
+} & EventDataBase>;
+export type TradeCancelEvent = WorldEventBase<'trade_cancel', {
+    tradeId: string;
+    creatorAgentId: string;
+    reason?: string;
+    expiresAtTick?: number;
+} & EventDataBase>;
+export type AttackEvent = WorldEventBase<'attack', {
+    targetAgentId: string;
+    damage: number;
+    attackerStaminaAfter: number;
+    targetStaminaAfter: number;
+    loot?: {
+        itemId: string;
+        amount: number;
+        durability?: number;
+        maxDurability?: number;
+    } | null;
+} & EventDataBase>;
+export type TickSummaryEvent = WorldEventBase<'tick_summary', {
+    tick: number;
+    queuedActions: number;
+    acceptedActions: number;
+    ignoredActions: number;
+    rejectedActions: number;
+    agentCount: number;
+} & EventDataBase>;
+export type LegacyBuildEvent = WorldEventBase<'build', {
+    structureType: string;
+    structureId: string;
+    position?: Position;
+    material?: string;
+    hp?: number;
+} & EventDataBase>;
+type ProjectEventDataBase = {
+    projectId: string;
+    recipeId: string;
+    targetStructureTypeId: string;
+    builderAgentId: string;
+    origin: Position;
+    footprint: Footprint;
+    stage: BuildingProjectStage;
+    deliveredInputs: ItemStack[];
+    requiredInputs: ItemStack[];
+    currentWork: number;
+    requiredWork: number;
+    reservedUntilTick: number;
+} & EventDataBase;
+export type FramePlacedEvent = WorldEventBase<'frame_placed', ProjectEventDataBase>;
+export type ProjectSupplyProgressEvent = WorldEventBase<'project_supply_progress', ProjectEventDataBase & {
+    requestedStacks: ItemStack[];
+    appliedStacks: ItemStack[];
+    unusedStacks: Array<ItemStack & {
+        reason: string;
+    }>;
+    remainingRequiredInputsAfter: ItemStack[];
+    reservedUntilTickAfter: number;
+}>;
+export type ProjectSuppliedEvent = WorldEventBase<'project_supplied', ProjectEventDataBase & {
+    reservedUntilTickAfter: number;
+}>;
+export type ConstructionProgressEvent = WorldEventBase<'construction_progress', ProjectEventDataBase & {
+    workGain: number;
+    currentWorkAfter: number;
+    reservedUntilTickAfter: number;
+}>;
+export type ConstructionCompletedEvent = WorldEventBase<'construction_completed', ProjectEventDataBase & {
+    structureId: string;
+    sourceBuildRecipeId?: string;
+}>;
+export type ProjectExpiredEvent = WorldEventBase<'project_expired', {
+    projectId: string;
+    recipeId: string;
+    targetStructureTypeId: string;
+    builderAgentId: string;
+    origin: Position;
+    footprint: Footprint;
+    deliveredInputs: ItemStack[];
+    currentWork: number;
+    reservedUntilTick: number;
+    stage: Extract<BuildingProjectStage, 'expired'>;
+} & EventDataBase>;
+export type AssetWithdrawDeniedEvent = WorldEventBase<'asset_withdraw_denied', {
+    structureId: string;
+    ownerRef?: OwnerRef;
+    withdrawLevel?: WithdrawLevel;
+} & EventDataBase>;
+export type ExecuteContractEvent = WorldEventBase<'execute_contract', {
+    factoryId: string;
+    contractId: string;
+    contractInstanceId: string;
+} & EventDataBase>;
+export type CropGrowEvent = WorldEventBase<'crop_grow', {
+    cropId: string;
+    cropTypeId: string;
+    stage: CropStageId;
+    position: Position;
+    matureTick: number;
+} & EventDataBase>;
+export type OrganizationCreatedEvent = WorldEventBase<'organization_created', {
+    organizationId: string;
+    name: string;
+    ownerAgentId: string;
+} & EventDataBase>;
+export type OrganizationMemberAddedEvent = WorldEventBase<'organization_member_added', {
+    organizationId: string;
+    agentId: string;
+    role: OrganizationRole;
+    invitedByAgentId: string;
+} & EventDataBase>;
+export type OrganizationMemberRoleChangedEvent = WorldEventBase<'organization_member_role_changed', {
+    organizationId: string;
+    agentId: string;
+    role: OrganizationRole;
+    changedByAgentId: string;
+} & EventDataBase>;
+export type FactoryCreatedEvent = WorldEventBase<'factory_created', {
+    factoryId: string;
+    structureTypeId: string;
+    ownerRef: OwnerRef;
+} & EventDataBase>;
+export type FactoryRecipeChangedEvent = WorldEventBase<'factory_recipe_changed', {
+    factoryId: string;
+    previousRecipeId?: string;
+    pendingRecipeId?: string;
+} & EventDataBase>;
+export type FactoryContractSetEvent = WorldEventBase<'factory_contract_set', {
+    factoryId: string;
+    contractId: string;
+    status: ContractDefinitionStatus;
+} & EventDataBase>;
+export type FactoryWorkStartedEvent = WorldEventBase<'factory_work_started', {
+    factoryId: string;
+    contractId?: string;
+    effectiveAtTick: number;
+} & EventDataBase>;
+export type FactoryWorkStoppedEvent = WorldEventBase<'factory_work_stopped', {
+    factoryId: string;
+    effectiveAtTick: number;
+} & EventDataBase>;
+export type FactoryProcessedTickEvent = WorldEventBase<'factory_processed_tick', {
+    tick: number;
+    factoryId: string;
+    activeRecipeId: string;
+    runsExecuted: number;
+    consumed: ItemStack[];
+    produced: ItemStack[];
+    storageUsedGramsAfterTick: number;
+    workerCount: number;
+} & EventDataBase>;
+type ContractDefinitionLifecycleEventType = 'contract_definition_created' | 'contract_definition_opened' | 'contract_definition_paused' | 'contract_definition_closed';
+export type ContractDefinitionLifecycleEvent = WorldEventBase<ContractDefinitionLifecycleEventType, {
+    contractId: string;
+    kind: ContractKind;
+    status: ContractDefinitionStatus;
+    linkedFactoryId?: string;
+} & EventDataBase>;
+export type ContractInstanceCreatedEvent = WorldEventBase<'contract_instance_created', {
+    contractInstanceId: string;
+    contractId: string;
+    linkedFactoryId?: string;
+    executionMode: ContractInstance['executionMode'];
+} & EventDataBase>;
+export type ContractInstanceSettledEvent = WorldEventBase<'contract_instance_settled', {
+    contractInstanceId: string;
+    contractId: string;
+    linkedFactoryId?: string;
+} & EventDataBase>;
+export type ContractInstanceFailedEvent = WorldEventBase<'contract_instance_failed', {
+    contractInstanceId: string;
+    contractId: string;
+    linkedFactoryId?: string;
+    failureReason?: string;
+} & EventDataBase>;
+type TypedWorldEvent = AgentJoinedEvent | ActionAcceptedEvent | ActionIgnoredEvent | ActionRejectedEvent | MoveEvent | GatherEvent | PlantEvent | HarvestEvent | ConsumeEvent | ProcessEvent | TransferEvent | TradeCreateEvent | TradeAcceptEvent | TradeCancelEvent | AttackEvent | TickSummaryEvent | LegacyBuildEvent | FramePlacedEvent | ProjectSupplyProgressEvent | ProjectSuppliedEvent | ConstructionProgressEvent | ConstructionCompletedEvent | ProjectExpiredEvent | AssetWithdrawDeniedEvent | ExecuteContractEvent | CropGrowEvent | OrganizationCreatedEvent | OrganizationMemberAddedEvent | OrganizationMemberRoleChangedEvent | FactoryCreatedEvent | FactoryRecipeChangedEvent | FactoryContractSetEvent | FactoryWorkStartedEvent | FactoryWorkStoppedEvent | FactoryProcessedTickEvent | ContractDefinitionLifecycleEvent | ContractInstanceCreatedEvent | ContractInstanceSettledEvent | ContractInstanceFailedEvent;
+export type WorldEvent = TypedWorldEvent;
+export type WorldEventData<Type extends WorldEventType> = Extract<WorldEvent, {
+    type: Type;
+}>['data'];
+export interface TickApplyResult {
+    state: WorldState;
+    events: WorldEvent[];
+}
+export interface JoinRequest {
+    agentId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface JoinResponse {
+    agentId: string;
+    acceptedAtTick: number;
+}
+export type ActRequest = Action & {
+    basedOnTick?: number;
+    intendedStartTick?: number;
+};
+export type ActRequestInput = ActionInput & {
+    basedOnTick?: number;
+    intendedStartTick?: number;
+};
+export interface ActResponse {
+    accepted: boolean;
+    reason?: string;
+    startTick?: number;
+    duplicate?: boolean;
+    currentTick?: number;
+    basedOnTick?: number;
+    intendedStartTick?: number;
+    lateSubmission?: boolean;
+}
+export interface ObserveTargetingQuery {
+    archetype?: string;
+    resource?: string;
+}
+export interface ObserveResourceHint {
+    resourceId: string;
+    resourceTypeId: string;
+    nodeArchetypeId: string;
+    itemId: string;
+    position: Position;
+    amount: number;
+    distance: number;
+}
+export type ObserveArchetypeHint = {
+    kind: 'structure';
+    archetypeId: string;
+    structureId: string;
+    structureTypeId: string;
+    origin: Position;
+    footprint: Footprint;
+    position: Position;
+    distance: number;
+} | {
+    kind: 'resource';
+    archetypeId: string;
+    resourceId: string;
+    resourceTypeId: string;
+    nodeArchetypeId: string;
+    itemId: string;
+    position: Position;
+    amount: number;
+    distance: number;
+};
+export interface ObserveResponse {
+    tick: number;
+    agentId: string;
+    map: {
+        width: number;
+        height: number;
+    };
+    position: Position;
+    hunger: number;
+    stamina: number;
+    inventory: ItemStack[];
+    carryWeightGrams: number;
+    carryLimitGrams: number;
+    carryRemainingGrams: number;
+    joinedFactoryId?: string;
+    talents: AgentTalentViews;
+    organizations?: Array<{
+        organizationId: string;
+        name: string;
+        ownerAgentId: string;
+        members: OrganizationMember[];
+    }>;
+    factories?: FactoryView[];
+    contractDefinitions?: ContractDefinitionView[];
+    contractInstances?: ContractInstanceView[];
+    nearbyResources: Array<{
+        resourceId: string;
+        resourceTypeId: string;
+        nodeArchetypeId: string;
+        itemId: string;
+        miningDifficulty?: number;
+        position: Position;
+        amount: number;
+        distance: number;
+    }>;
+    nearbyCrops: Array<{
+        cropId: string;
+        cropTypeId: string;
+        position: Position;
+        stage: CropStageId;
+        matureTick: number;
+        distance: number;
+    }>;
+    nearbyStructures: Array<{
+        structureId: string;
+        structureTypeId: string;
+        origin: Position;
+        footprint: Footprint;
+        position: Position;
+        hp: number;
+        state?: StructureRuntimeState;
+        sourceBuildRecipeId?: string;
+        builderAgentId?: string;
+        ownerRef?: OwnerRef;
+        withdrawLevel?: WithdrawLevel;
+        canWithdraw?: boolean;
+        distance: number;
+    }>;
+    nearbyProjects: Array<{
+        projectId: string;
+        recipeId: string;
+        targetStructureTypeId: string;
+        builderAgentId: string;
+        origin: Position;
+        footprint: Footprint;
+        stage: Extract<BuildingProjectStage, 'frame' | 'supplied'>;
+        deliveredInputs: ItemStack[];
+        requiredInputs: ItemStack[];
+        currentWork: number;
+        requiredWork: number;
+        reservedUntilTick: number;
+        distance: number;
+    }>;
+    nearbyAgents: Array<{
+        agentId: string;
+        position: Position;
+        hunger: number;
+        stamina: number;
+        talents: AgentTalentViews;
+        distance: number;
+    }>;
+    adjacentTiles: Array<{
+        x: number;
+        y: number;
+        withinMap: boolean;
+        terrain?: TerrainType;
+        occupiedBy?: {
+            kind: 'resource' | 'crop' | 'structure' | 'project' | 'agent';
+            id: string;
+            typeId?: string;
+        };
+        canMove: boolean;
+        canBuild: boolean;
+    }>;
+    buildableAdjacentTargets: Position[];
+    visibleTrades: Array<{
+        tradeId: string;
+        creatorAgentId: string;
+        toAgentId?: string;
+        status: 'open' | 'accepted' | 'cancelled';
+        createdAtTick: number;
+        expiresAtTick: number;
+        ticksUntilExpire: number;
+        give: ItemStack[];
+        receive: ItemStack[];
+        canAccept: boolean;
+        canCancel: boolean;
+        acceptRequirementsMet: boolean;
+    }>;
+    resourceHints?: ObserveResourceHint[];
+    archetypeHints?: ObserveArchetypeHint[];
+}
+export interface TickSignal {
+    tick: number;
+    tickIntervalMs?: number;
+    nextTickAt?: string;
+    serverTime?: string;
+}
+export interface TickInfoResponse {
+    currentTick: number;
+    tickIntervalMs: number;
+    nextTickAt: string;
+    serverTime: string;
+}
+export interface WorldSnapshot {
+    tick: number;
+    savedAt: string;
+    state: WorldState;
+}
+export interface StoredEventBatch {
+    tick: number;
+    savedAt: string;
+    events: WorldEvent[];
+}
+export interface StoredTickRecord {
+    tick: number;
+    savedAt: string;
+    actions: QueuedAction[];
+    events: WorldEvent[];
+}
+export interface VerbSpec {
+    verb: string;
+    description: string;
+    params?: string[];
+    target?: string;
+}
+export interface CatalogArchetypeNeedsEffect {
+    type: 'needs';
+    hungerDelta?: number;
+    staminaDelta?: number;
+}
+export interface CatalogArchetypeSpawnItemEffect {
+    type: 'spawn-item';
+    itemId: string;
+    amount: number;
+}
+export type CatalogArchetypeUseEffect = CatalogArchetypeNeedsEffect | CatalogArchetypeSpawnItemEffect;
+export interface CatalogArchetypeUse {
+    verb: 'consume';
+    amountPerUse?: number;
+    effects: CatalogArchetypeUseEffect[];
+}
+export interface CatalogArchetype {
+    id: string;
+    tags: string[];
+    description: string;
+    weightGrams?: number;
+    use?: CatalogArchetypeUse;
+}
+export interface CatalogStructureType {
+    id: string;
+    archetypeId?: string;
+    tags: string[];
+    description: string;
+    footprint: Footprint;
+    maxHp: number;
+    traversal: StructureTraversal;
+    storage?: StorageSpec;
+    behavior?: StructureBehavior;
+    capabilities?: StructureCapabilities;
+    render?: StructureRender;
+}
+export interface CropStageDefinition {
+    id: CropStageId;
+}
+export interface CropRender {
+    baseTileId?: number;
+    stageTileIds?: Partial<Record<CropStageId, number>>;
+}
+export interface CatalogCropType {
+    id: string;
+    archetypeId?: string;
+    tags: string[];
+    description: string;
+    seedArchetypeId: string;
+    allowedTerrain: TerrainType[];
+    growthDurationTicks: number;
+    harvestOutputs: ItemStack[];
+    stages?: CropStageDefinition[];
+    render?: CropRender;
+}
+export interface IndustryVisualProfile {
+    id: string;
+    label: string;
+    tilesetAssetPath?: string;
+}
+export type ProcessRecipeBehavior = {
+    kind: 'default';
+} | {
+    kind: 'toggle-gate';
+    targetState: 'open' | 'closed';
+};
+export interface CatalogProcessRecipe {
+    id: string;
+    kind: 'process';
+    allowedStructureTypeIds?: string[];
+    inputs: ItemStack[];
+    outputs: ItemStack[];
+    durationTicks: number;
+    behavior?: ProcessRecipeBehavior;
+    awardTalentId?: TalentId;
+    industryVisualProfileId?: string;
+    notes?: string;
+}
+export interface CatalogBuildRecipe {
+    id: string;
+    kind: 'build';
+    targetStructureTypeId: string;
+    inputs: ItemStack[];
+    outputs: ItemStack[];
+    durationTicks: number;
+    requiredWork?: number;
+    frameReservationTicks?: number;
+    framePlacementTalents?: Partial<Record<TalentId, number>>;
+    notes?: string;
+}
+export type CatalogRecipe = CatalogProcessRecipe | CatalogBuildRecipe;
+export interface CatalogResourceSpawn {
+    count: number;
+    terrainWeights: Partial<Record<TerrainType, number>>;
+    renderTileIdRange?: [number, number];
+}
+export interface CatalogResourceGather {
+    toolType?: 'axe' | 'pickaxe' | 'drill';
+    bonusAmount?: number;
+    miningDifficulty?: number;
+    awardTalentId?: TalentId;
+    seedDropChancePercent?: number;
+    seedDropAmount?: number;
+}
+export interface CatalogResourceType {
+    id: string;
+    nodeArchetypeId: string;
+    yieldItemId: string;
+    maxAmount: number;
+    regenPerTick: number;
+    regenIntervalTicks?: number;
+    spawn: CatalogResourceSpawn;
+    gather?: CatalogResourceGather;
+}
+export interface CatalogPayload {
+    version: string;
+    archetypes: CatalogArchetype[];
+    resourceTypes: CatalogResourceType[];
+    structureTypes: CatalogStructureType[];
+    cropTypes: CatalogCropType[];
+    industryVisualProfiles: IndustryVisualProfile[];
+    recipes: CatalogRecipe[];
+}
+export interface RulesPayload {
+    version: string;
+    verbs: VerbSpec[];
+    errorCodes: Record<string, string>;
+}
+export interface EventQueryResult {
+    events: WorldEvent[];
+    nextCursor: number;
+}
+export interface ReplayResult {
+    fromTick: number;
+    toTick: number;
+    finalState: WorldState;
+}
+export interface FactoryView {
+    factoryId: string;
+    ownerRef: OwnerRef;
+    structureTypeId: string;
+    activeRecipeId?: string;
+    activeContractDefinitionIds: string[];
+    minWorkersToRun: number;
+    maxWorkers: number;
+    assignedWorkerCount: number;
+    maxRunsPerTick: number;
+    storageCapacityGrams: number;
+    storageUsedGrams: number;
+    inventorySummary: ItemStack[];
+    availableRecipeIds: string[];
+    lastTickRuns: number;
+    canConfigure: boolean;
+    joinedByViewer: boolean;
+}
+export interface ContractDefinitionView {
+    contractId: string;
+    kind: ContractKind;
+    status: ContractDefinitionStatus;
+    issuerLabel: string;
+    linkedFactoryId?: string;
+    clausesSummary: string[];
+    allowedActionsForViewer: ('open' | 'pause' | 'close' | 'inspect')[];
+}
+export interface ContractInstanceView {
+    contractInstanceId: string;
+    contractId: string;
+    kind: ContractKind;
+    status: ContractInstanceStatus;
+    requesterLabel: string;
+    providerLabel: string;
+    linkedFactoryId?: string;
+    executionMode: 'explicit' | 'work-tick';
+    failureReason?: string;
+    allowedActionsForViewer: 'inspect'[];
+}
+export {};