package routers

import (
	"context"
	"sync"
)

var _ = sync.Mutex{}
var _ = context.Background

// 
// 派对 NPC「驻留行为」—— 让被邀请进派对的角色**自己会动**（2026-09-26 第 46 轮）。
// WHY THIS FILE EXISTS
// --------------------
// 用户原话：「最主要的还是邀请进派对角色的行为问题，**不互动一个也要让角色们自由行动，
// 自由做动作，不然还是死气沉沉**」。
// 现场事实（第 45/46 轮实测）：被邀角色**能被正确认出来（cardId 已修）、会播 POI 预制动作，
// 但一动不动地站在原地做完那一套动作**。原因是 `SendCivilianAsync` 只发到「POI 动作」为止，
// 少了让客户端接管 locomotion 的那几步。
// ★★★★★ 官方口径（全部来自配表/客户端契约，不是猜）
// · `SyncMoveWandering`(68745518) 的契约注释原文（CrowdMethods4229938.cs:204-207）：
// 「**让一个已投放的 NPC/行人"自己走起来"的唯一官方包。**
// 它**不带目的地**——只有半径、角度窗口和时间预算，路径由客户端
// ZoneGraph/AetherAI 自己挑。⇒ 服务端根本不需要路网来做"行走"，
// 只需要周期续期（MaxTime 是总时长，走完就永久站住）。」
// · 项目自己的 static 路人配方（GameRouter.Ambient.cs:804-834 / 792-794）：
// `SendCivilianAsync`（建人）＋ **`SyncAgentForceGo`（启动行为树）**… 且
// 「crowd 通道是客户端自驱游荡，服务端发游荡包反而多余；**static 通道必须发，
// 否则只播 idle**」—— 派对 NPC 正好走 static 通道。
// · `GameRouter.Ambient.cs:16-27` 的终版配方把 `SyncLogicAgentEnter` 列为第 3 步：
// 「把 id 注册进 logic-agent 管理器（**任务从它派发**）—— 不发它，任务可能被静默丢弃」。
// ★ 为什么**不能**改用 crowd 通道（`SyncAetherAICrowdAdd` + `TargetLocationReason=1` 自驱游荡）：
// `ClientCrowdInitData4229938` 的字段只有
// `NpcFormworkId / AgentPersonaId / UrbanDiversityConfigId / DesiredSpeed / ActionId /
// TargetLocationReason / FashionSuitId` + 基类 `Id/Position/Facing/EulerAngles`
// —— **没有 `AIAgentInfo`** ⇒ 带不了 `FightSpiritId` ⇒ `ClientData.cardId` 恒 0
// ⇒ 第 45 轮刚修好的「烤肉邀请面板」会**立刻退回空列表**。所以通道必须留在 static。
// ★★ 另一条被排除的路（配表级硬判据，别再回头）：
// 24 个可邀角色的 `AgentConfig.AiSettingId` 指向的行为集
// （`AgentAIBehaviorSetsBattleAISBehaviorConfig`）**全部没有游荡行为**：
// 40213395 Companion_Taffy / 40215027 Companion_zhuchang_Lin / 40213369 Companion_Battle /
// 40215025 Bot_Common_SMG / 40213004 Behavior_EmptyBehavior（无战斗AI）…
// 它们的 `Behavior_Wander` 与 `Behavior_StandBy` **都是空字符串**。
// 对照：会走路的市民档是 40213001/40213002（`Main_Common_NPC`，
// `Behavior_Wander = Behavior_Common_Wander`、`Behavior_StandBy = Behavior_Common_Patrol`）。
// ⇒ 这些角色在官方场景里是「**跟着玩家的同伴**」，本来就不游荡；拿它们当驻场 NPC
// 就必须由服务端/客户端额外下发行为意图。这正是本文件的职责。
// ⚠ 已知边界（诚实标注）
// 1. `SyncMoveWandering` 对 **crowd 通道（ECS/AgentEntity 管线）** 已被证伪
// （Ambient.cs:33-34：走 WanderingActionModule = BaseUnit 管线 ⇒ 静默失败）。
// 本文件只用在 **static 通道** 上（Ambient.cs:792-794 明确说 static 必须发）。
// 若实测仍不动 ⇒ 把 `PartyNpcRoamMode` 换成 `"waypoint"`（路点巡游，同一份契约里
// 被称作「唯一能产生走路步态的通道」），无需改代码。
// 2. 游荡半径取小值（默认 2~10 m）——营地里有家具与碰撞体，绕远会走丢或穿模。
// 3. 走完 `MaxTime` 就永久站住 ⇒ 必须**周期续期**，见 `PartyNpcRoamRearmSeconds`。
// ★★★ 第 47 轮定案（用户现场）：「**停走**」才是正解。
// 用户实测 waypoint 档 = 「**可以走了，不过是乱走**」⇒ 走路通道本身已跑通
// （`SyncLogicAgentCommand`(68050574) + `TaskWayPointMove`(tag 39) 有效，
// `SyncMoveWandering` 无效），但马上要求「把角色**围成一圈**、**坐在地面**」。
// ⇒ 默认 `PartyNpcRoamMode = "none"`；`SyncLogicAgentEnter` / `SyncAgentForceGo`
// 已**上移到模式门之前**（`none` 档也要发 —— 行为树没起来，连 POI 坐姿都保不住）。
// ⛔ 位置与朝向**本来就是对的**（`SpawnPartyNpcsAsync` 圆周排布 + `angle + π` 朝圆心），
// 是 walk 任务把人走散、并用行走姿态顶掉了坐姿 ⇒ 不需要改坐标，也不需要另写编排。
// 
func GameRouter_PartyNpcRoam_RoamStateOf(ctx context.Context, session *GameSession) any {
	// Router implementation for GameRouter_PartyNpcRoam_RoamStateOf
	var zero any; return zero
}

