@tomflow/proflow-execution-browser-extension 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @tomflow/proflow-execution-browser-extension
+
+Execution-owned MV3 Browser executor/evidence provider plus the v1 Extension application surface: Task UI/New Task, Approval/Alert UI, deterministic Task Observer, low-priority System Observer, and Background Carrier Controller. These application blocks consume owner facts only through public ports and do **not** become Task/Agent/Collaboration business owners.
+
+The Carrier uses stable `workerRef/conversationLocator` and transient tab/content identities; v1 has no frame registry, frame-role handshake, iframe team workspace, persistent-tab business identity, per-Action Browser scheduler, or ordinary Browser file manager. DOM/programmatic input is primary; screenshot→Vision is fallback. Real Browser writes reuse durable Execution semantics and UNKNOWN is never blindly replayed.
+
+The optional `./bridge` export provides the loopback-only, token-authenticated runtime transport selected by real MV3 integration. It binds only `127.0.0.1`; the extension performs an explicit session hello, fresh polling heartbeat, typed command delivery, and result reporting. The bridge is never a public ingress or a second business truth.

package/conformance.json

@@ -0,0 +1 @@
+{ "contract": "proflow.conformance.v1", "levels": ["C1", "C2", "C3"] }

package/deployment/browser-extension.json

@@ -0,0 +1,6 @@
+{
+	"manifestVersion": 3,
+	"manifest": "manifest.json",
+	"statusAdapter": "deployment/adapter.ts",
+	"verificationAdapter": "deployment/adapter.ts"
+}

package/dist/deployment/adapter.d.ts

@@ -0,0 +1,61 @@
+export declare const behaviorAdapter: {
+    readonly describe: () => {
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.0";
+            ok: boolean;
+            status: string;
+        };
+        observedEffects: never[];
+    };
+    readonly preflight: () => {
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.0";
+            ok: boolean;
+            status: string;
+        };
+        observedEffects: never[];
+    };
+    readonly status: () => {
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.0";
+            ok: boolean;
+            status: string;
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+        };
+        observedEffects: never[];
+    };
+    readonly verify: () => {
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.0";
+            ok: boolean;
+            status: string;
+            checks: {
+                id: string;
+                status: string;
+                message: string;
+            }[];
+        };
+        observedEffects: never[];
+    };
+    readonly doctor: () => {
+        result: {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-browser-extension";
+            moduleVersion: "0.1.0";
+            ok: boolean;
+            status: string;
+        };
+        observedEffects: never[];
+    };
+};

package/dist/deployment/adapter.js

@@ -0,0 +1,47 @@
+import { descriptor } from "./descriptor.js";
+const base = {
+    contract: "deployment.result.v1",
+    moduleRef: descriptor.moduleRef,
+    moduleVersion: descriptor.moduleVersion,
+};
+export const behaviorAdapter = {
+    describe: () => ({
+        result: { ...base, ok: true, status: "SUCCEEDED" },
+        observedEffects: [],
+    }),
+    preflight: () => ({
+        result: { ...base, ok: true, status: "SUCCEEDED" },
+        observedEffects: [],
+    }),
+    status: () => ({
+        result: {
+            ...base,
+            ok: false,
+            status: "ACTION_REQUIRED",
+            actionRequired: {
+                action: "verify-real-carrier",
+                description: "Load in real Chrome and collect ChatGPT E3/E4 evidence",
+            },
+        },
+        observedEffects: [],
+    }),
+    verify: () => ({
+        result: {
+            ...base,
+            ok: true,
+            status: "SUCCEEDED",
+            checks: [
+                {
+                    id: "extension-package",
+                    status: "PASS",
+                    message: "The MV3 package is structurally verified; real Carrier readiness remains ACTION_REQUIRED in status",
+                },
+            ],
+        },
+        observedEffects: [],
+    }),
+    doctor: () => ({
+        result: { ...base, ok: true, status: "SUCCEEDED" },
+        observedEffects: [],
+    }),
+};

package/dist/deployment/descriptor.d.ts

