@litfamily/litopencode 1.0.36 → 1.0.38

package/CHANGELOG.md

@@ -5,6 +5,22 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.38 - 2026-11-02
+
+- Dependency alerts cleared: zod 4.6.6 (the runtime dependency and the Remotion cover template), the audio runtime's msgpack 1.2.3, @hono/node-server 2.1.5 in the HyperFrames cover template, and toml 5.0.1 in the development tree.
+- Releases are faster: the publish workflow no longer repeats the test suite and the QA probes. It checks with GitHub that CI already passed on the exact commit being released and stops if it did not. A publish from your own machine still runs the full suite first.
+- On OpenCode 2 the footer line beside the prompt now steps down with the terminal width instead of being clipped by the host: the ignition mark with the whole stage chip, the mark with a smaller chip, the chip alone, `🔥 1/3`, the bare flame, then nothing. Before, a narrow terminal cut the mark mid-word and mangled the host's own figures next to it.
+- On OpenCode 2 the status card shows the OpenCode Go plan windows (`5h 42% · 1w 18%`) for sessions on the `opencode-go` provider, read from the host's usage source and asked at most once a minute. Other providers and signed-out hosts show nothing, because OpenCode 2 gives a plugin no other usage data.
+- The automatic-handoff notices now reach the screen on OpenCode 2. The server plugin cannot raise a toast there, so it leaves each notice in `.litopencode/notices.jsonl` and the TUI plugin shows it.
+- Automatic handoff now fires on OpenCode 2. The plugin waited for a `session.status` or `session.idle` event that OpenCode 2 never publishes, so a turn that crossed the percent was never followed by the handoff request. It now reads the end of a turn from `session.execution.succeeded`, `failed` and `interrupted` (and the start from `session.execution.started`), which also records the session as idle for the status card.
+- A flaky test of the alias goal path now waits for the ledger event instead of only the goal in the fake host, so slow runners no longer fail it.
+
+## 1.0.37 - 2026-11-01
+
+- `lit-typographic-motion` films can now carry real keyed footage, such as a reaction clip or a spinning-cat loop shot on a green screen. Key it outside the renderer into 8-bit RGBA PNG frames, put them in `stage/clips/<folder>/` and list them in `stage/clips/clips.json` (`id`, `dir`, `count`, `fps`). The page loads `/lit/clips.js`, registers a clip once with `LitStage.clip({ parent, id, box })` and shows it from `render(t)`; the frame is picked from film time, so a cue is plain arithmetic and the determinism replay holds. A declared clip is checked against its bytes (12 clips, 360 frames each and 1500 in all, 40 MB each and 128 MB in all, 720 px on the long side, up to 30 fps, real transparency) and is exempt from the flipbook rule; any frame sequence you did not declare is still refused with exit 17. A cover takes no clips. The flash audit and the text checks run on the final pixels, and the report lists each clip. `LitStage.clip.circle`, `wipe` and `iris` keep working.
+- On OpenCode 2 the lit HUD is as complete as on OpenCode 1. The status card (discipline, workflow map, bar, live step, skill chips, lanes in parallel, context use and branch) now sits under every session, the stage chip appears beside the ignition line under the prompt, and the home screen shows the last goal. Until now only the ignition line and the sidebar panel were drawn there. The card reads OpenCode 2's own tool names, so a `skill` call (`id`) lights its chip and `subagent` calls show as lanes.
+- OpenCode 2 also gets pop-ups for the workflow stage moving, a discipline switching and a lane starting or finishing, next to the plan, goal, blocker and completion pop-ups it already had. The restart notice, the `lit adhd` suggestion and the opt-in finish alert (`notify` in the plugin options) work there too.
+
 ## 1.0.36 - 2026-10-31
 
 - On OpenCode 2.2 and later, `lit loop`, `litwork` and `/start-work` set OpenCode's native `/goal` for you. The goal carries your task plus what done means here (tests pass, a real-surface check ran, temporary files are cleaned up, the ledger is closed), and each change prints one `LitOpenCode goal:` line. LitOpenCode manages only goals it created: it resumes one that a server restart paused, clears one after OpenCode's verdict and the ledger both say done, and reports a goal you made as left alone without touching it. When OpenCode says the goal is met but the ledger is open, you get a conflict line and no done. Planning, research, review and bare `lit` never set a goal. OpenCode 1 and older OpenCode 2 builds have no `/goal`, so the ledger carries the work and `native-goal-unavailable` is recorded once.

