Struct JiraClient 

pub struct JiraClient { /* private fields */ }

Implementations

impl JiraClient

pub fn new( url: impl Into<String>, project_key: impl Into<String>, email: impl Into<String>, token: SecretString, ) -> Self

Create a new Jira client. Flavor is auto-detected from the URL.

pub fn with_proxy(self, headers: HashMap<String, String>) -> Self

Configure proxy mode with extra headers added to every request. When proxy is active, the provider’s own auth headers are suppressed — the proxy handles authentication. Note: instance_url is preserved for generating browse links.

pub fn with_instance_url(self, url: impl Into<String>) -> Self

Override the instance URL used for generating browse links. Useful when proxy URL differs from real Jira instance URL.

pub fn with_flavor(self, flavor: JiraFlavor) -> Self

Override auto-detected flavor. Use when the URL doesn’t reflect the actual Jira deployment (e.g. proxy URL instead of real Jira URL).

pub fn with_base_url( base_url: impl Into<String>, project_key: impl Into<String>, email: impl Into<String>, token: SecretString, flavor: bool, ) -> Self

Create a new Jira client with explicit base URL (for testing with httpmock). The base URL is used as-is (no /rest/api/N suffix appended).

pub async fn list_structures_for_metadata( &self, ) -> Result<Vec<JiraStructureRef>>

Fetch a compact list of accessible Structures for metadata enrichment.

Unlike Self::get_structures, this is intended to be called from a metadata-assembly pipeline and swallows the “Structure plugin not installed” error (HTTP 404, which the Structure endpoint returns as a generic Jira “dead link” HTML page) into an empty Vec. The resulting Ok(vec![]) is the “no structures are available here” signal that downstream enrichers key on to decide whether to touch the structureId parameter of Structure tools.

Credential / permission failures (401 Unauthorized, 403 Forbidden) still propagate — those indicate the caller’s integration is misconfigured, not that the feature is absent, and the metadata build should surface the error rather than silently pretend no structures exist.

Trait Implementations

impl IssueProvider for JiraClient

