@litfamily/litopencode 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -5,6 +5,17 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.15 - 2026-09-30
+
+- `gpt-6.1-sol` is now the recommended coding-lead alternative, because OpenAI lists `gpt-6-sol` as the previous generation. The installer model menu offers it as the coding lead and keeps `gpt-6-sol` listed as the previous generation, and the reference describes both. Routes that already use `gpt-6-sol` keep working, and `litopencode doctor` still accepts them.
+
+## 1.0.14 - 2026-09-30
+
+- Add an optional automatic handoff. It is off until you turn it on, and you choose the context percent; LitOpenCode has no default percent. When the conversation reaches your percent and the turn ends, LitOpenCode asks the model to write a handoff, checks that the file was saved, compacts the conversation, and puts the start of the handoff back in front of the model once. On OpenCode every one of those steps runs by itself. If OpenCode cannot start the compaction, a toast says "Handoff saved. Run /compact now."
+- Turn automatic handoff on with `lit-handoff auto on 70` (use your own number), or with `LITOPENCODE_AUTO_HANDOFF=1` and `LITOPENCODE_AUTO_HANDOFF_PERCENT`. `lit-handoff auto status` shows where it stands, and `litopencode doctor` warns when your percent is at or above the point where OpenCode compacts on its own.
+- The README no longer shows the A/B comparison; one run per side was too little to support its verdicts. The same section is gone from the npm page.
+- The GitHub pages (English and Korean) now show terminal pictures of what LitOpenCode prints, and the motion film was remade in Pretendard with a Korean version.
+
 ## 1.0.13 - 2026-09-30
 
 - The GitHub pages (English and Korean) now show what Jev looks like: the `litopencode doctor` line and the toasts when Jev is off, on, or missing its key. Jev stays off unless you turn it on, and the reference lists what each toast says.

package/README-Ko-KR.md

@@ -1,6 +1,6 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크" /></p>
 
 <details>
 <summary>ASCII 로고 복사</summary>
@@ -32,21 +32,21 @@
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/README-Ko-KR.md)
+[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/README-Ko-KR.md)
 
 > **불씨를 건네받았다.**<br>
 > **이제, 당신의 작업에 옮길 차례다.**
 
 <p align="center">
-<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/badge-version.svg" alt="1.0.13" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/badge-version.svg" alt="1.0.15" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 </p>
 
 LitOpenCode는 OpenCode에 워크플로 agent, 슬래시 명령, 로컬 근거 기록을 더합니다.
 
 프롬프트에 `lit`을 붙이면 계획하고, 만들고, 확인한 뒤 다음 할 일을 프로젝트에 적어 둡니다. 그래서 다음 세션이 멈춘 자리에서 바로 이어 갈 수 있습니다. 모델을 돌리고 권한을 묻는 일은 지금처럼 OpenCode가 합니다.
 
-**[전체 안내, 스킬 갤러리, A/B 결과는 GitHub에서 →](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md)**
+**[전체 안내와 스킬 갤러리는 GitHub에서 →](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md)**
 
 ## 설치
 
@@ -88,10 +88,6 @@ lit 외부 의존성 없이 index.html 하나로 할 일 목록을 만들고,
 
 이 밖에도 디버깅, 리팩터링, 코드 검토, 조사 스킬이 있고, 워드 보고서(`lit-docx`)와 파워포인트 발표자료(`lit-pptx`), 다이어그램, 과학 그림, 화면 구현, README, 글 다듬기(`/lit-humanizer`) 스킬도 함께 설치됩니다. 스킬마다 무엇을 만드는지는 그림과 함께 [GitHub 스킬 갤러리](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#스킬-한눈에-보기)에 있습니다.
 
-## 비교해 보니
-
-가볍게 던지는 한국어 프롬프트 열 개를 순정 OpenCode와 LitOpenCode에 똑같이 보내고, LitOpenCode 쪽 문장 끝에만 ` lit`을 붙였습니다. 최종 판정은 열 개 모두 LitOpenCode 승이었습니다. 아홉 개는 메인테이너가 두 결과를 나란히 보고 판정했고, 메인테이너가 눈으로 검토하지 않은 한 개는 블라인드 심사 결과를 그대로 썼습니다. 다만 제품 표식을 지우고 비교한 블라인드 심사만 따로 보면 LitOpenCode는 4승 3무 3패였습니다. 과제, 두 판정, 양쪽 화면은 [GitHub의 A/B 결과](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#ab-결과)에 있습니다.
-
 ## 설치하면 바뀌는 것
 
 많지 않습니다. OpenCode 설정에 플러그인을 등록하고, LitOpenCode의 명령과 스킬 파일을 OpenCode 설정 폴더에 복사합니다. 어떤 일에 어떤 모델을 쓸지 정한 route는 `~/.config/opencode/litopencode.json`에 저장됩니다. `XDG_CONFIG_HOME`을 지정하면 설정 폴더가 그쪽으로 옮겨 가고, 이미 손봐 둔 route는 건드리지 않습니다. 작업 기록은 프로젝트마다 `.litopencode/litgoal/`에 쌓이고, 다음 세션은 이 기록을 읽고 이어 갑니다.
@@ -103,7 +99,7 @@ OpenAI 제공자를 쓰면 새로 설치했을 때 계획과 검토는 GPT-6 Ast
 - planner는 계획만 세웁니다. `lit-plan`은 `edit`, `bash`, `task` 권한이 거부되어 있고, 더 느슨한 `balanced`나 `yolo` 모드를 직접 골라도 그대로입니다.
 - LitOpenCode는 대화형으로 시작할 때와 install이나 doctor가 성공한 뒤에 스스로 업데이트할 수 있습니다. 끄려면 `--no-auto-update`를 붙이거나 `LITOPENCODE_NO_AUTO_UPDATE=1`을 설정하세요.
 - 스킬 학습 기능은 제거되었습니다. 이전 릴리스가 프로젝트의 `.litopencode` 폴더에 남긴 학습 기록은 더 이상 쓰이지 않으니, 남겨 두든 지우든 편한 대로 하면 됩니다.
-- Jev 스킬 힌트는 선택 기능이고 기본값은 꺼짐입니다. 켜면 조건에 맞는 프롬프트가 TypeSafe로 전송되니, 먼저 [Jev 스킬 힌트 참조 문서](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference-Ko-KR.md#jev-스킬-힌트-선택)를 읽어 보세요. 알림과 doctor 줄이 어떻게 보이는지는 [GitHub 페이지](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#화면에서-보이는-것)에서 볼 수 있습니다.
+- Jev 스킬 힌트는 선택 기능이고 기본값은 꺼짐입니다. 켜면 조건에 맞는 프롬프트가 TypeSafe로 전송되니, 먼저 [Jev 스킬 힌트 참조 문서](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference-Ko-KR.md#jev-스킬-힌트-선택)를 읽어 보세요. 알림과 doctor 줄이 어떻게 보이는지는 [GitHub 페이지](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#화면에서-보이는-것)에서 볼 수 있습니다.
 - 뭔가 이상하면 `npm exec --package @litfamily/litopencode@latest -- litopencode doctor`로 패키지와 설정 상태를 확인하세요.
 
 ## 제거
@@ -114,11 +110,11 @@ OpenAI 제공자를 쓰면 새로 설치했을 때 계획과 검토는 GPT-6 Ast
 npm uninstall -g @litfamily/litopencode
 ```
 
-남겨 둘 만한 설치 파일과 기록은 [제거 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference-Ko-KR.md#제거)에 정리되어 있습니다.
+남겨 둘 만한 설치 파일과 기록은 [제거 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference-Ko-KR.md#제거)에 정리되어 있습니다.
 
 ## 더 보기
 
 - [GitHub 전체 안내](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md)
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/privacy.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference.md)
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/privacy.md)
+- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/JetBrainsMono-OFL.txt)

package/README.md

@@ -1,6 +1,6 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
 
 <details>
 <summary>Copy ASCII logo</summary>
@@ -32,20 +32,20 @@
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/README-Ko-KR.md)
+[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/README-Ko-KR.md)
 
 **Keep the work lit.**
 
 <p align="center">
-<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/badge-version.svg" alt="1.0.13" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/badge-version.svg" alt="1.0.15" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 LitOpenCode adds workflow agents, slash commands, and a local evidence ledger to OpenCode.
 
 Add `lit` to a prompt and it plans, builds, checks, and writes down the next step in your project, so a later session can pick up where this one stopped. OpenCode still runs the model and asks for permission the way it always has.
 
-**[Full guide, skills gallery and A/B results on GitHub →](https://github.com/wjgoarxiv/litopencode#readme)**
+**[Full guide and skills gallery on GitHub →](https://github.com/wjgoarxiv/litopencode#readme)**
 
 ## Install
 
@@ -87,10 +87,6 @@ You get an `index.html` to open and try. Next time, `/lit-recap` shows where you
 
 Beyond these, the package installs skills for debugging, refactoring, code review, research, Word reports (`lit-docx`), PowerPoint decks (`lit-pptx`), diagrams, scientific figures, interfaces, READMEs, and prose editing (`/lit-humanizer`). Each one, with a picture of what it produces, is in the [skills gallery on GitHub](https://github.com/wjgoarxiv/litopencode#skills-at-a-glance).
 
-## How it compared
-
-Ten casual Korean prompts went to plain OpenCode and to LitOpenCode; the LitOpenCode side only added ` lit` to the same line. The final verdict went to LitOpenCode on all ten. For nine of them that was the maintainer's call after comparing both outputs side by side; the one the maintainer didn't review by eye keeps the blind judge's verdict. The blind judge on its own, comparing outputs with product markings removed, scored LitOpenCode 4 wins, 3 ties, and 3 losses. The tasks, both verdicts, and screenshots of each side are in the [A/B results on GitHub](https://github.com/wjgoarxiv/litopencode#ab-results).
-
 ## What install changes
 
 Not much. Install adds the plugin to OpenCode's config and copies LitOpenCode's commands and skills into your OpenCode config folder. Your routes, which say which model handles each kind of work, are kept in `~/.config/opencode/litopencode.json`. Setting `XDG_CONFIG_HOME` moves that folder, and routes you've already customized are left as they are. Each project keeps its work record in `.litopencode/litgoal/`, and that record is what a later session reads to carry on.
@@ -102,7 +98,7 @@ With the OpenAI provider, a fresh install uses GPT-6 Astra (`gpt-6-astra`) at `x
 - The planner only plans. `lit-plan` has `edit`, `bash` and `task` denied, and it stays that way even if you choose the looser `balanced` or `yolo` mode.
 - LitOpenCode can update itself when it starts interactively and after an install or doctor run succeeds. To turn that off, pass `--no-auto-update` or set `LITOPENCODE_NO_AUTO_UPDATE=1`.
 - Skill learning has been removed. Learning records an earlier release left in a project's `.litopencode` folder are no longer used; keep or delete them as you like.
-- The Jev skill hint is optional and off by default. Turning it on sends eligible prompts to TypeSafe, so read the [Jev skill hint reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference.md#jev-skill-hint-optional) first. The GitHub page shows [what the toast and the doctor line look like](https://github.com/wjgoarxiv/litopencode#what-you-will-see).
+- The Jev skill hint is optional and off by default. Turning it on sends eligible prompts to TypeSafe, so read the [Jev skill hint reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference.md#jev-skill-hint-optional) first. The GitHub page shows [what the toast and the doctor line look like](https://github.com/wjgoarxiv/litopencode#what-you-will-see).
 - If something seems off, `npm exec --package @litfamily/litopencode@latest -- litopencode doctor` checks the package and your configuration.
 
 ## Uninstall
@@ -113,11 +109,11 @@ There's no uninstall command. Remove the `@litfamily/litopencode` entry from the
 npm uninstall -g @litfamily/litopencode
 ```
 
-The [removal reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference.md#remove) covers the installed files and records you may want to keep.
+The [removal reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference.md#remove) covers the installed files and records you may want to keep.
 
 ## More
 
 - [Full guide on GitHub](https://github.com/wjgoarxiv/litopencode#readme)
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference.md) · [한국어 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/reference-Ko-KR.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/privacy.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.13/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference.md) · [한국어 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/reference-Ko-KR.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/privacy.md)
+- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.15/docs/assets/readme/JetBrainsMono-OFL.txt)

package/dist/activation.d.ts

@@ -1,6 +1,7 @@
 import type { Hooks, PluginInput } from "@opencode-ai/plugin";
 import type { SessionLookup } from "./session-lineage.ts";
 import type { BoundedAuthorityOptions } from "./bounded-authority.ts";
+import { type AutoHandoffRouteMode } from "./auto-handoff.ts";
 import { type JevSkillHintPart } from "./jev-skill-hint.ts";
 export { litHandoffPromptInjection, scientificVisualizationPromptInjection } from "./activation-managed-prompts.ts";
 export { litActivationBanner } from "./activation-prompt-utils.ts";
@@ -21,6 +22,7 @@ export type ChatMessageActivationOptions = {
     readonly hostArgv?: readonly string[];
     readonly boundedAuthority?: BoundedAuthorityOptions;
     readonly knowledgeCaptureEnabled?: boolean;
+    readonly autoHandoffRoute?: (text: string, mode: AutoHandoffRouteMode) => Promise<string | undefined>;
     readonly onScientificVisualizationActivation?: (sessionID: string) => void;
     readonly onRootUserTurn?: (sessionID: string) => void | Promise<void>;
     readonly onSkillActivation?: (sessionID: string, skillId: string, appendedLit?: boolean) => void | Promise<void>;

package/dist/activation.js

@@ -3,6 +3,7 @@ import { detectChatActivationMode, endsWithStandaloneLitInvocation, unwrapOpenCo
 import { createLitGoalOperations } from "./ledger.js";
 import { applyTrustedStartWorkDirective, parseStartWorkLifecycleDirective } from "./bounded-authority-hooks.js";
 import { startWorkPromptInjection } from "./activation-workflow-prompts.js";
+import { autoHandoffSettingText } from "./auto-handoff.js";
 import { isReadOnlyWorkflowFamilyPlan } from "./workflow-families.js";
 import { queryKnowledge } from "./knowledge.js";
 import { activationDiscipline } from "./activation-probe.js";
@@ -105,6 +106,25 @@ export function createChatMessageActivationHook(projectRoot, options = {}) {
             }
         }
         const nonEmptyTextParts = output.parts.filter((part) => part.type === "text" && part.text.trim().length > 0).map((part) => ({ ...part, text: unwrapOpenCodeRunMessage(part.text, options.hostArgv ?? process.argv) }));
+        if (!childSession &&
+            options.autoHandoffRoute !== undefined &&
+            nonEmptyTextParts.length === 1 &&
+            output.parts.every((part) => part.type === "text")) {
+            const reply = await options.autoHandoffRoute(nonEmptyTextParts[0].text, "chat");
+            if (reply !== undefined) {
+                output.parts.push({
+                    id: `prt_litopencode_lit_handoff_auto_setting_${idSuffix(input.messageID ?? output.message.id)}`,
+                    sessionID: input.sessionID,
+                    messageID: input.messageID ?? output.message.id,
+                    type: "text",
+                    text: autoHandoffSettingText(reply),
+                    // Sent to the model like any text part, but not shown or copied as the user's own words.
+                    synthetic: true,
+                    metadata: { litopencodeAutoHandoff: { surface: "chat.message" } }
+                });
+                return;
+            }
+        }
         const exactBareMode = output.parts.every((part) => part.type === "text") &&
             nonEmptyTextParts.length === 1 &&
             detectChatActivationMode(nonEmptyTextParts[0].text, agent);

package/dist/auto-handoff-hooks.d.ts

@@ -0,0 +1,31 @@
+import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+import { type AutoHandoffRouteMode, type AutoHandoffResolution } from "./auto-handoff.ts";
+import type { AutoHandoffConfig } from "./config.ts";
+import { type SessionLookup } from "./session-lineage.ts";
+import type { RuntimePaths } from "./state.ts";
+type OpenCodeClient = PluginInput["client"];
+type EventHook = NonNullable<Hooks["event"]>;
+type SystemTransformHook = NonNullable<Hooks["experimental.chat.system.transform"]>;
+export declare const compactReminder = "Handoff saved. Run /compact now.";
+export type AutoHandoffOptions = {
+    readonly projectRoot: string;
+    readonly paths: Pick<RuntimePaths, "autoHandoffFile">;
+    readonly client: OpenCodeClient | undefined;
+    readonly config: AutoHandoffConfig;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly getSession?: SessionLookup;
+};
+export type AutoHandoff = {
+    readonly event: EventHook;
+    readonly systemTransform: SystemTransformHook;
+    readonly route: (text: string, mode: AutoHandoffRouteMode) => Promise<string | undefined>;
+    readonly resolve: () => Promise<AutoHandoffResolution>;
+};
+/**
+ * Opt-in automatic handoff for OpenCode. The plugin watches each assistant message's token count,
+ * waits for the turn to end once the user's percent is reached, asks the model to save a handoff
+ * that carries a session-bound marker, compacts the session itself after a verified handoff, and
+ * hands the handoff back through the system prompt once, after the compaction.
+ */
+export declare function createAutoHandoff(options: AutoHandoffOptions): AutoHandoff;
+export {};

package/dist/auto-handoff-hooks.js

@@ -0,0 +1,313 @@
+import { litHandoffPromptInjection } from "./activation-managed-prompts.js";
+import { assistantTokenTotal, autoHandoffDirective, autoHandoffMarker, createAutoHandoffSettings, handoffDigestText, readFreshHandoff } from "./auto-handoff.js";
+import { createSessionLookup } from "./session-lineage.js";
+export const compactReminder = "Handoff saved. Run /compact now.";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function failed(result) {
+    return isRecord(result) && result.error !== undefined && result.error !== null;
+}
+/**
+ * Opt-in automatic handoff for OpenCode. The plugin watches each assistant message's token count,
+ * waits for the turn to end once the user's percent is reached, asks the model to save a handoff
+ * that carries a session-bound marker, compacts the session itself after a verified handoff, and
+ * hands the handoff back through the system prompt once, after the compaction.
+ */
+export function createAutoHandoff(options) {
+    const settings = createAutoHandoffSettings({
+        stateFile: options.paths.autoHandoffFile,
+        config: options.config,
+        ...(options.env === undefined ? {} : { env: options.env })
+    });
+    const client = options.client;
+    const getSession = options.getSession ?? createSessionLookup(client);
+    const directory = options.projectRoot;
+    const sessions = new Map();
+    const windows = new Map();
+    function stateFor(sessionID) {
+        let state = sessions.get(sessionID);
+        if (state === undefined) {
+            state = {
+                phase: "armed",
+                root: undefined,
+                model: undefined,
+                observedPercent: 0,
+                sentAt: undefined,
+                marker: undefined,
+                sawActivity: false,
+                digestArmed: false
+            };
+            sessions.set(sessionID, state);
+        }
+        return state;
+    }
+    function toast(message, variant = "info") {
+        try {
+            const pending = client?.tui?.showToast({ body: { title: "LitOpenCode auto-handoff", message, variant, duration: 8000 } });
+            void pending?.catch(() => undefined);
+        }
+        catch { // no-excuse-ok: catch -- a missing or failing TUI must never stop the handoff.
+        }
+    }
+    async function isRootSession(state, sessionID) {
+        if (state.root !== undefined)
+            return state.root;
+        if (getSession === undefined)
+            return false;
+        try {
+            const session = await getSession(sessionID);
+            if (session === undefined)
+                return false;
+            state.root = session.parentID === undefined;
+            return state.root;
+        }
+        catch {
+            return false;
+        }
+    }
+    async function contextWindow(providerID, modelID) {
+        const key = `${providerID}/${modelID}`;
+        const known = windows.get(key);
+        if (known !== undefined)
+            return known;
+        if (client?.config?.providers === undefined)
+            return undefined;
+        try {
+            const result = await client.config.providers({ query: { directory } });
+            const data = isRecord(result) ? result.data : undefined;
+            const providers = isRecord(data) && Array.isArray(data.providers) ? data.providers : [];
+            for (const provider of providers) {
+                if (!isRecord(provider) || provider.id !== providerID || !isRecord(provider.models))
+                    continue;
+                const model = provider.models[modelID];
+                const limit = isRecord(model) && isRecord(model.limit) ? model.limit.context : undefined;
+                if (typeof limit === "number" && Number.isFinite(limit) && limit > 0) {
+                    windows.set(key, limit);
+                    return limit;
+                }
+            }
+        }
+        catch { // no-excuse-ok: catch -- an unknown window only means no percent and no action.
+        }
+        return undefined;
+    }
+    async function onMessage(info) {
+        if (!isRecord(info) || info.role !== "assistant" || typeof info.sessionID !== "string")
+            return;
+        const sessionID = info.sessionID;
+        const state = stateFor(sessionID);
+        const created = isRecord(info.time) ? info.time.created : undefined;
+        if (state.phase === "sent" && state.sentAt !== undefined && typeof created === "number" && created >= state.sentAt) {
+            state.sawActivity = true;
+        }
+        if (info.summary === true || (info.error !== undefined && info.error !== null))
+            return;
+        const tokens = assistantTokenTotal(info);
+        if (tokens === 0 || typeof info.providerID !== "string" || typeof info.modelID !== "string")
+            return;
+        state.model = {
+            providerID: info.providerID,
+            modelID: info.modelID,
+            agent: typeof info.mode === "string" && info.mode !== "" ? info.mode : undefined
+        };
+        const resolved = await settings.resolve();
+        if (!resolved.enabled || resolved.percent === null)
+            return;
+        if (!(await isRootSession(state, sessionID)))
+            return;
+        const window = await contextWindow(info.providerID, info.modelID);
+        if (window === undefined)
+            return;
+        const reached = tokens * 100 >= resolved.percent * window;
+        if (state.phase === "done" && !reached)
+            state.phase = "armed";
+        if (state.phase === "armed" && reached) {
+            state.phase = "crossed";
+            state.observedPercent = Math.floor((tokens * 100) / window);
+        }
+    }
+    async function sendHandoffRequest(sessionID, state) {
+        const sentAt = Date.now();
+        state.phase = "sent";
+        state.sentAt = sentAt;
+        state.marker = autoHandoffMarker(sessionID, sentAt);
+        state.sawActivity = false;
+        state.digestArmed = false;
+        try {
+            if (client === undefined)
+                throw new Error("no client");
+            const result = await client.session.promptAsync({
+                path: { id: sessionID },
+                query: { directory },
+                body: {
+                    ...(state.model?.agent === undefined ? {} : { agent: state.model.agent }),
+                    ...(state.model === undefined ? {} : { model: { providerID: state.model.providerID, modelID: state.model.modelID } }),
+                    system: litHandoffPromptInjection,
+                    parts: [{ type: "text", text: autoHandoffDirective(state.observedPercent, state.marker) }]
+                }
+            });
+            if (failed(result))
+                throw new Error("promptAsync refused");
+        }
+        catch {
+            state.phase = "done";
+            state.marker = undefined;
+            toast("The automatic handoff could not be started. The conversation was left as it is.", "warning");
+        }
+    }
+    async function sessionIsBusy(sessionID) {
+        try {
+            const result = await client?.session.status({ query: { directory } });
+            const data = isRecord(result) ? result.data : undefined;
+            const status = isRecord(data) ? data[sessionID] : undefined;
+            return isRecord(status) && typeof status.type === "string" && status.type !== "idle";
+        }
+        catch {
+            return false;
+        }
+    }
+    async function startCompaction(sessionID, state) {
+        state.phase = "compacting";
+        toast("Handoff saved. Compacting the conversation now.");
+        try {
+            if (client === undefined || state.model === undefined)
+                throw new Error("no model");
+            const result = await client.session.summarize({
+                path: { id: sessionID },
+                query: { directory },
+                body: { providerID: state.model.providerID, modelID: state.model.modelID }
+            });
+            if (failed(result))
+                throw new Error("summarize refused");
+            if (state.phase === "compacting") {
+                state.phase = "done";
+                state.digestArmed = true;
+            }
+        }
+        catch {
+            if (state.phase === "compacting") {
+                state.phase = "done";
+                toast(compactReminder);
+            }
+        }
+    }
+    async function afterHandoffReply(sessionID, state) {
+        if (!state.sawActivity || state.marker === undefined || state.sentAt === undefined)
+            return;
+        if (await sessionIsBusy(sessionID))
+            return;
+        if (state.phase !== "sent")
+            return;
+        const fresh = await readFreshHandoff(options.projectRoot, state.marker, state.sentAt);
+        if (state.phase !== "sent")
+            return;
+        if (fresh === undefined) {
+            state.phase = "done";
+            state.marker = undefined;
+            toast("No handoff carrying this session's marker was found, so the conversation was not compacted and nothing was lost.", "warning");
+            return;
+        }
+        // Compaction runs in the background: the host answers the request only when it has finished.
+        void startCompaction(sessionID, state);
+    }
+    async function onIdle(sessionID) {
+        const state = sessions.get(sessionID);
+        if (state === undefined)
+            return;
+        if (state.phase === "crossed") {
+            const resolved = await settings.resolve();
+            if (state.phase !== "crossed")
+                return;
+            if (!resolved.enabled || resolved.percent === null) {
+                state.phase = "armed";
+                return;
+            }
+            await sendHandoffRequest(sessionID, state);
+            return;
+        }
+        if (state.phase === "sent")
+            await afterHandoffReply(sessionID, state);
+    }
+    function onCompacted(sessionID) {
+        const state = sessions.get(sessionID);
+        if (state === undefined)
+            return;
+        // A compaction that arrives before any request was sent has already freed the context.
+        if (state.phase === "crossed") {
+            state.phase = "armed";
+            return;
+        }
+        if (state.marker === undefined)
+            return;
+        if (state.phase === "sent" || state.phase === "compacting")
+            state.phase = "done";
+        if (state.phase === "done")
+            state.digestArmed = true;
+    }
+    async function handle(hostEvent) {
+        const properties = hostEvent.properties;
+        if (!isRecord(properties))
+            return;
+        switch (hostEvent.type) {
+            case "message.updated":
+                await onMessage(properties.info);
+                return;
+            case "session.status": {
+                const status = properties.status;
+                const sessionID = properties.sessionID;
+                if (typeof sessionID !== "string" || !isRecord(status))
+                    return;
+                if (status.type === "busy") {
+                    const state = sessions.get(sessionID);
+                    if (state?.phase === "sent")
+                        state.sawActivity = true;
+                }
+                else if (status.type === "idle") {
+                    await onIdle(sessionID);
+                }
+                return;
+            }
+            case "session.idle":
+                if (typeof properties.sessionID === "string")
+                    await onIdle(properties.sessionID);
+                return;
+            case "session.compacted":
+                if (typeof properties.sessionID === "string")
+                    onCompacted(properties.sessionID);
+                return;
+            case "session.deleted": {
+                const info = properties.info;
+                if (isRecord(info) && typeof info.id === "string")
+                    sessions.delete(info.id);
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    // The host publishes a turn's final usage update and its idle event in the same millisecond and does
+    // not wait for a hook to finish, so handling them in parallel would let the idle event overtake the
+    // usage update it depends on.
+    let queue = Promise.resolve();
+    const event = ({ event: hostEvent }) => {
+        const run = queue.then(() => handle(hostEvent));
+        queue = run.catch(() => undefined);
+        return run;
+    };
+    const systemTransform = async (input, output) => {
+        if (typeof input.sessionID !== "string" || input.sessionID === "")
+            return;
+        const state = sessions.get(input.sessionID);
+        if (state === undefined || !state.digestArmed || state.marker === undefined || state.sentAt === undefined)
+            return;
+        const { marker, sentAt } = state;
+        state.digestArmed = false;
+        state.marker = undefined;
+        const fresh = await readFreshHandoff(options.projectRoot, marker, sentAt);
+        if (fresh === undefined || !Array.isArray(output.system))
+            return;
+        output.system.push(handoffDigestText(fresh.relativePath, fresh.text));
+    };
+    return { event, systemTransform, route: settings.route, resolve: settings.resolve };
+}

package/dist/auto-handoff.d.ts

@@ -0,0 +1,73 @@
+import type { AutoHandoffConfig } from "./config.ts";
+export declare const autoHandoffEnvEnabled = "LITOPENCODE_AUTO_HANDOFF";
+export declare const autoHandoffEnvPercent = "LITOPENCODE_AUTO_HANDOFF_PERCENT";
+export type AutoHandoffSource = "env" | "command" | "config" | "default" | "none";
+export type AutoHandoffResolution = {
+    readonly enabled: boolean;
+    readonly percent: number | null;
+    readonly lastPercent: number | null;
+    readonly warnings: readonly string[];
+    readonly sources: {
+        readonly enabled: AutoHandoffSource;
+        readonly percent: AutoHandoffSource;
+    };
+};
+export declare function isValidAutoHandoffPercent(value: unknown): value is number;
+/**
+ * Environment beats the saved command setting, which beats the config file, which beats the default
+ * (OFF, no percent). A percent that is not a whole number from 1 to 99 switches the feature OFF and
+ * says which source carried it; nothing falls back to a quieter source behind the user's back.
+ */
+export declare function resolveAutoHandoff(input: {
+    readonly config: AutoHandoffConfig;
+    readonly state: AutoHandoffConfig | undefined;
+    readonly env: NodeJS.ProcessEnv;
+    readonly stateProblem?: string;
+}): AutoHandoffResolution;
+export declare function readAutoHandoffState(stateFile: string): Promise<{
+    readonly state?: AutoHandoffConfig;
+    readonly problem?: string;
+}>;
+export declare function writeAutoHandoffState(stateFile: string, state: AutoHandoffConfig): Promise<void>;
+export type AutoHandoffRoute = {
+    readonly action: "on";
+    readonly percent: string | undefined;
+} | {
+    readonly action: "off";
+} | {
+    readonly action: "status";
+} | {
+    readonly action: "invalid";
+};
+export type AutoHandoffRouteMode = "command" | "chat";
+/**
+ * Slash arguments arrive without the command name (`auto on 70`); a chat message carries it
+ * (`lit-handoff auto on 70`) and must be that whole single line, so a sentence that merely mentions
+ * the route never changes a setting.
+ */
+export declare function parseAutoHandoffRoute(text: string, mode: AutoHandoffRouteMode): AutoHandoffRoute | undefined;
+export declare function autoHandoffSettingText(reply: string): string;
+export type AutoHandoffSettings = {
+    readonly resolve: () => Promise<AutoHandoffResolution>;
+    readonly route: (text: string, mode: AutoHandoffRouteMode) => Promise<string | undefined>;
+};
+export declare function createAutoHandoffSettings(options: {
+    readonly stateFile: string;
+    readonly config: AutoHandoffConfig;
+    readonly env?: NodeJS.ProcessEnv;
+}): AutoHandoffSettings;
+/** The host's own count: its total when present, otherwise input + output + cache read + cache write. */
+export declare function assistantTokenTotal(info: unknown): number;
+export declare function autoHandoffMarker(sessionID: string, firedAt: number): string;
+export declare function autoHandoffDirective(percent: number, marker: string): string;
+export type FreshHandoff = {
+    readonly relativePath: string;
+    readonly text: string;
+};
+/**
+ * A handoff counts only when it carries the marker this session's trigger produced and the file was
+ * written after the trigger. A file left by an earlier run, another session, or a person does not.
+ */
+export declare function readFreshHandoff(projectRoot: string, marker: string, firedAt: number): Promise<FreshHandoff | undefined>;
+export declare const handoffDigestLimitBytes = 6144;
+export declare function handoffDigestText(relativePath: string, text: string): string;