chore: import upstream snapshot with attribution

2026-07-13 13:39:25 +08:00
commit db620d33df
5151 changed files with 925932 additions and 0 deletions
@@ -0,0 +1,40 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System;
+using System.Collections.Generic;
+
+namespace Foundry.Hosting.IntegrationTests.Fixtures;
+
+/// <summary>
+/// Provisions a hosted agent that runs the test container in <c>IT_SCENARIO=toolbox-oauth-consent</c>
+/// mode. The container pre-registers a Foundry toolbox (named by <c>IT_TOOLBOX_NAME</c>) whose tool
+/// source is fronted by a per-user OAuth connection. The first request that needs the tool must
+/// surface an <c>oauth_consent_request</c> instead of running it.
+/// </summary>
+/// <remarks>
+/// Prerequisite (out of band, per project): a Foundry toolbox named by <see cref="ToolboxName"/> must
+/// exist in the target project and reference a tool source that returns <c>CONSENT_REQUIRED</c> for an
+/// unconsented user (for example a delegated GitHub or Microsoft Graph connection). Override the
+/// toolbox name with the <c>IT_TOOLBOX_NAME</c> environment variable. See the project README.
+/// </remarks>
+public sealed class ToolboxOAuthConsentHostedAgentFixture : HostedAgentFixture
+{
+    private const string ToolboxNameEnvironmentVariable = "IT_TOOLBOX_NAME";
+    private const string DefaultToolboxName = "auth-paths-oauth-toolbox";
+
+    protected override string ScenarioName => "toolbox-oauth-consent";
+
+    /// <summary>
+    /// The Foundry toolbox the container pre-registers. Resolved from <c>IT_TOOLBOX_NAME</c>, falling
+    /// back to a default that exists in the reference project.
+    /// </summary>
+    public string ToolboxName { get; } =
+        Environment.GetEnvironmentVariable(ToolboxNameEnvironmentVariable) ?? DefaultToolboxName;
+
+    protected override void ConfigureEnvironment(IDictionary<string, string> environment)
+    {
+        // Pass the toolbox name into the container so Program.cs wires AddFoundryToolboxes(credential, name).
+        // IT_TOOLBOX_NAME is a non-reserved key (FOUNDRY_*/AGENT_* are forbidden by the platform).
+        environment[ToolboxNameEnvironmentVariable] = this.ToolboxName;
+    }
+}