@tomflow/proflow-platform-host 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # @tomflow/proflow-platform-host
2
2
 
3
+ ## 0.1.12
4
+
5
+ ### Patch Changes
6
+
7
+ - 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.
8
+
9
+ ## 0.1.11
10
+
11
+ ### Patch Changes
12
+
13
+ - Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
14
+
3
15
  ## 0.1.10
4
16
 
5
17
  ### Patch Changes
package/DOCS.md CHANGED
@@ -1,11 +1,37 @@
1
- # platform-host
1
+ # platform-host — 平台组合服务
2
2
 
3
- Platform Host(平台主服务)把 Task、Agent、Execution 和 Model 等模块组合成一个本机应用,并提供受认证的本地接口。
3
+ ## 模块定位与作用
4
4
 
5
- ## 主要职责
5
+ ProFlow 的本地 Composition Root(组合根),把 Task、Agent、Execution 和 Model 的公开端口装配为受认证的本地 HTTP 服务。
6
6
 
7
- - 装配各领域运行时并管理启动与停止。
8
- - 提供本机 HTTP 接口和健康状态。
9
- - 把请求转给真正拥有数据和规则的模块。
7
+ ## 主要能力
10
8
 
11
- 它不保存第二份业务数据,也不负责浏览器中的 Observer(观察器)循环。
9
+ - 构造领域应用服务、Store 和跨域 Public Contract 适配器。
10
+ - 提供本地认证、健康检查和共享事实。
11
+ - 统一管理组合进程的启动、停止和恢复。
12
+
13
+ ## 提供的 API 与 Public Contract
14
+
15
+ - 提供 `platform-host` Contract,版本 `1.0.0`。
16
+ - 对 Agent Gateway 和 Browser Extension 暴露受认证的本地应用 API。
17
+
18
+ ## 依赖的 Module、Contract 和外部资源
19
+
20
+ - 依赖 `task-orchestration`、`agent-runtime`、`execution` 和 `model-inference`,兼容版本均为 `>=1.0.0 <2.0.0`。
21
+
22
+ ## 运行形态与生命周期
23
+
24
+ 类型为 Service,由 `platform start` 启动独立本地进程并监听 loopback 地址。
25
+
26
+ ## 使用方式
27
+
28
+ 所有依赖 Module READY 后通过 Platform 生命周期启动;下游从 shared facts 获取端点和凭据路径。
29
+
30
+ ## 职责边界与限制
31
+
32
+ 不成为第五领域的业务 Owner,不暴露数据库,不把公网入口或外部 Provider 配置收进自身私有配置。
33
+
34
+ ## 术语
35
+
36
+ - Composition Root(组合根):集中创建并连接应用组件的工程入口。
37
+ - Loopback(本机回环):仅当前主机可访问的网络地址。
@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
6
6
  ok: true;
7
7
  status: "SUCCEEDED";
8
8
  moduleRef: "platform-host";
9
- moduleVersion: "0.1.10";
9
+ moduleVersion: "0.1.12";
10
10
  data: {
11
11
  endpoint: string;
12
12
  stateRoot: string;
@@ -24,7 +24,7 @@ export declare const behaviorAdapter: {
24
24
  readonly ok: true;
25
25
  readonly status: "SUCCEEDED";
26
26
  readonly moduleRef: "platform-host";
27
- readonly moduleVersion: "0.1.10";
27
+ readonly moduleVersion: "0.1.12";
28
28
  };
29
29
  observedEffects: string[];
30
30
  }>;
@@ -34,10 +34,17 @@ export declare const behaviorAdapter: {
34
34
  ok: true;
35
35
  status: "SUCCEEDED";
36
36
  moduleRef: "platform-host";
37
- moduleVersion: "0.1.10";
37
+ moduleVersion: "0.1.12";
38
38
  data: {
39
- setupStatus: "FAILED" | "READY";
39
+ setupStatus: "BLOCKED" | "READY";
40
40
  runtimeStatus: "RUNNING" | "STOPPED";
41
+ issues?: {
42
+ scope: "SETUP";
43
+ code: string;
44
+ message: string;
45
+ relatedModuleRefs: string[];
46
+ nextCommand: string;
47
+ }[];
41
48
  };
42
49
  };
