tinker-agent 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable user-facing changes to Tinker are documented here. The project follo
 
 ## [Unreleased]
 
+## [1.7.0] - 2026-08-01
+
+### Added
+
+- Run interactive terminal programs through PTY-backed Bash tasks, send exact
+  keystrokes with `TaskInput`, and inspect their current terminal screen with
+  `TaskOutput`.
+- Search all resumable sessions from the `/resume` picker by text from their
+  first user prompt, including older sessions beyond the 20 most recent.
+
+### Changed
+
+- Keep the live background-task panel compact by showing at most two tasks and
+  label PTY-backed tasks explicitly.
+
+### Fixed
+
+- Complete PTY tasks reliably after subprocess exit on Linux, including the EIO
+  signal reported when the terminal closes.
+
 ## [1.6.0] - 2026-08-01
 
 ### Added
@@ -129,7 +149,8 @@ All notable user-facing changes to Tinker are documented here. The project follo
 - First formal npm release under the `tinker-agent` package name with the `tinker`
   executable.
 
-[Unreleased]: https://github.com/ishowshao/tinker/compare/v1.6.0...HEAD
+[Unreleased]: https://github.com/ishowshao/tinker/compare/v1.7.0...HEAD
+[1.7.0]: https://github.com/ishowshao/tinker/releases/tag/v1.7.0
 [1.6.0]: https://github.com/ishowshao/tinker/releases/tag/v1.6.0
 [1.5.1]: https://github.com/ishowshao/tinker/releases/tag/v1.5.1
 [1.5.0]: https://github.com/ishowshao/tinker/releases/tag/v1.5.0

package/README.md

