@tomflow/proflow-execution-runtime 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-execution-runtime
 
+## 0.1.13
+
+### Patch Changes
+
+- Distinguish dependency blocking from verified failure, expose Module-owned status diagnostics, remove automatic docs paging, consolidate start checks, add contextual help, and clarify uninstall output.
+
+## 0.1.12
+
+### Patch Changes
+
+- Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
+
 ## 0.1.11
 
 ### Patch Changes

package/DOCS.md

@@ -1,11 +1,39 @@
-# execution-runtime
+# execution-runtime — 执行服务
 
-Execution Runtime（执行运行时）是 ProFlow 真实操作的控制中心。它负责审批、幂等、执行调度、结果记录和异常恢复。
+## 模块定位与作用
 
-## 使用前提
+接收标准 Execution Intent，选择 Local 或 Browser Executor，管理执行、恢复和 Evidence，并向其他领域提供唯一真实副作用入口。
 
-本机执行器、浏览器执行器、模型运行时和 Platform Host 提供的身份信息必须就绪。缺少上游事实时，状态会显示失败并由 `platform setup` 给出原因。
+## 主要能力
 
-## 运行方式
+- 校验 Intent、权限、幂等键和执行状态。
+- 路由本地与浏览器执行能力，统一结果与失败恢复。
+- 持久化执行记录和 Evidence，提供认证的本地服务接口。
 
-配置完成后使用 `platform start` 启动。不要直接修改它在 `.proflow` 中维护的数据库和凭据。
+## 提供的 API 与 Public Contract
+
+- 提供 `execution` Contract，版本 `1.0.0`。
+- 对外提供请求执行、查询结果和读取证据的应用接口。
+
+## 依赖的 Module、Contract 和外部资源
+
+- 依赖 `execution-local`，兼容版本 `>=1.0.0 <2.0.0`。
+- Browser Effect 还需要 execution-browser-extension 发布的 Executor shared fact。
+
+## 运行形态与生命周期
+
+类型为 Service，配置 READY 后由 `platform start` 启动独立认证进程。
+
+## 使用方式
+
+先完成 Local、Browser 和上游 shared facts 配置，再由 Platform Host 或 Agent Gateway 通过公开 Contract 调用。
+
+## 职责边界与限制
+
+不拥有 Task 状态、不让 Browser 成为第二个 durable runtime，也不把模型判断当成执行成功证据。
+
+## 术语
+
+- Executor（执行器）：实现某类真实 Effect 的受控端口。
+- Idempotency（幂等性）：相同请求重试不会重复产生不可控副作用。
+- Recovery（恢复）：在中断或结果不确定后重新观察并安全继续。

package/SETUP.md

@@ -1,10 +1,28 @@
 # @tomflow/proflow-execution-runtime — Module Setup
 
-## STEP-EXECUTION-RUNTIME-01 — 完成模块自动配置
+## STEP-EXECUTION-RUNTIME-01 — 准备平台主服务
 
 Responsible: AI
-Interactive executable: `platform setup --module execution-runtime`
-Non-interactive executable: `platform setup --module execution-runtime`
+Interactive executable: `platform setup --module platform-host`
+Non-interactive executable: `platform setup --module platform-host`
 Required inputs: none
 Verify: `platform status`
-Success condition: `execution-runtime.setupStatus=READY`.
+Success condition: `platform-host.setupStatus=READY`.
+
+## STEP-EXECUTION-RUNTIME-02 — 准备模型运行时
+
+Responsible: AI
+Interactive executable: `platform setup --module model-runtime`
+Non-interactive executable: `platform setup --module model-runtime`
+Required inputs: configured FAST and REASON models
+Verify: `platform status`
+Success condition: `model-runtime.setupStatus=READY`.
+
+## STEP-EXECUTION-RUNTIME-03 — 准备浏览器执行器
+
+Responsible: USER
+Interactive executable: `platform setup --module execution-browser-extension`
+Non-interactive executable: `platform setup --module execution-browser-extension`
+Required inputs: loaded Chrome Extension ID
+Verify: `platform status`
+Success condition: `execution-browser-extension.setupStatus=READY`.

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             data: {
                 endpoint: string;
                 transportCredentialFile: string;
@@ -23,7 +23,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.11";
+            readonly moduleVersion: "0.1.13";
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
     }>;
