@tansr/sdk 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -14390,6 +14390,66 @@ interface McpLazyManager extends McpExpandView {
     forToolset(toolset: McpToolset): McpExpandView;
 }
 
+/**
+ * T-C8 — 内核侧价格表:内置条目 + refreshPricing() 注入缝。
+ *
+ * 分层铁律(AGENTS.md):kernel(L2)不得 import providers(L1)实现。本表在
+ * kernel 侧独立内置,形态与 providers/src/registry/capability-defaults.ts 的
+ * pricing 对齐(同源自 doc/10 §4.1,同为 protocol PricingSchema 形态),但零
+ * import 关系;providers 侧价目变更须同步本表(两处注释互指)。
+ *
+ * 索引粒度 = (provider, model) 二元组(W0 Spike③ 实证:MaaS 聚合工作空间同一
+ * endpoint 路由多厂商,见 spikes/endpoint/REPORT.md §四.5),大小写不敏感。
+ *
+ * 数据溯源(逐条注释;查不到的价目一律登记为「已收录无价」条目,不编造——
+ * 缺价降级路径会记 usage 不记金额并产结构化诊断):doc/10 §4.1 旗舰编码模型
+ * 价位参考(¥/百万 token,输入未命中/命中/输出)。
+ *
+ * 来源优先级:user(用户配置)> refreshed(运行期在线刷新)> builtin(内置)。
+ * 在线刷新不覆盖用户显式配置;同层重复 refresh 为 last-write-wins。
+ */
+
+/**
+ * 内核成本计价形态:protocol Pricing 的结构超集——增补可选缓存写入价
+ * (显式缓存创建溢价:Anthropic 型 1.25×/1h 2×,doc/02 §8.1、doc/80 §一;
+ * 百炼显式面创建 125%——qwen3.7-max 官方价目页有 15 CNY/M 明码,doc/110 A4
+ * 补录;隐式面 kimi/deepseek/glm 官方无写价 SKU(doc/80 §2.3「写免费」),
+ * 该键恒不填)。填值纪律:只填文件内注释或 doc/80 §一价表已有官方出处的
+ * 行,恒不臆造;缺席时 tracker 写量按 inputPerMillion 回退计(见 tracker.ts)。
+ * protocol Pricing 值可直接赋值本类型;contract-v0.5(RFC-B3-3)起 Pricing 原生
+ * 携带可选 tiers 阶梯,本形态自动继承(tracker 选档消费见 selectPricingTier)。
+ */
+interface CostPricing extends Pricing {
+    /** 缓存写入价(¥或$/百万 token);缺省时缓存写入按 inputPerMillion 计 */
+    cacheWriteInputPerMillion?: number;
+}
+/**
+ * 币种词表 v1(T-B2,《18》§8-2 币种裁决):国内试点两币种,ISO 4217 代码。
+ * 扩词表走 RFC(与 tansrd budget.currency 同词表同节奏);金额聚合按币种
+ * 分桶(tracker.ts),严禁跨币种直加——归一呈现是报表层职责(记账汇率)。
+ */
+declare const PRICING_CURRENCIES: readonly ["USD", "CNY"];
+type PricingCurrency = (typeof PRICING_CURRENCIES)[number];
+/**
+ * refreshPricing 的更新单元。
+ * pricing 三态:对象 = 设置价目;undefined(缺省)= 登记「已收录无价」条目;
+ * null = 清除该来源层的条目(恢复下层生效)。
+ */
+interface PricingUpdate {
+    providerId: string;
+    modelName: string;
+    /**
+     * 缺省 'CNY'——kernel 面「缺省 = 现状语义零变化」:本表自 T-C8 起内置与
+     * 注入缺省皆为人民币价(doc/10 §4.1),与 tansrd budget.pricing 的缺省
+     * 'USD'(其现状 = USD/百万 token 语义)各自守现状,不互相迁就(T-B2)。
+     */
+    currency?: PricingCurrency;
+    pricing?: CostPricing | null;
+    /** 名义价标注(T-B1;语义见 PricingEntry.nominal);缺省 = 真实价 */
+    nominal?: boolean;
+    note?: string;
+}
+
 /**
  * T-G3 — command 执行体:子进程 exec-form + stdin/exit-code/stdout 协议。
  *
@@ -15516,6 +15576,19 @@ type AppCapabilities = z.infer<typeof AppCapabilitiesSchema>;
 /** 平台缺省档(保守值;终值⏸候拍板⑥,doc/83 §八) */
 declare const DEFAULT_APP_CAPABILITIES: AppCapabilities;
 
