yee88 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

yee88/cli/handoff.py

@@ -223,6 +223,8 @@ def send(
             typer.echo("❌ 未找到 OpenCode 会话", err=True)
             raise typer.Exit(1)
         
+        typer.echo("\n📲 会话接力 - 将电脑端会话发送到 Telegram 继续对话")
+        typer.echo("━" * 50)
         typer.echo("\n📋 最近的会话:\n")
         for i, s in enumerate(sessions[:10], 1):
             title_display = s.title[:40] if s.title else s.project_name

yee88/cron/manager.py

@@ -76,6 +76,8 @@ class CronManager:
                     "last_run": job.last_run,
                     "next_run": job.next_run,
                     "one_time": job.one_time,
+                    "engine": job.engine,
+                    "model": job.model,
                 }
                 for job in self.jobs
             ]

yee88/cron/models.py

@@ -1,4 +1,5 @@
 from dataclasses import dataclass
+from typing import Optional
 
 
 @dataclass
@@ -11,3 +12,5 @@ class CronJob:
     last_run: str = ""
     next_run: str = ""
     one_time: bool = False
+    engine: Optional[str] = None
+    model: Optional[str] = None

yee88/ids.py

@@ -7,7 +7,7 @@ _ID_RE = re.compile(ID_PATTERN)
 
 RESERVED_CLI_COMMANDS = frozenset({"config", "doctor", "init", "plugins"})
 RESERVED_CHAT_COMMANDS = frozenset(
-    {"cancel", "file", "new", "agent", "model", "reasoning", "trigger", "topic", "ctx"}
+    {"cancel", "file", "new", "fork", "agent", "model", "reasoning", "trigger", "topic", "ctx"}
 )
 RESERVED_ENGINE_IDS = RESERVED_CLI_COMMANDS | RESERVED_CHAT_COMMANDS
 RESERVED_COMMAND_IDS = RESERVED_CLI_COMMANDS | RESERVED_CHAT_COMMANDS

yee88/skills/yee88/SKILL.md

@@ -525,12 +525,38 @@ yee88 cron run <task-id>
    - 执行后自动从列表中删除
    - 无法对一次性任务使用 enable/disable（执行前自动删除）
 
+### 10. 会话接力（Handoff）
+
+将当前 OpenCode 会话上下文发送到 Telegram，方便在手机上继续对话。
+
+```bash
+yee88 handoff
+```
+
+功能：
+- 自动列出当前项目的最近会话（带话题名称）
+- 选择会话后，创建新的 Telegram Topic
+- 将会话上下文和最近消息发送到 Topic
+- 在 Telegram 中直接继续对话
+
+选项：
+- `--session, -s`: 指定会话 ID（默认交互选择）
+- `--limit, -n`: 包含的消息数量（默认 3）
+- `--project, -p`: 项目名称
+
+示例：
+```bash
+yee88 handoff
+yee88 handoff -s ses_abc123 -n 5
+```
+
 ## 完整命令速查表
 
 | 命令 | 说明 |
 |------|------|
 | `yee88` | 启动 yee88 |
 | `yee88 init <alias>` | 注册项目 |
+| `yee88 handoff` | 会话接力到 Telegram |
 | `yee88 config path` | 查看配置路径 |
 | `yee88 config list` | 列出配置 |
 | `yee88 config get <key>` | 获取配置项 |

yee88/telegram/commands/handlers.py

@@ -18,6 +18,7 @@ from .reasoning import _handle_reasoning_command as handle_reasoning_command
 from .topics import _handle_chat_new_command as handle_chat_new_command
 from .topics import _handle_chat_ctx_command as handle_chat_ctx_command
 from .topics import _handle_ctx_command as handle_ctx_command
+from .topics import _handle_fork_command as handle_fork_command
 from .topics import _handle_new_command as handle_new_command
 from .topics import _handle_topic_command as handle_topic_command
 from .trigger import _handle_trigger_command as handle_trigger_command
