@thegeem/protocol 0.1.32 → 0.1.33

package/dist/index.cjs

@@ -176,6 +176,13 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     // an explicit seating beats an implicit one.
     // Violations are rejected with `invalid_seat`. Consumed by دامة (the only fixed-seat game today).
     players: import_zod.z.array(PlayerId).min(1).max(LIMITS.MAX_PLAYERS).optional(),
+    // SOLO vs the machine (gs#68). Fills the seats a game needs that no human took, so one person can
+    // play with nobody else around — دامة's «تمرين». Additive, no pv bump; omit it and nothing changes.
+    // The bot is a SEAT the relay drives, never something a client runs: Shape B means the server is
+    // still the referee, and a client-side opponent could not be trusted with the board anyway.
+    // `difficulty` is one search with different depth+noise, not three implementations.
+    // Solo games are deliberately NOT RATED and never touch the دامة ELO ladder — see the driver.
+    bot: import_zod.z.object({ difficulty: import_zod.z.enum(["easy", "medium", "hard"]).optional() }).optional(),
     // PREFERRED: pick a mode from the registry (see MODES). The server maps it to the engine
     // rules. Send this and omit buzzerMode/noHost. Falls back to the legacy flags below if omitted.
     modeId: import_zod.z.enum(MODE_IDS).optional(),

package/dist/index.d.cts

@@ -369,6 +369,13 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: z.ZodArray<z.ZodString, "many">;
     hostPlays: z.ZodOptional<z.ZodBoolean>;
     players: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    bot: z.ZodOptional<z.ZodObject<{
+        difficulty: z.ZodOptional<z.ZodEnum<["easy", "medium", "hard"]>>;
+    }, "strip", z.ZodTypeAny, {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    }, {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    }>>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -380,6 +387,9 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
+    bot?: {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    } | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -390,6 +400,9 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
+    bot?: {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    } | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{

package/dist/index.d.ts

@@ -369,6 +369,13 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: z.ZodArray<z.ZodString, "many">;
     hostPlays: z.ZodOptional<z.ZodBoolean>;
     players: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    bot: z.ZodOptional<z.ZodObject<{
+        difficulty: z.ZodOptional<z.ZodEnum<["easy", "medium", "hard"]>>;
+    }, "strip", z.ZodTypeAny, {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    }, {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    }>>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -380,6 +387,9 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
+    bot?: {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    } | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -390,6 +400,9 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
+    bot?: {
+        difficulty?: "easy" | "medium" | "hard" | undefined;
+    } | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{

package/dist/index.js

@@ -139,6 +139,13 @@ var ClientMsg = z.discriminatedUnion("t", [
     // an explicit seating beats an implicit one.
     // Violations are rejected with `invalid_seat`. Consumed by دامة (the only fixed-seat game today).
     players: z.array(PlayerId).min(1).max(LIMITS.MAX_PLAYERS).optional(),
+    // SOLO vs the machine (gs#68). Fills the seats a game needs that no human took, so one person can
+    // play with nobody else around — دامة's «تمرين». Additive, no pv bump; omit it and nothing changes.
+    // The bot is a SEAT the relay drives, never something a client runs: Shape B means the server is
+    // still the referee, and a client-side opponent could not be trusted with the board anyway.
+    // `difficulty` is one search with different depth+noise, not three implementations.
+    // Solo games are deliberately NOT RATED and never touch the دامة ELO ladder — see the driver.
+    bot: z.object({ difficulty: z.enum(["easy", "medium", "hard"]).optional() }).optional(),
     // PREFERRED: pick a mode from the registry (see MODES). The server maps it to the engine
     // rules. Send this and omit buzzerMode/noHost. Falls back to the legacy flags below if omitted.
     modeId: z.enum(MODE_IDS).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegeem/protocol",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "description": "Geem's wire protocol — shared zod schemas + TypeScript types for talking to the Geem game server over Socket.IO. The source of truth all clients implement against.",
   "license": "UNLICENSED",
   "homepage": "https://geem.tv",