AcpSyncAgent

java.lang.Object
- com.agentclientprotocol.sdk.agent.AcpSyncAgent

```
public class AcpSyncAgent
extends java.lang.Object
```
Synchronous ACP agent that provides blocking operations for handling client requests.
This is a blocking wrapper around AcpAsyncAgent that uses block() to convert reactive operations to blocking calls. Use this when you prefer a simpler synchronous API and don't need the scalability of non-blocking operations.

另请参阅:

AcpAsyncAgent, AcpAgent

构造器概要

构造器
构造器和说明
`AcpSyncAgent(AcpAsyncAgent asyncAgent)` Creates a new synchronous agent wrapping the given async agent.
`AcpSyncAgent(AcpAsyncAgent asyncAgent, java.time.Duration blockTimeout)` Creates a new synchronous agent wrapping the given async agent.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`AcpAsyncAgent`	`async()` Returns the underlying async agent.
`void`	`await()` Blocks until the agent terminates (transport closes).
`void`	`close()` Closes the agent immediately.
`void`	`closeGracefully()` Closes the agent gracefully, allowing pending operations to complete.
`AcpSchema.CreateTerminalResponse`	`createTerminal(AcpSchema.CreateTerminalRequest request)` Requests the client to create a terminal.
`NegotiatedCapabilities`	`getClientCapabilities()` Returns the capabilities negotiated with the client during initialization.
`AcpSchema.TerminalOutputResponse`	`getTerminalOutput(AcpSchema.TerminalOutputRequest request)` Requests terminal output from the client.
`AcpSchema.KillTerminalCommandResponse`	`killTerminal(AcpSchema.KillTerminalCommandRequest request)` Requests the client to kill a terminal.
`AcpSchema.ReadTextFileResponse`	`readTextFile(AcpSchema.ReadTextFileRequest request)` Requests the client to read a text file.
`AcpSchema.ReleaseTerminalResponse`	`releaseTerminal(AcpSchema.ReleaseTerminalRequest request)` Requests the client to release a terminal.
`AcpSchema.RequestPermissionResponse`	`requestPermission(AcpSchema.RequestPermissionRequest request)` Requests permission from the client for a sensitive operation.
`void`	`run()` Starts the agent and blocks until it terminates.
`void`	`sendSessionUpdate(java.lang.String sessionId, AcpSchema.SessionUpdate update)` Sends a session update notification to the client.
`void`	`start()` Starts the agent, beginning to accept client connections.
`AcpSchema.WaitForTerminalExitResponse`	`waitForTerminalExit(AcpSchema.WaitForTerminalExitRequest request)` Waits for a terminal to exit.
`AcpSchema.WriteTextFileResponse`	`writeTextFile(AcpSchema.WriteTextFileRequest request)` Requests the client to write a text file.

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

- 构造器详细资料
  - AcpSyncAgent
```
public AcpSyncAgent(AcpAsyncAgent asyncAgent)
```
    Creates a new synchronous agent wrapping the given async agent.
    
    参数:
    
    asyncAgent - The async agent to wrap
  - AcpSyncAgent
```
public AcpSyncAgent(AcpAsyncAgent asyncAgent,
                    java.time.Duration blockTimeout)
```
    Creates a new synchronous agent wrapping the given async agent.
    
    参数:
    
    asyncAgent - The async agent to wrap
    
    blockTimeout - The timeout for blocking operations
- 方法详细资料
  - start
```
public void start()
```
    Starts the agent, beginning to accept client connections. This method returns immediately after setup is complete. Use await() or run() to block until the transport closes.
  - await
```
public void await()
```
    Blocks until the agent terminates (transport closes). This is useful for keeping the main thread alive when using daemon threads.
    Example usage:
```
 agent.start();
 agent.await(); // Blocks until stdin closes
 
```
  - run
```
public void run()
```
    Starts the agent and blocks until it terminates. This is a convenience method combining start() and await().
    Example usage for a standalone agent:
```
 public static void main(String[] args) {
     AcpSyncAgent agent = AcpAgent.sync(transport)
         .promptHandler(...)
         .build();
     agent.run(); // Start and block until done
 }
 
```
  - sendSessionUpdate
```
public void sendSessionUpdate(java.lang.String sessionId,
                              AcpSchema.SessionUpdate update)
```
    Sends a session update notification to the client.
    
    参数:
    
    sessionId - The session ID
    
    update - The session update to send
  - requestPermission
```
public AcpSchema.RequestPermissionResponse requestPermission(AcpSchema.RequestPermissionRequest request)
```
    Requests permission from the client for a sensitive operation.
    
    参数:
    
    request - The permission request
    
    返回:
    
    The permission response
  - readTextFile
```
public AcpSchema.ReadTextFileResponse readTextFile(AcpSchema.ReadTextFileRequest request)
```
    Requests the client to read a text file.
    
    参数:
    
    request - The read file request
    
    返回:
    
    The file content
  - writeTextFile
```
public AcpSchema.WriteTextFileResponse writeTextFile(AcpSchema.WriteTextFileRequest request)
```
    Requests the client to write a text file.
    
    参数:
    
    request - The write file request
    
    返回:
    
    The write response
  - createTerminal
```
public AcpSchema.CreateTerminalResponse createTerminal(AcpSchema.CreateTerminalRequest request)
```
    Requests the client to create a terminal.
    
    参数:
    
    request - The create terminal request
    
    返回:
    
    The terminal ID response
  - getTerminalOutput
```
public AcpSchema.TerminalOutputResponse getTerminalOutput(AcpSchema.TerminalOutputRequest request)
```
    Requests terminal output from the client.
    
    参数:
    
    request - The terminal output request
    
    返回:
    
    The terminal output
  - releaseTerminal
```
public AcpSchema.ReleaseTerminalResponse releaseTerminal(AcpSchema.ReleaseTerminalRequest request)
```
    Requests the client to release a terminal.
    
    参数:
    
    request - The release terminal request
    
    返回:
    
    The release response
  - waitForTerminalExit
```
public AcpSchema.WaitForTerminalExitResponse waitForTerminalExit(AcpSchema.WaitForTerminalExitRequest request)
```
    Waits for a terminal to exit.
    
    参数:
    
    request - The wait for exit request
    
    返回:
    
    The exit status
  - killTerminal
```
public AcpSchema.KillTerminalCommandResponse killTerminal(AcpSchema.KillTerminalCommandRequest request)
```
    Requests the client to kill a terminal.
    
    参数:
    
    request - The kill terminal request
    
    返回:
    
    The kill response
  - getClientCapabilities
```
public NegotiatedCapabilities getClientCapabilities()
```
    Returns the capabilities negotiated with the client during initialization.
    This method returns null if initialization has not been completed yet. 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 initialized
  - async
```
public AcpAsyncAgent async()
```
    Returns the underlying async agent.
    
    返回:
    
    The async agent
  - closeGracefully
```
public void closeGracefully()
```
    Closes the agent gracefully, allowing pending operations to complete.
  - close
```
public void close()
```
    Closes the agent immediately.

类 AcpSyncAgent

构造器概要

方法概要

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

构造器详细资料

AcpSyncAgent

AcpSyncAgent

方法详细资料

start

await

run

sendSessionUpdate

requestPermission

readTextFile

writeTextFile

createTerminal

getTerminalOutput

releaseTerminal

waitForTerminalExit

killTerminal

getClientCapabilities

async

closeGracefully

close