package/README-Ko-KR.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/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.38/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 # LitOpenCode
 
 **LitOpenCode는 OpenCode용 워크플로 플러그인입니다. 프롬프트에 `lit`만 붙이면 계획하고, 만들고, 확인하고, 기록까지 남겨서 다음 세션이 어디서 멈췄는지 바로 압니다.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/badge-version.svg" alt="1.0.36" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/badge-version.svg" alt="1.0.38" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="월간 npm 다운로드 수" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub 스타" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## 더 보기
 
 - [GitHub의 사용 안내](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide-Ko-KR.md): 설치 옵션, 자동 인수인계, 문제 해결, 제거
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/privacy.md)
-- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/LICENSE) · [상표 정책](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/TRADEMARK.md) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/reference.md)
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/privacy.md)
+- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/LICENSE) · [상표 정책](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/TRADEMARK.md) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>ASCII 로고 복사</summary>

package/README.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven 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.38/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven 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>
 
 # LitOpenCode
 
 **LitOpenCode is a workflow plugin for OpenCode. Add `lit` to a prompt and the work gets planned, built, checked and written down, so the next session knows where you stopped.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/badge-version.svg" alt="1.0.36" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/badge-version.svg" alt="1.0.38" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="npm downloads per month" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub stars" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## More
 
 - [Guide on GitHub](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide.md): install options, automatic handoff, troubleshooting and removal.
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/reference.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/privacy.md)
-- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/LICENSE) · [Trademark policy](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/TRADEMARK.md) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.36/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/reference.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/privacy.md)
+- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/LICENSE) · [Trademark policy](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/TRADEMARK.md) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.38/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>Copy ASCII logo</summary>

package/dist/state.d.ts

@@ -18,6 +18,7 @@ export type RuntimePaths = {
     knowledgeDir: string;
     knowledgeClaimsFile: string;
     autoHandoffFile: string;
+    noticesFile: string;
     workflowStackDir: string;
     adhdDir: string;
     livenessDir: string;

package/dist/state.js

@@ -34,6 +34,7 @@ export function createRuntimePaths(projectRoot) {
         knowledgeDir: path.join(runtimeDir, "knowledge"),
         knowledgeClaimsFile: path.join(runtimeDir, "knowledge", "claims.jsonl"),
         autoHandoffFile: path.join(runtimeDir, "auto-handoff.json"),
+        noticesFile: path.join(runtimeDir, "notices.jsonl"),
         workflowStackDir: path.join(runtimeDir, "workflow-stack"),
         adhdDir: path.join(runtimeDir, "adhd"),
         livenessDir: path.join(runtimeDir, "liveness"),

package/dist/tools.d.ts

@@ -10,34 +10,44 @@ export declare const litOpenCodeTools: Readonly<{
         args: Readonly<{
             [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
         }>;
-        execute(args: Record<string, unknown>, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
+        execute(args: {
+            [x: string]: unknown;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
     };
     litwork: {
         description: string;
         args: Readonly<{
             [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
         }>;
-        execute(args: Record<string, unknown>, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
+        execute(args: {
+            [x: string]: unknown;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
     };
     "start-work": {
         description: string;
         args: Readonly<{
             [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
         }>;
-        execute(args: Record<string, unknown>, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
+        execute(args: {
+            [x: string]: unknown;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
     };
     "review-work": {
         description: string;
         args: Readonly<{
             [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
         }>;
-        execute(args: Record<string, unknown>, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
+        execute(args: {
+            [x: string]: unknown;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
     };
     wikify: {
         description: string;
         args: Readonly<{
             [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
         }>;
-        execute(args: Record<string, unknown>, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
+        execute(args: {
+            [x: string]: unknown;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<ToolResult>;
     };
 }>;

package/dist/tui/mission-band.d.ts

@@ -36,6 +36,13 @@ export type CardFigures = {
     readonly branch?: string;
     readonly inLane: boolean;
     readonly restartTo?: string;
+    readonly limits?: readonly CardLimit[];
+};
+/** A plan window the host reports (`5h 42%`), shown after the context figure; absent when the host reports none. */
+export type CardLimit = {
+    readonly label: string;
+    readonly percent: number;
+    readonly limited: boolean;
 };
 export type CardInputs = {
     readonly view: MissionView;

package/dist/tui/mission-band.js

@@ -150,6 +150,7 @@ function topLine(view, frame, palette, width, border, rest, mark) {
     }
     return fitLine([{ text: "╭" + "─".repeat(Math.max(0, width)), fg: border }], width, palette);
 }
+const limitWarnPercent = 90;
 /** The figures in the bottom border, most important first; the last ones go first when room runs out. */
 function figureParts(view, figures, palette) {
     const parts = [];
@@ -159,6 +160,9 @@ function figureParts(view, figures, palette) {
         const percent = Math.round(figures.contextPercent);
         parts.push({ text: `ctx ${percent}%`, fg: percent >= contextWarnPercent ? palette.warning : palette.muted });
     }
+    for (const limit of figures.limits ?? []) {
+        parts.push({ text: `${limit.label} ${limit.percent}%${limit.limited ? " limited" : ""}`, fg: limit.limited || limit.percent >= limitWarnPercent ? palette.warning : palette.muted });
+    }
     if (view.active)
         parts.push({ text: `⟳ ${elapsedText(view.elapsedMinutes)}${figures.inLane ? " · in lane" : ""}`, fg: palette.muted });
     if (figures.branch !== undefined)

package/dist/tui/mission-skills.js

@@ -25,7 +25,9 @@ export function readSkillUse(part, at) {
         const input = isRecord(state.input) ? state.input : {};
         const start = isRecord(state.time) && typeof state.time.start === "number" ? state.time.start : at;
         if (part.tool === "skill") {
-            return typeof input.name === "string" && ownSkills.has(input.name) ? { name: input.name, at: start } : undefined;
+            // OpenCode 1's skill tool takes `name`; OpenCode 2's takes `id`.
+            const skill = typeof input.name === "string" ? input.name : typeof input.id === "string" ? input.id : undefined;
+            return skill !== undefined && ownSkills.has(skill) ? { name: skill, at: start } : undefined;
         }
         const name = ownTools[part.tool];
         if (name === undefined || input.action === "status")

package/dist/tui/mission-source-v2.d.ts

@@ -15,16 +15,39 @@ type V2Message = {
     readonly content?: ReadonlyArray<{
         readonly type: string;
         readonly name?: string;
+        readonly text?: string;
         readonly state?: {
             readonly status?: string;
+            readonly input?: unknown;
+            readonly metadata?: unknown;
         };
         readonly time?: {
             readonly created?: number;
             readonly ran?: number;
+            readonly completed?: number;
         };
     }>;
 };
+type V2Model = {
+    readonly providerID: string;
+    readonly modelID: string;
+    readonly limit?: {
+        readonly context?: number;
+    };
+};
 export type MissionDataV2 = {
+    readonly location?: {
+        readonly vcs?: {
+            info(): {
+                readonly branch?: {
+                    readonly current?: string;
+                };
+            } | undefined;
+        };
+        readonly model?: {
+            list(): ReadonlyArray<V2Model> | undefined;
+        };
+    };
     readonly session: {
         status(sessionID: string): "idle" | "running";
         readonly message: {

package/dist/tui/mission-source-v2.js

@@ -5,11 +5,23 @@ function isMessage(value) {
 export function sessionMessagesV2(data, sessionID) {
     return (data.session.message.list(sessionID) ?? []).filter(isMessage).filter((message) => message.type === "user" || message.type === "assistant");
 }
+/** The provider table the context figure reads: each model's context window, from the host's model list. */
+function providersV2(data) {
+    const byProvider = new Map();
+    for (const model of data.location?.model?.list() ?? []) {
+        const models = byProvider.get(model.providerID) ?? {};
+        models[model.modelID] = { limit: { context: model.limit?.context } };
+        byProvider.set(model.providerID, models);
+    }
+    return [...byProvider].map(([id, models]) => ({ id, models }));
+}
 export function missionStateFromV2(data, directory) {
     const index = new Map();
+    const branch = data.location?.vcs?.info()?.branch?.current?.trim();
     return {
         path: directory === undefined ? {} : { directory },
-        provider: [],
+        ...(branch === undefined || branch === "" ? {} : { vcs: { branch } }),
+        provider: providersV2(data),
         session: {
             messages(sessionID) {
                 return sessionMessagesV2(data, sessionID).map((message) => {
@@ -35,9 +47,22 @@ export function missionStateFromV2(data, directory) {
                 return [];
             if (message.type === "user")
                 return message.metadata === undefined ? [] : [{ metadata: message.metadata }];
-            return (message.content ?? [])
-                .filter((item) => item.type === "tool" && typeof item.name === "string")
-                .map((item) => ({ type: "tool", tool: item.name, state: { status: item.state?.status, time: { start: item.time?.ran ?? item.time?.created } } }));
+            return (message.content ?? []).flatMap((item) => {
+                if (item.type === "text" && typeof item.text === "string")
+                    return [{ type: "text", text: item.text }];
+                if (item.type !== "tool" || typeof item.name !== "string")
+                    return [];
+                return [{
+                        type: "tool",
+                        tool: item.name,
+                        state: {
+                            status: item.state?.status,
+                            input: item.state?.input,
+                            metadata: item.state?.metadata,
+                            time: { start: item.time?.ran ?? item.time?.created, ...(item.time?.completed === undefined ? {} : { end: item.time.completed }) }
+                        }
+                    }];
+            });
         }
     };
 }

package/dist/tui/mission-source.d.ts

@@ -52,6 +52,7 @@ export type MissionStateSource = {
         readonly tool?: unknown;
         readonly state?: unknown;
         readonly metadata?: unknown;
+        readonly text?: unknown;
     }>;
 };
 /** The same root the server plugin uses: the worktree unless it is the filesystem root, else the directory. */

package/dist/tui/mission-source.js

@@ -330,7 +330,8 @@ function taskSources(state, sessionID, now) {
     const assistants = state.session.messages(sessionID).filter((message) => message.role === "assistant").slice(-recentAssistantMessages);
     for (const message of assistants) {
         for (const part of state.part(message.id)) {
-            if (part.type !== "tool" || part.tool !== "task" || !isRecord(part.state))
+            // OpenCode 1 delegates through `task`, OpenCode 2 through `subagent`.
+            if (part.type !== "tool" || (part.tool !== "task" && part.tool !== "subagent") || !isRecord(part.state))
                 continue;
             const toolState = part.state;
             const status = toolState.status;
@@ -348,7 +349,7 @@ function taskSources(state, sessionID, now) {
                 children.add(child);
             const todos = child === undefined ? [] : state.session.todo(child).filter((todo) => todo.status !== "cancelled");
             const done = todos.filter((todo) => todo.status === "completed").length;
-            const name = typeof input.description === "string" && input.description.trim() !== "" ? input.description.trim() : typeof input.subagent_type === "string" ? input.subagent_type : "subagent";
+            const name = typeof input.description === "string" && input.description.trim() !== "" ? input.description.trim() : typeof input.subagent_type === "string" ? input.subagent_type : typeof input.agent === "string" ? input.agent : "subagent";
             // A running task last moved when its own session did; its start time alone would read a long, busy run as idle.
             const moved = child === undefined ? undefined : lastActivity(state, child);
             sources.push({

package/dist/tui/mission-text.d.ts

@@ -100,13 +100,13 @@ export declare function groupsWidth(groups: readonly ChipGroup[]): number;
 export declare function fade(segment: Segment, alpha: number, palette: MissionPalette): Segment;
 export declare const chipSparkWidth = 7;
 export declare function chipSparkCells(t: number, palette: MissionPalette): Segment[] | undefined;
-export declare function chipTier(view: MissionView, frame: MotionFrame, palette: MissionPalette, budget: number): ChipTier;
+export declare function chipTier(view: MissionView, frame: MotionFrame, palette: MissionPalette, budget: number, largest?: ChipTier): ChipTier;
 /**
  * The map chip on the right of the prompt's agent/model row: `🔥 LIT  plan ✓ › WORK ▰▰▰▱▱▱▱ 3/7 › review`,
  * then the live step when the full chip leaves room for it, shedding labels before values as `budget`
- * shrinks. Idle sessions render nothing.
+ * shrinks, and never larger than `largest`. Idle sessions render nothing.
  */
-export declare function chipLine(view: MissionView, frame: MotionFrame, palette: MissionPalette, budget: number): Line;
+export declare function chipLine(view: MissionView, frame: MotionFrame, palette: MissionPalette, budget: number, largest?: ChipTier): Line;
 /** The header status: a glyph and words, or the COMPLETE badge that pops in and settles to green text. */
 export declare function statusSegments(view: MissionView, frame: MotionFrame, palette: MissionPalette): {
     readonly segments: Segment[];

package/dist/tui/mission-text.js

@@ -396,8 +396,8 @@ export function chipSparkCells(t, palette) {
     }
     return cells;
 }
-export function chipTier(view, frame, palette, budget) {
-    for (const tier of ["full", "medium"]) {
+export function chipTier(view, frame, palette, budget, largest = "full") {
+    for (const tier of largest === "full" ? ["full", "medium"] : largest === "medium" ? ["medium"] : []) {
         if (groupsWidth(chipGroups(view, frame, palette, tier)) <= budget)
             return tier;
     }
@@ -406,12 +406,12 @@ export function chipTier(view, frame, palette, budget) {
 /**
  * The map chip on the right of the prompt's agent/model row: `🔥 LIT  plan ✓ › WORK ▰▰▰▱▱▱▱ 3/7 › review`,
  * then the live step when the full chip leaves room for it, shedding labels before values as `budget`
- * shrinks. Idle sessions render nothing.
+ * shrinks, and never larger than `largest`. Idle sessions render nothing.
  */
-export function chipLine(view, frame, palette, budget) {
+export function chipLine(view, frame, palette, budget, largest = "full") {
     if (!view.active)
         return [];
-    const tier = chipTier(view, frame, palette, budget);
+    const tier = chipTier(view, frame, palette, budget, largest);
     const groups = chipGroups(view, frame, palette, tier);
     if (tier === "full") {
         const live = liveSegments(view, frame, palette, 24);

package/dist/v2/events.d.ts

@@ -36,7 +36,7 @@ export type EventModelLike = {
 };
 export type V2EventOptions = {
     readonly projectRoot: string;
-    readonly paths: Pick<RuntimePaths, "autoHandoffFile">;
+    readonly paths: Pick<RuntimePaths, "autoHandoffFile"> & Partial<Pick<RuntimePaths, "noticesFile">>;
     readonly autoHandoffConfig: AutoHandoffConfig;
     readonly boundedAuthority: BoundedAuthorityOptions;
     readonly getSession: SessionLookup;

package/dist/v2/events.js

@@ -1,6 +1,7 @@
 import { createAutoHandoff } from "../auto-handoff-hooks.js";
 import { LifecycleConflictError, LifecycleSafetyError, createBoundedAuthorityLifecycle, parseFencedProgress } from "../bounded-authority.js";
 import { markLiveness } from "../session-liveness.js";
+import { appendNotice } from "./notices.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -9,10 +10,20 @@ function str(value) {
 }
 /**
  * The calls the OpenCode 1 automatic handoff makes, answered by OpenCode 2. There is no server toast on
- * OpenCode 2, so the client has no `tui`; the handoff's own notices are not shown there.
+ * OpenCode 2, so `tui.showToast` leaves the notice in the project's notices file, which the TUI plugin
+ * reads and shows (notices.ts). Without a notices file the call is accepted and dropped.
  */
-function handoffClient(session, model, statuses) {
+function handoffClient(session, model, statuses, noticesFile) {
     const client = {
+        tui: {
+            async showToast(input) {
+                const body = input.body;
+                if (noticesFile !== undefined && body !== undefined && typeof body.message === "string") {
+                    appendNotice(noticesFile, { title: body.title ?? "🔥 LIT", message: body.message, variant: (body.variant ?? "info"), duration: body.duration ?? 8000 });
+                }
+                return { data: true };
+            }
+        },
         session: {
             async promptAsync(input) {
                 const text = [input.body.system, ...(input.body.parts ?? []).map((part) => part.text)].filter((part) => typeof part === "string" && part !== "").join("\n\n");
@@ -50,7 +61,7 @@ export function createV2Events(options) {
     const autoHandoff = createAutoHandoff({
         projectRoot: options.projectRoot,
         paths: options.paths,
-        client: handoffClient(options.session, options.model, statuses),
+        client: handoffClient(options.session, options.model, statuses, options.paths.noticesFile),
         config: options.autoHandoffConfig,
         getSession: options.getSession
     });
@@ -88,6 +99,11 @@ export function createV2Events(options) {
             throw error;
         }
     }
+    async function idle(sessionID) {
+        statuses.set(sessionID, { type: "idle" });
+        await markLiveness(options.projectRoot, sessionID, "idle");
+        await toHandoff("session.idle", { sessionID });
+    }
     async function handle(event) {
         const data = isRecord(event.data) ? event.data : {};
         const sessionID = str(data.sessionID);
@@ -135,13 +151,23 @@ export function createV2Events(options) {
                 });
                 return;
             }
+            // OpenCode 2.2.5 publishes no `session.status` or `session.idle`. A turn runs from
+            // `session.execution.started` to one of three endings, and the handoff reads them as busy and idle.
+            case "session.execution.started":
+                statuses.set(sessionID, { type: "busy" });
+                await toHandoff("session.status", { sessionID, status: { type: "busy" } });
+                return;
+            case "session.execution.succeeded":
+            case "session.execution.failed":
+            case "session.execution.interrupted":
+                await idle(sessionID);
+                return;
             case "session.status":
                 statuses.set(sessionID, data.status);
                 await toHandoff("session.status", { sessionID, status: data.status });
                 return;
             case "session.idle":
-                await markLiveness(options.projectRoot, sessionID, "idle");
-                await toHandoff("session.idle", { sessionID });
+                await idle(sessionID);
                 return;
             case "session.compaction.ended":
                 await toHandoff("session.compacted", { sessionID });

package/dist/v2/notices.d.ts

@@ -0,0 +1,13 @@
+export type NoticeVariant = "info" | "success" | "warning" | "error";
+export type TuiNotice = {
+    readonly title: string;
+    readonly message: string;
+    readonly variant: NoticeVariant;
+    readonly duration: number;
+};
+/** Leaves one popup for the TUI. Best effort: a place that cannot be written loses the notice, never the caller. */
+export declare function appendNotice(file: string, notice: TuiNotice): void;
+/** Reads the notices that appear after it was made. Each call returns the new ones once, oldest first. */
+export declare function createNoticeTail(file: string): {
+    readonly poll: () => readonly TuiNotice[];
+};

package/dist/v2/notices.js

@@ -0,0 +1,143 @@
+// The way a server-side popup reaches the screen on OpenCode 2. The server plugin's context only subscribes to
+// events, so it cannot raise a toast; the TUI plugin can, but it knows nothing of the server's state machines
+// (the automatic handoff). The server therefore appends each popup it would have shown to a small file under
+// the project's .litopencode, and the TUI reads the lines that appear after it started and toasts them. Both
+// halves ship in this package; neither needs the other to be there. A symbolic link in place of the file is
+// never followed, a torn line waits for its newline, and the file is rewritten to its newest lines past a cap.
+import fs from "node:fs";
+import path from "node:path";
+const variants = new Set(["info", "success", "warning", "error"]);
+const titleCells = 80;
+const messageCells = 400;
+const minDuration = 1000;
+const maxDuration = 15_000;
+const defaultDuration = 8000;
+const capBytes = 64_000;
+const keepBytes = 24_000;
+const readCapBytes = 128_000;
+const seenLimit = 64;
+let counter = 0;
+function clip(value, max) {
+    const chars = [...value];
+    return chars.length <= max ? value : `${chars.slice(0, max - 1).join("")}…`;
+}
+function clean(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const entry = value;
+    if (typeof entry.title !== "string" || typeof entry.message !== "string" || entry.message === "")
+        return undefined;
+    if (typeof entry.variant !== "string" || !variants.has(entry.variant))
+        return undefined;
+    const duration = typeof entry.duration === "number" && Number.isFinite(entry.duration) ? Math.min(maxDuration, Math.max(minDuration, entry.duration)) : defaultDuration;
+    return { title: clip(entry.title, titleCells), message: clip(entry.message, messageCells), variant: entry.variant, duration };
+}
+function plainFile(file) {
+    try {
+        const stat = fs.lstatSync(file);
+        return stat.isFile() ? stat : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function trimToNewest(file) {
+    const text = fs.readFileSync(file, "utf8");
+    const lines = text.split("\n").filter((line) => line !== "");
+    const kept = [];
+    let size = 0;
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        size += Buffer.byteLength(lines[index]) + 1;
+        if (size > keepBytes)
+            break;
+        kept.unshift(lines[index]);
+    }
+    const temp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(temp, kept.length === 0 ? "" : `${kept.join("\n")}\n`);
+    fs.renameSync(temp, file);
+}
+/** Leaves one popup for the TUI. Best effort: a place that cannot be written loses the notice, never the caller. */
+export function appendNotice(file, notice) {
+    const cleaned = clean(notice);
+    if (cleaned === undefined)
+        return;
+    try {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        const existing = (() => {
+            try {
+                return fs.lstatSync(file);
+            }
+            catch {
+                return undefined;
+            }
+        })();
+        if (existing !== undefined && !existing.isFile())
+            return;
+        counter += 1;
+        const stored = { id: `${Date.now().toString(36)}-${process.pid}-${counter}`, at: Date.now(), ...cleaned };
+        fs.appendFileSync(file, `${JSON.stringify(stored)}\n`);
+        if ((plainFile(file)?.size ?? 0) > capBytes)
+            trimToNewest(file);
+    }
+    catch { // no-excuse-ok: catch -- a popup is best-effort feedback; the handoff itself must never stop for it.
+    }
+}
+/** Reads the notices that appear after it was made. Each call returns the new ones once, oldest first. */
+export function createNoticeTail(file) {
+    let offset = plainFile(file)?.size ?? 0;
+    const seen = [];
+    return {
+        poll() {
+            const stat = plainFile(file);
+            if (stat === undefined)
+                return [];
+            // A smaller file was rewritten to its newest lines; read it again and let the ids drop what was shown.
+            if (stat.size < offset)
+                offset = 0;
+            if (stat.size === offset)
+                return [];
+            const length = Math.min(stat.size - offset, readCapBytes);
+            const buffer = Buffer.alloc(length);
+            let fd;
+            try {
+                fd = fs.openSync(file, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
+                fs.readSync(fd, buffer, 0, length, offset);
+            }
+            catch {
+                return [];
+            }
+            finally {
+                if (fd !== undefined)
+                    fs.closeSync(fd);
+            }
+            const text = buffer.toString("utf8");
+            const end = text.lastIndexOf("\n");
+            if (end < 0)
+                return length === readCapBytes ? (offset += length, []) : [];
+            offset += Buffer.byteLength(text.slice(0, end + 1));
+            const out = [];
+            for (const line of text.slice(0, end).split("\n")) {
+                let parsed;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                const id = typeof parsed?.id === "string" ? parsed.id : undefined;
+                if (id !== undefined && seen.includes(id))
+                    continue;
+                const entry = clean(parsed);
+                if (entry === undefined)
+                    continue;
+                if (id !== undefined) {
+                    seen.push(id);
+                    if (seen.length > seenLimit)
+                        seen.shift();
+                }
+                out.push(entry);
+            }
+            return out;
+        }
+    };
+}