+/**
+ * bundle 模型计价段(api /t1/config 既有键;DECIMAL 串形与 cli
+ * remote-bundle RemoteBundleModel.pricing 同形)。doc/110 B7 起 SDK 解析:
+ * serve 平台内置形据此喂 CostTracker 价格簿(会话级 budget 闸的金额维)。
+ * 服务端 t.usage 恒为计费权威,本地估算仅闸门/展示口径。
+ */
+interface AppBundleModelPricing {
+    currency: string;
+    inPerMillion: string;
+    outPerMillion: string;
+    cacheReadPerMillion: string;
+    cacheWritePerMillion: string;
+}
 /** bundle 内单模型条目(SDK 消费子集) */
 interface AppBundleModel {
     handle: string;
@@ -15533,6 +15606,8 @@ interface AppBundleModel {
     protocol: string;
     capabilities: Record<string, unknown>;
     contextWindow: number | null;
+    /** 计价段(doc/110 B7 加法解析;缺键/坏形状 = null,恒不猜价) */
+    pricing: AppBundleModelPricing | null;
 }
 /**
  * 图像模型受理约束(bundle platformModels.imageGen 行 constraints 加法键,
@@ -15593,6 +15668,12 @@ interface VideoModelConstraints {
 interface AppBundleMediaModel {
     model: string;
     displayName: string;
+    /**
+     * 产出托管地(S-ARCH P2-c 加法键 2026-09-02;平台媒体探针按产出 URL 宿主定性):
+     * overseas = 境外托管(中国大陆网络可能无法直接访问,veo/grok 教训)/ domestic /
+     * inline(b64 内联返回,无托管地问题)。缺席 = 未探/未识别(旧 api 同形)。
+     */
+    outputHosting?: 'domestic' | 'overseas' | 'inline';
 }
 interface AppBundleImageModel extends AppBundleMediaModel {
     constraints?: ImageModelConstraints;
@@ -15628,6 +15709,15 @@ declare const TANSR_PROVIDER_ID = "tansr";
  * 真实鉴权头由 createAppTokenFetch 包装覆写,令牌恒不进 registry env)。
  */
 declare const APP_TOKEN_PLACEHOLDER_ENV = "TANSR_SDK_APP_TOKEN_TIER";
+/**
+ * doc/110 B7 — bundle 计价 → kernel 价格簿注入行(refreshed 层;cli
+ * remote-bundle mapBundleToFragment 同律):币种走白名单(USD/CNY),其余
+ * 币种如实跳过(tracker 侧不猜币种不误标);DECIMAL 串 → 数值,必要价
+ * NaN 整条丢弃;缓存读价 >0 才落 cachedInputPerMillion;缓存写价 >0 落
+ * cacheWriteInputPerMillion(CostPricing 写溢价维,doc/110 A4 同口径)。
+ * 键 = (tansr, handle),与 twp 计量事件 provider/model 同口径。
+ */
+declare function appBundlePricingUpdates(bundle: AppBundle): PricingUpdate[];
 /**
  * bundle 载荷 → SDK 消费子集。顶层形状非法返回 null(调用方结构化报错);
  * 条目级损坏逐条跳过。capabilities 段严格校验,失败回落平台缺省档
@@ -15929,6 +16019,13 @@ interface AssembledPlatformModel {
      * 集成方零手配)。旧 api 无段 = 双空集如实。
      */
     platformModels: AppBundlePlatformModels;
