@tansr/serve 0.3.2 → 0.4.0

package/dist/index.d.ts

@@ -9825,6 +9825,62 @@ interface ServeSessionFactory extends SessionFactory {
     create(init: SessionInit, extras?: ServeSessionExtras): ServeSessionDriver;
 }
 
+interface CreateAppTokenMinterOptions {
+    /** 平台 API 基址(尾斜杠归一) */
+    apiBaseUrl: string;
+    /** 平台「应用」公开标识(= api_keys.public_id;AK 头) */
+    appId: string;
+    /** 平台「应用」主密钥(SK 头 + 签名钥派生;恒不出本闭包) */
+    appKey: string;
+    /** 换发令牌 TTL(秒;缺省 3600,契约边界 60–86400 钳制) */
+    ttlSeconds?: number;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+}
+interface AppTokenMinter {
+    /** 取 endUserId 的现值令牌(缓存命中直返;临期/缺席铸新,在飞去重) */
+    tokenFor(endUserId: string): Promise<string>;
+}
+/**
+ * per-endUser app_user 令牌铸造器:appkey 双头 + TWP 签名三头(providers
+ * 签名件原样复用)POST /v1/app-tokens;失败结构化上抛(状态码 + 平台错误
+ * 码,恒不携凭据与令牌本体)。
+ */
+declare function createAppTokenMinter(options: CreateAppTokenMinterOptions): AppTokenMinter;
+interface CreatePlatformSessionAssemblerOptions {
+    minter: AppTokenMinter;
+    /** 平台 API 基址(bundle 拉取与 twp 消费同基址) */
+    apiBaseUrl: string;
+    fetchImpl?: typeof fetch;
+    /**
+     * S-ARCH P2 — 平台提示帧承接(t.warn:thinking_unavailable_on_face/
+     * balance_low 等;SDK onPlatformWarning 同源语义)。缺席缺省 console.warn
+     * 每 (endUser, code) 一次(告知恒不静默蒸发);在场即全量接管。
+     * 注:向端上(/v2 SSE)转发需新控制帧,系 doc/98 冻结面增笔——候拍,
+     * 本缝先保证服务端可观测与宿主可编程。
+     */
+    onPlatformWarning?: (warning: {
+        endUserId: string;
+        sessionId: string;
+        code: string;
+        message: string;
+    }) => void;
+}
+interface PlatformSessionAssemblerInput {
+    endUserId: string;
+    sessionId: string;
+    /** 会话请求的模型别名(bundle aliases/目录 handle;缺省 'main') */
+    model?: string;
+}
+/**
+ * per-endUser 平台令牌档装配缝实现(agent-session-factory
+ * assembleEndUserModel 消费):铸/取该 endUser 现值令牌 → SDK
+ * assemblePlatformModel(bundle → registry;per-会话平台 ULID 经既有
+ * twp sessionId 缝出线)→ 返回逐会话装配器(别名解析走 bundle registry;
+ * Task 三档降档同表)。刷新 fetch 覆写令牌头,跨时效长会话自续。
+ */
+declare function createPlatformSessionAssembler(options: CreatePlatformSessionAssemblerOptions): (input: PlatformSessionAssemblerInput) => Promise<SessionModelAssembler>;
+
 /**
  * A 案 — 平台内置形 serve 内层工厂(用户拍板 2026-09-01:真平台装配内置
  * 进 serve,做实五形态边界)。
@@ -9906,6 +9962,12 @@ interface PlatformAgentSessionOptions {
     maxTurnsPerQuery?: number;
     /** runQuery 注入缝(测试脚本化;透传平台内层工厂) */
     runQueryImpl?: Parameters<typeof createPlatformServeSessionFactory>[0]['runQueryImpl'];
