@cimplify/sdk 0.108.0 → 0.110.2

package/dist/game/kit/frontier.d.ts

@@ -0,0 +1,344 @@
+import { A as AiGenerateRequest, j as AiRun, C as Ctx, B as CtxRequest } from '../../local-VZkqsCzR.js';
+import { G as Game } from '../../game-fgQy2YIm.js';
+import { T as TickRoomTransport } from '../../tick-transport-UjHY3xK1.js';
+import { G as GameScene } from '../../fluid-ARr0qUIL.js';
+import { f as FrontierCommand, i as RegionRef } from '../../protocol-C8qbpUbT.js';
+export { A as ACTION, a as ACTION_BASE, b as AI_RUN_BYTES, c as AI_RUN_PREFIX, C as CHANNEL, d as COMPARE, e as CommandWriter, F as FRONTIER_CHANNEL_SLOT, I as INVENTION_FLAG, M as MAX_COMMAND_BYTES, N as NO_INVENTION, g as NO_ITEM, P as PATHOGEN, h as PROCESS, R as RUN_ID_BYTES, T as TRAIT, j as actionOf, k as encodeCommand, l as inventionItem, m as isInvention, n as materialItem, r as regionFromBigInt, o as regionKey, p as runIdFromAiRun, q as runIdFromHex } from '../../protocol-C8qbpUbT.js';
+import '../../link-BUTqGmyi.js';
+import '../../schema-BrWxzKp6.js';
+import '../../ui-hi7S2YcH.js';
+import '../../vars-Dc_PrhBK.js';
+import '../../network-ZXLD7l1b.js';
+import '../../world-PvILHDR1.js';
+import '../../backend-gUCzs5Kg.js';
+import '../../library-DXYaMFhi.js';
+import '../../audio-m0w8cnxq.js';
+import '../../client-Dytx_ZTC.js';
+import '../../state-replica-stMtdkVD.js';
+
+declare const CHEMISTRY_PROMPT = "frontier_chemistry";
+declare const CHEMISTRY_SCHEMA_NAME = "frontier_chemistry";
+declare const MAX_CHEMISTRY_NAME = 32;
+declare const MAX_TERMS = 4;
+declare const MAX_COUNT = 16;
+declare const MAX_KELVIN = 8000;
+declare const MAX_ENTHALPY = 4000000;
+declare const MAX_LATENT = 2000000;
+declare const MAX_HEAT_CAPACITY = 400;
+declare const MAX_DENSITY = 30000;
+declare const MAX_ACTIVATION = 1000000;
+declare const MAX_RATE_MILLI = 1000000;
+declare const MAX_GROUPS = 8;
+declare const MAX_GROUP_CHARS = 16;
+declare const MAX_HARDNESS = 1000;
+declare const CHEMISTRY_GROUPS: readonly ["fuel", "oxidiser", "acid", "base", "metal", "salt", "ore", "oxide", "organic", "aqueous", "powder", "catalyst", "explosive", "inert", "solvent", "carbonate", "polymer", "sugar", "living", "reducer", "toxic", "mineral", "atmosphere", "custom"];
+type Json$1 = string | number | boolean | readonly Json$1[] | {
+    readonly [key: string]: Json$1;
+};
+declare const CHEMISTRY_SCHEMA: Json$1;
+declare const CHEMISTRY_TEMPLATE: string;
+declare function frontierChemistryAiSection(): string;
+interface ChemistryAi {
+    generate(request: AiGenerateRequest): Promise<AiRun>;
+}
+interface ChemistryRequest {
+    readonly description: string;
+    readonly substances: readonly string[];
+    readonly requestKey: string;
+}
+declare function chemistryRequest(request: ChemistryRequest): AiGenerateRequest;
+declare function requestChemistry(ai: ChemistryAi, request: ChemistryRequest): Promise<Uint8Array>;
+
+declare const FRAME_MAGIC = 245;
+declare const FRAME_VERSION = 1;
+declare const HEADER_BYTES = 9;
+declare const LAYER: {
+    readonly machines: 1;
+    readonly deposits: 2;
+    readonly plots: 3;
+    readonly herds: 4;
+    readonly inventory: 5;
+    readonly events: 6;
+    readonly herdHealth: 7;
+    readonly plotHealth: 8;
+    readonly reactors: 9;
+};
+declare const HEALTH_FIELDS = 5;
+declare const HERD_HEALTH: {
+    readonly sick: 0;
+    readonly immune: 1;
+    readonly resistance: 2;
+    readonly fertility: 3;
+    readonly yield: 4;
+};
+declare const PLOT_HEALTH: {
+    readonly blight: 0;
+    readonly immune: 1;
+    readonly growth: 2;
+    readonly yield: 3;
+    readonly drought: 4;
+};
+declare const REACTOR_SLOTS = 8;
+declare const REACTOR_FIELDS: number;
+declare const REACTOR: {
+    readonly machine: 0;
+    readonly kelvin: 1;
+    readonly slots: 2;
+    readonly contents: 3;
+};
+declare const FIELD: {
+    readonly placement: 1;
+    readonly laneA: 2;
+    readonly laneB: 4;
+    readonly out: 8;
+    readonly progress: 16;
+    readonly signal: 32;
+};
+declare const MACHINE_FLAG: {
+    readonly alive: 1;
+    readonly enabled: 2;
+    readonly working: 4;
+    readonly logicOff: 8;
+    readonly starved: 16;
+    readonly blocked: 32;
+    readonly unpowered: 64;
+};
+declare const EVENT: {
+    readonly refused: 1;
+    readonly techDiscovered: 2;
+    readonly inventionAccepted: 3;
+    readonly inventionRejected: 4;
+    readonly surveyHit: 5;
+    readonly materialDerived: 6;
+    readonly produced: 7;
+    readonly inventionRequested: 8;
+    readonly chemistryRequested: 9;
+    readonly chemistryAccepted: 10;
+    readonly chemistryRejected: 11;
+};
+declare const LANES = 6;
+declare const PLOT_FIELDS = 9;
+declare const HERD_FIELDS = 11;
+declare const EVENT_WORDS = 6;
+declare const EVENT_KIND = 0;
+declare const EVENT_PLAYER = 1;
+declare const EVENT_A = 2;
+declare const EVENT_B = 3;
+declare const EVENT_C_LOW = 4;
+declare const EVENT_C_HIGH = 5;
+declare const MIRROR_EVENTS = 256;
+declare const PLOT: {
+    readonly region: 0;
+    readonly x: 1;
+    readonly z: 2;
+    readonly crop: 3;
+    readonly stage: 4;
+    readonly health: 5;
+    readonly moisture: 6;
+    readonly fertility: 7;
+    readonly plants: 8;
+};
+declare const HERD: {
+    readonly species: 0;
+    readonly region: 1;
+    readonly x: 2;
+    readonly z: 3;
+    readonly females: 4;
+    readonly males: 5;
+    readonly young: 6;
+    readonly hunger: 7;
+    readonly thirst: 8;
+    readonly produce: 9;
+    readonly owner: 10;
+};
+declare const SLOT_FIELDS = 3;
+declare function itemFromCode(code: number): number;
+declare class FrontierMirror {
+    tick: number;
+    machines: number;
+    deposits: number;
+    plotCount: number;
+    herdCount: number;
+    players: number;
+    machineSpec: Uint32Array<ArrayBuffer>;
+    machineFlags: Uint8Array<ArrayBuffer>;
+    machineRegion: Uint32Array<ArrayBuffer>;
+    machineX: Uint32Array<ArrayBuffer>;
+    machineZ: Uint32Array<ArrayBuffer>;
+    machineOwner: Uint32Array<ArrayBuffer>;
+    machineLanes: Uint32Array<ArrayBuffer>;
+    machineProgress: Uint8Array<ArrayBuffer>;
+    machineSignal: Int32Array<ArrayBuffer>;
+    depositAmount: Float64Array<ArrayBuffer>;
+    plots: Uint32Array<ArrayBuffer>;
+    herds: Uint32Array<ArrayBuffer>;
+    techs: bigint[];
+    inventory: Uint32Array[];
+    inventoryUsed: number[];
+    herdHealthCount: number;
+    plotHealthCount: number;
+    reactorCount: number;
+    herdHealth: Uint32Array<ArrayBuffer>;
+    plotHealth: Uint32Array<ArrayBuffer>;
+    reactors: Uint32Array<ArrayBuffer>;
+    readonly events: Uint32Array<ArrayBuffer>;
+    eventHead: number;
+    eventCount: number;
+    eventsSeen: number;
+    private readonly reader;
+    apply(frame: Uint8Array, offset?: number, length?: number): void;
+    private ensureMachines;
+    private ensureDeposits;
+    private machine;
+    private plot;
+    private herd;
+    private reactor;
+    herdHealthField(herd: number, field: number): number;
+    plotHealthField(plot: number, field: number): number;
+    reactorKelvin(reactor: number): number;
+    private slots;
+    private pushEvent;
+    event(at: number, word: number): number;
+    machineLane(machine: number, lane: number): number;
+    plotField(plot: number, field: number): number;
+    herdField(herd: number, field: number): number;
+    digest(): string;
+}
+
+interface FrontierLink {
+    command(action: number, payload: Uint8Array, length: number): void;
+    pump(mirror: FrontierMirror): number;
+}
+declare class TickFrontierLink implements FrontierLink {
+    private readonly transport;
+    private readonly frames;
+    private readonly lengths;
+    private head;
+    private count;
+    dropped: number;
+    constructor(transport: TickRoomTransport);
+    private push;
+    command(action: number, payload: Uint8Array, length: number): void;
+    pump(mirror: FrontierMirror): number;
+    close(): void;
+}
+declare class ReplayFrontierLink implements FrontierLink {
+    readonly sent: {
+        readonly action: number;
+        readonly bytes: Uint8Array;
+    }[];
+    private readonly frames;
+    private next;
+    private readonly perPump;
+    constructor(frames: readonly Uint8Array[], perPump?: number);
+    get remaining(): number;
+    command(action: number, payload: Uint8Array, length: number): void;
+    pump(mirror: FrontierMirror): number;
+}
+declare class FrontierCommands {
+    private readonly link;
+    private readonly w;
+    constructor(link: FrontierLink);
+    send(command: FrontierCommand): void;
+    survey(region: RegionRef, x: number, z: number, tool: number): void;
+    gather(deposit: number, amount: number): void;
+    place(invention: number, region: RegionRef, x: number, z: number): void;
+    craft(invention: number, count: number): void;
+    learn(invention: number): void;
+    insert(machine: number, lane: number, slot: number, count: number): void;
+    take(machine: number, count: number): void;
+    till(region: RegionRef, x: number, z: number): void;
+    harvest(plot: number): void;
+    charge(machine: number, slot: number, count: number): void;
+    discharge(machine: number, material: number, count: number): void;
+    vaccinate(herd: number, pathogen: number): void;
+    breed(herd: number, trait: number, upward: boolean): void;
+    chemistry(run: Uint8Array): void;
+    invent(run: Uint8Array): void;
+    private flush;
+}
+
+declare const REGION_METRES = 256;
+declare const MAX_SURVEYED = 64;
+declare const BOX_CAPACITY = 4096;
+interface FrontierPlanetOptions {
+    readonly link: FrontierLink;
+    readonly region: RegionRef;
+    readonly player: number;
+    readonly spawn?: {
+        readonly x: number;
+        readonly z: number;
+    };
+    readonly onInvent?: () => void;
+}
+declare class FrontierPlanet implements GameScene<Game> {
+    readonly name = "frontier-planet";
+    readonly mirror: FrontierMirror;
+    readonly commands: FrontierCommands;
+    readonly surveyed: Uint32Array<ArrayBuffer>;
+    surveyedCount: number;
+    framesApplied: number;
+    techsKnown: number;
+    private readonly options;
+    private readonly hud;
+    private boxes;
+    private eventsRead;
+    private x;
+    private z;
+    private surveyAction;
+    private gatherAction;
+    private tillAction;
+    private harvestAction;
+    private inventAction;
+    constructor(options: FrontierPlanetOptions);
+    enter(game: Game): void;
+    fixedUpdate(game: Game): void;
+    private readEvents;
+    aliveMachines(): number;
+    animals(): number;
+    progress(): number;
+    update(_game: Game): void;
+    moveTo(x: number, z: number): void;
+}
+interface FrontierSession {
+    readonly scene: FrontierPlanet;
+    readonly transport: TickRoomTransport | null;
+    onFrame(nowMs: number): void;
+}
+declare function joinFrontierPlanet(ctx: Ctx, request: CtxRequest<"world.join">, onInvent?: () => void): Promise<FrontierSession>;
+
+declare const INVENT_PROMPT = "frontier_invent";
+declare const INVENT_SCHEMA = "frontier_invention";
+declare const MAX_KNOWN_CHARS = 200;
+declare const MAX_NAME_CHARS = 32;
+declare const MAX_INGREDIENTS = 6;
+declare const MAX_STEPS = 4;
+declare const MAX_BEHAVIOURS = 6;
+declare const MAX_QUANTITY = 999;
+declare const MAX_PARAM = 4294967295;
+declare const MAX_STEP_VALUE = 65535;
+declare const MAX_MATERIAL_CHARS = 48;
+declare const VERBS: readonly ["store", "generate", "solar", "battery", "heat", "press", "cut", "grind", "combine", "mine", "pump", "irrigate", "fertilise", "harvest", "grow_boost", "transport", "light", "sense", "logic", "vehicle", "shelter", "feed", "survey", "spin"];
+declare const KINDS: readonly ["tool", "machine", "structure", "consumable"];
+declare const PROCESSES: readonly ["heat", "press", "cut", "grind", "combine", "spin"];
+type Json = string | number | boolean | readonly Json[] | {
+    readonly [key: string]: Json;
+};
+declare const INVENTION_SCHEMA: Json;
+declare const INVENT_TEMPLATE: string;
+declare const AI_CAPABILITY = "Describe an invention and the planet's rules decide whether it works";
+declare function frontierAiToml(): string;
+declare function frontierAiSection(): string;
+interface InventionAi {
+    generate(request: AiGenerateRequest): Promise<AiRun>;
+}
+interface InventionRequest {
+    readonly description: string;
+    readonly materials: readonly string[];
+    readonly techs: readonly string[];
+    readonly requestKey: string;
+}
+declare function inventionRequest(request: InventionRequest): AiGenerateRequest;
+declare function requestInvention(ai: InventionAi, request: InventionRequest): Promise<Uint8Array>;
+
+export { AI_CAPABILITY, BOX_CAPACITY, CHEMISTRY_GROUPS, CHEMISTRY_PROMPT, CHEMISTRY_SCHEMA, CHEMISTRY_SCHEMA_NAME, CHEMISTRY_TEMPLATE, type ChemistryAi, type ChemistryRequest, EVENT, EVENT_A, EVENT_B, EVENT_C_HIGH, EVENT_C_LOW, EVENT_KIND, EVENT_PLAYER, EVENT_WORDS, FIELD, FRAME_MAGIC, FRAME_VERSION, FrontierCommand, FrontierCommands, type FrontierLink, FrontierMirror, FrontierPlanet, type FrontierPlanetOptions, type FrontierSession, HEADER_BYTES, HEALTH_FIELDS, HERD, HERD_FIELDS, HERD_HEALTH, INVENTION_SCHEMA, INVENT_PROMPT, INVENT_SCHEMA, INVENT_TEMPLATE, type InventionAi, type InventionRequest, KINDS, LANES, LAYER, MACHINE_FLAG, MAX_ACTIVATION, MAX_BEHAVIOURS, MAX_CHEMISTRY_NAME, MAX_COUNT, MAX_DENSITY, MAX_ENTHALPY, MAX_GROUPS, MAX_GROUP_CHARS, MAX_HARDNESS, MAX_HEAT_CAPACITY, MAX_INGREDIENTS, MAX_KELVIN, MAX_KNOWN_CHARS, MAX_LATENT, MAX_MATERIAL_CHARS, MAX_NAME_CHARS, MAX_PARAM, MAX_QUANTITY, MAX_RATE_MILLI, MAX_STEPS, MAX_STEP_VALUE, MAX_SURVEYED, MAX_TERMS, MIRROR_EVENTS, PLOT, PLOT_FIELDS, PLOT_HEALTH, PROCESSES, REACTOR, REACTOR_FIELDS, REACTOR_SLOTS, REGION_METRES, RegionRef, ReplayFrontierLink, SLOT_FIELDS, TickFrontierLink, VERBS, chemistryRequest, frontierAiSection, frontierAiToml, frontierChemistryAiSection, inventionRequest, itemFromCode, joinFrontierPlanet, requestChemistry, requestInvention };