/**
 * Session ID tag translation helpers for the CCR v2 compat layer.
 *
 * Lives in its own file (rather than workSecret.ts) so that sessionHandle.ts
 * and replBridgeTransport.ts (bridge.mjs entry points) can import from
 * workSecret.ts without pulling in these retag functions.
 *
 * The isCseShimEnabled kill switch is injected via setCseShimGate() to avoid
 * a static import of bridgeEnabled.ts → growthbook.ts → config.ts — all
 * banned from the sdk.mjs bundle (scripts/build-agent-sdk.sh). Callers that
 * already import bridgeEnabled.ts register the gate; the SDK path never does,
 * so the shim defaults to active (matching isCseShimEnabled()'s own default).
 * CCR v2 compat 层的会话 ID 标签转换辅助函数。
 *
 * 生活在自己的文件中（而非 workSecret.ts），以便 sessionHandle.ts
 * 和 replBridgeTransport.ts（bridge.mjs 入口点）可以从 workSecret.ts 导入，
 * 而无需引入这些 retag 函数。
 *
 * isCseShimEnabled kill switch 通过 setCseShimGate() 注入，以避免
 * bridgeEnabled.ts → growthbook.ts → config.ts 的静态导入 — 所有这些
 * 都从 sdk.mjs bundle 中禁止（scripts/build-agent-sdk.sh）。已经导入
 * bridgeEnabled.ts 的调用者注册门禁；SDK 路径从不这样做，
 * 因此 shim 默认为 active（匹配 isCseShimEnabled() 自身的默认值）。
 */

let _isCseShimEnabled: (() => boolean) | undefined

/**
 * Register the GrowthBook gate for the cse_ shim. Called from bridge
 * init code that already imports bridgeEnabled.ts.
 * 为 cse_ shim 注册 GrowthBook 门禁。从已经导入 bridgeEnabled.ts 的
 * bridge init 代码调用。
 */
export function setCseShimGate(gate: () => boolean): void {
  _isCseShimEnabled = gate
}

/**
 * Re-tag a `cse_*` session ID to `session_*` for use with the v1 compat API.
 *
 * Worker endpoints (/v1/code/sessions/{id}/worker/*) want `cse_*`; that's
 * what the work poll delivers. Client-facing compat endpoints
 * (/v1/sessions/{id}, /v1/sessions/{id}/archive, /v1/sessions/{id}/events)
 * want `session_*` — compat/convert.go:27 validates TagSession. Same UUID,
 * different costume. No-op for IDs that aren't `cse_*`.
 *
 * bridgeMain holds one sessionId variable for both worker registration and
 * session-management calls. It arrives as `cse_*` from the work poll under
 * the compat gate, so archiveSession/fetchSessionTitle need this re-tag.
 * 将 `cse_*` session ID 重新标记为 `session_*`，用于 v1 compat API。
 *
 * Worker endpoints（/v1/code/sessions/{id}/worker/*）需要 `cse_*`；
 * 这是 work poll 提供的内容。面向客户端的 compat endpoints
 *（/v1/sessions/{id}, /v1/sessions/{id}/archive, /v1/sessions/{id}/events）
 * 需要 `session_*` — compat/convert.go:27 验证 TagSession。同一个 UUID，
 * 不同的 costume。对于不是 `cse_*` 的 ID 无操作。
 *
 * bridgeMain 为 worker 注册和会话管理调用持有一个 sessionId 变量。
 * 在 compat 门禁下，它作为 `cse_*` 从 work poll 到达，
 * 因此 archiveSession/fetchSessionTitle 需要这个重新标记。
 */
export function toCompatSessionId(id: string): string {
  if (!id.startsWith('cse_')) return id
  if (_isCseShimEnabled && !_isCseShimEnabled()) return id
  return 'session_' + id.slice('cse_'.length)
}

/**
 * Re-tag a `session_*` session ID to `cse_*` for infrastructure-layer calls.
 *
 * Inverse of toCompatSessionId. POST /v1/environments/{id}/bridge/reconnect
 * lives below the compat layer: once ccr_v2_compat_enabled is on server-side,
 * it looks sessions up by their infra tag (`cse_*`). createBridgeSession still
 * returns `session_*` (compat/convert.go:41) and that's what bridge-pointer
 * stores — so perpetual reconnect passes the wrong costume and gets "Session
 * not found" back. Same UUID, wrong tag. No-op for IDs that aren't `session_*`.
 * 将 `session_*` session ID 重新标记为 `cse_*`，用于基础设施层调用。
 *
 * toCompatSessionId 的反向。POST /v1/environments/{id}/bridge/reconnect
 * 位于 compat 层之下：一旦 ccr_v2_compat_enabled 在服务器端开启，
 * 它通过 infra tag（`cse_*`）查找会话。createBridgeSession 仍然返回
 * `session_*`（compat/convert.go:41），这是 bridge-pointer 存储的 —
 * 因此永久 reconnect 传递了错误的 costume 并得到"Session not found"。
 * 同一个 UUID，错误的标签。对于不是 `session_*` 的 ID 无操作。
 */
export function toInfraSessionId(id: string): string {
  if (!id.startsWith('session_')) return id
  return 'cse_' + id.slice('session_'.length)
}