@tomflow/proflow-agent-gateway 0.1.15 → 0.1.17

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-agent-gateway
 
+## 0.1.17
+
+### 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.
+
+## 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

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             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.15";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     }>;
@@ -30,7 +30,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             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.15";
+            moduleVersion: "0.1.17";
             data: {
                 localBaseUrl: string;
                 publicBaseUrl?: string;
@@ -66,7 +66,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             data: {
                 docs: string;
             };
@@ -79,7 +79,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             data: {
                 host: string;
                 port: number;
@@ -90,7 +90,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             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.15";
+            readonly moduleVersion: "0.1.17";
         };
         observedEffects: string[];
     } | {
@@ -116,11 +116,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "agent-gateway";
-            readonly moduleVersion: "0.1.15";
+            readonly moduleVersion: "0.1.17";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "agent-gateway";
-            moduleVersion: "0.1.15";
+            moduleVersion: "0.1.17";
             ok: false;
             status: "FAILED";
             error: {

package/dist/deployment/adapter.js

@@ -56,8 +56,8 @@ async function running(context) {
     if (!own)
         return false;
     try {
-        return (await fetch(`${own.localBaseUrl}/ready`, {
-            signal: AbortSignal.timeout(500),
+        return (await fetch(`${own.localBaseUrl}/health`, {
+            signal: AbortSignal.timeout(2_000),
         })).ok;
     }
     catch {

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.15";
+    readonly moduleVersion: "0.1.17";
     readonly kind: "service";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
@@ -21,9 +21,6 @@ export declare const descriptor: {
     }, {
         readonly contractRef: "task-orchestration";
         readonly versionRange: ">=1.0.0 <2.0.0";
-    }, {
-        readonly contractRef: "execution";
-        readonly versionRange: ">=1.0.0 <2.0.0";
     }, {
         readonly contractRef: "platform-host";
         readonly versionRange: ">=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.15",
+    moduleVersion: "0.1.17",
     kind: "service",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
@@ -26,10 +26,6 @@ export const descriptor = {
             contractRef: "task-orchestration",
             versionRange: ">=1.0.0 <2.0.0",
         },
-        {
-            contractRef: "execution",
-            versionRange: ">=1.0.0 <2.0.0",
-        },
         {
             contractRef: "platform-host",
             versionRange: ">=1.0.0 <2.0.0",

package/dist/src/index.d.ts

@@ -9,6 +9,7 @@ export type GatewayOwnerPorts = {
     authenticateBearer(credential: string): Promise<string>;
     route(operationId: string, authenticatedRoleRef: string, input: unknown, context?: {
         signal: AbortSignal;
+        deadlineAt: string;
         fileMaterializationInputs?: readonly ExternalFileMaterializationInput[];
     }): Promise<unknown>;
     lookupResult?(operationId: string, authenticatedRoleRef: string, input: unknown): Promise<unknown>;

package/dist/src/index.js

@@ -331,11 +331,15 @@ export async function createAgentGateway(options) {
                     canonicalBody.content.length > 0)
                     throw new AgentGatewayError("OPENAI_FILE_INPUT_CONFLICT");
             }
-            const actionSignal = AbortSignal.timeout(options.actionTimeoutMs ?? 45_000);
+            const actionTimeoutMs = Math.min(40_000, options.actionTimeoutMs ?? 40_000);
+            const propagationReserveMs = Math.min(1_500, Math.max(100, Math.floor(actionTimeoutMs / 10)));
+            const deadlineAt = new Date(now() + Math.max(1, actionTimeoutMs - propagationReserveMs)).toISOString();
+            const actionSignal = AbortSignal.timeout(actionTimeoutMs);
             const operation = action.uncertain && options.owners.lookupResult
                 ? options.owners.lookupResult(action.operationId, authenticatedRoleRef, canonicalBody)
                 : options.owners.route(action.operationId, authenticatedRoleRef, canonicalBody, {
                     signal: actionSignal,
+                    deadlineAt,
                     ...(fileMaterializationInputs === undefined
                         ? {}
                         : { fileMaterializationInputs }),

package/dist/src/process.js

@@ -1,7 +1,77 @@
 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",
+    "ROLE_TOOL_OPERATION_DENIED",
+    "DIRECT_TOOL_INPUT_INVALID",
+    "DIRECT_TOOL_DEADLINE_REQUIRED",
+    "LOCAL_TOOL_BRIDGE_UNAVAILABLE",
+    "LOCAL_TOOL_AUTH_INVALID",
+    "LOCAL_TOOL_INPUT_INVALID",
+    "LOCAL_TOOL_OFFLINE",
+    "LOCAL_TOOL_COMMAND_TIMEOUT",
+    "LOCAL_TOOL_RESULT_UNKNOWN",
+    "LOCAL_TOOL_PROVIDER_UNAVAILABLE",
+    "LOCAL_TOOL_SCOPE_DENIED",
+    "LOCAL_TOOL_COMMAND_FAILED",
+]);
+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 +162,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({
@@ -125,6 +215,7 @@ export async function createAgentGatewayProcess(input) {
                 return downstream(`/actions/${encodeURIComponent(operationId)}`, {
                     authenticatedRoleRef,
                     input: value,
+                    deadlineAt: context?.deadlineAt,
                     ...(context?.fileMaterializationInputs === undefined
                         ? {}
                         : {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-agent-gateway",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -28,15 +28,14 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-agent-runtime": "^0.1.10",
+    "@tomflow/proflow-execution-browser-extension": "^0.1.51",
     "@tomflow/proflow-deployment-conformance": "^0.1.13",
-    "@tomflow/proflow-execution-browser-extension": "^0.1.15",
-    "@tomflow/proflow-platform-host": "^0.1.14",
-    "@tomflow/proflow-execution-runtime": "^0.1.15",
+    "@tomflow/proflow-execution-runtime": "^0.1.19",
+    "@tomflow/proflow-agent-runtime": "^0.1.14",
+    "@tomflow/proflow-platform-host": "^0.1.23",
+    "@tomflow/proflow-task-orchestration": "^0.1.11",
     "@tomflow/proflow-task-migration-runner": "^0.1.11",
-    "@tomflow/proflow-task-orchestration": "^0.1.9",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.11",
-    "@tomflow/proflow-execution-local": "^0.1.13"
+    "@tomflow/proflow-task-store-sqlite": "^0.1.12"
   },
   "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.15",
+	"moduleVersion": "0.1.17",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
@@ -26,10 +26,6 @@
 			"contractRef": "task-orchestration",
 			"versionRange": ">=1.0.0 <2.0.0"
 		},
-		{
-			"contractRef": "execution",
-			"versionRange": ">=1.0.0 <2.0.0"
-		},
 		{
 			"contractRef": "platform-host",
 			"versionRange": ">=1.0.0 <2.0.0"