+    /**
+     * doc/110 B7 — bundle 计价 → kernel 价格簿注入行((tansr, handle) 键,
+     * USD/CNY 白名单;appBundlePricingUpdates 语义)。消费方(serve 平台内置
+     * 形)经 PricingBook.refreshPricing(rows, 'refreshed') 喂 CostTracker,
+     * 会话级 budget 闸的金额维自此对 tansr 模型出数。无计价段 = 空数组。
+     */
+    pricingUpdates: PricingUpdate[];
 }
 /**
  * 令牌头注入 fetch 包装:剥 AK/SK 双头与签名三头(值只是占位哑值,但
@@ -16060,6 +16157,8 @@ interface SessionRecordMeta {
      * 平台会话 id(ULID 26 位 Crockford;doc/91 拍板⑤):令牌档 createSession
      * per-AgentSession 铸造并经 twp meta.sessionId 出线,ULID↔内核 UUID 映射
      * 落在此键——平台侧会话行(归因/续租/亲和)与本地记录互认的桥。
+     * doc/110 B2(2026-09-02 翻案拍板⑤实施语义):resume 径**沿用**此键——
+     * 缓存键/粘性/归因跨 resume 延续;旧记录无键时 resume 铸新并补录。
      */
     platformSessionId?: string;
     /** 开发者自留元数据域(SDK 恒不消费其内容) */
