microsoft / microsoft/agent-framework

.NET: Hyperlight host-tool parameter schemas missing from execute_code descriptions

Open
#8,446 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

.NET
Dominant language
Python
Stars
13.6k
Forks
2.3k
Avg merge
2d 45m
Merged PRs (30d)
358

Description

## Parent issue

Sub-issue of #8125. Sibling #8445 is separate and must not close this child or the parent.

## Confirmed behavior

At upstream/main `999dda7970fe969c0901d524365ce34ecbda6227`, `dotnet/src/Microsoft.Agents.AI.Hyperlight/Internal/InstructionBuilder.cs::BuildExecuteCodeDescription` emits each host `AIFunction` name and description but never reads `JsonSchema`. The model therefore does not receive host-tool parameter names, requiredness, descriptions, enums, or nested shapes through this listing.

Both `HyperlightExecuteCodeFunction` and `HyperlightCodeActProvider` use this shared builder. Inspect the standalone function Description or the provider-returned execute-code function description; current BuildInstructions() returns short guidance and is not the correct reproduction accessor.

## Acceptance criteria

- Surface existing host-tool parameter schemas in the model-facing execute-code description for both entry points.
- Add parameterized-host-tool regression coverage; the current builder test uses a zero-parameter function and misses the defect.
- Preserve no-tool output, the code-only execute-code input schema, approval behavior, filesystem host-path protection, and network restrictions.
- Keep the fix focused and document directly affected behavior. Confirm rendering and public API choices separately.

## Status

Deferred at the user request and outside the sibling PR. This child does not authorize implementation. Source behavior was independently confirmed; no new build or live-model reproduction was run. The parent includes a contributor offer to help, so coordinate ownership and check for an implementing PR before starting.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in dotnet/src/Microsoft.Agents.AI.Hyperlight/Internal/InstructionBuilder.cs at BuildExecuteCodeDescription, then inspect HyperlightExecuteCodeFunction and HyperlightCodeActProvider and the existing builder test. Verify the standalone and provider-returned descriptions with a parameterized host tool. Done means schemas are surfaced while the listed no-tool, input-schema, approval, filesystem, and network behaviors remain unchanged.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
ai, backend-api-design
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.