Distillation

Date: Sep 8, 2026

• 🟡 (03:41) User supplied a source snapshot of ../../.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts; visible configuration includes MAX_SESSIONS = 25 and MAX_ARGUMENT_LENGTH = 16_384.
• 🟡 (03:41) ../../.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts defines SPAWN_DESCRIPTION, an optional timeoutSeconds schema field, an optional ignoreCase: Schema.Boolean field described as "Match the pattern without case sensitivity.", and a Session type containing createdAt: string.
• 🟡 (03:41) PTY session creation in ../../.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts enforces MAX_SESSIONS_PER_OWNER, generates IDs with pty_${crypto.randomUUID().replaceAll("-", "").slice(0, 8)}, tracks finalized, and handles both pty.once("close", (code, signal) => ...) and pty.on("error", (error: Error) => ...).
• 🟡 (03:41) PTY tools in ../../.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts are transformed through ctx.tool.transform((tools) => ...); at least one tool uses options: { codemode: false, permission: "shell" }.
• 🟡 (03:41) PTY termination logic can call terminate(session), uses SIGKILL as a fallback, and throws PTY ${session.id} did not close after SIGKILL. if the session still does not close.
• 🟡 (03:41) Supporting logic in ../../.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts includes escape conversion where "t" maps to "\t", permission action "external_directory", propagation of context.agent, timeout creation via setTimeout(() => fail(new Error(message)), timeout), and grep handling where exit code 1 returns an empty string while another fallback invokes grep.kill("SIGKILL").