"""BG run worker + 渠道入站对话核心(从 app.py 析出,2026-07-23 拆分)。

`run_agent_bg` 是「一次 run」的工作线程本体(build_agent → agent.run → 写终态),
web 路由与渠道回调都经它起 run;`run_channel_conversation` 是微信/企微共用的
入站对话编排(§8.7)。依赖 web 层 broker/sink 桥事件,故住 web/ 不下沉 core。
"""
from __future__ import annotations

import asyncio
from uuid import UUID

from sqlalchemy import select, update

from core.paths import from_db_path
from core.storage import session_scope
from core.storage.models import Task
from core.storage.telemetry import record_run_error
from core.toolfail import alert_provider_critical

from .broker import broker
from .sinks import WebEventSink


def run_agent_bg(
    task_id: UUID, user_id: UUID, user_message: str,
    image_variant: str = "", video_variant: str = "",
    scheduled: bool = False,
    *, user_message_persisted: bool = False,
) -> None:
    """工作线程:`build_agent(resume=True)` → 装 WebEventSink + cancel_check → `agent.run` → 写 tasks.run_status。

    sink 通过 broker.emit 桥事件回 asyncio loop;agent.run 是 sync,所以在 to_thread 跑。
    user_id 必须从 JWT 那侧透传过来 —— 决定 memory_block 读哪个 per-user 子树。
    cancel_check 桥 broker.is_cancelled,loop 在 stream chunk 间 + 工具调用之间 poll;
    cancel 延迟 ~ 单 chunk 间隔(100ms 级);seedance 轮询间也读这个 cancel_check 用于
    用户停止按钮(必须在 build_agent 阶段就传进去,因为 SeedanceTool ctor 持有它,
    不能像以前那样 build_agent 返回后再赋 agent.cancel_check)。
    `ok` 收尾回 `idle`;`cancelled`(用户停止)与 `error` 一样落持久终态 —— 前端据此
    补「已停止」/ 错误卡(扛过收尾重渲),下次起新 run(post_message 写 running)覆盖清掉。

    image_variant / video_variant:本 run 用哪个 image/video variant 装 tool(空 → yaml 第一个)。
    随消息 POST 传进来,不入 DB —— UI 下拉的选择就跟在这一条消息上生效。
    user_message_persisted=True 供 Web / 渠道 / 定时生命周期入口：用户消息已和
    tasks.running 同事务提交，worker 从 Session 恢复后直接处理最后一条 user，
    避免重复落库。CLI 等非 Web 入口保持旧行为。
    """
    from core.agent_builder import build_agent, sync_task_tokens
    cancel_check = lambda tid=task_id: broker.is_cancelled(tid)
    try:
        broker.emit(task_id, {"type": "run_start"})
        agent, session, sid, task_state, task_dir = build_agent(
            session_id=str(task_id), resume=True, user_id=user_id,
            image_variant=image_variant,
            video_variant=video_variant,
            cancel_check=cancel_check,
            scheduled_run=scheduled,
        )
        agent.sink = WebEventSink(broker, task_id)
        result = (
            agent.run_persisted_turn()
            if user_message_persisted
            else agent.run(user_message)
        )
        sync_task_tokens(task_state)
        # 收尾终态:agent.run 在任一取消路径都 return "[cancelled]"(loop.py)——
        # 用户停止 → 落持久 cancelled(前端 renderPersistedRunTerminal 据此补「已停止」卡,
        # 扛过收尾 loadMessages 整屏重建);正常完成 → 回 idle。两者都清 run_error。
        # cancelled 与 error 同为持久终态,下次起新 run(post_message 写 running)自然覆盖。
        final_status = "cancelled" if result == "[cancelled]" else "idle"
        with session_scope() as s:
            s.execute(
                update(Task).where(Task.task_id == task_id).values(
                    run_status=final_status, run_error=None,
                )
            )
        # 当前 working_dir 不能在 agent 仍执行工具时改名（executor/system prompt 都握
        # 旧 cwd）。rename_working_dir 工具只登记意图；正常完成并退出 running 后，
        # 在 done 事件前统一走 DB-aware 服务。取消时不执行，避免用户停止后仍发生变更。
        rename_to = agent.deferred_actions.rename_working_dir_to
        if final_status == "idle" and rename_to:
            from core.working_dirs import WorkingDirRenameError, rename_working_dir
            try:
                renamed = rename_working_dir(
                    user_id=user_id,
                    old_path=task_dir,
                    new_path=task_dir.parent / rename_to,
                )
                broker.emit(task_id, {
                    "type": "warn",
                    "level": "info",
                    "msg": f"工作目录已重命名为 {renamed.new_path.name}",
                })
            except WorkingDirRenameError as e:
                broker.emit(task_id, {
                    "type": "warn",
                    "msg": f"工作目录改名未执行：{e}",
                })
            except Exception as e:
                # 延迟附加动作失败不应把已经成功的对话 run 改标 error；保留目录原状，
                # 给当前订阅者明确提示，下轮可重试。
                broker.emit(task_id, {
                    "type": "warn",
                    "msg": (
                        "工作目录改名未执行："
                        f"{type(e).__name__}: {e}"
                    ),
                })
    except Exception as e:
        err = f"{type(e).__name__}: {e}"
        mp = ""
        try:
            with session_scope() as s:
                mp = s.execute(
                    select(Task.model_profile).where(Task.task_id == task_id)
                ).scalar_one_or_none() or ""
                s.execute(
                    update(Task).where(Task.task_id == task_id).values(
                        run_status="error", run_error=err,
                    )
                )
        except Exception:
            pass  # DB 写失败不阻断后续可见 error 事件
        # error 是 SSE 终止事件，客户端收到后会立即回读 task meta；先落 DB 终态再 emit，
        # 避免它抢读到旧 running，导致持久错误卡和中断进度面板偶发不显示。
        broker.emit(task_id, {"type": "error", "msg": err})
        # 留痕 + 告警(0.58.21,反 2a1bc25d 教训:Zai 余额不足连挂 3 次续跑无人知):
        # run_error 列只留最后一次,usage_events(kind=run_error)才是聚合面板/巡检
        # 邮件的完整数据源;余额/认证类 provider 级错误另走即时邮件(6h 签名冷却)。
        # 两路都静默失败 —— 留痕/告警绝不能在错误路径上再抛。
        try:
            record_run_error(
                task_id=task_id, user_id=user_id, model_profile=mp, error=err,
            )
        except Exception:
            pass
        alert_provider_critical(err, task_id=task_id, model_profile=mp)
    finally:
        broker.clear_cancel(task_id)
        broker.close(task_id)


