@tansr/sdk 0.5.0 → 0.7.0

package/README.md

@@ -63,7 +63,9 @@ for await (const event of session.events) {
   开发者可选:`{ delivery: { text: 'stream'|'final', thinking: 'stream'|'final'|'off' } }`
   ——文本/思考各自选流式或整段一次性,思考可整体关显(状态派生与工具卡恒不受影响,
   缺省全流式零漂移);且可**动态切换**:`view.setDelivery(delivery)` 块粒度即时生效,
-  切 off 自动追溯剔除既有思考(详见手册 §9.1);
+  切 off 自动追溯剔除既有思考;生成面思考(产不产/预算)走
+  `createSession({ thinking: { budget } })` + `session.setThinking(…)`(下一轮生效),
+  与呈现档正交(详见手册 §9.1);
 - **权限**:`permission: { mode?, rules?, askUser? }`——ask 裁决桥到你的 UI,缺席
   fail-closed 降级 deny;
 - **计量**:`cost.usage.updated` 逐请求;终端自查 `/v1/my-usage` 恒无金额字段,

package/dist/index.d.ts

@@ -16086,6 +16086,15 @@ interface CreateSessionOptions {
     system?: IRSystemSegment[];
     /** 缺省 8192 */
     maxTokens?: number;
+    /**
+     * 思考生成(**生成面**旋钮;呈现面走 SessionView 的 delivery 选项,两旋钮
+     * 正交):逐轮透传 IRRequest.thinking(budget = 思考 token 预算,按模型
+     * 方言映射)。缺省缺席 = 不注入(沿模型/适配器缺省,多数模型即不产思考)。
+     * 会话中可经 setThinking 动态换,下一轮生效。
+     */
+    thinking?: {
+        budget?: number;
+    };
     /** 单轮 modelTurns 护栏;缺省 200(与 serve 对齐) */
     maxTurnsPerQuery?: number;
     /** 缺省 randomUUID() */
@@ -16165,6 +16174,9 @@ interface AgentSessionInit {
     cwd: string;
     sessionId: string;
     maxTokens: number;
+    thinking: {
+        budget?: number;
+    } | undefined;
     maxTurnsPerQuery: number;
     compaction: QueryCompactionOptions | undefined;
     initialMessages: readonly IRMessage[];
@@ -16204,6 +16216,14 @@ declare class AgentSession {
      *   不可复用);contextWindowTokens 不传则清空(宁缺毋错)。
      */
     setModel(next: string | SetModelBinding): void;
+    /**
+     * 动态切换思考生成(生成面旋钮,setModel 同形制):下一轮生效,运行中轮
+     * 不受影响。undefined = 回到不注入(模型缺省);呈现面(思考显示与否)
+     * 走 SessionView delivery,两旋钮正交互不推导。
+     */
+    setThinking(thinking: {
+        budget?: number;
+    } | undefined): void;
     /**
      * 关闭会话(幂等):空闲立即收口(session.ended + 流终结);运行中先
      * abort,收口推迟到泵终态——中止轮的尾部事件(turn.aborted 等)不丢失。

package/dist/index.js

@@ -28554,6 +28554,10 @@ var TWP_FEATURE_REASONING_OFF = "reasoning-off";
 function sendableTwpReasoningOff(features) {
   return features !== void 0 && features.includes(TWP_FEATURE_REASONING_OFF);
 }
+var TWP_FEATURE_REASONING_CONTENT = "reasoning-content";
+function sendableTwpReasoningContent(features) {
+  return features !== void 0 && features.includes(TWP_FEATURE_REASONING_CONTENT);
+}
 
 // ../providers/src/twp/signing.ts
 import { createHash as createHash11, createHmac, randomBytes } from "node:crypto";
@@ -28664,6 +28668,11 @@ function irMessageToTwp(message, sendImages) {
   if (blocks.length === 0) return null;
   return { role: message.role, blocks };
 }
+function reasoningLevelOfBudget(budget) {
+  if (budget <= 1024) return "low";
+  if (budget <= 4096) return "medium";
+  return "high";
+}
 function irRequestToTwpWire(request, opts = {}) {
   const sendImages = opts.sendImages ?? false;
   const cacheHints = opts.cacheHints ?? false;
@@ -28700,7 +28709,12 @@ function irRequestToTwpWire(request, opts = {}) {
       // ——服务端缺席语义 = 仅既有输出钳制,零行为变化
       ...request.promptTokensEstimate !== void 0 && Math.ceil(request.promptTokensEstimate) >= 1 ? { promptTokensEstimate: Math.ceil(request.promptTokensEstimate) } : {},
       // RFC-M3 B2:思考关断出线(门开 × IR off 双判;门关恒不落键零漂移)
-      ...opts.reasoningOff === true && request.thinking?.off === true ? { reasoning: "off" } : {}
+      ...opts.reasoningOff === true && request.thinking?.off === true ? { reasoning: "off" } : (
+        // S-TH1:思考开启出线(门开 × IR budget 双判;off 恒胜 budget)——
+        // budget → 档位反查(EFFORT_THINKING_BUDGET 同族阈值:≤1024 low /
+        // ≤4096 medium / 其余 high),网关按方言翻译
+        opts.reasoningLevels === true && request.thinking?.off !== true && typeof request.thinking?.budget === "number" && request.thinking.budget > 0 ? { reasoning: reasoningLevelOfBudget(request.thinking.budget) } : {}
+      )
     },
     meta: {
       requestId: opts.requestId ?? ulid(),
@@ -28968,6 +28982,13 @@ var TwpStreamAssembler = class {
       out.push({ t: "text_delta", index: i, text: v });
       return out;
     }
+    if (kind === "thinking") {
+      const v = record["v"];
+      if (typeof v !== "string") return out;
+      out.push(...this.#ensureBlock(i, "thinking", record));
+      out.push({ t: "thinking_delta", index: i, text: v });
+      return out;
+    }
     if (kind === "tool_use") {
       out.push(...this.#ensureBlock(i, "tool_use", record));
       const vJson = record["vJson"];
@@ -28991,6 +29012,8 @@ var TwpStreamAssembler = class {
     }
     if (kind === "text") {
       out.push({ t: "block_start", index: i, block: { t: "text", text: "" } });
+    } else if (kind === "thinking") {
+      out.push({ t: "block_start", index: i, block: { t: "thinking", text: "" } });
     } else {
       out.push({
         t: "block_start",
@@ -29120,6 +29143,7 @@ var TwpAdapter = class {
       );
       const cacheHints = sendableTwpCacheHints(this.#options.features?.());
       const reasoningOff = sendableTwpReasoningOff(this.#options.features?.());
+      const reasoningLevels = sendableTwpReasoningContent(this.#options.features?.());
       try {
         body = JSON.stringify(
           irRequestToTwpWire(request, {
@@ -29131,7 +29155,8 @@ var TwpAdapter = class {
             ...sendImages ? { sendImages } : {},
             ...cacheHints ? { cacheHints } : {},
             ...cacheHints && platformSessionId !== void 0 ? { cacheKey: platformSessionId } : {},
-            ...reasoningOff ? { reasoningOff } : {}
+            ...reasoningOff ? { reasoningOff } : {},
+            ...reasoningLevels ? { reasoningLevels } : {}
           })
         );
       } catch (err) {
@@ -32387,6 +32412,7 @@ var AgentSession = class {
   #system;
   #tools;
   #maxTokens;
+  #thinking;
   #sessionId;
   #maxTurnsPerQuery;
   #compaction;
@@ -32409,6 +32435,7 @@ var AgentSession = class {
     this.#system = init.system;
     this.#tools = init.tools;
     this.#maxTokens = init.maxTokens;
+    this.#thinking = init.thinking;
     this.#sessionId = init.sessionId;
     this.#maxTurnsPerQuery = init.maxTurnsPerQuery;
     this.#compaction = init.compaction;
@@ -32484,6 +32511,14 @@ var AgentSession = class {
       ...next.maxOutputTokens !== void 0 ? { maxOutputTokens: next.maxOutputTokens } : {}
     };
   }
+  /**
+   * 动态切换思考生成(生成面旋钮,setModel 同形制):下一轮生效,运行中轮
+   * 不受影响。undefined = 回到不注入(模型缺省);呈现面(思考显示与否)
+   * 走 SessionView delivery,两旋钮正交互不推导。
+   */
+  setThinking(thinking) {
+    this.#thinking = thinking;
+  }
   /**
    * 关闭会话(幂等):空闲立即收口(session.ended + 流终结);运行中先
    * abort,收口推迟到泵终态——中止轮的尾部事件(turn.aborted 等)不丢失。
@@ -32544,6 +32579,7 @@ var AgentSession = class {
       tools: this.#tools,
       model: binding.model,
       maxTokens: this.#maxTokens,
+      ...this.#thinking !== void 0 ? { thinking: this.#thinking } : {},
       sessionId: this.#sessionId,
       initialMessages,
       maxTurns: this.#maxTurnsPerQuery,
@@ -32786,6 +32822,7 @@ async function createSession(options = {}) {
     cwd,
     sessionId,
     maxTokens,
+    thinking: options.thinking,
     maxTurnsPerQuery: options.maxTurnsPerQuery ?? DEFAULT_MAX_TURNS,
     compaction: options.compaction === false ? void 0 : options.compaction ?? {},
     initialMessages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tansr/sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Tansr public TypeScript SDK: headless agent API (query / createSession / runAgent) + pure protocol type re-exports (public, MIT).",
   "license": "MIT",
   "type": "module",