com.agentclientprotocol.sdk.agent.support

类 AcpInvocationContext

java.lang.Object

com.agentclientprotocol.sdk.agent.support.AcpInvocationContext

public final class AcpInvocationContext
extends java.lang.Object

Context for a single method invocation, holding request data and runtime information needed by argument resolvers and interceptors.

从以下版本开始:

1.0.0

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	AcpInvocationContext.Builder Builder for AcpInvocationContext.

方法概要

限定符和类型	方法和说明
static AcpInvocationContext.Builder	builder() Create a new builder.
java.lang.String	getAcpMethod() Get the ACP method name (e.g., "initialize", "session/prompt").
java.util.Optional<java.lang.Object>	getAttribute(java.lang.String name) Get a custom attribute.
<T> java.util.Optional<T>	getAttribute(java.lang.String name, java.lang.Class<T> type) Get a typed custom attribute.
java.util.Optional<NegotiatedCapabilities>	getCapabilities() Get the negotiated capabilities.
java.util.Optional<PromptContext>	getPromptContext() Get the async prompt context if available.
java.lang.Object	getRequest() Get the request object.
<T> T	getRequest(java.lang.Class<T> type) Get the request cast to a specific type.
java.util.Optional<java.lang.String>	getSessionId() Get the session ID if available.
java.util.Optional<SyncPromptContext>	getSyncPromptContext() Get the sync prompt context if available.
void	setAttribute(java.lang.String name, java.lang.Object value) Set a custom attribute.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

builder

public static AcpInvocationContext.Builder builder()

Create a new builder.

返回:

a new builder

getAcpMethod

public java.lang.String getAcpMethod()

Get the ACP method name (e.g., "initialize", "session/prompt").

返回:

the method name

getRequest

public java.lang.Object getRequest()

Get the request object.

返回:

the request

getRequest

public <T> T getRequest(java.lang.Class<T> type)

Get the request cast to a specific type.

类型参数:

T - the type

参数:

type - the expected type

返回:

the typed request

抛出:

java.lang.ClassCastException - if the request is not of the expected type

getSessionId

public java.util.Optional<java.lang.String> getSessionId()

Get the session ID if available.

返回:

optional session ID

getPromptContext

public java.util.Optional<PromptContext> getPromptContext()

Get the async prompt context if available. Only present for prompt handlers.

返回:

optional prompt context

getSyncPromptContext

public java.util.Optional<SyncPromptContext> getSyncPromptContext()

Get the sync prompt context if available. Only present for prompt handlers.

返回:

optional sync prompt context

getCapabilities

public java.util.Optional<NegotiatedCapabilities> getCapabilities()

Get the negotiated capabilities.

返回:

optional capabilities

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)

Set a custom attribute.

参数:

name - attribute name

value - attribute value

getAttribute

public java.util.Optional<java.lang.Object> getAttribute(java.lang.String name)

Get a custom attribute.

参数:

name - attribute name

返回:

optional attribute value

getAttribute

public <T> java.util.Optional<T> getAttribute(java.lang.String name,
                                              java.lang.Class<T> type)

Get a typed custom attribute.

类型参数:

T - the type

参数:

name - attribute name

type - expected type

返回:

optional typed attribute value