Package com.flowable.platform.service.agent

Class AgentTimelinePdfService

java.lang.Object

com.flowable.platform.service.agent.AgentTimelinePdfService

public class AgentTimelinePdfService
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AgentTimelinePdfService.AgentInstanceInfo	Header details for a single-agent-invocation PDF.
static final record	AgentTimelinePdfService.ScopeInfo	Optional details about the work instance (case/process) the timeline belongs to.

Field Summary

Fields

Modifier and Type	Field	Description
protected final AgentModelPricingService	agentModelPricingService
protected final tools.jackson.databind.ObjectMapper	objectMapper
protected final AgentTimelinePdfRenderer	pdfRenderer
protected final PlatformAgentService	platformAgentService

Constructor Summary

Constructors

Constructor	Description
AgentTimelinePdfService(PlatformAgentService platformAgentService, AgentModelPricingService agentModelPricingService, AgentTimelinePdfRenderer pdfRenderer, tools.jackson.databind.ObjectMapper objectMapper)

Method Summary

Modifier and Type	Method	Description
protected void	addGuardrail(AgentInvocationReport invocationReport, AgentExchangeTimelineResponse exchange)	Records one guardrail evaluation on the invocation: updates the evaluated/fired/passed counts and appends a parsed AgentGuardrailReport.
protected AgentExchangeReport	buildExchange(AgentExchangeTimelineResponse exchange, List<AgentModelPrice> prices)
protected AgentInvocationReport	buildInvocation(AgentInvocationTimelineResponse invocation, List<AgentModelPrice> prices, AgentTimelineReport report)
protected AgentTimelineReport	buildInvocationReport(String agentInstanceId, String invocationId, AgentTimelinePdfService.AgentInstanceInfo header, AgentInstanceTimelineResponse instance, List<AgentModelPrice> prices)
protected AgentTimelineReport	buildReport(String scopeId, String scopeType, AgentTimelinePdfService.ScopeInfo scopeInfo, List<AgentInstanceTimelineResponse> timeline, List<AgentModelPrice> prices)
protected double	computeCost(long inputTokens, long outputTokens, long cachedTokens, AgentModelPrice price)	Cost for the given (disjoint) token buckets against the given price.
protected Long	durationMillis(Instant start, Instant end)
protected String	firstText(tools.jackson.databind.JsonNode node, String... fields)
void	generateInvocationPdf(String agentInstanceId, String invocationId, AgentTimelinePdfService.AgentInstanceInfo header, OutputStream outputStream)	Generates a PDF for a single agent invocation: fetches the agent instance timeline, keeps only the target invocation and renders it in single-agent-instance mode (agent-instance header, no multi-agent overview).
void	generateTimelinePdf(String scopeId, String scopeType, AgentTimelinePdfService.ScopeInfo scopeInfo, OutputStream outputStream)
protected String	guardrailOutputContent(AgentExchangeTimelineResponse exchange)	Returns the content of the exchange's output/result part, which carries the guardrail evaluation JSON.
protected boolean	isGuardrailFired(String subType)
protected AgentModelPrice	matchPrice(String model, List<AgentModelPrice> prices)	Returns the price whose model prefix is the longest prefix of model, or null if none matches.
protected long	nz(Integer value)
protected void	parseGuardrailContent(AgentExchangeTimelineResponse exchange, AgentGuardrailReport guardrail)	Parses the guardrail's output part content (a JSON object) into the report, tolerating any missing field.
protected String	resolveFlowableVersion()	Resolves the Flowable product/build version to display in the report.
protected String	textOrNull(tools.jackson.databind.JsonNode node, String field)

Methods inherited from class java.lang.Object

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

Field Details

platformAgentService

protected final PlatformAgentService platformAgentService

agentModelPricingService

protected final AgentModelPricingService agentModelPricingService

pdfRenderer

protected final AgentTimelinePdfRenderer pdfRenderer

objectMapper

protected final tools.jackson.databind.ObjectMapper objectMapper

Constructor Details

AgentTimelinePdfService

public AgentTimelinePdfService(PlatformAgentService platformAgentService,
 AgentModelPricingService agentModelPricingService,
 AgentTimelinePdfRenderer pdfRenderer,
 tools.jackson.databind.ObjectMapper objectMapper)

Method Details

generateTimelinePdf

public void generateTimelinePdf(String scopeId,
 String scopeType,
 AgentTimelinePdfService.ScopeInfo scopeInfo,
 OutputStream outputStream)

generateInvocationPdf

public void generateInvocationPdf(String agentInstanceId,
 String invocationId,
 AgentTimelinePdfService.AgentInstanceInfo header,
 OutputStream outputStream)

Generates a PDF for a single agent invocation: fetches the agent instance timeline, keeps only the target invocation and renders it in single-agent-instance mode (agent-instance header, no multi-agent overview).

buildInvocationReport

protected AgentTimelineReport buildInvocationReport(String agentInstanceId,
 String invocationId,
 AgentTimelinePdfService.AgentInstanceInfo header,
 AgentInstanceTimelineResponse instance,
 List<AgentModelPrice> prices)

buildReport

protected AgentTimelineReport buildReport(String scopeId,
 String scopeType,
 AgentTimelinePdfService.ScopeInfo scopeInfo,
 List<AgentInstanceTimelineResponse> timeline,
 List<AgentModelPrice> prices)

buildInvocation

protected AgentInvocationReport buildInvocation(AgentInvocationTimelineResponse invocation,
 List<AgentModelPrice> prices,
 AgentTimelineReport report)

buildExchange

protected AgentExchangeReport buildExchange(AgentExchangeTimelineResponse exchange,
 List<AgentModelPrice> prices)

addGuardrail

protected void addGuardrail(AgentInvocationReport invocationReport,
 AgentExchangeTimelineResponse exchange)

Records one guardrail evaluation on the invocation: updates the evaluated/fired/passed counts and appends a parsed AgentGuardrailReport. A guardrail is considered "fired" when its exchange subType is one of the guardrail* subtypes; the detail is parsed best-effort from the exchange's output part JSON content.

isGuardrailFired

protected boolean isGuardrailFired(String subType)

parseGuardrailContent

protected void parseGuardrailContent(AgentExchangeTimelineResponse exchange,
 AgentGuardrailReport guardrail)

Parses the guardrail's output part content (a JSON object) into the report, tolerating any missing field.

guardrailOutputContent

protected String guardrailOutputContent(AgentExchangeTimelineResponse exchange)

Returns the content of the exchange's output/result part, which carries the guardrail evaluation JSON.

textOrNull

protected String textOrNull(tools.jackson.databind.JsonNode node,
 String field)

firstText

protected String firstText(tools.jackson.databind.JsonNode node,
 String... fields)

resolveFlowableVersion

protected String resolveFlowableVersion()

Resolves the Flowable product/build version to display in the report. Prefers the platform build version from this service's own JAR manifest (Implementation-Version); when that is absent (e.g. running from source in development) it falls back to the bundled Flowable engine version constant. May return null.

durationMillis

protected Long durationMillis(Instant start,
 Instant end)

nz

protected long nz(Integer value)

matchPrice

protected AgentModelPrice matchPrice(String model,
 List<AgentModelPrice> prices)

Returns the price whose model prefix is the longest prefix of model, or null if none matches.

computeCost

protected double computeCost(long inputTokens,
 long outputTokens,
 long cachedTokens,
 AgentModelPrice price)

Cost for the given (disjoint) token buckets against the given price. Returns 0 when the price is null.