tinker-agent 2.7.0 → 2.8.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable user-facing changes to Tinker are documented here. The project follo
 
 ## [Unreleased]
 
+## [2.8.0] - 2026-09-04
+
+### Changed
+
+- Refresh built-in tool descriptions so filesystem scope, local command
+  execution, waiting, and context swaps are stated more precisely to the model.
+- Remove obsolete implementation roadmaps and reconcile the remaining design
+  documents with the behavior already delivered by the runtime.
+
+### Fixed
+
+- Re-evaluate context pressure after a completed turn so automatic maintenance
+  still runs when closing the turn itself moves the active context above its
+  configured pressure threshold.
+
 ## [2.7.0] - 2026-09-04
 
 ### Added
@@ -346,7 +361,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/v2.7.0...HEAD
+[Unreleased]: https://github.com/ishowshao/tinker/compare/v2.8.0...HEAD
+[2.8.0]: https://github.com/ishowshao/tinker/releases/tag/v2.8.0
 [2.7.0]: https://github.com/ishowshao/tinker/releases/tag/v2.7.0
 [2.6.0]: https://github.com/ishowshao/tinker/releases/tag/v2.6.0
 [2.5.0]: https://github.com/ishowshao/tinker/releases/tag/v2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinker-agent",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "A personal coding agent with an interactive TUI and one-shot CLI.",
   "license": "Apache-2.0",
   "type": "module",

package/src/agent/runtime-session.ts

@@ -2499,6 +2499,7 @@ class DefaultRuntimeSession implements RuntimeSession {
       }
       await this.settleClosedTurnSkills();
       if (result.status === "completed") {
+        await this.evaluateClosedTurnContextPressure();
         await this.performAutomaticContextMaintenance();
       }
       return result;
@@ -2522,6 +2523,21 @@ class DefaultRuntimeSession implements RuntimeSession {
     }
   }
 
+  private async evaluateClosedTurnContextPressure(): Promise<void> {
+    const automation = this.requireContextAutomation();
+    if (!automation.automaticSwapOnly) return;
+
+    const snapshot = this.requireContextManager().measureCurrent();
+    await this.append({
+      type: "context.usage.updated",
+      sessionId: this.sessionId,
+      data: { phase: "turn_close", snapshot },
+    });
+    if (snapshot.pressure !== "normal") {
+      this.pendingAutomaticContextMaintenance = true;
+    }
+  }
+
   private async performAutomaticContextMaintenance(): Promise<void> {
     if (!this.pendingAutomaticContextMaintenance) return;
     this.pendingAutomaticContextMaintenance = false;

package/src/events/types.ts

@@ -46,7 +46,7 @@ export type SessionStartedData = {
 };
 
 export type ContextUsageUpdatedData = {
-  phase: "initial" | "preflight" | "measured" | "revision";
+  phase: "initial" | "preflight" | "measured" | "turn_close" | "revision";
   snapshot: ContextUsageSnapshot;
 };
 

package/src/tools/bash.ts

@@ -44,7 +44,7 @@ export function createBashToolExecutor(options: BashToolOptions): ToolExecutor {
   return defineToolExecutor("bash", {
     definition: {
       name: "Bash",
-      description: "Run a shell command in the local workspace.",
+      description: "Run a shell command locally.",
       parameters: {
         type: "object",
         additionalProperties: false,

package/src/tools/context-maintenance.ts

@@ -53,7 +53,7 @@ export const CONTEXT_SWAP_CANDIDATES_TOOL_DEFINITION: ToolDefinition = Object.fr
 export const CONTEXT_SWAP_TOOL_DEFINITION: ToolDefinition = Object.freeze({
   name: "ContextSwap",
   description:
-    "Schedule selected ContextSwapCandidates for replacement by compact Recall-backed placeholders. The swap runs after this iteration's tool frame closes and preserves canonical history for RecallGet. Pass only candidate IDs returned by ContextSwapCandidates.",
+    "Schedule selected ContextSwapCandidates for replacement by compact Recall-backed placeholders and preserve canonical history for RecallGet. Pass only candidate IDs returned by ContextSwapCandidates.",
   parameters: {
     type: "object",
     additionalProperties: false,

package/src/tools/read.ts

@@ -32,7 +32,7 @@ export function createReadToolExecutor(options: ReadToolOptions): ToolExecutor {
     definition: {
       name: "Read",
       description:
-        "Read a file from the local workspace. Use offset and limit for line ranges.",
+        "Read a file from the local filesystem. Use offset and limit for line ranges.",
       parameters: {
         type: "object",
         additionalProperties: false,

package/src/tools/wait.ts

@@ -13,9 +13,7 @@ export function createWaitToolExecutor(): ToolExecutor {
   return defineToolExecutor("wait", {
     definition: {
       name: "Wait",
-      description:
-        `Wait for a given number of integer seconds before continuing, from ${MIN_WAIT_SECONDS} to ${MAX_WAIT_SECONDS}. ` +
-        "Use this to pause between polling attempts or to give an external process time to make progress.",
+      description: `Wait for a given number of integer seconds before continuing, from ${MIN_WAIT_SECONDS} to ${MAX_WAIT_SECONDS}. `,
       parameters: {
         type: "object",
         additionalProperties: false,