+    /**
+     * S-ARCH P2 — 平台提示帧承接(t.warn;透传装配缝,语义同 SDK
+     * onPlatformWarning):缺席缺省 console.warn 每 (endUser, code) 一次。
+     * 向 /v2 端上转发需新控制帧(doc/98 冻结面增笔),候拍不代拍。
+     */
+    onPlatformWarning?: Parameters<typeof createPlatformSessionAssembler>[0]['onPlatformWarning'];
 }
 interface CreateAgentSessionFactoryOptions {
     /**
@@ -10000,49 +10062,6 @@ interface RemoteToolBuild {
  */
 declare function buildRemoteTool(decl: ClientToolDecl, bridge: AgentSessionBridge, now?: () => number): RemoteToolBuild;
 
-interface CreateAppTokenMinterOptions {
-    /** 平台 API 基址(尾斜杠归一) */
-    apiBaseUrl: string;
-    /** 平台「应用」公开标识(= api_keys.public_id;AK 头) */
-    appId: string;
-    /** 平台「应用」主密钥(SK 头 + 签名钥派生;恒不出本闭包) */
-    appKey: string;
-    /** 换发令牌 TTL(秒;缺省 3600,契约边界 60–86400 钳制) */
-    ttlSeconds?: number;
-    fetchImpl?: typeof fetch;
-    now?: () => number;
-}
-interface AppTokenMinter {
-    /** 取 endUserId 的现值令牌(缓存命中直返;临期/缺席铸新,在飞去重) */
-    tokenFor(endUserId: string): Promise<string>;
-}
-/**
- * per-endUser app_user 令牌铸造器:appkey 双头 + TWP 签名三头(providers
- * 签名件原样复用)POST /v1/app-tokens;失败结构化上抛(状态码 + 平台错误
- * 码,恒不携凭据与令牌本体)。
- */
-declare function createAppTokenMinter(options: CreateAppTokenMinterOptions): AppTokenMinter;
-interface CreatePlatformSessionAssemblerOptions {
-    minter: AppTokenMinter;
-    /** 平台 API 基址(bundle 拉取与 twp 消费同基址) */
-    apiBaseUrl: string;
-    fetchImpl?: typeof fetch;
-}
-interface PlatformSessionAssemblerInput {
-    endUserId: string;
-    sessionId: string;
-    /** 会话请求的模型别名(bundle aliases/目录 handle;缺省 'main') */
-    model?: string;
-}
-/**
- * per-endUser 平台令牌档装配缝实现(agent-session-factory
- * assembleEndUserModel 消费):铸/取该 endUser 现值令牌 → SDK
- * assemblePlatformModel(bundle → registry;per-会话平台 ULID 经既有
- * twp sessionId 缝出线)→ 返回逐会话装配器(别名解析走 bundle registry;
- * Task 三档降档同表)。刷新 fetch 覆写令牌头,跨时效长会话自续。
- */
-declare function createPlatformSessionAssembler(options: CreatePlatformSessionAssemblerOptions): (input: PlatformSessionAssemblerInput) => Promise<SessionModelAssembler>;
-
 /**
  * /v2 装配半场 i18n 消息键(A 案下沉 2026-09-01)。
  *

package/dist/index.js

@@ -60630,7 +60630,8 @@ async function assemblePlatformModel(options) {
     // S-TH3:features 能力串同缝供给(闭包定格;undefined = 门全关同现状)
     twp: {
       ...options.sessionId !== void 0 ? { sessionId: options.sessionId } : {},
-      features: () => features
+      features: () => features,
+      ...options.onWarn !== void 0 ? { onWarn: options.onWarn } : {}
     }
   });
   const built = buildClientFromRegistry(registry, options.model ?? "main", options.onProviderSelected);
@@ -60713,6 +60714,13 @@ function createAppTokenMinter(options) {
   };
 }
 function createPlatformSessionAssembler(options) {
+  const warnedDefault = /* @__PURE__ */ new Set();
+  const deliverWarning = options.onPlatformWarning ?? ((w) => {
+    const key2 = `${w.endUserId}\0${w.code}`;
+    if (warnedDefault.has(key2)) return;
+    warnedDefault.add(key2);
+    console.warn(`[tansr-serve] platform warning ${w.code} (endUser=${w.endUserId}): ${w.message}`);
+  });
   return async (input) => {
     const initialToken = await options.minter.tokenFor(input.endUserId);
     const platformSessionId = ulid();
@@ -60729,7 +60737,15 @@ function createPlatformSessionAssembler(options) {
       baseUrl: options.apiBaseUrl,
       ...input.model !== void 0 ? { model: input.model } : {},
       fetchImpl: refreshingFetch,
-      sessionId: () => platformSessionId
+      sessionId: () => platformSessionId,
+      // S-ARCH P2:平台提示帧经 SDK onWarn 缝出线,携会话归属(serve 面
+      // per-会话装配,归属天然可判——CLI 进程级电台的「无从归属」不适用此径)
+      onWarn: (warn) => deliverWarning({
+        endUserId: input.endUserId,
+        sessionId: input.sessionId,
+        code: warn.code,
+        message: warn.message
+      })
     });
     return (alias, onProviderSelected) => {
       const built = buildClientFromRegistry(platform.registry, alias, onProviderSelected);
@@ -61268,7 +61284,8 @@ function createAgentSessionFactory(options) {
     assembleEndUserModel = createPlatformSessionAssembler({
       minter,
       apiBaseUrl: platform.apiBaseUrl,
-      ...platform.fetchImpl !== void 0 ? { fetchImpl: platform.fetchImpl } : {}
+      ...platform.fetchImpl !== void 0 ? { fetchImpl: platform.fetchImpl } : {},
+      ...platform.onPlatformWarning !== void 0 ? { onPlatformWarning: platform.onPlatformWarning } : {}
     });
     innerFactory = createPlatformServeSessionFactory({
       cwd: options.cwd,

package/package.json

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