@jhh96/light-app-bridge 1.2.1 → 1.3.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { default } from './lightAppBridge';
 export { createBridge } from './lightAppBridge';
-export type { BridgeRole, BindMode, EnvelopeType, Envelope, BridgeOptions, SendOptions, MessageHandler } from './lightAppBridge';
+export type { BridgeRole, BindMode, ReportMode, EnvelopeType, Envelope, BridgeOptions, SendOptions, MessageHandler } from './lightAppBridge';

package/dist/lightAppBridge.d.ts

@@ -30,6 +30,17 @@ export type BridgeRole = 'plugin' | 'lightapp';
  *             向新窗口探测握手（成功即切换绑定；失败——如未集成 SDK——保持旧绑定）。
  */
 export type BindMode = 'fixed' | 'dynamic';
+/**
+ * 指令执行结果的上报模式（轻应用角色语义声明，默认 'plugin'）：
+ *   - plugin 默认。轻应用不在本窗口回传 ai-controller，执行结果随 reply 返回
+ *             插件窗口，由插件统一上报。reply 无需额外字段。
+ *   - self   轻应用业务自行 POST ai-controller/callback（如需 AI 闭环），
+ *             并在 onMessage 的 reply 上带 result_reported: true，
+ *             插件据此跳过补报，避免双重上报。
+ * 纯语义声明：SDK 不执行上报，读取方是插件侧业务代码（经 reply 字段判定），
+ * 两 SDK 间零依赖。
+ */
+export type ReportMode = 'plugin' | 'self';
 /** 信封类型 */
 export type EnvelopeType = 'hello' | 'ack' | 'req' | 'res' | 'ping' | 'pong';
 /** 消息信封：所有跨窗口通信的统一包装 */
@@ -51,6 +62,13 @@ export interface BridgeOptions {
      * dynamic：轮询 getContentContext 跟随当前激活的轻应用窗口切换绑定。
      */
     bindMode?: BindMode;
+    /**
+     * 结果上报模式（轻应用角色语义声明），默认 'plugin'：
+     * 'plugin'=结果交插件统一上报（reply 无需额外字段）；
+     * 'self'=业务自行上报并在 reply 带 result_reported: true。
+     * SDK 不执行上报，仅存为实例属性 reportMode 供业务读取。
+     */
+    reportMode?: ReportMode;
     /** dynamic 模式轮询 getContentContext 的间隔(ms)，默认 2000 */
     dynamicPollInterval?: number;
     /** dynamic 模式迁移探测窗口：向新窗口发 hello 等 ack 的时长(ms)，默认 3000 */
@@ -94,6 +112,7 @@ export default class LightAppBridge {
     timeout: number;
     handshakeTimeout: number;
     bindMode: BindMode;
+    reportMode: ReportMode;
     dynamicPollInterval: number;
     migrateProbeTimeout: number;
     pingInterval: number;

package/dist/lightAppBridge.js

@@ -212,6 +212,7 @@ export default class LightAppBridge {
         this.timeout = options.timeout != null ? options.timeout : DEFAULT_TIMEOUT;
         this.handshakeTimeout = options.handshakeTimeout != null ? options.handshakeTimeout : DEFAULT_HANDSHAKE_TIMEOUT;
         this.bindMode = options.bindMode === 'dynamic' ? 'dynamic' : DEFAULT_BIND_MODE;
+        this.reportMode = options.reportMode === 'self' ? 'self' : 'plugin';
         this.dynamicPollInterval = options.dynamicPollInterval != null ? options.dynamicPollInterval : DEFAULT_DYNAMIC_POLL_INTERVAL;
         this.migrateProbeTimeout = options.migrateProbeTimeout != null ? options.migrateProbeTimeout : DEFAULT_MIGRATE_PROBE_TIMEOUT;
         this.pingInterval = options.pingInterval != null ? options.pingInterval : DEFAULT_PING_INTERVAL;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhh96/light-app-bridge",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "type": "module",
   "description": "招商随行（WorkLink）插件窗口(plugin)与轻应用窗口(lightapp)之间的双向通信 SDK",
   "main": "./dist/index.js",