@tomflow/proflow-execution-runtime 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-execution-runtime
 
+## 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
+
+- 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,39 @@
-# @tomflow/proflow-execution-runtime — Module Docs
+# execution-runtime — 执行服务
 
-Module ref: `execution-runtime`  
-Domain: `execution`  
-Kind: `service`
+## 模块定位与作用
 
-Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports.
+接收标准 Execution Intent，选择 Local 或 Browser Executor，管理执行、恢复和 Evidence，并向其他领域提供唯一真实副作用入口。
 
-## Standard management surface
+## 主要能力
 
-`install / uninstall / status / setup / docs / start / stop`
+- 校验 Intent、权限、幂等键和执行状态。
+- 路由本地与浏览器执行能力，统一结果与失败恢复。
+- 持久化执行记录和 Evidence，提供认证的本地服务接口。
 
-## Provides
+## 提供的 API 与 Public Contract
 
-- `execution` `1.0.0`
+- 提供 `execution` Contract，版本 `1.0.0`。
+- 对外提供请求执行、查询结果和读取证据的应用接口。
 
-## Requires
+## 依赖的 Module、Contract 和外部资源
 
-- `execution-local` `>=1.0.0 <2.0.0`
+- 依赖 `execution-local`，兼容版本 `>=1.0.0 <2.0.0`。
+- Browser Effect 还需要 execution-browser-extension 发布的 Executor shared fact。
 
-## Public setup inputs
+## 运行形态与生命周期
 
-- None. Deterministic/private values and cross-Module shared facts are not public configuration.
+类型为 Service，配置 READY 后由 `platform start` 启动独立认证进程。
 
-## 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`.
+先完成 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.10";
+            moduleVersion: "0.1.12";
             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.10";
+            readonly moduleVersion: "0.1.12";
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
     }>;
@@ -33,7 +33,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             data: {
                 setupStatus: "FAILED" | "READY";
                 runtimeStatus: "RUNNING" | "STOPPED";
@@ -47,11 +47,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.12";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             ok: false;
             status: "FAILED";
             error: {
@@ -62,17 +62,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 +112,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             data: {
                 docs: string;
             };
@@ -97,7 +125,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             data: unknown;
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
@@ -105,7 +133,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             ok: false;
             status: "FAILED";
             error: {
@@ -122,7 +150,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.12";
         };
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
     } | {
@@ -131,11 +159,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.10";
+            readonly moduleVersion: "0.1.12";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.12";
             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 尚未就绪",
         },
     ],
 };

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.10";
+    readonly moduleVersion: "0.1.12";
     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.10",
+    moduleVersion: "0.1.12",
     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.10",
+  "version": "0.1.12",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -24,14 +24,14 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-browser-extension": "^0.1.8",
-    "@tomflow/proflow-execution-local": "^0.1.8",
-    "@tomflow/proflow-module-contract": "^0.1.9",
-    "@tomflow/proflow-model-contracts": "^0.1.7",
-    "@tomflow/proflow-execution-contracts": "^0.1.7"
+    "@tomflow/proflow-execution-browser-extension": "^0.1.11",
+    "@tomflow/proflow-execution-contracts": "^0.1.9",
+    "@tomflow/proflow-module-contract": "^0.1.11",
+    "@tomflow/proflow-model-contracts": "^0.1.9",
+    "@tomflow/proflow-execution-local": "^0.1.10"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.7"
+    "@tomflow/proflow-deployment-conformance": "^0.1.9"
   },
   "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.10",
+	"moduleVersion": "0.1.12",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",