@@ -31,6 +32,7 @@ __all__ = [
     "handle_ctx_command",
     "handle_file_command",
     "handle_file_put_default",
+    "handle_fork_command",
     "handle_media_group",
     "handle_model_command",
     "handle_new_command",

yee88/telegram/commands/menu.py

@@ -83,7 +83,10 @@ def build_bot_commands(
         commands.append({"command": cmd, "description": description})
         seen.add(cmd)
     if include_topics:
-        for cmd, description in [("topic", "create or bind a topic")]:
+        for cmd, description in [
+            ("topic", "create or bind a topic"),
+            ("fork", "fork current topic to new topic"),
+        ]:
             if cmd in seen:
                 continue
             commands.append({"command": cmd, "description": description})

yee88/telegram/commands/topics.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import re as _re
 from typing import TYPE_CHECKING
 
 from ...context import RunContext
@@ -340,3 +341,84 @@ async def _handle_topic_command(
         message=RenderedMessage(text=rendered_text, extra={"entities": entities}),
         options=SendOptions(thread_id=thread_id),
     )
+
+
+_FORK_TITLE_PATTERN = _re.compile(r"^(.+) \(fork #(\d+)\)$")
+
+
+def _get_forked_title(title: str | None) -> str:
+    if title is None:
+        return "topic (fork #1)"
+    match = _FORK_TITLE_PATTERN.match(title)
+    if match:
+        base = match.group(1)
+        num = int(match.group(2))
+        return f"{base} (fork #{num + 1})"
+    return f"{title} (fork #1)"
+
+
+async def _handle_fork_command(
+    cfg: TelegramBridgeConfig,
+    msg: TelegramIncomingMessage,
+    store: TopicStateStore,
+    *,
+    resolved_scope: str | None = None,
+    scope_chat_ids: frozenset[int] | None = None,
+) -> None:
+    from ...model import ResumeToken
+
+    reply = make_reply(cfg, msg)
+    error = _topics_command_error(
+        cfg,
+        msg.chat_id,
+        resolved_scope=resolved_scope,
+        scope_chat_ids=scope_chat_ids,
+    )
+    if error is not None:
+        await reply(text=error)
+        return
+    tkey = _topic_key(msg, cfg, scope_chat_ids=scope_chat_ids)
+    if tkey is None:
+        await reply(text="this command only works inside a topic.")
+        return
+
+    snapshot = await store.get_thread(*tkey)
+    current_title = snapshot.topic_title if snapshot else None
+    forked_title = _get_forked_title(current_title)
+
+    created = await cfg.bot.create_forum_topic(msg.chat_id, forked_title)
+    if created is None:
+        await reply(text="failed to create forked topic.")
+        return
+
+    new_thread_id = created.message_thread_id
+
+    if snapshot and snapshot.context:
+        await store.set_context(
+            msg.chat_id,
+            new_thread_id,
+            snapshot.context,
+            topic_title=forked_title,
+        )
+
+    if snapshot and snapshot.sessions:
+        for engine, resume_value in snapshot.sessions.items():
+            token = ResumeToken(engine=engine, value=resume_value)
+            await store.set_session_resume(msg.chat_id, new_thread_id, token)
+
+    await reply(text=f"forked to new topic `{forked_title}`.")
+
+    context_label = _format_context(cfg.runtime, snapshot.context) if snapshot and snapshot.context else "none"
+    sessions_label = ", ".join(sorted(snapshot.sessions.keys())) if snapshot and snapshot.sessions else "none"
+    welcome_text = (
+        f"forked from previous topic\n\n"
+        f"context: `{context_label}`\n"
+        f"sessions: {sessions_label}\n\n"
+        "continue your conversation here!"
+    )
+    rendered_text, entities = prepare_telegram(MarkdownParts(header=welcome_text))
+    await cfg.exec_cfg.transport.send(
+        channel_id=msg.chat_id,
+        message=RenderedMessage(text=rendered_text, extra={"entities": entities}),
+        options=SendOptions(thread_id=new_thread_id),
+    )

yee88/telegram/loop.py

@@ -44,6 +44,7 @@ from .commands.handlers import (
     handle_ctx_command,
     handle_file_command,
     handle_file_put_default,
+    handle_fork_command,
     handle_media_group,
     handle_model_command,
     handle_new_command,
@@ -224,6 +225,15 @@ def _dispatch_builtin_command(
                 resolved_scope=resolved_scope,
                 scope_chat_ids=scope_chat_ids,
             )
+        elif command_id == "fork":
+            handler = partial(
+                handle_fork_command,
+                cfg,
+                msg,
+                topic_store,
+                resolved_scope=resolved_scope,
+                scope_chat_ids=scope_chat_ids,
+            )
         elif command_id == "topic":
             handler = partial(
                 handle_topic_command,
@@ -1082,7 +1092,9 @@ async def run_main_loop(
 
                 async def _execute_cron_job(job: CronJob) -> None:
                     try:
+                        from ..model import EngineId
                         context = RunContext(project=job.project) if job.project else None
+                        engine_override: EngineId | None = job.engine if job.engine else None
                         await run_job(
                             chat_id=cfg.chat_id,
                             user_msg_id=0,
@@ -1091,6 +1103,9 @@ async def run_main_loop(
                             context=context,
                             thread_id=None,
                             force_hide_resume_line=True,
+                            force_new_session=True,
+                            run_options_model=job.model,
+                            engine_override=engine_override,
                         )
                     except Exception as exc:
                         logger.error(
@@ -1158,6 +1173,8 @@ async def run_main_loop(
                 engine_override: EngineId | None = None,
                 progress_ref: MessageRef | None = None,
                 force_hide_resume_line: bool = False,
+                force_new_session: bool = False,
+                run_options_model: str | None = None,
             ) -> None:
                 topic_key = (
                     (chat_id, thread_id)
@@ -1168,6 +1185,9 @@ async def run_main_loop(
                     )
                     else None
                 )
+                if force_new_session:
+                    topic_key = None
+                    chat_session_key = None
                 stateful_mode = topic_key is not None or chat_session_key is not None
                 show_resume_line = False if force_hide_resume_line else should_show_resume_line(
                     show_resume_line=cfg.show_resume_line,
@@ -1176,7 +1196,7 @@ async def run_main_loop(
                 )
                 engine_for_overrides = (
                     resume_token.engine
-                    if resume_token is not None
+                    if resume_token is not None and not force_new_session
                     else engine_override
                     if engine_override is not None
                     else cfg.runtime.resolve_engine(
@@ -1193,6 +1213,15 @@ async def run_main_loop(
                     topic_store=state.topic_store,
                     system_prompt=cfg.runtime.resolve_system_prompt(context),
                 )
+                if run_options_model:
+                    if run_options is None:
+                        run_options = EngineRunOptions(model=run_options_model)
+                    else:
+                        run_options = EngineRunOptions(
+                            model=run_options_model,
+                            reasoning=run_options.reasoning,
+                            system=run_options.system,
+                        )
                 await run_engine(
                     exec_cfg=cfg.exec_cfg,
                     runtime=cfg.runtime,
@@ -1200,7 +1229,7 @@ async def run_main_loop(
                     chat_id=chat_id,
                     user_msg_id=user_msg_id,
                     text=text,
-                    resume_token=resume_token,
+                    resume_token=None if force_new_session else resume_token,
                     context=context,
                     reply_ref=reply_ref,
                     on_thread_known=wrap_on_thread_known(

{yee88-0.7.0.dist-info → yee88-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yee88
-Version: 0.7.0
+Version: 0.8.0
 Summary: Telegram bridge for Codex, Claude Code, and other agent CLIs.
 Project-URL: Homepage, https://github.com/banteg/yee88
 Project-URL: Documentation, https://yee88.dev/

{yee88-0.7.0.dist-info → yee88-0.8.0.dist-info}/RECORD

@@ -10,7 +10,7 @@ yee88/context.py,sha256=2GXdWY8KpWbEARJNo34unLN8nqGBtiE72Z_mjwrJTUM,187
 yee88/directives.py,sha256=28XG1f7yQs8GAgvPoy5g0pTe_aaVQeWFSD4-S5mC5oo,4583
 yee88/engines.py,sha256=uXtGie-XkQDB1LROTjPlCkYKbCu7XgyTr0yGn837gN4,1646
 yee88/events.py,sha256=1yo6l5D4xFreyPoU1d4L1ckaplPizxpFeJJevP8JDtk,4225
-yee88/ids.py,sha256=uU2A7x61Xn3_Pj-YgY5-EruoOtwDSXOp2D-XduTqAEo,534
+yee88/ids.py,sha256=n8ULXEUpeHRCGc571ZH2IAIGPRuf9lB0g1pZRFm8dWY,542
 yee88/lockfile.py,sha256=xCSsxVQMqnCN2RWFkkDOVg1qm5D-Sb4AMKr6FdP0kbY,4162
 yee88/logging.py,sha256=aqoIClE5_vlASKXsc9FjrmsmBy-7jLYOomHheSWSadA,8227
 yee88/markdown.py,sha256=__2qyoBXTBZVVD7DgZvjDaj67xQCJHMfU0yQ8jcY1pQ,9144
@@ -32,7 +32,7 @@ yee88/cli/__init__.py,sha256=_Ji5MfYqvF2nuC7_sgbtZOOe0pvIuk0RQ47Hw_aCV_k,6684
 yee88/cli/config.py,sha256=gTDdaTkJGGooeGECgcOXkpF-Y7Kmqi_Iyum0ghQzazg,9560
 yee88/cli/cron.py,sha256=uvzgkAmMom8sDMjLgdMcB8V7DACmmdoGTiefif1Ol3U,6215
 yee88/cli/doctor.py,sha256=FPLXk-ZSPZiHtWrncEqborcz4e1dhb3S5sUVcOw-n60,6000
-yee88/cli/handoff.py,sha256=LPDTSZi4TucxtWgI8d7SUDImz0n4cW9UH4JOYKt4tgo,9292
+yee88/cli/handoff.py,sha256=gd_4HE98wooT4n9gM2if5LkXZMoMi47Fd3A5U4ogBzE,9417
 yee88/cli/init.py,sha256=y1Z08rh9t4RPhzsgJRtopgd6UvjEPYi9Wfv_t2KlrxI,3761
 yee88/cli/onboarding_cmd.py,sha256=VNJl9cpfz-Bo7LNpGUIH-VtbOFdATTn1ry21cwtyQQM,4170
 yee88/cli/plugins.py,sha256=Kxr1FgLIjN6c8il83_cfE9nix0jYPUvI6KXtol3Swow,6319
@@ -40,8 +40,8 @@ yee88/cli/reload.py,sha256=ays9R2kJ0IQEPGfxb3BY7R2mxbJBmp325dKrqqv1nw8,3552
 yee88/cli/run.py,sha256=qKMJCEwoiNN4Qqt59Gmm1bDQHTboGf8JO73gMeACAck,14197
 yee88/cli/topic.py,sha256=6j_o0wpHMfkyeyj9wcjU5T5PVXw_cOM0qM5fsMDRiIw,11019
 yee88/cron/__init__.py,sha256=WZN2RcqJD4i6ZPZjI6b_sKI1VxhNGzhDu2Pju5u9J0o,152
-yee88/cron/manager.py,sha256=MOKYxGMEDH-rMMdd5nZmltp1kimzrO9L8OuV-HIoKnc,5500
-yee88/cron/models.py,sha256=IZtUvMBr2_wZbgEWR3U9yQW-QEOMzUybDER8B7Ne8Go,224
+yee88/cron/manager.py,sha256=_gqPXgnflb-i8-Mb8GS8LgcSGDbRa_X6K64xGPQXkt4,5582
+yee88/cron/models.py,sha256=Ue7Q9ZhA34t0y4HttZrJX9aU_v8G0dT4fsotz1iGpXg,317
 yee88/cron/scheduler.py,sha256=ITNqpF4MXUieuuFBvVHgzOVxxR5bnhGAFYvWTJWy-IU,1922
 yee88/runners/__init__.py,sha256=McKaMqLXT9dJlgiEwKf6biD0Ns66Fk7SrxwtcP0ZgzI,30
 yee88/runners/claude.py,sha256=mj-L_V-cuCUWL9BW90I645EgDsjRHNdmpLQxN7skUL0,15518
@@ -56,7 +56,7 @@ yee88/schemas/claude.py,sha256=HqOik1O4u3WcMb4RN2cTVJw6VRYn3EaYj8h5Sevs1XY,5702
 yee88/schemas/codex.py,sha256=bgIsh35LuaqoOYdTl6BWR-mn-mvh3ouwes_Jn9JMVXg,3412
 yee88/schemas/opencode.py,sha256=ODhnKXTzxZ_8qaQ7AYqXB7J-XoAjQnXbGMBVTUEM2qY,1175
 yee88/schemas/pi.py,sha256=e5ETawxk8jrdJbEbeBI_pWQKeCFiBBZLEF-Wo5Fx0XY,2680
-yee88/skills/yee88/SKILL.md,sha256=rw2LeFbsZBeFWaDAVR8-h37pnzfn8N1rkeukCDAcfew,14479
+yee88/skills/yee88/SKILL.md,sha256=GrZ7a8sm2ArUo5OdeUC3OECavnykx2DcsBI5EdtdvuQ,15113
 yee88/telegram/__init__.py,sha256=hX_Wvu920dNLTDrKlj0fsZFSewOo-_otN26O1UNPNA4,452
 yee88/telegram/api_models.py,sha256=d3H4o2sRZuFgfZfxF1Y1z_xzzCoOy3bKhMeKggYCW3w,538
 yee88/telegram/api_schemas.py,sha256=Xj-i68GFSb9Uk6GhU2Etp-gYhAat9DKYcvQN9av1NPQ,3823
@@ -70,7 +70,7 @@ yee88/telegram/context.py,sha256=Hb8-k-YbAjO0EmZ35hA8yyMvl1kozgYHUL1L-lbCglA,468
 yee88/telegram/engine_defaults.py,sha256=n6ROkTmP_s-H5AhPz_OdT62oZf0QtZJyFEDjp5gfub4,2594
 yee88/telegram/engine_overrides.py,sha256=kv2j102VP-Bqzbutd5ApBkjW3LmVwvCYixsFewVXVeY,3122
 yee88/telegram/files.py,sha256=Cvmw6r_ocSb3jLzJLGVbzr46m8cRU159majJ1-A5lvg,5053
-yee88/telegram/loop.py,sha256=-UpsnoCjQrrpEhXgIy1l7YOU2AJ-HG4m2Gjk38Bn0Vo,69471
+yee88/telegram/loop.py,sha256=r_z2gKRf1Z9dLF8qb8Df3Id__ycfHIEFmGpQ4VHLI00,70813
 yee88/telegram/onboarding.py,sha256=QWYaJT_s2bujDxzKjsZuLytyxs_XFDRuiBrsZGRjoOw,35633
 yee88/telegram/outbox.py,sha256=OcoRyQ7zmQCXR8ZXEMK2f_7-UMRVRAbBgmJGS1u_lcU,5939
 yee88/telegram/parsing.py,sha256=5PvIPns1NnKryt3XNxPCp4BpWX1gI8kjKi4VxcQ0W-Q,7429
@@ -87,16 +87,16 @@ yee88/telegram/commands/cancel.py,sha256=jE93VjztNETlmAgb7FJX0sLR3O-NHy5XcraUbK1
 yee88/telegram/commands/dispatch.py,sha256=zcvX0V6_klf5jXqJlBwAK25e83WC9z3-KoRcDbeWre0,3572
 yee88/telegram/commands/executor.py,sha256=eczs7Ds_S8GVX2_OvdmN23y6zE1fhYTpIAuchfH0eRU,14781
 yee88/telegram/commands/file_transfer.py,sha256=yfopf_If9f7Scaz4dlUsfcrVvg24QmQdajLzemaENy0,17697
-yee88/telegram/commands/handlers.py,sha256=2zySjRW49e1iv2QJW6xq2m9j0t-uz9_FCJZpE7NhIDA,1834
+yee88/telegram/commands/handlers.py,sha256=KsmV6U_TKeNBvy5UdjuC4DQ3_xYiw_CFIYNrrQYlUfQ,1925
 yee88/telegram/commands/media.py,sha256=drSKTf_BbyvXOGhS9UKwey_243Ic5XissoaxCykpd-c,5045
-yee88/telegram/commands/menu.py,sha256=AvEgKQUZageBx7TwV2-V_IGhT7AC0qUTtAHjcLIweNY,4466
+yee88/telegram/commands/menu.py,sha256=vkvH0E4-sizhtyLgq5YRcptcWkzsVgMHkADxkQGscFo,4546
 yee88/telegram/commands/model.py,sha256=GwdEHuebm02aUIqkcvznPh0FSViVlAjxeMks7TjFXIE,12729
 yee88/telegram/commands/overrides.py,sha256=lLlIuCWkKwbS5WlQOOr_Ftv_EvfHR9DhjBpWaf6FBng,4853
 yee88/telegram/commands/parse.py,sha256=0QVW1TVdBWadLbpJ9lRY3s7W4Cm62JJa9jfAaFHQmXU,887
 yee88/telegram/commands/plan.py,sha256=iKsaRBS-qIfvAaxik5ZEA_VzAnFwx7aEED8sKXNq1wE,487
 yee88/telegram/commands/reasoning.py,sha256=UFEJOHm4d0v2jFh5HC3oQGS41NYKbmJHRTaAmu_LiGo,8188
 yee88/telegram/commands/reply.py,sha256=a3zkNjKzn3qZXEZFXuflX-tdhQKQyhYDqZskMy1nS3o,580
-yee88/telegram/commands/topics.py,sha256=Vs4BsVGRfsUSlZupOiWp7vpESm_0z-4gHOWuHOEtu7U,11207
+yee88/telegram/commands/topics.py,sha256=TBUdhqtTyDv7I6qFlxeENPMfvZGkYUjvHsEI2Q2b2Mc,13899
 yee88/telegram/commands/trigger.py,sha256=RgB4V7NoFdfDLk83xl3BPTsIIVr5A2zCNstR_5B_mEw,5201
 yee88/utils/__init__.py,sha256=cV9_7v07Y6XkrUju0lHdO1ia0-Q57NqyFVMaFCg--do,34
 yee88/utils/git.py,sha256=SVKcPNl2mUrv-cVHZQ5b8QXWKi33e_Jc4_vfCLwagkg,2413
@@ -104,8 +104,8 @@ yee88/utils/json_state.py,sha256=cnSvGbB9zj90GdYSyigId1M0nEx54T3A3CqqhkAm9kQ,524
 yee88/utils/paths.py,sha256=_Tp-LyFLeyGD0P0agRudLuT1NR_XTIpryxk3OYDJAGQ,1318
 yee88/utils/streams.py,sha256=TQezA-A5VCNksLOtwsJplfr8vm1xPTXoGxvik8G2NPI,1121
 yee88/utils/subprocess.py,sha256=2if6IxTZVSB1kDa8SXw3igj3E-zhKB8P4z5MVe-odzY,2169
-yee88-0.7.0.dist-info/METADATA,sha256=xY44BCi-27tb84I7moGx0D_2BQ_3PUzN95kt4cmMqkY,4340
-yee88-0.7.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-yee88-0.7.0.dist-info/entry_points.txt,sha256=P4MVZ_sZfrHaARVMImNJjoGamP8VDukARWMKfDh20V8,282
-yee88-0.7.0.dist-info/licenses/LICENSE,sha256=poyQ59wnbmL3Ox3TiiephfHvUpLvJl0DwLFFgqBDdHY,1063
-yee88-0.7.0.dist-info/RECORD,,
+yee88-0.8.0.dist-info/METADATA,sha256=_oAnZ-DG_kvqqQcf16urGMb5rq4586IOyDqruoXa8IM,4340
+yee88-0.8.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+yee88-0.8.0.dist-info/entry_points.txt,sha256=P4MVZ_sZfrHaARVMImNJjoGamP8VDukARWMKfDh20V8,282
+yee88-0.8.0.dist-info/licenses/LICENSE,sha256=poyQ59wnbmL3Ox3TiiephfHvUpLvJl0DwLFFgqBDdHY,1063
+yee88-0.8.0.dist-info/RECORD,,