Package org.machanism.machai.mcp.server

Class AbstractPromptGenaiAdapter<E,S,P>

java.lang.Object

org.machanism.machai.ai.provider.AbstractAIProvider

org.machanism.machai.mcp.server.GenericGenaiAdapter<E,S>

org.machanism.machai.mcp.server.AbstractPromptGenaiAdapter<E,S,P>

Type Parameters:

E - server exchange or transport context type

S - transport-specific tool specification type

P - transport-specific prompt specification type

All Implemented Interfaces:

Genai

Direct Known Subclasses:

HttpStatelessGenericGenaiAdapter, HttpStreamableGenericGenaiAdapter, StdioGenaiAdapter

abstract class AbstractPromptGenaiAdapter<E,S,P>
extends GenericGenaiAdapter<E,S>

Common prompt-registration support for MCP GenAI adapters.

Since:

1.2.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	AbstractPromptGenaiAdapter.PromptExecutionException

Field Summary

Fields

Modifier and Type	Field	Description
private final org.slf4j.Logger	log
private final List<P>	prompts

Fields inherited from class org.machanism.machai.ai.provider.AbstractAIProvider

chatModel, DEFAULT_WEBSEARCH_TYPE_NAME, ERROR_TOOL_RESULT_PREFIX, instructions, LINE_SEPARATOR, LOG_LINE_LENG, MAX_OUTPUT_TOKENS, maxOutputTokens, maxToolCalls, MCP_PROP_NAME_PREFIX, PARAGRAPH_SEPARATOR, PASSWORD_PROP_NAME, PROJECT_DIR_PARAM_NAME, projectDir, timeoutSec, USERNAME_PROP_NAME

Constructor Summary

Constructors

Constructor	Description
AbstractPromptGenaiAdapter(List<S> toolSpecifications, AbstractMcpServer.ToolSpecificationBuilder<E> toolSpecificationBuilder)

Method Summary

Modifier and Type	Method	Description
protected void	addPrompt(String name, String description, ToolFunction function, Role role, ParamDescriptor... paramsDesc)
private void	addPromptMessage(List<io.modelcontextprotocol.spec.McpSchema.PromptMessage> messages, String text, Role role)
private void	addPromptMessages(List<io.modelcontextprotocol.spec.McpSchema.PromptMessage> messages, Object result, com.fasterxml.jackson.databind.ObjectMapper mapper, Role role)
protected void	addSessionIdentifier(E exchange, Map<String,Object> arguments)	Adds transport-specific session data to prompt arguments when available.
protected abstract P	buildPromptSpecification(io.modelcontextprotocol.spec.McpSchema.Prompt prompt, BiFunction<E,io.modelcontextprotocol.spec.McpSchema.GetPromptRequest,io.modelcontextprotocol.spec.McpSchema.GetPromptResult> promptHandler)
private Object	executePrompt(ToolFunction function, com.fasterxml.jackson.databind.JsonNode parameters)
List<P>	getPrompts()	Returns the prompts registered with this adapter.

Methods inherited from class org.machanism.machai.mcp.server.GenericGenaiAdapter

addTool, perform, toHumanReadable

Methods inherited from class org.machanism.machai.ai.provider.AbstractAIProvider

addMcpServer, addMcpServers, addPrompts, addResource, addResources, addTools, addWebSearch, addWebSearch, clear, getConfigurator, getParamValue, getProjectDir, getTimeout, init, instructions, isErrorHandling, normalize, prompt, safelyInvokeTool, setErrorHandling, setProjectDir, setTimeout

Methods inherited from class java.lang.Object

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

Field Details

log

private final org.slf4j.Logger log

prompts

private final List<P> prompts

Constructor Details

AbstractPromptGenaiAdapter

AbstractPromptGenaiAdapter(List<S> toolSpecifications,
 AbstractMcpServer.ToolSpecificationBuilder<E> toolSpecificationBuilder)

Method Details

addPrompt

protected void addPrompt(String name,
 String description,
 ToolFunction function,
 Role role,
 ParamDescriptor... paramsDesc)

Overrides:

addPrompt in class AbstractAIProvider

executePrompt

private Object executePrompt(ToolFunction function,
 com.fasterxml.jackson.databind.JsonNode parameters)
                      throws AbstractPromptGenaiAdapter.PromptExecutionException

Throws:

AbstractPromptGenaiAdapter.PromptExecutionException

addSessionIdentifier

protected void addSessionIdentifier(E exchange,
 Map<String,Object> arguments)

Adds transport-specific session data to prompt arguments when available.

Parameters:

exchange - server exchange or transport context

arguments - prompt arguments

addPromptMessages

private void addPromptMessages(List<io.modelcontextprotocol.spec.McpSchema.PromptMessage> messages,
 Object result,
 com.fasterxml.jackson.databind.ObjectMapper mapper,
 Role role)
                        throws com.fasterxml.jackson.core.JsonProcessingException

Throws:

com.fasterxml.jackson.core.JsonProcessingException

addPromptMessage

private void addPromptMessage(List<io.modelcontextprotocol.spec.McpSchema.PromptMessage> messages,
 String text,
 Role role)

buildPromptSpecification

protected abstract P buildPromptSpecification(io.modelcontextprotocol.spec.McpSchema.Prompt prompt,
 BiFunction<E,io.modelcontextprotocol.spec.McpSchema.GetPromptRequest,io.modelcontextprotocol.spec.McpSchema.GetPromptResult> promptHandler)

getPrompts

public List<P> getPrompts()

Returns the prompts registered with this adapter.

Returns:

mutable list of transport-specific prompt specifications