fn get_issues<'life0, 'async_trait>( &'life0 self, filter: IssueFilter, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Issue>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get a list of issues with optional filters.

fn get_issue<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Issue>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a single issue by key (e.g., “gitlab#123”, “gh#456”).

fn create_issue<'life0, 'async_trait>( &'life0 self, input: CreateIssueInput, ) -> Pin<Box<dyn Future<Output = Result<Issue>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a new issue.

fn update_issue<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, input: UpdateIssueInput, ) -> Pin<Box<dyn Future<Output = Result<Issue>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Update an existing issue.

fn get_comments<'life0, 'life1, 'async_trait>( &'life0 self, issue_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Comment>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn add_comment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, issue_key: &'life1 str, body: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Comment>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn get_statuses<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<IssueStatus>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get available statuses for the issue tracker. Default returns ProviderUnsupported — override in providers that support statuses.

fn get_users<'life0, 'async_trait>( &'life0 self, options: GetUsersOptions, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<User>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get users from the issue tracker (Jira only).

fn link_issues<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, source_key: &'life1 str, target_key: &'life2 str, link_type: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Link two issues together.

fn get_issue_relations<'life0, 'life1, 'async_trait>( &'life0 self, issue_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<IssueRelations>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get issue relations (parent, subtasks, linked issues).

fn upload_attachment<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, issue_key: &'life1 str, filename: &'life2 str, data: &'life3 [u8], ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Upload a file attachment to an issue. Returns the download URL. Default returns ProviderUnsupported — override in providers that support attachments.

fn get_issue_attachments<'life0, 'life1, 'async_trait>( &'life0 self, issue_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<AssetMeta>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List attachments currently attached to an issue (body + comments).

fn download_attachment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _issue_key: &'life1 str, asset_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Download the raw bytes of an attachment belonging to an issue.

fn delete_attachment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _issue_key: &'life1 str, asset_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Delete an attachment from an issue.

fn asset_capabilities(&self) -> AssetCapabilities

Describe which asset operations this provider supports for each context. Used by the enricher to surface per-provider capabilities in tool schemas so agents can adapt their behaviour before making calls that would fail with ProviderUnsupported.

fn get_structures<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Structure>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all available structures.

fn get_structure_forest<'life0, 'async_trait>( &'life0 self, structure_id: u64, options: GetForestOptions, ) -> Pin<Box<dyn Future<Output = Result<StructureForest>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get a structure’s forest (hierarchy tree).

fn add_structure_rows<'life0, 'async_trait>( &'life0 self, structure_id: u64, input: AddStructureRowsInput, ) -> Pin<Box<dyn Future<Output = Result<ForestModifyResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Add rows to a structure’s forest.

fn move_structure_rows<'life0, 'async_trait>( &'life0 self, structure_id: u64, input: MoveStructureRowsInput, ) -> Pin<Box<dyn Future<Output = Result<ForestModifyResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Move rows within a structure’s forest.

fn remove_structure_row<'life0, 'async_trait>( &'life0 self, structure_id: u64, row_id: u64, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Remove a row from a structure’s forest.

fn get_structure_values<'life0, 'async_trait>( &'life0 self, input: GetStructureValuesInput, ) -> Pin<Box<dyn Future<Output = Result<StructureValues>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Batch-read column values (including formulas) for structure rows.

fn get_structure_views<'life0, 'async_trait>( &'life0 self, structure_id: u64, view_id: Option<u64>, ) -> Pin<Box<dyn Future<Output = Result<Vec<StructureView>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get views for a structure, optionally a specific view by ID.

fn save_structure_view<'life0, 'async_trait>( &'life0 self, input: SaveStructureViewInput, ) -> Pin<Box<dyn Future<Output = Result<StructureView>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create or update a structure view.

fn create_structure<'life0, 'async_trait>( &'life0 self, input: CreateStructureInput, ) -> Pin<Box<dyn Future<Output = Result<Structure>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a new structure.

fn get_structure_generators<'life0, 'async_trait>( &'life0 self, structure_id: u64, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<StructureGenerator>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List generators configured on a structure.

fn add_structure_generator<'life0, 'async_trait>( &'life0 self, input: AddStructureGeneratorInput, ) -> Pin<Box<dyn Future<Output = Result<StructureGenerator>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Attach a new generator to a structure.

fn sync_structure_generator<'life0, 'async_trait>( &'life0 self, input: SyncStructureGeneratorInput, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Force a generator to refresh its produced rows.

fn delete_structure<'life0, 'async_trait>( &'life0 self, structure_id: u64, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Delete a structure permanently.

fn update_structure_automation<'life0, 'async_trait>( &'life0 self, input: UpdateStructureAutomationInput, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Replace a structure’s automation configuration.

fn trigger_structure_automation<'life0, 'async_trait>( &'life0 self, structure_id: u64, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Run a structure’s automation pass on demand.

fn get_board_sprints<'life0, 'async_trait>( &'life0 self, board_id: u64, state: SprintState, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Sprint>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List sprints visible on a board, optionally filtered by state.

fn assign_to_sprint<'life0, 'async_trait>( &'life0 self, input: AssignToSprintInput, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Move one or more issues onto a sprint.

fn list_project_versions<'life0, 'async_trait>( &'life0 self, params: ListProjectVersionsParams, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<ProjectVersion>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List versions (“releases” / fixVersion targets) for a project. Default: ProviderUnsupported.

fn upsert_project_version<'life0, 'async_trait>( &'life0 self, input: UpsertProjectVersionInput, ) -> Pin<Box<dyn Future<Output = Result<ProjectVersion>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create-or-update a project version, keyed by (project, name). Partial update: optional fields left as None are not touched. Default: ProviderUnsupported.

fn provider_name(&self) -> &'static str

Get the provider name for logging (e.g., “gitlab”, “github”).

fn unlink_issues<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _source_key: &'life1 str, _target_key: &'life2 str, _link_type: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, Self: 'async_trait,

Remove a link between two issues.

fn set_custom_fields<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _issue_key: &'life1 str, _fields: &'life2 [Value], ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Set custom fields on an issue. Each entry: {"id": "field_id", "value": <value>}. Default is no-op — override in providers that support custom fields (e.g., ClickUp).

impl MergeRequestProvider for JiraClient

fn provider_name(&self) -> &'static str

Get the provider name for logging.

fn get_merge_requests<'life0, 'async_trait>( &'life0 self, _filter: MrFilter, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<MergeRequest>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Get a list of merge requests with optional filters.

fn get_merge_request<'life0, 'life1, 'async_trait>( &'life0 self, _key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<MergeRequest, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Get a single merge request by key (e.g., “mr#123”, “pr#456”).

fn get_discussions<'life0, 'life1, 'async_trait>( &'life0 self, _mr_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Discussion>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Get discussions/comments for a merge request.

fn get_diffs<'life0, 'life1, 'async_trait>( &'life0 self, _mr_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<FileDiff>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

fn add_comment<'life0, 'life1, 'async_trait>( &'life0 self, _mr_key: &'life1 str, _input: CreateCommentInput, ) -> Pin<Box<dyn Future<Output = Result<Comment, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

fn create_merge_request<'life0, 'async_trait>( &'life0 self, _input: CreateMergeRequestInput, ) -> Pin<Box<dyn Future<Output = Result<MergeRequest, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Create a new merge request / pull request.

fn update_merge_request<'life0, 'life1, 'async_trait>( &'life0 self, _key: &'life1 str, _input: UpdateMergeRequestInput, ) -> Pin<Box<dyn Future<Output = Result<MergeRequest, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Update an existing merge request / pull request.

fn get_releases<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ProviderResult<Release>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Get releases/tags for the repository.

fn get_mr_attachments<'life0, 'life1, 'async_trait>( &'life0 self, _mr_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<AssetMeta>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

List attachments on a merge request (body + discussions).

fn download_mr_attachment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _mr_key: &'life1 str, _asset_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

fn delete_mr_attachment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _mr_key: &'life1 str, _asset_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

impl PipelineProvider for JiraClient

fn provider_name(&self) -> &'static str

Get the provider name for logging.

fn get_pipeline<'life0, 'async_trait>( &'life0 self, _input: GetPipelineInput, ) -> Pin<Box<dyn Future<Output = Result<PipelineInfo, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

fn get_job_logs<'life0, 'life1, 'async_trait>( &'life0 self, _job_id: &'life1 str, _options: JobLogOptions, ) -> Pin<Box<dyn Future<Output = Result<JobLogOutput, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Get job logs with search, pagination, or smart extraction.

impl Provider for JiraClient

fn get_current_user<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<User>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get the current authenticated user.

impl UserProvider for JiraClient

fn provider_name(&self) -> &'static str

Provider name for logging / error reporting.

fn get_user_profile<'life0, 'life1, 'async_trait>( &'life0 self, user_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<User>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Resolve a user by their provider-native id (Slack U0123, Jira accountId / name, ClickUp user id, etc.).

fn lookup_user_by_email<'life0, 'life1, 'async_trait>( &'life0 self, email: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<User>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Look up a user by email. Returns None if the provider can issue the query but there is no match, Error::ProviderUnsupported when the provider simply doesn’t expose an email lookup.