AcpClient.AsyncSpec

java.lang.Object
- com.agentclientprotocol.sdk.client.AcpClient.AsyncSpec

封闭接口:

AcpClient
```
public static class AcpClient.AsyncSpec
extends java.lang.Object
```
Asynchronous client specification. This class follows the builder pattern to provide a fluent API for setting up clients with custom configurations.
The builder supports configuration of:
- Transport layer for client-agent communication
- Request timeouts for operation boundaries
- Client capabilities for feature negotiation
- Request handlers for incoming agent requests (file operations, etc.)
- Notification handlers for streaming updates

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`AcpAsyncClient`	`build()` Creates an instance of `AcpAsyncClient` with the provided configurations or sensible defaults.
`AcpClient.AsyncSpec`	`clientCapabilities(AcpSchema.ClientCapabilities clientCapabilities)` Sets the client capabilities that will be advertised to the agent during initialization.
`AcpClient.AsyncSpec`	`createTerminalHandler(java.util.function.Function<AcpSchema.CreateTerminalRequest,reactor.core.publisher.Mono<AcpSchema.CreateTerminalResponse>> handler)` Adds a typed handler for terminal creation requests from the agent.
`AcpClient.AsyncSpec`	`killTerminalHandler(java.util.function.Function<AcpSchema.KillTerminalCommandRequest,reactor.core.publisher.Mono<AcpSchema.KillTerminalCommandResponse>> handler)` Adds a typed handler for terminal kill requests from the agent.
`AcpClient.AsyncSpec`	`notificationHandler(java.lang.String method, AcpClientSession.NotificationHandler handler)` Adds a custom notification handler for a specific method.
`AcpClient.AsyncSpec`	`readTextFileHandler(java.util.function.Function<AcpSchema.ReadTextFileRequest,reactor.core.publisher.Mono<AcpSchema.ReadTextFileResponse>> handler)` Adds a typed handler for file system read requests from the agent.
`AcpClient.AsyncSpec`	`releaseTerminalHandler(java.util.function.Function<AcpSchema.ReleaseTerminalRequest,reactor.core.publisher.Mono<AcpSchema.ReleaseTerminalResponse>> handler)` Adds a typed handler for terminal release requests from the agent.
`AcpClient.AsyncSpec`	`requestHandler(java.lang.String method, AcpClientSession.RequestHandler<?> handler)` Adds a custom request handler for a specific method.
`AcpClient.AsyncSpec`	`requestPermissionHandler(java.util.function.Function<AcpSchema.RequestPermissionRequest,reactor.core.publisher.Mono<AcpSchema.RequestPermissionResponse>> handler)` Adds a typed handler for permission requests from the agent.
`AcpClient.AsyncSpec`	`requestTimeout(java.time.Duration requestTimeout)` Sets the duration to wait for agent responses before timing out requests.
`AcpClient.AsyncSpec`	`sessionUpdateConsumer(java.util.function.Function<AcpSchema.SessionNotification,reactor.core.publisher.Mono<java.lang.Void>> sessionUpdateConsumer)` Adds a consumer to be notified when session update notifications are received from the agent.
`AcpClient.AsyncSpec`	`terminalOutputHandler(java.util.function.Function<AcpSchema.TerminalOutputRequest,reactor.core.publisher.Mono<AcpSchema.TerminalOutputResponse>> handler)` Adds a typed handler for terminal output requests from the agent.
`AcpClient.AsyncSpec`	`waitForTerminalExitHandler(java.util.function.Function<AcpSchema.WaitForTerminalExitRequest,reactor.core.publisher.Mono<AcpSchema.WaitForTerminalExitResponse>> handler)` Adds a typed handler for wait-for-terminal-exit requests from the agent.
`AcpClient.AsyncSpec`	`writeTextFileHandler(java.util.function.Function<AcpSchema.WriteTextFileRequest,reactor.core.publisher.Mono<AcpSchema.WriteTextFileResponse>> handler)` Adds a typed handler for file system write requests from the agent.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - requestTimeout
```
public AcpClient.AsyncSpec requestTimeout(java.time.Duration requestTimeout)
```
    Sets the duration to wait for agent responses before timing out requests. This timeout applies to all requests made through the client, including initialize, prompt, and session operations.
    
    参数:
    
    requestTimeout - The duration to wait before timing out requests. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if requestTimeout is null
  - clientCapabilities
