fix(exec): qualify unavailable-workdir diagnostic as gateway-local

Pandah97 · Pandah97 · commit a703dca097fe · 2026-07-03T09:54:15.000+08:00
The shared formatUnavailableWorkdirFailure formatter is used by gateway,
node, and sandbox exec paths. The previous wording "for local execution"
implied the message applied globally. Changing to "for gateway-local
execution" makes the scope accurate for all callers.

P2: make unavailable-workdir guidance host-aware.
diff --git a/src/agents/bash-tools.exec-foreground-failures.test.ts b/src/agents/bash-tools.exec-foreground-failures.test.ts
@@ -100,7 +100,7 @@ async function expectUnavailableWorkdir(params: {
     const text = requireTextContent(result);
     expect(text).toContain(`workdir "${params.workdir}" is unavailable or not a directory`);
     expect(text).toContain("command was not executed");
-    expect(text).toContain('Leading "~" is expanded to the home directory for local execution');
+    expect(text).toContain('Leading "~" is expanded for gateway-local execution');
     const details = requireFailedDetails(result.details);
     expect(details.exitCode).toBeNull();
     expect(details.timedOut).toBe(false);
diff --git a/src/agents/bash-tools.exec-workdir.ts b/src/agents/bash-tools.exec-workdir.ts
@@ -329,7 +329,7 @@ async function resolveSandboxWorkdir(params: {
 export function formatUnavailableWorkdirFailure(workdir: string): string {
   return [
     `workdir "${workdir}" is unavailable or not a directory: command was not executed.`,
-    'Leading "~" is expanded to the home directory for local execution.',
+    'Leading "~" is expanded for gateway-local execution.',
     "Use an existing directory, omit an explicit workdir to use the default cwd, or update the configured default cwd.",
   ].join(" ");
 }
diff --git a/src/agents/bash-tools.exec.path.test.ts b/src/agents/bash-tools.exec.path.test.ts
@@ -234,7 +234,7 @@ describe("exec PATH login shell merge", () => {
     expect(result.details?.status).toBe("failed");
     expect(value).toContain(`workdir "${missingWorkdir}" is unavailable or not a directory`);
     expect(value).toContain("command was not executed");
-    expect(value).toContain('Leading "~" is expanded to the home directory for local execution');
+    expect(value).toContain('Leading "~" is expanded for gateway-local execution');
     expect(value).not.toMatch(/^ok/);
   });
 

Original file line number	Diff line number	Diff line change
`@@ -329,7 +329,7 @@ async function resolveSandboxWorkdir(params: {`
`329`	`329`	`export function formatUnavailableWorkdirFailure(workdir: string): string {`
`330`	`330`	`return [`
`331`	`331`	`workdir "${workdir}" is unavailable or not a directory: command was not executed.`,
`332`		`- 'Leading "~" is expanded to the home directory for local execution.',`
	`332`	`+ 'Leading "~" is expanded for gateway-local execution.',`
`333`	`333`	`"Use an existing directory, omit an explicit workdir to use the default cwd, or update the configured default cwd.",`
`334`	`334`	`].join(" ");`
`335`	`335`	`}`