def-game 6.1.0 → 6.2.0

package/README.md

@@ -5,10 +5,10 @@
 
 ## Getting Started
 
-Node.js 22以降が必要です。v6.1.0の利用手順です。
+Node.js 22以降が必要です。v6.2.0の利用手順です。
 
 ```sh
-npx def-game@6.1.0 init-worker --directory my-game --name my-game
+npx def-game@6.2.0 init-worker --directory my-game --name my-game
 cd my-game
 npm install
 npm run dev

package/dist/worker/cloudflare/session-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAgD,aAAa,EAAE,MAAM,YAAY,CAAC;AAMtK;;;GAGG;AACH,8BAAsB,cAAc,CAAC,GAAG,EAAE,CAAC,SAAS,SAAS,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;;IACvF,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEzD,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgBzC,iDAAiD;IAC3C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IActE,wCAAwC;IAClC,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKzG,oDAAoD;IAC9C,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAgFrF,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,uDAAuD;IACjD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBhD,8CAA8C;IACxC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEnF,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAGrD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CACxC"}
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAkD,aAAa,EAAE,MAAM,YAAY,CAAC;AAMxK;;;GAGG;AACH,8BAAsB,cAAc,CAAC,GAAG,EAAE,CAAC,SAAS,SAAS,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;;IACvF,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEzD,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgBzC,iDAAiD;IAC3C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IActE,wCAAwC;IAClC,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKzG,oDAAoD;IAC9C,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAsFrF,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,uDAAuD;IACjD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBhD,8CAA8C;IACxC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEnF,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAGrD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CACxC"}

package/dist/worker/cloudflare/session-runtime.js

@@ -1,7 +1,7 @@
 import { DurableObject } from "cloudflare:workers";
 import { failure, isRecord, parseCommandRequest } from "./protocol.js";
 const STATE_KEY = "game-state";
-const TIMEOUT_KEY = "decision-timeout";
+const SCHEDULED_EVENTS_KEY = "scheduled-events";
 /**
  * 1ルームを動かすCloudflare専用runtime。アプリはadapterだけを接続した派生クラスをexportする。
  * RPCとfetchは信頼されたWorker専用。認証・外部リクエスト保護はWorker入口が担当する。
@@ -60,17 +60,20 @@ export class SessionRuntime extends DurableObject {
             try {
                 let consumed;
                 if (options.alarm) {
-                    const reservation = await this.ctx.storage.get(TIMEOUT_KEY);
-                    if (!reservation)
+                    const reservations = await this.#reservations(this.ctx.storage);
+                    const reservation = this.#earliest(reservations);
+                    if (!reservation) {
+                        await this.ctx.storage.deleteAlarm();
                         return { ok: true };
+                    }
                     if (Date.now() < reservation.deadline) {
                         await this.ctx.storage.setAlarm(reservation.deadline);
                         return { ok: true };
                     }
-                    if (!this.adapter.timeout)
-                        throw new Error("Timeout adapter missing");
-                    command = this.adapter.timeout.command(reservation.decisionId);
-                    consumed = reservation.decisionId;
+                    if (!this.adapter.scheduler)
+                        throw new Error("Scheduler adapter missing");
+                    command = this.adapter.scheduler.command(reservation.id);
+                    consumed = reservation.id;
                 }
                 const state = await this.ctx.storage.get(STATE_KEY);
                 if (state === undefined)
@@ -84,41 +87,44 @@ export class SessionRuntime extends DurableObject {
                 if (result.state === undefined)
                     throw new Error("State must be persistable");
                 const external = [];
-                const alarms = [];
+                const scheduled = [];
                 for (const effect of result.effects) {
-                    const alarm = this.adapter.timeout?.effect(effect) ?? null;
-                    if (alarm === null)
+                    const scheduledEffect = this.adapter.scheduler?.effect(effect) ?? null;
+                    if (scheduledEffect === null)
                         external.push(effect);
                     else {
-                        if (!alarm.decisionId || (alarm.type !== "schedule" && alarm.type !== "cancel")
-                            || (alarm.type === "schedule" && !Number.isFinite(alarm.deadline)))
-                            throw new Error("Invalid alarm effect");
-                        alarms.push(alarm);
+                        if (!scheduledEffect.id || (scheduledEffect.type !== "schedule" && scheduledEffect.type !== "cancel")
+                            || (scheduledEffect.type === "schedule" && !Number.isFinite(scheduledEffect.deadline))) {
+                            throw new Error("Invalid scheduler effect");
+                        }
+                        scheduled.push(scheduledEffect);
                     }
                 }
                 await this.ctx.storage.transaction(async (txn) => {
                     await txn.put(STATE_KEY, result.state);
-                    if (consumed !== undefined) {
-                        const current = await txn.get(TIMEOUT_KEY);
-                        if (current?.decisionId === consumed) {
-                            await txn.delete(TIMEOUT_KEY);
-                            await txn.deleteAlarm();
+                    if (consumed !== undefined || scheduled.length > 0) {
+                        let reservations = await this.#reservations(txn);
+                        if (consumed !== undefined)
+                            reservations = reservations.filter(item => item.id !== consumed);
+                        for (const scheduledEffect of scheduled) {
+                            reservations = reservations.filter(item => item.id !== scheduledEffect.id);
+                            if (scheduledEffect.type === "schedule") {
+                                reservations.push({ id: scheduledEffect.id, deadline: scheduledEffect.deadline });
+                            }
                         }
-                    }
-                    for (const alarm of alarms) {
-                        if (alarm.type === "schedule") {
-                            await txn.put(TIMEOUT_KEY, { decisionId: alarm.decisionId, deadline: alarm.deadline });
-                            await txn.setAlarm(alarm.deadline);
+                        const earliest = this.#earliest(reservations);
+                        if (earliest) {
+                            await txn.put(SCHEDULED_EVENTS_KEY, reservations);
+                            await txn.setAlarm(earliest.deadline);
                         }
                         else {
-                            const current = await txn.get(TIMEOUT_KEY);
-                            if (current?.decisionId === alarm.decisionId) {
-                                await txn.delete(TIMEOUT_KEY);
-                                await txn.deleteAlarm();
-                            }
+                            await txn.delete(SCHEDULED_EVENTS_KEY);
+                            await txn.deleteAlarm();
                         }
                     }
                 });
+                if (consumed !== undefined)
+                    options.onScheduledProcessed?.();
                 // 保存後の配信失敗で、確定したCommandを失敗に戻さない。
                 effects = external;
                 this.#broadcast(result.state);
@@ -136,9 +142,28 @@ export class SessionRuntime extends DurableObject {
     }
     /** Alarm失敗は例外としてCloudflareの有限回リトライへ返す。 */
     async alarm() {
-        const result = await this.#dispatchCommand(undefined, { origin: "system" }, { alarm: true });
-        if (!result.ok)
-            throw new Error("Timeout command failed");
+        while (true) {
+            let processed = false;
+            const result = await this.#dispatchCommand(undefined, { origin: "system" }, { alarm: true, onScheduledProcessed: () => { processed = true; } });
+            if (!result.ok)
+                throw new Error("Scheduled command failed");
+            if (!processed)
+                return;
+        }
+    }
+    async #reservations(storage) {
+        const reservations = await storage.get(SCHEDULED_EVENTS_KEY);
+        if (reservations === undefined)
+            return [];
+        if (!Array.isArray(reservations) || reservations.some(item => !isRecord(item)
+            || typeof item.id !== "string" || item.id.length === 0
+            || typeof item.deadline !== "number" || !Number.isFinite(item.deadline))) {
+            throw new Error("Invalid scheduled reservations");
+        }
+        return reservations;
+    }
+    #earliest(reservations) {
+        return reservations.reduce((earliest, item) => !earliest || item.deadline < earliest.deadline ? item : earliest, undefined);
     }
     /** 認証済みWorkerからだけ呼ぶ内部WS入口。一般HTTP Commandの転送は受け付けない。 */
     async fetch(request) {

package/dist/worker/cloudflare/types.d.ts

@@ -41,14 +41,14 @@ export type GetViewResult<View> = {
     readonly ok: false;
     readonly error: RuntimeError;
 };
-/** 状態と一緒に確定する、1つの現在decisionに対する予約・解除。 */
-export type TimeoutEffect = {
+/** 状態と一緒に確定する、論理的な予定イベントの予約・解除。 */
+export type ScheduledEffect = {
     readonly type: "schedule";
-    readonly decisionId: string;
+    readonly id: string;
     readonly deadline: number;
 } | {
     readonly type: "cancel";
-    readonly decisionId: string;
+    readonly id: string;
 };
 /** 失敗した区間を通知する。秘密の状態・Command・Effectを自動ログに含めない。 */
 export interface RuntimeFailure {
@@ -63,9 +63,9 @@ export interface GameAdapter<Env, T extends GameTypes> {
         readonly parseCommand: (input: unknown) => T["actorCommand"] | null;
     };
     readonly canConnect: (state: T["state"], actorId: string) => boolean;
-    readonly timeout?: {
-        readonly effect: (effect: T["effect"]) => TimeoutEffect | null;
-        readonly command: (decisionId: string) => T["systemCommand"];
+    readonly scheduler?: {
+        readonly effect: (effect: T["effect"]) => ScheduledEffect | null;
+        readonly command: (id: string) => T["systemCommand"];
     };
     /** 保存後のbest-effort処理。結果はruntimeがSystem Commandとして再度dispatchする。 */
     readonly executeEffect?: (effect: T["effect"], context: {

package/dist/worker/cloudflare/types.d.ts.map

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

package/docs/design-philosophy.md

@@ -16,14 +16,14 @@ flowchart TB
   subgraph App["初期生成するアプリ所有コード：編集・置き換え可能"]
     Entry["Worker入口：HTTP／WS接続ルート<br/>認証・公開ルームIDの解決"]
     API["HTTP処理・外部情報の取得"]
-    Adapter["adapter：入力parser・接続可否・Alarm変換"]
+    Adapter["adapter：入力parser・接続可否・scheduler変換"]
     Handler["Effect handler"]
     Game["Game Definition<br/>初期状態・ルール・Actor別View"]
   end
   subgraph Lib["DefGameライブラリ：SessionRuntimeが提供"]
     WS["標準WS管理<br/>接続とActorの紐付け・Hibernation"]
     Runtime["共通dispatcher<br/>状態取得・Command実行・保存"]
-    Alarm["Alarm予約・発火時の処理"]
+    Alarm["永続scheduler<br/>論理予約・Alarm発火"]
   end
   External["外部サービス"]
   Client -->|HTTP・WS接続開始| Entry
@@ -34,7 +34,7 @@ flowchart TB
   Runtime -->|handleCommand・projectを呼ぶ| Game
   Game -->|次状態・Effect・View| Runtime
   Adapter -.->|入力・接続条件を提供| WS
-  Adapter -.->|Alarm変換を提供| Alarm
+  Adapter -.->|予定イベント変換を提供| Alarm
   Runtime -->|状態と一緒に予約| Alarm
   Alarm -->|System Command| Runtime
   Runtime -->|保存後のActor別View| WS
@@ -52,10 +52,10 @@ WS接続後のメッセージはライブラリのWS処理へ届き、毎回Work
 
 ## 1. init-workerで開発を始める
 
-Node.js 22以降で、次を実行します。以下は`6.1.0`の利用手順です。
+Node.js 22以降で、次を実行します。以下は`6.2.0`の利用手順です。
 
 ```sh
-npx def-game@6.1.0 init-worker --directory my-game --name my-game
+npx def-game@6.2.0 init-worker --directory my-game --name my-game
 cd my-game
 npm install
 npm run dev
@@ -195,12 +195,12 @@ webhookやマッチング処理から入力する場合は、アプリで認証
 | `game` | 必須 | 作成したGame Definitionを渡す |
 | `webSocket.parseCommand` | 必須 | unknownの入力を許可したActor Commandへ変換。拒否はnull |
 | `canConnect` | 必須 | StateとActor IDから接続・View配信の可否を判定 |
-| `timeout.effect`／`timeout.command` | 期限処理を使う場合 | Alarm用Effectの識別と、発火時のSystem Command作成 |
+| `scheduler.effect`／`scheduler.command` | 予定イベントを使う場合 | Effectから論理予約への変換と、発火時のSystem Command作成 |
 | `executeEffect` | 外部Effectを出す場合 | 外部処理と、必要なら結果Commandの返却 |
 | `onError` | 独自の診断が必要な場合 | 失敗した区間の記録・通知 |
 
 `executeEffect`は型上は省略可能ですが、外部Effectを出すゲームでは対応するhandlerが必要です。
-Alarm用Effectはruntimeが状態と一緒に保存します。外部handlerから直接setAlarmする構成にはしません。
+scheduler用Effectはruntimeが状態と一緒に保存します。外部handlerから直接setAlarmする構成にはしません。
 
 `src/room.ts`では、そのadapterを共通runtimeへ接続しています。
 
@@ -266,7 +266,7 @@ flowchart LR
   G -->|拒否| E["状態を変えずエラーを返す"]
 ```
 
-HTTP、WS、timeout、外部処理の完了がそれぞれ直接状態を書き換えると、どこにルールがあるのか追いにくくなります。
+HTTP、WS、予定イベント、外部処理の完了がそれぞれ直接状態を書き換えると、どこにルールがあるのか追いにくくなります。
 DefGameでは初期状態の生成後、すべてのゲーム操作をCommandとして`handleCommand`へ集めます。
 同じ操作なら通信経路によらず同じルールを通り、変更理由をCommandとその処理から読めます。
 これは状態遷移の構造を揃える仕組みであり、Command履歴の永続保存や自動リプレイを提供するものではありません。
@@ -317,7 +317,7 @@ sequenceDiagram
 ただし、外部Effectはbest effortです。状態保存後、handlerが起動する前に停止すれば依頼が失われる可能性があります。
 外部処理の完了から結果Commandの保存までにも同様の隙間があります。
 ライブラリは永続outboxや自動再試行を提供せず、Effect失敗で保存済み状態を取り消しません。
-結果が必須の機能では、アプリ側の復旧方法やゲーム側のtimeoutを設計してください。
+結果が必須の機能では、アプリ側の復旧方法やゲーム側の予定イベントを設計してください。
 
 ### 保存・Alarm・配信の手順を共通化する
 
@@ -325,36 +325,40 @@ sequenceDiagram
 flowchart TB
   Input["プレイヤーの操作"] --> G["handleCommand"]
   G --> Wait["安定した入力待ち状態<br/>誰の入力・どのdecision IDを待つか"]
-  G --> Effect["Alarm用Effect<br/>decision ID・期限"]
+  G --> Effect["scheduler用Effect<br/>イベントID・期限"]
   subgraph TX["同じstorage transactionで確定"]
     State["入力待ち状態を保存"]
-    Reservation["予約情報とCloudflare Alarmを設定"]
+    Reservations["N個の論理予約を保存"]
+    Alarm["最も早い期限を<br/>1つの物理Alarmへ設定"]
+    Reservations -->|min(deadline)| Alarm
   end
   Wait --> State
-  Effect -->|adapterで識別| Reservation
+  Effect -->|adapterで識別| Reservations
   TX --> Saved["保存確定"]
   Saved --> View["View配信"]
   Saved --> Waiting["次の入力を待つ"]
   Waiting -->|期限前の操作| Next["Actor Command"]
-  Waiting -->|Cloudflare Alarm発火| Timeout["System Command<br/>decision IDを付ける"]
+  Waiting -->|Cloudflare Alarm発火| Scheduled["System Command<br/>イベントIDを付ける"]
   Next --> Check["同じhandleCommand<br/>現在の入力待ちに有効か検証"]
-  Timeout --> Check
+  Scheduled --> Check
   Check -->|有効| Transition["次の安定状態へ<br/>必要なら予約を取消・更新"]
   Check -->|古い入力等| Reject["現在状態を進めない"]
 ```
 
