@tomflow/proflow-execution-browser-extension 0.1.26 → 0.1.28

package/DOCS.md

@@ -6,7 +6,7 @@ Execution 领域拥有的 Chrome MV3 Extension，负责 Task UI、审批提醒
 
 ## 主要能力
 
-- 运行期提供 New Task 与 Side Panel UI、Task Observer、System Observer 和 Browser Effect。
+- 运行期提供独立 ProFlow Tasks 扩展页面、Task Observer、System Observer 和 Browser Effect；任务 UI 不再以内嵌 Side Panel 形式占用当前网页。
 - 运行期创建、恢复和唤醒 Custom GPT Conversation，稳定观察 workerRef/c-id。
 - 部署期通过独立 `/gpts/editor` / `/gpts/editor/*` Provisioning Surface 物化 Custom GPT；该分支不进入 Task/Worker 状态机。
 - 正常创建路径在单一 GPT Editor 会话中完成字段、Action Schema、API Key/Bearer、Knowledge ZIP、模型与 Capabilities 配置，再创建 Private GPT；不在 Create 后重新打开同一 GPT 做 Auth。

package/dist/deployment/adapter.d.ts

@@ -47,7 +47,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             data: {
                 loadDir: string;
             };
@@ -60,7 +60,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.26";
+            readonly moduleVersion: "0.1.28";
         };
         observedEffects: never[];
     }>;
@@ -70,7 +70,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -95,7 +95,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -127,14 +127,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.26";
+            readonly moduleVersion: "0.1.28";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             ok: false;
             status: "FAILED";
             error: {
@@ -167,7 +167,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             data: {
                 docs: string;
             };
@@ -180,11 +180,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.26";
+            readonly moduleVersion: "0.1.28";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.26";
+            moduleVersion: "0.1.28";
             ok: false;
             status: "FAILED";
             error: {
@@ -201,7 +201,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.26";
+            readonly moduleVersion: "0.1.28";
         };
         observedEffects: never[];
     }>;

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

package/dist/extension/background.js

@@ -13866,6 +13866,13 @@ function createTaskObserver(options) {
   return Object.freeze({ advance, drive });
 }
 
+// packages/execution-browser-extension/src/recovery-trigger.ts
+function shouldTriggerObserverRecovery(previous, current) {
+  if (current.pageState !== "IDLE") return false;
+  if (!previous) return true;
+  return previous.pageState !== "IDLE" || previous.url !== current.url || previous.contentInstanceId !== current.contentInstanceId || previous.activityKind !== current.activityKind;
+}
+
 // packages/execution-browser-extension/extension/background.ts
 var extensionInstanceId = `extension:${crypto.randomUUID()}`;
 var sessions = /* @__PURE__ */ new Map();
@@ -14693,6 +14700,7 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
     return true;
   }
   if (message.type === "PROFLOW_CONTENT_OBSERVATION" && message.observation && sender.tab?.id !== void 0 && sender.tab.windowId !== void 0) {
+    const previous = sessions.get(sender.tab.id);
     const observed = {
       ...message.observation,
       tabId: sender.tab.id,
@@ -14700,7 +14708,8 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
     };
     sessions.set(sender.tab.id, observed);
     void persistSnapshot();
-    if (observed.pageState === "IDLE") void runObserverRecovery();
+    if (shouldTriggerObserverRecovery(previous, observed))
+      void runObserverRecovery();
     sendResponse({ accepted: true, extensionInstanceId });
     return;
   }
@@ -14770,6 +14779,18 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
     return true;
   }
 });