// 重开派对（撤掉上一批人）时调用：停掉旧循环、清空账本。
func GameRouter_PartyNpcRoam_ResetPartyNpcRoam(ctx context.Context, session *GameSession) any {
	// Router implementation for GameRouter_PartyNpcRoam_ResetPartyNpcRoam
	var zero any; return zero
}

func GameRouter_PartyNpcRoam_PartyRoamActive(ctx context.Context, ) bool {
	// Router implementation for GameRouter_PartyNpcRoam_PartyRoamActive
	return true
}

// 
// 把一个人登记进驻留行为，并起后台续期循环。
// ⛑ 在 SendCivilianAsync **之后**调用：单位必须先存在，任务才有人接。
// 
func GameRouter_PartyNpcRoam_ArmPartyNpcRoamAsync(ctx context.Context, session *GameSession, entityId uint64, x float32, y float32, z float32, token context.Context) any {
	// Router implementation for GameRouter_PartyNpcRoam_ArmPartyNpcRoamAsync
	var zero any; return zero
}

// 按当前模式下发一次行为意图（并回写 PartyNpcRoamEntry.ArmedTicks）。
func GameRouter_PartyNpcRoam_PushPartyRoamIntentAsync(ctx context.Context, session *GameSession, entry any, cfg any, token context.Context) any {
	// Router implementation for GameRouter_PartyNpcRoam_PushPartyRoamIntentAsync
	var zero any; return zero
}

// 
// `SyncMoveWandering`(68745518) —— 客户端自驱游荡意图。
// 逐字段照抄 `GameRouter.Ambient.PushAmbientWanderAsync`（同一条已验证的 static 配方），
// 只有半径/时长换成派对用的保守值。
// ⛑ `MoveId` 不是序号，是 `BattleMoveActionType`；填 0(Unknown) 等于「没有 locomotion 状态」。
// 
func GameRouter_PartyNpcRoam_PushPartyWanderAsync(ctx context.Context, session *GameSession, entry any, cfg any, token context.Context) any {
	// Router implementation for GameRouter_PartyNpcRoam_PushPartyWanderAsync
	var zero any; return zero
}

// 
// 对照/退路档：用 `SyncLogicAgentCommand`+`TaskWayPointMove`(tag 39) 让 NPC 沿一条
// **绕着营地的小多边形**巡游。`Ambient.cs` 文件头称这条通道是
// 「**唯一能产生走路步态的通道**」。
// 服务端自己记 `Cursor*`（= 上一腿终点）⇒ 不需要客户端上报位置。
// 
func GameRouter_PartyNpcRoam_PushPartyWaypointAsync(ctx context.Context, session *GameSession, entry any, cfg any, token context.Context) any {
	// Router implementation for GameRouter_PartyNpcRoam_PushPartyWaypointAsync
	var zero any; return zero
}

// 
// 续期循环。`MaxTime` 走完客户端会**永久站住**，所以必须周期性补发。
// 与 `EnsureLeftBehindLoop` 同款：session 断开后写 socket 会抛异常，循环自己退出，
// 不需要额外的停止钩子。
// 
func GameRouter_PartyNpcRoam_EnsurePartyNpcRoamLoop(ctx context.Context, session *GameSession, state any) any {
	// Router implementation for GameRouter_PartyNpcRoam_EnsurePartyNpcRoamLoop
	var zero any; return zero
}

func GameRouter_PartyNpcRoam_RunPartyNpcRoamLoopAsync(ctx context.Context, session *GameSession, state any, token context.Context) any {
	// Router implementation for GameRouter_PartyNpcRoam_RunPartyNpcRoamLoopAsync
	var zero any; return zero
}

type PartyNpcRoamEntry struct {
	EntityId uint64 `json:"entityId"`
	HomeX float32 `json:"homeX"`
	HomeY float32 `json:"homeY"`
	HomeZ float32 `json:"homeZ"`
// 上一次「下发/续期」的时刻（Environment.TickCount64）。
	ArmedTicks int64 `json:"armedTicks"`
// waypoint 模式：这一腿预计走完的时刻。
	EtaTicks int64 `json:"etaTicks"`
// waypoint 模式：下一腿的起点（= 上一腿的终点，服务端自己记账，不依赖客户端上报）。
	CursorX float32 `json:"cursorX"`
	CursorY float32 `json:"cursorY"`
	CursorZ float32 `json:"cursorZ"`
}

type PartyNpcRoamState struct {
	Entries []PartyNpcRoamEntry `json:"entries"`
	SyncRoot any `json:"syncRoot"`
	Cts *context.CancelFunc `json:"cts"`
	Loop *any `json:"loop"`
// ★ 第 49 轮：停走档那条日志每批只打一次（原先每人一条 ⇒ 10 条一样的话
// 把 [PARTYNPC] 生成汇总 淹掉，而汇总才是真正要看的证据）。
	StopWalkLogged bool `json:"stopWalkLogged"`
}