```
public AcpClient.AsyncSpec clientCapabilities(AcpSchema.ClientCapabilities clientCapabilities)
```
    Sets the client capabilities that will be advertised to the agent during initialization. Capabilities define what features the client supports, such as file system operations, terminal access, and authentication methods.
    
    参数:
    
    clientCapabilities - The client capabilities configuration. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if clientCapabilities is null
  - readTextFileHandler
```
public AcpClient.AsyncSpec readTextFileHandler(java.util.function.Function<AcpSchema.ReadTextFileRequest,reactor.core.publisher.Mono<AcpSchema.ReadTextFileResponse>> handler)
```
    Adds a typed handler for file system read requests from the agent. This is the preferred method as it provides type-safe request handling without manual unmarshalling.
    Example usage:
```
 .readTextFileHandler(req ->
     Mono.fromCallable(() -> Files.readString(Path.of(req.path())))
         .map(ReadTextFileResponse::new))
 
```
    参数:
    
    handler - The typed handler function that processes read requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - writeTextFileHandler
```
public AcpClient.AsyncSpec writeTextFileHandler(java.util.function.Function<AcpSchema.WriteTextFileRequest,reactor.core.publisher.Mono<AcpSchema.WriteTextFileResponse>> handler)
```
    Adds a typed handler for file system write requests from the agent. This is the preferred method as it provides type-safe request handling without manual unmarshalling.
    Example usage:
```
 .writeTextFileHandler(req ->
     Mono.fromRunnable(() -> Files.writeString(Path.of(req.path()), req.content()))
         .then(Mono.just(new WriteTextFileResponse())))
 
```
    参数:
    
    handler - The typed handler function that processes write requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - requestPermissionHandler
```
public AcpClient.AsyncSpec requestPermissionHandler(java.util.function.Function<AcpSchema.RequestPermissionRequest,reactor.core.publisher.Mono<AcpSchema.RequestPermissionResponse>> handler)
```
    Adds a typed handler for permission requests from the agent. This is the preferred method as it provides type-safe request handling without manual unmarshalling.
    Example usage:
```
 .requestPermissionHandler(req ->
     Mono.just(new RequestPermissionResponse(
         new RequestPermissionOutcome("approve", null))))
 
```
    参数:
    
    handler - The typed handler function that processes permission requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - createTerminalHandler
```
public AcpClient.AsyncSpec createTerminalHandler(java.util.function.Function<AcpSchema.CreateTerminalRequest,reactor.core.publisher.Mono<AcpSchema.CreateTerminalResponse>> handler)
```
    Adds a typed handler for terminal creation requests from the agent.
    Example usage:
```
 .createTerminalHandler(req -> {
     String terminalId = UUID.randomUUID().toString();
     // Start process with req.command(), req.args(), req.cwd()
     return Mono.just(new CreateTerminalResponse(terminalId));
 })
 
```
    参数:
    
    handler - The typed handler function that processes terminal creation requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - terminalOutputHandler
```
public AcpClient.AsyncSpec terminalOutputHandler(java.util.function.Function<AcpSchema.TerminalOutputRequest,reactor.core.publisher.Mono<AcpSchema.TerminalOutputResponse>> handler)
```
    Adds a typed handler for terminal output requests from the agent.
    Example usage:
```
 .terminalOutputHandler(req -> {
     String output = getTerminalOutput(req.terminalId());
     return Mono.just(new TerminalOutputResponse(output, false, null));
 })
 
```
    参数:
    
    handler - The typed handler function that processes terminal output requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - releaseTerminalHandler
```
public AcpClient.AsyncSpec releaseTerminalHandler(java.util.function.Function<AcpSchema.ReleaseTerminalRequest,reactor.core.publisher.Mono<AcpSchema.ReleaseTerminalResponse>> handler)
```
    Adds a typed handler for terminal release requests from the agent.
    Example usage:
```
 .releaseTerminalHandler(req -> {
     releaseTerminal(req.terminalId());
     return Mono.just(new ReleaseTerminalResponse());
 })
 
```
    参数:
    
    handler - The typed handler function that processes terminal release requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - waitForTerminalExitHandler
```
public AcpClient.AsyncSpec waitForTerminalExitHandler(java.util.function.Function<AcpSchema.WaitForTerminalExitRequest,reactor.core.publisher.Mono<AcpSchema.WaitForTerminalExitResponse>> handler)
```
    Adds a typed handler for wait-for-terminal-exit requests from the agent.
    Example usage:
```
 .waitForTerminalExitHandler(req -> {
     int exitCode = waitForExit(req.terminalId());
     return Mono.just(new WaitForTerminalExitResponse(exitCode, null));
 })
 
```
    参数:
    
    handler - The typed handler function that processes wait-for-exit requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - killTerminalHandler
```
public AcpClient.AsyncSpec killTerminalHandler(java.util.function.Function<AcpSchema.KillTerminalCommandRequest,reactor.core.publisher.Mono<AcpSchema.KillTerminalCommandResponse>> handler)
```
    Adds a typed handler for terminal kill requests from the agent.
    Example usage:
```
 .killTerminalHandler(req -> {
     killProcess(req.terminalId());
     return Mono.just(new KillTerminalCommandResponse());
 })
 
```
    参数:
    
    handler - The typed handler function that processes terminal kill requests
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if handler is null
  - sessionUpdateConsumer
```
public AcpClient.AsyncSpec sessionUpdateConsumer(java.util.function.Function<AcpSchema.SessionNotification,reactor.core.publisher.Mono<java.lang.Void>> sessionUpdateConsumer)
```
    Adds a consumer to be notified when session update notifications are received from the agent. Session updates include agent thoughts, message chunks, and other streaming content during prompt processing.
    
    参数:
    
    sessionUpdateConsumer - A consumer that receives session update notifications. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if sessionUpdateConsumer is null
  - requestHandler
```
public AcpClient.AsyncSpec requestHandler(java.lang.String method,
                                          AcpClientSession.RequestHandler<?> handler)
```
    Adds a custom request handler for a specific method. This allows handling additional agent requests beyond the standard file system and permission operations.
    
    参数:
    
    method - The method name (e.g., "custom/operation")
    
    handler - The handler function for this method
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if method or handler is null
  - notificationHandler
```
public AcpClient.AsyncSpec notificationHandler(java.lang.String method,
                                               AcpClientSession.NotificationHandler handler)
```
    Adds a custom notification handler for a specific method. This allows handling additional agent notifications beyond session updates.
    
    参数:
    
    method - The method name (e.g., "custom/notification")
    
    handler - The handler function for this method
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if method or handler is null
  - build
```
public AcpAsyncClient build()
```
    Creates an instance of AcpAsyncClient with the provided configurations or sensible defaults.
    
    返回:
    
    a new instance of AcpAsyncClient

类 AcpClient.AsyncSpec

方法概要

从类继承的方法 java.lang.Object

方法详细资料

requestTimeout

clientCapabilities

readTextFileHandler

writeTextFileHandler

requestPermissionHandler

createTerminalHandler

terminalOutputHandler

releaseTerminalHandler

waitForTerminalExitHandler

killTerminalHandler

sessionUpdateConsumer

requestHandler

notificationHandler

build