@@ -33,10 +33,17 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             data: {
-                setupStatus: "FAILED" | "READY";
+                setupStatus: "BLOCKED" | "READY";
                 runtimeStatus: "RUNNING" | "STOPPED";
+                issues?: {
+                    scope: "SETUP";
+                    code: string;
+                    message: string;
+                    relatedModuleRefs: string[];
+                    nextCommand: string;
+                }[];
             };
         };
         observedEffects: never[];
@@ -47,11 +54,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.11";
+            readonly moduleVersion: "0.1.13";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             ok: false;
             status: "FAILED";
             error: {
@@ -62,17 +69,45 @@ export declare const behaviorAdapter: {
             data: {
                 readonly steps: readonly [{
                     readonly id: "STEP-EXECUTION-RUNTIME-01";
-                    readonly title: "等待上游服务信息";
+                    readonly title: "等待 Platform Host";
                     readonly state: "BLOCKED";
                     readonly responsible: "EXTERNAL";
                     readonly execution: {
-                        readonly interactive: "platform setup --module execution-runtime";
-                        readonly nonInteractive: "platform setup --module execution-runtime";
+                        readonly interactive: "platform setup --module platform-host";
+                        readonly nonInteractive: "platform setup --module platform-host";
                     };
                     readonly requiredInputs: readonly [];
                     readonly verify: "platform status";
                     readonly successCondition: "配置状态变为“已就绪”";
-                    readonly blockedReason: "Platform Host、Model Runtime 或 Browser Executor 尚未就绪";
+                    readonly blockedReason: "platform-host 尚未发布 endpoint 与 identityTokenFile";
+                }, {
+                    readonly id: "STEP-EXECUTION-RUNTIME-02";
+                    readonly title: "等待 Model Runtime";
+                    readonly description: "Execution 的模型决策入口尚不可用。";
+                    readonly state: "BLOCKED";
+                    readonly responsible: "EXTERNAL";
+                    readonly execution: {
+                        readonly interactive: "platform setup --module model-runtime";
+                        readonly nonInteractive: "platform setup --module model-runtime";
+                    };
+                    readonly requiredInputs: readonly [];
+                    readonly verify: "platform status";
+                    readonly successCondition: "model-runtime 已发布 endpoint 与 transportCredentialFile";
+                    readonly blockedReason: "model-runtime 尚未就绪";
+                }, {
+                    readonly id: "STEP-EXECUTION-RUNTIME-03";
+                    readonly title: "等待 Browser Executor";
+                    readonly description: "Browser Effect 配置尚不可用。";
+                    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 requiredInputs: readonly [];
+                    readonly verify: "platform status";
+                    readonly successCondition: "execution-browser-extension 已发布 browserExecutorConfigPath";
+                    readonly blockedReason: "execution-browser-extension 尚未就绪";
                 }];
             };
         };
@@ -84,7 +119,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             data: {
                 docs: string;
             };
@@ -97,7 +132,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             data: unknown;
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
@@ -105,7 +140,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             ok: false;
             status: "FAILED";
             error: {
@@ -122,7 +157,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.11";
+            readonly moduleVersion: "0.1.13";
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
     } | {
@@ -131,11 +166,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.11";
+            readonly moduleVersion: "0.1.13";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.11";
+            moduleVersion: "0.1.13";
             ok: false;
             status: "FAILED";
             error: {

package/dist/deployment/adapter.js

@@ -15,17 +15,47 @@ const blockedSetupPlan = {
     steps: [
         {
             id: "STEP-EXECUTION-RUNTIME-01",
-            title: "等待上游服务信息",
+            title: "等待 Platform Host",
             state: "BLOCKED",
             responsible: "EXTERNAL",
             execution: {
-                interactive: "platform setup --module execution-runtime",
-                nonInteractive: "platform setup --module execution-runtime",
+                interactive: "platform setup --module platform-host",
+                nonInteractive: "platform setup --module platform-host",
             },
             requiredInputs: [],
             verify: "platform status",
             successCondition: "配置状态变为“已就绪”",
-            blockedReason: "Platform Host、Model Runtime 或 Browser Executor 尚未就绪",
+            blockedReason: "platform-host 尚未发布 endpoint 与 identityTokenFile",
+        },
+        {
+            id: "STEP-EXECUTION-RUNTIME-02",
+            title: "等待 Model Runtime",
+            description: "Execution 的模型决策入口尚不可用。",
+            state: "BLOCKED",
+            responsible: "EXTERNAL",
+            execution: {
+                interactive: "platform setup --module model-runtime",
+                nonInteractive: "platform setup --module model-runtime",
+            },
+            requiredInputs: [],
+            verify: "platform status",
+            successCondition: "model-runtime 已发布 endpoint 与 transportCredentialFile",
+            blockedReason: "model-runtime 尚未就绪",
+        },
+        {
+            id: "STEP-EXECUTION-RUNTIME-03",
+            title: "等待 Browser Executor",
+            description: "Browser Effect 配置尚不可用。",
+            state: "BLOCKED",
+            responsible: "EXTERNAL",
+            execution: {
+                interactive: "platform setup --module execution-browser-extension",
+                nonInteractive: "platform setup --module execution-browser-extension",
+            },
+            requiredInputs: [],
+            verify: "platform status",
+            successCondition: "execution-browser-extension 已发布 browserExecutorConfigPath",
+            blockedReason: "execution-browser-extension 尚未就绪",
         },
     ],
 };
@@ -143,20 +173,38 @@ export const behaviorAdapter = {
                 : [],
         };
     },
-    status: async (context) => ({
-        result: {
-            ...base,
-            data: {
-                setupStatus: (await dependencies(context))
-                    ? "READY"
-                    : "FAILED",
-                runtimeStatus: (await running(context))
-                    ? "RUNNING"
-                    : "STOPPED",
+    status: async (context) => {
+        const ready = await dependencies(context);
+        return {
+            result: {
+                ...base,
+                data: {
+                    setupStatus: ready ? "READY" : "BLOCKED",
+                    runtimeStatus: (await running(context))
+                        ? "RUNNING"
+                        : "STOPPED",
+                    ...(ready
+                        ? {}
+                        : {
+                            issues: [
+                                {
+                                    scope: "SETUP",
+                                    code: "UPSTREAM_NOT_READY",
+                                    message: "等待 platform-host、model-runtime 与 execution-browser-extension 发布运行所需信息",
+                                    relatedModuleRefs: [
+                                        "platform-host",
+                                        "model-runtime",
+                                        "execution-browser-extension",
+                                    ],
+                                    nextCommand: "platform setup --module model-runtime",
+                                },
+                            ],
+                        }),
+                },
             },
-        },
-        observedEffects: [],
-    }),
+            observedEffects: [],
+        };
+    },
     setup: async (context) => ({
         result: (await dependencies(context))
             ? base

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "execution-runtime";
     readonly packageName: "@tomflow/proflow-execution-runtime";
-    readonly moduleVersion: "0.1.11";
+    readonly moduleVersion: "0.1.13";
     readonly kind: "service";
     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-runtime",
     packageName: "@tomflow/proflow-execution-runtime",
-    moduleVersion: "0.1.11",
+    moduleVersion: "0.1.13",
     kind: "service",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-runtime",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -24,14 +24,14 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-browser-extension": "^0.1.9",
-    "@tomflow/proflow-execution-contracts": "^0.1.8",
-    "@tomflow/proflow-module-contract": "^0.1.10",
-    "@tomflow/proflow-execution-local": "^0.1.9",
-    "@tomflow/proflow-model-contracts": "^0.1.8"
+    "@tomflow/proflow-execution-browser-extension": "^0.1.12",
+    "@tomflow/proflow-execution-contracts": "^0.1.9",
+    "@tomflow/proflow-execution-local": "^0.1.11",
+    "@tomflow/proflow-model-contracts": "^0.1.9",
+    "@tomflow/proflow-module-contract": "^0.1.12"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.8"
+    "@tomflow/proflow-deployment-conformance": "^0.1.10"
   },
   "description": "Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-runtime",
 	"packageName": "@tomflow/proflow-execution-runtime",
-	"moduleVersion": "0.1.11",
+	"moduleVersion": "0.1.13",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",