async def run_channel_conversation(app, uid, text, attachments, *, channel):
    """渠道无关的入站对话核心(§8.7):解析/建该用户该渠道常驻 task → 落盘附件 → 抢 run 锁
    → run_agent_bg → 取 assistant 回复文本。两渠道各一张会话 task,互不串扰。

    channel:'wechat'(个人微信 ClawBot,绑定快照取 chat_task_id)| 'wecom'(企业微信,
    wecom 绑定行取 chat_task_id)。attachments:已下载解密的入站附件(可空,wecom 暂只收文本)。
    返回回复文本(供 ClawBot 回流 / wecom 主动推回)。
    """
    from core.wechat import service as _wx
    from core.wechat.ilink import attachment_basename
    from core.wechat.inbound import extract_last_assistant_text
    from .run_lifecycle import (
        RunScheduleError,
        RunTaskBusy,
        RunTaskNotFound,
        claim_run_with_message,
        schedule_claimed_run,
    )

    # 解析/建该渠道常驻 chat task(不存在自动建)—— 与 push 记录(send_to_user)共用
    # ensure_channel_chat_task,避免两条建 task 路径漂移。wechat 无 binding → 返回 None。
    tid = await asyncio.to_thread(_wx.ensure_channel_chat_task, uid, channel)
    if tid is None:
        return ""

    # 手动「新话题」命令:硬重置上下文窗口(base=总数),不跑 agent,直接回执。之前的
    # 对话全留 DB(网页端可翻),只是不再喂模型。纯文本命令,有附件则不当命令处理。
    if not attachments and text.strip() in _wx.NEW_TOPIC_COMMANDS:
        await asyncio.to_thread(_wx.reset_channel_context, tid, hard=True)
        return "已开启新话题,之前的对话已归档(网页端仍可查看完整历史)。"

    # 快捷指令展开(渠道无关,见 core/shortcuts.py):整条精确命中触发词 → 文本换成完整指令
    # 再照常跑;不进上下文、不问模型。放「新话题」命令之后、附件/gap 之前:展开后的文本仍会
    # 被下面的附件行追加,故打「简报」+ 附图也成立。
    from core.agent_builder import resolve_workspace as _resolve_ws
    from core import shortcuts as _shortcuts
    _ws = await asyncio.to_thread(_resolve_ws, None)
    text, _hit = await asyncio.to_thread(_shortcuts.expand, _ws, uid, text)
    if _hit:
        print(f"[shortcut] {str(uid)[:8]} '{_hit}' expanded")

    # 自动分段:距上次消息超过 gap 阈值 → 软重置(base=最后一条 user 消息 idx,保留上一轮
    # 原文做续聊锚点)。在入站消息落库前判断,故 last_at 取的是上一轮的时间。push 不走这。
    from core.agent_builder import load_config as _load_config
    gap_hours = float(
        (_load_config().get("channel") or {}).get(
            "session_gap_hours", _wx.SESSION_GAP_HOURS_DEFAULT
        )
    )
    await asyncio.to_thread(_wx.maybe_gap_reset, tid, gap_hours)

    # 落盘入站附件到 <wd>/inbound/,拼 [用户上传的...] 行进 text(复用 web 端粘贴图约定)
    if attachments:
        from datetime import datetime

        with session_scope() as s:
            wd_db = s.execute(
                select(Task.working_dir).where(Task.task_id == tid)
            ).scalar_one()
        inbound_dir = from_db_path(wd_db) / "inbound"
        inbound_dir.mkdir(parents=True, exist_ok=True)
        ts = datetime.now().strftime("%Y%m%d-%H%M%S")
        lines: list[str] = []
        for i, att in enumerate(attachments):
            if not att.data:
                continue
            base = attachment_basename(att)
            name = f"{ts}-{i}-{base}"
            (inbound_dir / name).write_bytes(att.data)
            rel = f"inbound/{name}"
            tag = "[用户上传的参考图]" if att.kind == "image" else "[用户上传的文件]"
            lines.append(f"{tag} {rel}")
        if lines:
            extra = "\n".join(lines)
            text = f"{text}\n\n{extra}" if text.strip() else extra

    # 渠道消息也与 running 原子提交，消除进程在 worker 启动前退出时的丢输入窗口。
    try:
        claim_run_with_message(tid, uid, text)
    except RunTaskNotFound:
        return "[出错] 对话 task 不存在"
    except RunTaskBusy:
        return "上一条还在处理中,请稍候再发。"
    try:
        runner = schedule_claimed_run(app, tid, uid, text)
    except RunScheduleError as e:
        return f"[出错] {e}"
    await runner

    with session_scope() as s:
        st = s.execute(
            select(Task.run_status, Task.run_error).where(Task.task_id == tid)
        ).first()
    if st is not None and st.run_status == "error":
        return f"[出错] {st.run_error}"
    reply = await asyncio.to_thread(extract_last_assistant_text, tid)
    return reply or "(本轮无文本回复)"


async def transcribe_wecom_voice(media_id: str) -> str:
    """企业微信入站语音 → 文本:media/get 下 AMR → `core.audio.transcribe_voice`
    (ffmpeg 解 16k PCM → 讯飞 IAT 整段转写,60s 截断在里面)。

    返回转写文本(空串=没听出内容)。失败抛异常,message 可直接给用户看
    (XfyunASRNotConfigured / AudioNotConfigured 自带配置指引)。
    """
    from core import audio
    from core.wechat import wecom

    data, _fname = await asyncio.to_thread(wecom.download_media, media_id)
    return await audio.transcribe_voice(data)