-手番や選択待ちに期限を付けるとき、ゲームは「期限に達したら何をするか」を実装します。
-予約の保存とCloudflareネイティブのAlarmへの接続はruntimeに任せられます。
-タイムアウトは任意の機能ですが、プレイヤーの離席や切断で進行が止まるゲームに役立ちます。
+手番や選択待ち、inactivity、再接続猶予などに期限を付けるとき、ゲームは「期限に達したら何をするか」を実装します。
+複数の論理予約の保存とCloudflareネイティブの1つのAlarmへの接続はruntimeに任せられます。
+runtimeはイベントIDの意味を解釈せず、最も早い期限だけを物理Alarmへ設定します。
 図のtransactionは保存処理だけを囲んでいます。将来の発火・Command実行や、取り消せないView配信は含みません。
 
-複数の入力が届いても、runtimeが状態取得から更新を直列化し、状態とAlarm予約を同じtransactionで保存します。
+複数の入力が届いても、runtimeが状態取得から更新を直列化し、状態と論理予約を同じtransactionで保存します。
 これにより、ゲームごとに同じ排他制御や保存手順を実装する負担を減らします。
 保存が確定してからViewを配信し、外部Effectは直列化区間を出て実行します。
 外部処理を待っている間にも次のCommandを処理し、結果が戻れば最新状態に対して検証します。
 
