@tomflow/proflow-execution-browser-extension 0.1.19 → 0.1.21

package/dist/deployment/adapter.d.ts

@@ -7,6 +7,29 @@ export declare function materializeProductionConfig(input: {
 }): Promise<{
     loadDir: string;
 }>;
+export type RunningBridgeProbe = {
+    kind: "ABSENT";
+} | {
+    kind: "PRESENT";
+    identity?: {
+        extensionId: string;
+        extensionInstanceId: string;
+    };
+};
+export declare function classifyBrowserLiveSetup(input: {
+    baseSetupReady: boolean;
+    evidenceInstanceId?: string;
+    bridgeProbe: RunningBridgeProbe;
+}): {
+    readonly setupReady: boolean;
+    issueCode?: never;
+} | {
+    setupReady: boolean;
+    issueCode: "EXTENSION_SESSION_OFFLINE";
+} | {
+    setupReady: boolean;
+    issueCode: "EXTENSION_SESSION_REVALIDATION_REQUIRED";
+};
 export declare function pairBrowserExtensionSetup(context: ModuleCommandContext, options?: {
     timeoutMs?: number;
     onWaiting?: (input: {
@@ -24,7 +47,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             data: {
                 loadDir: string;
             };
@@ -37,7 +60,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.19";
+            readonly moduleVersion: "0.1.21";
         };
         observedEffects: never[];
     }>;
@@ -47,17 +70,23 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
-                issues?: {
+                issues?: ({
                     scope: "SETUP";
                     code: string;
                     message: string;
                     relatedModuleRefs: string[];
                     nextCommand: string;
-                }[];
+                } | {
+                    scope: "SETUP";
+                    code: "EXTENSION_SESSION_OFFLINE" | "EXTENSION_SESSION_REVALIDATION_REQUIRED" | undefined;
+                    message: string;
+                    relatedModuleRefs: string[];
+                    nextCommand: string;
+                })[];
             };
         };
         observedEffects: never[];