+async function openTaskPage() {
+  const taskPageUrl = chrome.runtime.getURL("extension/tasks.html");
+  const [existing] = await chrome.tabs.query({
+    url: taskPageUrl,
+    currentWindow: true
+  });
+  if (existing?.id !== void 0) {
+    await chrome.tabs.update(existing.id, { active: true });
+    return;
+  }
+  await chrome.tabs.create({ url: taskPageUrl, active: true });
+}
 async function startBackgroundRuntime() {
   await bootstrapManagedRuntimeConfig();
   await persistSnapshot();
@@ -14777,8 +14798,10 @@ async function startBackgroundRuntime() {
   void runProvisioningBridgeLoop();
   void runObserverRecovery();
 }
+chrome.action.onClicked.addListener(() => {
+  void openTaskPage();
+});
 chrome.runtime.onInstalled.addListener(() => {
-  void chrome.sidePanel.setPanelBehavior({ openPanelOnActionClick: true });
   void bootstrapManagedRuntimeConfig().then(async () => {
     await persistSnapshot();
     void runBridgeLoop();

package/dist/extension/{side-panel.js → tasks.js}

@@ -2,7 +2,7 @@ export {};
 function element(selector) {
     const value = document.querySelector(selector);
     if (!value)
-        throw new Error(`SIDE_PANEL_TARGET_MISSING:${selector}`);
+        throw new Error(`TASK_PAGE_TARGET_MISSING:${selector}`);
     return value;
 }
 const connection = element("#connection");
@@ -81,7 +81,7 @@ async function refreshApprovals() {
             await approvalApplication("approval.deny", {
                 approvalRef: approval.approvalRef,
                 expectedVersion: approval.version,
-                reason: "Denied from Extension Side Panel",
+                reason: "Denied from Extension Task Page",
             });
             await refreshApprovals();
         }));
@@ -116,7 +116,7 @@ async function loadTask(taskId) {
                     await taskApplication("node.reopen", {
                         taskId: selected.taskId,
                         nodeId: node.nodeId,
-                        reason: "Human reopen from Extension Side Panel",
+                        reason: "Human reopen from Extension Task Page",
                         expectedTaskVersion: selected.version,
                         idempotencyKey: requestId("extension-reopen"),
                     });

package/dist/src/recovery-trigger.d.ts

@@ -0,0 +1,8 @@
+type RecoveryObservation = {
+    url: string;
+    contentInstanceId: string;
+    pageState: "IDLE" | "BUSY" | "BLOCKED" | "UNKNOWN";
+    activityKind: string | null;
+};
+export declare function shouldTriggerObserverRecovery(previous: RecoveryObservation | undefined, current: RecoveryObservation): boolean;
+export {};

package/dist/src/recovery-trigger.js

@@ -0,0 +1,10 @@
+export function shouldTriggerObserverRecovery(previous, current) {
+    if (current.pageState !== "IDLE")
+        return false;
+    if (!previous)
+        return true;
+    return (previous.pageState !== "IDLE" ||
+        previous.url !== current.url ||
+        previous.contentInstanceId !== current.contentInstanceId ||
+        previous.activityKind !== current.activityKind);
+}

package/extension/background.ts

@@ -12,6 +12,7 @@ import {
 	type TaskObserverDiagnosticAssessment,
 	type TaskObserverDiagnosticFailure,
 } from "../src/task-observer.js";
+import { shouldTriggerObserverRecovery } from "../src/recovery-trigger.js";
 
 type PageState = "IDLE" | "BUSY" | "BLOCKED" | "UNKNOWN";
 type ActivityKind =
@@ -111,13 +112,11 @@ type ChromeRuntime = {
 			set(value: Record<string, unknown>): Promise<void>;
 		};
 	};
-	sidePanel: {
-		setPanelBehavior(options: {
-			openPanelOnActionClick: boolean;
-		}): Promise<void>;
+	action: {
+		onClicked: { addListener(listener: () => void): void };
 	};
 	tabs: {
-		query(query: { url?: string }): Promise<ChromeTab[]>;
+		query(query: { url?: string; currentWindow?: boolean }): Promise<ChromeTab[]>;
 		get(tabId: number): Promise<ChromeTab>;
 		create(create: { url: string; active: boolean }): Promise<ChromeTab>;
 		reload(tabId: number): Promise<void>;
@@ -1218,6 +1217,7 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
 		sender.tab?.id !== undefined &&
 		sender.tab.windowId !== undefined
 	) {
+		const previous = sessions.get(sender.tab.id);
 		const observed: ContentObservation = {
 			...message.observation,
 			tabId: sender.tab.id,
@@ -1225,7 +1225,8 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
 		};
 		sessions.set(sender.tab.id, observed);
 		void persistSnapshot();
-		if (observed.pageState === "IDLE") void runObserverRecovery();
+		if (shouldTriggerObserverRecovery(previous, observed))
+			void runObserverRecovery();
 		sendResponse({ accepted: true, extensionInstanceId });
 		return;
 	}
@@ -1316,6 +1317,19 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
 	}
 });
 
+async function openTaskPage(): Promise<void> {
+	const taskPageUrl = chrome.runtime.getURL("extension/tasks.html");
+	const [existing] = await chrome.tabs.query({
+		url: taskPageUrl,
+		currentWindow: true,
+	});
+	if (existing?.id !== undefined) {
+		await chrome.tabs.update(existing.id, { active: true });
+		return;
+	}
+	await chrome.tabs.create({ url: taskPageUrl, active: true });
+}
+
 async function startBackgroundRuntime(): Promise<void> {
 	await bootstrapManagedRuntimeConfig();
 	await persistSnapshot();
@@ -1324,8 +1338,10 @@ async function startBackgroundRuntime(): Promise<void> {
 	void runObserverRecovery();
 }
 
+chrome.action.onClicked.addListener(() => {
+	void openTaskPage();
+});
 chrome.runtime.onInstalled.addListener(() => {
-	void chrome.sidePanel.setPanelBehavior({ openPanelOnActionClick: true });
 	void bootstrapManagedRuntimeConfig().then(async () => {
 		await persistSnapshot();
 		void runBridgeLoop();

package/extension/options.html

@@ -29,7 +29,7 @@
 
 		<section>
 			<h2>Task Application</h2>
-			<p>Connects the Side Panel to the loopback platform-host application surface. This credential is separate from Role and Browser-bridge credentials.</p>
+			<p>Connects the independent ProFlow Tasks page to the loopback platform-host application surface. This credential is separate from Role and Browser-bridge credentials.</p>
 			<form id="task-application-form">
 				<label>Platform-host endpoint <input id="task-application-endpoint" required placeholder="http://127.0.0.1:47830" /></label>
 				<label>Task application token <input id="task-application-token" type="password" required autocomplete="off" /></label>

package/extension/{side-panel.html → tasks.html}

@@ -3,25 +3,28 @@
 	<head>
 		<meta charset="utf-8" />
 		<meta name="viewport" content="width=device-width" />
-		<title>ProFlow</title>
+		<title>ProFlow Tasks</title>
 		<style>
-			body { font: 13px system-ui; margin: 12px; }
-			section { border-top: 1px solid #ddd; margin-top: 14px; padding-top: 10px; }
+			body { background: #f7f7f8; color: #18181b; font: 14px system-ui; margin: 0; }
+			main { box-sizing: border-box; margin: 0 auto; max-width: 1180px; padding: 28px; }
+			header { margin-bottom: 20px; }
+			section { background: #fff; border: 1px solid #e4e4e7; border-radius: 10px; margin-top: 14px; padding: 16px; }
 			label { display: block; margin: 8px 0; }
-			input, textarea { box-sizing: border-box; display: block; margin-top: 4px; width: 100%; }
-			textarea { min-height: 72px; }
-			button { margin: 4px 4px 4px 0; padding: 5px 9px; }
+			input, textarea { box-sizing: border-box; display: block; margin-top: 4px; padding: 8px; width: 100%; }
+			textarea { min-height: 84px; }
+			button { margin: 4px 4px 4px 0; padding: 7px 11px; }
 			button[disabled] { opacity: .55; }
-			.task { border: 1px solid #ddd; margin: 6px 0; padding: 7px; }
-			.meta { color: #555; font-size: 12px; }
+			.task { border: 1px solid #e4e4e7; border-radius: 8px; margin: 8px 0; padding: 10px; }
+			.meta { color: #52525b; font-size: 12px; }
 			#error { color: #a00; white-space: pre-wrap; }
 			#result { white-space: pre-wrap; }
-			#browser-status { max-height: 180px; overflow: auto; }
+			#browser-status { max-height: 220px; overflow: auto; }
 		</style>
 	</head>
 	<body>
+		<main>
 		<header>
-			<h1>ProFlow</h1>
+			<h1>ProFlow Tasks</h1>
 			<div id="connection" class="meta">Connecting…</div>
 		</header>
 
@@ -54,7 +57,7 @@
 
 		<section>
 			<h2>Execution Approval</h2>
-			<p class="meta">Approval is an Execution-owned durable fact. This panel only sends authenticated human decisions to the Execution Owner.</p>
+			<p class="meta">Approval is an Execution-owned durable fact. This page only sends authenticated human decisions to the Execution Owner.</p>
 			<button id="refresh-approvals" type="button">Refresh approvals</button>
 			<div id="approvals"></div>
 		</section>
@@ -72,6 +75,7 @@
 
 		<p id="error" role="alert"></p>
 		<pre id="result" role="status"></pre>
-		<script type="module" src="../dist/extension/side-panel.js"></script>
+		<script type="module" src="../dist/extension/tasks.js"></script>
+		</main>
 	</body>
 </html>

package/extension/{side-panel.ts → tasks.ts}

@@ -47,7 +47,7 @@ type TaskView = TaskSummary & {
 
 function element<T extends HTMLElement>(selector: string): T {
 	const value = document.querySelector<T>(selector);
-	if (!value) throw new Error(`SIDE_PANEL_TARGET_MISSING:${selector}`);
+	if (!value) throw new Error(`TASK_PAGE_TARGET_MISSING:${selector}`);
 	return value;
 }
 
@@ -152,7 +152,7 @@ async function refreshApprovals() {
 					await approvalApplication("approval.deny", {
 						approvalRef: approval.approvalRef,
 						expectedVersion: approval.version,
-						reason: "Denied from Extension Side Panel",
+						reason: "Denied from Extension Task Page",
 					});
 					await refreshApprovals();
 				}),
@@ -189,7 +189,7 @@ async function loadTask(taskId: string) {
 					await taskApplication("node.reopen", {
 						taskId: selected.taskId,
 						nodeId: node.nodeId,
-						reason: "Human reopen from Extension Side Panel",
+						reason: "Human reopen from Extension Task Page",
 						expectedTaskVersion: selected.version,
 						idempotencyKey: requestId("extension-reopen"),
 					});

package/manifest.json

@@ -1,11 +1,10 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.26",
+	"version": "0.1.28",
 	"permissions": [
 		"tabs",
-		"storage",
-		"sidePanel"
+		"storage"
 	],
 	"host_permissions": [
 		"https://chatgpt.com/*",
@@ -36,8 +35,8 @@
 			"run_at": "document_idle"
 		}
 	],
-	"side_panel": {
-		"default_path": "extension/side-panel.html"
+	"action": {
+		"default_title": "Open ProFlow Tasks"
 	},
 	"options_page": "extension/options.html"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -27,8 +27,8 @@
     "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-execution-runtime": "^0.1.15",

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

package/CHANGELOG.md

@@ -1,31 +0,0 @@
-# @tomflow/proflow-execution-browser-extension
-
-## 0.1.26
-
-### Patch Changes
-
-- Close the Real-3 source candidate and real-workspace loop: fail-closed Browser submit verification, worker-bound Task mutation and WAKE confirmation, detached platform start ownership with shell return, discoverable docs, and targeted single-package Workspace update.
-
-## 0.1.25
-
-### Patch Changes
-
-- Preserve irreversible Custom GPT role authority and revalidate existing roles without duplicate creation
-
-## 0.1.24
-
-### Patch Changes
-
-- Cover Chrome's observed delayed Secure Preferences flush while waiting for unpacked-extension registration to become enabled after pairing.
-
-## 0.1.23
-
-### Patch Changes
-
-- Wait for Chrome unpacked-extension registration to become observably enabled after heartbeat pairing before Browser setup reports success.
-
-## 0.1.22
-
-### Patch Changes
-
-- Make Browser Extension static materialization version-idempotent, freeze real-user install/remove acceptance paths, and remove unsupported Reload/Disable-Enable test scenarios.