@tansr/sdk 0.4.0 → 0.5.0

package/README.md

@@ -49,12 +49,21 @@ for await (const event of session.events) {
   ——环2 内置本地工具(read/glob/grep/shell/…)、环3 平台托管能力(imageGen 图像
   生成,平台代调按张计费)、环1 `defineTool` 业务函数(注册即说明书,JSON 参数表/
   zod 双档);
+- **联网搜索双位双门**:webSearch 工具本体是内置 `WebSearch`(写在 `tools.builtin`,
+  旧写法 `tools.platform` 报迁移错),后端恒平台通道(按次计费归 App,SDK 恒无 BYO
+  径)——装配需双位齐开(`tools.webSearch` 工具位 + `platform.webSearch` 通道位)且
+  令牌档在场;缺席选择时门不备静默不装,显式选择即 fail-fast 分因可读错(详见手册
+  §5.3);
 - **skills**:`defineSkill` 内联 + `dirs` 目录装载(`<name>/SKILL.md`),按需装载零
   发现(恒不扫用户目录);
 - **MCP 外接**:`createMcpHost({ servers })` 应用级共享 / `mcp: { servers }` 会话级,
   配置与业界 `mcpServers` 同形;
 - **渲染管道**:`createSessionView`(事件流 → 不可变视图快照,structuredClone-safe,
-  Electron IPC 直传)+ `createNarrator`(人类可读日志行);恒不用手拼事件;
+  Electron IPC 直传)+ `createNarrator`(人类可读日志行);恒不用手拼事件;呈现档
+  开发者可选:`{ delivery: { text: 'stream'|'final', thinking: 'stream'|'final'|'off' } }`
+  ——文本/思考各自选流式或整段一次性,思考可整体关显(状态派生与工具卡恒不受影响,
+  缺省全流式零漂移);且可**动态切换**:`view.setDelivery(delivery)` 块粒度即时生效,
+  切 off 自动追溯剔除既有思考(详见手册 §9.1);
 - **权限**:`permission: { mode?, rules?, askUser? }`——ask 裁决桥到你的 UI,缺席
   fail-closed 降级 deny;
 - **计量**:`cost.usage.updated` 逐请求;终端自查 `/v1/my-usage` 恒无金额字段,

package/dist/index.d.ts

@@ -10087,6 +10087,50 @@ interface Tool<Args = unknown> {
     execute(args: Args, ctx: ToolContext): Promise<ToolResult>;
 }
 
+/**
+ * T-D6 — 会话待办台账(内存态,不做持久化)。
+ *
+ * 设计要点:
+ * - `TodoItem` 形状与 protocol `plan.todo.updated` 事件的 items 对齐
+ *   (id/content/status 三字段;status 在事件侧是宽松 string,本侧收窄为枚举);
+ * - 依赖注入:`onChange` 由工厂(内核会话装配处)注入,store 本身不发事件、
+ *   不落盘——外部在回调里接线 `plan.todo.updated` 事件与(未来的)持久化;
+ * - 所有对外暴露的数组/对象均为副本,防止调用方或回调持引用后污染内部状态。
+ */
+/** 待办状态全集(as const 元组,供 zod enum 与类型共用一份事实源) */
+declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
+type TodoStatus = (typeof TODO_STATUSES)[number];
+interface TodoItem {
+    id: string;
+    content: string;
+    status: TodoStatus;
+}
+/**
+ * merge 输入:按 id 定位,已知 id 只覆盖给定字段(未给字段保留原值);
+ * 未知 id 追加为新项,此时 content 与 status 必须齐全(TodoWrite 工具
+ * 的 schema 恒为全量,不会触发缺字段路径;此约束仅防御其他内部调用方)。
+ */
+type TodoPatch = {
+    id: string;
+} & Partial<Omit<TodoItem, 'id'>>;
+interface TodoStoreOptions {
+    /** 变更回调:replace/merge 每次调用后触发一次,载荷为变更后完整列表的独立副本 */
+    onChange?: (items: TodoItem[]) => void;
+}
+declare class TodoStore {
+    #private;
+    constructor(options?: TodoStoreOptions);
+    /** 当前列表(副本;修改返回值不影响内部状态) */
+    list(): TodoItem[];
+    /** 全量替换(含替换为空 = 清空台账),返回变更后快照 */
+    replace(items: readonly TodoItem[]): TodoItem[];
+    /**
+     * 按 id 合并:已知 id 原位覆盖给定字段;未知 id 按提交顺序追加到尾部。
+     * 返回变更后快照。未知 id 缺 content/status 视为调用方契约错误,抛 TypeError。
+     */
+    merge(patches: readonly TodoPatch[]): TodoItem[];
+}
+
 /**
  * T-C1 — 测试用顺序工具执行器(ToolExecutor 的最小实现)。
  *
@@ -10820,50 +10864,6 @@ type OnToolDecision = (record: ToolDecisionRecord) => void;
  */
 type CaptureFileCheckpoints = (paths: readonly string[]) => Promise<void> | void;
 
-/**
- * T-D6 — 会话待办台账(内存态,不做持久化)。
- *
- * 设计要点:
- * - `TodoItem` 形状与 protocol `plan.todo.updated` 事件的 items 对齐
- *   (id/content/status 三字段;status 在事件侧是宽松 string,本侧收窄为枚举);
- * - 依赖注入:`onChange` 由工厂(内核会话装配处)注入,store 本身不发事件、
- *   不落盘——外部在回调里接线 `plan.todo.updated` 事件与(未来的)持久化;
- * - 所有对外暴露的数组/对象均为副本,防止调用方或回调持引用后污染内部状态。
- */
-/** 待办状态全集(as const 元组,供 zod enum 与类型共用一份事实源) */
-declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
-type TodoStatus = (typeof TODO_STATUSES)[number];
-interface TodoItem {
-    id: string;
-    content: string;
-    status: TodoStatus;
-}
-/**
- * merge 输入:按 id 定位,已知 id 只覆盖给定字段(未给字段保留原值);
- * 未知 id 追加为新项,此时 content 与 status 必须齐全(TodoWrite 工具
- * 的 schema 恒为全量,不会触发缺字段路径;此约束仅防御其他内部调用方)。
- */
-type TodoPatch = {
-    id: string;
-} & Partial<Omit<TodoItem, 'id'>>;
-interface TodoStoreOptions {
-    /** 变更回调:replace/merge 每次调用后触发一次,载荷为变更后完整列表的独立副本 */
-    onChange?: (items: TodoItem[]) => void;
-}
-declare class TodoStore {
-    #private;
-    constructor(options?: TodoStoreOptions);
-    /** 当前列表(副本;修改返回值不影响内部状态) */
-    list(): TodoItem[];
-    /** 全量替换(含替换为空 = 清空台账),返回变更后快照 */
-    replace(items: readonly TodoItem[]): TodoItem[];
-    /**
-     * 按 id 合并:已知 id 原位覆盖给定字段;未知 id 按提交顺序追加到尾部。
-     * 返回变更后快照。未知 id 缺 content/status 视为调用方契约错误,抛 TypeError。
-     */
-    merge(patches: readonly TodoPatch[]): TodoItem[];
-}
-
 /**
  * T-D6 — 交互通道抽象:AskUser 工具与表面层之间的依赖注入缝。
  *
@@ -16293,6 +16293,35 @@ declare class TansrSdkError extends Error {
 
 /** 会话即时状态(状态机推导见 deriveStatus;'error' = 最近终态轮以模型错误收场) */
 type SessionViewStatus = 'idle' | 'thinking' | 'responding' | 'tooling' | 'awaiting_permission' | 'compacting' | 'error';
