From 4cb0c3b4ff1f9534674cfd602213b2eddf80a0e0 Mon Sep 17 00:00:00 2001
From: Matt Apperson <me@mattapperson.com>
Date: Tue, 5 May 2026 20:50:51 -0400
Subject: [PATCH] chore: version packages for HITL tools release (0.5.0)

Consumes the pre-existing `curvy-streams-watch` patch changeset (stream
detection regression coverage from #34) and adds a new minor changeset
covering the human-in-the-loop tool type merged in #38.
---
 .changeset/curvy-streams-watch.md |  5 ----
 packages/agent/CHANGELOG.md       | 38 +++++++++++++++++++++++++++++++
 packages/agent/package.json       |  2 +-
 3 files changed, 39 insertions(+), 6 deletions(-)
 delete mode 100644 .changeset/curvy-streams-watch.md

diff --git a/.changeset/curvy-streams-watch.md b/.changeset/curvy-streams-watch.md
deleted file mode 100644
index 17d5e16..0000000
--- a/.changeset/curvy-streams-watch.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@openrouter/agent": patch
----
-
-Detect streamed Responses API results by readable stream behavior instead of constructor names or unsupported adapters.
diff --git a/packages/agent/CHANGELOG.md b/packages/agent/CHANGELOG.md
index 6781f26..395d0e8 100644
--- a/packages/agent/CHANGELOG.md
+++ b/packages/agent/CHANGELOG.md
@@ -1,5 +1,43 @@
 # @openrouter/agent
 
+## 0.5.0
+
+### Minor Changes
+
+- Add human-in-the-loop (HITL) tool type, a new `ClientTool` variant that sits
+  between regular `execute` tools and `manual` tools. HITL tools define two
+  async hooks:
+
+  - `onToolCalled(input, context)` runs when the model invokes the tool.
+    Return a value to feed the model directly (like a regular `execute` tool),
+    or return `null` to pause the conversation so the caller can supply the
+    output later — the same flow used by manual tools.
+  - `onResponseReceived(rawResult, context)` runs on the next turn when an
+    incoming `function_call_output` matches a prior call of this tool. It lets
+    the caller transform or validate the raw response before it reaches the
+    model. Throwing surfaces as a tool error to the model.
+
+  HITL tools require an `outputSchema`, which is used to validate both the
+  `onToolCalled` return value (when non-null) and caller-supplied responses
+  (after any `onResponseReceived` transform, or as-is when no hook is defined).
+
+  New `ConversationStatus` value `'awaiting_hitl'` is emitted when one or more
+  HITL tools return `null` from `onToolCalled`, signaling that the caller
+  should resume with outputs for the paused calls.
+
+  New public exports:
+
+  - Types: `HITLTool`, `HITLToolFunction`
+  - Guards: `isHITLTool`, `isAutoResolvableTool` (true for execute / generator
+    / HITL tools — i.e. anything that can resolve within a turn)
+
+  `isManualTool` now returns `false` for HITL tools, so existing manual-tool
+  branches continue to behave correctly.
+
+### Patch Changes
+
+- [#34](https://github.com/OpenRouterTeam/typescript-agent/pull/34) [`61aca10`](https://github.com/OpenRouterTeam/typescript-agent/commit/61aca10fd9434fe69fbe1e069e4b1858613a7da7) Thanks [@w0nche0l](https://github.com/w0nche0l)! - Detect streamed Responses API results by readable stream behavior instead of constructor names or unsupported adapters.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/agent/package.json b/packages/agent/package.json
index 31abc8b..89362c8 100644
--- a/packages/agent/package.json
+++ b/packages/agent/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/agent",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "author": "OpenRouter",
   "description": "Agent toolkit for building AI applications with OpenRouter — tool orchestration, streaming, multi-turn conversations, and format compatibility.",
   "keywords": [