@zibby/skills 2.0.5 → 2.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/artifact.js +7 -7
- package/dist/chat-notify.js +4 -4
- package/dist/chatProgress.js +4 -4
- package/dist/datasetStore.js +2 -2
- package/dist/discord.js +3 -3
- package/dist/figma.js +2 -2
- package/dist/git-write.js +9 -9
- package/dist/github.js +5 -5
- package/dist/gitlab.js +5 -5
- package/dist/googleDocs.js +9 -9
- package/dist/hubspot.js +1 -1
- package/dist/index.js +179 -181
- package/dist/jira.d.ts +19 -9
- package/dist/jira.js +22 -20
- package/dist/kvMemory.js +2 -2
- package/dist/lark.js +2 -2
- package/dist/larkAttendance.js +1 -1
- package/dist/larkDocs.js +3 -3
- package/dist/lib/http-deadline.d.ts +117 -0
- package/dist/lib/http-deadline.js +1 -0
- package/dist/lib/markup.d.ts +158 -0
- package/dist/lib/markup.js +22 -0
- package/dist/linear.js +15 -15
- package/dist/linkedin.js +2 -2
- package/dist/llm-billing.js +1 -1
- package/dist/notion.js +7 -7
- package/dist/opendesign.js +2 -2
- package/dist/package.json +6 -5
- package/dist/report.d.ts +42 -42
- package/dist/review.js +4 -4
- package/dist/reviewMemoryIo.js +1 -1
- package/dist/sentry.js +2 -2
- package/dist/skill-installer.js +3 -3
- package/dist/slack.js +2 -2
- package/dist/trackers/github-adapter.js +5 -5
- package/dist/trackers/index.js +46 -44
- package/dist/trackers/jira-adapter.js +24 -22
- package/dist/trackers/linear-adapter.js +19 -19
- package/dist/trackers/plane-adapter.js +1 -1
- package/dist/triggerAgent.js +1 -1
- package/dist/vikunja.d.ts +8 -1
- package/dist/vikunja.js +22 -7
- package/docs/templates/catalog-metadata.md +1 -1
- package/package.json +6 -5
|
@@ -1,22 +1,24 @@
|
|
|
1
|
-
import{createRequire as
|
|
2
|
-
`)
|
|
3
|
-
|
|
4
|
-
`);continue}let a=t.
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
${
|
|
9
|
-
|
|
10
|
-
`)
|
|
11
|
-
|
|
12
|
-
${
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
${
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
`)
|
|
1
|
+
import{createRequire as Re}from"module";import{resolveIntegrationToken as Ee,clearTokenCache as Le}from"@zibby/core/backend-client.js";var Y=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",LARK_DOCS:"lark_docs",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",VIKUNJA:"vikunja",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),ze=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark Chat",connectPath:"/integrations?provider=lark"},lark_docs:{id:"lark_docs",name:"Lark App",connectPath:"/integrations?provider=lark_docs"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},vikunja:{id:"vikunja",name:"Vikunja",connectPath:"/integrations?provider=vikunja"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});var R={api:{knob:"SKILL_API_TIMEOUT_MS",fallback:3e4},transfer:{knob:"SKILL_TRANSFER_TIMEOUT_MS",fallback:12e4},job:{knob:"SKILL_JOB_TIMEOUT_MS",fallback:3e5}};function pe(s,n,e=process.env){let t=Number(e?.[s]);return Number.isFinite(t)&&t>0?Math.min(6e5,Math.max(1e3,Math.floor(t))):n}function de(s="api",n=process.env){let e=R[s]||R.api;return pe(e.knob,e.fallback,n)}function q(s){return s?.name==="TimeoutError"||s?.name==="AbortError"}function fe(s){try{return new URL(String(s?.url??s)).host||"unknown host"}catch{return"unknown host"}}function me(s,n){if(!s)return n;let e=new AbortController,t=a=>{e.signal.aborted||e.abort(a)},i=()=>t(s.reason),r=()=>t(n.reason);return e.signal.addEventListener("abort",()=>{s.removeEventListener("abort",i),n.removeEventListener("abort",r)},{once:!0}),s.aborted?t(s.reason):n.aborted?t(n.reason):(s.addEventListener("abort",i,{once:!0}),n.addEventListener("abort",r,{once:!0})),e.signal}async function Q(s,n={},e={}){let t=e.kind||"api",i=(R[t]||R.api).knob,r=e.timeoutMs?Math.min(6e5,Math.max(1e3,Math.floor(e.timeoutMs))):de(t),a=n?.signal;if(a?.aborted)throw a.reason??new DOMException("This operation was aborted","AbortError");let o=AbortSignal.timeout(r),c=me(a,o);try{return await fetch(s,{...n,signal:c})}catch(l){throw o.aborted&&q(l)?new Error(`${e.what||"request"} TIMED OUT after ${r}ms against ${fe(s)} (${i})`):l}}var ye={NOTE:"info",TIP:"success",IMPORTANT:"note",WARNING:"warning",CAUTION:"error"},re={info:"NOTE",success:"TIP",note:"IMPORTANT",warning:"WARNING",error:"CAUTION"},ge=2e5,ie=6,he=/^```([A-Za-z0-9_+.-]{0,32})\s*$/,ke=/^(#{1,6})[ \t]+(.*?)\s*$/,be=/^(?:-{3,}|\*{3,}|_{3,})\s*$/,X=/^>(?: ?(.*))?$/,P=/^[-*][ \t]+\[([ xX])\][ \t]+(.*)$/,Z=/^[-*][ \t]+(.*)$/,V=/^(\d{1,3})[.)][ \t]+(.*)$/,ee=/^\|.*\|\s*$/,_e=/^\|?\s*:?-{1,}:?\s*(?:\|\s*:?-{1,}:?\s*)*\|?\s*$/,Ie=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/i;function te(s){let n=s.trim().replace(/^\|/,"").replace(/\|$/,""),e=[],t="";for(let i=0;i<n.length;i++){let r=n[i];if(r==="\\"&&n[i+1]==="|"){t+="|",i++;continue}if(r==="|"){e.push(t.trim()),t="";continue}t+=r}return e.push(t.trim()),e}function oe(s){let e=String(s??"").slice(0,ge).replace(/\r\n?/g,`
|
|
2
|
+
`).split(`
|
|
3
|
+
`);return J(e,0)}function J(s,n){let e=[],t=0;for(;t<s.length;){let i=s[t];if(i.trim()===""){t++;continue}if(/^[ \t]/.test(i)){e.push({t:"paragraph",c:b(i)}),t++;continue}let r;if(r=he.exec(i)){let a=r[1]||"",o=[];for(t++;t<s.length&&!/^```\s*$/.test(s[t]);)o.push(s[t]),t++;t++,e.push({t:"code",lang:a,v:o.join(`
|
|
4
|
+
`)});continue}if(be.test(i)){e.push({t:"rule"}),t++;continue}if(r=ke.exec(i)){let a=Math.min(ie,r[1].length);e.push({t:"heading",level:a,c:b(r[2])}),t++;continue}if(X.test(i)&&n<3){let a=[];for(;t<s.length&&(r=X.exec(s[t]));)a.push(r[1]??""),t++;let o=a.findIndex(l=>l.trim()!==""),c=o>=0?Ie.exec(a[o].trim()):null;if(c){let l=ye[c[1].toUpperCase()];e.push({t:"panel",kind:l,c:J(a.slice(o+1),n+1)})}else e.push({t:"quote",c:J(a,n+1)});continue}if(P.test(i)){let a=[];for(;t<s.length&&(r=P.exec(s[t]));)a.push({checked:r[1]!==" ",c:b(r[2])}),t++;e.push({t:"task",items:a});continue}if(Z.test(i)){let a=[];for(;t<s.length&&!P.test(s[t])&&(r=Z.exec(s[t]));)a.push([{t:"paragraph",c:b(r[1])}]),t++;e.push({t:"bullet",items:a});continue}if(r=V.exec(i)){let a=Math.max(1,parseInt(r[1],10)||1),o=[];for(;t<s.length&&(r=V.exec(s[t]));)o.push([{t:"paragraph",c:b(r[2])}]),t++;e.push({t:"ordered",start:a,items:o});continue}if(ee.test(i)&&t+1<s.length&&_e.test(s[t+1])){let a=te(i).map(b);t+=2;let o=[];for(;t<s.length&&ee.test(s[t]);)o.push(te(s[t]).map(b)),t++;e.push({t:"table",header:a,rows:o});continue}e.push({t:"paragraph",c:b(i)}),t++}return e}var je=/^https?:\/\/[^\s<>()[\]]+/,ve=/^\[([^\]\n]{1,300})\]\((https?:\/\/[^\s)]{1,2000})\)/,we=/[.,;:!?'"]+$/;function Ae(s,n){return n<=0?!0:/[\s([{"'“‘>:—–-]/.test(s[n-1])}function Se(s,n){return n>=s.length?!0:/[\s)\]}"'”’.,;:!?—–-]/.test(s[n])}function Te(s,n,e){let t=n;for(;t<s.length;){let i=s.indexOf(e,t);if(i<0)return-1;let r=s[i-1],a=s[i+e.length],o=e.length===1&&(r===e||a===e);if(i>n&&r&&!/\s/.test(r)&&!o&&Se(s,i+e.length))return i;t=i+1}return-1}function b(s){let n=String(s??""),e=[],t="",i=()=>{t&&(e.push({t:"text",v:t}),t="")},r=0;for(;r<n.length;){let a=n[r];if(a==="`"){let o=1;for(;n[r+o]==="`";)o++;let c="`".repeat(o),l=n.indexOf(c,r+o);if(l>r+o-1&&l!==-1){let u=n.slice(r+o,l);if(u.trim()){i(),e.push({t:"code",v:u.length>1&&u.startsWith(" ")&&u.endsWith(" ")?u.slice(1,-1):u}),r=l+o;continue}}t+=c,r+=o;continue}if(a==="["){let o=ve.exec(n.slice(r));if(o){i(),e.push({t:"link",href:o[2],c:b(o[1])}),r+=o[0].length;continue}}if((a==="*"||a==="_"||a==="~")&&Ae(n,r)){let o=n[r+1]===a;if(a==="~"&&!o){t+=a,r++;continue}let c=o?a+a:a,l=r+c.length;if(l<n.length&&!/\s/.test(n[l])){let u=Te(n,l,c);if(u>l){i();let d=b(n.slice(l,u));e.push(a==="~"?{t:"strike",c:d}:o?{t:"strong",c:d}:{t:"em",c:d}),r=u+c.length;continue}}}if(a==="h"&&(r===0||/[\s(<]/.test(n[r-1]))){let o=je.exec(n.slice(r));if(o){let c=o[0],l=we.exec(c);if(l&&(c=c.slice(0,-l[0].length)),c.length>8){i(),e.push({t:"link",href:c,c:[{t:"text",v:c}]}),r+=c.length;continue}}}t+=a,r++}return i(),e}function S(s,n=[]){let e=[];for(let t of s)switch(t.t){case"text":t.v&&e.push({type:"text",text:t.v,...n.length?{marks:n}:{}});break;case"br":e.push({type:"hardBreak"});break;case"code":e.push({type:"text",text:t.v,marks:[{type:"code"},...n.filter(i=>i.type==="link")]});break;case"strong":e.push(...S(t.c,E(n,{type:"strong"})));break;case"em":e.push(...S(t.c,E(n,{type:"em"})));break;case"strike":e.push(...S(t.c,E(n,{type:"strike"})));break;case"link":e.push(...S(t.c,E(n,{type:"link",attrs:{href:t.href}})));break}return e}function E(s,n){return s.some(e=>e.type===n.type)?s:[...s,n]}var K=0;function ne(){return K=(K+1)%1e6,`m${Date.now().toString(36)}-${K}`}var T=s=>{let n=S(s);return n.length?{type:"paragraph",content:n}:{type:"paragraph"}};function A(s,n){let e=[];for(let t of s)switch(t.t){case"paragraph":e.push(T(t.c));break;case"heading":if(n==="quote"||n==="item")e.push(T([{t:"strong",c:t.c}]));else{let i=S(t.c);i.length&&e.push({type:"heading",attrs:{level:t.level},content:i})}break;case"bullet":e.push({type:"bulletList",content:t.items.map(i=>({type:"listItem",content:L(A(i,"item"))}))});break;case"ordered":e.push({type:"orderedList",attrs:{order:t.start},content:t.items.map(i=>({type:"listItem",content:L(A(i,"item"))}))});break;case"task":n==="quote"||n==="item"?e.push({type:"bulletList",content:t.items.map(i=>({type:"listItem",content:[T([{t:"text",v:i.checked?"\u2611 ":"\u2610 "},...i.c])]}))}):e.push({type:"taskList",attrs:{localId:ne()},content:t.items.map(i=>({type:"taskItem",attrs:{localId:ne(),state:i.checked?"DONE":"TODO"},content:xe(S(i.c))}))});break;case"code":e.push({type:"codeBlock",attrs:t.lang?{language:t.lang}:{},...t.v?{content:[{type:"text",text:t.v}]}:{}});break;case"quote":n==="quote"||n==="item"?e.push(...A(t.c,n)):e.push({type:"blockquote",content:L(A(t.c,"quote"))});break;case"panel":n!=="doc"?e.push(...A(t.c,n)):e.push({type:"panel",attrs:{panelType:t.kind},content:L(A(t.c,"panel"))});break;case"rule":if(n==="quote"||n==="item")break;e.push({type:"rule"});break;case"table":{if(n!=="doc"){for(let r of[...t.header?[t.header]:[],...t.rows])e.push(T(Ne(r)));break}let i=[];t.header&&i.push({type:"tableRow",content:t.header.map(r=>({type:"tableHeader",attrs:{},content:[T(r)]}))});for(let r of t.rows)i.push({type:"tableRow",content:r.map(a=>({type:"tableCell",attrs:{},content:[T(a)]}))});i.length&&e.push({type:"table",attrs:{isNumberColumnEnabled:!1,layout:"default"},content:i});break}}return e}function L(s){return s.length?s:[{type:"paragraph"}]}function xe(s){return s.length?s:[{type:"text",text:" "}]}function Ne(s){let n=[];return s.forEach((e,t)=>{t&&n.push({t:"text",v:" \xB7 "}),n.push(...e)}),n}function M(s){return{type:"doc",version:1,content:String(s??"").split(`
|
|
5
|
+
`).map(n=>({type:"paragraph",...n?{content:[{type:"text",text:n}]}:{}}))}}function ae(s){try{let n=A(oe(s),"doc");return{type:"doc",version:1,content:n.length?n:[{type:"paragraph"}]}}catch{return M(s)}}function v(s){let n="";for(let e of s)switch(e.t){case"text":n+=e.v;break;case"br":n+=`
|
|
6
|
+
`;break;case"code":n+=`\`${e.v}\``;break;case"strong":n+=`**${v(e.c)}**`;break;case"em":n+=`_${v(e.c)}_`;break;case"strike":n+=`~~${v(e.c)}~~`;break;case"link":{let t=v(e.c);n+=!t||t===e.href?e.href:`[${t}](${e.href})`;break}}return n}function N(s){let n="";for(let e of s)switch(e.t){case"paragraph":n+=`${v(e.c)}
|
|
7
|
+
`;break;case"heading":n+=`${"#".repeat(Math.max(1,Math.min(ie,e.level)))} ${v(e.c)}
|
|
8
|
+
`;break;case"bullet":for(let t of e.items)n+=`- ${N(t).trim()}
|
|
9
|
+
`;break;case"ordered":e.items.forEach((t,i)=>{n+=`${e.start+i}. ${N(t).trim()}
|
|
10
|
+
`});break;case"task":for(let t of e.items)n+=`- [${t.checked?"x":" "}] ${v(t.c)}
|
|
11
|
+
`;break;case"code":n+=`\`\`\`${e.lang}
|
|
12
|
+
${e.v}
|
|
13
|
+
\`\`\`
|
|
14
|
+
`;break;case"quote":n+=se(N(e.c));break;case"panel":n+=`> [!${re[e.kind]}]
|
|
15
|
+
${se(N(e.c))}`;break;case"rule":n+=`---
|
|
16
|
+
`;break;case"table":{let t=i=>`| ${i.map(r=>v(r).replace(/\|/g,"\\|")).join(" | ")} |
|
|
17
|
+
`;e.header&&(n+=t(e.header)+`|${e.header.map(()=>" --- |").join("")}
|
|
18
|
+
`);for(let i of e.rows)n+=t(i);break}}return n}function Oe(s){return s.replace(/^\n+/,"").replace(/\s+$/,"")}function se(s){return s.replace(/\n$/,"").split(`
|
|
19
|
+
`).map(n=>n?`> ${n}`:">").join(`
|
|
20
|
+
`)+`
|
|
21
|
+
`}function x(s){let n=[];for(let e of s||[])if(!(!e||typeof e!="object"))switch(e.type){case"text":{let t={t:"text",v:String(e.text??"")},i=Array.isArray(e.marks)?e.marks:[];i.some(r=>r?.type==="code")&&(t={t:"code",v:String(e.text??"")});for(let r of i)!r||r.type==="code"||(r.type==="strong"?t={t:"strong",c:[t]}:r.type==="em"?t={t:"em",c:[t]}:r.type==="strike"?t={t:"strike",c:[t]}:r.type==="link"&&r.attrs?.href&&(t={t:"link",href:String(r.attrs.href),c:[t]}));n.push(t);break}case"hardBreak":n.push({t:"br"});break;case"mention":n.push({t:"text",v:String(e.attrs?.text||(e.attrs?.id?`@${e.attrs.id}`:"@someone"))});break;case"emoji":n.push({t:"text",v:String(e.attrs?.text||e.attrs?.shortName||"")});break;case"status":n.push({t:"text",v:String(e.attrs?.text||"")});break;case"date":n.push({t:"text",v:e.attrs?.timestamp?new Date(Number(e.attrs.timestamp)).toISOString().slice(0,10):""});break;case"inlineCard":{let t=String(e.attrs?.url||"");t&&n.push({t:"link",href:t,c:[{t:"text",v:t}]});break}default:Array.isArray(e.content)?n.push(...x(e.content)):typeof e.text=="string"&&n.push({t:"text",v:e.text})}return n}function _(s){let n=[];for(let e of s||[])if(!(!e||typeof e!="object"))switch(e.type){case"paragraph":n.push({t:"paragraph",c:x(e.content)});break;case"heading":n.push({t:"heading",level:Number(e.attrs?.level)||1,c:x(e.content)});break;case"bulletList":n.push({t:"bullet",items:(e.content||[]).map(t=>_(t?.content))});break;case"orderedList":n.push({t:"ordered",start:Number(e.attrs?.order)||1,items:(e.content||[]).map(t=>_(t?.content))});break;case"taskList":n.push({t:"task",items:(e.content||[]).map(t=>({checked:t?.attrs?.state==="DONE",c:x(t?.content)}))});break;case"decisionList":n.push({t:"bullet",items:(e.content||[]).map(t=>[{t:"paragraph",c:x(t?.content)}])});break;case"codeBlock":n.push({t:"code",lang:String(e.attrs?.language||""),v:(e.content||[]).map(t=>String(t?.text??"")).join("")});break;case"blockquote":n.push({t:"quote",c:_(e.content)});break;case"panel":{let t=String(e.attrs?.panelType||"info");n.push({t:"panel",kind:t in re?t:"info",c:_(e.content)});break}case"rule":n.push({t:"rule"});break;case"table":{let t=(e.content||[]).filter(o=>o?.type==="tableRow"),i=o=>(o.content||[]).map(c=>{let l=_(c?.content);return b(N(l).trim().replace(/\n+/g," "))}),r=o=>(o.content||[]).length>0&&(o.content||[]).every(c=>c?.type==="tableHeader"),a=t.length&&r(t[0])?i(t[0]):null;n.push({t:"table",header:a,rows:t.slice(a?1:0).map(i)});break}case"mediaSingle":case"mediaGroup":case"media":case"mediaInline":n.push({t:"paragraph",c:[{t:"text",v:"[attachment]"}]});break;case"expand":case"nestedExpand":{let t=String(e.attrs?.title||"").trim();t&&n.push({t:"paragraph",c:[{t:"strong",c:[{t:"text",v:t}]}]}),n.push(..._(e.content));break}default:{let t=Array.isArray(e.content)?e.content:[];t.some(i=>i?.type==="text"||i?.type==="hardBreak")?n.push({t:"paragraph",c:x(t)}):t.length?n.push(..._(t)):typeof e.text=="string"&&e.text&&n.push({t:"paragraph",c:[{t:"text",v:e.text}]})}}return n}function $e(s){try{if(Array.isArray(s))return _(s);if(s&&typeof s=="object"){let n=s;return n.type==="doc"||!n.type&&Array.isArray(n.content)?_(n.content):_([n])}if(typeof s=="string")return oe(s)}catch{}return[]}function B(s){try{return Oe(N($e(s)))}catch{return""}}var Ce=Re(import.meta.url);function qe(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return Ce.resolve("@zibby/mcp-jira/index.js")}catch{return null}}function Pe(s){return ae(s)}async function U(s,n){try{return await s(Pe(n))}catch(e){let t=Number(e?.status);if(!(t>=400&&t<500))throw e;return console.warn(`[jira] rich body rejected (${t}) \u2014 retrying as plain text: ${String(e?.message||e).slice(0,200)}`),await s(M(n))}}function O(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function D(s){return O(s).replace(/[a-z0-9]+/g,"")}function C(s,n){let e=O(s),t=O(n);if(!e||!t)return 0;if(e===t)return 1;if(e.length===1||t.length===1)return e===t?1:0;let i=u=>{let d=new Map;for(let m=0;m<u.length-1;m++){let g=u.slice(m,m+2);d.set(g,(d.get(g)||0)+1)}return d},r=i(e),a=i(t),o=0,c=0,l=0;for(let u of r.values())c+=u;for(let u of a.values())l+=u;for(let[u,d]of r.entries()){let m=a.get(u)||0;o+=Math.min(d,m)}return 2*o/Math.max(1,c+l)}function w(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Ke(s,n=[]){let e=Array.isArray(n)?n:[];if(e.length===0)return{requested:s||null,resolved:null,strategy:"none"};let t=e.filter(o=>!o.subtask),i=t.length>0?t:e,r=w(s);if(r){let o=i.find(u=>w(u.name)===r);if(o)return{requested:s,resolved:o,strategy:"exact"};let c={task:["task","\u4EFB\u52A1","\u4E8B\u9879","to do","todo"],story:["story","\u7528\u6237\u6545\u4E8B","\u9700\u6C42"],bug:["bug","\u7F3A\u9677","\u95EE\u9898"],improvement:["improvement","\u4F18\u5316","\u6539\u8FDB"],epic:["epic","\u53F2\u8BD7"]};for(let u of Object.values(c)){if(!u.some(m=>w(m)===r))continue;let d=i.find(m=>u.some(g=>w(g)===w(m.name)));if(d)return{requested:s,resolved:d,strategy:"alias"}}let l=i.map(u=>({t:u,score:C(s,u.name)})).sort((u,d)=>d.score-u.score);if(l[0]&&l[0].score>=.5)return{requested:s,resolved:l[0].t,strategy:"fuzzy"}}let a=["task","story","bug","improvement","epic"];for(let o of a){let c=i.find(l=>w(l.name)===o);if(c)return{requested:s||null,resolved:c,strategy:"default-preferred"}}return{requested:s||null,resolved:i[0],strategy:"default-first"}}async function ce(s){let n=`projectKeys=${encodeURIComponent(s)}&expand=projects.issuetypes`,e=await f(`/rest/api/3/issue/createmeta?${n}`),t=Array.isArray(e?.projects)?e.projects:[],r=t.find(o=>String(o?.key||"").toUpperCase()===String(s||"").toUpperCase())||t[0]||null;return(Array.isArray(r?.issuetypes)?r.issuetypes:[]).map(o=>({id:o.id,name:o.name,subtask:!!o.subtask,description:o.description||null}))}async function le(s,n){if(!s)throw new Error("projectKey is required");let e="sprint is not EMPTY";n==="active"?e="sprint in openSprints()":n==="closed"?e="sprint in closedSprints()":n==="future"&&(e="sprint in futureSprints()");let t=`project = ${s} AND ${e} ORDER BY updated DESC`,i=`jql=${encodeURIComponent(t)}&maxResults=100&fields=customfield_10020`,r=await f(`/rest/api/3/search/jql?${i}`),a=new Map;for(let o of r.issues||[])for(let c of o.fields?.customfield_10020||[])c&&!a.has(c.id)&&a.set(c.id,{id:c.id,name:c.name,state:c.state,boardId:c.boardId||null,startDate:c.startDate||null,endDate:c.endDate||null,goal:c.goal||null});return[...a.values()].sort((o,c)=>{let l={active:0,future:1,closed:2},u=(l[o.state]??3)-(l[c.state]??3);return u!==0?u:String(c.startDate||"").localeCompare(String(o.startDate||""))})}function Je(s,{sprintId:n,sprintName:e,target:t}={}){let i=Array.isArray(s)?s:[];if(!i.length)return{sprint:null,selectedBy:"none"};if(n!=null&&String(n).trim()!=="")return{sprint:i.find(o=>String(o.id)===String(n))||null,selectedBy:"id"};if(e&&String(e).trim()){let a=String(e).trim(),o=i.find(l=>String(l.name||"").toLowerCase()===a.toLowerCase());if(o)return{sprint:o,selectedBy:"name-exact"};let c=i.map(l=>({s:l,score:C(a,l.name||"")})).sort((l,u)=>u.score-l.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let r=String(t||"current").trim().toLowerCase();return r==="active"||r==="current"||r==="latest"?{sprint:i[0],selectedBy:r}:{sprint:i[0],selectedBy:"default"}}function Me(s,n){let e=s?.fields?.customfield_10020;return Array.isArray(e)?e.some(t=>String(t?.id)===String(n)):!1}async function Be({issueKey:s,projectKey:n,sprintId:e,attempts:t=3,delayMs:i=450}){let r=[];for(let a=0;a<t;a++){try{let o=`project = ${n} AND key = ${s} AND sprint = ${e}`,c=`jql=${encodeURIComponent(o)}&maxResults=1&fields=key,status`,l=await f(`/rest/api/3/search/jql?${c}`);if(Number(l?.total||0)>0)return r.push({attempt:a+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:r};let d=await f(`/rest/api/3/issue/${s}?fields=customfield_10020,status`),m=Me(d,e);if(r.push({attempt:a+1,jql:!1,issueField:m}),m)return{ok:!0,method:"issue_field",traces:r}}catch(o){r.push({attempt:a+1,error:String(o?.message||o)})}a<t-1&&await new Promise(o=>setTimeout(o,i))}return{ok:!1,method:"none",traces:r}}async function G({issueKey:s,projectKey:n,sprintId:e,sprintName:t,target:i}){if(!s)return{ok:!1,error:"issueKey is required"};let r=n;if(!r&&(r=(await f(`/rest/api/3/issue/${s}?fields=project`))?.fields?.project?.key||null,!r))return{ok:!1,error:`Could not resolve project for ${s}`};let a=await le(r,"active");if(!a.length)return{ok:!1,error:`No assignable active sprint found for project ${r}`};let{sprint:o,selectedBy:c}=Je(a,{sprintId:e,sprintName:t,target:i});if(!o)return{ok:!1,error:`No matching sprint found in ${r}`,requested:{sprintId:e??null,sprintName:t??null,target:i??"current"},availableSprints:a.map(d=>({id:d.id,name:d.name,state:d.state}))};await f(`/rest/api/3/issue/${s}`,{method:"PUT",body:{fields:{customfield_10020:Number(o.id)}}});let l=await Be({issueKey:s,projectKey:r,sprintId:o.id}),u=l.ok;return{ok:u,issueKey:s,projectKey:r,sprintId:o.id,sprintName:o.name,selectedBy:c,verifiedBy:l.method,verified:u,verificationTrace:l.traces,warning:u?null:`Sprint assignment attempted but verification did not find ${s} in sprint ${o.id}`}}async function Ue(){let s=process.env.JIRA_API_TOKEN,n=process.env.JIRA_EMAIL,e=process.env.JIRA_BASE_URL;if(s&&n&&e)return{authType:"token",apiToken:s,email:n,baseUrl:e};let t=await Ee("jira");return t?.cloudId?{authType:"oauth",accessToken:t.token,cloudId:t.cloudId}:{authType:"token",apiToken:t?.token,email:n||t?.email||"",baseUrl:e||t?.instanceUrl||t?.baseUrl||process.env.ATLASSIAN_INSTANCE_URL||""}}function De(s,n,e={}){let t=s||{},i={Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers};if(t.authType==="token"){let r=String(t.baseUrl||t.instanceUrl||"").trim().replace(/\/+$/,""),a=t.apiToken||t.accessToken||"";if(!r)throw new Error("Jira token connection has no base URL \u2014 reconnect Jira with its instance URL, or set JIRA_BASE_URL.");if(!t.email)throw new Error("Jira token connection has no account email \u2014 reconnect Jira with the account email, or set JIRA_EMAIL.");if(!a)throw new Error("Jira token connection has no API token \u2014 reconnect Jira, or set JIRA_API_TOKEN.");return{url:`${r}${n}`,headers:{Authorization:"Basic "+Buffer.from(`${t.email}:${a}`).toString("base64"),...i}}}if(typeof t.accessToken!="string"||!t.accessToken)throw new Error(`Invalid jira token type: ${typeof t.accessToken}`);if(!t.cloudId)throw new Error("Invalid jira cloudId: missing");return{url:`https://api.atlassian.com/ex/jira/${t.cloudId}${n}`,headers:{Authorization:`Bearer ${t.accessToken}`,...i}}}async function f(s,n={}){let e=async()=>{let t=await Ue(),{url:i,headers:r}=De(t,s,n),a=await Q(i,{method:n.method||"GET",headers:r,body:n.body?JSON.stringify(n.body):void 0,signal:n.signal},{kind:/\/search\b/.test(String(s))?"job":"api",what:`Jira ${n.method||"GET"} ${s}`}),o=()=>a.text().catch(l=>{if(q(l)||n.signal?.aborted)throw l;return""});if(!a.ok){let l=await o(),u=new Error(`Jira API ${a.status}: ${l.slice(0,300)}`);throw u.status=a.status,u}let c=await o();if(!c||!c.trim())return{};try{return JSON.parse(c)}catch{return{raw:c}}};try{return await e()}catch(t){if(n.signal?.aborted)throw t;let i=String(t?.message||t||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("403")||i.includes("substring")))throw t;return Le("jira"),e()}}var $={id:"jira",callsBackend:!0,serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:Y.JIRA,envKeys:["ATLASSIAN_ACCESS_TOKEN","ATLASSIAN_CLOUD_ID"],description:"Zibby Jira MCP Server (OAuth Bearer)",promptFragment:`## Jira
|
|
20
22
|
You have direct access to the user's Jira. Use these tools proactively:
|
|
21
23
|
|
|
22
24
|
### Issue tools
|
|
@@ -66,6 +68,6 @@ When user asks to move/transition ticket status:
|
|
|
66
68
|
3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
|
|
67
69
|
4. Call jira_get_issue(issueKey) to verify final status before claiming success.
|
|
68
70
|
5. If target wording differs (e.g. \u5DF2\u7ECF\u9A8C\u6536 vs \u5DF2\u9A8C\u6536), try toStatus first; only ask user to confirm when no reasonable match exists.
|
|
69
|
-
6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=D();if(!s)return null;let r={};for(let e of this.envKeys)process.env[e]&&(r[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(r.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(r[e]=process.env[e]);return{command:"node",args:[s],env:r,description:this.description}},async handleToolCall(s,r){try{switch(s){case"jira_list_projects":{let e=await y("/rest/api/3/project"),t=(Array.isArray(e)?e:[]).map(a=>({id:a.id,key:a.key,name:a.name,style:a.style}));return JSON.stringify({count:t.length,projects:t})}case"jira_list_statuses":{let{projectKey:e}=r||{};if(e){let i=await y(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),c=Array.isArray(i)?i:[],n=new Map;for(let l of c)for(let u of l.statuses||[])u?.id&&(n.has(u.id)||n.set(u.id,{id:u.id,name:u.name,category:u.statusCategory?.name||null}));let o=[...n.values()].sort((l,u)=>String(l.name).localeCompare(String(u.name)));return JSON.stringify({scope:"project",projectKey:e,count:o.length,statuses:o})}let t=await y("/rest/api/3/status"),a=(Array.isArray(t)?t:[]).map(i=>({id:i.id,name:i.name,category:i.statusCategory?.name||null})).sort((i,c)=>String(i.name).localeCompare(String(c.name)));return JSON.stringify({scope:"global",count:a.length,statuses:a})}case"jira_list_issue_types":{let{projectKey:e}=r||{};if(!e)return JSON.stringify({error:"projectKey is required"});let t=await C(e);return JSON.stringify({projectKey:e,count:t.length,issueTypes:t})}case"jira_search":{let e=r.jql||"",t=r.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let i=`jql=${encodeURIComponent(e)}&maxResults=${t}&fields=summary,status,assignee,priority,updated,issuetype,project`,n=((await y(`/rest/api/3/search/jql?${i}`)).issues||[]).map(o=>({key:o.key,project:o.fields?.project?.key,summary:o.fields?.summary,status:o.fields?.status?.name,assignee:o.fields?.assignee?.displayName||"Unassigned",priority:o.fields?.priority?.name,type:o.fields?.issuetype?.name}));return JSON.stringify({count:n.length,issues:n})}case"jira_get_issue":{let e=r.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let t=await y(`/rest/api/3/issue/${e}`);return JSON.stringify({key:t.key,project:t.fields?.project?.key,summary:t.fields?.summary,description:t.fields?.description,status:t.fields?.status?.name,assignee:t.fields?.assignee?.displayName||"Unassigned",priority:t.fields?.priority?.name,type:t.fields?.issuetype?.name,labels:t.fields?.labels,created:t.fields?.created,updated:t.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:t,issueType:a,description:i,priority:c,labels:n,assigneeId:o,moveToSprint:l,moveToActiveSprint:u,sprintId:d,sprintName:m,target:g}=r;if(!e||!t)return JSON.stringify({error:"projectKey and summary are required"});let p={requested:a||null,resolved:null,strategy:"none"},h=[];try{h=await C(e),p=M(a,h)}catch{}let f={project:{key:e},summary:t,issuetype:p?.resolved?.id?{id:p.resolved.id}:{name:a||"Task"}};i&&(f.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:i}]}]}),c&&(f.priority={name:c}),n?.length&&(f.labels=n),o&&(f.assignee={id:o});let j=await y("/rest/api/3/issue",{method:"POST",body:{fields:f}}),_={ok:!0,key:j.key,id:j.id,self:j.self};return p?.resolved&&(_.issueType=p.resolved.name,_.issueTypeResolution=p.strategy,p.strategy!=="exact"&&p.requested&&b(p.requested)!==b(p.resolved.name)&&(_.issueTypeWarning=`Requested "${p.requested}" is not available in ${e}; used "${p.resolved.name}" instead.`)),h.length>0&&(_.availableIssueTypes=h.map(k=>k.name)),(l||u)&&(_.sprintMove=await N({issueKey:j.key,projectKey:e,sprintId:d,sprintName:m,target:g})),JSON.stringify(_)}case"jira_list_sprints":{let{projectKey:e,state:t}=r,a=await P(e,t);return JSON.stringify({count:a.length,sprints:a})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:t,sprintId:a,sprintName:i,target:c}=r||{},n=await N({issueKey:e,projectKey:t,sprintId:a,sprintName:i,target:c||"current"});return JSON.stringify(n)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:t,sprintId:a,sprintName:i,target:c}=r||{},n=await N({issueKey:e,projectKey:t,sprintId:a,sprintName:i,target:c});return JSON.stringify(n)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:t,projectKey:a,status:i,maxResults:c}=r;if(!e&&!t)return JSON.stringify({error:"sprintName or sprintId is required"});let n=c||50,o=t?`sprint = ${t}`:`sprint = "${e}"`,l=a?`project = ${a} AND `:"",u=i?` AND status = "${i}"`:"",d=`${l}${o}${u} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(d)}&maxResults=${n}&fields=summary,status,assignee,priority,issuetype,project`,g=await y(`/rest/api/3/search/jql?${m}`),p=(g.issues||[]).map(f=>({key:f.key,project:f.fields?.project?.key,summary:f.fields?.summary,status:f.fields?.status?.name,assignee:f.fields?.assignee?.displayName||"Unassigned",priority:f.fields?.priority?.name,type:f.fields?.issuetype?.name})),h={};for(let f of p)h[f.status]=(h[f.status]||0)+1;return JSON.stringify({count:p.length,total:g.total||p.length,statusCounts:h,issues:p})}case"jira_get_comments":{let{issueKey:e,maxResults:t}=r;if(!e)return JSON.stringify({error:"issueKey is required"});let i=await y(`/rest/api/3/issue/${e}/comment?maxResults=${t||50}&orderBy=-created`),c=(i.comments||[]).map(n=>{let o="";return n.body?.content&&(o=w(n.body.content)),{id:n.id,author:n.author?.displayName||"Unknown",body:o,created:n.created,updated:n.updated}});return JSON.stringify({count:c.length,total:i.total||c.length,comments:c})}case"jira_add_comment":{let{issueKey:e,body:t}=r;return!e||!t?JSON.stringify({error:"issueKey and body are required"}):(await y(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:t}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:t}=r;return!e||!t?JSON.stringify({error:"issueKey and fields are required"}):(await y(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:t}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:t,toStatus:a,statusName:i,status:c}=r;if(!e)return JSON.stringify({error:"issueKey is required"});let n=String(a||i||c||"").trim();if(!t&&!n){let d=((await y(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(m=>({id:m.id,name:m.name,to:m.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:d})}let o=t;if(!o){let d=(await y(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=v(n),g=d.find(p=>v(p?.name||"")===m||v(p?.to?.name||"")===m);if(!g){let p=A(n);p.length>=2&&(g=d.find(h=>{let f=A(h?.name||""),j=A(h?.to?.name||""),_=f.length>=2&&(f.includes(p)||p.includes(f)),k=j.length>=2&&(j.includes(p)||p.includes(j));return _||k}))}if(!g){let p=d.map(_=>{let k=I(n,_?.name||""),q=I(n,_?.to?.name||"");return{t:_,score:Math.max(k,q)}}).sort((_,k)=>k.score-_.score),h=p[0],f=p[1];h&&h.score>=.45&&(!f||h.score-f.score>=.12)&&(g=h.t)}if(!g?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${n}"`,issueKey:e,availableTransitions:d.map(p=>({id:p.id,name:p.name,to:p.to?.name}))});o=g.id}await y(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:o}}});let l=await y(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:o,statusAfter:l?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description (plain text)"},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text (plain text)"}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, story points, labels, priority)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};var W={new:"todo",indeterminate:"in_progress",done:"done"},Q=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function T(s){if(!s)return"unknown";if(s.name&&Q.test(s.name))return"blocked";let r=s.statusCategory?.key;return W[r]||"unknown"}function J(s){if(!s)return"";if(Array.isArray(s))return s.map(J).join("");if(s.type==="text")return s.text||"";if(s.type==="hardBreak"||s.type==="rule")return`
|
|
70
|
-
`;let
|
|
71
|
-
`),
|
|
71
|
+
6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=qe();if(!s)return null;let n={};for(let e of this.envKeys)process.env[e]&&(n[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(n.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(n[e]=process.env[e]);return{command:"node",args:[s],env:n,description:this.description}},async handleToolCall(s,n){try{switch(s){case"jira_list_projects":{let e=await f("/rest/api/3/project"),t=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:t.length,projects:t})}case"jira_list_statuses":{let{projectKey:e}=n||{};if(e){let r=await f(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),a=Array.isArray(r)?r:[],o=new Map;for(let l of a)for(let u of l.statuses||[])u?.id&&(o.has(u.id)||o.set(u.id,{id:u.id,name:u.name,category:u.statusCategory?.name||null}));let c=[...o.values()].sort((l,u)=>String(l.name).localeCompare(String(u.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let t=await f("/rest/api/3/status"),i=(Array.isArray(t)?t:[]).map(r=>({id:r.id,name:r.name,category:r.statusCategory?.name||null})).sort((r,a)=>String(r.name).localeCompare(String(a.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=n||{};if(!e)return JSON.stringify({error:"projectKey is required"});let t=await ce(e);return JSON.stringify({projectKey:e,count:t.length,issueTypes:t})}case"jira_search":{let e=n.jql||"",t=n.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let r=`jql=${encodeURIComponent(e)}&maxResults=${t}&fields=summary,status,assignee,priority,updated,issuetype,project`,o=((await f(`/rest/api/3/search/jql?${r}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:o.length,issues:o})}case"jira_get_issue":{let e=n.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let t=await f(`/rest/api/3/issue/${e}`);return JSON.stringify({key:t.key,project:t.fields?.project?.key,summary:t.fields?.summary,description:t.fields?.description?B(t.fields.description):t.fields?.description??null,status:t.fields?.status?.name,assignee:t.fields?.assignee?.displayName||"Unassigned",priority:t.fields?.priority?.name,type:t.fields?.issuetype?.name,labels:t.fields?.labels,created:t.fields?.created,updated:t.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:t,issueType:i,description:r,priority:a,labels:o,assigneeId:c,moveToSprint:l,moveToActiveSprint:u,sprintId:d,sprintName:m,target:g}=n;if(!e||!t)return JSON.stringify({error:"projectKey and summary are required"});let p={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await ce(e),p=Ke(i,h)}catch{}let y={project:{key:e},summary:t,issuetype:p?.resolved?.id?{id:p.resolved.id}:{name:i||"Task"}};a&&(y.priority={name:a}),o?.length&&(y.labels=o),c&&(y.assignee={id:c});let I=r?await U(j=>f("/rest/api/3/issue",{method:"POST",body:{fields:{...y,description:j}}}),r):await f("/rest/api/3/issue",{method:"POST",body:{fields:y}}),k={ok:!0,key:I.key,id:I.id,self:I.self};return p?.resolved&&(k.issueType=p.resolved.name,k.issueTypeResolution=p.strategy,p.strategy!=="exact"&&p.requested&&w(p.requested)!==w(p.resolved.name)&&(k.issueTypeWarning=`Requested "${p.requested}" is not available in ${e}; used "${p.resolved.name}" instead.`)),h.length>0&&(k.availableIssueTypes=h.map(j=>j.name)),(l||u)&&(k.sprintMove=await G({issueKey:I.key,projectKey:e,sprintId:d,sprintName:m,target:g})),JSON.stringify(k)}case"jira_list_sprints":{let{projectKey:e,state:t}=n,i=await le(e,t);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:t,sprintId:i,sprintName:r,target:a}=n||{},o=await G({issueKey:e,projectKey:t,sprintId:i,sprintName:r,target:a||"current"});return JSON.stringify(o)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:t,sprintId:i,sprintName:r,target:a}=n||{},o=await G({issueKey:e,projectKey:t,sprintId:i,sprintName:r,target:a});return JSON.stringify(o)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:t,projectKey:i,status:r,maxResults:a}=n;if(!e&&!t)return JSON.stringify({error:"sprintName or sprintId is required"});let o=a||50,c=t?`sprint = ${t}`:`sprint = "${e}"`,l=i?`project = ${i} AND `:"",u=r?` AND status = "${r}"`:"",d=`${l}${c}${u} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(d)}&maxResults=${o}&fields=summary,status,assignee,priority,issuetype,project`,g=await f(`/rest/api/3/search/jql?${m}`),p=(g.issues||[]).map(y=>({key:y.key,project:y.fields?.project?.key,summary:y.fields?.summary,status:y.fields?.status?.name,assignee:y.fields?.assignee?.displayName||"Unassigned",priority:y.fields?.priority?.name,type:y.fields?.issuetype?.name})),h={};for(let y of p)h[y.status]=(h[y.status]||0)+1;return JSON.stringify({count:p.length,total:g.total||p.length,statusCounts:h,issues:p})}case"jira_get_comments":{let{issueKey:e,maxResults:t}=n;if(!e)return JSON.stringify({error:"issueKey is required"});let r=await f(`/rest/api/3/issue/${e}/comment?maxResults=${t||50}&orderBy=-created`),a=(r.comments||[]).map(o=>{let c=o.body?.content?B(o.body):"";return{id:o.id,author:o.author?.displayName||"Unknown",body:c,created:o.created,updated:o.updated}});return JSON.stringify({count:a.length,total:r.total||a.length,comments:a})}case"jira_add_comment":{let{issueKey:e,body:t}=n;return!e||!t?JSON.stringify({error:"issueKey and body are required"}):(await U(i=>f(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:i}}),t),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:t}=n;if(!e||!t)return JSON.stringify({error:"issueKey and fields are required"});if(typeof t.description=="string"){let{description:i,...r}=t;await U(a=>f(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:{...r,description:a}}}),i)}else await f(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:t}});return JSON.stringify({ok:!0,issueKey:e})}case"jira_transition_issue":{let{issueKey:e,transitionId:t,toStatus:i,statusName:r,status:a}=n;if(!e)return JSON.stringify({error:"issueKey is required"});let o=String(i||r||a||"").trim();if(!t&&!o){let d=((await f(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(m=>({id:m.id,name:m.name,to:m.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:d})}let c=t;if(!c){let d=(await f(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=O(o),g=d.find(p=>O(p?.name||"")===m||O(p?.to?.name||"")===m);if(!g){let p=D(o);p.length>=2&&(g=d.find(h=>{let y=D(h?.name||""),I=D(h?.to?.name||""),k=y.length>=2&&(y.includes(p)||p.includes(y)),j=I.length>=2&&(I.includes(p)||p.includes(I));return k||j}))}if(!g){let p=d.map(k=>{let j=C(o,k?.name||""),ue=C(o,k?.to?.name||"");return{t:k,score:Math.max(j,ue)}}).sort((k,j)=>j.score-k.score),h=p[0],y=p[1];h&&h.score>=.45&&(!y||h.score-y.score>=.12)&&(g=h.t)}if(!g?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${o}"`,issueKey:e,availableTransitions:d.map(p=>({id:p.id,name:p.name,to:p.to?.name}))});c=g.id}await f(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let l=await f(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:l?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description. Markdown is rendered (headings, **bold**, `code`, lists, - [ ] tasks, links, tables, > quotes, > [!NOTE]/[!TIP]/[!WARNING]/[!CAUTION] panels)."},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text. Markdown is rendered: headings, **bold**, `code`, lists, - [ ] tasks, links, tables, > quotes, > [!NOTE]/[!TIP]/[!WARNING]/[!CAUTION] panels."}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, description, story points, labels, priority). A string `description` is Markdown and is rendered.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};var Ge={new:"todo",indeterminate:"in_progress",done:"done"},Fe=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function z(s){if(!s)return"unknown";if(s.name&&Fe.test(s.name))return"blocked";let n=s.statusCategory?.key;return Ge[n]||"unknown"}function H(s){if(!s)return"";if(Array.isArray(s))return s.map(H).join("");if(s.type==="text")return s.text||"";if(s.type==="hardBreak"||s.type==="rule")return`
|
|
72
|
+
`;let n=s.content?H(s.content):"";return/^(paragraph|heading|listItem|blockquote|codeBlock|panel)$/.test(s.type)&&(n+=`
|
|
73
|
+
`),n}function F(s,n){let e=s.fields||{},t=e.status||null,i=null;if(s.self&&s.key)try{i=`${new URL(s.self).origin}/browse/${s.key}`}catch{i=null}return!i&&n&&s.key&&(i=`${String(n).replace(/\/+$/,"")}/browse/${s.key}`),{id:String(s.id??s.key??""),key:s.key,title:e.summary||"",body:typeof e.description=="string"?e.description:H(e.description?.content).trim(),state:t?.name||null,stateCategory:z(t),assignee:e.assignee?.displayName||null,url:i,_raw:s}}function W(s){let n=JSON.parse(s);if(n&&n.error)throw new Error(n.error);return n}var We={id:"jira",toStateCategory:z,toNeutral:F,async listCandidates(s={}){let n=s.query||"";if(!n.trim()){let r=[];if(s.state&&r.push(`status = "${s.state}"`),s.labels){let a=Array.isArray(s.labels)?s.labels:[s.labels];for(let o of a)r.push(`labels = "${o}"`)}s.updatedAfter&&r.push(`updated >= "${s.updatedAfter}"`),n=r.length?`${r.join(" AND ")} ORDER BY updated DESC`:"ORDER BY updated DESC"}let e=Number(s.limit)||30,t=`jql=${encodeURIComponent(n)}&maxResults=${e}&fields=summary,description,status,assignee,labels,project,updated,created`;return((await f(`/rest/api/3/search/jql?${t}`)).issues||[]).map(r=>F(r))},async getTicket(s){if(!s)throw new Error("key is required");let n=await f(`/rest/api/3/issue/${encodeURIComponent(s)}`);return!n||!n.key?null:F(n)},async getComments(s){if(!s)throw new Error("key is required");return(W(await $.handleToolCall("jira_get_comments",{issueKey:s})).comments||[]).map(e=>({id:String(e.id),author:e.author||"Unknown",body:e.body||"",createdAt:e.created||null,updatedAt:e.updated||null,_raw:e}))},async addComment(s,n){if(!s||!n)throw new Error("key and body are required");return{ok:!!W(await $.handleToolCall("jira_add_comment",{issueKey:s,body:n})).ok,id:null}},async transition(s,n){if(!s)throw new Error("key is required");let e=JSON.parse(await $.handleToolCall("jira_transition_issue",{issueKey:s,toStatus:n}));if(!e.ok)return{ok:!1,error:e.error||"transition failed",_raw:e};let t=e.statusAfter||null;return{ok:!0,stateAfter:t,stateCategoryAfter:z(t?{name:t}:null),_raw:e}},async linkPullRequest(s,n,e){if(!s||!n)throw new Error("key and prUrl are required");try{return await f(`/rest/api/3/issue/${encodeURIComponent(s)}/remotelink`,{method:"POST",body:{object:{url:n,title:e||n,icon:{url16x16:"https://github.com/favicon.ico",title:"GitHub"}}}}),{ok:!0,via:"remotelink"}}catch(t){let i=`${e?`${e}: `:"Linked PR: "}${n}`;return{ok:!!W(await $.handleToolCall("jira_add_comment",{issueKey:s,body:i})).ok,via:"comment",error:String(t?.message||t)}}}},rt=We;export{rt as default,We as jiraAdapter};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{existsSync as
|
|
1
|
+
import{existsSync as R}from"fs";import{fileURLToPath as $}from"url";import{dirname as C,resolve as K}from"path";var L=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",LARK_DOCS:"lark_docs",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",VIKUNJA:"vikunja",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),H=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark Chat",connectPath:"/integrations?provider=lark"},lark_docs:{id:"lark_docs",name:"Lark App",connectPath:"/integrations?provider=lark_docs"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},vikunja:{id:"vikunja",name:"Vikunja",connectPath:"/integrations?provider=vikunja"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});var k={api:{knob:"SKILL_API_TIMEOUT_MS",fallback:3e4},transfer:{knob:"SKILL_TRANSFER_TIMEOUT_MS",fallback:12e4},job:{knob:"SKILL_JOB_TIMEOUT_MS",fallback:3e5}};function E(t,n,e=process.env){let i=Number(e?.[t]);return Number.isFinite(i)&&i>0?Math.min(6e5,Math.max(1e3,Math.floor(i))):n}function O(t="api",n=process.env){let e=k[t]||k.api;return E(e.knob,e.fallback,n)}function v(t){return t?.name==="TimeoutError"||t?.name==="AbortError"}function P(t){try{return new URL(String(t?.url??t)).host||"unknown host"}catch{return"unknown host"}}function M(t,n){if(!t)return n;let e=new AbortController,i=s=>{e.signal.aborted||e.abort(s)},a=()=>i(t.reason),r=()=>i(n.reason);return e.signal.addEventListener("abort",()=>{t.removeEventListener("abort",a),n.removeEventListener("abort",r)},{once:!0}),t.aborted?i(t.reason):n.aborted?i(n.reason):(t.addEventListener("abort",a,{once:!0}),n.addEventListener("abort",r,{once:!0})),e.signal}async function S(t,n={},e={}){let i=e.kind||"api",a=(k[i]||k.api).knob,r=e.timeoutMs?Math.min(6e5,Math.max(1e3,Math.floor(e.timeoutMs))):O(i),s=n?.signal;if(s?.aborted)throw s.reason??new DOMException("This operation was aborted","AbortError");let o=AbortSignal.timeout(r),d=M(s,o);try{return await fetch(t,{...n,signal:d})}catch(m){throw o.aborted&&v(m)?new Error(`${e.what||"request"} TIMED OUT after ${r}ms against ${P(t)} (${a})`):m}}function U(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let t=C($(import.meta.url)),n=K(t,"..","bin","mcp-skill.mjs");return R(n)?n:null}var x=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function G(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let t=process.env.LINEAR_API_KEY;if(!t)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return t}async function f(t,n={}){let e=await S(x,{method:"POST",headers:{Authorization:G(),"Content-Type":"application/json"},body:JSON.stringify({query:t,variables:n})},{kind:"api",what:"Linear GraphQL"});if(!e.ok){let a=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${a.slice(0,300)}`)}let i=await e.json().catch(()=>null);if(!i)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(i.errors)&&i.errors.length){let a=i.errors.map(r=>r?.message||String(r)).join("; ");throw new Error(`Linear GraphQL error: ${a.slice(0,300)}`)}return i.data}function I(t){return String(t||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function q(t,n){let e=I(t),i=I(n);if(!e||!i)return 0;if(e===i)return 1;if(e.length===1||i.length===1)return e===i?1:0;let a=l=>{let u=new Map;for(let y=0;y<l.length-1;y++){let g=l.slice(y,y+2);u.set(g,(u.get(g)||0)+1)}return u},r=a(e),s=a(i),o=0,d=0,m=0;for(let l of r.values())d+=l;for(let l of s.values())m+=l;for(let[l,u]of r.entries())o+=Math.min(u,s.get(l)||0);return 2*o/Math.max(1,d+m)}function J(t,n){let e=Array.isArray(t)?t:[];if(!e.length)return{state:null,strategy:"no-states"};let i=I(n);if(!i)return{state:null,strategy:"no-target"};let a=e.find(o=>I(o.name)===i);if(a)return{state:a,strategy:"exact"};let r={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[o,d]of Object.entries(r)){if(!d.some(l=>I(l)===i))continue;let m=e.find(l=>l.type===o);if(m)return{state:m,strategy:"type-alias"}}let s=e.map(o=>({s:o,score:q(n,o.name)})).sort((o,d)=>d.score-o.score);return s[0]&&s[0].score>=.5?{state:s[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var j=`
|
|
2
2
|
id
|
|
3
3
|
identifier
|
|
4
4
|
number
|
|
@@ -12,7 +12,7 @@ import{existsSync as S}from"fs";import{fileURLToPath as v}from"url";import{dirna
|
|
|
12
12
|
assignee { id name displayName email }
|
|
13
13
|
labels { nodes { id name color } }
|
|
14
14
|
team { id key name }
|
|
15
|
-
`,_={id:"linear",serverName:"linear",allowedTools:["mcp__linear__*"],requiresIntegration:
|
|
15
|
+
`,_={id:"linear",serverName:"linear",allowedTools:["mcp__linear__*"],requiresIntegration:L.LINEAR,envKeys:["LINEAR_API_KEY","LINEAR_OAUTH_TOKEN"],description:"Linear \u2014 issues, comments, workflow states (GraphQL API key)",promptFragment:`## Linear
|
|
16
16
|
You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
17
17
|
|
|
18
18
|
### Discovery
|
|
@@ -30,32 +30,32 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
|
30
30
|
|
|
31
31
|
### Notes
|
|
32
32
|
- Always resolve a team first when you need states or want to create/move issues by state name \u2014 states only make sense within their team.
|
|
33
|
-
- Issue identifier (ENG-123) and internal id (uuid) are both accepted by get/update tools.`,resolve(){let
|
|
33
|
+
- Issue identifier (ENG-123) and internal id (uuid) are both accepted by get/update tools.`,resolve(){let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);process.env.LINEAR_API_URL&&(t.LINEAR_API_URL=process.env.LINEAR_API_URL);let n=U();return n?{type:"stdio",command:"node",args:[n,"../dist/linear.js","linearSkill"],env:t,description:this.description,alwaysLoad:!0}:{command:null,args:[],env:t,description:this.description}},async handleToolCall(t,n){try{switch(t){case"linear_list_teams":{let i=(await f(`
|
|
34
34
|
query Teams($first: Int) {
|
|
35
35
|
teams(first: $first) {
|
|
36
36
|
nodes { id key name description }
|
|
37
37
|
}
|
|
38
38
|
}
|
|
39
|
-
`,{first:
|
|
39
|
+
`,{first:n?.limit||50}))?.teams?.nodes||[];return JSON.stringify({count:i.length,teams:i})}case"linear_list_states":{let{teamId:e,teamKey:i}=n||{},a=e;if(!a&&i&&(a=await N(i)),a){let d=(await f(`
|
|
40
40
|
query States($teamId: String!) {
|
|
41
41
|
team(id: $teamId) {
|
|
42
42
|
id key name
|
|
43
43
|
states { nodes { id name type color position } }
|
|
44
44
|
}
|
|
45
45
|
}
|
|
46
|
-
`,{teamId:
|
|
46
|
+
`,{teamId:a}))?.team,m=(d?.states?.nodes||[]).slice().sort((l,u)=>(l.position||0)-(u.position||0));return JSON.stringify({team:d?{id:d.id,key:d.key,name:d.name}:null,count:m.length,states:m})}let s=(await f(`
|
|
47
47
|
query AllStates($first: Int) {
|
|
48
48
|
workflowStates(first: $first) {
|
|
49
49
|
nodes { id name type color team { id key name } }
|
|
50
50
|
}
|
|
51
51
|
}
|
|
52
|
-
`,{first:
|
|
52
|
+
`,{first:n?.limit||200}))?.workflowStates?.nodes||[];return JSON.stringify({scope:"workspace",count:s.length,states:s})}case"linear_list_labels":{let{teamId:e}=n||{},a=(await f(`
|
|
53
53
|
query Labels($first: Int, $filter: IssueLabelFilter) {
|
|
54
54
|
issueLabels(first: $first, filter: $filter) {
|
|
55
55
|
nodes { id name color team { id key } }
|
|
56
56
|
}
|
|
57
57
|
}
|
|
58
|
-
`,{first:
|
|
58
|
+
`,{first:n?.limit||100,filter:e?{team:{id:{eq:e}}}:void 0}))?.issueLabels?.nodes||[];return JSON.stringify({count:a.length,labels:a})}case"linear_list_issues":{let{teamId:e,teamKey:i,stateId:a,stateName:r,label:s,assigneeId:o,updatedAfter:d,limit:m}=n||{},l={},u=e;!u&&i&&(u=await N(i)),u&&(l.team={id:{eq:u}}),a?l.state={id:{eq:a}}:r&&(l.state={name:{eqIgnoreCase:r}}),s&&(l.labels={name:{eqIgnoreCase:s}}),o&&(l.assignee={id:{eq:o}}),d&&(l.updatedAt={gt:d});let g=((await f(`
|
|
59
59
|
query Issues($first: Int, $filter: IssueFilter, $orderBy: PaginationOrderBy) {
|
|
60
60
|
issues(first: $first, filter: $filter, orderBy: $orderBy) {
|
|
61
61
|
nodes {
|
|
@@ -67,48 +67,48 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
|
67
67
|
}
|
|
68
68
|
}
|
|
69
69
|
}
|
|
70
|
-
`,{first:m||30,filter:Object.keys(
|
|
70
|
+
`,{first:m||30,filter:Object.keys(l).length?l:void 0,orderBy:"updatedAt"}))?.issues?.nodes||[]).map(c=>({id:c.id,identifier:c.identifier,number:c.number,title:c.title,url:c.url,priority:c.priority,state:c.state?.name,stateType:c.state?.type,assignee:c.assignee?.displayName||null,labels:(c.labels?.nodes||[]).map(p=>p.name),team:c.team?.key,createdAt:c.createdAt,updatedAt:c.updatedAt}));return JSON.stringify({count:g.length,issues:g})}case"linear_get_issue":{let e=n?.issueId||n?.identifier||n?.issueKey;if(!e)return JSON.stringify({error:"issueId or identifier is required"});let i=await b(e);return JSON.stringify(i?{id:i.id,identifier:i.identifier,number:i.number,title:i.title,description:i.description||"",url:i.url,priority:i.priority,state:i.state?.name,stateId:i.state?.id,stateType:i.state?.type,assignee:i.assignee?.displayName||i.assignee?.name||null,assigneeId:i.assignee?.id||null,labels:(i.labels?.nodes||[]).map(a=>a.name),team:i.team?{id:i.team.id,key:i.team.key,name:i.team.name}:null,createdAt:i.createdAt,updatedAt:i.updatedAt}:{error:`Issue not found: ${e}`})}case"linear_get_comments":{let e=n?.issueId||n?.identifier||n?.issueKey;if(!e)return JSON.stringify({error:"issueId or identifier is required"});let i=await b(e,`
|
|
71
71
|
id identifier
|
|
72
|
-
comments(first: ${Number(
|
|
72
|
+
comments(first: ${Number(n?.limit)||50}) {
|
|
73
73
|
nodes { id body createdAt updatedAt user { id name displayName } }
|
|
74
74
|
}
|
|
75
|
-
`);if(!
|
|
75
|
+
`);if(!i)return JSON.stringify({error:`Issue not found: ${e}`});let a=(i.comments?.nodes||[]).map(r=>({id:r.id,author:r.user?.displayName||r.user?.name||"Unknown",body:r.body||"",createdAt:r.createdAt,updatedAt:r.updatedAt})).sort((r,s)=>String(s.createdAt).localeCompare(String(r.createdAt)));return JSON.stringify({count:a.length,issue:i.identifier,comments:a})}case"linear_add_comment":{let e=n?.issueId||n?.identifier||n?.issueKey,i=n?.body;if(!e||!i)return JSON.stringify({error:"issueId/identifier and body are required"});let a=await b(e,"id identifier");if(!a)return JSON.stringify({error:`Issue not found: ${e}`});let s=(await f(`
|
|
76
76
|
mutation AddComment($input: CommentCreateInput!) {
|
|
77
77
|
commentCreate(input: $input) {
|
|
78
78
|
success
|
|
79
79
|
comment { id url createdAt }
|
|
80
80
|
}
|
|
81
81
|
}
|
|
82
|
-
`,{input:{issueId:
|
|
82
|
+
`,{input:{issueId:a.id,body:i}}))?.commentCreate;return JSON.stringify({ok:!!s?.success,commentId:s?.comment?.id,url:s?.comment?.url})}case"linear_update_state":{let e=n?.issueId||n?.identifier||n?.issueKey,{stateId:i,stateName:a,toStatus:r,status:s}=n||{};if(!e)return JSON.stringify({error:"issueId or identifier is required"});let o=await b(e,`
|
|
83
83
|
id identifier
|
|
84
84
|
state { id name type }
|
|
85
85
|
team { id key states { nodes { id name type position } } }
|
|
86
|
-
`);if(!o)return JSON.stringify({error:`Issue not found: ${e}`});let
|
|
86
|
+
`);if(!o)return JSON.stringify({error:`Issue not found: ${e}`});let d=i,m=i?{strategy:"explicit-id"}:null;if(!d){let y=String(a||r||s||"").trim(),g=(o.team?.states?.nodes||[]).slice().sort((p,T)=>(p.position||0)-(T.position||0));if(!y)return JSON.stringify({ok:!1,error:"stateId or stateName/toStatus is required",issue:o.identifier,availableStates:g.map(p=>({id:p.id,name:p.name,type:p.type}))});let c=J(g,y);if(!c.state)return JSON.stringify({ok:!1,error:`No workflow state matches "${y}" in team ${o.team?.key}`,issue:o.identifier,availableStates:g.map(p=>({id:p.id,name:p.name,type:p.type}))});d=c.state.id,m={strategy:c.strategy,matchedName:c.state.name}}let u=(await f(`
|
|
87
87
|
mutation MoveIssue($id: String!, $input: IssueUpdateInput!) {
|
|
88
88
|
issueUpdate(id: $id, input: $input) {
|
|
89
89
|
success
|
|
90
90
|
issue { id identifier state { id name type } }
|
|
91
91
|
}
|
|
92
92
|
}
|
|
93
|
-
`,{id:o.id,input:{stateId:
|
|
93
|
+
`,{id:o.id,input:{stateId:d}}))?.issueUpdate;return JSON.stringify({ok:!!u?.success,issue:u?.issue?.identifier||o.identifier,stateAfter:u?.issue?.state?.name||null,stateTypeAfter:u?.issue?.state?.type||null,resolution:m})}case"linear_link_attachment":{let e=n?.issueId||n?.identifier||n?.issueKey,{url:i,title:a,subtitle:r}=n||{};if(!e||!i)return JSON.stringify({error:"issueId/identifier and url are required"});let s=await b(e,"id identifier");if(!s)return JSON.stringify({error:`Issue not found: ${e}`});let d=(await f(`
|
|
94
94
|
mutation LinkAttachment($input: AttachmentCreateInput!) {
|
|
95
95
|
attachmentCreate(input: $input) {
|
|
96
96
|
success
|
|
97
97
|
attachment { id url title }
|
|
98
98
|
}
|
|
99
99
|
}
|
|
100
|
-
`,{input:{issueId:
|
|
100
|
+
`,{input:{issueId:s.id,url:i,title:a||i,subtitle:r||void 0}}))?.attachmentCreate;return JSON.stringify({ok:!!d?.success,attachmentId:d?.attachment?.id,url:d?.attachment?.url})}default:return JSON.stringify({error:`Unknown tool: ${t}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"linear_list_teams",description:"List Linear teams (id, key, name). Needed to scope workflow states and issue queries.",input_schema:{type:"object",properties:{limit:{type:"number",description:"Max teams (default: 50)"}}}},{name:"linear_list_states",description:"List a team's workflow states (id, name, type: backlog|unstarted|started|completed|canceled|triage). Linear states are PER-TEAM. Omit team to list all states across the workspace.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Team uuid"},teamKey:{type:"string",description:"Team key (e.g. ENG); resolved to an id if teamId omitted"},limit:{type:"number",description:"Max states when listing workspace-wide (default: 200)"}}}},{name:"linear_list_labels",description:"List issue labels, optionally scoped to a team.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Optional team uuid to scope labels"},limit:{type:"number",description:"Max labels (default: 100)"}}}},{name:"linear_list_issues",description:"List/poll Linear issues filtered by team, state, label, assignee, and an updatedAfter cursor. Returns newest-updated first.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Team uuid"},teamKey:{type:"string",description:"Team key (e.g. ENG); resolved if teamId omitted"},stateId:{type:"string",description:"Filter by workflow state uuid"},stateName:{type:"string",description:"Filter by state name (case-insensitive)"},label:{type:"string",description:"Filter by label name (case-insensitive)"},assigneeId:{type:"string",description:"Filter by assignee uuid"},updatedAfter:{type:"string",description:"ISO-8601 timestamp; only issues updated after this (polling cursor)"},limit:{type:"number",description:"Max issues (default: 30)"}}}},{name:"linear_get_issue",description:"Get a single Linear issue by identifier (e.g. ENG-123) or internal uuid \u2014 title, description, state, labels, assignee, url.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"}}}},{name:"linear_get_comments",description:"Get comments on a Linear issue (newest first).",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},limit:{type:"number",description:"Max comments (default: 50)"}}}},{name:"linear_add_comment",description:"Add a comment to a Linear issue (markdown supported).",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},body:{type:"string",description:"Comment body (markdown)"}},required:["body"]}},{name:"linear_update_state",description:"Move a Linear issue to a different workflow state. Pass a state NAME (toStatus/stateName) and the tool resolves it to the issue's team's matching state id (exact -> type-alias -> fuzzy), or pass stateId directly. Linear has no transitions \u2014 this sets the state.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},stateId:{type:"string",description:"Target workflow state uuid (skips name resolution)"},stateName:{type:"string",description:'Target state name (e.g. "In Progress", "Done")'},toStatus:{type:"string",description:"Alias for stateName"}}}},{name:"linear_link_attachment",description:"Attach a URL (e.g. a GitHub PR) to a Linear issue via native attachments. Use this for PR links; fall back to linear_add_comment if it fails.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},url:{type:"string",description:"The URL to attach (e.g. a PR link)"},title:{type:"string",description:"Attachment title (defaults to the URL)"},subtitle:{type:"string",description:"Optional attachment subtitle"}},required:["url"]}}]};async function N(t){return(await f(`
|
|
101
101
|
query TeamByKey($filter: TeamFilter) {
|
|
102
102
|
teams(first: 1, filter: $filter) { nodes { id key } }
|
|
103
103
|
}
|
|
104
|
-
`,{filter:{key:{eq:
|
|
104
|
+
`,{filter:{key:{eq:t}}}))?.teams?.nodes?.[0]?.id||null}async function b(t,n=j){let e=String(t).trim(),i=/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/.exec(e);if(i){let r=i[1].toUpperCase(),s=Number(i[2]);return(await f(`
|
|
105
105
|
query IssueByIdentifier($filter: IssueFilter) {
|
|
106
106
|
issues(first: 1, filter: $filter) {
|
|
107
|
-
nodes { ${
|
|
107
|
+
nodes { ${n} }
|
|
108
108
|
}
|
|
109
109
|
}
|
|
110
|
-
`,{filter:{number:{eq:
|
|
110
|
+
`,{filter:{number:{eq:s},team:{key:{eq:r}}}}))?.issues?.nodes?.[0]||null}return(await f(`
|
|
111
111
|
query IssueById($id: String!) {
|
|
112
|
-
issue(id: $id) { ${
|
|
112
|
+
issue(id: $id) { ${n} }
|
|
113
113
|
}
|
|
114
|
-
`,{id:e}))?.issue||null}var
|
|
114
|
+
`,{id:e}))?.issue||null}var D={triage:"todo",backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",canceled:"done"},B=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function w(t){return t?t.name&&B.test(t.name)?"blocked":D[t.type]||"unknown":"unknown"}function h(t){let n=JSON.parse(t);if(n&&n.error)throw new Error(n.error);return n}function A(t){let n=t.state||null,e=t.stateType||null;return{id:String(t.id||t.identifier||""),key:t.identifier||String(t.id||""),title:t.title||"",body:t.description||"",state:n,stateCategory:w(n?{name:n,type:e}:null),assignee:t.assignee||null,url:t.url||null,_raw:t}}var F={id:"linear",toStateCategory:w,toNeutral:A,async listCandidates(t={}){let n=t.ctx||{},e={teamId:n.teamId,teamKey:n.teamKey,stateName:t.state,label:Array.isArray(t.labels)?t.labels[0]:t.labels,assigneeId:n.assigneeId,updatedAfter:t.updatedAfter,limit:t.limit};return(h(await _.handleToolCall("linear_list_issues",e)).issues||[]).map(A)},async getTicket(t){if(!t)throw new Error("key is required");let n=JSON.parse(await _.handleToolCall("linear_get_issue",{identifier:t}));return n.error?null:A(n)},async getComments(t){if(!t)throw new Error("key is required");return(h(await _.handleToolCall("linear_get_comments",{identifier:t})).comments||[]).map(e=>({id:String(e.id),author:e.author||"Unknown",body:e.body||"",createdAt:e.createdAt||null,updatedAt:e.updatedAt||null,_raw:e}))},async addComment(t,n){if(!t||!n)throw new Error("key and body are required");let e=h(await _.handleToolCall("linear_add_comment",{identifier:t,body:n}));return{ok:!!e.ok,id:e.commentId||null}},async transition(t,n){if(!t)throw new Error("key is required");let e=JSON.parse(await _.handleToolCall("linear_update_state",{identifier:t,toStatus:n}));if(!e.ok)return{ok:!1,error:e.error||"state update failed",_raw:e};let i=e.stateAfter||null;return{ok:!0,stateAfter:i,stateCategoryAfter:w(i?{name:i,type:e.stateTypeAfter}:null),_raw:e}},async linkPullRequest(t,n,e){if(!t||!n)throw new Error("key and prUrl are required");try{if(h(await _.handleToolCall("linear_link_attachment",{identifier:t,url:n,title:e||n})).ok)return{ok:!0,via:"attachment"};throw new Error("attachmentCreate returned ok:false")}catch(i){let a=`${e?`${e}: `:"Linked PR: "}${n}`;return{ok:!!h(await _.handleToolCall("linear_add_comment",{identifier:t,body:a})).ok,via:"comment",error:String(i?.message||i)}}}},ie=F;export{ie as default,F as linearAdapter};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
var f=(process.env.PLANE_API_URL||"https://api.plane.so/api/v1").replace(/\/+$/,""),
|
|
1
|
+
var u={api:{knob:"SKILL_API_TIMEOUT_MS",fallback:3e4},transfer:{knob:"SKILL_TRANSFER_TIMEOUT_MS",fallback:12e4},job:{knob:"SKILL_JOB_TIMEOUT_MS",fallback:3e5}};function b(e,t,n=process.env){let o=Number(n?.[e]);return Number.isFinite(o)&&o>0?Math.min(6e5,Math.max(1e3,Math.floor(o))):t}function E(e="api",t=process.env){let n=u[e]||u.api;return b(n.knob,n.fallback,t)}function k(e){return e?.name==="TimeoutError"||e?.name==="AbortError"}function y(e){try{return new URL(String(e?.url??e)).host||"unknown host"}catch{return"unknown host"}}function A(e,t){if(!e)return t;let n=new AbortController,o=r=>{n.signal.aborted||n.abort(r)},a=()=>o(e.reason),s=()=>o(t.reason);return n.signal.addEventListener("abort",()=>{e.removeEventListener("abort",a),t.removeEventListener("abort",s)},{once:!0}),e.aborted?o(e.reason):t.aborted?o(t.reason):(e.addEventListener("abort",a,{once:!0}),t.addEventListener("abort",s,{once:!0})),n.signal}async function f(e,t={},n={}){let o=n.kind||"api",a=(u[o]||u.api).knob,s=n.timeoutMs?Math.min(6e5,Math.max(1e3,Math.floor(n.timeoutMs))):E(o),r=t?.signal;if(r?.aborted)throw r.reason??new DOMException("This operation was aborted","AbortError");let c=AbortSignal.timeout(s),i=A(r,c);try{return await fetch(e,{...t,signal:i})}catch(_){throw c.aborted&&k(_)?new Error(`${n.what||"request"} TIMED OUT after ${s}ms against ${y(e)} (${a})`):_}}var w=(process.env.PLANE_API_URL||"https://api.plane.so/api/v1").replace(/\/+$/,""),T=process.env.PLANE_WORKSPACE_SLUG||"",L=process.env.PLANE_PROJECT_ID||"";function h(){let e=process.env.PLANE_API_KEY||process.env.PLANE_OAUTH_TOKEN;if(!e)throw new Error("Plane is not connected: set PLANE_API_KEY (personal access token).");return e}function l(e={}){let t=e.workspaceSlug||T,n=e.projectId||L;if(!t||!n)throw new Error("Plane scope missing: provide workspaceSlug + projectId (env PLANE_WORKSPACE_SLUG / PLANE_PROJECT_ID or per-call ctx).");return{workspaceSlug:t,projectId:n}}async function d(e,t={}){let n=`${w}${e}`;if(t.query&&Object.keys(t.query).length){let s=new URLSearchParams;for(let[c,i]of Object.entries(t.query))i!=null&&i!==""&&s.set(c,String(i));let r=s.toString();r&&(n+=(n.includes("?")?"&":"?")+r)}let o=await f(n,{method:t.method||"GET",headers:{"X-API-Key":h(),Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0},{kind:"api",what:`Plane ${t.method||"GET"} ${e}`});if(!o.ok){let s=await o.text().catch(()=>"");throw new Error(`Plane API ${o.status}: ${s.slice(0,300)}`)}let a=await o.text().catch(()=>"");if(!a||!a.trim())return{};try{return JSON.parse(a)}catch{return{raw:a}}}var O={backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",cancelled:"done"},P=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function m(e){return e?e.name&&P.test(e.name)?"blocked":O[e.group]||"unknown":"unknown"}var g=new Map,M=300*1e3;async function S(e){let{workspaceSlug:t,projectId:n}=l(e),o=g.get(n);if(o&&Date.now()-o.fetchedAt<M)return o.states;let a=await d(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(n)}/states/`,{query:{per_page:100}}),s=(a.results||a||[]).map(r=>({id:r.id,name:r.name,group:r.group,color:r.color}));return g.set(n,{fetchedAt:Date.now(),states:s}),s}function p(e){return String(e||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function U(e,t){let n=p(t);if(!n)return null;let o=e.find(s=>p(s.name)===n);if(o)return o;let a={todo:["todo","backlog","open","unstarted"],inprogress:["inprogress","started","doing","wip"],done:["done","completed","closed","resolved","cancelled","canceled"],blocked:["blocked","onhold","waiting"]};for(let[,s]of Object.entries(a)){if(!s.some(i=>p(i)===n))continue;let r=n==="done"?"completed":n==="inprogress"?"started":"unstarted",c=e.find(i=>i.group===r);if(c)return c}return null}async function I(e,t){let o=(await S(t).catch(()=>[])).find(i=>i.id===e.state)||null,{workspaceSlug:a,projectId:s}=l(t),r=t.projectIdentifier&&e.sequence_id!=null?`${t.projectIdentifier}-${e.sequence_id}`:e.sequence_id!=null?String(e.sequence_id):e.id,c=e.assignees||[];return{id:e.id,key:r,title:e.name||"",body:e.description_html||e.description_stripped||e.description||"",state:o?o.name:null,stateCategory:m(o),assignee:c.length?String(c[0]):null,url:t.baseWebUrl?`${t.baseWebUrl}/${a}/projects/${s}/issues/${e.id}`:null,_raw:e}}var R={id:"plane",envKeys:["PLANE_API_KEY","PLANE_OAUTH_TOKEN","PLANE_API_URL","PLANE_WORKSPACE_SLUG","PLANE_PROJECT_ID"],planeFetch:d,toStateCategory:m,async listCandidates(e={}){let t=e.ctx||{},{workspaceSlug:n,projectId:o}=l(t),a={per_page:Math.min(Number(e.limit)||50,100),cursor:e.cursor};e.state&&(a.state=e.state),e.updatedAfter&&(a.updated_at__gte=e.updatedAfter);let r=(await d(`/workspaces/${encodeURIComponent(n)}/projects/${encodeURIComponent(o)}/work-items/`,{query:a})).results||[];return e.updatedAfter&&(r=r.filter(c=>String(c.updated_at)>String(e.updatedAfter))),Promise.all(r.map(c=>I(c,t)))},async getTicket(e,t={}){let{workspaceSlug:n,projectId:o}=l(t),a=await d(`/workspaces/${encodeURIComponent(n)}/projects/${encodeURIComponent(o)}/work-items/${encodeURIComponent(e)}/`);return!a||!a.id?null:I(a,t)},async getComments(e,t={}){let{workspaceSlug:n,projectId:o}=l(t);return((await d(`/workspaces/${encodeURIComponent(n)}/projects/${encodeURIComponent(o)}/work-items/${encodeURIComponent(e)}/comments/`,{query:{per_page:100}})).results||[]).map(r=>({id:r.id,author:r.actor||r.actor_detail?.display_name||"Unknown",body:r.comment_html||r.comment_stripped||"",createdAt:r.created_at||null,updatedAt:r.updated_at||null,_raw:r})).sort((r,c)=>String(c.createdAt).localeCompare(String(r.createdAt)))},async addComment(e,t,n={}){let{workspaceSlug:o,projectId:a}=l(n),r=/<[a-z][\s\S]*>/i.test(String(t||""))?String(t):`<p>${String(t||"")}</p>`,c=await d(`/workspaces/${encodeURIComponent(o)}/projects/${encodeURIComponent(a)}/work-items/${encodeURIComponent(e)}/comments/`,{method:"POST",body:{comment_html:r}});return{ok:!!c.id,id:c.id||null,_raw:c}},async transition(e,t,n={}){let{workspaceSlug:o,projectId:a}=l(n),s=await S(n),r=U(s,t);if(!r)return{ok:!1,error:`No Plane state matches "${t}" in this project`,availableStates:s.map(i=>({id:i.id,name:i.name,group:i.group}))};let c=await d(`/workspaces/${encodeURIComponent(o)}/projects/${encodeURIComponent(a)}/work-items/${encodeURIComponent(e)}/`,{method:"PATCH",body:{state:r.id}});return{ok:!!c.id,stateAfter:r.name,stateCategoryAfter:m(r),_raw:c}},async linkPullRequest(e,t,n,o={}){let a=n?`${n}: `:"Linked PR: ";return{ok:!!(await this.addComment(e,`<p>${a}<a href="${t}">${t}</a></p>`,o)).ok,via:"comment"}}},N=R;export{N as default,R as planeAdapter,d as planeFetch,m as toStateCategory};
|
package/dist/triggerAgent.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{dirname as
|
|
1
|
+
import{dirname as h,resolve as O}from"path";import{fileURLToPath as m}from"url";import{existsSync as I}from"fs";var p={api:{knob:"SKILL_API_TIMEOUT_MS",fallback:3e4},transfer:{knob:"SKILL_TRANSFER_TIMEOUT_MS",fallback:12e4},job:{knob:"SKILL_JOB_TIMEOUT_MS",fallback:3e5}};function f(e,t,r=process.env){let n=Number(r?.[e]);return Number.isFinite(n)&&n>0?Math.min(6e5,Math.max(1e3,Math.floor(n))):t}function u(e="api",t=process.env){let r=p[e]||p.api;return f(r.knob,r.fallback,t)}function d(e){return e?.name==="TimeoutError"||e?.name==="AbortError"}function T(e){try{return new URL(String(e?.url??e)).host||"unknown host"}catch{return"unknown host"}}function _(e,t){if(!e)return t;let r=new AbortController,n=a=>{r.signal.aborted||r.abort(a)},i=()=>n(e.reason),s=()=>n(t.reason);return r.signal.addEventListener("abort",()=>{e.removeEventListener("abort",i),t.removeEventListener("abort",s)},{once:!0}),e.aborted?n(e.reason):t.aborted?n(t.reason):(e.addEventListener("abort",i,{once:!0}),t.addEventListener("abort",s,{once:!0})),r.signal}async function g(e,t={},r={}){let n=r.kind||"api",i=(p[n]||p.api).knob,s=r.timeoutMs?Math.min(6e5,Math.max(1e3,Math.floor(r.timeoutMs))):u(n),a=t?.signal;if(a?.aborted)throw a.reason??new DOMException("This operation was aborted","AbortError");let c=AbortSignal.timeout(s),o=_(a,c);try{return await fetch(e,{...t,signal:o})}catch(l){throw c.aborted&&d(l)?new Error(`${r.what||"request"} TIMED OUT after ${s}ms against ${T(e)} (${i})`):l}}function b(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let e=h(m(import.meta.url)),t=O(e,"..","bin","mcp-skill.mjs");return I(t)?t:null}function y(){return process.env.PROJECT_API_TOKEN||process.env.ZIBBY_USER_TOKEN||null}function S(){return((process.env.PROGRESS_API_URL||"").replace(/\/executions\/?$/,"")||process.env.ZIBBY_ACCOUNT_API_URL||process.env.ZIBBY_PROD_ACCOUNT_API_URL||(process.env.ZIBBY_ENV==="local"?"http://localhost:3001":"https://api-prod.zibby.app")).replace(/\/+$/,"")}var w={name:"trigger_agent",description:"Trigger another Zibby workflow/agent run in THIS project (fire-and-forget). Call it once per run you want to start \u2014 the agent decides which and how many. Omit workflowType to re-run THIS same agent (self-dispatch, e.g. with a different trigger input). Returns the started run's executionId; does NOT wait for it to finish.",input_schema:{type:"object",properties:{workflowType:{type:"string",description:"Which workflow to trigger (its type/slug in this project). Omit to trigger THIS same agent (self-dispatch)."},input:{type:"object",description:"The trigger payload passed to the target workflow (validated against its state schema)."}},required:[]}},v={id:"trigger-agent",callsBackend:!0,serverName:"trigger",allowedTools:["mcp__trigger__*"],envKeys:[],description:"Trigger another Zibby workflow/agent run in this project (agent-driven, fire-and-forget; cloud + self-hosted).",promptFragment:"## Trigger another agent (agent-driven)\nYou can start another Zibby agent run yourself with the `trigger_agent`\ntool \u2014 and YOU decide when and how many times to call it. Each call starts ONE\nindependent run (fire-and-forget) and returns its executionId; it does NOT wait for\nthat run to finish.\n- To re-run THIS same agent (self-dispatch) \u2014 e.g. to hand an item to another of\n this agent's scenarios \u2014 OMIT `workflowType` and pass the `input` for that run.\n- To trigger a DIFFERENT agent in the project, pass its `workflowType` + `input`.\nCall it once per run you want to start (loop over your items and call it for each).\nIt never throws \u2014 a failure comes back as { ok:false, error }; log it and move on.",resolve(){let e=b();if(!e)return{command:null,args:[],env:{},description:this.description};let t={};for(let r of["PROJECT_API_TOKEN","PROJECT_ID","WORKFLOW_TYPE","PROGRESS_API_URL","ZIBBY_ACCOUNT_API_URL","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_USER_TOKEN"])process.env[r]&&(t[r]=process.env[r]);return{type:"stdio",command:"node",args:[e,"../dist/triggerAgent.js","triggerAgentSkill"],env:t,description:this.description,alwaysLoad:!1}},async handleToolCall(e,t={}){if(e!=="trigger_agent")return JSON.stringify({ok:!1,error:`unknown tool: ${e}`});try{let r=process.env.PROJECT_ID,n=y(),i=typeof t.workflowType=="string"&&t.workflowType.trim()?t.workflowType.trim():(process.env.WORKFLOW_TYPE||"").trim();if(!r)return JSON.stringify({ok:!1,error:"PROJECT_ID not set \u2014 cannot resolve the target project."});if(!n)return JSON.stringify({ok:!1,error:"PROJECT_API_TOKEN not set \u2014 cannot authenticate the trigger."});if(!i)return JSON.stringify({ok:!1,error:"No workflowType given and WORKFLOW_TYPE is unset \u2014 nothing to trigger."});let s=`${S()}/projects/${encodeURIComponent(r)}/workflows/${encodeURIComponent(i)}/trigger`,a=await g(s,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${n}`},body:JSON.stringify({input:t.input&&typeof t.input=="object"?t.input:{}})},{kind:"api",what:`trigger agent ${i}`}),c=await a.text().catch(()=>""),o;try{o=c?JSON.parse(c):{}}catch{o={raw:c}}if(!a.ok)return JSON.stringify({ok:!1,error:`trigger failed (HTTP ${a.status})`,detail:o&&(o.error||o.message)||c.slice(0,300)});let l=o.executionId||o.execution?.id||o.id||null;return JSON.stringify({ok:!0,workflowType:i,executionId:l,note:"run started (fire-and-forget)"})}catch(r){return JSON.stringify({ok:!1,error:`trigger_agent failed: ${r?.message||String(r)}`})}},tools:[w]};export{v as triggerAgentSkill};
|
package/dist/vikunja.d.ts
CHANGED
|
@@ -43,8 +43,15 @@
|
|
|
43
43
|
*/
|
|
44
44
|
/** For tests: forget the memoized credentials. */
|
|
45
45
|
export declare function clearVikunjaCredsCache(): void;
|
|
46
|
-
/**
|
|
46
|
+
/**
|
|
47
|
+
* Vikunja stores descriptions and comments as Tiptap HTML. Both directions go
|
|
48
|
+
* through ONE grammar (`lib/markup.ts`): Markdown the model writes → HTML the
|
|
49
|
+
* board renders; HTML the board holds → Markdown the model reads. Same module
|
|
50
|
+
* the Jira skill uses, so a body reads the same off either tracker.
|
|
51
|
+
*/
|
|
47
52
|
export declare function vkPlainText(html: any): string;
|
|
53
|
+
/** Markdown → the HTML Vikunja's editor renders. */
|
|
54
|
+
export declare function vkRichHtml(markdown: any): string;
|
|
48
55
|
/** Vikunja priority is 0-5; accept the words a human (or a model) would use. */
|
|
49
56
|
export declare function vkPriority(p: any): number | null;
|
|
50
57
|
export declare const vikunjaSkill: any;
|