PromptContext

```
public interface PromptContext
```
Context provided to prompt handlers for accessing agent capabilities.
This interface provides prompt handlers with everything they need to:
- Send session updates back to the client
- Request file operations from the client
- Request permissions from the client
- Create and manage terminals
- Query client capabilities
This follows the MCP SDK's "Exchange" pattern where handlers receive a context object with all necessary capabilities, eliminating the need for external references to the agent instance.
Example usage:
```
 agent.promptHandler((request, context) -> {
     // Send an update
     context.sendUpdate(sessionId, update);

     // Read a file (if client supports it)
     if (context.getClientCapabilities().supportsReadTextFile()) {
         var content = context.readTextFile(new ReadTextFileRequest(...)).block();
     }

     // Request permission
     var permission = context.requestPermission(new RequestPermissionRequest(...));

     return Mono.just(new PromptResponse(StopReason.END_TURN));
 });
 
```
从以下版本开始:

0.9.1

另请参阅:

AcpAgent.PromptHandler, SyncPromptContext

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`reactor.core.publisher.Mono<java.lang.String>`	`askChoice(java.lang.String question, java.lang.String... options)` Asks the client to choose from multiple options.
`reactor.core.publisher.Mono<java.lang.Boolean>`	`askPermission(java.lang.String action)` Asks the client for permission to perform an action.
`reactor.core.publisher.Mono<AcpSchema.CreateTerminalResponse>`	`createTerminal(AcpSchema.CreateTerminalRequest request)` Requests the client to create a terminal.
`reactor.core.publisher.Mono<CommandResult>`	`execute(Command command)` Executes a command with options and waits for completion.
`reactor.core.publisher.Mono<CommandResult>`	`execute(java.lang.String... commandAndArgs)` Executes a command in a terminal and waits for completion.
`NegotiatedCapabilities`	`getClientCapabilities()` Returns the capabilities negotiated with the client during initialization.
`java.lang.String`	`getSessionId()` Returns the session ID for this prompt invocation.
`reactor.core.publisher.Mono<AcpSchema.TerminalOutputResponse>`	`getTerminalOutput(AcpSchema.TerminalOutputRequest request)` Requests terminal output from the client.
`reactor.core.publisher.Mono<AcpSchema.KillTerminalCommandResponse>`	`killTerminal(AcpSchema.KillTerminalCommandRequest request)` Requests the client to kill a terminal.
`reactor.core.publisher.Mono<java.lang.String>`	`readFile(java.lang.String path)` Reads a text file from the client's file system.
`reactor.core.publisher.Mono<java.lang.String>`	`readFile(java.lang.String path, java.lang.Integer startLine, java.lang.Integer lineCount)` Reads a portion of a text file from the client's file system.
`reactor.core.publisher.Mono<AcpSchema.ReadTextFileResponse>`	`readTextFile(AcpSchema.ReadTextFileRequest request)` Requests the client to read a text file.
`reactor.core.publisher.Mono<AcpSchema.ReleaseTerminalResponse>`	`releaseTerminal(AcpSchema.ReleaseTerminalRequest request)` Requests the client to release a terminal.
`reactor.core.publisher.Mono<AcpSchema.RequestPermissionResponse>`	`requestPermission(AcpSchema.RequestPermissionRequest request)` Requests permission from the client for a sensitive operation.
`reactor.core.publisher.Mono<java.lang.Void>`	`sendMessage(java.lang.String text)` Sends a message to the client as an agent message chunk.
`reactor.core.publisher.Mono<java.lang.Void>`	`sendThought(java.lang.String text)` Sends a thought to the client as an agent thought chunk.
`reactor.core.publisher.Mono<java.lang.Void>`	`sendUpdate(java.lang.String sessionId, AcpSchema.SessionUpdate update)` Sends a session update notification to the client.
`reactor.core.publisher.Mono<AcpSchema.WaitForTerminalExitResponse>`	`waitForTerminalExit(AcpSchema.WaitForTerminalExitRequest request)` Waits for a terminal to exit.
`reactor.core.publisher.Mono<java.lang.Void>`	`writeFile(java.lang.String path, java.lang.String content)` Writes content to a text file on the client's file system.
`reactor.core.publisher.Mono<AcpSchema.WriteTextFileResponse>`	`writeTextFile(AcpSchema.WriteTextFileRequest request)` Requests the client to write a text file.