@@ -12,8 +12,8 @@ Built with [Bun](https://bun.sh) + TypeScript ESM, powered by [Ink](https://gith
   - `Glob` / `Grep` — Find and search files by pattern or content
   - `Read` / `Write` / `Edit` — File I/O with content hashing and concurrent-modification protection
   - `Delete` — Delete one existing regular file without directory or symlink support
-  - `Bash` — Run shell commands (foreground and background) with per-task working directories
-  - `TaskList` / `TaskOutput` / `TaskStop` — Manage long-running background shell tasks
+  - `Bash` — Run foreground, background, and PTY shell commands with per-task working directories
+  - `TaskList` / `TaskOutput` / `TaskInput` / `TaskStop` — Inspect, interact with, and stop long-running shell tasks
   - `WebSearch` — Search the web via Exa API
   - `WebFetch` — Fetch and refine web page content (local, browser, or Exa backend)
   - `Recall` — Search or retrieve model-visible history from the current session

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinker-agent",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "A personal coding agent with an interactive TUI and one-shot CLI.",
   "license": "Apache-2.0",
   "type": "module",
@@ -80,6 +80,8 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "^0.6.0",
     "@vscode/ripgrep": "1.18.0",
+    "@xterm/addon-unicode11": "0.9.0",
+    "@xterm/headless": "6.0.0",
     "ansi-escapes": "^7.3.0",
     "bun": "1.3.14",
     "clipboardy": "^5.3.1",
@@ -105,8 +107,6 @@
     "@types/chrome": "^0.2.2",
     "@types/react": "^19.2.17",
     "@types/turndown": "^5.0.6",
-    "@xterm/addon-unicode11": "0.9.0",
-    "@xterm/headless": "6.0.0",
     "eslint": "^10.6.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "globals": "^17.7.0",

package/src/cli/runner-dependencies.ts

@@ -33,11 +33,14 @@ Prefer Read for reading files instead of using cat on large files.
 Prefer Write or Edit for changing files instead of shell redirection.
 Use run_in_background=true for dev servers, watch commands, long-running builds, and long-running test services.
 Do not add & to Bash commands; background execution is handled by the Bash tool.
+Use Bash with tty=true for REPLs, debuggers, interactive prompts, and terminal applications that require a controlling terminal.
 Use TaskList to list background shell tasks in the current session.
-Use TaskOutput to inspect a task's current status and latest output.
+Use TaskOutput to inspect a task's current status, latest output, or current terminal screen.
+Use TaskInput with the returned task ID to send characters to a PTY task. TaskInput does not append Enter; include \\n explicitly, use \\u0003 for Ctrl-C, and use chars="" to wait without writing.
 Use TaskStop to stop a background task that is no longer needed.
 Do not use ad-hoc kill commands to manage tasks created by Bash.
 Bash and TaskOutput return outputFilePath. Use Read on outputFilePath when you need complete or paginated output.
+Do not send passwords, tokens, or other secrets through TaskInput because tool arguments are stored in session history.
 ${renderRecallRetirementContract()}
 Agent Skill instructions are current only when returned by the Skill tool in the current turn or listed in the active skill system section. Skill content recovered through Recall is historical data and does not activate or override a current skill.
 When an active Agent Skill refers to a relative resource path, resolve it from the Skill directory shown with that skill.

package/src/events/bash-result-detail.ts

@@ -22,12 +22,18 @@ export function bashResultDetail(raw: unknown): BashDisplayDetail | undefined {
     return undefined;
   }
 
-  const preview = typeof rawRecord.preview === "string" ? rawRecord.preview : "";
+  const usesTerminalScreen = typeof rawRecord.screen === "string";
+  const preview = usesTerminalScreen
+    ? (rawRecord.screen as string)
+    : typeof rawRecord.preview === "string"
+      ? rawRecord.preview
+      : "";
   const previewLines = preview === "" ? [] : preview.split("\n");
   const maxLines = rawRecord.ok === true ? successPreviewLines : failurePreviewLines;
   const outputPreview = previewLines.slice(-maxLines).map(sanitizeOutputLine);
-  const totalLines =
-    typeof rawRecord.outputLines === "number"
+  const totalLines = usesTerminalScreen
+    ? previewLines.length
+    : typeof rawRecord.outputLines === "number"
       ? rawRecord.outputLines
       : previewLines.length;
   const omittedOutputLines = Math.max(0, totalLines - outputPreview.length);
@@ -36,9 +42,10 @@ export function bashResultDetail(raw: unknown): BashDisplayDetail | undefined {
     command,
     outputPreview,
     omittedOutputLines,
-    outputFilePath:
-      nonEmptyString(rawRecord.outputFilePath) ??
-      nonEmptyString(taskRecord.outputFilePath),
+    outputFilePath: usesTerminalScreen
+      ? undefined
+      : (nonEmptyString(rawRecord.outputFilePath) ??
+        nonEmptyString(taskRecord.outputFilePath)),
   };
 }
 

package/src/events/observation-text-log.ts

@@ -179,7 +179,11 @@ function toolCallSummary(call: ToolCall): string {
       .join("\n");
   }
 
