From c3d51b833848d4dfae5b429a875c5f542f5bb369 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 6 Feb 2026 07:08:47 +0000
Subject: [PATCH 1/2] Initial plan


From ce4efbde2a376d1f4561ba5baac69cb68947c34a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 6 Feb 2026 07:16:13 +0000
Subject: [PATCH 2/2] docs: remove payload-dir from frontmatter documentation

The payload-dir field was never user-configurable from workflow frontmatter.
It's an internal implementation detail set programmatically by
ensureDefaultMCPGatewayConfig(). The extractMCPGatewayConfig() function
does not extract this field from frontmatter.

The payloadDir field remains correctly documented in the MCP Gateway
Specification (mcp-gateway.md) as part of the gateway configuration JSON
schema, which is the correct location for internal gateway configuration.

Changes:
- Removed payload-dir section from frontmatter.md
- No code changes needed (field was never parsed from frontmatter)
- PayloadDir field in MCPGatewayRuntimeConfig remains unchanged (internal use)
- MCP gateway specification documentation unchanged (correct location)

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 docs/src/content/docs/reference/frontmatter.md | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/docs/src/content/docs/reference/frontmatter.md b/docs/src/content/docs/reference/frontmatter.md
index 2914a9d0efe..ffb802a26bb 100644
--- a/docs/src/content/docs/reference/frontmatter.md
+++ b/docs/src/content/docs/reference/frontmatter.md
@@ -127,16 +127,6 @@ plugins:
 
 Each plugin repository must be specified in `org/repo` format. The compiler generates installation steps that run after the engine CLI is installed but before workflow execution begins.
 
-### Payload Directory (`payload-dir:`)
-
-Configures the directory path for sharing large MCP response payloads between agent and gateway containers. Defaults to `/tmp/gh-aw/mcp-payload`.
-
-```yaml wrap
-payload-dir: /tmp/custom/payload-path
-```
-
-The payload directory is mounted read-only in the agent container and read-write in the MCP gateway container, enabling efficient sharing of large tool responses without token overhead. This is automatically configured when using MCP servers.
-
 ### Permissions (`permissions:`)
 
 The `permissions:` section uses standard GitHub Actions permissions syntax to specify the permissions relevant to the agentic (natural language) part of the execution of the workflow. See [GitHub Actions permissions documentation](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#permissions).