@tomflow/proflow-agent-gateway 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-agent-gateway
 
+## 0.1.16
+
+### Patch Changes
+
+- Release the verified Real-3 B1 task recovery, exact execution identity, durable observer resume, bounded gateway error, and matching Agent Action contract fixes.
+
+## 0.1.15
+
+### Patch Changes
+
+- Add professional setup orchestration, Provider FAST/THINK input, recoverable managed Dev Tunnel provisioning, Browser installation guidance, and precise status diagnostics.
+
 ## 0.1.14
 
 ### Patch Changes

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             data: {
                 localBaseUrl: string;
                 publicBaseUrl?: string;
@@ -20,7 +20,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "agent-gateway";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.16";
         };
         observedEffects: string[];
     }>;
@@ -30,7 +30,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             data: {
                 setupStatus: "BLOCKED" | "READY";
                 runtimeStatus: "RUNNING" | "STOPPED";
@@ -51,7 +51,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             data: {
                 localBaseUrl: string;
                 publicBaseUrl?: string;
@@ -66,7 +66,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             data: {
                 docs: string;
             };
@@ -79,7 +79,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             data: {
                 host: string;
                 port: number;
@@ -90,7 +90,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             ok: false;
             status: "FAILED";
             error: {
@@ -107,7 +107,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "agent-gateway";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.16";
         };
         observedEffects: string[];
     } | {
@@ -116,11 +116,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "agent-gateway";
-            readonly moduleVersion: "0.1.14";
+            readonly moduleVersion: "0.1.16";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.14";
+            moduleVersion: "0.1.16";
             ok: false;
             status: "FAILED";
             error: {

package/dist/deployment/adapter.js

@@ -25,19 +25,31 @@ async function readOwnFacts(context) {
     const localBaseUrl = factString(facts, "localBaseUrl");
     return localBaseUrl ? { localBaseUrl } : undefined;
 }
-async function dependencies(context) {
+async function dependencyObservation(context) {
     const tunnel = await readModuleSharedFacts(context, "dev-tunnel");
     const host = await readModuleSharedFacts(context, "platform-host");
     const publicBaseUrl = factString(tunnel, "publicBaseUrl");
     const downstreamBaseUrl = factString(host, "endpoint");
     const downstreamCredentialFile = factString(host, "gatewayTransportCredentialFile");
     const stateRoot = factString(host, "stateRoot");
-    return publicBaseUrl &&
-        downstreamBaseUrl &&
-        downstreamCredentialFile &&
-        stateRoot
-        ? { publicBaseUrl, downstreamBaseUrl, downstreamCredentialFile, stateRoot }
+    const missing = [
+        ...(!publicBaseUrl ? ["dev-tunnel"] : []),
+        ...(!downstreamBaseUrl || !downstreamCredentialFile || !stateRoot
+            ? ["platform-host"]
+            : []),
+    ];
+    const value = publicBaseUrl && downstreamBaseUrl && downstreamCredentialFile && stateRoot
+        ? {
+            publicBaseUrl,
+            downstreamBaseUrl,
+            downstreamCredentialFile,
+            stateRoot,
+        }
         : undefined;
+    return { value, missing };
+}
+async function dependencies(context) {
+    return (await dependencyObservation(context)).value;
 }
 async function running(context) {
     const own = await readOwnFacts(context);
@@ -96,7 +108,8 @@ export const behaviorAdapter = {
         };
     },
     status: async (context) => {
-        const ready = await dependencies(context);
+        const dependency = await dependencyObservation(context);
+        const ready = dependency.value;
         return {
             result: {
                 ...base,
@@ -112,9 +125,11 @@ export const behaviorAdapter = {
                                 {
                                     scope: "SETUP",
                                     code: "UPSTREAM_NOT_READY",
-                                    message: "等待 dev-tunnel 发布公开 HTTPS 地址，并等待 platform-host 发布下游端点与传输凭据",
-                                    relatedModuleRefs: ["dev-tunnel", "platform-host"],
-                                    nextCommand: "platform setup --module dev-tunnel",
+                                    message: `等待 ${dependency.missing.join("、")} 完成前置配置`,
+                                    relatedModuleRefs: dependency.missing,
+                                    nextCommand: dependency.missing[0] === "dev-tunnel"
+                                        ? "platform setup --module dev-tunnel"
+                                        : "platform setup",
                                 },
                             ],
                         }),
@@ -123,18 +138,21 @@ export const behaviorAdapter = {
             observedEffects: [],
         };
     },
-    setup: async (context) => ({
-        result: {
-            ...base,
-            data: {
-                ...(await ownFacts(context)),
-                ...((await dependencies(context)) === undefined
-                    ? { waitingFor: ["dev-tunnel", "platform-host"] }
-                    : {}),
+    setup: async (context) => {
+        const dependency = await dependencyObservation(context);
+        return {
+            result: {
+                ...base,
+                data: {
+                    ...(await ownFacts(context)),
+                    ...(dependency.value === undefined
+                        ? { waitingFor: dependency.missing }
+                        : {}),
+                },
             },
-        },
-        observedEffects: [],
-    }),
+            observedEffects: [],
+        };
+    },
     docs: async (_context) => ({
         result: {
             ...base,

package/dist/deployment/descriptor.d.ts

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

package/dist/src/process.js

@@ -1,7 +1,65 @@
 import { createHash, timingSafeEqual } from "node:crypto";
 import { readFile, stat } from "node:fs/promises";
 import { resolve } from "node:path";
-import { createAgentGateway } from "./index.js";
+import { AgentGatewayError, createAgentGateway } from "./index.js";
+const MAX_DOWNSTREAM_ERROR_BYTES = 8_192;
+const safeDownstreamErrorCodes = new Set([
+    "INVALID_REQUEST",
+    "ROLE_OPERATION_DENIED",
+    "TASK_ROLE_BINDING_REQUIRED",
+    "TASK_WORKER_BINDING_MISMATCH",
+    "ROLE_NOT_TASK_PARTICIPANT",
+    "WORKER_IDENTITY_INVALID",
+    "WORKER_MISMATCH",
+    "TASK_TERMINAL",
+    "EXECUTION_TASK_NOT_ACTIVE",
+    "EXECUTION_NODE_NOT_CURRENT",
+    "EXECUTION_NODE_NOT_RUNNING",
+    "EXECUTION_GENERATION_MISMATCH",
+    "EXECUTION_ROLE_SCOPE_MISMATCH",
+    "EXECUTION_WORKER_SCOPE_MISMATCH",
+]);
+async function boundedDownstreamErrorCode(response) {
+    if (!response.body)
+        return null;
+    const reader = response.body.getReader();
+    const chunks = [];
+    let bytes = 0;
+    try {
+        while (true) {
+            const next = await reader.read();
+            if (next.done)
+                break;
+            bytes += next.value.byteLength;
+            if (bytes > MAX_DOWNSTREAM_ERROR_BYTES) {
+                await reader.cancel();
+                return null;
+            }
+            chunks.push(next.value);
+        }
+    }
+    catch {
+        return null;
+    }
+    const merged = new Uint8Array(bytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    try {
+        const value = JSON.parse(new TextDecoder().decode(merged));
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            return null;
+        const code = Reflect.get(value, "error");
+        return typeof code === "string" && safeDownstreamErrorCodes.has(code)
+            ? code
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
 function record(value, name) {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         throw new TypeError(`${name} must be an object`);
@@ -92,21 +150,41 @@ export async function createAgentGatewayProcess(input) {
         const downstreamCredential = input.config.downstreamCredentialFile
             ? await readDownstreamCredential(input.config.downstreamCredentialFile)
             : undefined;
-        const response = await fetchImplementation(`${input.config.downstreamBaseUrl}${path}`, {
-            method: body === undefined ? "GET" : "POST",
-            headers: {
-                ...(body === undefined ? {} : { "content-type": "application/json" }),
-                ...(downstreamCredential
-                    ? { authorization: `Bearer ${downstreamCredential}` }
-                    : {}),
-            },
-            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
-            ...(signal ? { signal } : {}),
-        });
-        if (!response.ok)
-            throw Object.assign(new Error("DOWNSTREAM_UNAVAILABLE"), {
+        let response;
+        try {
+            response = await fetchImplementation(`${input.config.downstreamBaseUrl}${path}`, {
+                method: body === undefined ? "GET" : "POST",
+                headers: {
+                    ...(body === undefined
+                        ? {}
+                        : { "content-type": "application/json" }),
+                    ...(downstreamCredential
+                        ? { authorization: `Bearer ${downstreamCredential}` }
+                        : {}),
+                },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+                ...(signal ? { signal } : {}),
+            });
+        }
+        catch {
+            throw Object.assign(new AgentGatewayError(signal?.aborted
+                ? "OPENAI_ACTION_TIMEOUT"
+                : "OWNER_SERVICE_UNAVAILABLE"), { httpStatus: signal?.aborted ? 504 : 503 });
+        }
+        if (!response.ok) {
+            const downstreamCode = await boundedDownstreamErrorCode(response);
+            const code = response.status >= 500 || response.status === 401
+                ? "OWNER_SERVICE_UNAVAILABLE"
+                : (downstreamCode ??
+                    (response.status === 400
+                        ? "INVALID_REQUEST"
+                        : response.status === 403
+                            ? "ROLE_OPERATION_DENIED"
+                            : "DOWNSTREAM_UNAVAILABLE"));
+            throw Object.assign(new AgentGatewayError(code), {
                 httpStatus: response.status,
             });
+        }
         return response.json();
     };
     const gateway = await createAgentGateway({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-agent-gateway",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -28,15 +28,15 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-task-migration-runner": "^0.1.11",
-    "@tomflow/proflow-execution-local": "^0.1.13",
-    "@tomflow/proflow-agent-runtime": "^0.1.10",
-    "@tomflow/proflow-platform-host": "^0.1.14",
-    "@tomflow/proflow-execution-runtime": "^0.1.15",
-    "@tomflow/proflow-execution-browser-extension": "^0.1.14",
+    "@tomflow/proflow-agent-runtime": "^0.1.13",
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
+    "@tomflow/proflow-execution-browser-extension": "^0.1.45",
+    "@tomflow/proflow-execution-runtime": "^0.1.18",
+    "@tomflow/proflow-task-orchestration": "^0.1.11",
     "@tomflow/proflow-task-store-sqlite": "^0.1.11",
-    "@tomflow/proflow-task-orchestration": "^0.1.9",
-    "@tomflow/proflow-deployment-conformance": "^0.1.12"
+    "@tomflow/proflow-task-migration-runner": "^0.1.11",
+    "@tomflow/proflow-execution-local": "^0.1.15",
+    "@tomflow/proflow-platform-host": "^0.1.19"
   },
   "description": "The sole Custom GPT Actions HTTP ingress and OpenAI transport anti-corruption layer.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "agent-gateway",
 	"packageName": "@tomflow/proflow-agent-gateway",
-	"moduleVersion": "0.1.14",
+	"moduleVersion": "0.1.16",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",