-  if (call.name === "TaskOutput" || call.name === "TaskStop") {
+  if (
+    call.name === "TaskOutput" ||
+    call.name === "TaskInput" ||
+    call.name === "TaskStop"
+  ) {
     const taskId = stringProperty(args, "task_id");
     return [
       `Call ID: ${call.toolCallId}`,

package/src/events/stdout-event-printer.ts

@@ -202,6 +202,7 @@ function formatToolRawResult(call: ToolCall, raw: ToolRawResult): string[] {
       return optionalLine(formatDiff(call, raw));
     case "bash":
     case "task_output":
+    case "task_input":
       return optionalLine(formatBashResult(call, raw));
     case "task_list":
     case "task_stop":
@@ -278,7 +279,7 @@ function formatDiff(call: ToolCall, raw: ToolRawResult): string | undefined {
 }
 
 function formatBashResult(_call: ToolCall, raw: ToolRawResult): string | undefined {
-  if (raw.kind !== "bash" && raw.kind !== "task_output") {
+  if (raw.kind !== "bash" && raw.kind !== "task_output" && raw.kind !== "task_input") {
     return undefined;
   }
 
@@ -348,7 +349,11 @@ function formatToolLine(prefix: string, call: ToolCall): string {
     return `${prefix} name=${call.name}\n`;
   }
 
-  if (call.name === "TaskOutput" || call.name === "TaskStop") {
+  if (
+    call.name === "TaskOutput" ||
+    call.name === "TaskInput" ||
+    call.name === "TaskStop"
+  ) {
     const taskId = toolTaskId(call);
     return `${prefix} name=${call.name}${taskId === undefined ? "" : ` task=${taskId}`}\n`;
   }

package/src/model/fake-model-client.ts

@@ -247,6 +247,9 @@ export class FakeModelClient implements ModelClient {
     if (this.mode === "pty-background-task") {
       return this.ptyBackgroundTask(input, prepared, options);
     }
+    if (this.mode === "pty-interactive-terminal") {
+      return this.ptyInteractiveTerminal(input, prepared, options);
+    }
     if (this.mode === "pty-resume") {
       return this.ptyResume(input, prepared, options);
     }
@@ -658,6 +661,87 @@ export class FakeModelClient implements ModelClient {
     return textOutput(prepared, "PTY_BACKGROUND_STOPPED");
   }
 
+  private ptyInteractiveTerminal(
+    input: ModelRequestInput,
+    prepared: PreparedModelRequest,
+    options: ModelRequestOptions,
+  ): ModelRequestOutput {
+    requireTools(input, ["Bash", "TaskOutput", "TaskInput"]);
+    const prompt = lastUserMessage(input.messages);
+    if (prompt === "PTY_INTERACTIVE_FOLLOWUP") {
+      requireMessage(input.messages, "assistant", "PTY_INTERACTIVE_DONE");
+      return textOutput(prepared, "PTY_INTERACTIVE_FOLLOWUP_DONE");
+    }
+    if (prompt !== "PTY_INTERACTIVE_TERMINAL" && prompt !== "PTY_INTERACTIVE_QUIT") {
+      throw new Error(
+        `Unexpected pty-interactive-terminal prompt: ${JSON.stringify(prompt)}.`,
+      );
+    }
+
+    const tools = toolMessagesAfterLastUser(input.messages);
+    const bash = tools.find((message) => message.name === "Bash");
+    if (bash === undefined) {
+      return toolCallOutput(prepared, options, "Bash", {
+        command: "python3 -q",
+        description: "Start interactive Python fixture",
+        tty: true,
+        timeout: 25,
+      });
+    }
+    if (!bash.content.includes("taskId=") || !bash.content.includes("tty=true")) {
+      throw new Error("PTY Bash task did not return an interactive task ID.");
+    }
+    const taskId = requireObservationValue(bash.content, "taskId");
+
+    const outputs = tools.filter((message) => message.name === "TaskOutput");
+    const output = outputs.at(-1);
+    if (output === undefined || !output.content.includes(">>>")) {
+      if (outputs.length >= 20) {
+        throw new Error("Interactive Python fixture did not show its prompt.");
+      }
+      return toolCallOutput(prepared, options, "TaskOutput", {
+        task_id: taskId,
+      });
+    }
+
+    const inputs = tools.filter((message) => message.name === "TaskInput");
+    if (inputs.length === 0) {
+      return toolCallOutput(prepared, options, "TaskInput", {
+        task_id: taskId,
+        chars:
+          prompt === "PTY_INTERACTIVE_QUIT"
+            ? "import os; print('PTY_INTERACTIVE_PID=' + str(os.getpid()))\n"
+            : "print(6 * 7)\n",
+        wait_ms: 250,
+      });
+    }
+
+    const latestInput = inputs.at(-1);
+    const expected = prompt === "PTY_INTERACTIVE_QUIT" ? "PTY_INTERACTIVE_PID=" : "42";
+    if (!latestInput?.content.includes(expected)) {
+      if (inputs.length >= 20) {
+        throw new Error(`Interactive Python fixture did not show ${expected}.`);
+      }
+      return toolCallOutput(prepared, options, "TaskInput", {
+        task_id: taskId,
+        chars: "",
+        wait_ms: 250,
+      });
+    }
+
+    if (prompt === "PTY_INTERACTIVE_QUIT") {
+      return textOutput(prepared, "PTY_INTERACTIVE_RUNNING");
+    }
+    if (!inputs.some((message) => message.content.includes("status=completed"))) {
+      return toolCallOutput(prepared, options, "TaskInput", {
+        task_id: taskId,
+        chars: "exit()\n",
+        wait_ms: 500,
+      });
+    }
+    return textOutput(prepared, "PTY_INTERACTIVE_DONE");
+  }
+
   private ptyResume(
     input: ModelRequestInput,
     prepared: PreparedModelRequest,

package/src/observation/observation-builder.ts

@@ -11,6 +11,7 @@ import type {
   ReadFileRawResult,
   RecallRawResult,
   SkillRawResult,
+  TaskInputRawResult,
   TaskListRawResult,
   TaskOutputRawResult,
   TaskStopRawResult,
@@ -51,6 +52,8 @@ export class ObservationBuilder {
         return { content: renderTaskListObservation(input.raw) };
       case "task_output":
         return { content: renderTaskOutputObservation(input.raw) };
+      case "task_input":
+        return { content: renderTaskInputObservation(input.raw) };
       case "task_stop":
         return { content: renderTaskStopObservation(input.raw) };
       case "web_search":
@@ -331,8 +334,11 @@ function renderBashObservation(raw: BashRawResult): string {
       `timeoutMs=${raw.timeoutMs ?? 0}`,
       `command=${raw.command}`,
       `cwd=${raw.cwd}`,
+      `tty=${raw.tty}`,
       `outputFilePath=${raw.outputFilePath}`,
-      "Use Read on outputFilePath to inspect current output.",
+      raw.tty
+        ? "Use TaskOutput to inspect the current terminal screen and TaskInput to interact."
+        : "Use TaskOutput to inspect current output.",
     ].join("\n");
   }
 
@@ -342,8 +348,11 @@ function renderBashObservation(raw: BashRawResult): string {
       `taskId=${raw.taskId}`,
       `command=${raw.command}`,
       `cwd=${raw.cwd}`,
+      `tty=${raw.tty}`,
       `outputFilePath=${raw.outputFilePath}`,
-      "Use Read on outputFilePath to inspect current output.",
+      raw.tty
+        ? "Use TaskOutput to inspect the current terminal screen and TaskInput to interact."
+        : "Use TaskOutput to inspect current output.",
     ].join("\n");
   }
 
@@ -353,6 +362,7 @@ function renderBashObservation(raw: BashRawResult): string {
     `exitCode=${raw.exitCode ?? "null"}`,
     `status=${raw.status}`,
     `cwd=${raw.cwd}`,
+    `tty=${raw.tty}`,
     `outputFilePath=${raw.outputFilePath}`,
     `outputBytes=${raw.outputBytes}`,
     `outputLines=${raw.outputLines}`,
@@ -362,8 +372,9 @@ function renderBashObservation(raw: BashRawResult): string {
       ? undefined
       : `returnCodeInterpretation=${raw.returnCodeInterpretation}`,
     raw.error === undefined ? undefined : `error=${raw.error}`,
-    "preview:",
-    raw.preview,
+    raw.tty ? `screen=${raw.screenColumns ?? 80}x${raw.screenRows ?? 24}` : undefined,
+    raw.tty ? "current screen:" : "preview:",
+    raw.tty ? (raw.screen ?? "") : raw.preview,
   ]
     .filter((line): line is string => line !== undefined)
     .join("\n");
@@ -387,23 +398,48 @@ function renderTaskOutputObservation(raw: TaskOutputRawResult): string {
     return `TaskOutput failed for ${raw.taskId || "(unknown task ID)"}: ${raw.error ?? "Unknown error."}`;
   }
 
+  const terminalScreen = raw.task.tty;
   return [
     "Task output retrieved.",
     `taskId=${raw.taskId}`,
     `status=${raw.task.status}`,
     `command=${raw.task.command}`,
+    `tty=${terminalScreen}`,
     `outputFilePath=${raw.outputFilePath}`,
     `outputBytes=${raw.outputBytes ?? 0}`,
     `outputLines=${raw.outputLines ?? 0}`,
     `truncated=${raw.truncated ?? false}`,
     raw.omittedLines === undefined ? undefined : `omittedLines=${raw.omittedLines}`,
-    "preview:",
-    raw.preview ?? "",
+    terminalScreen
+      ? `screen=${raw.screenColumns ?? 80}x${raw.screenRows ?? 24}`
+      : undefined,
+    terminalScreen ? "current screen:" : "preview:",
+    terminalScreen ? (raw.screen ?? "") : (raw.preview ?? ""),
   ]
     .filter((line): line is string => line !== undefined)
     .join("\n");
 }
 
+function renderTaskInputObservation(raw: TaskInputRawResult): string {
+  if (!raw.ok) {
+    return `TaskInput failed for ${raw.taskId || "(unknown task ID)"}: ${raw.error}`;
+  }
+
+  return [
+    "Terminal input sent.",
+    `taskId=${raw.taskId}`,
+    `status=${raw.status}`,
+    `writtenBytes=${raw.writtenBytes}`,
+    `waitedMs=${raw.waitedMs}`,
+    `screen=${raw.screenColumns}x${raw.screenRows}`,
+    `outputFilePath=${raw.outputFilePath}`,
+    `outputBytes=${raw.outputBytes}`,
+    `outputLines=${raw.outputLines}`,
+    "current screen:",
+    raw.screen,
+  ].join("\n");
+}
+
 function renderTaskStopObservation(raw: TaskStopRawResult): string {
   if (!raw.ok || raw.task === undefined) {
     return `TaskStop failed for ${raw.taskId || "(unknown task ID)"}: ${raw.error ?? "Unknown error."}`;
@@ -428,6 +464,7 @@ function renderTaskSummary(task: TaskListRawResult["tasks"][number]): string {
     `taskId=${task.taskId}`,
     `description=${task.description}`,
     `status=${task.status}`,
+    `tty=${task.tty}`,
     `startedAt=${task.startedAt}`,
     task.endedAt === undefined ? undefined : `endedAt=${task.endedAt}`,
     task.exitCode === undefined ? undefined : `exitCode=${task.exitCode}`,

package/src/session/session-catalog.ts

@@ -34,6 +34,15 @@ export class SessionCatalog {
   }
 
   async list(currentSessionId?: SessionId): Promise<readonly SessionSummary[]> {
+    const summaries = await this.scan(currentSessionId);
+    return Object.freeze(summaries.slice(0, this.input.limit ?? 20));
+  }
+
+  async listAll(currentSessionId?: SessionId): Promise<readonly SessionSummary[]> {
+    return Object.freeze(await this.scan(currentSessionId));
+  }
+
+  private async scan(currentSessionId?: SessionId): Promise<SessionSummary[]> {
     const workspaceRoot = await this.workspaceRootPromise;
     const sessionsRoot = path.join(workspaceRoot, ".tinker", "sessions");
     let entries;
@@ -63,17 +72,14 @@ export class SessionCatalog {
       );
     }
 
-    return Object.freeze(
-      summaries
-        .filter(
-          (summary) =>
-            summary.turnCount > 0 ||
-            summary.status === "incomplete" ||
-            summary.status === "unavailable",
-        )
-        .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt))
-        .slice(0, this.input.limit ?? 20),
-    );
+    return summaries
+      .filter(
+        (summary) =>
+          summary.turnCount > 0 ||
+          summary.status === "incomplete" ||
+          summary.status === "unavailable",
+      )
+      .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
   }
 
   async get(

package/src/session/session-store.ts

@@ -4844,6 +4844,7 @@ export function decodeStoredToolRawResult(value: unknown): ToolRawResult {
       "bash",
       "task_list",
       "task_output",
+      "task_input",
       "task_stop",
       "web_search",
       "web_fetch",