@tomflow/proflow-execution-browser-extension 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-execution-browser-extension
 
+## 0.1.16
+
+### Patch Changes
+
+- Harden Deployment Closeout: fail closed on partial installs and package-manager conflicts, normalize Git workspace isolation, make Dev Tunnel status fast and resumable without fabricating login failures, and align Browser Extension setup/conformance behavior.
+
+## 0.1.15
+
+### Patch Changes
+
+- Add professional setup orchestration, Provider FAST/THINK input, recoverable managed Dev Tunnel provisioning, Browser installation guidance, and precise status diagnostics.
+
 ## 0.1.14
 
 ### Patch Changes

package/DOCS.md

@@ -32,7 +32,7 @@ Execution 领域拥有的 Chrome MV3 Extension，负责 Task UI、审批提醒
 
 ## 使用方式
 
-运行 `platform setup --workspace <workspace> --module execution-browser-extension`。ProFlow 会先准备 unpacked 目录、运行配置和本地 Bridge，并用真实 hello + heartbeat 尝试重验证已有扩展；已有扩展仍在线时不会再次打扰用户。只有未检测到在线扩展时，ProFlow 才把正确目录复制到剪贴板并打开 `chrome://extensions/`，提示用户完成安装操作：如果开发者模式尚未开启则先开启，然后点击“加载未打包的扩展程序”，在目录选择窗口中粘贴并确认目录。完成后无需回终端输入任何标识或状态；扩展身份、session、hello/heartbeat、Browser Executor 配置和 setup evidence 都由机器自动发现、生成并验证。历史 pairing evidence 不能单独代替本次 live revalidation。
+运行 `platform setup --workspace <workspace>`。ProFlow 会先准备 unpacked 目录、运行配置和本地 Bridge，并用真实 hello + heartbeat 尝试重验证已有扩展；已有扩展仍在线时不会再次打扰用户。只有未检测到在线扩展时，ProFlow 才按步骤打开 `chrome://extensions/`、确认开发者模式、复制正确目录并指导加载。完成后无需输入任何标识或状态；扩展身份、session、hello/heartbeat、Browser Executor 配置和 setup evidence 都由模块自行发现、生成并验证。历史 pairing evidence 不能单独代替本次 live revalidation。
 
 若 pairing 等待超时，ProFlow 保留已经准备好的扩展文件和机器配置，不写伪 READY evidence，并输出稳定错误代码 `PAIRING_TIMEOUT`。用户确认 Chrome 已完成加载后重新执行 `platform setup` 即可。Agent setup 随后通过 `custom-gpt-web-provisioning` 使用同一 Extension package 的部署期分支。
 

package/SETUP.md

@@ -2,8 +2,8 @@
 
 ## STEP-EXECUTION-BROWSER-EXTENSION-01 — 加载扩展并自动配对
 Responsible: USER
-Interactive executable: `platform setup --module execution-browser-extension`
-Non-interactive executable: `platform setup --module execution-browser-extension`
+Interactive executable: `platform setup`
+Non-interactive executable: `platform setup`
 Required inputs: none
 Verify: `platform status`
 Success condition: 本地 pairing listener 已收到真实 Extension hello + heartbeat，并持久化部署证据。

package/dist/deployment/adapter.d.ts

@@ -24,7 +24,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.15";
             data: {
                 loadDir: string;
             };
@@ -37,7 +37,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.15";
         };
         observedEffects: never[];
     }>;
@@ -47,7 +47,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.15";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -60,22 +60,52 @@ export declare const behaviorAdapter: {
                 }[];
             };
         };
