preparing documentation updates

Author: evalstate

docs/specification/draft/server/tools.mdx

@@ -230,6 +230,12 @@ Tool results may contain [**structured**](#structured-content) or **unstructured
 }
 ```
 
+#### Linked Resources
+
+[Resources](/specification/draft/server/resources) **MAY** be linked, to provide additional context
+or data, behind a URI that can be subscribed to or fetched again by the client later:
+
+
 #### Embedded Resources
 
 [Resources](/specification/draft/server/resources) **MAY** be embedded, to provide additional context

schema/draft/schema.ts

@@ -637,6 +637,20 @@ export interface PromptMessage {
   content: ContentBlock;
 }
 
+/**
+ *
+ * A reference to a resource descriptor, embedded into a prompt or tool call result.
+ *
+ * It is up to the client how best to render linked resources for the benefit
+ * of the LLM and/or the user.
+ *
+ */
+export interface LinkedResource {
+  type: "linkedresource";
+  resource: Resource;
+}
+
+
 /**
  * The contents of a resource, embedded into a prompt or tool call result.
  *
@@ -652,20 +666,6 @@ export interface EmbeddedResource {
    */
   annotations?: Annotations;
 }
-
-/**
- *
- * A resource descriptor, embedded into a prompt or tool call result.
- *
- * It is up to the client how best to render linked resources for the benefit
- * of the LLM and/or the user.
- *
- */
-export interface LinkedResource {
-  type: "linkedresource";
-  resource: Resource;
-}
-
 /**
  * An optional notification from the server to the client, informing it that the list of prompts it offers has changed. This may be issued by servers without any previous subscription from the client.
  */
@@ -971,8 +971,8 @@ export type ContentBlock =
   | TextContent
   | ImageContent
   | AudioContent
-  | EmbeddedResource
-  | LinkedResource;
+  | LinkedResource
+  | EmbeddedResource;
 
 /**
  * Text provided to or from an LLM.