@cortexkit/aft-opencode 0.29.0 → 0.30.0

package/dist/shared/live-server-client.d.ts

@@ -19,6 +19,16 @@
  * UI uses, so the active session's `SessionRunState` is the one that
  * resolves `ensureRunning` and overlapping turns coalesce correctly.
  *
+ * The workaround only works when the live HTTP listener is actually
+ * reachable. OpenCode Desktop (Electron+Node) and TUI launched with
+ * `opencode --port 0` bind a real API listener; plain TUI binds an
+ * internal-only listener that 404s for `/session/*`. We probe once at
+ * plugin init and cache the result. When the listener is unreachable
+ * the wake path silently uses the in-process `input.client.session.promptAsync`,
+ * which keeps wakes flowing (at the cost of the upstream duplicate-runner
+ * bug) instead of producing no notification at all or nagging the user
+ * to relaunch with a different flag.
+ *
  * Tracked upstream as anomalyco/opencode#28202. When OpenCode fixes the
  * runtime split, this helper and its single consumer in `bg-notifications.ts`
  * can be deleted and the wake path can go back to `input.client`.
@@ -38,23 +48,32 @@ export type LiveServerClient = ReturnType<typeof createOpencodeClient>;
 export declare function getLiveServerClient(serverUrl: string, directory: string): LiveServerClient;
 /** Test helper — drop the cache between cases so each test starts clean. */
 export declare function __resetLiveServerClientCacheForTests(): void;
-/**
- * True when the current runtime is Bun. OpenCode's TUI ships with Bun;
- * the Electron Desktop app ships with Node. We use this to gate the
- * `--port 0` nudge: Desktop is unaffected by anomalyco/opencode#28202
- * because Node's webidl polyfill is complete, so undici v8 (and the live
- * HTTP server) work without additional flags.
- */
-export declare function isBunRuntime(): boolean;
 /**
  * Probe whether `serverUrl` accepts a connection within `timeoutMs`.
  * Returns `true` for any HTTP response (including 4xx / 5xx) since the
  * goal is to confirm the listener exists. Returns `false` on connection
  * refused, DNS failure, timeout, or undefined URL.
  *
- * Used at plugin init under Bun to detect TUI sessions started without
- * `opencode --port 0` — those bind an internal-only listener that 404s
- * for `/session/...` endpoints and breaks AFT's wake path.
+ * Used at plugin init to decide whether bg-notifications should use the
+ * live-server wake transport (workaround for anomalyco/opencode#28202)
+ * or fall back to the in-process `input.client.session.promptAsync`
+ * path. Plain TUI (no `--port 0`) binds an internal-only listener that
+ * 404s for `/session/...`, so this returns false there; OpenCode
+ * Desktop, `opencode run`, and `opencode --port 0` TUI return true.
  */
 export declare function probeServerReachable(serverUrl: string | undefined, timeoutMs?: number): Promise<boolean>;
+/**
+ * Record the probe result. Idempotent; if you record twice, the latest
+ * value wins. The wake path reads through `useLiveServerWake()`.
+ */
+export declare function setLiveServerWakeAvailable(available: boolean): void;
+/**
+ * Read the cached probe decision. `true` means the wake path should use
+ * `getLiveServerClient(serverUrl, directory)` and POST through the live
+ * HTTP listener. `false` means fall back to the in-process client passed
+ * via plugin context (`input.client`).
+ */
+export declare function useLiveServerWake(): boolean;
+/** Test helper — reset the decision cache between cases. */
+export declare function __resetLiveServerWakeForTests(): void;
 //# sourceMappingURL=live-server-client.d.ts.map