- 方法详细资料
  - sendUpdate
```
reactor.core.publisher.Mono<java.lang.Void> sendUpdate(java.lang.String sessionId,
                                                       AcpSchema.SessionUpdate update)
```
    Sends a session update notification to the client. Used for streaming updates during prompt processing.
    
    参数:
    
    sessionId - The session ID
    
    update - The session update to send
    
    返回:
    
    A Mono that completes when the notification is sent
  - readTextFile
```
reactor.core.publisher.Mono<AcpSchema.ReadTextFileResponse> readTextFile(AcpSchema.ReadTextFileRequest request)
```
    Requests the client to read a text file.
    
    参数:
    
    request - The read file request
    
    返回:
    
    A Mono containing the file content
    
    抛出:
    
    AcpCapabilityException - if client doesn't support file reading
  - writeTextFile
```
reactor.core.publisher.Mono<AcpSchema.WriteTextFileResponse> writeTextFile(AcpSchema.WriteTextFileRequest request)
```
    Requests the client to write a text file.
    
    参数:
    
    request - The write file request
    
    返回:
    
    A Mono that completes when the file is written
    
    抛出:
    
    AcpCapabilityException - if client doesn't support file writing
  - requestPermission
```
reactor.core.publisher.Mono<AcpSchema.RequestPermissionResponse> requestPermission(AcpSchema.RequestPermissionRequest request)
```
    Requests permission from the client for a sensitive operation.
    
    参数:
    
    request - The permission request
    
    返回:
    
    A Mono containing the permission response
  - createTerminal
```
reactor.core.publisher.Mono<AcpSchema.CreateTerminalResponse> createTerminal(AcpSchema.CreateTerminalRequest request)
```
    Requests the client to create a terminal.
    
    参数:
    
    request - The create terminal request
    
    返回:
    
    A Mono containing the terminal ID
    
    抛出:
    
    AcpCapabilityException - if client doesn't support terminals
  - getTerminalOutput
```
reactor.core.publisher.Mono<AcpSchema.TerminalOutputResponse> getTerminalOutput(AcpSchema.TerminalOutputRequest request)
```
    Requests terminal output from the client.
    
    参数:
    
    request - The terminal output request
    
    返回:
    
    A Mono containing the terminal output
  - releaseTerminal
```
reactor.core.publisher.Mono<AcpSchema.ReleaseTerminalResponse> releaseTerminal(AcpSchema.ReleaseTerminalRequest request)
```
    Requests the client to release a terminal.
    
    参数:
    
    request - The release terminal request
    
    返回:
    
    A Mono that completes when the terminal is released
  - waitForTerminalExit
```
reactor.core.publisher.Mono<AcpSchema.WaitForTerminalExitResponse> waitForTerminalExit(AcpSchema.WaitForTerminalExitRequest request)
```
    Waits for a terminal to exit.
    
    参数:
    
    request - The wait for exit request
    
    返回:
    
    A Mono containing the exit status
  - killTerminal
```
reactor.core.publisher.Mono<AcpSchema.KillTerminalCommandResponse> killTerminal(AcpSchema.KillTerminalCommandRequest request)
```
    Requests the client to kill a terminal.
    
    参数:
    
    request - The kill terminal request
    
    返回:
    
    A Mono that completes when the terminal is killed
  - getClientCapabilities
```
NegotiatedCapabilities getClientCapabilities()
```
    Returns the capabilities negotiated with the client during initialization.
    Use this to check what features the client supports before calling methods like readTextFile(com.agentclientprotocol.sdk.spec.AcpSchema.ReadTextFileRequest) or createTerminal(com.agentclientprotocol.sdk.spec.AcpSchema.CreateTerminalRequest).
    
    返回:
    
    the negotiated client capabilities, or null if not yet initialized
  - getSessionId
```
java.lang.String getSessionId()
```
    Returns the session ID for this prompt invocation.
    
    返回:
    
    the session ID
  - sendMessage
```
reactor.core.publisher.Mono<java.lang.Void> sendMessage(java.lang.String text)
```
    Sends a message to the client as an agent message chunk. This is a convenience method that wraps the text in the appropriate session update structure.
    
    参数:
    
    text - The message text to send
    
    返回:
    
    A Mono that completes when the message is sent
  - sendThought
```
reactor.core.publisher.Mono<java.lang.Void> sendThought(java.lang.String text)
```
    Sends a thought to the client as an agent thought chunk. Thoughts are typically displayed differently than messages, showing the agent's reasoning process.
    
    参数:
    
    text - The thought text to send
    
    返回:
    
    A Mono that completes when the thought is sent
  - readFile
```
reactor.core.publisher.Mono<java.lang.String> readFile(java.lang.String path)
```
    Reads a text file from the client's file system.
    
    参数:
    
    path - The path to the file
    
    返回:
    
    A Mono containing the file content
    
    抛出:
    
    AcpCapabilityException - if client doesn't support file reading
  - readFile
```
reactor.core.publisher.Mono<java.lang.String> readFile(java.lang.String path,
                                                       java.lang.Integer startLine,
                                                       java.lang.Integer lineCount)
```
    Reads a portion of a text file from the client's file system.
    
    参数:
    
    path - The path to the file
    
    startLine - The line number to start reading from (0-indexed, null for beginning)
    
    lineCount - The number of lines to read (null for all remaining)
    
    返回:
    
    A Mono containing the file content
    
    抛出:
    
    AcpCapabilityException - if client doesn't support file reading
  - writeFile
```
reactor.core.publisher.Mono<java.lang.Void> writeFile(java.lang.String path,
                                                      java.lang.String content)
```
    Writes content to a text file on the client's file system.
    
    参数:
    
    path - The path to the file
    
    content - The content to write
    
    返回:
    
    A Mono that completes when the file is written
    
    抛出:
    
    AcpCapabilityException - if client doesn't support file writing
  - askPermission
```
reactor.core.publisher.Mono<java.lang.Boolean> askPermission(java.lang.String action)
```
    Asks the client for permission to perform an action. Presents a simple Allow/Deny choice.
    
    参数:
    
    action - A description of the action to request permission for
    
    返回:
    
    A Mono containing true if allowed, false otherwise
  - askChoice
```
reactor.core.publisher.Mono<java.lang.String> askChoice(java.lang.String question,
                                                        java.lang.String... options)
```
    Asks the client to choose from multiple options.
    
    参数:
    
    question - The question to ask
    
    options - The available options (at least 2)
    
    返回:
    
    A Mono containing the selected option text, or null if cancelled
  - execute
```
reactor.core.publisher.Mono<CommandResult> execute(java.lang.String... commandAndArgs)
```
    Executes a command in a terminal and waits for completion. The terminal is automatically released after execution.
    
    参数:
    
    commandAndArgs - The command and arguments to execute
    
    返回:
    
    A Mono containing the command result
    
    抛出:
    
    AcpCapabilityException - if client doesn't support terminals
  - execute
```
reactor.core.publisher.Mono<CommandResult> execute(Command command)
```
    Executes a command with options and waits for completion. The terminal is automatically released after execution.
    
    参数:
    
    command - The command configuration
    
    返回:
    
    A Mono containing the command result
    
    抛出:
    
    AcpCapabilityException - if client doesn't support terminals

接口 PromptContext

方法概要

方法详细资料

sendUpdate

readTextFile

writeTextFile

requestPermission

createTerminal

getTerminalOutput

releaseTerminal

waitForTerminalExit

killTerminal

getClientCapabilities

getSessionId

sendMessage

sendThought

readFile

readFile

writeFile

askPermission

askChoice

execute

execute