agents-relay 2.0.35 → 2.0.37

package/dist/adapters.js

@@ -165,9 +165,12 @@ function parseDriverJson(output) {
     }
     throw new Error('browser-worker driver returned no submitted receipt');
 }
-function browserWorkspaceCommand(command, args, stdin) {
+function browserWorkspaceCli(override = process.env.AGENTS_RELAY_BROWSER_WORKSPACE_COMMAND) {
+    return override ? { command: override, prefix: [] } : { command: 'npx', prefix: ['browser-workspace'] };
+}
+function browserWorkspaceCommand(cli, args, stdin) {
     return new Promise((resolve, reject) => {
-        const child = spawn(command, [...args], { shell: false, stdio: [stdin === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'] });
+        const child = spawn(cli.command, [...cli.prefix, ...args], { shell: false, stdio: [stdin === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'] });
         let stdout = '';
         let stderr = '';
         child.stdout?.on('data', (chunk) => { stdout += chunk.toString(); });
@@ -194,11 +197,11 @@ function parseWorkspaceJson(output) {
     }
     throw new Error('browser-workspace returned no JSON result');
 }
-export async function ensureChatGptBrowserWorkspace(command = process.env.AGENTS_RELAY_BROWSER_WORKSPACE_COMMAND ?? 'browser-workspace') {
-    await browserWorkspaceCommand(command, ['create', CHATGPT_BROWSER_WORKSPACE, String(CHATGPT_BROWSER_WORKSPACE_POOL_SIZE)]);
+export async function ensureChatGptBrowserWorkspace(command = process.env.AGENTS_RELAY_BROWSER_WORKSPACE_COMMAND) {
+    await browserWorkspaceCommand(browserWorkspaceCli(command), ['create', CHATGPT_BROWSER_WORKSPACE, String(CHATGPT_BROWSER_WORKSPACE_POOL_SIZE)]);
 }
 function sessionBrowserWorkerRunner(root) {
-    const command = process.env.AGENTS_RELAY_BROWSER_WORKSPACE_COMMAND ?? 'browser-workspace';
+    const cli = browserWorkspaceCli();
     return (_definition, request, _route, signal) => {
         const policy = request.tabClosePolicy ?? 'after-start';
         let activeSessionId;
@@ -231,7 +234,7 @@ function sessionBrowserWorkerRunner(root) {
                     close_policy: policy,
                     release_file: '',
                 }));
-                const startOutput = await browserWorkspaceCommand(command, ['session', 'start', '--workspace', CHATGPT_BROWSER_WORKSPACE]);
+                const startOutput = await browserWorkspaceCommand(cli, ['session', 'start', '--workspace', CHATGPT_BROWSER_WORKSPACE]);
                 const started = parseWorkspaceJson(startOutput);
                 if (typeof started.session_id !== 'string') {
                     throw new Error('browser-workspace session start returned no session_id');
@@ -245,7 +248,7 @@ function sessionBrowserWorkerRunner(root) {
                     submitSource.replace(/^from browser_harness import \*\s*$/m, ''),
                     temporarySource.replace(/^_wait_for_release\(\)\s*$/m, ''),
                 ].join('\n\n').replaceAll('__CFG_PATH__', escapedConfig);
-                const execOutput = await browserWorkspaceCommand(command, ['session', 'exec', activeSessionId], source);
+                const execOutput = await browserWorkspaceCommand(cli, ['session', 'exec', activeSessionId], source);
                 const wrapper = parseWorkspaceJson(execOutput);
                 if (wrapper.ok !== true) {
                     throw new Error(typeof wrapper.error === 'string' ? wrapper.error : 'browser-workspace session exec failed');
@@ -260,14 +263,14 @@ function sessionBrowserWorkerRunner(root) {
                 }
                 await releaseBarrier;
                 if (activeSessionId) {
-                    await browserWorkspaceCommand(command, ['session', 'stop', activeSessionId]);
+                    await browserWorkspaceCommand(cli, ['session', 'stop', activeSessionId]);
                     activeSessionId = undefined;
                 }
                 return result;
             }
             catch (failure) {
                 if (activeSessionId) {
-                    await browserWorkspaceCommand(command, ['session', 'stop', activeSessionId]).catch(() => { });
+                    await browserWorkspaceCommand(cli, ['session', 'stop', activeSessionId]).catch(() => { });
                     activeSessionId = undefined;
                 }
                 await unlink(configFile).catch(() => { });
@@ -279,7 +282,7 @@ function sessionBrowserWorkerRunner(root) {
         const cancel = () => {
             release();
             if (activeSessionId) {
-                void browserWorkspaceCommand(command, ['session', 'stop', activeSessionId]);
+                void browserWorkspaceCommand(cli, ['session', 'stop', activeSessionId]);
                 activeSessionId = undefined;
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.35",
+  "version": "2.0.37",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {

package/skills/agents-relay/contracts/task-job-contract.md

@@ -44,15 +44,18 @@ Task input should include, as applicable:
 
 Do not require a producer to invent a root cause or solution that is not known yet.
 
-Task results should include, as applicable:
+Every executing Task worker must make both of these explicit in its durable Task result:
+
+- **root cause** — for bug, incident, failure, diagnostic, or recovery work, state the confirmed cause; if it cannot be determined, say so and preserve the remaining uncertainty. For feature, refactor, research, review, or other work with no failure cause to diagnose, explicitly state that root cause is not applicable and why rather than omitting it.
+- **implemented solution** — describe what was actually changed or done. For read-only research or review work, state the concrete findings, recommendation, or resolution produced by the Task rather than omitting the solution.
+
+Task results should also include, as applicable:
 
-- **root cause** for bug, incident, failure, diagnostic, or recovery work; if an investigation cannot determine it, state that explicitly with the remaining uncertainty;
-- **implemented solution**, describing what was actually changed or done;
 - **deviations** from any proposed or required solution, with the reason;
 - **validation** showing how the result was verified;
 - relevant changed files, commits, PR comments, artifacts, or remaining issues.
 
-For feature/refactor work with no failure to diagnose, root cause is not required. For research tasks, use findings/evidence instead of forcing root-cause language.
+This is a worker result-content contract, not a requirement for dedicated `rootCause` / `solution` schema fields. Workers may satisfy it in normal durable result prose unless a Job defines a stricter structured output contract.
 
 Keep these concepts distinct: observation is not root cause; hypothesis is not root cause; requested approach is not implemented solution; implementation is not validation.