@@ -16069,7 +16168,10 @@ interface SessionRecordMeta {
 interface SessionStoreCreateInit {
     sessionId?: string;
     title?: string;
-    /** 平台会话 ULID(令牌档装配注入;重复登记时以新值对账更新) */
+    /**
+     * 平台会话 ULID(令牌档装配注入;重复登记时以新值对账更新——doc/110 B2
+     * 起 resume 恒沿用已存值,故在场值只会是同值或旧记录无键的首次补录)
+     */
     platformSessionId?: string;
     meta?: Record<string, unknown>;
 }
@@ -16094,7 +16196,8 @@ interface SessionRecord {
  *   验收:改坏存储文件须报错不静默);
  * - list 恒不携消息内容(枚举是元数据面);
  * - create 幂等(同 sessionId 重复登记返回既有记录,platformSessionId
- *   以新值对账更新——resume 后的新 AgentSession 铸新平台 ULID 经此落位)。
+ *   以新值对账更新——doc/110 B2:resume 后的 AgentSession **沿用**记录已存
+ *   平台 ULID,本对账写只在旧记录无键(2026-09-02 前落盘)时补录新铸值)。
  */
 interface SessionStore {
     /** 建会话(登记 meta;id 由 store 铸造或调用方供给;幂等) */
@@ -16282,8 +16385,10 @@ declare class AgentSession {
     constructor(init: AgentSessionInit);
     get sessionId(): string;
     /**
-     * 会话事件流(async iterable;单消费者)。跨轮连续,close() 后以
-     * session.ended 收尾并正常终结(for-await 自然退出)。
+     * 会话事件流(async iterable;**多消费者广播**,2026-09-02 起)。每次 for-await 即一个
+     * 独立订阅者:SessionView 泵、Narrator、宿主自建循环可同时挂,各得全量事件、互不争抢;
+     * 首订阅者收到会话创建以来的积压,晚订阅者自订阅点起。跨轮连续,close() 后以
+     * session.ended 收尾并正常终结(各订阅者排空后 for-await 自然退出)。
      */
     get events(): AsyncIterable<KernelEvent>;
     /** 当前模型档快照 */
@@ -16625,8 +16730,9 @@ declare function viewStateFromHistory(messages: readonly IRMessage[], options?:
  * - AsyncIterable<KernelEvent>:直接消费;
  * - { events: AsyncIterable<KernelEvent> }(AgentSession 形):消费 .events。
  *
- * 注意:AgentSession 事件流是单消费者队列——同一会话上同时挂 SessionView
- * 与 Narrator(或宿主自身的 for-await)需要调用方自行扇出事件。
+ * 2026-09-02 起 AgentSession.events 系多消费者广播(每次 for-await 一个独立订阅者):
+ * 同一会话上同时挂 SessionView 与 Narrator(或宿主自身的 for-await)恒不再需要扇出;
+ * 本泵直接消费 session.events 即可(旧 fanout 写法仍兼容——多一层无害)。
  *
  * dispose 停泵:置标志 + best-effort 调用迭代器 return()(async generator
  * 的 finally 释放上游);已挂起的 next() 由 return 排队语义收口。
@@ -16956,5 +17062,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, 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, PlatformWarning, 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 };
+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, appBundlePricingUpdates, 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, AppBundleModelPricing, 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, PlatformWarning, 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

@@ -4926,6 +4926,16 @@ var DEFAULT_MICROCOMPACT_MARGIN = 4e4;
 var MICROCOMPACT_RECOVERY_FLOOR_MIN = 2e4;
 var MICROCOMPACT_RECOVERY_FLOOR_RATIO = 0.1;
 var MICROCOMPACT_RECOVERY_FLOOR_MAX_FRACTION = 0.5;
+var MICROCOMPACT_RECOVERY_FLOOR_RATIO_TIERS = [
+  { minContextWindow: 5e5, ratio: 0.15 },
+  { minContextWindow: 0, ratio: MICROCOMPACT_RECOVERY_FLOOR_RATIO }
+];
+function microcompactRecoveryFloorRatio(contextWindow) {
+  for (const tier of MICROCOMPACT_RECOVERY_FLOOR_RATIO_TIERS) {
+    if (contextWindow >= tier.minContextWindow) return tier.ratio;
+  }
+  return MICROCOMPACT_RECOVERY_FLOOR_RATIO;
+}
 var DEFAULT_AUTO_COMPACT_RATIO = 0.93;
 var MIN_CONTEXT_WINDOW = 1024;
 var ADAPTIVE_MAX_DEPTH_FRACTION = 0.75;
@@ -4958,9 +4968,12 @@ function linesHealthy(lines, contextWindow) {
 function clampLine(value, lo, hi) {
   return Math.min(hi, Math.max(lo, value));
 }
-function deriveMicrocompactStopAt(microcompactAt, floorKnob) {
+function deriveMicrocompactStopAt(microcompactAt, floorKnob, contextWindow) {
   const floor = floorKnob ?? Math.min(
-    Math.max(MICROCOMPACT_RECOVERY_FLOOR_MIN, Math.floor(microcompactAt * MICROCOMPACT_RECOVERY_FLOOR_RATIO)),
+    Math.max(
+      MICROCOMPACT_RECOVERY_FLOOR_MIN,
+      Math.floor(microcompactAt * microcompactRecoveryFloorRatio(contextWindow))
+    ),
     Math.floor(microcompactAt * MICROCOMPACT_RECOVERY_FLOOR_MAX_FRACTION)
   );
   return Math.max(0, microcompactAt - Math.floor(floor));
@@ -5030,7 +5043,11 @@ function resolveThresholds(config) {
       warningAt: legacy.warningAt,
       blockingAt: legacy.blockingAt,
       microcompactAt: legacy.microcompactAt,
-      microcompactStopAt: deriveMicrocompactStopAt(legacy.microcompactAt, recoveryFloorKnob),
+      microcompactStopAt: deriveMicrocompactStopAt(
+        legacy.microcompactAt,
+        recoveryFloorKnob,
+        config.contextWindow
+      ),
       compactOutputBudget
     };
   }
@@ -5063,7 +5080,7 @@ function resolveThresholds(config) {
     microcompactAt,
     // B1 停止线自最终触发线派生(自适应/钳制后的 microcompactAt;比例项使
     // 病态小窗口的下探幅度与触发线同尺度,恒不清穿)
-    microcompactStopAt: deriveMicrocompactStopAt(microcompactAt, recoveryFloorKnob),
+    microcompactStopAt: deriveMicrocompactStopAt(microcompactAt, recoveryFloorKnob, config.contextWindow),
     // 预留区被降级时压缩输出预算同步收窄(摘要必须装得进降级后的预留区;
     // 未降级时原样保留)
     compactOutputBudget: scale < 1 ? Math.min(compactOutputBudget, Math.max(1, scaledReserve)) : compactOutputBudget,
@@ -8505,8 +8522,11 @@ ${decision.referenceText}
         // 不可得(上方两径均未测量)或 <1 时省略,零漂移
         ...promptTokensEstimate !== void 0 && Math.ceil(promptTokensEstimate) >= 1 ? { promptTokensEstimate: Math.ceil(promptTokensEstimate) } : {},
         // TM-8:一次性辅助查询(记忆提取 fork 等)抑制消息尾缓存断点
-        // (RFC-OPT14-1 同族;缺省不落键,主查询请求形状零漂移)
-        ...options.skipCacheWrite === true ? { skipCacheWrite: true } : {}
+        // (RFC-OPT14-1 同族;缺省不落键,主查询请求形状零漂移)。
+        // doc/110 A3:收尾轮(closingTurnArmed)为可知末轮,调用方经
+        // closingTurn.skipCacheWrite 声明历史不复读时同跳(仅收尾请求;
+        // 非末轮恒不跳)。
+        ...options.skipCacheWrite === true || closingTurnArmed && options.closingTurn?.skipCacheWrite === true ? { skipCacheWrite: true } : {}
       };
       if (options.onModelRequest !== void 0) {
         try {
@@ -13848,6 +13868,26 @@ function lockFilePath(sessionDir) {
   return path5.join(sessionDir, "lock");
 }
 var durableTmpSeq = 0;
+var RENAME_TRANSIENT_CODES = /* @__PURE__ */ new Set(["EPERM", "EACCES", "EBUSY"]);
+var RENAME_RETRY_DELAYS_MS = [5, 10, 20, 40, 80, 160, 320];
+var defaultRenameDeps = {
+  rename,
+  sleep: (ms) => new Promise((resolve2) => setTimeout(resolve2, ms)),
+  platform: process.platform
+};
+async function renameWithRetry(from, to, deps = defaultRenameDeps) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      await deps.rename(from, to);
+      return;
+    } catch (err) {
+      const delay = RENAME_RETRY_DELAYS_MS[attempt];
+      const transient = deps.platform === "win32" && isErrnoException(err) && err.code !== void 0 && RENAME_TRANSIENT_CODES.has(err.code);
+      if (!transient || delay === void 0) throw err;
+      await deps.sleep(delay);
+    }
+  }
+}
 async function writeFileDurable(filePath, content) {
   durableTmpSeq += 1;
   const tempPath = `${filePath}.tmp-${process.pid}-${durableTmpSeq.toString(36)}-${Date.now()}`;
@@ -13863,7 +13903,7 @@ async function writeFileDurable(filePath, content) {
     await handle.close();
   }
   try {
-    await rename(tempPath, filePath);
+    await renameWithRetry(tempPath, filePath);
   } catch (err) {
     await rm(tempPath, { force: true }).catch(() => void 0);
     throw err;
@@ -19303,8 +19343,10 @@ async function runSubagent(options) {
     initialMessages: [{ role: "user", blocks: [{ t: "text", text: options.prompt }] }],
     maxTurns,
     // max_turns 优雅化:预算触顶且仍在干活时追加恰一次强制收束调用
-    // (有效轮数 = maxTurns + 1;语义见模块头注释与 RunQueryOptions.closingTurn)
-    closingTurn: { instruction: SUBAGENT_CLOSING_TURN_INSTRUCTION },
+    // (有效轮数 = maxTurns + 1;语义见模块头注释与 RunQueryOptions.closingTurn)。
+    // doc/110 A3:收尾轮是可知末轮且子代理历史随终局丢弃(只回传摘要),
+    // 尾断点写纯付费 → 收尾请求跳写;非末轮恒不跳(逐轮尾写/次轮读是正常增量)
+    closingTurn: { instruction: SUBAGENT_CLOSING_TURN_INSTRUCTION, skipCacheWrite: true },
     // TC-T1:阈值预警注入(剩 3 轮减速带 / 剩 1 轮最后工作轮;各恰一次,
     // 与收尾轮构成三级带)——恒注入,与 closingTurn 同一零配置纪律
     reminders: createTurnBudgetReminderProvider(maxTurns),
@@ -24755,6 +24797,9 @@ async function loadConfig(options = {}) {
 // ../kernel/src/cost/money.ts
 var MAX_SAFE_NANO = Number.MAX_SAFE_INTEGER;
 
+// ../kernel/src/cost/pricing-table.ts
+var PRICING_CURRENCIES = ["USD", "CNY"];
+
 // ../kernel/src/skills/frontmatter.ts
 function stripBom2(text) {
   return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
@@ -31078,6 +31123,9 @@ function imageModelNote(m) {
   if (!c.seed) notes.push("no seed");
   if (!c.negativePrompt) notes.push("no negativePrompt");
   if (c.maxImages === 1) notes.push("single image per call (n=1)");
+  if (m.outputHosting === "overseas") {
+    notes.push("output hosted OVERSEAS — image URLs may be unreachable from mainland China networks");
+  }
   return notes.length > 0 ? `${label} [${notes.join("; ")}]` : label;
 }
 function authorizedModelsNote(models) {
@@ -31305,6 +31353,9 @@ function videoModelNote(m) {
   else if (c.ratio !== void 0) notes.push(`ratio ${c.ratio.join("|")}`);
   if (!c.seed) notes.push("no seed");
   if (!c.negativePrompt) notes.push("no negativePrompt");
+  if (m.outputHosting === "overseas") {
+    notes.push("output hosted OVERSEAS — the video URL may be unreachable from mainland China networks");
+  }
   return `${label} [${notes.join("; ")}]`;
 }
 function authorizedModelsNote2(models) {
@@ -31876,6 +31927,19 @@ var APP_TOKEN_PLACEHOLDER_VALUE = "app-token-tier";
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parsePricing(raw) {
+  if (!isRecord8(raw)) return null;
+  if (typeof raw.currency !== "string" || typeof raw.inPerMillion !== "string" || typeof raw.outPerMillion !== "string") {
+    return null;
+  }
+  return {
+    currency: raw.currency,
+    inPerMillion: raw.inPerMillion,
+    outPerMillion: raw.outPerMillion,
+    cacheReadPerMillion: typeof raw.cacheReadPerMillion === "string" ? raw.cacheReadPerMillion : "0",
+    cacheWritePerMillion: typeof raw.cacheWritePerMillion === "string" ? raw.cacheWritePerMillion : "0"
+  };
+}
 function parseModel(raw) {
   if (!isRecord8(raw)) return null;
   if (typeof raw.handle !== "string" || raw.handle === "" || typeof raw.modelId !== "string" || raw.modelId === "" || typeof raw.protocol !== "string") {
@@ -31890,9 +31954,36 @@ function parseModel(raw) {
     family: typeof raw.family === "string" && raw.family !== "" ? raw.family : null,
     protocol: raw.protocol,
     capabilities: isRecord8(raw.capabilities) ? raw.capabilities : {},
-    contextWindow: typeof raw.contextWindow === "number" ? raw.contextWindow : null
+    contextWindow: typeof raw.contextWindow === "number" ? raw.contextWindow : null,
+    pricing: parsePricing(raw.pricing)
   };
 }
+function appBundlePricingUpdates(bundle) {
+  const updates = [];
+  for (const model of bundle.models) {
+    const pricing = model.pricing;
+    if (pricing === null) continue;
+    if (!PRICING_CURRENCIES.includes(pricing.currency)) continue;
+    const input = Number(pricing.inPerMillion);
+    const output = Number(pricing.outPerMillion);
+    if (!Number.isFinite(input) || !Number.isFinite(output)) continue;
+    const cached = Number(pricing.cacheReadPerMillion);
+    const cacheWrite = Number(pricing.cacheWritePerMillion);
+    updates.push({
+      providerId: TANSR_PROVIDER_ID,
+      modelName: model.handle,
+      currency: pricing.currency,
+      pricing: {
+        inputPerMillion: input,
+        outputPerMillion: output,
+        ...Number.isFinite(cached) && cached > 0 ? { cachedInputPerMillion: cached } : {},
+        ...Number.isFinite(cacheWrite) && cacheWrite > 0 ? { cacheWriteInputPerMillion: cacheWrite } : {}
+      },
+      note: "app bundle"
+    });
+  }
+  return updates;
+}
 function parseMediaImageInput(raw, flagKey) {
   if (raw === null) return null;
   if (!isRecord8(raw)) return false;
@@ -31955,10 +32046,12 @@ function parseMediaModels(raw, parseConstraints) {
   for (const item of raw) {
     if (!isRecord8(item) || typeof item.model !== "string" || item.model === "") continue;
     const constraints = item.constraints === void 0 ? void 0 : parseConstraints(item.constraints);
+    const hosting = item.outputHosting === "domestic" || item.outputHosting === "overseas" || item.outputHosting === "inline" ? item.outputHosting : void 0;
     out.push({
       model: item.model,
       displayName: typeof item.displayName === "string" && item.displayName !== "" ? item.displayName : item.model,
-      ...constraints !== void 0 ? { constraints } : {}
+      ...constraints !== void 0 ? { constraints } : {},
+      ...hosting !== void 0 ? { outputHosting: hosting } : {}
     });
   }
   return out;
@@ -32163,7 +32256,13 @@ async function assemblePlatformModel(options) {
     }
   });
   const built = buildClientFromRegistry(registry, options.model ?? "main", options.onProviderSelected);
-  return { ...built, registry, capabilities: bundle.capabilities, platformModels: bundle.platformModels };
+  return {
+    ...built,
+    registry,
+    capabilities: bundle.capabilities,
+    platformModels: bundle.platformModels,
+    pricingUpdates: appBundlePricingUpdates(bundle)
+  };
 }
 
 // src/task.ts
@@ -32408,39 +32507,64 @@ function repairHistoryPairing2(messages) {
 
 // src/session.ts
 function createEventQueue() {
-  const buffered = [];
+  const log = [];
+  let head = 0;
   let ended = false;
-  let wake = null;
-  const notify = () => {
-    if (wake !== null) {
-      const w = wake;
-      wake = null;
-      w();
+  let liveStarted = false;
+  const subscribers = /* @__PURE__ */ new Set();
+  const wakeAll = () => {
+    for (const s of subscribers) {
+      if (s.wake !== null) {
+        const w = s.wake;
+        s.wake = null;
+        w();
+      }
+    }
+  };
+  const trim = () => {
+    if (!liveStarted || subscribers.size === 0) return;
+    let min = Number.POSITIVE_INFINITY;
+    for (const s of subscribers) min = Math.min(min, s.cursor);
+    const drop = min - head;
+    if (drop > 0) {
+      log.splice(0, drop);
+      head = min;
     }
   };
   return {
     push(item) {
       if (ended) return;
-      buffered.push(item);
-      notify();
+      if (subscribers.size > 0) liveStarted = true;
+      log.push(item);
+      wakeAll();
     },
     end() {
       ended = true;
-      notify();
+      wakeAll();
     },
     get ended() {
       return ended;
     },
     iterable: {
       async *[Symbol.asyncIterator]() {
-        for (; ; ) {
-          while (buffered.length > 0) {
-            yield buffered.shift();
+        const me = { cursor: liveStarted ? head + log.length : head, wake: null };
+        subscribers.add(me);
+        try {
+          for (; ; ) {
+            while (me.cursor < head + log.length) {
+              const item = log[me.cursor - head];
+              me.cursor += 1;
+              trim();
+              yield item;
+            }
+            if (ended) return;
+            await new Promise((resolve2) => {
+              me.wake = resolve2;
+            });
           }
-          if (ended) return;
-          await new Promise((resolve2) => {
-            wake = resolve2;
-          });
+        } finally {
+          subscribers.delete(me);
+          trim();
         }
       }
     }
@@ -32489,8 +32613,10 @@ var AgentSession = class {
     return this.#sessionId;
   }
   /**
-   * 会话事件流(async iterable;单消费者)。跨轮连续,close() 后以
-   * session.ended 收尾并正常终结(for-await 自然退出)。
+   * 会话事件流(async iterable;**多消费者广播**,2026-09-02 起)。每次 for-await 即一个
+   * 独立订阅者:SessionView 泵、Narrator、宿主自建循环可同时挂,各得全量事件、互不争抢;
+   * 首订阅者收到会话创建以来的积压,晚订阅者自订阅点起。跨轮连续,close() 后以
+   * session.ended 收尾并正常终结(各订阅者排空后 for-await 自然退出)。
    */
   get events() {
     return this.#queue.iterable;
@@ -32724,6 +32850,7 @@ async function createSession(options = {}) {
   }
   validateTokenTierOptions("createSession", options);
   let initialMessages = options.initialMessages ?? [];
+  let storedPlatformSessionId;
   if (options.resume !== void 0) {
     const record = await options.resume.store.get(options.resume.sessionId);
     if (record === null) {
@@ -32733,8 +32860,9 @@ async function createSession(options = {}) {
       );
     }
     initialMessages = repairHistoryPairing2(record.messages).messages;
+    storedPlatformSessionId = record.meta.platformSessionId;
   }
-  const platformSessionId = tokenTier ? ulid() : void 0;
+  const platformSessionId = tokenTier ? storedPlatformSessionId ?? ulid() : void 0;
   let sessionRef = null;
   const emitBody = (body, source) => {
     sessionRef?.pushBody(body, source);
@@ -34159,6 +34287,7 @@ export {
   VIDEOGEN_TOOL_TIMEOUT_MS,
   VideoGenArgsSchema,
   accumulateUsage,
+  appBundlePricingUpdates,
   appBundleRegistryConfig,
   appendUserMessage,
   assembleManagedModel,

package/package.json

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