Package com.xebialabs.xlrelease.a2a.server

Class OrchestrateReleaseSkill

java.lang.Object
com.xebialabs.xlrelease.a2a.server.OrchestrateReleaseSkill
All Implemented Interfaces:
A2aServerSkill
public class OrchestrateReleaseSkill extends Object
Starts any Release template as a governed release on behalf of an external agent and tracks it as a live A2A task — the general-purpose counterpart of RequestDeploymentApprovalSkill's approval-specific contract.

  • Constructor Details

    • OrchestrateReleaseSkill

      public OrchestrateReleaseSkill(com.xebialabs.xlrelease.api.v1.TemplateApi templateApi)

  • Method Details

    • id

      public String id()
      Description copied from interface: A2aServerSkill
      Skill id as advertised on the Agent Card and addressed via message metadata skillId.

    • name

      public String name()
      Description copied from interface: A2aServerSkill
      Human-readable name for the Agent Card.

    • description

      public String description()
      Description copied from interface: A2aServerSkill
      What the skill does and what input it expects — agents read this to decide what to send.

    • readOnly

      public final boolean readOnly()
      Description copied from interface: A2aServerSkill
      Whether the skill only reads Release state. When the A2A feature's read-only mode is on, skills returning false are hidden from the Agent Card and rejected if called anyway.
      Specified by:
      readOnly in interface A2aServerSkill

    • invoke

      public final A2aSkillOutcome invoke(String text, Map<String,String> metadata)
      Description copied from interface: A2aServerSkill
      Executes the skill.

      Runs on the HTTP request thread under the caller's authenticated identity, so host API calls are permission-checked as that caller. Return A2aSkillOutcome.text(String) for an immediately-complete result, or A2aSkillOutcome.release(String) for work delegated to a release, whose live state becomes the A2A task from then on. Throw IllegalArgumentException for bad input (becomes a failed A2A task with the message as explanation), A2aContractViolationException for a governance handoff-contract violation (becomes a rejected task); any other exception is reported as a failed task without internal detail.

      Specified by:
      invoke in interface A2aServerSkill
      Parameters:
      text - the concatenated text parts of the incoming message
      metadata - the incoming message's metadata values, stringified