From 35197ed933044d322d0a653c4e88a5f3e475fe76 Mon Sep 17 00:00:00 2001
From: Adam Malczewski <github@tradam.dev>
Date: Fri, 12 Jun 2026 19:26:31 +0900
Subject: feat(contracts): reasoning effort — ReasoningEffort ladder
 (low..max), ProviderStreamOptions/ChatRequest fields, per-conversation
 GET/PUT types
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

wire 0.6.1->0.7.0, transport-contract 0.10.0->0.11.0. Additive only; typecheck+biome clean.
---
 packages/wire/src/index.ts | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'packages/wire/src')

diff --git a/packages/wire/src/index.ts b/packages/wire/src/index.ts
index 4fdf389..6a6de7d 100644
--- a/packages/wire/src/index.ts
+++ b/packages/wire/src/index.ts
@@ -146,6 +146,20 @@ export interface StoredChunk {
 	readonly chunk: Chunk;
 }
 
+// ─── Reasoning effort ───────────────────────────────────────────────────────
+
+/**
+ * The per-request thinking-depth knob: how much extended thinking / reasoning
+ * the model should spend before answering. Provider-agnostic ladder; each
+ * provider maps a level to its native knob in its own code (e.g. an Anthropic
+ * provider maps it to a `thinking.budget_tokens` value) and MAY ignore levels
+ * (or the field entirely) that its backend cannot express.
+ *
+ * Resolution (owned by the session-orchestrator): per-turn request value →
+ * persisted per-conversation value → default `"high"`.
+ */
+export type ReasoningEffort = "low" | "medium" | "high" | "xhigh" | "max";
+
 // ─── Usage ──────────────────────────────────────────────────────────────────
 
 /**
-- 
cgit v1.2.3