@@ -0,0 +1,103 @@
+export declare const descriptor: {
+    readonly contract: "module";
+    readonly contractVersion: "1.0.0";
+    readonly moduleRef: "execution-browser-extension";
+    readonly packageName: "@tomflow/proflow-execution-browser-extension";
+    readonly moduleVersion: "0.1.0";
+    readonly kind: "browser-extension";
+    readonly templateVersion: "1.0.0";
+    readonly platformCompatibility: ">=1.0.0 <2.0.0";
+    readonly installClass: "core";
+    readonly identity: {
+        readonly domain: "execution";
+        readonly summary: "Execution-owned MV3 Browser executor, evidence provider and browser application surface.";
+    };
+    readonly provides: readonly [{
+        readonly contractRef: "execution-browser-executor";
+        readonly version: "1.0.0";
+    }];
+    readonly requires: readonly [{
+        readonly contractRef: "execution";
+        readonly versionRange: ">=1.0.0 <2.0.0";
+    }, {
+        readonly contractRef: "task-orchestration";
+        readonly versionRange: ">=1.0.0 <2.0.0";
+    }, {
+        readonly contractRef: "agent-runtime";
+        readonly versionRange: ">=1.0.0 <2.0.0";
+    }];
+    readonly requirements: readonly [{
+        readonly kind: "runtime";
+        readonly runtime: "browser";
+        readonly versionRange: ">=1";
+    }, {
+        readonly kind: "human";
+        readonly action: "Load and verify the unpacked MV3 extension in the real Chrome profile";
+    }];
+    readonly configSlots: readonly [{
+        readonly key: "bridge.endpoint";
+        readonly type: "url";
+        readonly required: true;
+        readonly description: "Loopback Browser Reality Bridge endpoint";
+    }, {
+        readonly key: "bridge.token";
+        readonly type: "secretRef";
+        readonly required: true;
+        readonly sensitive: true;
+        readonly description: "Browser Reality Bridge extension token reference";
+    }, {
+        readonly key: "taskApplication.endpoint";
+        readonly type: "url";
+        readonly required: true;
+        readonly description: "Loopback Platform Host Task application endpoint";
+    }, {
+        readonly key: "taskApplication.token";
+        readonly type: "secretRef";
+        readonly required: true;
+        readonly sensitive: true;
+        readonly description: "Platform Host Task application token reference";
+    }, {
+        readonly key: "approvalApplication.endpoint";
+        readonly type: "url";
+        readonly required: true;
+        readonly description: "Loopback Platform Host Approval application endpoint";
+    }, {
+        readonly key: "approvalApplication.token";
+        readonly type: "secretRef";
+        readonly required: true;
+        readonly sensitive: true;
+        readonly description: "Platform Host Approval application token reference";
+    }, {
+        readonly key: "chromeRuntimeModuleRef";
+        readonly type: "moduleRef";
+        readonly required: false;
+        readonly description: "External resource module governing the Chrome runtime";
+        readonly default: "chrome-runtime";
+    }, {
+        readonly key: "carrierModuleRef";
+        readonly type: "moduleRef";
+        readonly required: false;
+        readonly description: "External resource module governing the Custom GPT carrier";
+        readonly default: "chatgpt-carrier";
+    }];
+    readonly lifecycle: {
+        readonly supported: readonly ["describe", "preflight", "status", "verify", "doctor"];
+    };
+    readonly verification: {
+        readonly checks: readonly [{
+            readonly id: "real-carrier-e3-e4";
+            readonly description: "Real Chrome and ChatGPT E3/E4 evidence is present";
+            readonly lifecycle: "verify";
+        }];
+    };
+    readonly effects: readonly [{
+        readonly kind: "external-resource";
+        readonly description: "Package an MV3 extension that performs Execution-authorized Browser effects";
+        readonly retention: "preserve";
+    }];
+    readonly documentation: readonly [{
+        readonly id: "overview";
+        readonly path: "./README.md";
+        readonly description: "Package-owned module overview";
+    }];
+};

package/dist/deployment/descriptor.js

@@ -0,0 +1,109 @@
+export const descriptor = {
+    contract: "module",
+    contractVersion: "1.0.0",
+    moduleRef: "execution-browser-extension",
+    packageName: "@tomflow/proflow-execution-browser-extension",
+    moduleVersion: "0.1.0",
+    kind: "browser-extension",
+    templateVersion: "1.0.0",
+    platformCompatibility: ">=1.0.0 <2.0.0",
+    installClass: "core",
+    identity: {
+        domain: "execution",
+        summary: "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
+    },
+    provides: [{ contractRef: "execution-browser-executor", version: "1.0.0" }],
+    requires: [
+        { contractRef: "execution", versionRange: ">=1.0.0 <2.0.0" },
+        { contractRef: "task-orchestration", versionRange: ">=1.0.0 <2.0.0" },
+        { contractRef: "agent-runtime", versionRange: ">=1.0.0 <2.0.0" },
+    ],
+    requirements: [
+        { kind: "runtime", runtime: "browser", versionRange: ">=1" },
+        {
+            kind: "human",
+            action: "Load and verify the unpacked MV3 extension in the real Chrome profile",
+        },
+    ],
+    configSlots: [
+        {
+            key: "bridge.endpoint",
+            type: "url",
+            required: true,
+            description: "Loopback Browser Reality Bridge endpoint",
+        },
+        {
+            key: "bridge.token",
+            type: "secretRef",
+            required: true,
+            sensitive: true,
+            description: "Browser Reality Bridge extension token reference",
+        },
+        {
+            key: "taskApplication.endpoint",
+            type: "url",
+            required: true,
+            description: "Loopback Platform Host Task application endpoint",
+        },
+        {
+            key: "taskApplication.token",
+            type: "secretRef",
+            required: true,
+            sensitive: true,
+            description: "Platform Host Task application token reference",
+        },
+        {
+            key: "approvalApplication.endpoint",
+            type: "url",
+            required: true,
+            description: "Loopback Platform Host Approval application endpoint",
+        },
+        {
+            key: "approvalApplication.token",
+            type: "secretRef",
+            required: true,
+            sensitive: true,
+            description: "Platform Host Approval application token reference",
+        },
+        {
+            key: "chromeRuntimeModuleRef",
+            type: "moduleRef",
+            required: false,
+            description: "External resource module governing the Chrome runtime",
+            default: "chrome-runtime",
+        },
+        {
+            key: "carrierModuleRef",
+            type: "moduleRef",
+            required: false,
+            description: "External resource module governing the Custom GPT carrier",
+            default: "chatgpt-carrier",
+        },
+    ],
+    lifecycle: {
+        supported: ["describe", "preflight", "status", "verify", "doctor"],
+    },
+    verification: {
+        checks: [
+            {
+                id: "real-carrier-e3-e4",
+                description: "Real Chrome and ChatGPT E3/E4 evidence is present",
+                lifecycle: "verify",
+            },
+        ],
+    },
+    effects: [
+        {
+            kind: "external-resource",
+            description: "Package an MV3 extension that performs Execution-authorized Browser effects",
+            retention: "preserve",
+        },
+    ],
+    documentation: [
+        {
+            id: "overview",
+            path: "./README.md",
+            description: "Package-owned module overview",
+        },
+    ],
+};

package/dist/extension/background.d.ts

@@ -0,0 +1 @@
+export {};