@tomflow/proflow-dev-tunnel 0.1.10 → 0.1.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-dev-tunnel
 
+## 0.1.11
+
+### Patch Changes
+
+- Improve terminal progress and localized status output, publish readable Chinese module docs, and add guided setup assistants for external resources.
+
 ## 0.1.10
 
 ### Patch Changes

package/DOCS.md

@@ -1,27 +1,13 @@
-# @tomflow/proflow-dev-tunnel — Module Docs
+# dev-tunnel
 
-Module ref: `dev-tunnel`  
-Domain: `deployment-governance`  
-Kind: `external-resource`
+Dev Tunnel（开发隧道）把本机 Agent Gateway 安全地映射为公开 HTTPS 地址，供 Custom GPT Actions 调用。
 
-Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.
+## 什么时候需要
 
-## Standard management surface
+当 ProFlow 在本机运行，而 Custom GPT 需要从互联网访问本机网关时使用。
 
-`install / uninstall / status / setup / docs / start / stop`
+## 如何配置
 
-## Provides
+运行 `proflow-dev-tunnel setup`。向导会检查 `devtunnel` 工具和登录状态，列出现有 Tunnel（隧道），协助选择或创建持久隧道，然后保存并验证公开地址。
 
-- None.
-
-## Requires
-
-- None.
-
-## Public setup inputs
-
-- None. Deterministic/private values and cross-Module shared facts are not public configuration.
-
-## Ownership boundary
-
-Module business APIs and any module-specific extra commands remain package-owned. Platform does not proxy or interpret them. Current human/external preparation is documented in `SETUP.md`.
+公开地址会被外部服务访问，请只暴露 ProFlow 网关需要的端口。

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.11";
         };
         observedEffects: never[];
     }>;
@@ -16,14 +16,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.11";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             ok: false;
             status: "FAILED";
             error: {
@@ -40,7 +40,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "FAILED" | "RUNNING" | "STOPPED";
@@ -52,7 +52,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -90,7 +90,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.11";
         };
         observedEffects: never[];
     }>;
@@ -100,7 +100,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             data: {
                 docs: string;
             };
@@ -111,7 +111,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             ok: false;
             status: "FAILED";
             error: {
@@ -127,7 +127,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             data: import("../src/resource-adapter.ts").DevTunnelObservation;
         };
         observedEffects: string[];
@@ -138,14 +138,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "dev-tunnel";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.11";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "dev-tunnel";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             ok: false;
             status: "FAILED";
             error: {

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.10";
+    readonly moduleVersion: "0.1.11";
     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.10",
+    moduleVersion: "0.1.11",
     kind: "external-resource",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { spawnSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
 import { behaviorAdapter } from "../deployment/adapter.js";
 function option(args, name) {
@@ -15,8 +16,41 @@ async function inputs(args) {
             output: process.stdout,
         });
         try {
-            tunnelId ||= await prompt.question("Tunnel ID：");
-            publicBaseUrl ||= await prompt.question("公开 HTTPS URL：");
+            process.stdout.write("\nDev Tunnel 配置\n\n  脚本将检查 CLI、完成 Microsoft 登录，并协助选择或创建持久 Tunnel（隧道）。\n\n");
+            const version = spawnSync("devtunnel", ["--version"], {
+                stdio: "ignore",
+            });
+            if (version.error || version.status !== 0)
+                throw new Error("未找到 devtunnel CLI。请先按 Microsoft Dev Tunnels 文档安装，然后重新运行本命令");
+            process.stdout.write("✓ 已找到 devtunnel CLI\n");
+            let login = spawnSync("devtunnel", ["user", "show"], { stdio: "ignore" });
+            if (login.status !== 0) {
+                process.stdout.write("◆ 需要登录 Microsoft 账号，正在启动登录流程…\n");
+                login = spawnSync("devtunnel", ["user", "login"], { stdio: "inherit" });
+                if (login.status !== 0)
+                    throw new Error("Microsoft 登录未完成");
+            }
+            process.stdout.write("✓ Microsoft 登录已就绪\n\n现有持久 Tunnel：\n");
+            spawnSync("devtunnel", ["list"], { stdio: "inherit" });
+            tunnelId ||= await prompt.question("\n◆ 输入要使用的 Tunnel ID（不存在时可创建）\n> ");
+            const existing = spawnSync("devtunnel", ["show", tunnelId], {
+                stdio: "ignore",
+            });
+            if (existing.status !== 0) {
+                const answer = await prompt.question(`未找到 ${tunnelId}，现在创建持久 Tunnel？[Y/n] `);
+                if (answer.trim() && !/^y(es)?$/i.test(answer.trim()))
+                    throw new Error("尚未选择可用的持久 Tunnel");
+                const created = spawnSync("devtunnel", ["create", tunnelId], {
+                    stdio: "inherit",
+                });
+                if (created.status !== 0)
+                    throw new Error("创建持久 Tunnel 失败");
+                process.stdout.write("✓ 持久 Tunnel 已创建\n");
+            }
+            else
+                process.stdout.write("✓ 已选择现有持久 Tunnel\n");
+            process.stdout.write("\n请为 Platform Host 的本地端口建立映射并启动 Tunnel；devtunnel 会显示公开 HTTPS 地址。\n");
+            publicBaseUrl ||= await prompt.question("◆ 粘贴公开 HTTPS URL\n> ");
         }
         finally {
             prompt.close();
@@ -33,8 +67,8 @@ if (command === "setup") {
         input: await inputs(args),
     });
     process.stdout.write(result.result.status === "SUCCEEDED"
-        ? "Tunnel 配置已保存。\n"
-        : `Tunnel 尚未就绪：${result.result.actionRequired.description}\n`);
+        ? "\n✓ Tunnel 配置已保存\n✓ 登录与公开地址验证通过\n"
+        : `\n✕ Tunnel 尚未就绪\n  ${result.result.actionRequired.description}\n`);
 }
 else if (command === "verify") {
     const result = await behaviorAdapter.status({ workspaceRoot });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-dev-tunnel",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -22,10 +22,10 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.9"
+    "@tomflow/proflow-module-contract": "^0.1.10"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.7"
+    "@tomflow/proflow-deployment-conformance": "^0.1.8"
   },
   "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.10",
+	"moduleVersion": "0.1.11",
 	"kind": "external-resource",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",