@tansr/serve 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -4397,7 +4397,24 @@ declare const CreateSessionBodySchema: z.ZodObject<{
         readOnly?: boolean | undefined;
     }>, "many">>;
     capabilitiesProfile: z.ZodOptional<z.ZodString>;
+    /**
+     * S-TH2(用户拍板 2026-09-01,doc/98 冻结面加法):思考生成(生成面旋钮)
+     * ——逐轮透传内核 IRRequest.thinking(budget = 思考 token 预算,按模型
+     * 方言映射;平台令牌档经 TWP reasoning 档位出线,S-TH1)。缺席 = 装配面
+     * 缺省(工厂 thinking 选项),两级皆缺席恒不注入(现状零漂移)。思考的
+     * 呈现走客户端 SessionView delivery(呈现面),与本键正交。
+     */
+    thinking: z.ZodOptional<z.ZodObject<{
+        budget: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        budget?: number | undefined;
+    }, {
+        budget?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    thinking?: {
+        budget?: number | undefined;
+    } | undefined;
     model?: string | undefined;
     tools?: string[] | undefined;
     budget?: {
@@ -4422,6 +4439,9 @@ declare const CreateSessionBodySchema: z.ZodObject<{
     }[] | undefined;
     capabilitiesProfile?: string | undefined;
 }, {
+    thinking?: {
+        budget?: number | undefined;
+    } | undefined;
     model?: string | undefined;
     tools?: string[] | undefined;
     budget?: {
@@ -4815,6 +4835,10 @@ interface AgentSessionCreateInit {
     resume?: {
         sessionId: string;
     };
+    /** S-TH2:思考生成(生成面;缺席 = 装配面缺省,两级皆缺席恒不注入) */
+    thinking?: {
+        budget?: number;
+    };
 }
 interface AgentSessionCreateResult {
     handle: AgentSessionHandle;
@@ -4916,6 +4940,14 @@ interface SessionInit {
         maxUsd?: number;
         maxTokens?: number;
     };
+    /**
+     * S-TH2(2026-09-01):思考生成(生成面旋钮)——逐轮透传 IRRequest.thinking。
+     * 优先级:本键(wire,per-会话)> 装配面缺省(工厂选项/profile effort)>
+     * 恒不注入(现状)。
+     */
+    thinking?: {
+        budget?: number;
+    };
 }
 /**
  * 会话句柄——装配层对内核会话的最小操控面。
@@ -9522,8 +9554,9 @@ interface ServeSessionDriverOptions {
     /** 缺省 8192 */
     maxTokens?: number;
     /**
-     * 思考预算(OPT-15 effort 档位映射产物;工厂经 applyEffort 计算):
-     * 逐轮透传 runQuery → IRRequest.thinking。缺省不注入(现状)。
+     * 思考预算:逐轮透传 runQuery → IRRequest.thinking。取值三级(S-TH2
+     * 用户拍板 2026-09-01):wire thinking 键(per-会话)> 装配面缺省(平台
+     * 形工厂 options.thinking / cli 形 profile effort 档)> 缺席恒不注入。
      */
     thinking?: {
         budget?: number;
@@ -9830,6 +9863,13 @@ interface PlatformServeSessionFactoryOptions {
     maxTokens?: number;
     /** 单轮 modelTurns 上限(防失控;缺省不设) */
     maxTurnsPerQuery?: number;
+    /**
+     * S-TH2(用户拍板 2026-09-01):装配面思考生成缺省(serve 旋钮)——
+     * 会话未带 wire thinking 键时的兜底;wire 键恒胜。两级皆缺席恒不注入。
+     */
+    thinking?: {
+        budget?: number;
+    };
     /** runQuery 注入缝(测试脚本化;缺省 kernel runQuery) */
     runQueryImpl?: typeof runQuery;
 }

package/dist/index.js

@@ -37955,7 +37955,15 @@ var CreateSessionBodySchema = z11.object({
   endUser: z11.object({ id: z11.string().regex(END_USER_ID_PATTERN) }).optional(),
   resume: z11.object({ sessionId: z11.string().min(1) }).optional(),
   clientTools: z11.array(ClientToolDeclSchema).max(V2_LIMITS.maxClientTools).optional(),
-  capabilitiesProfile: z11.string().min(1).optional()
+  capabilitiesProfile: z11.string().min(1).optional(),
+  /**
+   * S-TH2(用户拍板 2026-09-01,doc/98 冻结面加法):思考生成(生成面旋钮)
+   * ——逐轮透传内核 IRRequest.thinking(budget = 思考 token 预算,按模型
+   * 方言映射;平台令牌档经 TWP reasoning 档位出线,S-TH1)。缺席 = 装配面
+   * 缺省(工厂 thinking 选项),两级皆缺席恒不注入(现状零漂移)。思考的
+   * 呈现走客户端 SessionView delivery(呈现面),与本键正交。
+   */
+  thinking: z11.object({ budget: z11.number().int().positive().optional() }).optional()
 });
 var MessageBlockSchema = z11.discriminatedUnion("t", [
   z11.object({ t: z11.literal("text"), text: z11.string().min(1).max(V2_LIMITS.textBlockMaxChars) }),
@@ -38337,6 +38345,26 @@ var AgentSessionRegistry = class {
   }
 };
 
+// src/v2/history-projection.ts
+var REMINDER_OPEN = "<system-reminder>";
+var REMINDER_CLOSE = "</system-reminder>";
+function isReminderBlock(block) {
+  return block.t === "text" && block.text.startsWith(REMINDER_OPEN) && block.text.endsWith(REMINDER_CLOSE);
+}
+function stripReminderBlocks(messages) {
+  const out = [];
+  for (const message of messages) {
+    if (message.role !== "user" || !message.blocks.some(isReminderBlock)) {
+      out.push(message);
+      continue;
+    }
+    const blocks = message.blocks.filter((block) => !isReminderBlock(block));
+    if (blocks.length === 0) continue;
+    out.push({ ...message, blocks });
+  }
+  return out;
+}
+
 // src/v2/types.ts
 var AgentSessionCreateError = class extends Error {
   code;
@@ -38489,7 +38517,8 @@ function createAgentRoutesHandler(deps) {
       ...init.tools !== void 0 ? { tools: init.tools } : {},
       ...init.clientTools !== void 0 ? { clientTools: init.clientTools } : {},
       ...init.capabilitiesProfile !== void 0 ? { capabilitiesProfile: init.capabilitiesProfile } : {},
-      ...init.resume !== void 0 ? { resume: init.resume } : {}
+      ...init.resume !== void 0 ? { resume: init.resume } : {},
+      ...init.thinking !== void 0 ? { thinking: init.thinking } : {}
     };
     let handle;
     let resumed;
@@ -38683,7 +38712,11 @@ function createAgentRoutesHandler(deps) {
     if (record === "forbidden") return;
     if (record !== "absent") {
       const snapshot = record.handle.historySnapshot();
-      sendJson(res, 200, { sessionId, lastSeq: snapshot.lastSeq, messages: snapshot.messages });
+      sendJson(res, 200, {
+        sessionId,
+        lastSeq: snapshot.lastSeq,
+        messages: stripReminderBlocks(snapshot.messages)
+      });
       return;
     }
     let messages;
@@ -38699,7 +38732,7 @@ function createAgentRoutesHandler(deps) {
       notFound(res, sessionId);
       return;
     }
-    sendJson(res, 200, { sessionId, lastSeq: 0, messages });
+    sendJson(res, 200, { sessionId, lastSeq: 0, messages: stripReminderBlocks(messages) });
   };
   const handleInterrupt = (res, sessionId, endUserId) => {
     const record = ownedRecord(res, sessionId, endUserId);
@@ -56650,6 +56683,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 as createHmac2, randomBytes } from "node:crypto";
@@ -56760,6 +56797,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;
@@ -56796,7 +56838,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(),
@@ -57064,6 +57111,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"];
@@ -57087,6 +57141,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",
@@ -57216,6 +57272,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, {
@@ -57227,7 +57284,8 @@ var TwpAdapter = class {
             ...sendImages ? { sendImages } : {},
             ...cacheHints ? { cacheHints } : {},
             ...cacheHints && platformSessionId !== void 0 ? { cacheKey: platformSessionId } : {},
-            ...reasoningOff ? { reasoningOff } : {}
+            ...reasoningOff ? { reasoningOff } : {},
+            ...reasoningLevels ? { reasoningLevels } : {}
           })
         );
       } catch (err) {
@@ -61077,6 +61135,8 @@ function createPlatformServeSessionFactory(options) {
         compaction: assembled.compaction ?? {},
         ...assembled.compactionManagerOptions !== void 0 ? { compactionManagerOptions: assembled.compactionManagerOptions } : {},
         reminders: createReminderProvider({ todoStore }),
+        // S-TH2:思考生成两级取值——wire 键(per-会话)恒胜装配面缺省
+        ...init.thinking !== void 0 ? { thinking: init.thinking } : options.thinking !== void 0 ? { thinking: options.thinking } : {},
         ...extras?.onTurnEnd !== void 0 ? { onTurnEnd: extras.onTurnEnd } : {},
         ...options.runQueryImpl !== void 0 ? { runQueryImpl: options.runQueryImpl } : {}
       });
@@ -61278,7 +61338,8 @@ function createAgentSessionFactory(options) {
             ...init.profile !== void 0 ? { profile: init.profile } : {},
             ...init.labels !== void 0 ? { labels: init.labels } : {},
             ...init.budget !== void 0 ? { budget: init.budget } : {},
-            ...effectiveTools !== void 0 ? { tools: [...effectiveTools] } : {}
+            ...effectiveTools !== void 0 ? { tools: [...effectiveTools] } : {},
+            ...init.thinking !== void 0 ? { thinking: init.thinking } : {}
           },
           {
             sessionId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tansr/serve",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Tansr agent session server: the bare /v2 agent-session protocol engine (REST + SSE) you embed in your own Node service. Session auth is fully yours via the authenticate seam. Published as @tansr/serve (decided 2026-09-01); the pack script stamps the publish name into the tarball.",
   "license": "MIT",
   "type": "module",