-        observedEffects: string[];
+        observedEffects: never[];
     }>;
     readonly setup: (context: ModuleCommandContext) => Promise<{
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.15";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            data: {
+                steps: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    state: "TODO";
+                    responsible: "USER";
+                    execution: {
+                        interactive: string;
+                        nonInteractive: string;
+                    };
+                    requiredInputs: never[];
+                    verify: string;
+                    successCondition: string;
+                    humanAction: string;
+                }[];
+            };
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+        };
+        observedEffects: never[];
+    } | {
         result: {
             readonly contract: "deployment.result.v1";
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.15";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.15";
             ok: false;
             status: "FAILED";
             error: {
@@ -90,8 +120,8 @@ export declare const behaviorAdapter: {
                     readonly state: "BLOCKED";
                     readonly responsible: "EXTERNAL";
                     readonly execution: {
-                        readonly interactive: "platform setup --module execution-browser-extension";
-                        readonly nonInteractive: "platform setup --module execution-browser-extension";
+                        readonly interactive: "platform setup";
+                        readonly nonInteractive: "platform setup";
                     };
                     readonly requiredInputs: readonly [];
                     readonly verify: "platform status";
@@ -108,7 +138,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.15";
             data: {
                 docs: string;
             };
@@ -121,11 +151,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.15";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.15";
             ok: false;
             status: "FAILED";
             error: {
@@ -142,7 +172,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.15";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -3,7 +3,7 @@ import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { deterministicLoopbackPort, ensureModuleSecretFile, moduleWorkspaceStateDirectory, readModuleSharedFacts, writeModuleSharedFacts, } from "@tomflow/proflow-module-contract";
-import { runInteractiveBrowserExtensionSetup } from "../src/install-workflow.js";
+import { openBrowserExtensionManager, runInteractiveBrowserExtensionSetup, } from "../src/install-workflow.js";
 import { createBrowserExtensionPairingServer } from "../src/pairing.js";
 import { descriptor } from "./descriptor.js";
 const base = {
@@ -21,8 +21,8 @@ const blockedSetupPlan = {
             state: "BLOCKED",
             responsible: "EXTERNAL",
             execution: {
-                interactive: "platform setup --module execution-browser-extension",
-                nonInteractive: "platform setup --module execution-browser-extension",
+                interactive: "platform setup",
+                nonInteractive: "platform setup",
             },
             requiredInputs: [],
             verify: "platform status",
@@ -312,15 +312,13 @@ export const behaviorAdapter = {
                                     code: "EXTENSION_LOAD_REQUIRED",
                                     message: "Chrome 扩展尚未加载或缺少可验证的运行证据",
                                     relatedModuleRefs: ["chrome-runtime"],
-                                    nextCommand: "platform setup --module execution-browser-extension",
+                                    nextCommand: "platform setup",
                                 },
                             ],
                         }),
                 },
             },
-            observedEffects: evidence
-                ? ["Observes real Chrome MV3 load evidence"]
-                : [],
+            observedEffects: [],
         };
     },
     setup: async (context) => {
@@ -328,6 +326,40 @@ export const behaviorAdapter = {
             const input = typeof context.input === "object" && context.input !== null
                 ? context.input
                 : undefined;
+            if (input?.developerModeConfirmed !== true) {
+                await openBrowserExtensionManager(input?.desktop);
+                return {
+                    result: {
+                        ...base,
+                        ok: false,
+                        status: "ACTION_REQUIRED",
+                        data: {
+                            steps: [
+                                {
+                                    id: "STEP-EXECUTION-BROWSER-EXTENSION-01",
+                                    title: "开启 Chrome 开发者模式",
+                                    description: "请在刚打开的扩展管理页开启右上角“开发者模式”。",
+                                    state: "TODO",
+                                    responsible: "USER",
+                                    execution: {
+                                        interactive: "platform setup",
+                                        nonInteractive: "platform setup",
+                                    },
+                                    requiredInputs: [],
+                                    verify: "platform status",
+                                    successCondition: "用户确认开发者模式已开启",
+                                    humanAction: "开启开发者模式后返回终端确认",
+                                },
+                            ],
+                        },
+                        actionRequired: {
+                            action: "confirm-browser-developer-mode",
+                            description: "请开启 Chrome 开发者模式后确认。",
+                        },
+                    },
+                    observedEffects: [],
+                };
+            }
             await runInteractiveBrowserExtensionSetup({
                 workspaceRoot: context.workspaceRoot,
                 ...(input?.timeoutMs === undefined
@@ -338,11 +370,7 @@ export const behaviorAdapter = {
             });
             return {
                 result: base,
-                observedEffects: [
-                    "Materializes browser runtime configuration",
-                    "Opens Chrome extension management",
-                    "Persists heartbeat-proven Chrome MV3 pairing evidence",
-                ],
+                observedEffects: ["Materialize the unpacked MV3 extension package"],
             };
         }
         catch (error) {

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.14";
+    readonly moduleVersion: "0.1.15";
     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.14",
+    moduleVersion: "0.1.15",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/extension/background.js

@@ -14186,6 +14186,7 @@ async function persistSystemObserverState(result) {
   });
 }
 var observerRecoveryInFlight = null;
+var observerRecoveryRetryCount = 0;
 function runObserverRecovery() {
   if (observerRecoveryInFlight) return observerRecoveryInFlight;
   observerRecoveryInFlight = (async () => {
@@ -14221,7 +14222,15 @@ function runObserverRecovery() {
         }
       }
     }
-    const listed = await invokeTaskApplication("task.list", {});
+    const listed = await invokeTaskApplication("task.list", {}).catch(
+      () => null
+    );
+    if (listed === null && observerRecoveryRetryCount < 6) {
+      observerRecoveryRetryCount += 1;
+      setTimeout(() => void runObserverRecovery(), 2e3);
+    } else if (listed !== null) {
+      observerRecoveryRetryCount = 0;
+    }
     if (isRecord(listed) && Array.isArray(listed.tasks)) {
       for (const candidate of listed.tasks.slice(0, 100)) {
         if (!isRecord(candidate) || typeof candidate.taskId !== "string")

package/dist/src/install-workflow.d.ts

@@ -18,6 +18,7 @@ export type BrowserExtensionPair = (context: {
 export declare function browserExtensionInstallInstruction(loadDir: string): string;
 export declare function browserExtensionSetupSuccessMessage(): string;
 export declare function browserExtensionSetupFailureMessage(error: unknown): string;
+export declare function openBrowserExtensionManager(desktop?: BrowserExtensionDesktop): Promise<void>;
 export declare function runInteractiveBrowserExtensionSetup(input: {
     workspaceRoot: string;
     timeoutMs?: number;

package/dist/src/install-workflow.js

@@ -1,6 +1,6 @@
 import { spawn, spawnSync } from "node:child_process";
 export function browserExtensionInstallInstruction(loadDir) {
-    return `\nChrome 浏览器扩展\n\nProFlow 已准备好扩展文件，并已复制安装目录：\n${loadDir}\n\n请在已经打开的 Chrome 扩展管理页完成以下安装操作：\n1. 如果“开发者模式”尚未开启，请开启\n2. 点击“加载未打包的扩展程序”\n3. 在目录选择窗口中粘贴并确认刚刚复制的目录\n\n完成后无需返回输入任何内容。ProFlow 会自动检测扩展并继续。\n`;
+    return `\n步骤 2/2｜加载浏览器扩展\n\n扩展目录已复制到剪贴板：\n${loadDir}\n\n1. 点击“加载未打包的扩展程序”\n2. 在目录选择窗口按 Cmd+Shift+G\n3. 按 Cmd+V 粘贴路径，然后按 Enter\n4. 点击 Select（选择）\n\n完成后无需返回终端输入内容。ProFlow 正在自动等待扩展连接。\n`;
 }
 export function browserExtensionSetupSuccessMessage() {
     return "\n✓ Chrome 浏览器扩展已连接\n✓ 配置与真实 heartbeat 验证通过\n\n浏览器扩展：READY\n";
@@ -8,7 +8,7 @@ export function browserExtensionSetupSuccessMessage() {
 export function browserExtensionSetupFailureMessage(error) {
     const detail = error instanceof Error ? error.message : String(error);
     if (detail === "PAIRING_TIMEOUT") {
-        return "✕ 暂未检测到浏览器扩展连接\n\n请确认扩展已经在 Chrome 中完成加载。已准备好的扩展文件和机器配置不会丢失。\n下一步：重新执行 platform setup\n错误代码：PAIRING_TIMEOUT\n";
+        return "✕ 暂未检测到浏览器扩展连接\n\n已准备好的扩展文件和机器配置不会丢失。重新执行 platform setup 后可以再次复制路径、重新打开 Chrome、显示完整路径或退出。\n错误代码：PAIRING_TIMEOUT\n";
     }
     const code = /^[A-Z][A-Z0-9_:-]*$/.test(detail)
         ? detail
@@ -49,6 +49,9 @@ function systemDesktop() {
         },
     };
 }
+export async function openBrowserExtensionManager(desktop = systemDesktop()) {
+    await desktop.openExtensionsPage();
+}
 export async function runInteractiveBrowserExtensionSetup(input) {
     const desktop = input.desktop ?? systemDesktop();
     const pair = input.pair ??

package/extension/background.ts

@@ -583,6 +583,7 @@ async function persistSystemObserverState(
 }
 
 let observerRecoveryInFlight: Promise<void> | null = null;
+let observerRecoveryRetryCount = 0;
 function runObserverRecovery() {
 	if (observerRecoveryInFlight) return observerRecoveryInFlight;
 	observerRecoveryInFlight = (async () => {
@@ -636,7 +637,15 @@ function runObserverRecovery() {
 				}
 			}
 		}
-		const listed = await invokeTaskApplication("task.list", {});
+		const listed = await invokeTaskApplication("task.list", {}).catch(
+			() => null,
+		);
+		if (listed === null && observerRecoveryRetryCount < 6) {
+			observerRecoveryRetryCount += 1;
+			setTimeout(() => void runObserverRecovery(), 2_000);
+		} else if (listed !== null) {
+			observerRecoveryRetryCount = 0;
+		}
 		if (isRecord(listed) && Array.isArray(listed.tasks)) {
 			for (const candidate of listed.tasks.slice(0, 100)) {
 				if (!isRecord(candidate) || typeof candidate.taskId !== "string")

package/manifest.json

@@ -1,17 +1,28 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.14",
-	"permissions": ["tabs", "storage", "sidePanel"],
-	"host_permissions": ["https://chatgpt.com/*", "http://127.0.0.1/*"],
+	"version": "0.1.16",
+	"permissions": [
+		"tabs",
+		"storage",
+		"sidePanel"
+	],
+	"host_permissions": [
+		"https://chatgpt.com/*",
+		"http://127.0.0.1/*"
+	],
 	"background": {
 		"service_worker": "dist/extension/background.js",
 		"type": "module"
 	},
 	"content_scripts": [
 		{
-			"matches": ["https://chatgpt.com/g/*"],
-			"js": ["dist/extension/content.js"],
+			"matches": [
+				"https://chatgpt.com/g/*"
+			],
+			"js": [
+				"dist/extension/content.js"
+			],
 			"run_at": "document_idle"
 		},
 		{
@@ -19,7 +30,9 @@
 				"https://chatgpt.com/gpts/editor",
 				"https://chatgpt.com/gpts/editor/*"
 			],
-			"js": ["dist/extension/provisioning-content.js"],
+			"js": [
+				"dist/extension/provisioning-content.js"
+			],
 			"run_at": "document_idle"
 		}
 	],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -27,11 +27,11 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-contracts": "^0.1.10",
-    "@tomflow/proflow-module-contract": "^0.1.13"
+    "@tomflow/proflow-module-contract": "^0.1.13",
+    "@tomflow/proflow-execution-contracts": "^0.1.10"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.12",
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
     "@tomflow/proflow-execution-runtime": "^0.1.15"
   },
   "keywords": [

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.14",
+	"moduleVersion": "0.1.16",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",