@tomflow/proflow-platform-host 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @tomflow/proflow-platform-host
+
+## 0.1.23
+
+### Patch Changes
+
+- Close the Real-3 runtime reconciliation, health, browser effect-result boundary, observer pagination, and standalone execution-runtime configuration gaps for final human acceptance.

package/DOCS.md

@@ -17,7 +17,8 @@ ProFlow 的本地 Composition Root（组合根），把 Task、Agent、Execution
 
 ## 依赖的 Module、Contract 和外部资源
 
-- 依赖 `task-orchestration`、`agent-runtime`、`execution` 和 `model-inference`，兼容版本均为 `>=1.0.0 <2.0.0`。
+- 启动依赖只包含 `local-tool-bridge`、`task-orchestration` 和 `agent-runtime`，兼容版本均为 `>=1.0.0 <2.0.0`。
+- Execution 与 Model 是 operation-scoped late-bound dependency；它们不可用时只影响对应 operation，不构成 platform-host 全局启动前置。
 
 ## 运行形态与生命周期
 
@@ -25,7 +26,7 @@ ProFlow 的本地 Composition Root（组合根），把 Task、Agent、Execution
 
 ## 使用方式
 
-所有依赖 Module READY 后通过 Platform 生命周期启动；下游从 shared facts 获取端点和凭据路径。
+满足启动依赖后通过 Platform 生命周期启动；Execution/Model/Provider 等 operation-scoped 依赖在请求时解析，下游从 shared facts 获取端点和凭据路径。
 
 ## 职责边界与限制
 

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 endpoint: string;
                 stateRoot: string;
@@ -24,7 +24,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         };
         observedEffects: string[];
     }>;
@@ -34,17 +34,10 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 setupStatus: "READY";
                 runtimeStatus: "RUNNING" | "STOPPED";
-                issues?: {
-                    scope: "RUNTIME";
-                    code: string;
-                    message: string;
-                    relatedModuleRefs: string[];
-                    nextCommand: string;
-                }[];
             };
         };
         observedEffects: never[];
@@ -55,7 +48,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 endpoint: string;
                 stateRoot: string;
@@ -73,7 +66,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 docs: string;
             };
@@ -86,7 +79,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 host: string;
                 port: number;
