@tomflow/proflow-dev-tunnel 0.1.16 → 0.1.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-dev-tunnel
 
+## 0.1.18
+
+### 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.17
+
+### Patch Changes
+
+- Add professional setup orchestration, Provider FAST/THINK input, recoverable managed Dev Tunnel provisioning, Browser installation guidance, and precise status diagnostics.
+
 ## 0.1.16
 
 ### Patch Changes

package/DOCS.md

@@ -27,7 +27,7 @@
 
 ## 使用方式
 
-运行 `platform setup --module dev-tunnel`；除登录失效时的 GitHub 浏览器授权外，不需要输入 Tunnel ID、端口或 URL。
+运行 `platform setup`；除登录失效时的 GitHub 浏览器授权外，不需要输入 Tunnel ID、端口或 URL。
 
 ## 职责边界与限制
 

package/SETUP.md

@@ -4,9 +4,9 @@
 
 Responsible: AI
 
-Interactive executable: `platform setup --module dev-tunnel`
+Interactive executable: `platform setup`
 
-Non-interactive executable: `pnpm exec -- proflow-dev-tunnel setup --workspace <path>`
+Non-interactive executable: `platform setup --workspace <path>`
 
 Required inputs: none
 
@@ -25,6 +25,6 @@ Automatic flow:
 → 持久化并发布 tunnelId/publicBaseUrl
 ```
 
-Verify: `pnpm exec -- proflow-dev-tunnel verify`
+Verify: `platform status`
 
 Success condition: `dev-tunnel.setupStatus=READY`.

package/dist/deployment/adapter.d.ts

@@ -1,9 +1,13 @@
 import { type ModuleCommandContext } from "@tomflow/proflow-module-contract";
 import { type DevTunnelAutomation, type DevTunnelRuntime } from "../src/resource-adapter.ts";
+type SetupPhase = "PENDING_CREATED" | "PORT_READY" | "HOST_READY" | "READY";
 type SetupState = {
-    contract: "proflow.dev-tunnel-setup.v1";
+    contract: "proflow.dev-tunnel-setup.v2";
     tunnelId: string;
-    publicBaseUrl: string;
+    phase: SetupPhase;
+    gatewayPort?: number;
+    publicBaseUrl?: string;
+    cliPath?: string;
 };
 type RuntimeFactory = (input: {
     command?: string;
@@ -15,6 +19,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
     automation?: DevTunnelAutomation;
     createRuntime?: RuntimeFactory;
     verifyPublicBaseUrl?: (publicBaseUrl: string) => Promise<void>;
+    resolveCli?: (workspaceRoot: string) => Promise<string>;
 }): {
     readonly install: (context: ModuleCommandContext) => Promise<{
         result: {
@@ -22,7 +27,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: never[];
     }>;
@@ -32,14 +37,14 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -56,7 +61,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "FAILED" | "RUNNING" | "STOPPED";
@@ -83,7 +88,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: {
                 docs: string;
             };
@@ -94,7 +99,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -110,7 +115,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: import("../src/resource-adapter.ts").DevTunnelObservation;
         };
         observedEffects: string[];
@@ -121,14 +126,14 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -143,7 +148,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -159,7 +164,7 @@ export declare function createDevTunnelBehaviorAdapter(dependencies?: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: SetupState;
         };
         observedEffects: string[];
@@ -172,7 +177,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: never[];
     }>;
@@ -182,14 +187,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -206,7 +211,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "FAILED" | "RUNNING" | "STOPPED";
@@ -233,7 +238,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: {
                 docs: string;
             };
@@ -244,7 +249,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -260,7 +265,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: import("../src/resource-adapter.ts").DevTunnelObservation;
         };
         observedEffects: string[];
@@ -271,14 +276,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.16";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -293,7 +298,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {
@@ -309,7 +314,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.16";
+            moduleVersion: "0.1.17";
             data: SetupState;
         };
         observedEffects: string[];

package/dist/deployment/adapter.js

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import { resolveDevTunnelCli } from "@tomflow/proflow-devtunnel-cli";
 import { readModuleSharedFacts, writeModuleSharedFacts, } from "@tomflow/proflow-module-contract";
 import { createDevTunnelAutomation, createDevTunnelRuntime, verifyProvisionedPublicBaseUrl, } from "../src/resource-adapter.js";
 import { descriptor } from "./descriptor.js";
@@ -18,15 +19,50 @@ const processFile = (context) => join(stateDir(context), "process.json");
 async function readState(context) {
     try {
         const raw = JSON.parse(await readFile(stateFile(context), "utf8"));
-        if (raw.contract !== "proflow.dev-tunnel-setup.v1" ||
-            typeof raw.tunnelId !== "string" ||
-            !raw.tunnelId ||
-            typeof raw.publicBaseUrl !== "string")
+        if (typeof raw.tunnelId !== "string" || !raw.tunnelId)
             return undefined;
-        const url = new URL(raw.publicBaseUrl);
-        if (url.protocol !== "https:")
+        if (raw.contract === "proflow.dev-tunnel-setup.v1" &&
+            typeof raw.publicBaseUrl === "string") {
+            const url = new URL(raw.publicBaseUrl);
+            if (url.protocol !== "https:")
+                return undefined;
+            return {
+                contract: "proflow.dev-tunnel-setup.v2",
+                tunnelId: raw.tunnelId,
+                phase: "READY",
+                publicBaseUrl: url.href,
+            };
+        }
+        if (raw.contract !== "proflow.dev-tunnel-setup.v2")
+            return undefined;
+        if (raw.phase !== "PENDING_CREATED" &&
+            raw.phase !== "PORT_READY" &&
+            raw.phase !== "HOST_READY" &&
+            raw.phase !== "READY")
             return undefined;
-        return raw;
+        const gatewayPort = raw.gatewayPort;
+        if (gatewayPort !== undefined &&
+            (!Number.isInteger(gatewayPort) ||
+                Number(gatewayPort) < 1 ||
+                Number(gatewayPort) > 65_535))
+            return undefined;
+        const publicBaseUrl = raw.publicBaseUrl;
+        const cliPath = raw.cliPath;
+        if (raw.phase === "READY") {
+            if (typeof publicBaseUrl !== "string")
+                return undefined;
+            const url = new URL(publicBaseUrl);
+            if (url.protocol !== "https:")
+                return undefined;
+        }
+        return {
+            contract: "proflow.dev-tunnel-setup.v2",
+            tunnelId: raw.tunnelId,
+            phase: raw.phase,
+            ...(typeof gatewayPort === "number" ? { gatewayPort } : {}),
+            ...(typeof publicBaseUrl === "string" ? { publicBaseUrl } : {}),
+            ...(typeof cliPath === "string" ? { cliPath } : {}),
+        };
     }
     catch {
         return undefined;
@@ -41,6 +77,7 @@ async function writeState(context, state) {
 }
 function runtime(context, state) {
     return createDevTunnelRuntime({
+        ...(state?.cliPath ? { command: state.cliPath } : {}),
         ...(state
             ? { tunnelId: state.tunnelId, publicBaseUrl: state.publicBaseUrl }
             : {}),
@@ -51,7 +88,7 @@ const baseBehaviorAdapter = {
     install: async (context) => {
         await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
         const state = await readState(context);
-        if (state)
+        if (state?.phase === "READY" && state.publicBaseUrl)
             await writeModuleSharedFacts(context, descriptor.moduleRef, {
                 tunnelId: state.tunnelId,
                 publicBaseUrl: state.publicBaseUrl,
@@ -113,7 +150,7 @@ const baseBehaviorAdapter = {
                                 code: "TUNNEL_SETUP_REQUIRED",
                                 message: "尚未完成持久 Tunnel 自动配置",
                                 relatedModuleRefs: [],
-                                nextCommand: "platform setup --module dev-tunnel",
+                                nextCommand: "platform setup",
                             },
                         ],
                     },
@@ -122,9 +159,8 @@ const baseBehaviorAdapter = {
             };
         }
         const rt = runtime(context, state);
-        const login = await rt.loginStatus();
         const observed = await rt.status();
-        const configured = state !== undefined && login === "LOGGED_IN";
+        const configured = state.phase === "READY" && typeof state.publicBaseUrl === "string";
         const runtimeStatus = observed.state === "RUNNING"
             ? "RUNNING"
             : observed.state === "STOPPED"
@@ -147,10 +183,10 @@ const baseBehaviorAdapter = {
                                     ? [
                                         {
                                             scope: "SETUP",
-                                            code: "TUNNEL_LOGIN_REQUIRED",
-                                            message: "Dev Tunnel CLI 尚未登录或配置未保存",
+                                            code: "TUNNEL_SETUP_INCOMPLETE",
+                                            message: `远程连接配置已保存，当前阶段 ${state.phase}；重新运行 Platform setup 将从此处恢复`,
                                             relatedModuleRefs: [],
-                                            nextCommand: "platform setup --module dev-tunnel",
+                                            nextCommand: "platform setup",
                                         },
                                     ]
                                     : []),
@@ -161,7 +197,7 @@ const baseBehaviorAdapter = {
                                             code: "TUNNEL_RUNTIME_FAILED",
                                             message: "Tunnel 运行状态检查失败",
                                             relatedModuleRefs: [],
-                                            nextCommand: "pnpm exec -- proflow-dev-tunnel verify",
+                                            nextCommand: "platform status",
                                         },
                                     ]
                                     : []),
@@ -184,7 +220,7 @@ const baseBehaviorAdapter = {
     }),
     start: async (context) => {
         const state = await readState(context);
-        if (!state)
+        if (state?.phase !== "READY" || !state.publicBaseUrl)
             return {
                 result: {
                     ...base,
@@ -321,18 +357,23 @@ const setupFailed = (error) => ({
     observedEffects: [],
 });
 export function createDevTunnelBehaviorAdapter(dependencies) {
-    const automation = dependencies?.automation ??
-        createDevTunnelAutomation({ command: "devtunnel" });
     const createRuntime = dependencies?.createRuntime ?? createDevTunnelRuntime;
     const verifyPublicBaseUrl = dependencies?.verifyPublicBaseUrl ?? verifyProvisionedPublicBaseUrl;
     return {
         ...baseBehaviorAdapter,
         setup: async (context) => {
             try {
+                const previous = await readState(context);
+                const cliPath = previous?.cliPath ??
+                    (dependencies?.automation
+                        ? "devtunnel"
+                        : await (dependencies?.resolveCli ??
+                            (async (workspaceRoot) => (await resolveDevTunnelCli({ workspaceRoot })).command))(context.workspaceRoot));
+                const automation = dependencies?.automation ??
+                    createDevTunnelAutomation({ command: cliPath });
                 await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
                 const port = gatewayPort(await readModuleSharedFacts(context, "agent-gateway"));
                 await automation.ensureLogin();
-                const previous = await readState(context);
                 let tunnelId;
                 let safeToStartNewHost = false;
                 const createAndVerifyTunnel = async () => {
@@ -340,6 +381,13 @@ export function createDevTunnelBehaviorAdapter(dependencies) {
                     const created = await automation.inspectTunnel(createdTunnelId);
                     if (created.state !== "EXISTS")
                         throw new Error("new Dev Tunnel could not be verified by show --json");
+                    await writeState(context, {
+                        contract: "proflow.dev-tunnel-setup.v2",
+                        tunnelId: createdTunnelId,
+                        phase: "PENDING_CREATED",
+                        gatewayPort: port,
+                        cliPath,
+                    });
                     return createdTunnelId;
                 };
                 if (previous) {
@@ -360,6 +408,13 @@ export function createDevTunnelBehaviorAdapter(dependencies) {
                     safeToStartNewHost = true;
                 }
                 await automation.ensurePort(tunnelId, port);
+                await writeState(context, {
+                    contract: "proflow.dev-tunnel-setup.v2",
+                    tunnelId,
+                    phase: "PORT_READY",
+                    gatewayPort: port,
+                    cliPath,
+                });
                 const host = createRuntime({
                     tunnelId,
                     processStateFile: processFile(context),
@@ -374,15 +429,25 @@ export function createDevTunnelBehaviorAdapter(dependencies) {
                         throw new Error("Dev Tunnel host did not reach RUNNING");
                     started = true;
                 }
+                await writeState(context, {
+                    contract: "proflow.dev-tunnel-setup.v2",
+                    tunnelId,
+                    phase: "HOST_READY",
+                    gatewayPort: port,
+                    cliPath,
+                });
                 const publicBaseUrl = await automation.discoverPublicBaseUrl(tunnelId, port);
                 const url = new URL(publicBaseUrl);
                 if (url.protocol !== "https:")
                     throw new Error("discovered publicBaseUrl must be HTTPS");
                 await verifyPublicBaseUrl(url.href);
                 const state = {
-                    contract: "proflow.dev-tunnel-setup.v1",
+                    contract: "proflow.dev-tunnel-setup.v2",
                     tunnelId,
+                    phase: "READY",
+                    gatewayPort: port,
                     publicBaseUrl: url.href,
+                    cliPath,
                 };
                 await writeState(context, state);
                 await writeModuleSharedFacts(context, descriptor.moduleRef, {

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "dev-tunnel";
     readonly packageName: "@tomflow/proflow-dev-tunnel";
-    readonly moduleVersion: "0.1.16";
+    readonly moduleVersion: "0.1.17";
     readonly kind: "external-resource";
     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: "dev-tunnel",
     packageName: "@tomflow/proflow-dev-tunnel",
-    moduleVersion: "0.1.16",
+    moduleVersion: "0.1.17",
     kind: "external-resource",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/resource-adapter.js

@@ -10,7 +10,17 @@ const START_CONFIRM_MS = 500;
 function defaultCommandRunner(command, args, options) {
     if (options?.interactive) {
         return new Promise((resolve) => {
-            const child = spawn(command, args, { stdio: "inherit" });
+            const child = spawn(command, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout?.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr?.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
             let timedOut = false;
             const timer = setTimeout(() => {
                 timedOut = true;
@@ -18,14 +28,14 @@ function defaultCommandRunner(command, args, options) {
             }, options.timeoutMs ?? 600_000);
             child.once("error", (error) => {
                 clearTimeout(timer);
-                resolve({ exitCode: null, stdout: "", stderr: error.message });
+                resolve({ exitCode: null, stdout, stderr: error.message });
             });
             child.once("exit", (code) => {
                 clearTimeout(timer);
                 resolve({
                     exitCode: timedOut ? null : code,
-                    stdout: "",
-                    stderr: timedOut ? "command timed out" : "",
+                    stdout,
+                    stderr: timedOut ? "command timed out" : stderr,
                 });
             });
         });
@@ -94,6 +104,9 @@ function parsePorts(input) {
     if (Array.isArray(input))
         return z.array(tunnelPortSchema).parse(input);
     if (typeof input === "object" && input !== null) {
+        const warning = Reflect.get(input, "warning");
+        if (typeof warning === "string" && /\bno ports found\b/i.test(warning))
+            return [];
         const ports = Reflect.get(input, "ports");
         if (Array.isArray(ports))
             return z.array(tunnelPortSchema).parse(ports);
@@ -391,14 +404,11 @@ export function createDevTunnelRuntime(input) {
             return "UNKNOWN";
         }
     };
-    const observe = async (state) => {
-        const login = await observeLogin();
-        return {
-            state,
-            login,
-            ...(publicBaseUrl === undefined ? {} : { publicBaseUrl }),
-        };
-    };
+    const observation = (state, login = "UNKNOWN") => ({
+        state,
+        login,
+        ...(publicBaseUrl === undefined ? {} : { publicBaseUrl }),
+    });
     const ownedPersistedPid = async () => {
         if (!processStateFile || !tunnelId)
             return undefined;
@@ -414,24 +424,24 @@ export function createDevTunnelRuntime(input) {
         command,
         async status() {
             if (await ownedPersistedPid())
-                return observe("RUNNING");
+                return observation("RUNNING");
             if (child?.pid && processAlive(child.pid))
-                return observe("RUNNING");
-            return observe("UNKNOWN");
+                return observation("RUNNING");
+            return observation("UNKNOWN");
         },
         loginStatus: () => observeLogin(),
         publicBaseUrl: () => publicBaseUrl,
         async start() {
             const login = await observeLogin();
             if (login !== "LOGGED_IN")
-                return observe("UNKNOWN");
+                return observation("UNKNOWN", login);
             if (tunnelId === undefined) {
                 throw new TypeError("tunnelId is required to host the configured persistent tunnel");
             }
             if (await ownedPersistedPid())
-                return observe("RUNNING");
+                return observation("RUNNING", login);
             if (child?.pid && processAlive(child.pid))
-                return observe("RUNNING");
+                return observation("RUNNING", login);
             const spawned = spawn(command, ["host", tunnelId], {
                 stdio: "ignore",
                 detached: true,
@@ -480,7 +490,7 @@ export function createDevTunnelRuntime(input) {
                 }
             }
             spawned.unref();
-            return observe("RUNNING");
+            return observation("RUNNING", login);
         },
         async stop() {
             const persistedPid = await ownedPersistedPid();
@@ -489,20 +499,20 @@ export function createDevTunnelRuntime(input) {
                 if (processStateFile)
                     await rm(processStateFile, { force: true });
                 child = undefined;
-                return observe("STOPPED");
+                return observation("STOPPED");
             }
             try {
                 process.kill(pid, "SIGTERM");
             }
             catch {
-                return observe("UNKNOWN");
+                return observation("UNKNOWN");
             }
             if (!(await waitForProcessExit(pid)))
-                return observe("UNKNOWN");
+                return observation("UNKNOWN");
             if (processStateFile)
                 await rm(processStateFile, { force: true });
             child = undefined;
-            return observe("STOPPED");
+            return observation("STOPPED");
         },
         async restart() {
             const stopped = await this.stop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-dev-tunnel",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -23,10 +23,11 @@
   ],
   "dependencies": {
     "zod": "4.1.12",
+    "@tomflow/proflow-devtunnel-cli": "^0.1.0",
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.12"
+    "@tomflow/proflow-deployment-conformance": "^0.1.13"
   },
   "description": "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "dev-tunnel",
 	"packageName": "@tomflow/proflow-dev-tunnel",
-	"moduleVersion": "0.1.16",
+	"moduleVersion": "0.1.18",
 	"kind": "external-resource",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",