@assemblyline-agents/jira 2.0.0 → 3.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 OpenEve contributors
+Copyright (c) 2026 Assembly Line contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,7 +2,7 @@
 
 Official Assembly Line Jira connection plugin.
 
-It connects agents to Jira, exposing issue-tracking and project tools through Atlassian's MCP server. The package exports `defineJiraConnection(options)` to declare the connection in an agent definition and an `assemblyLinePlugin` module so the Assembly Line CLI and compiler can discover the plugin's connection metadata. A bundled skill under `skills/` teaches agents how to use the connection's tools.
+It connects agents to Jira, exposing issue-tracking and project tools through Atlassian's MCP server. The package exports `defineJiraConnection(options)` to declare the connection in an agent definition and an `assemblyLinePlugin` module so the Assembly Line CLI and compiler can discover the plugin's connection metadata.
 
 ## Install
 

package/dist/events.d.ts

@@ -0,0 +1,3 @@
+import { type ConnectionPluginEventAdapter } from "@assemblyline-agents/core";
+export declare const jiraEvents: ConnectionPluginEventAdapter;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,4BAA4B,EAElC,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,UAAU,EAAE,4BAgCxB,CAAC"}

package/dist/events.js

@@ -0,0 +1,49 @@
+import { createHash, randomBytes } from "node:crypto";
+import { ConnectionEventError, parseConnectionEventJson, providerJson, stringField } from "@assemblyline-agents/core";
+export const jiraEvents = {
+    prepare(context) { return context.state?.verificationToken ? context.state : { ...(context.state ?? {}), verificationToken: randomBytes(32).toString("base64url") }; },
+    async reconcile(context) {
+        const resources = context.resources.map(jiraResource);
+        if (!resources.length)
+            return { status: "needs_setup", ...(context.state ? { state: context.state } : {}), instructions: "Add Jira event resources with baseUrl and jql." };
+        const baseUrl = resources[0].baseUrl;
+        if (resources.some((resource) => resource.baseUrl !== baseUrl))
+            throw new Error("One Jira connection event binding cannot span multiple Jira sites.");
+        const token = (await context.getToken()).token;
+        const priorIds = webhookIds(context.state);
+        if (priorIds.length)
+            await providerJson(context.fetch, `${baseUrl}/rest/api/3/webhook`, { method: "DELETE", headers: auth(token), body: JSON.stringify({ webhookIds: priorIds.map(Number) }) }, [200, 202, 204, 404]);
+        const verificationToken = required(context.state ?? {}, "verificationToken");
+        const value = await providerJson(context.fetch, `${baseUrl}/rest/api/3/webhook`, {
+            method: "POST", headers: auth(token), body: JSON.stringify({ url: `${context.callbackUrl}?token=${encodeURIComponent(verificationToken)}`, webhooks: resources.map((resource) => ({ events: context.selectedEvents, jqlFilter: resource.jql })) })
+        });
+        const results = Array.isArray(value.webhookRegistrationResult) ? value.webhookRegistrationResult : [];
+        const ids = results.flatMap((item) => item && typeof item === "object" && !Array.isArray(item) && item.createdWebhookId !== undefined ? [String(item.createdWebhookId)] : []);
+        if (ids.length !== resources.length)
+            throw new Error(`Jira created ${ids.length} of ${resources.length} requested webhooks.`);
+        const expiresAt = new Date(Date.now() + 29 * 24 * 60 * 60_000).toISOString();
+        return { status: "active", externalId: ids.join(","), state: { verificationToken, baseUrl, webhookIds: ids }, expiresAt, detail: `${ids.length} Jira webhook${ids.length === 1 ? " is" : "s are"} active.` };
+    },
+    async remove(context) { const ids = webhookIds(context.state); const baseUrl = stringField(context.state ?? {}, "baseUrl"); if (!ids.length || !baseUrl)
+        return; await providerJson(context.fetch, `${baseUrl}/rest/api/3/webhook`, { method: "DELETE", headers: auth((await context.getToken()).token), body: JSON.stringify({ webhookIds: ids.map(Number) }) }, [200, 202, 204, 404]); },
+    check(context) { return webhookIds(context.state).length ? { status: "active", detail: "Jira dynamic webhooks are configured." } : { status: "needs_setup", detail: "Jira dynamic webhooks are not configured." }; },
+    ingress(request, context) {
+        if (request.query.token !== stringField(context.state ?? {}, "verificationToken"))
+            throw new ConnectionEventError("Jira webhook verification token is invalid.", 401);
+        const payload = parseConnectionEventJson(request.body);
+        const event = stringField(payload, "webhookEvent");
+        if (!event)
+            throw new ConnectionEventError("Jira webhook omitted webhookEvent.");
+        const occurred = payload.timestamp;
+        const occurredAt = typeof occurred === "number" ? new Date(occurred).toISOString() : undefined;
+        const eventId = createHash("sha256").update(request.body).digest("hex");
+        return { events: [{ event, eventId, payload: payload, ...(occurredAt ? { occurredAt } : {}) }], response: { status: 200, body: { ok: true } }, audit: { event } };
+    }
+};
+function jiraResource(resource) { const baseUrl = stringField(resource, "baseUrl")?.replace(/\/+$/u, ""); const jql = stringField(resource, "jql"); if (!baseUrl || !jql)
+    throw new Error("Jira event resources require baseUrl and jql."); return { baseUrl, jql }; }
+function webhookIds(state) { return Array.isArray(state?.webhookIds) ? state.webhookIds.filter((value) => typeof value === "string") : []; }
+function auth(token) { return { authorization: `Bearer ${token}`, "content-type": "application/json" }; }
+function required(value, name) { const result = stringField(value, name); if (!result)
+    throw new Error(`Jira event state omitted ${name}.`); return result; }
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE/I,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,yEAAwD;AAC3H,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmG,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAG7K,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,yEAAgN;AACnR,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
-import { connectionPluginMetadata, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { connectionPluginMetadata, defineConnectionPluginEvents, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { jiraEvents } from "./events.js";
 const PLUGIN = connectionPluginMetadata("jira");
-export function defineJiraConnection(options) { return defineMcpPluginConnection(PLUGIN, options); }
+export function defineJiraConnection(options) { const definition = defineMcpPluginConnection(PLUGIN, options); const events = defineConnectionPluginEvents(PLUGIN, options.events, jiraEvents); if (events)
+    definition.events = events; return definition; }
 export const assemblyLinePlugin = definePlugin({ connections: [PLUGIN] });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,YAAY,EAAmC,MAAM,2BAA2B,CAAC;AAC/I,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAE,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAAC,OAA8B,IAAI,OAAO,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3H,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,YAAY,EAAmC,MAAM,2BAA2B,CAAC;AAC7K,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAE,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAAC,OAA8B,IAAI,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM;IAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AACnR,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assemblyline-agents/jira",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "type": "module",
   "exports": {
     ".": {
@@ -9,12 +9,11 @@
     }
   },
   "dependencies": {
-    "@assemblyline-agents/core": "2.0.0"
+    "@assemblyline-agents/core": "3.0.0"
   },
   "description": "Official Assembly Line Jira connection plugin.",
   "files": [
-    "dist",
-    "skills"
+    "dist"
   ],
   "engines": {
     "node": ">=22.19.0"

package/skills/jira/SKILL.md

@@ -1,8 +0,0 @@
----
-name: jira
-description: Use configured Jira tools for issues, projects, transitions, users, and JQL search.
----
-# Jira
-Prefer bounded JQL and fetch exact issues only after identifying their keys. Read transition metadata before proposing workflow changes.
-
-The deployment owner configures Atlassian authorization. The scaffold is read-only; creating, editing, commenting, logging work, or transitioning issues requires writes to be enabled with the configured approval gate.