updates api notes (microsoft#204386)

Author: jrieken

src/vscode-dts/vscode.proposed.chatAgents2.d.ts

@@ -64,6 +64,9 @@ declare module 'vscode' {
 		 * If the request resulted in an error, this property defines the error details.
 		 */
 		errorDetails?: ChatAgentErrorDetails;
+
+		// TODO@API
+		// add CATCH-all signature [name:string]: string|boolean|number instead of `T extends...`
 	}
 
 	/**

src/vscode-dts/vscode.proposed.chatProvider.d.ts

@@ -10,6 +10,8 @@ declare module 'vscode' {
 		part: string;
 	}
 
+	// @API extension ship a d.ts files for their options
+
 	/**
 	 * Represents a large language model that accepts ChatML messages and produces a streaming response
 	 */

src/vscode-dts/vscode.proposed.chatRequestAccess.d.ts

@@ -65,13 +65,15 @@ declare module 'vscode' {
 		 * Whether the access to chat has been revoked. This happens when the condition that allowed for
 		 * chat access doesn't hold anymore, e.g a user interaction has ended.
 		 */
-		isRevoked: boolean;
+		readonly isRevoked: boolean;
+
+		// @API do we need an event for revocation
 
 		/**
 		 * The name of the model that is used for this chat access. It is expected that the model name can
 		 * be used to lookup properties like token limits and ChatML support
 		 */
-		model: string;
+		readonly model: string;
 
 		/**
 		 * Make a chat request.
@@ -101,5 +103,9 @@ declare module 'vscode' {
 		 * @param id The id of the chat provider, e.g `copilot`
 		 */
 		export function requestChatAccess(id: string): Thenable<ChatAccess>;
+
+		//@API add those
+		// export const chatAccesses: string[];
+		// export const onDidChangeChatAccesses: Event<void>;
 	}
 }