+/** 文本呈现档:'stream' 流式增量(缺省)| 'final' 块定稿整段一次性落 part */
+type TextDeliveryMode = 'stream' | 'final';
+/** 思考呈现档:'stream'(缺省)| 'final' | 'off' 恒不物化(状态派生仍见 thinking) */
+type ThinkingDeliveryMode = 'stream' | 'final' | 'off';
+/**
+ * 呈现档选项(用户拍板 2026-09-01「呈现方式做成会话选项交给开发者选」):
+ * 恒只影响 text/thinking part 的物化时机与在场性——状态机派生(thinking/
+ * responding 等)与工具卡(本就一次性整卡)恒不受档位影响。缺省全 'stream'
+ * = 既有行为零漂移。
+ */
+interface SessionViewDeliveryOptions {
+    /** 文本:'stream'(缺省)边收边显 | 'final' 整段生成完一次性显示 */
+    readonly text?: TextDeliveryMode;
+    /**
+     * 思考:'stream'(缺省)| 'final' 整段定稿一次性 | 'off' 恒不落视图
+     * (宿主仍可据 status==='thinking' 做「正在思考」占位)。此为呈现面开关;
+     * 生成面(是否产生思考/预算)走请求选项 thinking:{budget/off},两旋钮正交。
+     */
+    readonly thinking?: ThinkingDeliveryMode;
+}
+/** SessionView 构造选项(initialSessionViewState / createSessionView / viewStateFromHistory 同形) */
+interface SessionViewOptions {
+    readonly delivery?: SessionViewDeliveryOptions;
+}
+/** 解析后的呈现档(随 internal 落状态,resume 重建径同一份配置继续生效) */
+interface DeliveryConfig {
+    readonly text: TextDeliveryMode;
+    readonly thinking: ThinkingDeliveryMode;
+}
 /** 工具调用 part 全生命周期状态('aborted' = 轮终态时仍未收口的残留工具) */
 type ToolCallPartStatus = 'proposed' | 'awaiting_permission' | 'running' | 'completed' | 'failed' | 'denied' | 'aborted';
 interface UITextPart {
@@ -16384,6 +16413,11 @@ interface BlockTracking {
     readonly open: boolean;
     /** tool_call 块定稿后由 tool.proposed 回填 */
     readonly toolCallId?: string;
+    /**
+     * 'final' 呈现档的块内缓冲(delta 恒入此不落 part,块定稿一次性物化;
+     * 键在场 = 本块走 final 档;定稿/撤销后恒清)
+     */
+    readonly buffer?: string;
 }
 /** 当前流式 assistant 消息追踪(null = 下一个块开新消息) */
 interface CurrentMessageTracking {
@@ -16394,6 +16428,8 @@ interface CurrentMessageTracking {
     readonly sealed: boolean;
 }
 interface ViewInternalState {
+    /** 呈现档配置(构造期定格;turn/settle 恒不重置) */
+    readonly delivery: DeliveryConfig;
     readonly running: boolean;
     /** session.compacted/microcompacted 置位,下一个被处理事件清位(status 往返) */
     readonly compacting: boolean;
@@ -16416,7 +16452,7 @@ interface SessionViewReducerState {
 }
 /** 工具输出尾部聚合上限(与 TUI OUTPUT_TAIL_MAX_CHARS 同值同语义) */
 declare const OUTPUT_TAIL_MAX_CHARS = 4000;
-declare function initialSessionViewState(): SessionViewReducerState;
+declare function initialSessionViewState(options?: SessionViewOptions): SessionViewReducerState;
 /**
  * 纯函数投影:reduce(state, event) => state。
  * 未消费的事件(未知 kind / 与视图无关的 kind / 乱序孤儿)返回原引用
@@ -16429,6 +16465,23 @@ declare function reduceSessionView(state: SessionViewReducerState, event: Kernel
  * 恒不合成 user 消息——本函数是唯一补充入口,由宿主决定是否使用。
  */
 declare function appendUserMessage(state: SessionViewReducerState, text: string): SessionViewReducerState;
+/**
+ * 动态切换呈现档(纯函数;用户拍板 2026-09-01「留切换入口随时切换」):
+ * 恒**块粒度**生效——已开启的块沿其 block.start 时捕获的形态收尾(缓冲/
+ * 占位/不物化已定格在块登记,恒不中途变形),新块即用新档。恒不追溯已
+ * 物化 part;切 thinking:'off' 要既有思考即刻消失用 stripThinkingParts 配套。
+ * 档位相同恒返回原引用(泵壳零通知)。
+ */
+declare function setSessionViewDelivery(state: SessionViewReducerState, delivery: SessionViewDeliveryOptions): SessionViewReducerState;
+/**
+ * 思考 part 全量剔除(纯函数,追溯型配套件):切到 thinking:'off' 时宿主
+ * 调用本函数让**既有**思考即刻从视图消失(内核历史恒不动,仅视图面;切回
+ * 后恒不能从视图自身复原——宿主自持历史者可经 viewStateFromHistory 重建)。
+ * 滤后空 parts 的非当前消息整条移除;当前流式消息恒保留(空壳与既有同律,
+ * 块登记 partIndex 随删位重映射,被删思考块失联 partIndex 后续 delta 恒
+ * 原引用跳过)。无思考 part 时恒返回原引用。
+ */
+declare function stripThinkingParts(state: SessionViewReducerState): SessionViewReducerState;
 /**
  * 泵壳专用:事件源自身故障(自定义 AsyncIterable 抛错)时的终局错误面
  * ——比静默悬挂诚实。AgentSession.events 不抛,本路径只对自定义源可达。
@@ -16452,7 +16505,7 @@ declare function markSourceFailure(state: SessionViewReducerState, error: unknow
  *   新增消息恒不撞 id;其余内部簿记与视图字段取初始态(status='idle')。
  */
 
-declare function viewStateFromHistory(messages: readonly IRMessage[]): SessionViewReducerState;
+declare function viewStateFromHistory(messages: readonly IRMessage[], options?: SessionViewOptions): SessionViewReducerState;
 
 /**
  * S-B7 — 事件泵(view 内部共享;session-view 与 narrator 同用)。
@@ -16485,10 +16538,16 @@ interface SessionView {
      * dispose 后为无害空操作。
      */
     appendUserMessage(text: string): void;
+    /**
+     * 动态切换呈现档(块粒度生效:开启中的块按其起始档收尾,新块即用新档)。
+     * 切 thinking:'off' 时既有思考 part 一并即刻剔除(视图不变量:off ⇒ 视图
+     * 恒无思考;内核历史不动,切回后仅影响后续块)。dispose 后为无害空操作。
+     */
+    setDelivery(delivery: SessionViewDeliveryOptions): void;
     /** 停泵并清空订阅(幂等);state 冻结在最后快照 */
     dispose(): void;
 }
-declare function createSessionView(source: SessionViewSource): SessionView;
+declare function createSessionView(source: SessionViewSource, options?: SessionViewOptions): SessionView;
 
 type NarratorVerbosity = 'quiet' | 'normal' | 'verbose';
 interface NarratorOptions {
@@ -16572,9 +16631,15 @@ declare function assemblePlatformModel(options: AssemblePlatformModelOptions): P
  * 2026-08-29「开 imageGen」)。
  *
  * 环3 语义(区别于环1 defineTool 函数、环2 内置本地工具):执行不在终端本地
- * ——工具 execute 经令牌档 fetch 打平台网关 POST {baseUrl}/t1/imagegen
- * (鉴权头 x-tansr-app-token),平台代调图像上游(百炼 wan/qwen-image 系),
- * **按成功张数计量计费归 App**(开发者对终端如何转售自主,计量计费分离)。
+ * ——工具 execute 经令牌档 fetch 打平台网关(鉴权头 x-tansr-app-token),
+ * 平台代调图像上游(百炼 wan/qwen-image 系),**按成功张数计量计费归 App**
+ * (开发者对终端如何转售自主,计量计费分离)。
+ *
+ * 任务径先行(异步化拍板 2026-09-01,media-task-client.ts;videogen 同构):
+ * POST {baseUrl}/t1/imagegen/tasks 提交即返 taskId → 短请求轮询至终态——预算
+ * 耗尽/中断时 taskId 随错返出,产出可找回(服务端照跑照扣,断连语义 A 不亏)。
+ * 旧版生产无任务端点(404)自动回落 POST {baseUrl}/t1/imagegen 同步径
+ * (0.4.1 逐字同款),判定按工具实例缓存。
  *
  * 装配面:tools.platform: ['imageGen'] 且 bundle 能力位 platform.imageGen=true
  * 时由 buildSdkToolSet 装配(位关 fail-fast 可读错,三环裁剪同例);材料
@@ -16588,6 +16653,15 @@ declare function assemblePlatformModel(options: AssemblePlatformModelOptions): P
 
 /** 生成张数 wire 帽(与网关 TwpImagegenRequestSchema 同值;超模型帽由网关再钳)。 */
 declare const IMAGEGEN_TOOL_MAX_N = 4;
+/**
+ * 客户端硬超时缺省(毫秒;kernel Tool.timeoutMs 位)= 服务端生成预算 120s
+ * (tansr-api IMAGEGEN_DEFAULT_TIMEOUT_MS,解出层全模型恒用此值——含 classic
+ * 万相异步任务与 mj_task midjourney 任务轮询长径)+ 60s 余量(videogen 同口径:
+ * 请求上行/网关前置/响应回传)。kernel 统一档同为 120s、对服务端预算零余量——
+ * 任务径跑满预算时客户端恒先掐(同 videogen 的有扣无产形态,窗口更短),故
+ * 显式声明盖过。
+ */
+declare const IMAGEGEN_TOOL_TIMEOUT_MS = 180000;
 declare const ImageGenArgsSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodEffects<z.ZodString, string, string>;
@@ -16623,6 +16697,12 @@ interface ImageGenData {
     imageCount: number;
     /** 网关错误码(如 forbidden/imagegen_not_configured/model_not_authorized;成功缺席)。 */
     errorCode?: string;
+    /**
+     * 异步任务号(异步化拍板 2026-09-01;任务径在场时恒携)。预算耗尽/中断时
+     * 凭此找回产出:GET /t1/imagegen/tasks/{taskId}(服务端照跑照扣,7 天可查)。
+     * 同步回落径(旧版生产)缺席。
+     */
+    taskId?: string;
 }
 interface CreateImageGenToolOptions {
     /** 平台 API 基址(令牌档会话档;/t1 前缀由本工具追加)。 */
@@ -16639,6 +16719,12 @@ interface CreateImageGenToolOptions {
      * 直构/旧径),描述回落通用指引。
      */
     models?: readonly AppBundleImageModel[];
+    /**
+     * 客户端硬超时覆盖(毫秒;透传 kernel Tool.timeoutMs)。缺省
+     * IMAGEGEN_TOOL_TIMEOUT_MS(服务端 120s 预算 + 60s 余量)——恒不回落
+     * kernel 120s 统一档(与服务端预算零余量,任务轮询径必先掐)。
+     */
+    timeoutMs?: number;
 }
 /**
  * 环3 平台图像生成工具(kernel Tool 形态;name 'ImageGen' 沿 kernel PascalCase
@@ -16652,9 +16738,15 @@ declare function createImageGenTool(options: CreateImageGenToolOptions): Tool<Im
  * 平台托管能力)。
  *
  * 环3 语义:执行不在终端本地——工具 execute 经令牌档 fetch 打平台网关
- * POST {baseUrl}/t1/videogen(鉴权头 x-tansr-app-token),平台代调视频上游
- * (百炼 wan 视频系),**按成功生成的视频秒数计量计费归 App**(per_second
- * 系上游官方计费单位;开发者对终端如何转售自主,计量计费分离)。
+ * (鉴权头 x-tansr-app-token),平台代调视频上游(百炼 wan 视频系),**按成功
+ * 生成的视频秒数计量计费归 App**(per_second 系上游官方计费单位;开发者对
+ * 终端如何转售自主,计量计费分离)。
+ *
+ * 任务径先行(异步化拍板 2026-09-01,media-task-client.ts):POST
+ * {baseUrl}/t1/videogen/tasks 提交即返 taskId → 短请求轮询至终态——预算耗尽/
+ * 中断时 taskId 随错返出,产出可找回(服务端照跑照扣,断连语义 A 不亏)。
+ * 旧版生产无任务端点(404)自动回落 POST {baseUrl}/t1/videogen 同步长等径
+ * (0.4.1 逐字同款),判定按工具实例缓存。
  *
  * 装配面:tools.platform: ['videoGen'] 且 bundle 能力位 platform.videoGen=true
  * 时由 buildSdkToolSet 装配(位关 fail-fast 可读错);材料(baseUrl/token)
@@ -16667,6 +16759,16 @@ declare function createImageGenTool(options: CreateImageGenToolOptions): Tool<Im
 
 /** 时长 wire 帽(秒;与网关 TwpVideogenRequestSchema 同值;超模型帽由网关再钳)。 */
 declare const VIDEOGEN_TOOL_MAX_DURATION = 30;
+/**
+ * 客户端硬超时缺省(毫秒;kernel Tool.timeoutMs 位)= 服务端轮询预算 600s
+ * (tansr-api VIDEOGEN_DEFAULT_TIMEOUT_MS,解出层全模型恒用此值)+ 60s 余量
+ * (请求上行/网关前置[认证/限流/配额/预扣]/响应回传)。/t1/videogen 系服务端
+ * 同步长等——客户端必须等到服务端先出结论(成功或 upstream_timeout 退款),
+ * 恒不先掐:客户端先超时会复现「服务端成功结算而智能体无产出」的有扣无产
+ * (2026-09-01 定谳:kling-v3 实测 122-185s,kernel 120s 缺省档下结构性必超时,
+ * 三笔 ¥2.40 计 ¥7.20 有扣无产)。
+ */
+declare const VIDEOGEN_TOOL_TIMEOUT_MS = 660000;
 declare const VideoGenArgsSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodEffects<z.ZodString, string, string>;
@@ -16704,6 +16806,12 @@ interface VideoGenData {
     billedSeconds: number;
     /** 网关错误码(如 forbidden/videogen_not_configured/model_not_authorized;成功缺席)。 */
     errorCode?: string;
+    /**
+     * 异步任务号(异步化拍板 2026-09-01;任务径在场时恒携)。预算耗尽/中断时
+     * 凭此找回产出:GET /t1/videogen/tasks/{taskId}(服务端照跑照扣,7 天可查)。
+     * 同步回落径(旧版生产)缺席。
+     */
+    taskId?: string;
 }
 interface CreateVideoGenToolOptions {
     /** 平台 API 基址(令牌档会话档;/t1 前缀由本工具追加)。 */
@@ -16720,6 +16828,12 @@ interface CreateVideoGenToolOptions {
      * (注入档直构/旧径),描述回落通用指引。
      */
     models?: readonly AppBundleVideoModel[];
+    /**
+     * 客户端硬超时覆盖(毫秒;透传 kernel Tool.timeoutMs)。缺省
+     * VIDEOGEN_TOOL_TIMEOUT_MS(服务端 600s 预算 + 60s 余量)——恒不回落
+     * kernel 120s 统一档(视频生成分钟级,120s 帽结构性必超时)。
+     */
+    timeoutMs?: number;
 }
 /**
  * 环3 平台视频生成工具(kernel Tool 形态;name 'VideoGen' 沿 kernel PascalCase
@@ -16795,5 +16909,5 @@ declare function attachSdkTaskTool(toolset: SdkToolsetRef, config: AttachSdkTask
  */
 declare function subagentModelResolverOf(registry: ProviderRegistry | null): SubagentModelResolver | undefined;
 
-export { APP_SDK_CONTRACT_VERSION, APP_TOKEN_PLACEHOLDER_ENV, AgentSession, AppCapabilitiesSchema, AppTokenRequestSchema, AppTokenResponseSchema, DEFAULT_APP_CAPABILITIES, DEFAULT_MAX_TOKENS, DEFAULT_MAX_TURNS, EndUserIdSchema, HEADER_APP_TOKEN, IMAGEGEN_TOOL_MAX_N, ImageGenArgsSchema, McpHost, OUTPUT_TAIL_MAX_CHARS, PLATFORM_SEARCH_PROVIDER_NAME, QueueChannel, SequentialToolExecutor, TANSR_PROVIDER_ID, TOOL_GUIDE_LABEL, TansrSdkError, UnavailableChannel, VIDEOGEN_TOOL_MAX_DURATION, VideoGenArgsSchema, accumulateUsage, appBundleRegistryConfig, appendUserMessage, assembleManagedModel, assemblePlatformModel, assembleSdkSkills, assembleTooling, attachSdkMcp, attachSdkTaskTool, buildClientFromRegistry, buildSdkToolSet, buildToolGuideSegment, createAppTokenFetch, createFileSessionStore, createImageGenTool, createMcpHost, createNarrator, createPlatformSearchProvider, createSdkPermissionGate, createSession, createSessionView, createVideoGenTool, defineSkill, defineTool, initialSessionViewState, markSourceFailure, parseAppBundle, providerSwitchedBody, query, reduceSessionView, resolveBuiltinSelection, resolveInitialMessages, resolvePlatformSelection, runAgent, subagentModelResolverOf, toToolDef, viewStateFromHistory };
-export type { ActiveToolStatus, Answer, AppBundle, AppBundleImageModel, AppBundleMediaModel, AppBundleModel, AppBundlePlatformModels, AppBundleVideoModel, AppCapabilities, AppTokenRequest, AppTokenResponse, AskUserCallback, AssembleManagedModelOptions, AssemblePlatformModelOptions, AssembleToolingOptions, AssembledManagedModel, AssembledPlatformModel, AssembledSkills, AssembledTooling, AttachSdkTaskToolConfig, BuildSdkToolSetOptions, BuiltinToolName, Capability, CompactNowOptions, CompactNowResult, ConfigDiagnostic, CreateFileSessionStoreOptions, CreateImageGenToolOptions, CreatePlatformSearchProviderOptions, CreateSdkPermissionGateOptions, CreateSessionOptions, CreateVideoGenToolOptions, DecisionSource, DefineSkillOptions, DefineToolOptions, DefinedSkill, DefinedTool, ErrorView, EventBody, EventEnvelope, GateDecision, HistoryCommitMeta, HookOutcomeStatus, IRBlock, IRErrorKind, IRMessage, IRRequest, IRRole, IRStreamEvent, IRSystemSegment, IRToolContent, IRToolDef, IRToolResultBlock, IRUsage, ImageGenArgs, ImageGenData, ImageModelConstraints, Integrity, JournalKind, JournalRecord, KernelEvent, KernelState, LoadConfigOptions, LoadedConfig, ManagedQueryOptions, McpClientEvent, McpConnectFactory, McpConnection, McpEventObserver, McpHostOptions, McpServerConfig, McpSessionOption, ModelCallOptions, ModelClient, Narrator, NarratorOptions, NarratorVerbosity, PermissionDecision, PermissionGate, PermissionMode, PermissionOptions, PermissionRules, PlatformCapabilityName, PlatformToolContext, Pricing, PromptCachingMode, PromptChannel, ProposedToolCall, ProtocolKind, ProviderProfile, QueryCompactionOptions, QueryCounters, QueryHandle, QueryOptions, QueryResult, Question, QuestionOption, ResolvedModel, RunAgentOptions, SdkErrorCode, SdkSkillsOptions, SdkToolSet, SdkToolsOptions, SdkToolsetRef, SequentialToolHandler, SequentialToolResult, SessionEventSource, SessionRecord, SessionRecordMeta, SessionStore, SessionStoreCommitMeta, SessionStoreCreateInit, SessionView, SessionViewReducerState, SessionViewSource, SessionViewState, SessionViewStatus, SetModelBinding, SkillsFileSystem, TansrConfig, TerminalReason, TodoView, Tool, ToolCallPartStatus, ToolCallView, ToolContext, ToolErrorType, ToolExecutionContext, ToolExecutionOutcome, ToolExecutor, ToolExecutorYield, ToolParameterSpec, ToolResult, ToolResultContent, UIMessage, UIMessagePart, UITextPart, UIThinkingPart, UIToolCallPart, UsageView, VideoGenArgs, VideoGenData, VideoModelConstraints, Visibility };
+export { APP_SDK_CONTRACT_VERSION, APP_TOKEN_PLACEHOLDER_ENV, AgentSession, AppCapabilitiesSchema, AppTokenRequestSchema, AppTokenResponseSchema, DEFAULT_APP_CAPABILITIES, DEFAULT_MAX_TOKENS, DEFAULT_MAX_TURNS, EndUserIdSchema, HEADER_APP_TOKEN, IMAGEGEN_TOOL_MAX_N, IMAGEGEN_TOOL_TIMEOUT_MS, ImageGenArgsSchema, McpHost, OUTPUT_TAIL_MAX_CHARS, PLATFORM_SEARCH_PROVIDER_NAME, QueueChannel, SequentialToolExecutor, TANSR_PROVIDER_ID, TOOL_GUIDE_LABEL, TansrSdkError, UnavailableChannel, VIDEOGEN_TOOL_MAX_DURATION, VIDEOGEN_TOOL_TIMEOUT_MS, VideoGenArgsSchema, accumulateUsage, appBundleRegistryConfig, appendUserMessage, assembleManagedModel, assemblePlatformModel, assembleSdkSkills, assembleTooling, attachSdkMcp, attachSdkTaskTool, buildClientFromRegistry, buildSdkToolSet, buildToolGuideSegment, createAppTokenFetch, createFileSessionStore, createImageGenTool, createMcpHost, createNarrator, createPlatformSearchProvider, createSdkPermissionGate, createSession, createSessionView, createVideoGenTool, defineSkill, defineTool, initialSessionViewState, markSourceFailure, parseAppBundle, providerSwitchedBody, query, reduceSessionView, resolveBuiltinSelection, resolveInitialMessages, resolvePlatformSelection, runAgent, setSessionViewDelivery, stripThinkingParts, subagentModelResolverOf, toToolDef, viewStateFromHistory };
+export type { ActiveToolStatus, Answer, AppBundle, AppBundleImageModel, AppBundleMediaModel, AppBundleModel, AppBundlePlatformModels, AppBundleVideoModel, AppCapabilities, AppTokenRequest, AppTokenResponse, AskUserCallback, AssembleManagedModelOptions, AssemblePlatformModelOptions, AssembleToolingOptions, AssembledManagedModel, AssembledPlatformModel, AssembledSkills, AssembledTooling, AttachSdkTaskToolConfig, BuildSdkToolSetOptions, BuiltinToolName, Capability, CompactNowOptions, CompactNowResult, ConfigDiagnostic, CreateFileSessionStoreOptions, CreateImageGenToolOptions, CreatePlatformSearchProviderOptions, CreateSdkPermissionGateOptions, CreateSessionOptions, CreateVideoGenToolOptions, DecisionSource, DefineSkillOptions, DefineToolOptions, DefinedSkill, DefinedTool, DeliveryConfig, ErrorView, EventBody, EventEnvelope, GateDecision, HistoryCommitMeta, HookOutcomeStatus, IRBlock, IRErrorKind, IRMessage, IRRequest, IRRole, IRStreamEvent, IRSystemSegment, IRToolContent, IRToolDef, IRToolResultBlock, IRUsage, ImageGenArgs, ImageGenData, ImageModelConstraints, Integrity, JournalKind, JournalRecord, KernelEvent, KernelState, LoadConfigOptions, LoadedConfig, ManagedQueryOptions, McpClientEvent, McpConnectFactory, McpConnection, McpEventObserver, McpHostOptions, McpServerConfig, McpSessionOption, ModelCallOptions, ModelClient, Narrator, NarratorOptions, NarratorVerbosity, PermissionDecision, PermissionGate, PermissionMode, PermissionOptions, PermissionRules, PlatformCapabilityName, PlatformToolContext, Pricing, PromptCachingMode, PromptChannel, ProposedToolCall, ProtocolKind, ProviderProfile, QueryCompactionOptions, QueryCounters, QueryHandle, QueryOptions, QueryResult, Question, QuestionOption, ResolvedModel, RunAgentOptions, SdkErrorCode, SdkSkillsOptions, SdkToolSet, SdkToolsOptions, SdkToolsetRef, SequentialToolHandler, SequentialToolResult, SessionEventSource, SessionRecord, SessionRecordMeta, SessionStore, SessionStoreCommitMeta, SessionStoreCreateInit, SessionView, SessionViewDeliveryOptions, SessionViewOptions, SessionViewReducerState, SessionViewSource, SessionViewState, SessionViewStatus, SetModelBinding, SkillsFileSystem, TansrConfig, TerminalReason, TextDeliveryMode, ThinkingDeliveryMode, TodoView, Tool, ToolCallPartStatus, ToolCallView, ToolContext, ToolErrorType, ToolExecutionContext, ToolExecutionOutcome, ToolExecutor, ToolExecutorYield, ToolParameterSpec, ToolResult, ToolResultContent, UIMessage, UIMessagePart, UITextPart, UIThinkingPart, UIToolCallPart, UsageView, VideoGenArgs, VideoGenData, VideoModelConstraints, Visibility };

package/dist/index.js

@@ -30850,7 +30850,116 @@ var AppQuotaSchema = z41.object({
 
 // src/platform/imagegen-tool.ts
 import { z as z42 } from "zod";
+
+// src/platform/media-task-client.ts
+var POLL_INTERVAL_MIN_MS = 1;
+var POLL_INTERVAL_MAX_MS = 6e4;
+var DEADLINE_MARGIN_MS = 1e4;
+function sleep(ms, signal) {
+  return new Promise((resolve2) => {
+    if (signal.aborted || ms <= 0) {
+      resolve2();
+      return;
+    }
+    const timer = setTimeout(done, ms);
+    function done() {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", done);
+      resolve2();
+    }
+    signal.addEventListener("abort", done, { once: true });
+  });
+}
+function clampPollMs(v, fallback) {
+  if (typeof v !== "number" || !Number.isFinite(v) || v <= 0) return fallback;
+  return Math.min(Math.max(Math.floor(v), POLL_INTERVAL_MIN_MS), POLL_INTERVAL_MAX_MS);
+}
+function envelopeCode(raw, status) {
+  const envelope = raw ?? {};
+  const code = typeof envelope.error?.code === "string" ? envelope.error.code : `http_${status}`;
+  const message = typeof envelope.error?.message === "string" ? envelope.error.message : "request rejected";
+  return { code, message };
+}
+async function runMediaTask(options) {
+  const { base, face, payload, headers, fetchImpl, signal, budgetMs, defaultPollMs } = options;
+  const startMs = Date.now();
+  const deadlineMs = startMs + Math.max(budgetMs - DEADLINE_MARGIN_MS, Math.floor(budgetMs * 0.8));
+  let response;
+  try {
+    response = await fetchImpl(`${base}/t1/${face}/tasks`, {
+      method: "POST",
+      headers: { "content-type": "application/json", accept: "application/json", ...headers },
+      body: JSON.stringify(payload),
+      signal
+    });
+  } catch (err) {
+    if (signal.aborted) return { kind: "aborted", taskId: null };
+    return { kind: "transport_error", message: err instanceof Error ? err.message : String(err) };
+  }
+  if (response.status === 404) return { kind: "fallback_sync" };
+  let raw = null;
+  try {
+    raw = await response.json();
+  } catch {
+    raw = null;
+  }
+  if (!response.ok) return { kind: "submit_error", status: response.status, raw };
+  const submitted = raw ?? {};
+  if (typeof submitted.taskId !== "string" || submitted.taskId === "") {
+    return { kind: "transport_error", message: "platform accepted the task but returned no taskId (unexpected response)" };
+  }
+  const taskId = submitted.taskId;
+  let pollMs = clampPollMs(submitted.pollIntervalMs, defaultPollMs);
+  const taskUrl = `${base}/t1/${face}/tasks/${taskId}`;
+  for (; ; ) {
+    if (signal.aborted) return { kind: "aborted", taskId };
+    const now = Date.now();
+    if (now >= deadlineMs) return { kind: "deadline", taskId };
+    await sleep(Math.min(pollMs, deadlineMs - now), signal);
+    if (signal.aborted) return { kind: "aborted", taskId };
+    let poll;
+    try {
+      poll = await fetchImpl(taskUrl, { method: "GET", headers: { accept: "application/json", ...headers }, signal });
+    } catch {
+      if (signal.aborted) return { kind: "aborted", taskId };
+      continue;
+    }
+    let body = null;
+    try {
+      body = await poll.json();
+    } catch {
+      body = null;
+    }
+    if (poll.status === 401 || poll.status === 403 || poll.status === 404) {
+      const { code, message } = envelopeCode(body, poll.status);
+      return { kind: "failed", taskId, errorCode: code, message };
+    }
+    if (!poll.ok) continue;
+    const state = body ?? {};
+    if (state.status === "succeeded") {
+      return {
+        kind: "succeeded",
+        taskId,
+        result: state.result,
+        ...typeof state.cost === "string" ? { cost: state.cost } : {},
+        ...typeof state.currency === "string" ? { currency: state.currency } : {}
+      };
+    }
+    if (state.status === "failed") {
+      return {
+        kind: "failed",
+        taskId,
+        errorCode: typeof state.error?.code === "string" ? state.error.code : "upstream_error",
+        message: typeof state.error?.message === "string" ? state.error.message : "media generation failed"
+      };
+    }
+    pollMs = clampPollMs(state.pollIntervalMs, pollMs);
+  }
+}
+
+// src/platform/imagegen-tool.ts
 var IMAGEGEN_TOOL_MAX_N = 4;
+var IMAGEGEN_TOOL_TIMEOUT_MS = 18e4;
 var ImageGenArgsSchema = z42.object({
   // S-G1(媒体池化顺位取用):Optional——缺席即不发 model 位,网关按授权集顺位
   // 第一生效(与 bundle platformModels.imageGen 首行恒同);点名限集内(工具描述自列)。
@@ -30868,10 +30977,43 @@ var ImageGenArgsSchema = z42.object({
     "Input images for image editing or reference-conditioned generation (public http(s) URLs or data:image/*;base64 URIs). Only pass this for models whose bracketed note in this description lists imageUrls support; other models reject it."
   )
 });
-function errorResult13(text, model, errorCode2) {
-  const data = { model, images: [], imageCount: 0, ...errorCode2 !== void 0 ? { errorCode: errorCode2 } : {} };
+function errorResult13(text, model, errorCode2, taskId) {
+  const data = {
+    model,
+    images: [],
+    imageCount: 0,
+    ...errorCode2 !== void 0 ? { errorCode: errorCode2 } : {},
+    ...taskId !== void 0 ? { taskId } : {}
+  };
   return { content: [{ t: "text", text }], isError: true, data };
 }
+function gatewayError(raw, status) {
+  const envelope = raw ?? {};
+  const code = typeof envelope.error?.code === "string" ? envelope.error.code : `http_${status}`;
+  const message = typeof envelope.error?.message === "string" ? envelope.error.message : "request rejected";
+  return { code, message };
+}
+function successResult(raw, modelRef, taskId) {
+  const body = raw ?? {};
+  const images = Array.isArray(body.images) ? body.images.map((item) => typeof item.url === "string" ? { url: item.url } : null).filter((item) => item !== null) : [];
+  const imageCount = typeof body.imageCount === "number" ? body.imageCount : images.length;
+  if (images.length === 0) {
+    return errorResult13("Image generation returned no image URL (unexpected platform response).", modelRef, void 0, taskId);
+  }
+  const resolvedModel = typeof body.model === "string" && body.model !== "" ? body.model : modelRef;
+  const data = {
+    model: resolvedModel,
+    images,
+    imageCount,
+    ...taskId !== void 0 ? { taskId } : {}
+  };
+  const lines = [
+    `Generated ${imageCount} image(s) with model ${resolvedModel} (billed per image).`,
+    "Image URLs (valid ~24h; surface or persist promptly):",
+    ...images.map((img, i) => `${i + 1}. ${img.url}`)
+  ];
+  return { content: [{ t: "text", text: lines.join("\n") }], data };
+}
 function hintOf(code) {
   if (code === "forbidden") {
     return " The app platform capability imageGen is disabled; the app developer can enable it in console → app → capabilities.";
@@ -30923,13 +31065,18 @@ function createImageGenTool(options) {
   const base = options.baseUrl.replace(/\/+$/, "");
   const fetchImpl = options.fetchImpl ?? fetch;
   const token = options.token;
+  const budgetMs = options.timeoutMs ?? IMAGEGEN_TOOL_TIMEOUT_MS;
+  let taskRouteMissing = false;
   return {
     name: "ImageGen",
-    description: "Generates images from a text prompt via the tansr platform (ring-3 hosted capability; the platform calls the image provider and bills the app per generated image). Returns image URLs that stay valid for roughly 24 hours — surface them to the user promptly. Requires the app to have the imageGen platform capability enabled." + authorizedModelsNote(options.models),
+    description: "Generates images from a text prompt via the tansr platform (ring-3 hosted capability; the platform calls the image provider and bills the app per generated image). Some models run as polled tasks and can take a minute or two — client-side wait cap is ~3 minutes. If the cap is ever reached, the error carries a taskId: generation continues server-side (billed on success) and the result stays retrievable for ~7 days — do not resubmit blindly. Returns image URLs that stay valid for roughly 24 hours — surface them to the user promptly. Requires the app to have the imageGen platform capability enabled." + authorizedModelsNote(options.models),
     shortDescription: "Generate images from a prompt via the tansr platform (billed per image). Args: model?, prompt, negativePrompt?, size?, n?, seed?, imageUrls?.",
     inputSchema: ImageGenArgsSchema,
     isReadOnly: false,
     isConcurrencySafe: false,
+    // 2026-09-01 定谳修(videogen 同批):服务端预算 120s 与 kernel 120s 缺省档
+    // 零余量,classic/mj_task 任务轮询径跑满预算时客户端恒先掐——声明 180s 盖过。
+    timeoutMs: budgetMs,
     async execute(args, ctx) {
       const modelRef = args.model ?? "(default)";
       if (ctx.signal.aborted) {
@@ -30944,6 +31091,53 @@ function createImageGenTool(options) {
         ...args.seed !== void 0 ? { seed: args.seed } : {},
         ...args.imageUrls !== void 0 ? { imageUrls: args.imageUrls } : {}
       };
+      if (!taskRouteMissing) {
+        const outcome = await runMediaTask({
+          base,
+          face: "imagegen",
+          payload,
+          headers: { [HEADER_APP_TOKEN]: token },
+          fetchImpl,
+          signal: ctx.signal,
+          budgetMs,
+          defaultPollMs: 2e3
+        });
+        if (outcome.kind === "succeeded") {
+          return successResult(outcome.result, modelRef, outcome.taskId);
+        }
+        if (outcome.kind === "failed") {
+          return errorResult13(
+            `Image generation failed (${outcome.errorCode}): ${outcome.message}.${hintOf(outcome.errorCode)} (taskId: ${outcome.taskId})`,
+            modelRef,
+            outcome.errorCode,
+            outcome.taskId
+          );
+        }
+        if (outcome.kind === "submit_error") {
+          const { code, message } = gatewayError(outcome.raw, outcome.status);
+          return errorResult13(`Image generation failed (${code}): ${message}.${hintOf(code)}`, modelRef, code);
+        }
+        if (outcome.kind === "transport_error") {
+          return errorResult13(`Image generation request failed to reach the platform: ${outcome.message}`, modelRef);
+        }
+        if (outcome.kind === "deadline") {
+          return errorResult13(
+            `Image generation is still running server-side (taskId: ${outcome.taskId}) — the client-side wait cap was reached. The task keeps running and is billed only on success; do not resubmit blindly. Retrieve the result later via GET ${base}/t1/imagegen/tasks/${outcome.taskId} (task retrievable ~7 days; image URLs expire ~24h after completion).`,
+            modelRef,
+            "task_pending",
+            outcome.taskId
+          );
+        }
+        if (outcome.kind === "aborted") {
+          return errorResult13(
+            outcome.taskId === null ? "Tool execution was aborted." : `Tool execution was aborted. Image generation may still complete server-side (billed on success) — retrieve via GET ${base}/t1/imagegen/tasks/${outcome.taskId} (retrievable ~7 days). (taskId: ${outcome.taskId})`,
+            modelRef,
+            void 0,
+            outcome.taskId ?? void 0
+          );
+        }
+        taskRouteMissing = true;
+      }
       let response;
       try {
         response = await fetchImpl(`${base}/t1/imagegen`, {
@@ -30968,25 +31162,10 @@ function createImageGenTool(options) {
         raw = null;
       }
       if (!response.ok) {
-        const envelope = raw ?? {};
-        const code = typeof envelope.error?.code === "string" ? envelope.error.code : `http_${response.status}`;
-        const message = typeof envelope.error?.message === "string" ? envelope.error.message : "request rejected";
+        const { code, message } = gatewayError(raw, response.status);
         return errorResult13(`Image generation failed (${code}): ${message}.${hintOf(code)}`, modelRef, code);
       }
-      const body = raw ?? {};
-      const images = Array.isArray(body.images) ? body.images.map((item) => typeof item.url === "string" ? { url: item.url } : null).filter((item) => item !== null) : [];
-      const imageCount = typeof body.imageCount === "number" ? body.imageCount : images.length;
-      if (images.length === 0) {
-        return errorResult13("Image generation returned no image URL (unexpected platform response).", modelRef);
-      }
-      const resolvedModel = typeof body.model === "string" && body.model !== "" ? body.model : modelRef;
-      const data = { model: resolvedModel, images, imageCount };
-      const lines = [
-        `Generated ${imageCount} image(s) with model ${resolvedModel} (billed per image).`,
-        "Image URLs (valid ~24h; surface or persist promptly):",
-        ...images.map((img, i) => `${i + 1}. ${img.url}`)
-      ];
-      return { content: [{ t: "text", text: lines.join("\n") }], data };
+      return successResult(raw, modelRef);
     }
   };
 }
@@ -30994,6 +31173,7 @@ function createImageGenTool(options) {
 // src/platform/videogen-tool.ts
 import { z as z43 } from "zod";
 var VIDEOGEN_TOOL_MAX_DURATION = 30;
+var VIDEOGEN_TOOL_TIMEOUT_MS = 66e4;
 var VideoGenArgsSchema = z43.object({
   // S-G1(媒体池化顺位取用):Optional——缺席即不发 model 位,网关按授权集顺位
   // 第一生效(与 bundle platformModels.videoGen 首行恒同);点名限集内(工具描述自列)。
@@ -31014,16 +31194,46 @@ var VideoGenArgsSchema = z43.object({
     'First-frame image(s) for image-to-video generation (public http(s) URL or data:image/*;base64 URI). REQUIRED for models marked "image-to-video ONLY" in this description (generate or obtain an image first, e.g. via the ImageGen tool); rejected by text-to-video-only models.'
   )
 });
-function errorResult14(text, model, errorCode2) {
+function errorResult14(text, model, errorCode2, taskId) {
   const data = {
     model,
     videos: [],
     videoCount: 0,
     billedSeconds: 0,
-    ...errorCode2 !== void 0 ? { errorCode: errorCode2 } : {}
+    ...errorCode2 !== void 0 ? { errorCode: errorCode2 } : {},
+    ...taskId !== void 0 ? { taskId } : {}
   };
   return { content: [{ t: "text", text }], isError: true, data };
 }
+function gatewayError2(raw, status) {
+  const envelope = raw ?? {};
+  const code = typeof envelope.error?.code === "string" ? envelope.error.code : `http_${status}`;
+  const message = typeof envelope.error?.message === "string" ? envelope.error.message : "request rejected";
+  return { code, message };
+}
+function successResult2(raw, modelRef, taskId) {
+  const body = raw ?? {};
+  const videos = Array.isArray(body.videos) ? body.videos.map((item) => typeof item.url === "string" ? { url: item.url } : null).filter((item) => item !== null) : [];
+  if (videos.length === 0) {
+    return errorResult14("Video generation returned no video URL (unexpected platform response).", modelRef, void 0, taskId);
+  }
+  const videoCount = typeof body.videoCount === "number" ? body.videoCount : videos.length;
+  const billedSeconds = typeof body.billedSeconds === "number" ? body.billedSeconds : 0;
+  const resolvedModel = typeof body.model === "string" && body.model !== "" ? body.model : modelRef;
+  const data = {
+    model: resolvedModel,
+    videos,
+    videoCount,
+    billedSeconds,
+    ...taskId !== void 0 ? { taskId } : {}
+  };
+  const lines = [
+    `Generated ${videoCount} video(s) with model ${resolvedModel} (${billedSeconds}s billed, per-second pricing).`,
+    "Video URLs (valid ~24h; surface or persist promptly):",
+    ...videos.map((v, i) => `${i + 1}. ${v.url}`)
+  ];
+  return { content: [{ t: "text", text: lines.join("\n") }], data };
+}
 function hintOf2(code) {
   if (code === "forbidden") {
     return " The app platform capability videoGen is disabled; the app developer can enable it in console → app → capabilities.";
@@ -31082,13 +31292,19 @@ function createVideoGenTool(options) {
   const base = options.baseUrl.replace(/\/+$/, "");
   const fetchImpl = options.fetchImpl ?? fetch;
   const token = options.token;
+  const budgetMs = options.timeoutMs ?? VIDEOGEN_TOOL_TIMEOUT_MS;
+  let taskRouteMissing = false;
   return {
     name: "VideoGen",
-    description: "Generates a short video from a text prompt via the tansr platform (ring-3 hosted capability; the platform calls the video provider and bills the app per second of generated video). Generation is a long-running task (often minutes). Returns a video URL that stays valid for roughly 24 hours — surface it to the user promptly. Requires the app to have the videoGen platform capability enabled." + authorizedModelsNote2(options.models),
+    description: "Generates a short video from a text prompt via the tansr platform (ring-3 hosted capability; the platform calls the video provider and bills the app per second of generated video). Generation is a long-running task (often minutes). This call waits for the result — client-side wait cap is ~11 minutes; do not abort or retry early. If the cap is ever reached, the error carries a taskId: generation continues server-side (billed on success) and the result stays retrievable for ~7 days — do not resubmit blindly. Returns a video URL that stays valid for roughly 24 hours — surface it to the user promptly. Requires the app to have the videoGen platform capability enabled." + authorizedModelsNote2(options.models),
     shortDescription: "Generate a video from a prompt via the tansr platform (billed per second). Args: model?, prompt, negativePrompt?, duration?, ratio?, seed?, imageUrls?.",
     inputSchema: VideoGenArgsSchema,
     isReadOnly: false,
     isConcurrencySafe: false,
+    // 2026-09-01 定谳修:/t1/videogen 系服务端同步长等(600s 轮询预算),kernel
+    // 120s 缺省档下分钟级任务结构性必超时且有扣无产——工具级声明盖过缺省档
+    // (kernel 全局档恒不动;dispatching-tool-executor timeoutMs>0 即生效)。
+    timeoutMs: budgetMs,
     async execute(args, ctx) {
       const modelRef = args.model ?? "(default)";
       if (ctx.signal.aborted) {
@@ -31103,6 +31319,53 @@ function createVideoGenTool(options) {
         ...args.seed !== void 0 ? { seed: args.seed } : {},
         ...args.imageUrls !== void 0 ? { imageUrls: args.imageUrls } : {}
       };
+      if (!taskRouteMissing) {
+        const outcome = await runMediaTask({
+          base,
+          face: "videogen",
+          payload,
+          headers: { [HEADER_APP_TOKEN]: token },
+          fetchImpl,
+          signal: ctx.signal,
+          budgetMs,
+          defaultPollMs: 5e3
+        });
+        if (outcome.kind === "succeeded") {
+          return successResult2(outcome.result, modelRef, outcome.taskId);
+        }
+        if (outcome.kind === "failed") {
+          return errorResult14(
+            `Video generation failed (${outcome.errorCode}): ${outcome.message}.${hintOf2(outcome.errorCode)} (taskId: ${outcome.taskId})`,
+            modelRef,
+            outcome.errorCode,
+            outcome.taskId
+          );
+        }
+        if (outcome.kind === "submit_error") {
+          const { code, message } = gatewayError2(outcome.raw, outcome.status);
+          return errorResult14(`Video generation failed (${code}): ${message}.${hintOf2(code)}`, modelRef, code);
+        }
+        if (outcome.kind === "transport_error") {
+          return errorResult14(`Video generation request failed to reach the platform: ${outcome.message}`, modelRef);
+        }
+        if (outcome.kind === "deadline") {
+          return errorResult14(
+            `Video generation is still running server-side (taskId: ${outcome.taskId}) — the client-side wait cap was reached. The task keeps running and is billed only on success; do not resubmit blindly. Retrieve the result later via GET ${base}/t1/videogen/tasks/${outcome.taskId} (task retrievable ~7 days; video URLs expire ~24h after completion).`,
+            modelRef,
+            "task_pending",
+            outcome.taskId
+          );
+        }
+        if (outcome.kind === "aborted") {
+          return errorResult14(
+            outcome.taskId === null ? "Tool execution was aborted." : `Tool execution was aborted. Video generation may still complete server-side (billed on success) — retrieve via GET ${base}/t1/videogen/tasks/${outcome.taskId} (retrievable ~7 days). (taskId: ${outcome.taskId})`,
+            modelRef,
+            void 0,
+            outcome.taskId ?? void 0
+          );
+        }
+        taskRouteMissing = true;
+      }
       let response;
       try {
         response = await fetchImpl(`${base}/t1/videogen`, {
@@ -31127,26 +31390,10 @@ function createVideoGenTool(options) {
         raw = null;
       }
       if (!response.ok) {
-        const envelope = raw ?? {};
-        const code = typeof envelope.error?.code === "string" ? envelope.error.code : `http_${response.status}`;
-        const message = typeof envelope.error?.message === "string" ? envelope.error.message : "request rejected";
+        const { code, message } = gatewayError2(raw, response.status);
         return errorResult14(`Video generation failed (${code}): ${message}.${hintOf2(code)}`, modelRef, code);
       }
-      const body = raw ?? {};
-      const videos = Array.isArray(body.videos) ? body.videos.map((item) => typeof item.url === "string" ? { url: item.url } : null).filter((item) => item !== null) : [];
-      if (videos.length === 0) {
-        return errorResult14("Video generation returned no video URL (unexpected platform response).", modelRef);
-      }
-      const videoCount = typeof body.videoCount === "number" ? body.videoCount : videos.length;
-      const billedSeconds = typeof body.billedSeconds === "number" ? body.billedSeconds : 0;
-      const resolvedModel = typeof body.model === "string" && body.model !== "" ? body.model : modelRef;
-      const data = { model: resolvedModel, videos, videoCount, billedSeconds };
-      const lines = [
-        `Generated ${videoCount} video(s) with model ${resolvedModel} (${billedSeconds}s billed, per-second pricing).`,
-        "Video URLs (valid ~24h; surface or persist promptly):",
-        ...videos.map((v, i) => `${i + 1}. ${v.url}`)
-      ];
-      return { content: [{ t: "text", text: lines.join("\n") }], data };
+      return successResult2(raw, modelRef);
     }
   };
 }
@@ -32050,7 +32297,7 @@ function toolCallIds(message) {
 function toolResultIds(message) {
   return message.blocks.flatMap((b) => b.t === "tool_result" ? [b.callId] : []);
 }
-function repairHistoryPairing(messages) {
+function repairHistoryPairing2(messages) {
   const open4 = /* @__PURE__ */ new Set();
   let cleanEnd = 0;
   for (let i = 0; i < messages.length; i++) {
@@ -32409,7 +32656,7 @@ async function createSession(options = {}) {
         `createSession: session "${options.resume.sessionId}" was not found in the given store; list() the store or create a fresh session instead.`
       );
     }
-    initialMessages = repairHistoryPairing(record.messages).messages;
+    initialMessages = repairHistoryPairing2(record.messages).messages;
   }
   const platformSessionId = tokenTier ? ulid() : void 0;
   let sessionRef = null;
@@ -32821,8 +33068,14 @@ function createFileSessionStore(options) {
 }
 
 // src/view/reducer.ts
+function resolveDelivery(options) {
+  return {
+    text: options?.delivery?.text ?? "stream",
+    thinking: options?.delivery?.thinking ?? "stream"
+  };
+}
 var OUTPUT_TAIL_MAX_CHARS = 4e3;
-function initialSessionViewState() {
+function initialSessionViewState(options) {
   return {
     view: {
       status: "idle",
@@ -32832,6 +33085,7 @@ function initialSessionViewState() {
       usage: { turnTokens: 0, sessionTokens: 0, requests: 0 }
     },
     internal: {
+      delivery: resolveDelivery(options),
       running: false,
       compacting: false,
       lastTurnFailed: false,
@@ -33065,6 +33319,22 @@ function reduceBody(draft, event) {
       }
       const tracking = next.internal.current;
       if (event.blockType === "text" || event.blockType === "thinking") {
+        const mode = event.blockType === "thinking" ? next.internal.delivery.thinking : next.internal.delivery.text;
+        if (mode === "off") {
+          return {
+            ...next,
+            internal: {
+              ...next.internal,
+              current: {
+                ...tracking,
+                blocks: {
+                  ...tracking.blocks,
+                  [event.index]: { blockType: event.blockType, open: true }
+                }
+              }
+            }
+          };
+        }
         const appended = appendPart(next, messageId, { type: event.blockType, text: "" });
         next = appended.draft;
         return {
@@ -33078,7 +33348,8 @@ function reduceBody(draft, event) {
                 [event.index]: {
                   blockType: event.blockType,
                   partIndex: appended.partIndex,
-                  open: true
+                  open: true,
+                  ...mode === "final" ? { buffer: "" } : {}
                 }
               }
             }
@@ -33104,7 +33375,23 @@ function reduceBody(draft, event) {
       const current = draft.internal.current;
       if (current === null) return null;
       const tracking = current.blocks[event.index];
-      if (tracking === void 0 || tracking.partIndex === void 0) return null;
+      if (tracking === void 0) return null;
+      if (tracking.buffer !== void 0) {
+        return {
+          ...draft,
+          internal: {
+            ...draft.internal,
+            current: {
+              ...current,
+              blocks: {
+                ...current.blocks,
+                [event.index]: { ...tracking, buffer: tracking.buffer + event.text }
+              }
+            }
+          }
+        };
+      }
+      if (tracking.partIndex === void 0) return null;
       const view = withPartAt(
         draft.view,
         current.messageId,
@@ -33119,9 +33406,22 @@ function reduceBody(draft, event) {
       const tracking = current.blocks[event.index];
       if (tracking === void 0) return null;
       let next = draft;
+      if (tracking.buffer !== void 0 && tracking.buffer !== "" && tracking.partIndex !== void 0) {
+        const text = tracking.buffer;
+        next = {
+          ...next,
+          view: withPartAt(
+            next.view,
+            current.messageId,
+            tracking.partIndex,
+            (part) => part.type === "text" || part.type === "thinking" ? { ...part, text } : part
+          )
+        };
+      }
+      const { buffer: _buffered, ...trackingRest } = tracking;
       let blocks = {
         ...current.blocks,
-        [event.index]: { ...tracking, open: false }
+        [event.index]: { ...trackingRest, open: false }
       };
       if (tracking.partIndex !== void 0) {
         const mi = messageIndexById(next.view.messages, current.messageId);
@@ -33406,6 +33706,62 @@ function appendUserMessage(state, text) {
     internal: { ...state.internal, nextMessageSeq: state.internal.nextMessageSeq + 1 }
   };
 }
+function setSessionViewDelivery(state, delivery) {
+  const prev = state.internal.delivery;
+  const next = {
+    text: delivery.text ?? prev.text,
+    thinking: delivery.thinking ?? prev.thinking
+  };
+  if (next.text === prev.text && next.thinking === prev.thinking) return state;
+  return { view: state.view, internal: { ...state.internal, delivery: next } };
+}
+function stripThinkingParts(state) {
+  const current = state.internal.current;
+  let changed = false;
+  let nextBlocks = current?.blocks ?? null;
+  const messages = [];
+  for (const message of state.view.messages) {
+    const removed = [];
+    const parts = message.parts.filter((part, index) => {
+      if (part.type === "thinking") {
+        removed.push(index);
+        return false;
+      }
+      return true;
+    });
+    if (removed.length === 0) {
+      messages.push(message);
+      continue;
+    }
+    changed = true;
+    const isCurrent = current !== null && message.id === current.messageId;
+    if (isCurrent && nextBlocks !== null) {
+      const remapped = {};
+      for (const [key2, tracking] of Object.entries(nextBlocks)) {
+        if (tracking.partIndex === void 0) {
+          remapped[Number(key2)] = tracking;
+          continue;
+        }
+        if (removed.includes(tracking.partIndex)) {
+          const { partIndex: _gone, buffer: _buf, ...rest } = tracking;
+          remapped[Number(key2)] = rest;
+          continue;
+        }
+        const shift = removed.filter((r) => r < tracking.partIndex).length;
+        remapped[Number(key2)] = shift > 0 ? { ...tracking, partIndex: tracking.partIndex - shift } : tracking;
+      }
+      nextBlocks = remapped;
+    }
+    if (parts.length > 0 || isCurrent) {
+      messages.push({ ...message, parts });
+    }
+  }
+  if (!changed) return state;
+  return {
+    view: { ...state.view, messages },
+    internal: current !== null && nextBlocks !== null && nextBlocks !== current.blocks ? { ...state.internal, current: { ...current, blocks: nextBlocks } } : state.internal
+  };
+}
 function markSourceFailure(state, error) {
   const message = error instanceof Error ? error.message : String(error);
   return finalize({
@@ -33418,7 +33774,8 @@ function markSourceFailure(state, error) {
 }
 
 // src/view/history.ts
-function viewStateFromHistory(messages) {
+function viewStateFromHistory(messages, options) {
+  const thinkingMode = options?.delivery?.thinking ?? "stream";
   const results = /* @__PURE__ */ new Map();
   for (const message of messages) {
     for (const block of message.blocks) {
@@ -33435,7 +33792,9 @@ function viewStateFromHistory(messages) {
           if (block.text !== "") parts.push({ type: "text", text: block.text });
           break;
         case "thinking":
-          if (block.text !== "") parts.push({ type: "thinking", text: block.text });
+          if (block.text !== "" && thinkingMode !== "off") {
+            parts.push({ type: "thinking", text: block.text });
+          }
           break;
         case "tool_call": {
           const result = results.get(block.id);
@@ -33462,7 +33821,7 @@ function viewStateFromHistory(messages) {
     uiMessages.push({ id: `msg-${nextSeq}`, role: message.role, parts });
     nextSeq += 1;
   }
-  const initial = initialSessionViewState();
+  const initial = initialSessionViewState(options);
   return {
     view: { ...initial.view, messages: uiMessages },
     internal: { ...initial.internal, nextMessageSeq: nextSeq }
@@ -33502,13 +33861,15 @@ function startEventPump(source, handlers) {
 }
 
 // src/view/session-view.ts
-function createSessionView(source) {
-  let current = initialSessionViewState();
+function createSessionView(source, options) {
+  let current = initialSessionViewState(options);
   const listeners = /* @__PURE__ */ new Set();
   let disposed = false;
   const commit = (next) => {
     if (next === current) return;
+    const viewChanged = next.view !== current.view;
     current = next;
+    if (!viewChanged) return;
     for (const listener of [...listeners]) {
       try {
         listener(next.view);
@@ -33538,6 +33899,12 @@ function createSessionView(source) {
       if (disposed) return;
       commit(appendUserMessage(current, text));
     },
+    setDelivery(delivery) {
+      if (disposed) return;
+      let next = setSessionViewDelivery(current, delivery);
+      if (delivery.thinking === "off") next = stripThinkingParts(next);
+      commit(next);
+    },
     dispose() {
       if (disposed) return;
       disposed = true;
@@ -33699,6 +34066,7 @@ export {
   EndUserIdSchema,
   HEADER_APP_TOKEN,
   IMAGEGEN_TOOL_MAX_N,
+  IMAGEGEN_TOOL_TIMEOUT_MS,
   ImageGenArgsSchema,
   McpHost,
   OUTPUT_TAIL_MAX_CHARS,
@@ -33710,6 +34078,7 @@ export {
   TansrSdkError,
   UnavailableChannel,
   VIDEOGEN_TOOL_MAX_DURATION,
+  VIDEOGEN_TOOL_TIMEOUT_MS,
   VideoGenArgsSchema,
   accumulateUsage,
   appBundleRegistryConfig,
@@ -33745,6 +34114,8 @@ export {
   resolveInitialMessages,
   resolvePlatformSelection,
   runAgent,
+  setSessionViewDelivery,
+  stripThinkingParts,
   subagentModelResolverOf,
   toToolDef,
   viewStateFromHistory

package/package.json

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