Package io.jenkins.plugins.aiagentjob.pi

Class PiAgentHandler

java.lang.Object

hudson.model.AbstractDescribableImpl<AiAgentTypeHandler>

io.jenkins.plugins.aiagentjob.AiAgentTypeHandler

io.jenkins.plugins.aiagentjob.pi.PiAgentHandler

All Implemented Interfaces:

ExtensionPoint, Describable<AiAgentTypeHandler>

public final class PiAgentHandler
extends AiAgentTypeHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	PiAgentHandler.DescriptorImpl

Nested classes/interfaces inherited from class io.jenkins.plugins.aiagentjob.AiAgentTypeHandler

AiAgentTypeHandler.AcpExecutionSpec, AiAgentTypeHandler.ModelSelection

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
PiAgentHandler()

Method Summary

Modifier and Type	Method	Description
List<String>	buildDefaultCommand(AiAgentConfiguration config, String prompt)
String	getDefaultApiKeyEnvVar()	Default API-key environment variable, or empty when the agent uses node-level auth.
String	getId()	Stable identifier for this agent implementation.
AiAgentLogFormat	getLogFormat()	Returns the log format parser for this agent's JSONL output.
AiAgentStatsExtractor	getStatsExtractor()	Returns the stats extractor for this agent's JSONL output.
protected Set<String>	getSupportedReasoningEfforts()	Reasoning efforts recognized when appended to a model identifier.
int	resolveExitCode(int processExitCode, File rawLogFile)	Maps process exit status after complete output has been persisted.
void	validateExecution(AiAgentConfiguration config)	Rejects unsupported execution settings before any process or temporary file is created.

Methods inherited from class io.jenkins.plugins.aiagentjob.AiAgentTypeHandler

buildAcpExecution, prepareExecution, resolveModelSelection, supportsManualApprovals

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.model.Describable

getDescriptor

Constructor Details

PiAgentHandler

@DataBoundConstructor
public PiAgentHandler()

Method Details

getId

public String getId()

Description copied from class: AiAgentTypeHandler

Stable identifier for this agent implementation.

Specified by:

getId in class AiAgentTypeHandler

getDefaultApiKeyEnvVar

public String getDefaultApiKeyEnvVar()

Description copied from class: AiAgentTypeHandler

Default API-key environment variable, or empty when the agent uses node-level auth.

Specified by:

getDefaultApiKeyEnvVar in class AiAgentTypeHandler

getSupportedReasoningEfforts

protected Set<String> getSupportedReasoningEfforts()

Description copied from class: AiAgentTypeHandler

Reasoning efforts recognized when appended to a model identifier.

Overrides:

getSupportedReasoningEfforts in class AiAgentTypeHandler

validateExecution

public void validateExecution(AiAgentConfiguration config)

Description copied from class: AiAgentTypeHandler

Rejects unsupported execution settings before any process or temporary file is created.

Overrides:

validateExecution in class AiAgentTypeHandler

buildDefaultCommand

public List<String> buildDefaultCommand(AiAgentConfiguration config,
 String prompt)

Specified by:

buildDefaultCommand in class AiAgentTypeHandler

getLogFormat

public AiAgentLogFormat getLogFormat()

Description copied from class: AiAgentTypeHandler

Returns the log format parser for this agent's JSONL output.

The returned format's AiAgentLogFormat.classify(long, net.sf.json.JSONObject) method should return null for any JSON it does not recognise, so the parser can fall through to the shared format and generic fallback.

Specified by:

getLogFormat in class AiAgentTypeHandler

getStatsExtractor

public AiAgentStatsExtractor getStatsExtractor()

Description copied from class: AiAgentTypeHandler

Returns the stats extractor for this agent's JSONL output.

The returned extractor's AiAgentStatsExtractor.extract(net.sf.json.JSONObject, io.jenkins.plugins.aiagentjob.AgentUsageStats) method should return false for any JSON it does not recognise, so the shared extractor handles it as a fallback.

Specified by:

getStatsExtractor in class AiAgentTypeHandler

resolveExitCode

public int resolveExitCode(int processExitCode,
 File rawLogFile)
                    throws IOException

Description copied from class: AiAgentTypeHandler

Maps process exit status after complete output has been persisted. Agents that report terminal failures while exiting zero can override this method.

Overrides:

resolveExitCode in class AiAgentTypeHandler

Throws:

IOException