Skip to content

feat: define agent tool access contracts - #3543

Merged
ananthsub merged 1 commit into
mainfrom
ananthsub/environment-server-tool-access
Sep 22, 2026
Merged

ananthsub merged 1 commit into
mainfrom
ananthsub/environment-server-tool-access

Conversation

@ananthsub

@ananthsub ananthsub commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do?

Defines named direct-HTTP and streamable-HTTP MCP access independently of any session lifecycle. These contracts carry episode-scoped connectivity and authorization data; locally launched MCP processes remain Agent Server configuration.

Single-agent interaction flow

This diagram shows the built-in single-agent use case. Other Environment Server protocols may coordinate different participants and use different request, result, and lifecycle flows.

sequenceDiagram
    participant C as Rollout collector
    participant E as Environment Server
    participant R as Task / Resources Server
    participant A as Agent Server
    participant M as Model Server
    participant S as Task sandbox

    C->>E: POST /run
    E->>R: Seed task session
    R-->>E: Tool access and optional SandboxAccess
    E->>A: Seed agent session
    A->>S: Connect as borrower when supplied
    E->>A: Invoke /v1/responses
    A->>M: Model and capture requests
    A-->>E: Agent response
    E->>A: Close agent session
    E->>R: Verify response
    E->>R: Close task session
    E-->>C: Episode result
Loading

The Environment Server coordinates ordering and the final result. Agent and Task/Resources Servers retain ownership of the state and resources they create.

This is part 4 of 14 in the Environment Server stack. Previous: #3484. Next: #3545.

Validation

  • uv run pytest tests/unit_tests/test_tool_access.py -q

Rollouts

See the final PR for end-to-end rollout evidence.

Compatibility and benchmark impact

Additive contract definitions only. Static stdio MCP configuration remains owned by individual Agent Server implementations.

@copy-pr-bot

copy-pr-bot Bot commented Sep 18, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@ananthsub
ananthsub added this pull request to stack #3546 September 18, 2026 22:11
@ananthsub
ananthsub marked this pull request as ready for review September 18, 2026 22:12
@nemo-automation-bot
nemo-automation-bot Bot requested review from a team September 18, 2026 22:12
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from e0c1da6 to dd7b005 Compare September 18, 2026 22:22
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from dd7b005 to 5ca28f3 Compare September 18, 2026 22:27
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from ab65cdc to 1326bd1 Compare September 21, 2026 13:38
@nemo-automation-bot
nemo-automation-bot Bot requested a review from a team September 21, 2026 13:38
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from 1326bd1 to c2c0da1 Compare September 21, 2026 17:19
@github-actions github-actions Bot added the sla:review-overdue Review response is over the one-business-day SLA label Sep 21, 2026
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from c2c0da1 to 9ecb0d7 Compare September 22, 2026 13:13
@ananthsub
ananthsub force-pushed the ananthsub/environment-server-tool-access branch from 9ecb0d7 to da4b903 Compare September 22, 2026 13:18
Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>

This branch was previously deployed

1 inactive deployment
public β€” 4c8c3ad8 Deployed Sep 22, 2026 by copy-pr-bot[bot] via release / finalize / notify #3476
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:agent Agent harnesses and Responses API agent behavior complexity:medium Single-domain change with interacting parts or a moderate review surface feature New capabilities, enhancements, or enablement work needs-review PR is ready for code review and waiting on a reviewer sla:review-overdue Review response is over the one-business-day SLA

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants