NegotiatedCapabilities

java.lang.Object
- com.agentclientprotocol.sdk.capabilities.NegotiatedCapabilities

public final class NegotiatedCapabilities
extends java.lang.Object

Tracks the capabilities negotiated during the ACP initialization handshake.

After the initialize exchange, both client and agent know what features the other side supports. This class provides convenient methods to check capabilities and validate that operations are supported before attempting them.

Example usage for an agent checking client capabilities:


 NegotiatedCapabilities caps = NegotiatedCapabilities.fromClient(clientCapabilities);

 // Check before calling fs/read_text_file
 if (caps.supportsReadTextFile()) {
     agent.readTextFile(request);
 }

 // Or require the capability (throws if not supported)
 caps.requireReadTextFile();
 agent.readTextFile(request);

Example usage for a client checking agent capabilities:


 NegotiatedCapabilities caps = NegotiatedCapabilities.fromAgent(agentCapabilities);

 // Check if agent supports image content
 if (caps.supportsImageContent()) {
     prompt.add(imageContent);
 }

另请参阅:: AcpSchema.ClientCapabilities, AcpSchema.AgentCapabilities

嵌套类概要

嵌套类
限定符和类型类和说明

static class NegotiatedCapabilities.Builder
Builder for NegotiatedCapabilities.

嵌套类
限定符和类型	类和说明
`static class`	`NegotiatedCapabilities.Builder` Builder for NegotiatedCapabilities.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static NegotiatedCapabilities`	`fromAgent(AcpSchema.AgentCapabilities caps)` Creates negotiated capabilities from agent capabilities (used by clients).
`static NegotiatedCapabilities`	`fromClient(AcpSchema.ClientCapabilities caps)` Creates negotiated capabilities from client capabilities (used by agents).
`void`	`requireAudioContent()` Requires audio content capability, throwing if not supported.
`void`	`requireImageContent()` Requires image content capability, throwing if not supported.
`void`	`requireLoadSession()` Requires load session capability, throwing if not supported.
`void`	`requireReadTextFile()` Requires read text file capability, throwing if not supported.
`void`	`requireTerminal()` Requires terminal capability, throwing if not supported.
`void`	`requireWriteTextFile()` Requires write text file capability, throwing if not supported.
`boolean`	`supportsAudioContent()` Returns true if the agent supports audio content in prompts.
`boolean`	`supportsEmbeddedContext()` Returns true if the agent supports embedded context (resources) in prompts.
`boolean`	`supportsImageContent()` Returns true if the agent supports image content in prompts.
`boolean`	`supportsLoadSession()` Returns true if the agent supports loading sessions.
`boolean`	`supportsMcpHttp()` Returns true if the agent supports MCP servers via HTTP.
`boolean`	`supportsMcpSse()` Returns true if the agent supports MCP servers via SSE.
`boolean`	`supportsReadTextFile()` Returns true if the client supports reading text files.
`boolean`	`supportsTerminal()` Returns true if the client supports terminal operations.
`boolean`	`supportsWriteTextFile()` Returns true if the client supports writing text files.
`java.lang.String`	`toString()`

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

- 方法详细资料
  - fromClient
```
public static NegotiatedCapabilities fromClient(AcpSchema.ClientCapabilities caps)
```
    Creates negotiated capabilities from client capabilities (used by agents).
    
    参数:
    
    caps - the client's advertised capabilities, may be null
    
    返回:
    
    negotiated capabilities based on client
  - fromAgent
```
public static NegotiatedCapabilities fromAgent(AcpSchema.AgentCapabilities caps)
```
    Creates negotiated capabilities from agent capabilities (used by clients).
    
    参数:
    
    caps - the agent's advertised capabilities, may be null
    
    返回:
    
    negotiated capabilities based on agent
  - supportsReadTextFile
```
public boolean supportsReadTextFile()
```
    Returns true if the client supports reading text files.
    
    返回:
    
    true if fs.readTextFile capability was advertised
  - supportsWriteTextFile
```
public boolean supportsWriteTextFile()
```
    Returns true if the client supports writing text files.
    
    返回:
    
    true if fs.writeTextFile capability was advertised
  - supportsTerminal
```
public boolean supportsTerminal()
```
    Returns true if the client supports terminal operations.
    
    返回:
    
    true if terminal capability was advertised
  - requireReadTextFile
```
public void requireReadTextFile()
```
    Requires read text file capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the client doesn't support this capability
  - requireWriteTextFile
```
public void requireWriteTextFile()
```
    Requires write text file capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the client doesn't support this capability
  - requireTerminal
```
public void requireTerminal()
```
    Requires terminal capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the client doesn't support this capability
  - supportsLoadSession
```
public boolean supportsLoadSession()
```
    Returns true if the agent supports loading sessions.
    
    返回:
    
    true if loadSession capability was advertised
  - supportsImageContent
```
public boolean supportsImageContent()
```
    Returns true if the agent supports image content in prompts.
    
    返回:
    
    true if promptCapabilities.image was advertised
  - supportsAudioContent
```
public boolean supportsAudioContent()
```
    Returns true if the agent supports audio content in prompts.
    
    返回:
    
    true if promptCapabilities.audio was advertised
  - supportsEmbeddedContext
```
public boolean supportsEmbeddedContext()
```
    Returns true if the agent supports embedded context (resources) in prompts.
    
    返回:
    
    true if promptCapabilities.embeddedContext was advertised
  - supportsMcpHttp
```
public boolean supportsMcpHttp()
```
    Returns true if the agent supports MCP servers via HTTP.
    
    返回:
    
    true if mcpCapabilities.http was advertised
  - supportsMcpSse
```
public boolean supportsMcpSse()
```
    Returns true if the agent supports MCP servers via SSE.
    
    返回:
    
    true if mcpCapabilities.sse was advertised
  - requireLoadSession
```
public void requireLoadSession()
```
    Requires load session capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the agent doesn't support this capability
  - requireImageContent
```
public void requireImageContent()
```
    Requires image content capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the agent doesn't support this capability
  - requireAudioContent
```
public void requireAudioContent()
```
    Requires audio content capability, throwing if not supported.
    
    抛出:
    
    AcpCapabilityException - if the agent doesn't support this capability
  - toString
```
public java.lang.String toString()
```
    覆盖:
    
    toString 在类中 java.lang.Object

类 NegotiatedCapabilities

嵌套类概要

方法概要

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

方法详细资料

fromClient

fromAgent

supportsReadTextFile

supportsWriteTextFile

supportsTerminal

requireReadTextFile

requireWriteTextFile

requireTerminal

supportsLoadSession

supportsImageContent

supportsAudioContent

supportsEmbeddedContext

supportsMcpHttp

supportsMcpSse

requireLoadSession

requireImageContent

requireAudioContent

toString