@@ -97,7 +90,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             ok: false;
             status: "FAILED";
             error: {
@@ -114,7 +107,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         };
         observedEffects: string[];
     } | {
@@ -123,11 +116,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             ok: false;
             status: "FAILED";
             error: {

package/dist/deployment/adapter.js

@@ -1,6 +1,6 @@
 import { randomBytes } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
-import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { chmod, mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { deterministicLoopbackPort, ensureModuleSecretFile, readModuleSharedFacts, writeModuleSharedFacts, } from "@tomflow/proflow-module-contract";
 import { descriptor } from "./descriptor.js";
@@ -50,32 +50,13 @@ async function readOwnFacts(context) {
     const endpoint = factString(facts, "endpoint");
     return endpoint ? { endpoint } : undefined;
 }
-async function dependencies(context) {
-    const execution = await readModuleSharedFacts(context, "execution-runtime");
-    const model = await readModuleSharedFacts(context, "model-runtime");
-    const executionBaseUrl = factString(execution, "endpoint");
-    const executionTransportCredentialFile = factString(execution, "transportCredentialFile");
-    const modelBaseUrl = factString(model, "endpoint");
-    const modelTransportCredentialFile = factString(model, "transportCredentialFile");
-    return executionBaseUrl &&
-        executionTransportCredentialFile &&
-        modelBaseUrl &&
-        modelTransportCredentialFile
-        ? {
-            executionBaseUrl,
-            executionTransportCredentialFile,
-            modelBaseUrl,
-            modelTransportCredentialFile,
-        }
-        : undefined;
-}
 async function running(context) {
     const own = await readOwnFacts(context);
     if (!own)
         return false;
     try {
-        return (await fetch(`${own.endpoint}/ready`, {
-            signal: AbortSignal.timeout(500),
+        return (await fetch(`${own.endpoint}/health`, {
+            signal: AbortSignal.timeout(2_000),
         })).ok;
     }
     catch {
@@ -84,21 +65,41 @@ async function running(context) {
 }
 async function compose(context) {
     const own = await ownFacts(context);
-    const deps = await dependencies(context);
-    if (!deps)
-        throw new Error("required Execution/Model shared facts are unavailable");
     const { createPlatformHost, parsePlatformHostConfig } = await import("../src/index.js");
     const url = new URL(own.endpoint);
     const host = createPlatformHost({
+        resolveLocalToolConnection: async () => {
+            const facts = await readModuleSharedFacts(context, "execution-browser-extension");
+            const endpoint = factString(facts, "localToolBridgeEndpoint");
+            const tokenFile = factString(facts, "localToolHostTokenFile");
+            if (!endpoint || !tokenFile)
+                return undefined;
+            const info = await stat(tokenFile);
+            if (process.platform !== "win32" && (info.mode & 0o077) !== 0)
+                throw new Error("local tool credential permissions must be owner-only");
+            const credential = (await readFile(tokenFile, "utf8")).trim();
+            if (credential.length < 32)
+                throw new Error("invalid local tool credential");
+            return { endpoint, credential };
+        },
+        resolveOwnerConnection: async (owner) => {
+            const facts = await readModuleSharedFacts(context, owner === "execution" ? "execution-runtime" : "model-runtime");
+            const baseUrl = factString(facts, "endpoint"), tokenFile = factString(facts, "transportCredentialFile");
+            if (!baseUrl || !tokenFile)
+                return undefined;
+            const info = await stat(tokenFile);
+            if (process.platform !== "win32" && (info.mode & 0o077) !== 0)
+                throw new Error("owner credential permissions must be owner-only");
+            const credential = (await readFile(tokenFile, "utf8")).trim();
+            if (credential.length < 32)
+                throw new Error("invalid owner credential");
+            return { baseUrl, credential };
+        },
         config: parsePlatformHostConfig({
             stateRoot: own.stateRoot,
             workspaceRoot: key(context),
             host: url.hostname,
             port: Number(url.port),
-            executionBaseUrl: deps.executionBaseUrl,
-            executionTransportCredentialFile: deps.executionTransportCredentialFile,
-            modelBaseUrl: deps.modelBaseUrl,
-            modelTransportCredentialFile: deps.modelTransportCredentialFile,
             gatewayTransportCredentialFile: own.gatewayTransportCredentialFile,
             roles: [],
         }),
@@ -128,7 +129,6 @@ export const behaviorAdapter = {
         };
     },
     status: async (context) => {
-        const runtimeDependencies = await dependencies(context);
         return {
             result: {
                 ...base,
@@ -137,19 +137,6 @@ export const behaviorAdapter = {
                     runtimeStatus: (await running(context))
                         ? "RUNNING"
                         : "STOPPED",
-                    ...(runtimeDependencies
-                        ? {}
-                        : {
-                            issues: [
-                                {
-                                    scope: "RUNTIME",
-                                    code: "UPSTREAM_NOT_READY",
-                                    message: "等待 Execution 与 Model Runtime 发布运行所需服务信息",
-                                    relatedModuleRefs: ["execution-runtime", "model-runtime"],
-                                    nextCommand: "platform setup",
-                                },
-                            ],
-                        }),
                 },
             },
             observedEffects: [],

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "platform-host";
     readonly packageName: "@tomflow/proflow-platform-host";
-    readonly moduleVersion: "0.1.21";
+    readonly moduleVersion: "0.1.23";
     readonly kind: "service";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
@@ -16,16 +16,13 @@ export declare const descriptor: {
         readonly version: "1.0.0";
     }];
     readonly requires: readonly [{
-        readonly contractRef: "task-orchestration";
-        readonly versionRange: ">=1.0.0 <2.0.0";
-    }, {
-        readonly contractRef: "agent-runtime";
+        readonly contractRef: "local-tool-bridge";
         readonly versionRange: ">=1.0.0 <2.0.0";
     }, {
-        readonly contractRef: "execution";
+        readonly contractRef: "task-orchestration";
         readonly versionRange: ">=1.0.0 <2.0.0";
     }, {
-        readonly contractRef: "model-inference";
+        readonly contractRef: "agent-runtime";
         readonly versionRange: ">=1.0.0 <2.0.0";
     }];
     readonly requirements: readonly [{

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "platform-host",
     packageName: "@tomflow/proflow-platform-host",
-    moduleVersion: "0.1.21",
+    moduleVersion: "0.1.23",
     kind: "service",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
@@ -19,19 +19,15 @@ export const descriptor = {
     ],
     requires: [
         {
-            contractRef: "task-orchestration",
+            contractRef: "local-tool-bridge",
             versionRange: ">=1.0.0 <2.0.0",
         },
         {
-            contractRef: "agent-runtime",
-            versionRange: ">=1.0.0 <2.0.0",
-        },
-        {
-            contractRef: "execution",
+            contractRef: "task-orchestration",
             versionRange: ">=1.0.0 <2.0.0",
         },
         {
-            contractRef: "model-inference",
+            contractRef: "agent-runtime",
             versionRange: ">=1.0.0 <2.0.0",
         },
     ],

package/dist/src/cli.js

@@ -11,10 +11,6 @@ async function main() {
     const config = await loadPlatformHostConfig(configPath);
     if (!config.gatewayTransportCredentialFile)
         throw new Error("platform-host requires gatewayTransportCredentialFile for authenticated Gateway transport");
-    if (!config.modelTransportCredentialFile)
-        throw new Error("platform-host requires modelTransportCredentialFile for authenticated Model Runtime transport");
-    if (!config.executionTransportCredentialFile)
-        throw new Error("platform-host requires executionTransportCredentialFile for authenticated Execution Runtime transport");
     const host = createPlatformHost({
         config,
         log: (entry) => process.stderr.write(`${JSON.stringify(entry)}\n`),

package/dist/src/index.d.ts

@@ -4,9 +4,9 @@ declare const configSchema: z.ZodPipe<z.ZodObject<{
     workspaceRoot: z.ZodString;
     host: z.ZodDefault<z.ZodString>;
     port: z.ZodDefault<z.ZodNumber>;
-    executionBaseUrl: z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>;
+    executionBaseUrl: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>>;
     executionTransportCredentialFile: z.ZodOptional<z.ZodString>;
-    modelBaseUrl: z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>;
+    modelBaseUrl: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>>;
     modelTransportCredentialFile: z.ZodOptional<z.ZodString>;
     gatewayTransportCredentialFile: z.ZodOptional<z.ZodString>;
     roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -22,9 +22,9 @@ declare const configSchema: z.ZodPipe<z.ZodObject<{
 }, z.core.$strict>, z.ZodTransform<{
     host: string;
     port: number;
-    executionBaseUrl: string;
+    executionBaseUrl?: string | undefined;
     executionTransportCredentialFile?: string | undefined;
-    modelBaseUrl: string;
+    modelBaseUrl?: string | undefined;
     modelTransportCredentialFile?: string | undefined;
     gatewayTransportCredentialFile?: string | undefined;
     roles: {
@@ -40,9 +40,9 @@ declare const configSchema: z.ZodPipe<z.ZodObject<{
     workspaceRoot: string;
     host: string;
     port: number;
-    executionBaseUrl: string;
+    executionBaseUrl?: string | undefined;
     executionTransportCredentialFile?: string | undefined;
-    modelBaseUrl: string;
+    modelBaseUrl?: string | undefined;
     modelTransportCredentialFile?: string | undefined;
     gatewayTransportCredentialFile?: string | undefined;
     roles: {
@@ -57,9 +57,9 @@ export declare const parsePlatformHostConfig: (value: unknown) => PlatformHostCo
 export declare function loadPlatformHostConfig(path: string): Promise<{
     host: string;
     port: number;
-    executionBaseUrl: string;
+    executionBaseUrl?: string | undefined;
     executionTransportCredentialFile?: string | undefined;
-    modelBaseUrl: string;
+    modelBaseUrl?: string | undefined;
     modelTransportCredentialFile?: string | undefined;
     gatewayTransportCredentialFile?: string | undefined;
     roles: {
@@ -91,6 +91,14 @@ export type PlatformHostStatus = {
         model: DependencyReadiness;
     };
 };
+export type OwnerConnectionResolver = (owner: "execution" | "model") => Promise<{
+    baseUrl: string;
+    credential: string;
+} | undefined>;
+export type LocalToolConnectionResolver = () => Promise<{
+    endpoint: string;
+    credential: string;
+} | undefined>;
 export type PlatformHostBrowserOwnerPorts = {
     task: {
         getWorkerBinding(taskId: string, roleRef: string): Promise<{
@@ -222,6 +230,8 @@ export declare function createPlatformHost(input: {
     config: PlatformHostConfig;
     log?: (entry: Record<string, unknown>) => void;
     executionCredential?: string;
+    resolveOwnerConnection?: OwnerConnectionResolver;
+    resolveLocalToolConnection?: LocalToolConnectionResolver;
 }): Readonly<{
     start: () => Promise<{
         host: string;