Update API docs for Aspire 13.4 (#1132)

Regenerate the integration catalog, C# API JSON, TypeScript API JSON, and twoslash declarations from the release/13.4 NuGet feed.

Co-authored-by: David Pine <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: IEvangelist

src/frontend/scripts/generate-twoslash-types.ts

@@ -397,6 +397,13 @@ export declare const InputType: {
 }`,
 ];
 
+const POST_SNAPSHOT_DECLARATION_TYPE_NAMES = new Set([
+  'BeforePublishEvent',
+  'AfterPublishEvent',
+  'InputType',
+  'ParameterCustomInputOptions',
+]);
+
 const POST_SNAPSHOT_AUGMENTATIONS = [
   `export interface IDistributedApplicationBuilder {
   /**
@@ -614,10 +621,15 @@ const BUILT_IN = new Set([
 ]);
 
 const declaredTypes = new Set<string>([
-  ...dtoTypes.map((d) => d.name),
-  ...enumTypes.map((e) => e.name),
+  ...dtoTypes
+    .filter((d) => !POST_SNAPSHOT_DECLARATION_TYPE_NAMES.has(d.name))
+    .map((d) => d.name),
+  ...enumTypes
+    .filter((e) => !POST_SNAPSHOT_DECLARATION_TYPE_NAMES.has(e.name))
+    .map((e) => e.name),
   ...handleTypes.map((h) => h.name),
   ...methodsByTarget.keys(),
+  ...POST_SNAPSHOT_DECLARATION_TYPE_NAMES,
 ]);
 
 const parts: string[] = [];
@@ -653,6 +665,7 @@ for (const declaration of POST_SNAPSHOT_DECLARATIONS) {
   parts.push('');
 }
 for (const en of enumTypes) {
+  if (POST_SNAPSHOT_DECLARATION_TYPE_NAMES.has(en.name)) continue;
   parts.push(jsdoc([`Enum ${en.fullName}`]));
   const members = en.members.map((m) => JSON.stringify(m)).join(' | ') || 'string';
   parts.push(`export type ${en.name} = ${members};`);
@@ -669,6 +682,7 @@ for (const en of enumTypes) {
 
 parts.push(`// ---- DTOs ----`);
 for (const dto of dtoTypes) {
+  if (POST_SNAPSHOT_DECLARATION_TYPE_NAMES.has(dto.name)) continue;
   parts.push(jsdoc([`DTO ${dto.fullName}`]));
   parts.push(`export interface ${dto.name} {`);
   for (const f of dto.fields) {

src/frontend/src/content/docs/integrations/ai/github-models/github-models-host.mdx

@@ -278,7 +278,7 @@ import { createBuilder, GitHubModelName } from './.aspire/modules/aspire.mjs';
 const builder = await createBuilder();
 
 const chat = await builder.addGitHubModel("chat", GitHubModelName.OpenAIGpt4oMini);
-await chat.withHealthCheck();
+chat.enableHealthCheck();
 
 await builder.addNodeApp("api", "./api", "index.js")
     .withReference(chat);

src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx

@@ -351,7 +351,7 @@ await foundry
 
 ## Publish a hosted agent to Azure AI Foundry
 
-Use `PublishAsHostedAgent` to publish an executable or containerized app as a hosted agent in a Foundry project:
+Use `PublishAsHostedAgent` in C# or `withComputeEnvironment` in TypeScript to publish an executable or containerized app as a hosted agent in a Foundry project:
 
 <Tabs syncKey='aspire-lang'>
 <TabItem id='csharp' label='C#'>
@@ -397,22 +397,22 @@ await builder
   .addPythonApp('agent-python', '../agent', 'main:app')
   .withReference(project)
   .withReference(chat)
-  .publishAsHostedAgent({ project });
+  .withComputeEnvironment({ project });
 
 await builder
   .addProject('agent-dotnet', '../Agent/Agent.csproj')
   .withHttpEndpoint({ targetPort: 9000 })
   .withReference(project)
   .withReference(chat)
-  .publishAsHostedAgent({ project });
+  .withComputeEnvironment({ project });
 
 await builder.build().run();
 ```
 
 </TabItem>
 </Tabs>
 
-In run mode, `PublishAsHostedAgent(...)` configures a local `http` endpoint for the agent. Aspire first checks whether the resource already has an endpoint named `http`. If that endpoint has a target port, Aspire preserves it. If there is no existing `http` target port, Aspire defaults to `8088`.
+In run mode, the hosted-agent configuration configures a local `http` endpoint for the agent. Aspire first checks whether the resource already has an endpoint named `http`. If that endpoint has a target port, Aspire preserves it. If there is no existing `http` target port, Aspire defaults to `8088`.
 
 Aspire also injects the selected port as `DEFAULT_AD_PORT`, so hosted-agent apps can bind to the right port:
 
@@ -421,7 +421,7 @@ var port = Environment.GetEnvironmentVariable("DEFAULT_AD_PORT") ?? "8088";
 builder.WebHost.UseUrls($"http://+:{port}");
 ```
 
-If your hosted agent listens on a different port, declare the endpoint before calling `PublishAsHostedAgent(...)`:
+If your hosted agent listens on a different port, declare the endpoint before configuring the resource as a hosted agent:
 
 <Tabs syncKey="aspire-lang">
 <TabItem id="csharp" label="C#">
@@ -450,7 +450,7 @@ const dotnetWeatherAgent = await builder
   .withReference(chat)
   .waitFor(chat);
 
-await dotnetWeatherAgent.publishAsHostedAgent({ project });
+await dotnetWeatherAgent.withComputeEnvironment({ project });
 ```
 
 </TabItem>
@@ -509,12 +509,14 @@ const webSearch = await project.addWebSearchTool('web-search');
 
 await project
   .addPromptAgent(
-    chat,
     'web-researcher',
-    `
+    chat,
+    {
+      instructions: `
     You are the Web Researcher. Use web search for current information,
     cite sources, summarize tradeoffs, and keep answers concise and practical.
-  `
+  `,
+    }
   )
   .withTool(webSearch);
 

src/frontend/src/content/docs/integrations/cloud/azure/azure-openai/azure-openai-host.mdx

@@ -185,7 +185,7 @@ Referencing `chat` passes a connection named `chat` to the consuming project, an
 
 By default, Aspire provisions Azure OpenAI with `disableLocalAuth: true` and automatically creates a `CognitiveServicesOpenAIUser` role assignment for each app that references the resource. This means consuming apps authenticate via managed identity — no API key is needed.
 
-To explicitly assign roles to a consuming app (for example, to grant contributor access for fine-tuning scenarios), call `WithRoleAssignments` (or `withRoleAssignments`) on the consuming resource:
+To explicitly assign roles to a consuming app (for example, to grant contributor access for fine-tuning scenarios), call `WithRoleAssignments` in C# or `withCognitiveServicesRoleAssignments` in TypeScript on the consuming resource:
 
 <Tabs syncKey="aspire-lang">
 <TabItem id="csharp" label="C#">
@@ -219,7 +219,7 @@ const chat = await openai.addDeployment("chat", "gpt-4o", "2024-08-06");
 await builder.addNodeApp("api", "./api", "index.js")
     .withReference(chat)
     .waitFor(chat)
-    .withRoleAssignments(openai, [AzureOpenAIRole.CognitiveServicesOpenAIContributor]);
+    .withCognitiveServicesRoleAssignments(openai, [AzureOpenAIRole.CognitiveServicesOpenAIContributor]);
 
 // After adding all resources, run the app...
 ```

src/frontend/src/content/docs/integrations/cloud/azure/role-assignments.mdx

@@ -86,14 +86,14 @@ const builder = await createBuilder();
 const search = await builder.addAzureSearch("search");
 
 const api = await builder.addProject("api", "../Api/Api.csproj");
-await api.withRoleAssignments(search, [AzureSearchRole.SearchIndexDataReader]);
+await api.withSearchRoleAssignments(search, [AzureSearchRole.SearchIndexDataReader]);
 await api.withReference(search);
 ````
 
 </TabItem>
 </Tabs>
 
-When you use the `WithRoleAssignments` method, it replaces the default role assignments with the specified ones. This method requires two parameters: the resource to which the role assignment applies and the built-in role to assign. In the preceding example, the `search` resource is assigned the `Azure.Provisioning.Search.SearchBuiltInRole.SearchIndexDataReader` role.
+When you use the `WithRoleAssignments` method in C# or a resource-specific TypeScript role assignment method such as `withSearchRoleAssignments`, it replaces the default role assignments with the specified ones. This method requires two parameters: the resource to which the role assignment applies and the built-in role to assign. In the preceding example, the `search` resource is assigned the `Azure.Provisioning.Search.SearchBuiltInRole.SearchIndexDataReader` role.
 
 When you replace the default role assignments with the `SearchIndexDataReader` role, the API project is restricted to only reading data from the Azure Search resource. This ensures the API project can't write data to the Azure Search resource.
 

src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx

@@ -880,7 +880,7 @@ const chat = await project.addModelDeployment("chat", {
 await builder.addPythonApp("agent", "../agent", "main:app")
     .withReference(project)
     .withReference(chat)
-    .publishAsHostedAgent({ project });
+    .withComputeEnvironment({ project });
 
 await builder.build().run();
 ```

src/frontend/src/content/docs/whats-new/aspire-13-2.mdx

@@ -881,7 +881,7 @@ const chat = await project.addModelDeployment("chat", {
 await builder.addPythonApp("agent", "../agent", "main:app")
     .withReference(project)
     .withReference(chat)
-    .publishAsHostedAgent({ project });
+    .withComputeEnvironment({ project });
 
 await builder.build().run();
 ```