@cortexkit/aft-opencode 0.29.1 → 0.30.1

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/_shared.d.ts

@@ -17,6 +17,45 @@
  */
 import type { BinaryBridge, BridgeRequestOptions } from "@cortexkit/aft-bridge";
 import type { PluginContext } from "../types.js";
+/**
+ * Optional integer with bounds.
+ *
+ * MUST be JSON-Schema-representable for OpenCode tool registration to
+ * succeed: OpenCode wraps plugin args in a host `z.object()` and runs
+ * `z.toJSONSchema(args, { io: "input" })` at session start. Any node
+ * the host's Zod can't convert (e.g. `.transform()`, `.preprocess()`)
+ * throws "Transforms cannot be represented in JSON Schema" and the
+ * entire plugin fails to load. Keep this a plain schema — no
+ * transforms. Empty-sentinel coercion (null/""/0 → undefined) belongs
+ * in tool handlers via `coerceOptionalInt`, not in the schema.
+ *
+ * Regression guard: `tool-schemas-json-convertible.test.ts` runs
+ * `z.toJSONSchema(z.object(args), { io: "input" })` on every plugin
+ * tool. If anyone reintroduces a `.transform()` here it fails before
+ * shipping.
+ *
+ * Return type is `any` to suppress TS2742 — Zod's inferred type leaks
+ * `.bun/zod@...` paths that aren't portable across the host SDK and
+ * our zod version. The type annotation has no runtime effect; the
+ * contract test is the real invariant.
+ */
+export declare const optionalInt: (min: number, max: number) => any;
+/**
+ * Runtime coercion for agent-friendly sentinel handling.
+ *
+ * Some agents emit null / "" / 0 when they mean "param not provided".
+ * Use this inside tool handlers BEFORE relying on the value. Returns
+ * `undefined` for all empty sentinels; rejects out-of-bounds with a
+ * clear message.
+ *
+ * Tool handlers that want sentinel tolerance must pass args through
+ * this AFTER Zod validation has accepted the value (or for fields
+ * declared as `z.unknown().optional()` that bypass type validation).
+ * With `optionalInt`'s bounded `z.number().int()` schema, Zod already
+ * rejects the sentinels — call this for defense in depth or for fields
+ * declared more permissively.
+ */
+export declare function coerceOptionalInt(v: unknown, paramName: string, min: number, max: number): number | undefined;
 /**
  * Per-command timeout overrides (milliseconds).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAOhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAW3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9F"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,GACR,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAW3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9F"}

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

@@ -1 +1 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/tools/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkDjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA6S3E"}
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/tools/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkDjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4S3E"}

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,CAkQjE;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,CAyFtE;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,CAkKjE;AAkmCD;;;;;;;;;;;;;;;;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/tools/lsp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAkF3E"}
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA+E3E"}

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAqDlF"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAkDlF"}

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

@@ -1 +1 @@
-{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2J/E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACnC,eAAe,CAyBjB"}
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0J/E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACnC,eAAe,CAyBjB"}

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

@@ -1 +1 @@
-{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/tools/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyDhF"}
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/tools/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWjD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyDhF"}

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.1",
+  version: "0.30.1",
   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.1",
+    "@cortexkit/aft-bridge": "0.30.1",
     "@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.1",
-    "@cortexkit/aft-darwin-x64": "0.29.1",
-    "@cortexkit/aft-linux-arm64": "0.29.1",
-    "@cortexkit/aft-linux-x64": "0.29.1",
-    "@cortexkit/aft-win32-arm64": "0.29.1",
-    "@cortexkit/aft-win32-x64": "0.29.1"
+    "@cortexkit/aft-darwin-arm64": "0.30.1",
+    "@cortexkit/aft-darwin-x64": "0.30.1",
+    "@cortexkit/aft-linux-arm64": "0.30.1",
+    "@cortexkit/aft-linux-x64": "0.30.1",
+    "@cortexkit/aft-win32-arm64": "0.30.1",
+    "@cortexkit/aft-win32-x64": "0.30.1"
   },
   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.1",
+  "version": "0.30.1",
   "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.1",
+    "@cortexkit/aft-bridge": "0.30.1",
     "@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.1",
-    "@cortexkit/aft-darwin-x64": "0.29.1",
-    "@cortexkit/aft-linux-arm64": "0.29.1",
-    "@cortexkit/aft-linux-x64": "0.29.1",
-    "@cortexkit/aft-win32-arm64": "0.29.1",
-    "@cortexkit/aft-win32-x64": "0.29.1"
+    "@cortexkit/aft-darwin-arm64": "0.30.1",
+    "@cortexkit/aft-darwin-x64": "0.30.1",
+    "@cortexkit/aft-linux-arm64": "0.30.1",
+    "@cortexkit/aft-linux-x64": "0.30.1",
+    "@cortexkit/aft-win32-arm64": "0.30.1",
+    "@cortexkit/aft-win32-x64": "0.30.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

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));
+}