Implement app capabilities feature by satvu · Pull Request #11577 · Azure/azure-functions-host

satvu · 2026-01-22T22:34:33Z

Issue describing the changes in this PR

resolves #11574

Example branch of webjobs extension this works e2e with here.
Example branch of dotnet worker that works e2e with this here

Pull request checklist

IMPORTANT: Currently, changes must be backported to the in-proc branch to be included in Core Tools and non-Flex deployments.

Backporting to the in-proc branch is not required
- Otherwise: Link to backporting PR
My changes do not require documentation changes
- Otherwise: Documentation issue linked to PR
My changes should not be added to the release notes for the next release
- Otherwise: I've added my notes to release_notes.md
My changes do not need to be backported to a previous version
- Otherwise: Backport tracked by issue/PR #issue_or_pr
My changes do not require diagnostic events changes
- Otherwise: I have added/updated all related diagnostic events and their documentation (Documentation issue linked to PR)
I have added all required tests (Unit tests, E2E tests)

Additional Comments

The two new endpoints added (admin/capabilities and admin/capabilities/{name}) can be used by partners or customers to quickly query for an app's capabilities/features and related values (endpoints, names, etc.). Capabilities include values that can be set by extensions, language workers, customers, and the host.

One example: At the ARM level, the admin/capabilities endpoint can be called and the values can be stored in ARG for later purposes (such as querying/filtering apps for a dashboard).

Related PRs:

Protobuf PR: Add app capabilities field azure-functions-language-worker-protobuf#100
Abstractions PR: TODO

src/WebJobs.Script.Abstractions/Directory.Version.props

src/WebJobs.Script.Grpc/azure-functions-language-worker-protobuf/src/proto/FunctionRpc.proto

src/WebJobs.Script.WebHost/Security/Authorization/Policies/AuthorizationOptionsExtensions.cs

satvu · 2026-01-22T22:36:23Z

src/WebJobs.Script/WebJobs.Script.csproj

  </ItemGroup>

+  <ItemGroup>
+      <ProjectReference Include="..\WebJobs.Script.Abstractions\WebJobs.Script.Abstractions.csproj" />


TODO: remove testing change --> need to release abstractions project and reference released package in this PR before merging.

src/WebJobs.Script.Abstractions/AppCapabilities/AppCapabilitiesOptions.cs

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs

src/WebJobs.Script.WebHost/Controllers/AppCapabilitiesController.cs

src/WebJobs.Script.Grpc/Channel/GrpcWorkerChannel.cs

src/WebJobs.Script.WebHost/Properties/launchSettings.json

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs

src/WebJobs.Script.WebHost/Controllers/AppCapabilitiesController.cs

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesProvider.cs

…rpc changes

…tration from webjobs extension

src/WebJobs.Script/AppCapabilities/AppCapabilitiesChangeTokenSource.cs

liliankasem

Approach taken looks good to me, just missing tests

jviau

I think there are still lifetime/access/resolution issues between script host and web host copies of AppCapabilitiesOptions. See my comment in the review discussing it.

src/WebJobs.Script.Abstractions/AppCapabilities/AppCapabilitiesOptions.cs

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesStore.cs

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs

jviau · 2026-03-05T21:30:15Z

src/WebJobs.Script/WebJobs.Script.csproj

  </ItemGroup>

+  <ItemGroup>
+      <ProjectReference Include="..\WebJobs.Script.Abstractions\WebJobs.Script.Abstractions.csproj" />


We will need to review that our CI is producing and publishing new abstractions packages. If it isn't, core tools will fail restore.

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs

src/WebJobs.Script.Abstractions/AppCapabilities/AppCapabilitiesOptions.cs

brettsam · 2026-03-06T22:50:31Z

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs

+            var capabilitiesSection = _configuration.GetSection(ConfigurationSectionNames.AppCapabilities);
+            if (capabilitiesSection.Exists())
+            {
+                AddCapabilitiesFromSection(optionsDict, capabilitiesSection);


What's the scenario for this? Do we expect someone to add this as an app setting to express some capabilities?

This is for setting capabilities in host.json (customer provided values, their own customer scenarios).

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesStore.cs

Copilot

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated 7 comments.

You can also share your feedback on Copilot code review. Take the survey.

test/WebJobs.Script.Tests/Workers/Rpc/GrpcWorkerChannelTests.cs

test/WebJobs.Script.Tests/StaticAnalysisTests.cs

src/WebJobs.Script/AppCapabilities/IAppCapabilitiesStore.cs

src/WebJobs.Script.Grpc/Channel/WorkerChannel.cs

src/WebJobs.Script.Abstractions/AppCapabilities/AppCapabilitiesOptions.cs

Co-authored-by: Copilot Autofix powered by AI <[email protected]>

…/Azure/azure-functions-host into satvu/app-capabilities-prototype

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesStore.cs

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs

src/WebJobs.Script.Grpc/Channel/WorkerChannel.cs

src/WebJobs.Script/AppCapabilities/AppCapabilitiesChangeTokenSource.cs

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesStore.cs

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs

satvu commented Jan 22, 2026

View reviewed changes

src/WebJobs.Script.Abstractions/Directory.Version.props Outdated Show resolved Hide resolved

satvu commented Jan 22, 2026

View reviewed changes

src/WebJobs.Script.Grpc/azure-functions-language-worker-protobuf/src/proto/FunctionRpc.proto Outdated Show resolved Hide resolved

satvu commented Jan 22, 2026

View reviewed changes

src/WebJobs.Script.WebHost/Security/Authorization/Policies/AuthorizationOptionsExtensions.cs Outdated Show resolved Hide resolved

satvu commented Jan 22, 2026

View reviewed changes

src/WebJobs.Script.Abstractions/AppCapabilities/AppCapabilitiesOptions.cs Outdated Show resolved Hide resolved

jviau reviewed Feb 2, 2026

View reviewed changes

liliankasem reviewed Feb 2, 2026

View reviewed changes

src/WebJobs.Script.Grpc/Channel/GrpcWorkerChannel.cs Outdated Show resolved Hide resolved

src/WebJobs.Script.WebHost/Properties/launchSettings.json Outdated Show resolved Hide resolved

src/WebJobs.Script/AppCapabilities/AppCapabilitiesOptionsSetup.cs Outdated Show resolved Hide resolved

liliankasem reviewed Feb 2, 2026

View reviewed changes

src/WebJobs.Script.WebHost/Controllers/AppCapabilitiesController.cs Outdated Show resolved Hide resolved

liliankasem reviewed Feb 2, 2026

View reviewed changes

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesProvider.cs Outdated Show resolved Hide resolved

liliankasem reviewed Feb 2, 2026

View reviewed changes

src/WebJobs.Script/AppCapabilities/DefaultAppCapabilitiesProvider.cs Outdated Show resolved Hide resolved

satvu added 12 commits February 12, 2026 13:24

prototype pull from host.json works

1aabf25

cleanup config prototype

bd24ac9

moveto webjobs script, add some wip worker-provided capabilities

0e29921

move items to abstractions, host admin endpoint runs, partial worker …

049367f

…rpc changes

wip, some extra files not used need cleanup later, working with regis…

c07e873

…tration from webjobs extension

wip simplify capabilities to string, string

dc542f3

wip, loads from all sources

1acd82b

cleanup

a076ee5

add some logging

e3d4e2c

cleanup

2a10387

resolve minor comments only

48f4613

works e2e with all sources, complete refactor

2e2de7c

satvu force-pushed the satvu/app-capabilities-prototype branch from 5871c63 to 2e2de7c Compare February 12, 2026 21:27

satvu commented Feb 12, 2026

View reviewed changes

src/WebJobs.Script/AppCapabilities/AppCapabilitiesChangeTokenSource.cs Outdated Show resolved Hide resolved

liliankasem reviewed Feb 13, 2026

View reviewed changes

satvu added 2 commits February 18, 2026 15:04

remove options from webhost scope

17d8dbc

fix compilation failures in test classes

a3fc5ae

satvu marked this pull request as ready for review February 19, 2026 19:16

satvu requested a review from a team as a code owner February 19, 2026 19:16

Copilot AI review requested due to automatic review settings February 19, 2026 19:16

jviau requested changes Mar 5, 2026

View reviewed changes

microsoft-github-policy-service bot added Needs: Author Feedback and removed Needs: Author Feedback labels Mar 5, 2026

brettsam requested changes Mar 6, 2026

View reviewed changes

microsoft-github-policy-service bot added Needs: Author Feedback and removed Needs: Author Feedback labels Mar 6, 2026

respond to comments, update tests

4687eae

jviau reviewed Mar 10, 2026

View reviewed changes

satvu added 4 commits March 17, 2026 17:10

resolve some comments

560f43d

update trigger change behavior

5c104e7

Merge branch 'dev' into satvu/app-capabilities-prototype

06ae728

resolve worker channel changes

862f0ed

satvu requested review from brettsam, Copilot and jviau March 18, 2026 18:07

Copilot AI reviewed Mar 18, 2026

View reviewed changes

satvu and others added 5 commits March 18, 2026 15:14

Typo fix for pull request finding

cf50645

Co-authored-by: Copilot Autofix powered by AI <[email protected]>

update xml comment for accuracy

0991f32

Co-authored-by: Copilot Autofix powered by AI <[email protected]>

resolve tests and spelling errors

b90bc86

Merge branch 'satvu/app-capabilities-prototype' of https://github.com…

5624797

…/Azure/azure-functions-host into satvu/app-capabilities-prototype

add resource contains secrets attribute

e12ae5c

liliankasem reviewed Mar 18, 2026

View reviewed changes

resolve comments

ec4bdd4

satvu requested a review from liliankasem March 19, 2026 20:27

Merge branch 'dev' into satvu/app-capabilities-prototype

878f6e3

kshyju reviewed Mar 19, 2026

View reviewed changes

src/WebJobs.Script.WebHost/AppCapabilities/AppCapabilitiesController.cs Outdated Show resolved Hide resolved

satvu added 3 commits March 23, 2026 13:01

add jsonserializercontext, fix test

56489b7

fix whitespace compilation issues

e7abc7d

rm local debugging changes

f309250

satvu requested a review from kshyju March 23, 2026 22:20

Conversation

satvu commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue describing the changes in this PR

Pull request checklist

Additional Comments

Related PRs:

Uh oh!

Uh oh!

Uh oh!

Uh oh!

satvu Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

liliankasem left a comment

Choose a reason for hiding this comment

Uh oh!

jviau left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jviau Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

brettsam Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

satvu Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

satvu commented Jan 22, 2026 •

edited

Loading

satvu Jan 22, 2026 •

edited

Loading

satvu Mar 6, 2026 •

edited

Loading