package/dist/shared/live-server-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-server-client.d.ts","sourceRoot":"","sources":["../../src/shared/live-server-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA6BvE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAY1F;AAED,4EAA4E;AAC5E,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,SAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAqBlB"}
+{"version":3,"file":"live-server-client.d.ts","sourceRoot":"","sources":["../../src/shared/live-server-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA6BvE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAY1F;AAED,4EAA4E;AAC5E,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,SAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAmBD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,4DAA4D;AAC5D,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/shared/pty-cache.d.ts

@@ -0,0 +1,18 @@
+import * as fs from "node:fs/promises";
+import { Terminal } from "@xterm/headless";
+export interface PtyTerminalState {
+    terminal: Terminal;
+    fileHandle: fs.FileHandle;
+    offset: number;
+    rows: number;
+    cols: number;
+    lastAccessMs: number;
+}
+export declare function getOrCreatePtyTerminal(key: string, outputPath: string, rows?: number, cols?: number): Promise<PtyTerminalState>;
+export declare function readPtyBytes(state: PtyTerminalState): Promise<Buffer>;
+export declare function disposePtyTerminal(key: string): Promise<void>;
+export declare function disposeAllPtyTerminals(): Promise<void>;
+export declare function renderScreen(state: PtyTerminalState, rows?: number, cols?: number): string;
+export declare function __resetPtyCacheForTests(): void;
+export declare function __ptyCacheSizeForTests(): number;
+//# sourceMappingURL=pty-cache.d.ts.map

package/dist/shared/pty-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-cache.d.ts","sourceRoot":"","sources":["../../src/shared/pty-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,SAAe,EACnB,IAAI,SAAe,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa3E;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,gBAAgB,EACvB,IAAI,SAAa,EACjB,IAAI,SAAa,GAChB,MAAM,CAiBR;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/tools/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0EjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAuOjE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAqCvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAmBrE"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0EjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAmRjE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAyBvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAuBrE"}

package/dist/tools/bash_watch.d.ts

@@ -0,0 +1,24 @@
+import type { ToolContext, ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+export type BashWaitPattern = {
+    kind: "substring";
+    value: string;
+} | {
+    kind: "regex";
+    value: RegExp;
+    source: string;
+};
+export type BashStatusWaited = {
+    reason: "matched" | "exited" | "timeout";
+    elapsed_ms: number;
+    match?: string;
+    match_offset?: number;
+};
+type BashStatusWithWait = Record<string, unknown> & {
+    waited?: BashStatusWaited;
+};
+export declare function createBashWatchTool(ctx: PluginContext): ToolDefinition;
+export declare function waitForBashStatus(ctx: PluginContext, runtime: ToolContext, taskId: string, outputMode: string | undefined, waitFor: BashWaitPattern | undefined, effectiveWaitMs: number): Promise<BashStatusWithWait>;
+export declare function parseWaitPattern(value: unknown): BashWaitPattern | undefined;
+export {};
+//# sourceMappingURL=bash_watch.d.ts.map

package/dist/tools/bash_watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash_watch.d.ts","sourceRoot":"","sources":["../../src/tools/bash_watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AACF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAElF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA4FtE;AAiDD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAsCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAK5E"}

package/dist/tools/bash_write.d.ts

@@ -0,0 +1,38 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+/**
+ * Write bytes to a running PTY background task.
+ *
+ * Two input shapes:
+ *
+ *   - **String** — verbatim bytes written to the PTY. Use this for plain text
+ *     such as REPL commands (`"print(1)\n"`) or when the agent specifically
+ *     wants the literal characters `\u001b` (e.g. writing source code).
+ *
+ *   - **Sequence array** — mix plain strings (text) with `{ key: "<name>" }`
+ *     objects (named control keys). Items concatenate into one atomic write
+ *     so the PTY sees the whole sequence as one input chunk. The agent never
+ *     has to JSON-encode escape characters.
+ *
+ *     Allowed key names: `enter`, `return`, `tab`, `space`, `backspace`,
+ *     `esc`, `escape`, `up`, `down`, `left`, `right`, `home`, `end`,
+ *     `page-up`, `page-down`, `delete`, `insert`, `f1`..`f12`,
+ *     `ctrl-a`..`ctrl-z`. Names are case-insensitive.
+ *
+ * The vim "type text, exit insert, save and quit" idiom:
+ *
+ * ```ts
+ * bash_write({ taskId, input: [
+ *   "iHello",
+ *   { key: "esc" },
+ *   ":wq",
+ *   { key: "enter" },
+ * ]})
+ * ```
+ *
+ * Rust enforces a 1 MiB maximum on the EXPANDED byte stream. Agents should
+ * check `bash_status` first and only call `bash_write` when the task reports
+ * `mode: "pty"`.
+ */
+export declare function createBashWriteTool(ctx: PluginContext): ToolDefinition;
+//# sourceMappingURL=bash_write.d.ts.map

package/dist/tools/bash_write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash_write.d.ts","sourceRoot":"","sources":["../../src/tools/bash_write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA6CtE"}

package/dist/tools/hoisted.d.ts

@@ -20,7 +20,7 @@ export declare function createReadTool(ctx: PluginContext): ToolDefinition;
  * Returns hoisted tools keyed by opencode's built-in names.
  * Overrides: read, write, edit, apply_patch (always when hoisting is on).
  *
- * Bash hoisting is opt-in: `bash`, `bash_status`, and `bash_kill` are
+ * Bash hoisting is opt-in: `bash`, `bash_status`, `bash_write`, and `bash_kill` are
  * registered together when at least one `experimental.bash.*` flag is
  * enabled (rewrite, compress, or background). When all flags are off,
  * opencode's native bash stays in place — users without bash experimentals

package/dist/tools/hoisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA+JjE;AAmmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwB/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4FnF"}
+{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA+JjE;AAmmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0B/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA8FnF"}

package/dist/tui.js

@@ -3,7 +3,7 @@ import { createMemo as createMemo2, createSignal as createSignal2, onCleanup as
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.29.0",
+  version: "0.30.0",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -32,20 +32,21 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.29.0",
+    "@cortexkit/aft-bridge": "0.30.0",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
+    "@xterm/headless": "^5.5.0",
     "comment-json": "^4.6.2",
     undici: "^7.25.0",
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.29.0",
-    "@cortexkit/aft-darwin-x64": "0.29.0",
-    "@cortexkit/aft-linux-arm64": "0.29.0",
-    "@cortexkit/aft-linux-x64": "0.29.0",
-    "@cortexkit/aft-win32-arm64": "0.29.0",
-    "@cortexkit/aft-win32-x64": "0.29.0"
+    "@cortexkit/aft-darwin-arm64": "0.30.0",
+    "@cortexkit/aft-darwin-x64": "0.30.0",
+    "@cortexkit/aft-linux-arm64": "0.30.0",
+    "@cortexkit/aft-linux-x64": "0.30.0",
+    "@cortexkit/aft-win32-arm64": "0.30.0",
+    "@cortexkit/aft-win32-x64": "0.30.0"
   },
   devDependencies: {
     "@types/node": "^22.0.0",

package/dist/workflow-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAmEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAQjG"}
+{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAuEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAQjG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -29,20 +29,21 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.29.0",
+    "@cortexkit/aft-bridge": "0.30.0",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
+    "@xterm/headless": "^5.5.0",
     "comment-json": "^4.6.2",
     "undici": "^7.25.0",
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.29.0",
-    "@cortexkit/aft-darwin-x64": "0.29.0",
-    "@cortexkit/aft-linux-arm64": "0.29.0",
-    "@cortexkit/aft-linux-x64": "0.29.0",
-    "@cortexkit/aft-win32-arm64": "0.29.0",
-    "@cortexkit/aft-win32-x64": "0.29.0"
+    "@cortexkit/aft-darwin-arm64": "0.30.0",
+    "@cortexkit/aft-darwin-x64": "0.30.0",
+    "@cortexkit/aft-linux-arm64": "0.30.0",
+    "@cortexkit/aft-linux-x64": "0.30.0",
+    "@cortexkit/aft-win32-arm64": "0.30.0",
+    "@cortexkit/aft-win32-x64": "0.30.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/shared/live-server-client.ts

@@ -19,6 +19,16 @@
  * UI uses, so the active session's `SessionRunState` is the one that
  * resolves `ensureRunning` and overlapping turns coalesce correctly.
  *
+ * The workaround only works when the live HTTP listener is actually
+ * reachable. OpenCode Desktop (Electron+Node) and TUI launched with
+ * `opencode --port 0` bind a real API listener; plain TUI binds an
+ * internal-only listener that 404s for `/session/*`. We probe once at
+ * plugin init and cache the result. When the listener is unreachable
+ * the wake path silently uses the in-process `input.client.session.promptAsync`,
+ * which keeps wakes flowing (at the cost of the upstream duplicate-runner
+ * bug) instead of producing no notification at all or nagging the user
+ * to relaunch with a different flag.
+ *
  * Tracked upstream as anomalyco/opencode#28202. When OpenCode fixes the
  * runtime split, this helper and its single consumer in `bg-notifications.ts`
  * can be deleted and the wake path can go back to `input.client`.
@@ -84,26 +94,18 @@ export function __resetLiveServerClientCacheForTests(): void {
   clientCache.clear();
 }
 
-/**
- * True when the current runtime is Bun. OpenCode's TUI ships with Bun;
- * the Electron Desktop app ships with Node. We use this to gate the
- * `--port 0` nudge: Desktop is unaffected by anomalyco/opencode#28202
- * because Node's webidl polyfill is complete, so undici v8 (and the live
- * HTTP server) work without additional flags.
- */
-export function isBunRuntime(): boolean {
-  return typeof (globalThis as { Bun?: unknown }).Bun !== "undefined";
-}
-
 /**
  * Probe whether `serverUrl` accepts a connection within `timeoutMs`.
  * Returns `true` for any HTTP response (including 4xx / 5xx) since the
  * goal is to confirm the listener exists. Returns `false` on connection
  * refused, DNS failure, timeout, or undefined URL.
  *
- * Used at plugin init under Bun to detect TUI sessions started without
- * `opencode --port 0` — those bind an internal-only listener that 404s
- * for `/session/...` endpoints and breaks AFT's wake path.
+ * Used at plugin init to decide whether bg-notifications should use the
+ * live-server wake transport (workaround for anomalyco/opencode#28202)
+ * or fall back to the in-process `input.client.session.promptAsync`
+ * path. Plain TUI (no `--port 0`) binds an internal-only listener that
+ * 404s for `/session/...`, so this returns false there; OpenCode
+ * Desktop, `opencode run`, and `opencode --port 0` TUI return true.
  */
 export async function probeServerReachable(
   serverUrl: string | undefined,
@@ -130,3 +132,43 @@ export async function probeServerReachable(
     clearTimeout(timer);
   }
 }
+
+/**
+ * Per-plugin-process decision: should bg-notifications use the live-server
+ * wake transport (workaround for anomalyco/opencode#28202), or fall back
+ * to the in-process `input.client.session.promptAsync` path?
+ *
+ * Set once at plugin init from the result of `probeServerReachable()`.
+ * Defaults to `false` if no decision has been recorded yet — that's the
+ * safe direction because `input.client.session.promptAsync` is always
+ * available (it's part of the plugin contract), whereas the live-server
+ * path needs both a probe-confirmed listener and the workaround code
+ * itself to be live.
+ *
+ * Read at wake time (not cached on a closure) so background probes that
+ * complete after plugin init still take effect on the next wake.
+ */
+let liveServerWakeAvailable = false;
+
+/**
+ * Record the probe result. Idempotent; if you record twice, the latest
+ * value wins. The wake path reads through `useLiveServerWake()`.
+ */
+export function setLiveServerWakeAvailable(available: boolean): void {
+  liveServerWakeAvailable = available;
+}
+
+/**
+ * Read the cached probe decision. `true` means the wake path should use
+ * `getLiveServerClient(serverUrl, directory)` and POST through the live
+ * HTTP listener. `false` means fall back to the in-process client passed
+ * via plugin context (`input.client`).
+ */
+export function useLiveServerWake(): boolean {
+  return liveServerWakeAvailable;
+}
+
+/** Test helper — reset the decision cache between cases. */
+export function __resetLiveServerWakeForTests(): void {
+  liveServerWakeAvailable = false;
+}

package/src/shared/pty-cache.ts

@@ -0,0 +1,113 @@
+import * as fs from "node:fs/promises";
+import { Terminal } from "@xterm/headless";
+
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+const READ_CHUNK_SIZE = 64 * 1024;
+
+export interface PtyTerminalState {
+  terminal: Terminal;
+  fileHandle: fs.FileHandle;
+  offset: number;
+  rows: number;
+  cols: number;
+  lastAccessMs: number;
+}
+
+const terminals = new Map<string, PtyTerminalState>();
+
+export async function getOrCreatePtyTerminal(
+  key: string,
+  outputPath: string,
+  rows = DEFAULT_ROWS,
+  cols = DEFAULT_COLS,
+): Promise<PtyTerminalState> {
+  const existing = terminals.get(key);
+  if (existing) {
+    existing.lastAccessMs = Date.now();
+    if (existing.rows === rows && existing.cols === cols) {
+      return existing;
+    }
+    terminals.delete(key);
+    existing.terminal.dispose();
+    await existing.fileHandle.close().catch(() => undefined);
+  }
+
+  const fileHandle = await fs.open(outputPath, "r");
+  const state: PtyTerminalState = {
+    terminal: new Terminal({ cols, rows, allowProposedApi: true }),
+    fileHandle,
+    offset: 0,
+    rows,
+    cols,
+    lastAccessMs: Date.now(),
+  };
+  terminals.set(key, state);
+  return state;
+}
+
+export async function readPtyBytes(state: PtyTerminalState): Promise<Buffer> {
+  const chunks: Buffer[] = [];
+  while (true) {
+    const buffer = Buffer.allocUnsafe(READ_CHUNK_SIZE);
+    const { bytesRead } = await state.fileHandle.read(buffer, 0, buffer.length, state.offset);
+    if (bytesRead === 0) break;
+    const chunk = buffer.subarray(0, bytesRead);
+    chunks.push(Buffer.from(chunk));
+    await writeTerminal(state.terminal, chunk);
+    state.offset += bytesRead;
+  }
+  state.lastAccessMs = Date.now();
+  return Buffer.concat(chunks);
+}
+
+export async function disposePtyTerminal(key: string): Promise<void> {
+  const state = terminals.get(key);
+  if (!state) return;
+  terminals.delete(key);
+  state.terminal.dispose();
+  await state.fileHandle.close().catch(() => undefined);
+}
+
+export async function disposeAllPtyTerminals(): Promise<void> {
+  await Promise.all([...terminals.keys()].map((key) => disposePtyTerminal(key)));
+}
+
+export function renderScreen(
+  state: PtyTerminalState,
+  rows = state.rows,
+  cols = state.cols,
+): string {
+  const active = state.terminal.buffer.active;
+  const lines: string[] = [];
+  for (let y = 0; y < rows; y++) {
+    const line = active.getLine(active.baseY + y);
+    if (!line) {
+      lines.push("");
+      continue;
+    }
+    let text = "";
+    for (let x = 0; x < cols; x++) {
+      text += line.getCell(x)?.getChars() || " ";
+    }
+    lines.push(text.trimEnd());
+  }
+  while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+  return lines.join("\n");
+}
+
+export function __resetPtyCacheForTests(): void {
+  for (const state of terminals.values()) {
+    state.terminal.dispose();
+    void state.fileHandle.close().catch(() => undefined);
+  }
+  terminals.clear();
+}
+
+export function __ptyCacheSizeForTests(): number {
+  return terminals.size;
+}
+
+function writeTerminal(terminal: Terminal, data: Uint8Array): Promise<void> {
+  return new Promise((resolve) => terminal.write(data, resolve));
+}