@@ -66,7 +95,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -98,14 +127,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.19";
+            readonly moduleVersion: "0.1.21";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             ok: false;
             status: "FAILED";
             error: {
@@ -138,7 +167,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             data: {
                 docs: string;
             };
@@ -151,11 +180,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.19";
+            readonly moduleVersion: "0.1.21";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.19";
+            moduleVersion: "0.1.21";
             ok: false;
             status: "FAILED";
             error: {
@@ -172,7 +201,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.19";
+            readonly moduleVersion: "0.1.21";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -133,11 +133,12 @@ async function persistDeveloperModeConfirmation(context) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     await writeFile(installFlowFile(context), `${JSON.stringify({ developerModeConfirmed: true })}\n`, { mode: 0o600 });
 }
-async function readEvidence(context, loadDir) {
+async function readEvidenceCandidate(context, loadDir) {
     try {
         const raw = JSON.parse(await readFile(verificationFile(context), "utf8"));
         return raw.contract === "proflow.browser-extension-verification.v1" &&
-            raw.moduleVersion === descriptor.moduleVersion &&
+            typeof raw.moduleVersion === "string" &&
+            raw.moduleVersion.length > 0 &&
             raw.loadDir === loadDir &&
             typeof raw.extensionId === "string" &&
             /^[a-z]{32}$/.test(raw.extensionId) &&
@@ -154,6 +155,12 @@ async function readEvidence(context, loadDir) {
         return undefined;
     }
 }
+async function readEvidence(context, loadDir) {
+    const evidence = await readEvidenceCandidate(context, loadDir);
+    return evidence?.moduleVersion === descriptor.moduleVersion
+        ? evidence
+        : undefined;
+}
 async function ownFacts(context) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     const loadDir = browserExtensionLoadDir(context.workspaceRoot);
@@ -248,15 +255,98 @@ async function persistPairedBrowserExtension(context, prepared, identity) {
     await writeFile(verificationFile(context), `${JSON.stringify(evidence, null, 2)}\n`, { mode: 0o600 });
     return identity;
 }
+export function classifyBrowserLiveSetup(input) {
+    if (!input.baseSetupReady || input.bridgeProbe.kind === "ABSENT")
+        return { setupReady: input.baseSetupReady };
+    if (!input.bridgeProbe.identity)
+        return {
+            setupReady: false,
+            issueCode: "EXTENSION_SESSION_OFFLINE",
+        };
+    if (input.bridgeProbe.identity.extensionInstanceId !== input.evidenceInstanceId)
+        return {
+            setupReady: false,
+            issueCode: "EXTENSION_SESSION_REVALIDATION_REQUIRED",
+        };
+    return { setupReady: true };
+}
+function connectionRefused(error) {
+    if (!(error instanceof TypeError))
+        return false;
+    const cause = Reflect.get(error, "cause");
+    return (typeof cause === "object" &&
+        cause !== null &&
+        Reflect.get(cause, "code") === "ECONNREFUSED");
+}
+async function probeRunningBridgeSession(prepared, extensionId, timeoutMs) {
+    try {
+        const response = await fetch(`${prepared.bridgeEndpoint}/v1/session/status`, {
+            headers: {
+                authorization: `Bearer ${await credential(prepared.bridgeTokenFile)}`,
+                origin: `chrome-extension://${extensionId}`,
+            },
+            signal: AbortSignal.timeout(Math.max(25, Math.min(500, timeoutMs))),
+        });
+        if (!response.ok)
+            throw new Error(`RUNNING_BRIDGE_STATUS_${response.status}`);
+        const body = (await response.json());
+        if (typeof body !== "object" || body === null || Array.isArray(body))
+            throw new Error("RUNNING_BRIDGE_STATUS_INVALID");
+        if (Reflect.get(body, "online") !== true)
+            return { kind: "PRESENT" };
+        const extensionInstanceId = Reflect.get(body, "extensionInstanceId");
+        if (typeof extensionInstanceId !== "string" ||
+            extensionInstanceId.length === 0)
+            throw new Error("RUNNING_BRIDGE_STATUS_INVALID");
+        return {
+            kind: "PRESENT",
+            identity: { extensionId, extensionInstanceId },
+        };
+    }
+    catch (error) {
+        if (connectionRefused(error))
+            return { kind: "ABSENT" };
+        throw error;
+    }
+}
+async function revalidateRunningBridge(prepared, extensionId, timeoutMs, onWaiting) {
+    const startedAt = Date.now();
+    const graceMs = Math.min(2_000, Math.max(25, Math.floor(timeoutMs / 4)));
+    let waitingShown = false;
+    while (true) {
+        const remainingMs = Math.max(1, timeoutMs - (Date.now() - startedAt));
+        const probe = await probeRunningBridgeSession(prepared, extensionId, remainingMs);
+        if (probe.kind === "ABSENT")
+            return undefined;
+        if (probe.identity)
+            return probe.identity;
+        const elapsedMs = Date.now() - startedAt;
+        if (!waitingShown && elapsedMs >= graceMs) {
+            waitingShown = true;
+            await onWaiting?.({
+                loadDir: prepared.loadDir,
+                endpoint: prepared.bridgeEndpoint,
+            });
+        }
+        if (elapsedMs >= timeoutMs)
+            throw new Error("PAIRING_TIMEOUT");
+        await new Promise((resolve) => setTimeout(resolve, Math.min(100, Math.max(10, timeoutMs - elapsedMs))));
+    }
+}
 export async function pairBrowserExtensionSetup(context, options = {}) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     await installPackage(context);
     const existingSetup = await readSetup(context);
-    const existingEvidence = await readEvidence(context, browserExtensionLoadDir(context.workspaceRoot));
+    const existingEvidence = await readEvidenceCandidate(context, browserExtensionLoadDir(context.workspaceRoot));
     const canRevalidateExisting = Boolean(existingSetup &&
         existingEvidence &&
         existingSetup.extensionId === existingEvidence.extensionId);
     const prepared = await materializeRuntimeConfig(context);
+    if (canRevalidateExisting && existingSetup) {
+        const runningIdentity = await revalidateRunningBridge(prepared, existingSetup.extensionId, options.timeoutMs ?? 120_000, options.onWaiting);
+        if (runningIdentity)
+            return persistPairedBrowserExtension(context, prepared, runningIdentity);
+    }
     const pairing = await createBrowserExtensionPairingServer({
         token: await credential(prepared.bridgeTokenFile),
         host: "127.0.0.1",
@@ -317,31 +407,57 @@ export const behaviorAdapter = {
                 loadDir,
             })
             : "MISSING";
-        const setupReady = Boolean(setup &&
+        const baseSetupReady = Boolean(setup &&
             evidence &&
             setup.extensionId === evidence.extensionId &&
             chromeState === "ENABLED");
+        let bridgeProbe = { kind: "ABSENT" };
+        if (baseSetupReady && evidence) {
+            const facts = await readModuleSharedFacts(context, descriptor.moduleRef);
+            const bridgeEndpoint = factString(facts, "bridgeEndpoint");
+            const bridgeTokenFile = factString(facts, "bridgeTokenFile");
+            if (bridgeEndpoint && bridgeTokenFile) {
+                try {
+                    bridgeProbe = await probeRunningBridgeSession({ bridgeEndpoint, bridgeTokenFile }, evidence.extensionId, 500);
+                }
+                catch {
+                    bridgeProbe = { kind: "PRESENT" };
+                }
+            }
+        }
+        const live = classifyBrowserLiveSetup({
+            baseSetupReady,
+            ...(evidence ? { evidenceInstanceId: evidence.extensionInstanceId } : {}),
+            bridgeProbe,
+        });
+        const issue = !baseSetupReady
+            ? {
+                scope: "SETUP",
+                code: "EXTENSION_LOAD_REQUIRED",
+                message: "Chrome 扩展尚未加载或缺少可验证的运行证据",
+                relatedModuleRefs: ["chrome-runtime"],
+                nextCommand: "platform setup",
+            }
+            : live.setupReady
+                ? undefined
+                : {
+                    scope: "SETUP",
+                    code: live.issueCode,
+                    message: live.issueCode === "EXTENSION_SESSION_OFFLINE"
+                        ? "Chrome 扩展已加载，但当前运行会话未在线"
+                        : "Chrome 扩展已重新启动，需要自动刷新当前运行会话证据",
+                    relatedModuleRefs: ["execution-runtime"],
+                    nextCommand: "platform setup",
+                };
         return {
             result: {
                 ...base,
                 data: {
-                    setupStatus: setupReady
+                    setupStatus: live.setupReady
                         ? "READY"
                         : "ACTION_REQUIRED",
                     runtimeStatus: "NOT_APPLICABLE",
-                    ...(setupReady
-                        ? {}
-                        : {
-                            issues: [
-                                {
-                                    scope: "SETUP",
-                                    code: "EXTENSION_LOAD_REQUIRED",
-                                    message: "Chrome 扩展尚未加载或缺少可验证的运行证据",
-                                    relatedModuleRefs: ["chrome-runtime"],
-                                    nextCommand: "platform setup",
-                                },
-                            ],
-                        }),
+                    ...(issue ? { issues: [issue] } : {}),
                 },
             },
             observedEffects: [],

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "execution-browser-extension";
     readonly packageName: "@tomflow/proflow-execution-browser-extension";
-    readonly moduleVersion: "0.1.19";
+    readonly moduleVersion: "0.1.21";
     readonly kind: "browser-extension";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "execution-browser-extension",
     packageName: "@tomflow/proflow-execution-browser-extension",
-    moduleVersion: "0.1.19",
+    moduleVersion: "0.1.21",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/bridge.js

@@ -129,6 +129,15 @@ export async function createBrowserRealityBridgeServer(options) {
                 send(response, 200, { accepted: true });
                 return;
             }
+            if (request.method === "GET" && url.pathname === "/v1/session/status") {
+                const online = session !== undefined &&
+                    now().getTime() - session.lastHeartbeatAt <= freshnessMs;
+                send(response, 200, {
+                    online,
+                    extensionInstanceId: session?.extensionInstanceId ?? null,
+                });
+                return;
+            }
             if (!session)
                 throw new BrowserRealityBridgeError("BRIDGE_OFFLINE", "extension session has not completed hello");
             if (url.searchParams.get("extensionInstanceId") !==

package/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.19",
+	"version": "0.1.21",
 	"permissions": ["tabs", "storage", "sidePanel"],
 	"host_permissions": ["https://chatgpt.com/*", "http://127.0.0.1/*"],
 	"background": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -31,8 +31,8 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-execution-runtime": "^0.1.15",
-    "@tomflow/proflow-deployment-conformance": "^0.1.13"
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
+    "@tomflow/proflow-execution-runtime": "^0.1.15"
   },
   "keywords": [
     "proflow",

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-browser-extension",
 	"packageName": "@tomflow/proflow-execution-browser-extension",
-	"moduleVersion": "0.1.19",
+	"moduleVersion": "0.1.21",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",