@tansr/serve 0.2.0 → 0.3.1

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) }),
@@ -38509,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;
@@ -60547,10 +60556,30 @@ function createAppTokenFetch(token, inner) {
   };
   return wrapped;
 }
+async function fetchTwpFeatures(base, token, fetchImpl, sessionId) {
+  try {
+    const response = await fetchImpl(`${base}${TWP_ENDPOINT_PATHS.heartbeat}`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json",
+        [HEADER_APP_TOKEN]: token
+      },
+      body: JSON.stringify({ client: "sdk", ...sessionId !== void 0 ? { sessionId } : {} })
+    });
+    if (!response.ok) return void 0;
+    const raw = await response.json();
+    const features = raw?.features;
+    return Array.isArray(features) ? features.filter((f) => typeof f === "string") : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function assemblePlatformModel(options) {
   const base = options.baseUrl.replace(/\/+$/, "");
   const innerFetch = options.fetchImpl ?? fetch;
   const url = `${base}${TWP_ENDPOINT_PATHS.config}`;
+  const featuresPromise = fetchTwpFeatures(base, options.token, innerFetch, options.sessionId?.());
   let response;
   try {
     response = await innerFetch(url, {
@@ -60587,13 +60616,18 @@ async function assemblePlatformModel(options) {
       `App config bundle from ${url} has an unexpected shape. Check that "baseUrl" points to the tansr API.`
     );
   }
+  const features = await featuresPromise;
   const registry = new ProviderRegistry(appBundleRegistryConfig(bundle, base), {
     // 占位哑值:满足装配期 readApiKey 非空校验;真实鉴权恒由 fetch 包装注入
     env: { [APP_TOKEN_PLACEHOLDER_ENV]: APP_TOKEN_PLACEHOLDER_VALUE },
     fetchImpl: createAppTokenFetch(options.token, options.fetchImpl),
     // 拍板⑤:平台会话 id 供给经既有 TwpClientOptions.sessionId 缝出线——
-    // registry 为会话私有(每次装配新建),setModel/Task 子代理同缝同值
-    ...options.sessionId !== void 0 ? { twp: { sessionId: options.sessionId } } : {}
+    // registry 为会话私有(每次装配新建),setModel/Task 子代理同缝同值。
+    // S-TH3:features 能力串同缝供给(闭包定格;undefined = 门全关同现状)
+    twp: {
+      ...options.sessionId !== void 0 ? { sessionId: options.sessionId } : {},
+      features: () => features
+    }
   });
   const built = buildClientFromRegistry(registry, options.model ?? "main", options.onProviderSelected);
   return { ...built, registry, capabilities: bundle.capabilities, platformModels: bundle.platformModels };
@@ -61126,6 +61160,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 } : {}
       });
@@ -61327,7 +61363,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.2.0",
+  "version": "0.3.1",
   "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",