-Alarmの予約が状態と一緒に確定することと、将来のAlarm発火が一度だけ処理されることは別です。
-ゲーム側でもdecision IDと現在状態を確認し、古い入力を適用しないようにします。
+Alarm発火時は期限に達した予約を1件ずつ通常のCommandとして処理し、そのたびに最新のStateと予約を読み直します。
+先のCommandがゲームを終了して次の予約を取り消せば、その予約は処理されません。
+論理予約が状態と一緒に確定することと、将来のAlarm発火が一度だけ処理されることは別です。
+ゲーム側でもイベントIDと現在状態を確認し、古い入力を適用しないようにします。
 
 ### ゲームの参加状態を、通信の寿命から切り離す
 

package/docs/runtime-api.md

@@ -62,9 +62,9 @@ export interface GameAdapter<Env, T extends GameTypes> {
     readonly parseCommand: (input: unknown) => T["actorCommand"] | null;
   };
   readonly canConnect: (state: T["state"], actorId: string) => boolean;
-  readonly timeout?: {
-    readonly effect: (effect: T["effect"]) => TimeoutEffect | null;
-    readonly command: (decisionId: string) => T["systemCommand"];
+  readonly scheduler?: {
+    readonly effect: (effect: T["effect"]) => ScheduledEffect | null;
+    readonly command: (id: string) => T["systemCommand"];
   };
   /** 保存後のbest-effort処理。結果はruntimeがSystem Commandとして再度dispatchする。 */
   readonly executeEffect?: (effect: T["effect"], context: { readonly env: Env; readonly roomId: string })
@@ -79,7 +79,7 @@ export interface GameAdapter<Env, T extends GameTypes> {
 | `game` | 純粋な初期状態生成・ルール・View生成を提供 | 必須 |
 | `webSocket.parseCommand` | クライアントが指定してよい入力をCommandへ変換 | 必須 |
 | `canConnect` | Actorの接続とView配信を許可するか判断 | 必須 |
-| `timeout` | ゲームの期限処理をCloudflare Alarmにつなぐ | 期限処理を使う場合 |
+| `scheduler` | 論理的な予定イベントをCloudflare Alarmにつなぐ | 予定イベントを使う場合 |
 | `executeEffect` | Alarm以外のEffectを実行し、必要なら結果を返す | 外部Effectを出す場合 |
 | `onError` | runtimeの診断情報を受け取る | 任意 |
 
@@ -222,37 +222,47 @@ HTTPから`dispatchActor`へ渡したCommandには、このWS parserは適用さ
 falseなら接続開始は403、WS Commandは`NotRoomMember`として拒否し、配信対象なら接続を閉じます。
 HTTP／SystemのCommand認可には使われないため、`handleCommand`の検証は必須です。
 
-### timeout.effect / timeout.command
+### scheduler.effect / scheduler.command
 
 ```ts
-timeout?: {
-  effect: (effect: T['effect']) => TimeoutEffect | null;
-  command: (decisionId: string) => T['systemCommand'];
+scheduler?: {
+  effect: (effect: T['effect']) => ScheduledEffect | null;
+  command: (id: string) => T['systemCommand'];
 };
 
-type TimeoutEffect =
-  | { readonly type: 'schedule'; readonly decisionId: string; readonly deadline: number }
-  | { readonly type: 'cancel'; readonly decisionId: string };
+type ScheduledEffect =
+  | { readonly type: 'schedule'; readonly id: string; readonly deadline: number }
+  | { readonly type: 'cancel'; readonly id: string };
 ```
 
-**目的:** ゲームが返すEffectを、状態と一緒に保存するAlarm予約へ変換します。
-`effect`は成功した遷移の各Effectに対して呼ばれます。Alarm用なら上記の形に変換し、外部Effectなら`null`を返します。
-変換したAlarm用Effectは`executeEffect`へは渡されません。
+**目的:** ゲームが返すEffectを、状態と一緒に保存する論理的な予定イベントへ変換します。
+`effect`は成功した遷移の各Effectに対して呼ばれます。予定イベント用なら上記の形に変換し、外部Effectなら`null`を返します。
+変換したEffectは`executeEffect`へは渡されません。
 
 | 戻り値 | runtimeの動作 |
 | --- | --- |
-| schedule | 現在予約を置き換え、State・予約・Alarmを同じtransactionで保存 |
-| cancel | 現在のdecisionIdと一致するときだけ予約・Alarmを削除 |
+| schedule | 同じidの予約を追加または置き換え、最も早い期限を物理Alarmへ設定 |
+| cancel | 同じidの予約を削除し、残る最も早い期限へ物理Alarmを再設定 |
 | null | 保存後に外部Effect handlerへ渡す |
 
-1ルームの予約は1つです。`decisionId`は空でない文字列、`deadline`は有限のUnix時刻ミリ秒を指定します。
-複数のAlarm用Effectは配列順に適用します。
+1ルームに複数の論理予約を保持できます。`id`は空でない文字列、`deadline`は有限のUnix時刻ミリ秒を指定します。
+予約はゲームStateとは別の`scheduled-events`へ永続化されます。Cloudflareの物理Alarmは1つだけで、常に最も早い論理予約の期限を指します。
+予約がなくなれば物理Alarmも削除されます。複数のscheduler Effectは配列順に適用します。
 
-`command`は期限に達した予約からSystem Commandを作ります。必要なら`now: Date.now()`等を追加してください。
-実行時にゲーム側でも現在のdecision IDと状態を検証します。
-早すぎる発火は再予約し、ゲームによる拒否・保存失敗では予約を消費せず例外を返します。
+`command`は期限に達した論理予約の`id`からSystem Commandを作ります。必要なら`now: Date.now()`等を追加してください。
+runtimeはイベント名の意味を解釈しません。decision timeout、inactivity、reconnect grace period等の名前と処理はアプリが決めます。
+decision timeoutもschedulerの通常の利用例であり、runtime固有の特別な予約ではありません。
+
+Alarm発火時は、期限に達した最も早い予約を1件だけCommandへ変換し、通常のdispatcherで処理します。
+成功後に予約を読み直し、別の予約も期限に達していれば最新Stateに対して次のCommandを処理します。
+これにより、先のCommandが後続予約を取り消した場合、その予約は古いStateから作ったCommandとして実行されません。
+早すぎる発火は最も早い期限へ再設定し、ゲームによる拒否・保存失敗では予約を消費せず例外を返します。
 Alarmの予約と、将来の発火・再試行は別の実行です。一度だけ届く前提にしないでください。
 
+セッション削除はschedulerとは別のruntime lifecycle操作です。予定イベントをきっかけに削除する場合も、
+まずSystem Commandとしてゲームが最新Stateで削除の妥当性を判断し、その結果をruntimeが`storage.deleteAll()`等へ接続する境界にします。
+イベントID自体へ削除の意味を持たせたり、ゲームからDurable Object Storageを直接操作したりしません。
+
 ### executeEffect
 
 ```ts
@@ -443,10 +453,10 @@ requestIdは応答の対応付け用で、永続的な重複排除には使い
 
 ### 始め方
 
-Node.js 22以降を使用します。`6.1.0`を指定して生成します。
+Node.js 22以降を使用します。`6.2.0`を指定して生成します。
 
 ```sh
-npx def-game@6.1.0 init-worker --directory my-game --name my-game
+npx def-game@6.2.0 init-worker --directory my-game --name my-game
 cd my-game
 npm install
 npm run dev
@@ -454,7 +464,7 @@ npm run dev
 
 開発版をこのリポジトリから試す場合は、リポジトリで`npm pack`を実行します。
 `node bin/def-game.cjs init-worker --directory /path/to/my-game --name my-game`で生成し、生成先で
-`npm install /absolute/path/to/def-game-6.1.0.tgz`を実行してください。
+`npm install /absolute/path/to/def-game-6.2.0.tgz`を実行してください。
 その後は`npm run typecheck`、`npm run build`、`npm run dev`を利用できます。buildはWranglerのdry-runで、公開しません。
 
 生成先は新しいディレクトリに限定します。既存ディレクトリは空でも拒否します。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "def-game",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "Pure game definitions, a simulator, and a Cloudflare Durable Object runtime for turn-based games",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/starter/README.md

@@ -12,7 +12,7 @@ npm install
 npm run dev
 ```
 
-ローカルの開発版では、`npm install`の代わりに`npm install /absolute/path/to/def-game-6.1.0.tgz`を実行してください。
+ローカルの開発版では、`npm install`の代わりに`npm install /absolute/path/to/def-game-6.2.0.tgz`を実行してください。
 `http://127.0.0.1:8787`を開きます。別ブラウザープロファイルで共有URLを開くと、2人で試せます。
 
 実装前に[設計思想](node_modules/def-game/docs/design-philosophy.md)を読み、詳細は[runtime API・初期生成の使い方](node_modules/def-game/docs/runtime-api.md)を参照してください。

package/templates/starter/package.json

@@ -10,6 +10,6 @@
     "build": "wrangler deploy --dry-run --outdir dist",
     "deploy": "wrangler deploy"
   },
-  "dependencies": { "def-game": "6.1.0", "hono": "^4.13.7", "jose": "^6.2.12" },
+  "dependencies": { "def-game": "6.2.0", "hono": "^4.13.7", "jose": "^6.2.12" },
   "devDependencies": { "@cloudflare/workers-types": "^5.20260911.1", "typescript": "^5.8.2", "wrangler": "^4.131.1" }
 }

package/templates/starter/src/game-adapter.ts

@@ -17,9 +17,11 @@ export const adapter: GameAdapter<Env, Types> = {
     return null;
   } },
   canConnect: (state, actorId) => state.players.some(p => p.actorId === actorId),
-  timeout: {
-    effect: effect => effect.type === 'schedule' || effect.type === 'cancel' ? effect : null,
-    command: decisionId => ({ type: 'decision-timeout', decisionId, now: Date.now() }),
+  scheduler: {
+    effect: effect => effect.type === 'schedule'
+      ? { type: 'schedule', id: `decision:${effect.decisionId}`, deadline: effect.deadline }
+      : effect.type === 'cancel' ? { type: 'cancel', id: `decision:${effect.decisionId}` } : null,
+    command: id => ({ type: 'decision-timeout', decisionId: id.slice('decision:'.length), now: Date.now() }),
   },
   async executeEffect(effect, { roomId }) {
     if (effect.type === 'finished') console.info('Game finished', { roomId });