43
50
  observedEffects: never[];
@@ -48,11 +55,11 @@ export declare const behaviorAdapter: {
48
55
  readonly ok: true;
49
56
  readonly status: "SUCCEEDED";
50
57
  readonly moduleRef: "platform-host";
51
- readonly moduleVersion: "0.1.10";
58
+ readonly moduleVersion: "0.1.12";
52
59
  } | {
53
60
  contract: "deployment.result.v1";
54
61
  moduleRef: "platform-host";
55
- moduleVersion: "0.1.10";
62
+ moduleVersion: "0.1.12";
56
63
  ok: false;
57
64
  status: "FAILED";
58
65
  error: {
@@ -69,7 +76,7 @@ export declare const behaviorAdapter: {
69
76
  ok: true;
70
77
  status: "SUCCEEDED";
71
78
  moduleRef: "platform-host";
72
- moduleVersion: "0.1.10";
79
+ moduleVersion: "0.1.12";
73
80
  data: {
74
81
  docs: string;
75
82
  };
@@ -82,7 +89,7 @@ export declare const behaviorAdapter: {
82
89
  ok: true;
83
90
  status: "SUCCEEDED";
84
91
  moduleRef: "platform-host";
85
- moduleVersion: "0.1.10";
92
+ moduleVersion: "0.1.12";
86
93
  data: {
87
94
  host: string;
88
95
  port: number;
@@ -93,7 +100,7 @@ export declare const behaviorAdapter: {
93
100
  result: {
94
101
  contract: "deployment.result.v1";
95
102
  moduleRef: "platform-host";
96
- moduleVersion: "0.1.10";
103
+ moduleVersion: "0.1.12";
97
104
  ok: false;
98
105
  status: "FAILED";
99
106
  error: {
@@ -110,7 +117,7 @@ export declare const behaviorAdapter: {
110
117
  readonly ok: true;
111
118
  readonly status: "SUCCEEDED";
112
119
  readonly moduleRef: "platform-host";
113
- readonly moduleVersion: "0.1.10";
120
+ readonly moduleVersion: "0.1.12";
114
121
  };
115
122
  observedEffects: string[];
116
123
  } | {
@@ -119,11 +126,11 @@ export declare const behaviorAdapter: {
119
126
  readonly ok: true;
120
127
  readonly status: "SUCCEEDED";
121
128
  readonly moduleRef: "platform-host";
122
- readonly moduleVersion: "0.1.10";
129
+ readonly moduleVersion: "0.1.12";
123
130
  } | {
124
131
  contract: "deployment.result.v1";
125
132
  moduleRef: "platform-host";
126
- moduleVersion: "0.1.10";
133
+ moduleVersion: "0.1.12";
127
134
  ok: false;
128
135
  status: "FAILED";
129
136
  error: {
@@ -118,20 +118,34 @@ export const behaviorAdapter = {
118
118
  observedEffects: service ? ["Manage the platform-host process"] : [],
119
119
  };
120
120
  },
121
- status: async (context) => ({
122
- result: {
123
- ...base,
124
- data: {
125
- setupStatus: (await dependencies(context))
126
- ? "READY"
127
- : "FAILED",
128
- runtimeStatus: (await running(context))
129
- ? "RUNNING"
130
- : "STOPPED",
121
+ status: async (context) => {
122
+ const ready = await dependencies(context);
123
+ return {
124
+ result: {
125
+ ...base,
126
+ data: {
127
+ setupStatus: ready ? "READY" : "BLOCKED",
128
+ runtimeStatus: (await running(context))
129
+ ? "RUNNING"
130
+ : "STOPPED",
131
+ ...(ready
132
+ ? {}
133
+ : {
134
+ issues: [
135
+ {
136
+ scope: "SETUP",
137
+ code: "UPSTREAM_NOT_READY",
138
+ message: "等待 Execution 与 Model Runtime 发布服务信息",
139
+ relatedModuleRefs: ["execution-runtime", "model-runtime"],
140
+ nextCommand: "platform setup --module model-runtime",
141
+ },
142
+ ],
143
+ }),
144
+ },
131
145
  },
132
- },
133
- observedEffects: [],
134
- }),
146
+ observedEffects: [],
147
+ };
148
+ },
135
149
  setup: async (context) => ({
136
150
  result: (await dependencies(context))
137
151
  ? base
@@ -3,7 +3,7 @@ export declare const descriptor: {
3
3
  readonly contractVersion: "1.0.0";
4
4
  readonly moduleRef: "platform-host";
5
5
  readonly packageName: "@tomflow/proflow-platform-host";
6
- readonly moduleVersion: "0.1.10";
6
+ readonly moduleVersion: "0.1.12";
7
7
  readonly kind: "service";
8
8
  readonly templateVersion: "1.0.0";
9
9
  readonly platformCompatibility: ">=1.0.0 <2.0.0";
@@ -3,7 +3,7 @@ export const descriptor = {
3
3
  contractVersion: "1.0.0",
4
4
  moduleRef: "platform-host",
5
5
  packageName: "@tomflow/proflow-platform-host",
6
- moduleVersion: "0.1.10",
6
+ moduleVersion: "0.1.12",
7
7
  kind: "service",
8
8
  templateVersion: "1.0.0",
9
9
  platformCompatibility: ">=1.0.0 <2.0.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tomflow/proflow-platform-host",
3
- "version": "0.1.10",
3
+ "version": "0.1.12",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -24,19 +24,19 @@
24
24
  ],
25
25
  "dependencies": {
26
26
  "zod": "4.1.12",
27
- "@tomflow/proflow-agent-runtime": "^0.1.8",
28
- "@tomflow/proflow-module-contract": "^0.1.10",
29
- "@tomflow/proflow-execution-browser-extension": "^0.1.9",
30
- "@tomflow/proflow-task-store-sqlite": "^0.1.8",
31
- "@tomflow/proflow-task-migration-runner": "^0.1.8",
32
- "@tomflow/proflow-task-orchestration": "^0.1.7",
33
- "@tomflow/proflow-execution-contracts": "^0.1.8"
27
+ "@tomflow/proflow-module-contract": "^0.1.12",
28
+ "@tomflow/proflow-task-migration-runner": "^0.1.10",
29
+ "@tomflow/proflow-task-orchestration": "^0.1.8",
30
+ "@tomflow/proflow-execution-browser-extension": "^0.1.12",
31
+ "@tomflow/proflow-agent-runtime": "^0.1.9",
32
+ "@tomflow/proflow-task-store-sqlite": "^0.1.10",
33
+ "@tomflow/proflow-execution-contracts": "^0.1.9"
34
34
  },
35
35
  "devDependencies": {
36
- "@tomflow/proflow-agent-gateway": "^0.1.10",
37
- "@tomflow/proflow-deployment-conformance": "^0.1.8",
38
- "@tomflow/proflow-execution-runtime": "^0.1.11",
39
- "@tomflow/proflow-model-runtime": "^0.1.11"
36
+ "@tomflow/proflow-agent-gateway": "^0.1.12",
37
+ "@tomflow/proflow-deployment-conformance": "^0.1.10",
38
+ "@tomflow/proflow-model-runtime": "^0.1.14",
39
+ "@tomflow/proflow-execution-runtime": "^0.1.13"
40
40
  },
41
41
  "description": "Provides the ProFlow local application composition root that binds Task, Agent, Execution and Model owner transports.",
42
42
  "keywords": [
@@ -3,7 +3,7 @@
3
3
  "contractVersion": "1.0.0",
4
4
  "moduleRef": "platform-host",
5
5
  "packageName": "@tomflow/proflow-platform-host",
6
- "moduleVersion": "0.1.10",
6
+ "moduleVersion": "0.1.12",
7
7
  "kind": "service",
8
8
  "templateVersion": "1.0.0",
9
9
  "platformCompatibility": ">=1.0.0 <2.0.0",