Add methods docs to typescript

Author: agu-z

AGENTS.md

@@ -1 +1,7 @@
 All paths in the protocol should be absolute
+
+When updating JSON-RPC methods, their params, or output:
+
+- Update the mintlify docs and guides in the `docs` directory
+- Run `npm run check` to make sure the json and zod schemas gets generated properly
+- Params and responses docs make it to the schema, but the method-level docs, so make sure to update the typescript library accordingly.

docs/protocol/file-system.mdx

@@ -95,7 +95,7 @@ The `fs/write_text_file` method allows Agents to write or update text files in t
 </ParamField>
 
 <ParamField path="path" type="string" required>
-  Absolute path to the file to write.
+Absolute path to the file to write.
 
 The Client **MUST** create the file if it doesn't exist.
 

docs/protocol/initialization.mdx

@@ -119,8 +119,8 @@ The Agent **SHOULD** specify whether it supports the following capabilities:
 </ResponseField>
 
 <ResponseField name="promptCapabilities" type="PromptCapabilities Object">
-  Object indicating the different types of [content](./content) that may be included in
-  `session/prompt` requests.
+  Object indicating the different types of [content](./content) that may be
+  included in `session/prompt` requests.
 </ResponseField>
 
 #### Prompt capabilities

docs/protocol/overview.mdx

@@ -20,14 +20,17 @@ A typical conversation follows this pattern:
 
 <Steps>
 <Step title="Initialization Phase">
-   - Client → Agent: `initialize` to establish connection
-   - Client → Agent: `authenticate` if required by the Agent
+
+- Client → Agent: `initialize` to establish connection
+- Client → Agent: `authenticate` if required by the Agent
+
 </Step>
 
-<Step title="Session Setup">
-  Either:
-  - Client → Agent: `session/new` to create a new session
-  - Client → Agent: `session/load` to resume an existing session if supported
+<Step title="Session Setup - either:">
+
+- Client → Agent: `session/new` to create a new session
+- Client → Agent: `session/load` to resume an existing session if supported
+
 </Step>
 
 <Step title="Prompt Turn">
@@ -64,13 +67,15 @@ Agents are programs that use generative AI to autonomously modify code. They typ
 ### Optional Methods
 
 <ParamField path="session/load">
-  [Load an existing session](./session-setup#loading-sessions) (requires `loadSession` capability).
+  [Load an existing session](./session-setup#loading-sessions) (requires
+  `loadSession` capability).
 </ParamField>
 
 ### Notifications
 
 <ParamField path="session/cancel">
-  [Cancel ongoing operations](./prompt-turn#cancellation) (no response expected).
+  [Cancel ongoing operations](./prompt-turn#cancellation) (no response
+  expected).
 </ParamField>
 
 ## Client
@@ -80,23 +85,27 @@ Clients provide the interface between users and agents. They are typically code
 ### Baseline Methods
 
 <ParamField path="session/request_permission">
-  [Request user authorization](./tool-calls#requesting-permission) for tool calls.
+  [Request user authorization](./tool-calls#requesting-permission) for tool
+  calls.
 </ParamField>
 
 ### Optional Methods
 
 <ParamField path="fs/read_text_file">
-  [Read file contents](./file-system#reading-files) (requires `fs.readTextFile` capability).
+  [Read file contents](./file-system#reading-files) (requires `fs.readTextFile`
+  capability).
 </ParamField>
 
 <ParamField path="fs/write_text_file">
-  [Write file contents](./file-system#writing-files) (requires `fs.writeTextFile` capability).
+  [Write file contents](./file-system#writing-files) (requires
+  `fs.writeTextFile` capability).
 </ParamField>
 
 ### Notifications
 
 <ParamField path="session/update">
-  [Send progress updates](./prompt-turn#3-agent-reports-output) during prompt processing (no response expected).
+  [Send progress updates](./prompt-turn#3-agent-reports-output) during prompt
+  processing (no response expected).
 </ParamField>
 
 ## Argument requirements

rust/agent.rs

@@ -48,6 +48,7 @@ pub trait Agent {
     /// Creates a new conversation session with the agent.
     ///
     /// Sessions represent independent conversation contexts with their own history and state.
+    ///
     /// The agent should:
     /// - Create a new session context
     /// - Connect to any specified MCP servers
@@ -66,6 +67,7 @@ pub trait Agent {
     /// Loads an existing session to resume a previous conversation.
     ///
     /// This method is only available if the agent advertises the `loadSession` capability.
+    ///
     /// The agent should:
     /// - Restore the session context and conversation history
     /// - Connect to the specified MCP servers
@@ -79,9 +81,11 @@ pub trait Agent {
 
     /// Processes a user prompt within a session.
     ///
-    /// This is the core interaction method where the agent:
+    /// This method handles the whole lifecycle of a prompt:
     /// - Receives user messages with optional context (files, images, etc.)
     /// - Processes the prompt using language models
+    /// - Reports language model content and tool calls to the Clients
+    /// - Requests permission to run tools
     /// - Executes any requested tool calls
     /// - Returns when the turn is complete with a stop reason
     ///