@zibby/skills 0.1.49 → 0.1.50
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/bin/mcp-sentry.mjs +59 -2
- package/dist/index.js +68 -66
- package/dist/package.json +1 -1
- package/dist/sentry.d.ts +39 -0
- package/dist/sentry.js +4 -2
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{registerSkill as I}from"@zibby/agent-workflow";import{createRequire as as}from"module";import{join as cs}from"path";var ls=as(import.meta.url);function ds(){if(process.env.MCP_BROWSER_PATH)return process.env.MCP_BROWSER_PATH;try{return ls.resolve("@zibby/mcp-browser/dist/bin/mcp-browser-zibby.js")}catch{return null}}var ps="1280x720",us="1280x720";function ms({headless:s}={}){if(s===!0)return!0;if(s===!1)return!1;let t=process.env.ZIBBY_HEADLESS;return t==="1"||String(t).toLowerCase()==="true"}function fs(s,t){let e=(s||[]).filter(r=>r!=="--headless");return t?[...e,"--headless"]:e}var
|
|
1
|
+
import{registerSkill as I}from"@zibby/agent-workflow";import{createRequire as as}from"module";import{join as cs}from"path";var ls=as(import.meta.url);function ds(){if(process.env.MCP_BROWSER_PATH)return process.env.MCP_BROWSER_PATH;try{return ls.resolve("@zibby/mcp-browser/dist/bin/mcp-browser-zibby.js")}catch{return null}}var ps="1280x720",us="1280x720";function ms({headless:s}={}){if(s===!0)return!0;if(s===!1)return!1;let t=process.env.ZIBBY_HEADLESS;return t==="1"||String(t).toLowerCase()==="true"}function fs(s,t){let e=(s||[]).filter(r=>r!=="--headless");return t?[...e,"--headless"]:e}var _t={id:"browser",serverName:"playwright",cursorKey:"playwright-official",allowedTools:["mcp__playwright__*"],sessionEnvKey:"ZIBBY_SESSION_INFO",description:"Playwright Browser MCP Server",envKeys:[],tools:[],promptFragment:`Execute this test using the browser tools available to you. You MUST make actual browser tool calls \u2014 do not fabricate results.
|
|
2
2
|
If you DO NOT have access to browser tools \u2192 return {"success": false, "steps": [], "browserClosed": false, "notes": "No browser tools available"}.
|
|
3
3
|
DO NOT return success: true unless you ACTUALLY called browser tools.`,resolve({sessionPath:s,workspace:t,nodeName:e,headless:r}={}){let i=ds(),n=s&&e?cs(s,e):null,o=n||s||t||"test-results",a=ms({headless:r}),c={};if(n&&(c.ZIBBY_NODE_SESSION_PATH=n),s&&(c.ZIBBY_SESSION_PATH=s),!i)throw new Error(`@zibby/mcp-browser is not installed.
|
|
4
4
|
Cloud: verify the Fargate image has it (packages/Dockerfile installs it globally alongside @zibby/cli).
|
|
@@ -21,7 +21,7 @@ ${"#".repeat(n)} ${i.trim()}
|
|
|
21
21
|
${i}
|
|
22
22
|
`):e.push(i)}return e.join("").replace(/\n{3,}/g,`
|
|
23
23
|
|
|
24
|
-
`)}function oe(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function
|
|
24
|
+
`)}function oe(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function Ge(s){return oe(s).replace(/[a-z0-9]+/g,"")}function Ne(s,t){let e=oe(s),r=oe(t);if(!e||!r)return 0;if(e===r)return 1;if(e.length===1||r.length===1)return e===r?1:0;let i=l=>{let p=new Map;for(let u=0;u<l.length-1;u++){let m=l.slice(u,u+2);p.set(m,(p.get(m)||0)+1)}return p},n=i(e),o=i(r),a=0,c=0,d=0;for(let l of n.values())c+=l;for(let l of o.values())d+=l;for(let[l,p]of n.entries()){let u=o.get(l)||0;a+=Math.min(p,u)}return 2*a/Math.max(1,c+d)}function Z(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function vs(s,t=[]){let e=Array.isArray(t)?t:[];if(e.length===0)return{requested:s||null,resolved:null,strategy:"none"};let r=e.filter(a=>!a.subtask),i=r.length>0?r:e,n=Z(s);if(n){let a=i.find(l=>Z(l.name)===n);if(a)return{requested:s,resolved:a,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 l of Object.values(c)){if(!l.some(u=>Z(u)===n))continue;let p=i.find(u=>l.some(m=>Z(m)===Z(u.name)));if(p)return{requested:s,resolved:p,strategy:"alias"}}let d=i.map(l=>({t:l,score:Ne(s,l.name)})).sort((l,p)=>p.score-l.score);if(d[0]&&d[0].score>=.5)return{requested:s,resolved:d[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=i.find(d=>Z(d.name)===a);if(c)return{requested:s||null,resolved:c,strategy:"default-preferred"}}return{requested:s||null,resolved:i[0],strategy:"default-first"}}async function bt(s){let t=`projectKeys=${encodeURIComponent(s)}&expand=projects.issuetypes`,e=await T(`/rest/api/3/issue/createmeta?${t}`),r=Array.isArray(e?.projects)?e.projects:[],n=r.find(a=>String(a?.key||"").toUpperCase()===String(s||"").toUpperCase())||r[0]||null;return(Array.isArray(n?.issuetypes)?n.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function kt(s,t){if(!s)throw new Error("projectKey is required");let e="sprint is not EMPTY";t==="active"?e="sprint in openSprints()":t==="closed"?e="sprint in closedSprints()":t==="future"&&(e="sprint in futureSprints()");let r=`project = ${s} AND ${e} ORDER BY updated DESC`,i=`jql=${encodeURIComponent(r)}&maxResults=100&fields=customfield_10020`,n=await T(`/rest/api/3/search/jql?${i}`),o=new Map;for(let a of n.issues||[])for(let c of a.fields?.customfield_10020||[])c&&!o.has(c.id)&&o.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[...o.values()].sort((a,c)=>{let d={active:0,future:1,closed:2},l=(d[a.state]??3)-(d[c.state]??3);return l!==0?l:String(c.startDate||"").localeCompare(String(a.startDate||""))})}function Ns(s,{sprintId:t,sprintName:e,target:r}={}){let i=Array.isArray(s)?s:[];if(!i.length)return{sprint:null,selectedBy:"none"};if(t!=null&&String(t).trim()!=="")return{sprint:i.find(a=>String(a.id)===String(t))||null,selectedBy:"id"};if(e&&String(e).trim()){let o=String(e).trim(),a=i.find(d=>String(d.name||"").toLowerCase()===o.toLowerCase());if(a)return{sprint:a,selectedBy:"name-exact"};let c=i.map(d=>({s:d,score:Ne(o,d.name||"")})).sort((d,l)=>l.score-d.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let n=String(r||"current").trim().toLowerCase();return n==="active"||n==="current"||n==="latest"?{sprint:i[0],selectedBy:n}:{sprint:i[0],selectedBy:"default"}}function Is(s,t){let e=s?.fields?.customfield_10020;return Array.isArray(e)?e.some(r=>String(r?.id)===String(t)):!1}async function Os({issueKey:s,projectKey:t,sprintId:e,attempts:r=3,delayMs:i=450}){let n=[];for(let o=0;o<r;o++){try{let a=`project = ${t} AND key = ${s} AND sprint = ${e}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,d=await T(`/rest/api/3/search/jql?${c}`);if(Number(d?.total||0)>0)return n.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:n};let p=await T(`/rest/api/3/issue/${s}?fields=customfield_10020,status`),u=Is(p,e);if(n.push({attempt:o+1,jql:!1,issueField:u}),u)return{ok:!0,method:"issue_field",traces:n}}catch(a){n.push({attempt:o+1,error:String(a?.message||a)})}o<r-1&&await new Promise(a=>setTimeout(a,i))}return{ok:!1,method:"none",traces:n}}async function Fe({issueKey:s,projectKey:t,sprintId:e,sprintName:r,target:i}){if(!s)return{ok:!1,error:"issueKey is required"};let n=t;if(!n&&(n=(await T(`/rest/api/3/issue/${s}?fields=project`))?.fields?.project?.key||null,!n))return{ok:!1,error:`Could not resolve project for ${s}`};let o=await kt(n,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${n}`};let{sprint:a,selectedBy:c}=Ns(o,{sprintId:e,sprintName:r,target:i});if(!a)return{ok:!1,error:`No matching sprint found in ${n}`,requested:{sprintId:e??null,sprintName:r??null,target:i??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await T(`/rest/api/3/issue/${s}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let d=await Os({issueKey:s,projectKey:n,sprintId:a.id}),l=d.ok;return{ok:l,issueKey:s,projectKey:n,sprintId:a.id,sprintName:a.name,selectedBy:c,verifiedBy:d.method,verified:l,verificationTrace:d.traces,warning:l?null:`Sprint assignment attempted but verification did not find ${s} in sprint ${a.id}`}}async function T(s,t={}){let e=async()=>{let{token:r,cloudId:i}=await gs("jira");if(typeof r!="string"||!r)throw new Error(`Invalid jira token type: ${typeof r}`);if(!i)throw new Error("Invalid jira cloudId: missing");let n=`https://api.atlassian.com/ex/jira/${i}${s}`,o=await fetch(n,{method:t.method||"GET",headers:{Authorization:`Bearer ${r}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`Jira API ${o.status}: ${c.slice(0,300)}`)}let a=await o.text().catch(()=>"");if(!a||!a.trim())return{};try{return JSON.parse(a)}catch{return{raw:a}}};try{return await e()}catch(r){let i=String(r?.message||r||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("403")||i.includes("substring")))throw r;return _s("jira"),e()}}var wt={id:"jira",serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:N.JIRA,envKeys:["ATLASSIAN_ACCESS_TOKEN","ATLASSIAN_CLOUD_ID"],description:"Zibby Jira MCP Server (OAuth Bearer)",promptFragment:`## Jira (connected)
|
|
25
25
|
You have direct access to the user's Jira. Use these tools proactively:
|
|
26
26
|
|
|
27
27
|
### Issue tools
|
|
@@ -71,7 +71,7 @@ When user asks to move/transition ticket status:
|
|
|
71
71
|
3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
|
|
72
72
|
4. Call jira_get_issue(issueKey) to verify final status before claiming success.
|
|
73
73
|
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.
|
|
74
|
-
6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=ks();if(!s)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL),{command:"node",args:[s],env:t,description:this.description}},async handleToolCall(s,t){try{switch(s){case"jira_list_projects":{let e=await T("/rest/api/3/project"),r=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:r.length,projects:r})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let n=await T(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],a=new Map;for(let d of o)for(let l of d.statuses||[])l?.id&&(a.has(l.id)||a.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let c=[...a.values()].sort((d,l)=>String(d.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let r=await T("/rest/api/3/status"),i=(Array.isArray(r)?r:[]).map(n=>({id:n.id,name:n.name,category:n.statusCategory?.name||null})).sort((n,o)=>String(n.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let r=await _t(e);return JSON.stringify({projectKey:e,count:r.length,issueTypes:r})}case"jira_search":{let e=t.jql||"",r=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${r}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await T(`/rest/api/3/search/jql?${n}`)).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:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let r=await T(`/rest/api/3/issue/${e}`);return JSON.stringify({key:r.key,project:r.fields?.project?.key,summary:r.fields?.summary,description:r.fields?.description,status:r.fields?.status?.name,assignee:r.fields?.assignee?.displayName||"Unassigned",priority:r.fields?.priority?.name,type:r.fields?.issuetype?.name,labels:r.fields?.labels,created:r.fields?.created,updated:r.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:r,issueType:i,description:n,priority:o,labels:a,assigneeId:c,moveToSprint:d,moveToActiveSprint:l,sprintId:p,sprintName:u,target:m}=t;if(!e||!r)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await _t(e),f=vs(i,h)}catch{}let _={project:{key:e},summary:r,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};n&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(_.priority={name:o}),a?.length&&(_.labels=a),c&&(_.assignee={id:c});let g=await T("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&Z(f.requested)!==Z(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),h.length>0&&(b.availableIssueTypes=h.map(y=>y.name)),(d||l)&&(b.sprintMove=await Ge({issueKey:g.key,projectKey:e,sprintId:p,sprintName:u,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:r}=t,i=await bt(e,r);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},a=await Ge({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},a=await Ge({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:r,projectKey:i,status:n,maxResults:o}=t;if(!e&&!r)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=r?`sprint = ${r}`:`sprint = "${e}"`,d=i?`project = ${i} AND `:"",l=n?` AND status = "${n}"`:"",p=`${d}${c}${l} ORDER BY status ASC, priority DESC`,u=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,m=await T(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),h={};for(let _ of f)h[_.status]=(h[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:r}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await T(`/rest/api/3/issue/${e}/comment?maxResults=${r||50}&orderBy=-created`),o=(n.comments||[]).map(a=>{let c="";return a.body?.content&&(c=ve(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:r}=t;return!e||!r?JSON.stringify({error:"issueKey and body are required"}):(await T(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:r}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:r}=t;return!e||!r?JSON.stringify({error:"issueKey and fields are required"}):(await T(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:r}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:r,toStatus:i,statusName:n,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(i||n||o||"").trim();if(!r&&!a){let p=((await T(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(u=>({id:u.id,name:u.name,to:u.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=r;if(!c){let p=(await T(`/rest/api/3/issue/${e}/transitions`)).transitions||[],u=oe(a),m=p.find(f=>oe(f?.name||"")===u||oe(f?.to?.name||"")===u);if(!m){let f=Ke(a);f.length>=2&&(m=p.find(h=>{let _=Ke(h?.name||""),g=Ke(h?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),y=g.length>=2&&(g.includes(f)||f.includes(g));return b||y}))}if(!m){let f=p.map(b=>{let y=Ne(a,b?.name||""),S=Ne(a,b?.to?.name||"");return{t:b,score:Math.max(y,S)}}).sort((b,y)=>y.score-b.score),h=f[0],_=f[1];h&&h.score>=.45&&(!_||h.score-_.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await T(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let d=await T(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:d?.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"]}}]};import{existsSync as Os}from"fs";import{fileURLToPath as As}from"url";import{dirname as js,resolve as Ts}from"path";import{resolveIntegrationToken as wt}from"@zibby/core/backend-client.js";function $s(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=js(As(import.meta.url)),t=Ts(s,"..","bin","mcp-skill.mjs");return Os(t)?t:null}async function v(s,t={}){let{token:e}=await wt("github"),r=s.startsWith("https://")?s:`https://api.github.com${s}`,i={Authorization:`Bearer ${e}`,Accept:t.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`GitHub API ${n.status}: ${o.slice(0,300)}`)}return t.raw?n.text():n.json()}var ae={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:N.GITHUB,envKeys:["GITHUB_TOKEN"],description:"GitHub \u2014 issues, PRs, commits, code search, file reading",promptFragment:`## GitHub (connected)
|
|
74
|
+
6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=ks();if(!s)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL),{command:"node",args:[s],env:t,description:this.description}},async handleToolCall(s,t){try{switch(s){case"jira_list_projects":{let e=await T("/rest/api/3/project"),r=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:r.length,projects:r})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let n=await T(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],a=new Map;for(let d of o)for(let l of d.statuses||[])l?.id&&(a.has(l.id)||a.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let c=[...a.values()].sort((d,l)=>String(d.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let r=await T("/rest/api/3/status"),i=(Array.isArray(r)?r:[]).map(n=>({id:n.id,name:n.name,category:n.statusCategory?.name||null})).sort((n,o)=>String(n.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let r=await bt(e);return JSON.stringify({projectKey:e,count:r.length,issueTypes:r})}case"jira_search":{let e=t.jql||"",r=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${r}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await T(`/rest/api/3/search/jql?${n}`)).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:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let r=await T(`/rest/api/3/issue/${e}`);return JSON.stringify({key:r.key,project:r.fields?.project?.key,summary:r.fields?.summary,description:r.fields?.description,status:r.fields?.status?.name,assignee:r.fields?.assignee?.displayName||"Unassigned",priority:r.fields?.priority?.name,type:r.fields?.issuetype?.name,labels:r.fields?.labels,created:r.fields?.created,updated:r.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:r,issueType:i,description:n,priority:o,labels:a,assigneeId:c,moveToSprint:d,moveToActiveSprint:l,sprintId:p,sprintName:u,target:m}=t;if(!e||!r)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await bt(e),f=vs(i,h)}catch{}let _={project:{key:e},summary:r,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};n&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(_.priority={name:o}),a?.length&&(_.labels=a),c&&(_.assignee={id:c});let g=await T("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&Z(f.requested)!==Z(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),h.length>0&&(b.availableIssueTypes=h.map(y=>y.name)),(d||l)&&(b.sprintMove=await Fe({issueKey:g.key,projectKey:e,sprintId:p,sprintName:u,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:r}=t,i=await kt(e,r);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},a=await Fe({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},a=await Fe({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:r,projectKey:i,status:n,maxResults:o}=t;if(!e&&!r)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=r?`sprint = ${r}`:`sprint = "${e}"`,d=i?`project = ${i} AND `:"",l=n?` AND status = "${n}"`:"",p=`${d}${c}${l} ORDER BY status ASC, priority DESC`,u=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,m=await T(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),h={};for(let _ of f)h[_.status]=(h[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:r}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await T(`/rest/api/3/issue/${e}/comment?maxResults=${r||50}&orderBy=-created`),o=(n.comments||[]).map(a=>{let c="";return a.body?.content&&(c=ve(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:r}=t;return!e||!r?JSON.stringify({error:"issueKey and body are required"}):(await T(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:r}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:r}=t;return!e||!r?JSON.stringify({error:"issueKey and fields are required"}):(await T(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:r}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:r,toStatus:i,statusName:n,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(i||n||o||"").trim();if(!r&&!a){let p=((await T(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(u=>({id:u.id,name:u.name,to:u.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=r;if(!c){let p=(await T(`/rest/api/3/issue/${e}/transitions`)).transitions||[],u=oe(a),m=p.find(f=>oe(f?.name||"")===u||oe(f?.to?.name||"")===u);if(!m){let f=Ge(a);f.length>=2&&(m=p.find(h=>{let _=Ge(h?.name||""),g=Ge(h?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),y=g.length>=2&&(g.includes(f)||f.includes(g));return b||y}))}if(!m){let f=p.map(b=>{let y=Ne(a,b?.name||""),S=Ne(a,b?.to?.name||"");return{t:b,score:Math.max(y,S)}}).sort((b,y)=>y.score-b.score),h=f[0],_=f[1];h&&h.score>=.45&&(!_||h.score-_.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await T(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let d=await T(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:d?.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"]}}]};import{existsSync as Rs}from"fs";import{fileURLToPath as As}from"url";import{dirname as js,resolve as Ts}from"path";import{resolveIntegrationToken as St}from"@zibby/core/backend-client.js";function $s(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=js(As(import.meta.url)),t=Ts(s,"..","bin","mcp-skill.mjs");return Rs(t)?t:null}async function v(s,t={}){let{token:e}=await St("github"),r=s.startsWith("https://")?s:`https://api.github.com${s}`,i={Authorization:`Bearer ${e}`,Accept:t.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`GitHub API ${n.status}: ${o.slice(0,300)}`)}return t.raw?n.text():n.json()}var ae={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:N.GITHUB,envKeys:["GITHUB_TOKEN"],description:"GitHub \u2014 issues, PRs, commits, code search, file reading",promptFragment:`## GitHub (connected)
|
|
75
75
|
You have access to the user's GitHub repositories. Available tools:
|
|
76
76
|
|
|
77
77
|
### Discovery
|
|
@@ -114,9 +114,9 @@ When user says "check out repo-name" or "clone repo-name":
|
|
|
114
114
|
3. STOP. Do not offer to inspect files or ask what to do next.
|
|
115
115
|
|
|
116
116
|
When user just wants to "look at" or "read" files (not clone):
|
|
117
|
-
- Use github_get_file to read individual files via API`,resolve(){let s=$s();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/github.js","githubSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=await v(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(r.items||[]).map(n=>({number:n.number,title:n.title,state:n.state,repo:n.repository_url?.split("/").slice(-2).join("/"),url:n.html_url,user:n.user?.login,isPR:!!n.pull_request,labels:(n.labels||[]).map(o=>o.name),createdAt:n.created_at}));return JSON.stringify({total:r.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",n=await v(`/search/code?q=${encodeURIComponent(e)}${r}${i}&per_page=${t.limit||15}`),o=(n.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:n.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}`);return JSON.stringify({number:n.number,title:n.title,state:n.state,merged:n.merged,body:n.body?.slice(0,5e3),user:n.user?.login,branch:n.head?.ref,headSha:n.head?.sha,base:n.base?.ref,changedFiles:n.changed_files,additions:n.additions,deletions:n.deletions,createdAt:n.created_at,mergedAt:n.merged_at,url:n.html_url,labels:(n.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=n.length>15e3;return JSON.stringify({number:i,diff:o?n.slice(0,15e3):n,truncated:o,totalLength:n.length})}case"github_list_pr_files":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:n.length,files:n.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}/comments?per_page=50`),o=await v(`/repos/${e}/${r}/issues/${i}/comments?per_page=50`),a=[...n.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,d)=>new Date(c.createdAt)-new Date(d.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_get_review_thread":{let{owner:e,repo:r,number:i,commentId:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await v(`/repos/${e}/${r}/pulls/comments/${n}`),a=o.in_reply_to_id||o.id,c=[];try{c=await v(`/repos/${e}/${r}/pulls/${i}/comments?per_page=100`)}catch{c=[o]}(!Array.isArray(c)||c.length===0)&&(c=[o]);let d=c.filter(u=>u.id===a||u.in_reply_to_id===a).sort((u,m)=>new Date(u.created_at)-new Date(m.created_at)),l=d.length?d:[o],p=l.find(u=>u.id===a)||l[0];return JSON.stringify({rootCommentId:a,path:p.path,line:p.line??p.original_line??null,side:p.side||"RIGHT",diffHunk:typeof p.diff_hunk=="string"?p.diff_hunk.slice(0,3e3):null,commitId:p.commit_id||p.original_commit_id||null,notes:l.map(u=>({id:u.id,user:u.user?.login,body:(u.body||"").slice(0,4e3),createdAt:u.created_at,isRoot:u.id===a,url:u.html_url}))})}case"github_reply_review_thread":{let{owner:e,repo:r,number:i,commentId:n,body:o}=t||{};if(!e||!r||!i||!n||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await v(`/repos/${e}/${r}/pulls/${i}/comments/${n}/replies`,{method:"POST",body:{body:String(o)}});return JSON.stringify({ok:!0,id:a.id,url:a.html_url,inReplyTo:a.in_reply_to_id})}case"github_reply_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:String(n)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:e,repo:r,number:i,body:n,event:o,comments:a}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(c))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let d=Array.isArray(a)?a.filter(u=>u&&u.path&&u.body&&(u.line!=null||u.position!=null)).map(u=>{let m={path:u.path,body:String(u.body)};return u.line!=null?(m.line=Number(u.line),m.side=u.side==="LEFT"?"LEFT":"RIGHT"):m.position=Number(u.position),m}):[];if(c!=="APPROVE"&&!n&&d.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l={event:c};n&&(l.body=String(n)),d.length>0&&(l.comments=d);let p=await v(`/repos/${e}/${r}/pulls/${i}/reviews`,{method:"POST",body:l});return JSON.stringify({ok:!0,id:p.id,state:p.state,event:c,commentsPosted:d.length,url:p.html_url})}case"github_list_commits":{let{owner:e,repo:r,branch:i,path:n,limit:o}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let a=`/repos/${e}/${r}/commits?per_page=${o||20}`;i&&(a+=`&sha=${encodeURIComponent(i)}`),n&&(a+=`&path=${encodeURIComponent(n)}`);let c=await v(a);return JSON.stringify({total:c.length,commits:c.map(d=>({sha:d.sha?.slice(0,8),fullSha:d.sha,message:d.commit?.message?.slice(0,300),author:d.commit?.author?.name,date:d.commit?.author?.date,url:d.html_url}))})}case"github_get_commit":{let{owner:e,repo:r,sha:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let n=await v(`/repos/${e}/${r}/commits/${i}`);return JSON.stringify({sha:n.sha?.slice(0,8),message:n.commit?.message,author:n.commit?.author?.name,date:n.commit?.author?.date,stats:n.stats,files:(n.files||[]).map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_get_file":{let{owner:e,repo:r,path:i,ref:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${r}/contents/${encodeURIComponent(i)}`;n&&(o+=`?ref=${encodeURIComponent(n)}`);let a=await v(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:i,entries:a.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),d=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:d?c.slice(0,2e4):c,truncated:d})}case"github_get_user":try{let e=await v("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let r=e.repositories[0],i=r.owner.login,n=r.owner.type,o=n==="Organization"?`/orgs/${i}`:`/users/${i}`,a=await v(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:n,isOrg:n==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let r=(await v("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of r)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let n=Array.from(i.values());return JSON.stringify({count:n.length,orgs:n,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(g){let b=g.replace(/^~(?=$|\/|\\)/,m);return a(b)},{owner:e,repo:r,destination:i}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let{execSync:n}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:d}=await import("fs"),{homedir:l,platform:p}=await import("os"),{token:u}=await
|
|
117
|
+
- Use github_get_file to read individual files via API`,resolve(){let s=$s();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/github.js","githubSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=await v(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(r.items||[]).map(n=>({number:n.number,title:n.title,state:n.state,repo:n.repository_url?.split("/").slice(-2).join("/"),url:n.html_url,user:n.user?.login,isPR:!!n.pull_request,labels:(n.labels||[]).map(o=>o.name),createdAt:n.created_at}));return JSON.stringify({total:r.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",n=await v(`/search/code?q=${encodeURIComponent(e)}${r}${i}&per_page=${t.limit||15}`),o=(n.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:n.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}`);return JSON.stringify({number:n.number,title:n.title,state:n.state,merged:n.merged,body:n.body?.slice(0,5e3),user:n.user?.login,branch:n.head?.ref,headSha:n.head?.sha,base:n.base?.ref,changedFiles:n.changed_files,additions:n.additions,deletions:n.deletions,createdAt:n.created_at,mergedAt:n.merged_at,url:n.html_url,labels:(n.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=n.length>15e3;return JSON.stringify({number:i,diff:o?n.slice(0,15e3):n,truncated:o,totalLength:n.length})}case"github_list_pr_files":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:n.length,files:n.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/pulls/${i}/comments?per_page=50`),o=await v(`/repos/${e}/${r}/issues/${i}/comments?per_page=50`),a=[...n.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,d)=>new Date(c.createdAt)-new Date(d.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_get_review_thread":{let{owner:e,repo:r,number:i,commentId:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await v(`/repos/${e}/${r}/pulls/comments/${n}`),a=o.in_reply_to_id||o.id,c=[];try{c=await v(`/repos/${e}/${r}/pulls/${i}/comments?per_page=100`)}catch{c=[o]}(!Array.isArray(c)||c.length===0)&&(c=[o]);let d=c.filter(u=>u.id===a||u.in_reply_to_id===a).sort((u,m)=>new Date(u.created_at)-new Date(m.created_at)),l=d.length?d:[o],p=l.find(u=>u.id===a)||l[0];return JSON.stringify({rootCommentId:a,path:p.path,line:p.line??p.original_line??null,side:p.side||"RIGHT",diffHunk:typeof p.diff_hunk=="string"?p.diff_hunk.slice(0,3e3):null,commitId:p.commit_id||p.original_commit_id||null,notes:l.map(u=>({id:u.id,user:u.user?.login,body:(u.body||"").slice(0,4e3),createdAt:u.created_at,isRoot:u.id===a,url:u.html_url}))})}case"github_reply_review_thread":{let{owner:e,repo:r,number:i,commentId:n,body:o}=t||{};if(!e||!r||!i||!n||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await v(`/repos/${e}/${r}/pulls/${i}/comments/${n}/replies`,{method:"POST",body:{body:String(o)}});return JSON.stringify({ok:!0,id:a.id,url:a.html_url,inReplyTo:a.in_reply_to_id})}case"github_reply_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:String(n)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:e,repo:r,number:i,body:n,event:o,comments:a}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(c))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let d=Array.isArray(a)?a.filter(u=>u&&u.path&&u.body&&(u.line!=null||u.position!=null)).map(u=>{let m={path:u.path,body:String(u.body)};return u.line!=null?(m.line=Number(u.line),m.side=u.side==="LEFT"?"LEFT":"RIGHT"):m.position=Number(u.position),m}):[];if(c!=="APPROVE"&&!n&&d.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l={event:c};n&&(l.body=String(n)),d.length>0&&(l.comments=d);let p=await v(`/repos/${e}/${r}/pulls/${i}/reviews`,{method:"POST",body:l});return JSON.stringify({ok:!0,id:p.id,state:p.state,event:c,commentsPosted:d.length,url:p.html_url})}case"github_list_commits":{let{owner:e,repo:r,branch:i,path:n,limit:o}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let a=`/repos/${e}/${r}/commits?per_page=${o||20}`;i&&(a+=`&sha=${encodeURIComponent(i)}`),n&&(a+=`&path=${encodeURIComponent(n)}`);let c=await v(a);return JSON.stringify({total:c.length,commits:c.map(d=>({sha:d.sha?.slice(0,8),fullSha:d.sha,message:d.commit?.message?.slice(0,300),author:d.commit?.author?.name,date:d.commit?.author?.date,url:d.html_url}))})}case"github_get_commit":{let{owner:e,repo:r,sha:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let n=await v(`/repos/${e}/${r}/commits/${i}`);return JSON.stringify({sha:n.sha?.slice(0,8),message:n.commit?.message,author:n.commit?.author?.name,date:n.commit?.author?.date,stats:n.stats,files:(n.files||[]).map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_get_file":{let{owner:e,repo:r,path:i,ref:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${r}/contents/${encodeURIComponent(i)}`;n&&(o+=`?ref=${encodeURIComponent(n)}`);let a=await v(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:i,entries:a.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),d=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:d?c.slice(0,2e4):c,truncated:d})}case"github_get_user":try{let e=await v("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let r=e.repositories[0],i=r.owner.login,n=r.owner.type,o=n==="Organization"?`/orgs/${i}`:`/users/${i}`,a=await v(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:n,isOrg:n==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let r=(await v("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of r)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let n=Array.from(i.values());return JSON.stringify({count:n.length,orgs:n,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(g){let b=g.replace(/^~(?=$|\/|\\)/,m);return a(b)},{owner:e,repo:r,destination:i}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let{execSync:n}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:d}=await import("fs"),{homedir:l,platform:p}=await import("os"),{token:u}=await St("github"),m=l(),h=i?f(i):o(m,"zibby-repos"),_=o(h,r);if(d(h,{recursive:!0}),c(_))return JSON.stringify({error:`Directory ${_} already exists. Remove it first or use a different destination.`,existingPath:_});try{let g=`https://x-access-token:${u}@github.com/${e}/${r}.git`;n(`git clone ${g} "${_}"`,{stdio:"pipe"});let b=p()==="win32",y;return b?y=n(`dir "${_}"`,{encoding:"utf-8",shell:"cmd.exe"}):y=n(`ls -la "${_}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:_,message:`Cloned ${e}/${r} to ${_}`,contents:y.split(`
|
|
118
118
|
`).slice(0,30).join(`
|
|
119
|
-
`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(g){return JSON.stringify({error:`Clone failed: ${g.message}`})}}case"github_search_repos":{let{query:e,limit:r}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),n=JSON.parse(i);if(n.error)return JSON.stringify(n);let o=e.toLowerCase(),a=n.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,r||20)})}case"github_list_repos":{let{owner:e,type:r,sort:i,direction:n,limit:o,query:a}=t,c=100,d=o||200,l=[],p=y=>({name:y.name,fullName:y.full_name,private:y.private,description:y.description,language:y.language,defaultBranch:y.default_branch,updatedAt:y.updated_at,stars:y.stargazers_count,url:y.html_url,fullPath:y.full_name,webUrl:y.html_url,visibility:y.visibility||(y.private?"private":"public")}),u=y=>{if(!a)return!0;let S=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(S)||y.fullName&&y.fullName.toLowerCase().includes(S)||y.description&&y.description.toLowerCase().includes(S)};if(!e){let y=1,S=!0;for(;S&&l.length<d;){let M=`/installation/repositories?per_page=${c}&page=${y}`,Be=(await v(M)).repositories||[];if(Be.length===0)break;l=l.concat(Be),S=Be.length===c,y++}let j=l.map(p).filter(u),Y=j.slice(0,d),De=j.length>Y.length,A=Y.filter(M=>M.private).length,R=Y.filter(M=>!M.private).length;return JSON.stringify({count:Y.length,repos:Y,truncated:De,privateCount:A,publicCount:R,message:`Found ${A} private and ${R} public repos`})}let m=await v(`/orgs/${e}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&l.length<d;){let y;m?y=`/orgs/${e}/repos?per_page=${c}&page=${f}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`:y=`/users/${e}/repos?per_page=${c}&page=${f}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`;let S=await v(y),j=Array.isArray(S)?S:[];if(j.length===0)break;l=l.concat(j),h=j.length===c,f++}let _=l.map(p).filter(u),g=_.slice(0,d),b=_.length>g.length;return JSON.stringify({count:g.length,repos:g,truncated:b})}case"github_create_pr":{let{owner:e,repo:r,head:i,title:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=t.base;if(!o)try{o=(await v(`/repos/${e}/${r}`)).default_branch||"main"}catch{o="main"}let a={title:String(n),head:String(i),base:String(o),body:t.body?String(t.body):"",draft:!!t.draft};try{let c=await v(`/repos/${e}/${r}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${e}/${r}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let d=String(c.message||c);if(/GitHub API 422/.test(d))return JSON.stringify({success:!1,branch:i,base:o,repo:`${e}/${r}`,provider:"github",skippedReason:d});throw c}}case"github_merge_pr":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=t.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(n))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${n})`});let o={merge_method:n};t.commitTitle&&(o.commit_title=String(t.commitTitle)),t.commitMessage&&(o.commit_message=String(t.commitMessage));try{let a=await v(`/repos/${e}/${r}/pulls/${i}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:i,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:i,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:r,title:i,body:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await v(`/repos/${e}/${r}/issues`,{method:"POST",body:{title:i,body:n||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:r,state:i,labels:n,since:o,assignee:a,sort:c,direction:d,limit:l}=t||{};if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",i||"open"),p.set("per_page",String(l||30)),p.set("sort",c||"updated"),p.set("direction",d||"desc"),n&&p.set("labels",Array.isArray(n)?n.join(","):n),o&&p.set("since",o),a&&p.set("assignee",a);let u=await v(`/repos/${e}/${r}/issues?${p.toString()}`),m=(Array.isArray(u)?u:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(h=>typeof h=="string"?h:h.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(h=>h.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/issues/${i}`);return n.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:n.number,title:n.title,body:n.body||"",state:n.state,stateReason:n.state_reason||null,labels:(n.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:n.assignee?.login||null,assignees:(n.assignees||[]).map(o=>o.login),user:n.user?.login,milestone:n.milestone?.title||null,comments:n.comments,url:n.html_url,createdAt:n.created_at,updatedAt:n.updated_at,closedAt:n.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:r,number:i,limit:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments?per_page=${n||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:n}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:r,number:i,stateReason:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};n&&(o.state_reason=n);let a=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:n.number,state:n.state,url:n.html_url})}case"github_label_issue":{let{owner:e,repo:r,number:i,labels:n,mode:o}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(n)?n:n?[n]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let l=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await v(`/repos/${e}/${r}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await v(`/repos/${e}/${r}/issues/${i}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let d=await v(`/repos/${e}/${r}/issues/${i}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(d)?d:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List recent commits on a branch, optionally filtered by file path",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Max commits (default: 20)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};import{existsSync as Es}from"fs";import{fileURLToPath as Ls}from"url";import{dirname as xs,resolve as Cs}from"path";function Ps(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=xs(Ls(import.meta.url)),t=Cs(s,"..","bin","mcp-skill.mjs");return Es(t)?t:null}function qs(){let s=process.env.GITLAB_API_URL;if(s)return s.replace(/\/+$/,"");let t=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(t)?t:`${t}/api/v4`}function Js(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let s=process.env.GITLAB_TOKEN;if(!s)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":s}}async function $(s,t={}){let e=/^https?:\/\//.test(s)?s:`${qs()}${s}`,r={Accept:"application/json","User-Agent":"Zibby-App",...Js(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:r,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let n=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${n.slice(0,300)}`)}return t.raw?i.text():i.json()}function St(){let s=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(s?s.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function Us(){return process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function L(s){let t=String(s);return/^\d+$/.test(t)?t:encodeURIComponent(t)}var ce={id:"gitlab",serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:N.GITLAB,envKeys:["GITLAB_TOKEN","GITLAB_OAUTH_TOKEN","GITLAB_INSTANCE_URL","GITLAB_API_URL"],description:"GitLab \u2014 merge requests, diffs, MR reviews/discussions, issues",promptFragment:`## GitLab (connected)
|
|
119
|
+
`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(g){return JSON.stringify({error:`Clone failed: ${g.message}`})}}case"github_search_repos":{let{query:e,limit:r}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),n=JSON.parse(i);if(n.error)return JSON.stringify(n);let o=e.toLowerCase(),a=n.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,r||20)})}case"github_list_repos":{let{owner:e,type:r,sort:i,direction:n,limit:o,query:a}=t,c=100,d=o||200,l=[],p=y=>({name:y.name,fullName:y.full_name,private:y.private,description:y.description,language:y.language,defaultBranch:y.default_branch,updatedAt:y.updated_at,stars:y.stargazers_count,url:y.html_url,fullPath:y.full_name,webUrl:y.html_url,visibility:y.visibility||(y.private?"private":"public")}),u=y=>{if(!a)return!0;let S=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(S)||y.fullName&&y.fullName.toLowerCase().includes(S)||y.description&&y.description.toLowerCase().includes(S)};if(!e){let y=1,S=!0;for(;S&&l.length<d;){let M=`/installation/repositories?per_page=${c}&page=${y}`,Ke=(await v(M)).repositories||[];if(Ke.length===0)break;l=l.concat(Ke),S=Ke.length===c,y++}let j=l.map(p).filter(u),Y=j.slice(0,d),Be=j.length>Y.length,A=Y.filter(M=>M.private).length,O=Y.filter(M=>!M.private).length;return JSON.stringify({count:Y.length,repos:Y,truncated:Be,privateCount:A,publicCount:O,message:`Found ${A} private and ${O} public repos`})}let m=await v(`/orgs/${e}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&l.length<d;){let y;m?y=`/orgs/${e}/repos?per_page=${c}&page=${f}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`:y=`/users/${e}/repos?per_page=${c}&page=${f}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`;let S=await v(y),j=Array.isArray(S)?S:[];if(j.length===0)break;l=l.concat(j),h=j.length===c,f++}let _=l.map(p).filter(u),g=_.slice(0,d),b=_.length>g.length;return JSON.stringify({count:g.length,repos:g,truncated:b})}case"github_create_pr":{let{owner:e,repo:r,head:i,title:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=t.base;if(!o)try{o=(await v(`/repos/${e}/${r}`)).default_branch||"main"}catch{o="main"}let a={title:String(n),head:String(i),base:String(o),body:t.body?String(t.body):"",draft:!!t.draft};try{let c=await v(`/repos/${e}/${r}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${e}/${r}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let d=String(c.message||c);if(/GitHub API 422/.test(d))return JSON.stringify({success:!1,branch:i,base:o,repo:`${e}/${r}`,provider:"github",skippedReason:d});throw c}}case"github_merge_pr":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=t.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(n))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${n})`});let o={merge_method:n};t.commitTitle&&(o.commit_title=String(t.commitTitle)),t.commitMessage&&(o.commit_message=String(t.commitMessage));try{let a=await v(`/repos/${e}/${r}/pulls/${i}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:i,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:i,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:r,title:i,body:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await v(`/repos/${e}/${r}/issues`,{method:"POST",body:{title:i,body:n||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:r,state:i,labels:n,since:o,assignee:a,sort:c,direction:d,limit:l}=t||{};if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",i||"open"),p.set("per_page",String(l||30)),p.set("sort",c||"updated"),p.set("direction",d||"desc"),n&&p.set("labels",Array.isArray(n)?n.join(","):n),o&&p.set("since",o),a&&p.set("assignee",a);let u=await v(`/repos/${e}/${r}/issues?${p.toString()}`),m=(Array.isArray(u)?u:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(h=>typeof h=="string"?h:h.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(h=>h.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/issues/${i}`);return n.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:n.number,title:n.title,body:n.body||"",state:n.state,stateReason:n.state_reason||null,labels:(n.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:n.assignee?.login||null,assignees:(n.assignees||[]).map(o=>o.login),user:n.user?.login,milestone:n.milestone?.title||null,comments:n.comments,url:n.html_url,createdAt:n.created_at,updatedAt:n.updated_at,closedAt:n.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:r,number:i,limit:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments?per_page=${n||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:n}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:r,number:i,stateReason:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};n&&(o.state_reason=n);let a=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:n.number,state:n.state,url:n.html_url})}case"github_label_issue":{let{owner:e,repo:r,number:i,labels:n,mode:o}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(n)?n:n?[n]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let l=await v(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await v(`/repos/${e}/${r}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await v(`/repos/${e}/${r}/issues/${i}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let d=await v(`/repos/${e}/${r}/issues/${i}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(d)?d:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List recent commits on a branch, optionally filtered by file path",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Max commits (default: 20)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};import{existsSync as Es}from"fs";import{fileURLToPath as xs}from"url";import{dirname as Ls,resolve as Cs}from"path";function Ps(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=Ls(xs(import.meta.url)),t=Cs(s,"..","bin","mcp-skill.mjs");return Es(t)?t:null}function qs(){let s=process.env.GITLAB_API_URL;if(s)return s.replace(/\/+$/,"");let t=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(t)?t:`${t}/api/v4`}function Js(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let s=process.env.GITLAB_TOKEN;if(!s)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":s}}async function $(s,t={}){let e=/^https?:\/\//.test(s)?s:`${qs()}${s}`,r={Accept:"application/json","User-Agent":"Zibby-App",...Js(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:r,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let n=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${n.slice(0,300)}`)}return t.raw?i.text():i.json()}function vt(){let s=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(s?s.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function Us(){return process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function x(s){let t=String(s);return/^\d+$/.test(t)?t:encodeURIComponent(t)}var ce={id:"gitlab",serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:N.GITLAB,envKeys:["GITLAB_TOKEN","GITLAB_OAUTH_TOKEN","GITLAB_INSTANCE_URL","GITLAB_API_URL"],description:"GitLab \u2014 merge requests, diffs, MR reviews/discussions, issues",promptFragment:`## GitLab (connected)
|
|
120
120
|
You have access to the user's GitLab projects via the REST API (cloud gitlab.com OR self-hosted). A "merge request" (MR) is GitLab's pull request. An MR is addressed by a PROJECT (numeric id OR full path like "group/repo") and an \`iid\` (the per-project MR number shown in the URL). For projects, prefer the full path form ("group/subgroup/repo") \u2014 it's what users have. Available tools:
|
|
121
121
|
|
|
122
122
|
### Discovery
|
|
@@ -142,9 +142,9 @@ You have access to the user's GitLab projects via the REST API (cloud gitlab.com
|
|
|
142
142
|
|
|
143
143
|
### Notes
|
|
144
144
|
- A code-review flow is: gitlab_get_mr (context + diff_refs) \u2192 gitlab_get_mr_changes (the diff) \u2192 gitlab_post_mr_discussion per inline finding \u2192 gitlab_post_mr_note for the summary.
|
|
145
|
-
- If an inline position is rejected by GitLab (bad line anchor), fall back to gitlab_post_mr_note with the file/line in the text.`,resolve(){let s=Ps();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/gitlab.js","gitlabSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"gitlab_clone":{let{projectPath:e,projectId:r,destination:i,branch:n}=t||{},o=e&&String(e).trim();if(!o&&r!=null&&(/^\d+$/.test(String(r))?o=(await $(`/projects/${
|
|
145
|
+
- If an inline position is rejected by GitLab (bad line anchor), fall back to gitlab_post_mr_note with the file/line in the text.`,resolve(){let s=Ps();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/gitlab.js","gitlabSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"gitlab_clone":{let{projectPath:e,projectId:r,destination:i,branch:n}=t||{},o=e&&String(e).trim();if(!o&&r!=null&&(/^\d+$/.test(String(r))?o=(await $(`/projects/${x(r)}`))?.path_with_namespace:o=String(r).trim()),!o)return JSON.stringify({error:'projectPath (e.g. "group/repo") or a numeric projectId is required'});let a=Us();if(!a)return JSON.stringify({error:"GitLab is not connected (no token to authenticate the clone)."});let{execSync:c}=await import("child_process"),{join:d,resolve:l}=await import("path"),{existsSync:p,mkdirSync:u}=await import("fs"),m=i?l(i):l(process.cwd(),".zibby","repos"),f=o.split("/").filter(Boolean).pop(),h=d(m,f);if(u(m,{recursive:!0}),p(h))return JSON.stringify({success:!0,path:h,message:`Already cloned at ${h}`,alreadyCloned:!0});let _=vt().replace(/^https?:\/\//,""),b=`${vt().startsWith("http://")?"http":"https"}://oauth2:${a}@${_}/${o}.git`,y=n?`--branch "${String(n).replace(/"/g,"")}" `:"";try{c(`git clone --depth 1 ${y}${b} "${h}"`,{stdio:"pipe",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}});let S=c(`ls -la "${h}"`,{encoding:"utf-8"});return JSON.stringify({success:!0,path:h,message:`Cloned ${o} to ${h}`,contents:S.split(`
|
|
146
146
|
`).slice(0,30).join(`
|
|
147
|
-
`)})}catch(S){let j=String(S.message||S).split(a).join("***");return JSON.stringify({error:`Clone failed: ${j}`})}}case"gitlab_create_mr":{let e=t?.project??t?.projectId,r=t?.source_branch??t?.sourceBranch,{title:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let n=L(e),o=t?.target_branch??t?.targetBranch;if(!o)try{o=(await $(`/projects/${n}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(r),target_branch:String(o),title:String(i),description:t?.description?String(t.description):""};try{let c=await $(`/projects/${n}/merge_requests`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.web_url,number:c.iid,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",state:c.state})}catch(c){let d=String(c.message||c);if(/GitLab API (409|400)/.test(d))return JSON.stringify({success:!1,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",skippedReason:d});throw c}}case"gitlab_accept_mr":{let e=t?.project??t?.projectId,{iid:r}=t||{};if(!e||!r)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=L(e),n={};t.squash!=null&&(n.squash=!!t.squash),t.mergeCommitMessage&&(n.merge_commit_message=String(t.mergeCommitMessage)),t.mergeWhenPipelineSucceeds!=null&&(n.merge_when_pipeline_succeeds=!!t.mergeWhenPipelineSucceeds);try{let o=await $(`/projects/${i}/merge_requests/${r}/merge`,{method:"PUT",body:n});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??r,project:String(e),provider:"gitlab",state:o.state})}catch(o){let a=String(o.message||o);if(/GitLab API (405|406|404)/.test(a))return JSON.stringify({success:!1,iid:r,project:String(e),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${L(e)}/merge_requests/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${L(e)}/merge_requests/${r}/changes`),n=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:n.length,diffRefs:i.diff_refs||null,files:n.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_mrs":{let{projectId:e,state:r,targetBranch:i,sourceBranch:n,authorUsername:o,labels:a,search:c,sort:d,orderBy:l,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",r||"opened"),u.set("per_page",String(p||20)),u.set("order_by",l||"updated_at"),u.set("sort",d||"desc"),i&&u.set("target_branch",i),n&&u.set("source_branch",n),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await $(`/projects/${L(e)}/merge_requests?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,author:h.author?.username,sourceBranch:h.source_branch,targetBranch:h.target_branch,draft:h.draft??h.work_in_progress??!1,labels:Array.isArray(h.labels)?h.labels:[],webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:r,limit:i}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let n=await $(`/projects/${L(e)}/merge_requests/${r}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(n)?n.length:0,notes:(Array.isArray(n)?n:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await $(`/projects/${L(e)}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:r,path:i,oldPath:n,newLine:o,oldLine:a,body:c}=t||{};if(!e||!r||!i||!c)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&a==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let d=L(e),l=t.diffRefs||null;if(l||(l=(await $(`/projects/${d}/merge_requests/${r}`)).diff_refs||null),!l||!l.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let p={base_sha:l.base_sha,start_sha:l.start_sha,head_sha:l.head_sha,position_type:"text",new_path:i,old_path:n||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await $(`/projects/${d}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(c),position:p}});return JSON.stringify({ok:!0,discussionId:u.id})}catch(u){return JSON.stringify({ok:!1,error:`inline anchor rejected (${u.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:r,body:i,comments:n}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let o=L(e),a=Array.isArray(n)?n.filter(u=>u&&u.path&&u.body&&(u.newLine!=null||u.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=t.diffRefs||null;a.length>0&&!c&&(c=(await $(`/projects/${o}/merge_requests/${r}`)).diff_refs||null);let d=!1;i&&(await $(`/projects/${o}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}}),d=!0);let l=0,p=[];if(a.length>0&&c)for(let u of a){let m={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:u.path,old_path:u.oldPath||u.path};u.newLine!=null&&(m.new_line=Number(u.newLine)),u.oldLine!=null&&(m.old_line=Number(u.oldLine));try{await $(`/projects/${o}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(u.body),position:m}}),l+=1}catch(f){p.push(`${u.path}:${u.newLine??u.oldLine} \u2014 ${f.message}`)}}else a.length>0&&!c&&p.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:d,inlinePosted:l,inlineErrors:p.length?p:void 0})}case"gitlab_get_discussion":{let{projectId:e,iid:r,discussionId:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let n=await $(`/projects/${L(e)}/merge_requests/${r}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(n.notes)?n.notes:[],a=o.find(d=>d.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:n.id,individualNote:!!n.individual_note,path:c&&(c.new_path||c.old_path)||null,newLine:c?c.new_line??null:null,oldLine:c?c.old_line??null:null,diffRefs:c?{base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha}:null,notes:o.map(d=>({id:d.id,author:d.author?.username,body:(d.body||"").slice(0,4e3),system:!!d.system,createdAt:d.created_at}))})}case"gitlab_reply_discussion":{let{projectId:e,iid:r,discussionId:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await $(`/projects/${L(e)}/merge_requests/${r}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(n)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:e,limit:r}=t||{},i=Math.min(Number(r)>0?Number(r):50,200),n=new URLSearchParams;n.set("membership","true"),n.set("simple","true"),n.set("order_by","last_activity_at"),n.set("sort","desc"),n.set("per_page",String(Math.min(i+1,100))),e&&n.set("search",String(e));let o=await $(`/projects?${n.toString()}`),a=Array.isArray(o)?o:[],c=a.length>i,d=a.slice(0,i).map(l=>({fullPath:l.path_with_namespace,name:l.name,webUrl:l.web_url,defaultBranch:l.default_branch||null,visibility:l.visibility||null}));return JSON.stringify({count:d.length,truncated:c,projects:d})}case"gitlab_list_issues":{let{projectId:e,state:r,labels:i,assigneeUsername:n,authorUsername:o,updatedAfter:a,search:c,sort:d,orderBy:l,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",r||"opened"),u.set("per_page",String(p||30)),u.set("order_by",l||"updated_at"),u.set("sort",d||"desc"),i&&u.set("labels",Array.isArray(i)?i.join(","):i),n&&u.set("assignee_username",n),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await $(`/projects/${L(e)}/issues?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,labels:Array.isArray(h.labels)?h.labels:[],author:h.author?.username,assignees:(h.assignees||[]).map(_=>_.username),userNotesCount:h.user_notes_count,webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${L(e)}/issues/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(n=>n.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await $(`/projects/${L(e)}/issues/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"gitlab_list_projects",description:"List the GitLab projects this token can access (the projects you are a member of), optionally filtered by a search query. Use this to discover a RELATED project worth cloning when a change's correctness depends on another accessible repo. Returns a normalized list of { fullPath, name, webUrl, defaultBranch, visibility } and a truncated flag.",input_schema:{type:"object",properties:{query:{type:"string",description:"Optional search term matched against project name/path"},limit:{type:"number",description:"Max projects (default 50, hard max 200)"}}}},{name:"gitlab_clone",description:"Clone a GitLab repository locally (shallow) so you can read code OUTSIDE the MR diff \u2014 callers of a changed symbol, shared types/contracts, an existing util, or a cross-repo dependency. Auto-authenticates with the connected GitLab token. After cloning, use Grep/Glob/Read on the returned path. Clone SPARINGLY \u2014 only when the change's correctness depends on code beyond the diff.",input_schema:{type:"object",properties:{projectPath:{type:"string",description:'Full project path, e.g. "group/subgroup/repo" (preferred).'},projectId:{type:"string",description:"Alternatively a numeric project id (resolved to its path via the API)."},branch:{type:"string",description:"Branch to clone (default: the repo default branch)."},destination:{type:"string",description:"Destination dir (default: <workspace>/.zibby/repos/<repo>)."}}}},{name:"gitlab_create_mr",description:"Open a merge request on GitLab (POST /projects/{id}/merge_requests). The source_branch must already be pushed. Returns the REAL pr_url (the MR web_url) from GitLab \u2014 never fabricate it. Expected business outcomes (no changes between branches, an MR already exists, source==target) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{project:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},source_branch:{type:"string",description:"Source branch to merge FROM (must already be pushed)"},target_branch:{type:"string",description:"Target branch to merge INTO (default: the project's default branch)"},title:{type:"string",description:"MR title"},description:{type:"string",description:"MR description (markdown)"}},required:["project","source_branch","title"]}},{name:"gitlab_accept_mr",description:"Accept (merge) a merge request on GitLab (PUT /projects/{id}/merge_requests/{iid}/merge). Optional squash, mergeCommitMessage, mergeWhenPipelineSucceeds. Returns { success:true, merged:true, sha } with the REAL merge_commit_sha from GitLab. Expected non-mergeable outcomes (405/406 = not mergeable / WIP / conflicts / pipeline not done, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{project:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"},squash:{type:"boolean",description:"Squash the MR commits into one on merge (optional)"},mergeCommitMessage:{type:"string",description:"Custom merge commit message (optional)"},mergeWhenPipelineSucceeds:{type:"boolean",description:"Merge automatically once the pipeline succeeds (optional)"}},required:["project","iid"]}},{name:"gitlab_get_mr",description:"Get a GitLab merge request \u2014 title, description, branches, state, author, web url, and diff_refs (needed to anchor inline review comments).",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_get_mr_changes",description:"Get the changed files of a GitLab merge request with per-file diffs \u2014 the actual code changes to review. Also returns diff_refs for inline comments.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid"}},required:["projectId","iid"]}},{name:"gitlab_list_mrs",description:"List a GitLab project's merge requests, filtered by state and other criteria. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","merged","locked","all"],description:"Filter by state (default: opened)"},targetBranch:{type:"string",description:"Filter by target branch"},sourceBranch:{type:"string",description:"Filter by source branch"},authorUsername:{type:"string",description:"Filter by author username"},labels:{type:"array",items:{type:"string"},description:"Only MRs carrying ALL of these labels"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at","title"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max MRs (default: 20)"}},required:["projectId"]}},{name:"gitlab_list_mr_notes",description:"List the discussion notes on a GitLab merge request (chronological).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},limit:{type:"number",description:"Max notes (default 50)"}},required:["projectId","iid"]}},{name:"gitlab_post_mr_note",description:"Post a general (non-inline) comment on a GitLab merge request. Use for a review summary or a top-level remark.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}},{name:"gitlab_post_mr_discussion",description:"Post an INLINE review comment anchored to a file + line in a GitLab merge request diff. Provide newLine (added/changed line) or oldLine (removed/context line). Pass diffRefs from gitlab_get_mr/gitlab_get_mr_changes, or omit to have the tool fetch them. If the line anchor is rejected, fall back to gitlab_post_mr_note.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr. Omit and the tool fetches them."}},required:["projectId","iid","path","body"]}},{name:"gitlab_create_mr_review",description:"Post a full review on a GitLab merge request in one call: a summary note plus optional inline comments anchored to file/line in the diff. Convenience wrapper over gitlab_post_mr_note + gitlab_post_mr_discussion.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"The review summary (markdown). Posted as a top-level MR note."},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr \u2014 required to anchor inline comments. Omit and the tool fetches them."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line in a file.",items:{type:"object",properties:{path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","body"]}}},required:["projectId","iid"]}},{name:"gitlab_get_discussion",description:"Read a single GitLab merge-request DISCUSSION (thread) by its discussion id: all notes in order plus the diff position (file + line) it is anchored to. Use this to understand a human's reply to a previous review discussion before replying in-thread.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},discussionId:{type:"string",description:"The discussion id (from the Note Hook payload or gitlab_list_mr_notes)"}},required:["projectId","iid","discussionId"]}},{name:"gitlab_reply_discussion",description:"Reply IN-THREAD to an existing GitLab merge-request discussion (a conversational reply appended to the SAME thread \u2014 NOT a fresh review). Use after gitlab_get_discussion to answer a human's reply to a review comment.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},discussionId:{type:"string",description:"The discussion id to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["projectId","iid","discussionId","body"]}},{name:"gitlab_list_issues",description:"List a GitLab project's issues, filtered by state, labels, and an updatedAfter polling cursor. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","all"],description:"Filter by state (default: opened)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},assigneeUsername:{type:"string",description:"Filter by assignee username"},authorUsername:{type:"string",description:"Filter by author username"},updatedAfter:{type:"string",description:"ISO-8601 timestamp; only issues updated after this (polling cursor)"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30)"}},required:["projectId"]}},{name:"gitlab_get_issue",description:"Get a single GitLab issue with full detail (title, description, state, labels, assignees, web url).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Issue iid (the per-project issue number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_add_issue_comment",description:"Add a comment to a GitLab issue. Also the way to record an MR link on a ticket (post a markdown link).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Issue iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}}]};import{existsSync as Ms}from"fs";import{fileURLToPath as Ds}from"url";import{dirname as Bs,resolve as Ks}from"path";import{resolveIntegrationToken as Gs}from"@zibby/core/backend-client.js";function Fs(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=Bs(Ds(import.meta.url)),t=Ks(s,"..","bin","mcp-skill.mjs");return Ms(t)?t:null}async function ue(s,t={}){let{token:e}=await Gs("figma"),r=s.startsWith("https://")?s:`https://api.figma.com${s}`,i={"X-Figma-Token":e,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`Figma API ${n.status}: ${o.slice(0,300)}`)}return n.json()}var vt={id:"figma",serverName:"figma",allowedTools:["mcp__figma__*"],requiresIntegration:N.FIGMA,envKeys:[],description:"Figma \u2014 read files, nodes, comments, and render frames as PNGs",promptFragment:`## Figma (connected)
|
|
147
|
+
`)})}catch(S){let j=String(S.message||S).split(a).join("***");return JSON.stringify({error:`Clone failed: ${j}`})}}case"gitlab_create_mr":{let e=t?.project??t?.projectId,r=t?.source_branch??t?.sourceBranch,{title:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let n=x(e),o=t?.target_branch??t?.targetBranch;if(!o)try{o=(await $(`/projects/${n}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(r),target_branch:String(o),title:String(i),description:t?.description?String(t.description):""};try{let c=await $(`/projects/${n}/merge_requests`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.web_url,number:c.iid,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",state:c.state})}catch(c){let d=String(c.message||c);if(/GitLab API (409|400)/.test(d))return JSON.stringify({success:!1,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",skippedReason:d});throw c}}case"gitlab_accept_mr":{let e=t?.project??t?.projectId,{iid:r}=t||{};if(!e||!r)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=x(e),n={};t.squash!=null&&(n.squash=!!t.squash),t.mergeCommitMessage&&(n.merge_commit_message=String(t.mergeCommitMessage)),t.mergeWhenPipelineSucceeds!=null&&(n.merge_when_pipeline_succeeds=!!t.mergeWhenPipelineSucceeds);try{let o=await $(`/projects/${i}/merge_requests/${r}/merge`,{method:"PUT",body:n});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??r,project:String(e),provider:"gitlab",state:o.state})}catch(o){let a=String(o.message||o);if(/GitLab API (405|406|404)/.test(a))return JSON.stringify({success:!1,iid:r,project:String(e),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${x(e)}/merge_requests/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${x(e)}/merge_requests/${r}/changes`),n=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:n.length,diffRefs:i.diff_refs||null,files:n.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_mrs":{let{projectId:e,state:r,targetBranch:i,sourceBranch:n,authorUsername:o,labels:a,search:c,sort:d,orderBy:l,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",r||"opened"),u.set("per_page",String(p||20)),u.set("order_by",l||"updated_at"),u.set("sort",d||"desc"),i&&u.set("target_branch",i),n&&u.set("source_branch",n),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await $(`/projects/${x(e)}/merge_requests?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,author:h.author?.username,sourceBranch:h.source_branch,targetBranch:h.target_branch,draft:h.draft??h.work_in_progress??!1,labels:Array.isArray(h.labels)?h.labels:[],webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:r,limit:i}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let n=await $(`/projects/${x(e)}/merge_requests/${r}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(n)?n.length:0,notes:(Array.isArray(n)?n:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await $(`/projects/${x(e)}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:r,path:i,oldPath:n,newLine:o,oldLine:a,body:c}=t||{};if(!e||!r||!i||!c)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&a==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let d=x(e),l=t.diffRefs||null;if(l||(l=(await $(`/projects/${d}/merge_requests/${r}`)).diff_refs||null),!l||!l.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let p={base_sha:l.base_sha,start_sha:l.start_sha,head_sha:l.head_sha,position_type:"text",new_path:i,old_path:n||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await $(`/projects/${d}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(c),position:p}});return JSON.stringify({ok:!0,discussionId:u.id})}catch(u){return JSON.stringify({ok:!1,error:`inline anchor rejected (${u.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:r,body:i,comments:n}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let o=x(e),a=Array.isArray(n)?n.filter(u=>u&&u.path&&u.body&&(u.newLine!=null||u.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=t.diffRefs||null;a.length>0&&!c&&(c=(await $(`/projects/${o}/merge_requests/${r}`)).diff_refs||null);let d=!1;i&&(await $(`/projects/${o}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}}),d=!0);let l=0,p=[];if(a.length>0&&c)for(let u of a){let m={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:u.path,old_path:u.oldPath||u.path};u.newLine!=null&&(m.new_line=Number(u.newLine)),u.oldLine!=null&&(m.old_line=Number(u.oldLine));try{await $(`/projects/${o}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(u.body),position:m}}),l+=1}catch(f){p.push(`${u.path}:${u.newLine??u.oldLine} \u2014 ${f.message}`)}}else a.length>0&&!c&&p.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:d,inlinePosted:l,inlineErrors:p.length?p:void 0})}case"gitlab_get_discussion":{let{projectId:e,iid:r,discussionId:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let n=await $(`/projects/${x(e)}/merge_requests/${r}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(n.notes)?n.notes:[],a=o.find(d=>d.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:n.id,individualNote:!!n.individual_note,path:c&&(c.new_path||c.old_path)||null,newLine:c?c.new_line??null:null,oldLine:c?c.old_line??null:null,diffRefs:c?{base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha}:null,notes:o.map(d=>({id:d.id,author:d.author?.username,body:(d.body||"").slice(0,4e3),system:!!d.system,createdAt:d.created_at}))})}case"gitlab_reply_discussion":{let{projectId:e,iid:r,discussionId:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await $(`/projects/${x(e)}/merge_requests/${r}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(n)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:e,limit:r}=t||{},i=Math.min(Number(r)>0?Number(r):50,200),n=new URLSearchParams;n.set("membership","true"),n.set("simple","true"),n.set("order_by","last_activity_at"),n.set("sort","desc"),n.set("per_page",String(Math.min(i+1,100))),e&&n.set("search",String(e));let o=await $(`/projects?${n.toString()}`),a=Array.isArray(o)?o:[],c=a.length>i,d=a.slice(0,i).map(l=>({fullPath:l.path_with_namespace,name:l.name,webUrl:l.web_url,defaultBranch:l.default_branch||null,visibility:l.visibility||null}));return JSON.stringify({count:d.length,truncated:c,projects:d})}case"gitlab_list_issues":{let{projectId:e,state:r,labels:i,assigneeUsername:n,authorUsername:o,updatedAfter:a,search:c,sort:d,orderBy:l,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",r||"opened"),u.set("per_page",String(p||30)),u.set("order_by",l||"updated_at"),u.set("sort",d||"desc"),i&&u.set("labels",Array.isArray(i)?i.join(","):i),n&&u.set("assignee_username",n),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await $(`/projects/${x(e)}/issues?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,labels:Array.isArray(h.labels)?h.labels:[],author:h.author?.username,assignees:(h.assignees||[]).map(_=>_.username),userNotesCount:h.user_notes_count,webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await $(`/projects/${x(e)}/issues/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(n=>n.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await $(`/projects/${x(e)}/issues/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"gitlab_list_projects",description:"List the GitLab projects this token can access (the projects you are a member of), optionally filtered by a search query. Use this to discover a RELATED project worth cloning when a change's correctness depends on another accessible repo. Returns a normalized list of { fullPath, name, webUrl, defaultBranch, visibility } and a truncated flag.",input_schema:{type:"object",properties:{query:{type:"string",description:"Optional search term matched against project name/path"},limit:{type:"number",description:"Max projects (default 50, hard max 200)"}}}},{name:"gitlab_clone",description:"Clone a GitLab repository locally (shallow) so you can read code OUTSIDE the MR diff \u2014 callers of a changed symbol, shared types/contracts, an existing util, or a cross-repo dependency. Auto-authenticates with the connected GitLab token. After cloning, use Grep/Glob/Read on the returned path. Clone SPARINGLY \u2014 only when the change's correctness depends on code beyond the diff.",input_schema:{type:"object",properties:{projectPath:{type:"string",description:'Full project path, e.g. "group/subgroup/repo" (preferred).'},projectId:{type:"string",description:"Alternatively a numeric project id (resolved to its path via the API)."},branch:{type:"string",description:"Branch to clone (default: the repo default branch)."},destination:{type:"string",description:"Destination dir (default: <workspace>/.zibby/repos/<repo>)."}}}},{name:"gitlab_create_mr",description:"Open a merge request on GitLab (POST /projects/{id}/merge_requests). The source_branch must already be pushed. Returns the REAL pr_url (the MR web_url) from GitLab \u2014 never fabricate it. Expected business outcomes (no changes between branches, an MR already exists, source==target) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{project:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},source_branch:{type:"string",description:"Source branch to merge FROM (must already be pushed)"},target_branch:{type:"string",description:"Target branch to merge INTO (default: the project's default branch)"},title:{type:"string",description:"MR title"},description:{type:"string",description:"MR description (markdown)"}},required:["project","source_branch","title"]}},{name:"gitlab_accept_mr",description:"Accept (merge) a merge request on GitLab (PUT /projects/{id}/merge_requests/{iid}/merge). Optional squash, mergeCommitMessage, mergeWhenPipelineSucceeds. Returns { success:true, merged:true, sha } with the REAL merge_commit_sha from GitLab. Expected non-mergeable outcomes (405/406 = not mergeable / WIP / conflicts / pipeline not done, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{project:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"},squash:{type:"boolean",description:"Squash the MR commits into one on merge (optional)"},mergeCommitMessage:{type:"string",description:"Custom merge commit message (optional)"},mergeWhenPipelineSucceeds:{type:"boolean",description:"Merge automatically once the pipeline succeeds (optional)"}},required:["project","iid"]}},{name:"gitlab_get_mr",description:"Get a GitLab merge request \u2014 title, description, branches, state, author, web url, and diff_refs (needed to anchor inline review comments).",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_get_mr_changes",description:"Get the changed files of a GitLab merge request with per-file diffs \u2014 the actual code changes to review. Also returns diff_refs for inline comments.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid"}},required:["projectId","iid"]}},{name:"gitlab_list_mrs",description:"List a GitLab project's merge requests, filtered by state and other criteria. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","merged","locked","all"],description:"Filter by state (default: opened)"},targetBranch:{type:"string",description:"Filter by target branch"},sourceBranch:{type:"string",description:"Filter by source branch"},authorUsername:{type:"string",description:"Filter by author username"},labels:{type:"array",items:{type:"string"},description:"Only MRs carrying ALL of these labels"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at","title"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max MRs (default: 20)"}},required:["projectId"]}},{name:"gitlab_list_mr_notes",description:"List the discussion notes on a GitLab merge request (chronological).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},limit:{type:"number",description:"Max notes (default 50)"}},required:["projectId","iid"]}},{name:"gitlab_post_mr_note",description:"Post a general (non-inline) comment on a GitLab merge request. Use for a review summary or a top-level remark.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}},{name:"gitlab_post_mr_discussion",description:"Post an INLINE review comment anchored to a file + line in a GitLab merge request diff. Provide newLine (added/changed line) or oldLine (removed/context line). Pass diffRefs from gitlab_get_mr/gitlab_get_mr_changes, or omit to have the tool fetch them. If the line anchor is rejected, fall back to gitlab_post_mr_note.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr. Omit and the tool fetches them."}},required:["projectId","iid","path","body"]}},{name:"gitlab_create_mr_review",description:"Post a full review on a GitLab merge request in one call: a summary note plus optional inline comments anchored to file/line in the diff. Convenience wrapper over gitlab_post_mr_note + gitlab_post_mr_discussion.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"The review summary (markdown). Posted as a top-level MR note."},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr \u2014 required to anchor inline comments. Omit and the tool fetches them."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line in a file.",items:{type:"object",properties:{path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","body"]}}},required:["projectId","iid"]}},{name:"gitlab_get_discussion",description:"Read a single GitLab merge-request DISCUSSION (thread) by its discussion id: all notes in order plus the diff position (file + line) it is anchored to. Use this to understand a human's reply to a previous review discussion before replying in-thread.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},discussionId:{type:"string",description:"The discussion id (from the Note Hook payload or gitlab_list_mr_notes)"}},required:["projectId","iid","discussionId"]}},{name:"gitlab_reply_discussion",description:"Reply IN-THREAD to an existing GitLab merge-request discussion (a conversational reply appended to the SAME thread \u2014 NOT a fresh review). Use after gitlab_get_discussion to answer a human's reply to a review comment.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},discussionId:{type:"string",description:"The discussion id to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["projectId","iid","discussionId","body"]}},{name:"gitlab_list_issues",description:"List a GitLab project's issues, filtered by state, labels, and an updatedAfter polling cursor. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","all"],description:"Filter by state (default: opened)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},assigneeUsername:{type:"string",description:"Filter by assignee username"},authorUsername:{type:"string",description:"Filter by author username"},updatedAfter:{type:"string",description:"ISO-8601 timestamp; only issues updated after this (polling cursor)"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30)"}},required:["projectId"]}},{name:"gitlab_get_issue",description:"Get a single GitLab issue with full detail (title, description, state, labels, assignees, web url).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Issue iid (the per-project issue number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_add_issue_comment",description:"Add a comment to a GitLab issue. Also the way to record an MR link on a ticket (post a markdown link).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Issue iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}}]};import{existsSync as Ms}from"fs";import{fileURLToPath as Ds}from"url";import{dirname as Bs,resolve as Ks}from"path";import{resolveIntegrationToken as Gs}from"@zibby/core/backend-client.js";function Fs(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=Bs(Ds(import.meta.url)),t=Ks(s,"..","bin","mcp-skill.mjs");return Ms(t)?t:null}async function ue(s,t={}){let{token:e}=await Gs("figma"),r=s.startsWith("https://")?s:`https://api.figma.com${s}`,i={"X-Figma-Token":e,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`Figma API ${n.status}: ${o.slice(0,300)}`)}return n.json()}var Nt={id:"figma",serverName:"figma",allowedTools:["mcp__figma__*"],requiresIntegration:N.FIGMA,envKeys:[],description:"Figma \u2014 read files, nodes, comments, and render frames as PNGs",promptFragment:`## Figma (connected)
|
|
148
148
|
You have read access to the user's Figma files via the Figma REST API. Tools:
|
|
149
149
|
|
|
150
150
|
### Identity
|
|
@@ -176,7 +176,7 @@ You have read access to the user's Figma files via the Figma REST API. Tools:
|
|
|
176
176
|
assignee { id name displayName email }
|
|
177
177
|
labels { nodes { id name color } }
|
|
178
178
|
team { id key name }
|
|
179
|
-
`,
|
|
179
|
+
`,Ot={id:"linear",serverName:"linear",allowedTools:["mcp__linear__*"],requiresIntegration:N.LINEAR,envKeys:["LINEAR_API_KEY","LINEAR_OAUTH_TOKEN"],description:"Linear \u2014 issues, comments, workflow states (GraphQL API key)",promptFragment:`## Linear (connected)
|
|
180
180
|
You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
181
181
|
|
|
182
182
|
### Discovery
|
|
@@ -200,7 +200,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
|
200
200
|
nodes { id key name description }
|
|
201
201
|
}
|
|
202
202
|
}
|
|
203
|
-
`,{first:t?.limit||50}))?.teams?.nodes||[];return JSON.stringify({count:r.length,teams:r})}case"linear_list_states":{let{teamId:e,teamKey:r}=t||{},i=e;if(!i&&r&&(i=await
|
|
203
|
+
`,{first:t?.limit||50}))?.teams?.nodes||[];return JSON.stringify({count:r.length,teams:r})}case"linear_list_states":{let{teamId:e,teamKey:r}=t||{},i=e;if(!i&&r&&(i=await It(r)),i){let c=(await D(`
|
|
204
204
|
query States($teamId: String!) {
|
|
205
205
|
team(id: $teamId) {
|
|
206
206
|
id key name
|
|
@@ -219,7 +219,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
|
219
219
|
nodes { id name color team { id key } }
|
|
220
220
|
}
|
|
221
221
|
}
|
|
222
|
-
`,{first:t?.limit||100,filter:e?{team:{id:{eq:e}}}:void 0}))?.issueLabels?.nodes||[];return JSON.stringify({count:i.length,labels:i})}case"linear_list_issues":{let{teamId:e,teamKey:r,stateId:i,stateName:n,label:o,assigneeId:a,updatedAfter:c,limit:d}=t||{},l={},p=e;!p&&r&&(p=await
|
|
222
|
+
`,{first:t?.limit||100,filter:e?{team:{id:{eq:e}}}:void 0}))?.issueLabels?.nodes||[];return JSON.stringify({count:i.length,labels:i})}case"linear_list_issues":{let{teamId:e,teamKey:r,stateId:i,stateName:n,label:o,assigneeId:a,updatedAfter:c,limit:d}=t||{},l={},p=e;!p&&r&&(p=await It(r)),p&&(l.team={id:{eq:p}}),i?l.state={id:{eq:i}}:n&&(l.state={name:{eqIgnoreCase:n}}),o&&(l.labels={name:{eqIgnoreCase:o}}),a&&(l.assignee={id:{eq:a}}),c&&(l.updatedAt={gt:c});let m=((await D(`
|
|
223
223
|
query Issues($first: Int, $filter: IssueFilter, $orderBy: PaginationOrderBy) {
|
|
224
224
|
issues(first: $first, filter: $filter, orderBy: $orderBy) {
|
|
225
225
|
nodes {
|
|
@@ -261,7 +261,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
|
|
|
261
261
|
attachment { id url title }
|
|
262
262
|
}
|
|
263
263
|
}
|
|
264
|
-
`,{input:{issueId:o.id,url:r,title:i||r,subtitle:n||void 0}}))?.attachmentCreate;return JSON.stringify({ok:!!c?.success,attachmentId:c?.attachment?.id,url:c?.attachment?.url})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}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
|
|
264
|
+
`,{input:{issueId:o.id,url:r,title:i||r,subtitle:n||void 0}}))?.attachmentCreate;return JSON.stringify({ok:!!c?.success,attachmentId:c?.attachment?.id,url:c?.attachment?.url})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}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 It(s){return(await D(`
|
|
265
265
|
query TeamByKey($filter: TeamFilter) {
|
|
266
266
|
teams(first: 1, filter: $filter) { nodes { id key } }
|
|
267
267
|
}
|
|
@@ -281,7 +281,7 @@ You have direct access to the user's Plane workspace via the official Plane MCP
|
|
|
281
281
|
- List/get projects and work items, then create/update/delete or search work items as needed.
|
|
282
282
|
- For status changes, read the project's available states first, then set the work item's state.
|
|
283
283
|
- Cycles and modules group work items \u2014 list them to scope queries before drilling into items.
|
|
284
|
-
- Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:s,description:this.description}}};import{existsSync as ri}from"fs";import{fileURLToPath as si}from"url";import{dirname as ii,resolve as ni}from"path";import{resolveIntegrationToken as oi}from"@zibby/core/backend-client.js";function ai(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=ii(si(import.meta.url)),t=ni(s,"..","bin","mcp-skill.mjs");return ri(t)?t:null}async function
|
|
284
|
+
- Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:s,description:this.description}}};import{existsSync as ri}from"fs";import{fileURLToPath as si}from"url";import{dirname as ii,resolve as ni}from"path";import{resolveIntegrationToken as oi}from"@zibby/core/backend-client.js";function ai(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=ii(si(import.meta.url)),t=ni(s,"..","bin","mcp-skill.mjs");return ri(t)?t:null}async function At(){let s=await oi(N.OPEN_DESIGN),t=s?.token,e=s?.baseUrl;if(!t||typeof t!="string")throw new Error("OpenDesign is not connected: missing token. Connect it in Integrations.");if(!e||typeof e!="string")throw new Error("OpenDesign is not connected: missing baseUrl. Connect it in Integrations.");let r=e.replace(/\/+$/,"");return{token:t,baseUrl:r}}async function V(s,t={}){let{token:e,baseUrl:r}=await At(),i=`${r}/api${s}`;if(t.query&&typeof t.query=="object"){let a=new URLSearchParams;for(let[d,l]of Object.entries(t.query))l!=null&&l!==""&&a.set(d,String(l));let c=a.toString();c&&(i+=(i.includes("?")?"&":"?")+c)}let n={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},o=await fetch(i,{method:t.method||"GET",headers:n,body:t.body?JSON.stringify(t.body):void 0});return jt(o,"OpenDesign")}async function jt(s,t){if(!s.ok){let r=await s.text().catch(()=>""),i=r.slice(0,300);try{let n=JSON.parse(r),o=n?.code||n?.error?.code,a=n?.message||n?.error?.message||n?.error;(o||a)&&(i=[o?`[${o}]`:null,a].filter(Boolean).join(" ")||i)}catch{}throw new Error(`${t} API ${s.status}: ${i}`)}let e=await s.text().catch(()=>"");if(!e)return{};try{return JSON.parse(e)}catch{return{raw:e}}}var Tt={id:"open-design",serverName:"opendesign",allowedTools:["mcp__opendesign__*"],envKeys:[],description:"OpenDesign \u2014 list projects/designs, run the design agent, and export decks to PDF/HTML",promptFragment:`## OpenDesign (optional)
|
|
285
285
|
You may have access to the user's OpenDesign workspace (the Zibby-managed design/deck app) via its REST API. These tools are OPTIONAL \u2014 if OpenDesign is not connected they will return a "not connected" error; reach for them only when the task involves OpenDesign projects, designs, or exports. Tools (mcp__opendesign__*):
|
|
286
286
|
|
|
287
287
|
### Connectivity
|
|
@@ -303,35 +303,35 @@ You may have access to the user's OpenDesign workspace (the Zibby-managed design
|
|
|
303
303
|
|
|
304
304
|
### Notes
|
|
305
305
|
- A design artifact lookup ALWAYS needs its projectId (it scopes the query).
|
|
306
|
-
- After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let s=ai();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/opendesign.js","opendesignSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"opendesign_health":{let{baseUrl:e}=await
|
|
306
|
+
- After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let s=ai();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/opendesign.js","opendesignSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"opendesign_health":{let{baseUrl:e}=await At(),r=await fetch(`${e}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await jt(r,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let e=await V("/projects");return JSON.stringify(e)}case"opendesign_get_project":{let e=t?.id||t?.projectId;if(!e)return JSON.stringify({error:"id is required"});let r=await V(`/projects/${encodeURIComponent(e)}`);return JSON.stringify(r)}case"opendesign_list_designs":{let e=t?.projectId;if(!e)return JSON.stringify({error:"projectId is required"});let r=await V("/live-artifacts",{query:{projectId:e}});return JSON.stringify(r)}case"opendesign_get_design":{let e=t?.id,r=t?.projectId;if(!e)return JSON.stringify({error:"id is required"});if(!r)return JSON.stringify({error:"projectId is required"});let i=await V(`/live-artifacts/${encodeURIComponent(e)}`,{query:{projectId:r}});return JSON.stringify(i)}case"opendesign_export_pdf":{let e=t?.projectId||t?.id,{fileName:r,title:i,deck:n}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});if(!r)return JSON.stringify({error:"fileName is required"});let o={fileName:r};i!==void 0&&(o.title=i),n!==void 0&&(o.deck=n);let a=await V(`/projects/${encodeURIComponent(e)}/export/pdf`,{method:"POST",body:o});return JSON.stringify(a)}case"opendesign_export_html":{let e=t?.projectId||t?.id,r=t?.path;if(!e)return JSON.stringify({error:"projectId is required"});if(!r)return JSON.stringify({error:"path is required (the export sub-path)"});let n=String(r).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),o=await V(`/projects/${encodeURIComponent(e)}/export/${n}`,{query:{inline:1}});return JSON.stringify(o)}case"opendesign_cli_run":{let{agentId:e,message:r,projectId:i,conversationId:n,model:o}=t||{};if(!e)return JSON.stringify({error:"agentId is required"});if(!r)return JSON.stringify({error:"message is required"});let a={agentId:e,message:r};i!==void 0&&(a.projectId=i),n!==void 0&&(a.conversationId=n),o!==void 0&&(a.model=o);let c=await V("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let e=t?.id||t?.runId;if(!e)return JSON.stringify({error:"id (runId) is required"});let r=await V(`/runs/${encodeURIComponent(e)}`);return JSON.stringify(r)}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"opendesign_health",description:"Probe the OpenDesign instance (GET /api/health, no auth). Use to confirm connectivity before other calls.",input_schema:{type:"object",properties:{}}},{name:"opendesign_list_projects",description:"List the projects in the OpenDesign workspace.",input_schema:{type:"object",properties:{}}},{name:"opendesign_get_project",description:"Get a single OpenDesign project by id.",input_schema:{type:"object",properties:{id:{type:"string",description:"The project id."}},required:["id"]}},{name:"opendesign_list_designs",description:"List the live design artifacts in an OpenDesign project. Requires the projectId, which scopes the query.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id whose designs to list."}},required:["projectId"]}},{name:"opendesign_get_design",description:"Get a single live design artifact by id. Requires both the design id and its projectId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The live-artifact (design) id."},projectId:{type:"string",description:"The project id the design belongs to (scopes the lookup)."}},required:["id","projectId"]}},{name:"opendesign_export_pdf",description:"Export an OpenDesign project deck to PDF. Returns the export result (e.g. a download URL/path).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},fileName:{type:"string",description:"The output PDF file name."},title:{type:"string",description:"Optional deck title for the PDF."},deck:{description:"Optional deck payload/override to render instead of the project's current deck."}},required:["projectId","fileName"]}},{name:"opendesign_export_html",description:"Fetch an OpenDesign project's HTML export by sub-path (requested inline). Requires projectId and the export path.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},path:{type:"string",description:'The export sub-path under /projects/:id/export/ (e.g. "index.html" or a slide path).'}},required:["projectId","path"]}},{name:"opendesign_cli_run",description:"Start an OpenDesign agent run. Returns a runId; poll opendesign_cli_status with it until the run finishes.",input_schema:{type:"object",properties:{agentId:{type:"string",description:"The OpenDesign agent id to run."},message:{type:"string",description:"The instruction/message to send to the agent."},projectId:{type:"string",description:"Optional project id to scope the run to."},conversationId:{type:"string",description:"Optional conversation id to continue an existing thread."},model:{type:"string",description:"Optional model id override for the run."}},required:["agentId","message"]}},{name:"opendesign_cli_status",description:"Poll the status of an OpenDesign agent run by its runId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The runId returned by opendesign_cli_run."}},required:["id"]}}]};import{existsSync as ci}from"fs";import{fileURLToPath as li}from"url";import{dirname as di,resolve as pi}from"path";import{resolveIntegrationToken as ui}from"@zibby/core/backend-client.js";function mi(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let s=di(li(import.meta.url)),t=pi(s,"..","bin","mcp-slack.mjs");return ci(t)?t:null}async function U(s,t={}){let{token:e}=await ui("slack"),r=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(s),i=`https://slack.com/api/${s}`,n={Authorization:`Bearer ${e}`},o;if(r){let d=new URLSearchParams(t).toString();d&&(i+=`?${d}`)}else n["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let c=await(await fetch(i,{method:r?"GET":"POST",headers:n,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var L={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:N.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack (connected)
|
|
307
307
|
You have access to the user's Slack workspace. Use these tools:
|
|
308
308
|
- slack_list_channels, slack_post_message, slack_reply_to_thread
|
|
309
309
|
- slack_add_reaction, slack_get_channel_history, slack_get_thread_replies
|
|
310
310
|
- slack_get_users, slack_get_user_profile
|
|
311
311
|
- slack_lookup_user_by_email (precise email\u2192user_id, prefer this over scanning slack_get_users)
|
|
312
|
-
- slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let s=mi();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"slack_list_channels":{let e=await U("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(e.channels||[]).map(r=>({id:r.id,name:r.name,topic:r.topic?.value}))})}case"slack_post_message":{if(!t.channel||!t.text)return JSON.stringify({error:"channel and text are required"});let e=await U("chat.postMessage",{channel:t.channel,text:t.text,...t.blocks?{blocks:t.blocks}:{}});return JSON.stringify({ok:!0,ts:e.ts,channel:e.channel})}case"slack_reply_to_thread":{if(!t.channel||!t.thread_ts||!t.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let e=await U("chat.postMessage",{channel:t.channel,thread_ts:t.thread_ts,text:t.text});return JSON.stringify({ok:!0,ts:e.ts})}case"slack_add_reaction":return!t.channel||!t.timestamp||!t.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await U("reactions.add",{channel:t.channel,timestamp:t.timestamp,name:t.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!t.channel)return JSON.stringify({error:"channel is required"});let e=await U("conversations.history",{channel:t.channel,limit:t.limit||20});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_thread_replies":{if(!t.channel||!t.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let e=await U("conversations.replies",{channel:t.channel,ts:t.thread_ts});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_users":{let e=await U("users.list",{limit:100});return JSON.stringify({users:(e.members||[]).filter(r=>!r.is_bot&&!r.deleted).map(r=>({id:r.id,name:r.real_name||r.name}))})}case"slack_get_user_profile":{if(!t.user_id)return JSON.stringify({error:"user_id is required"});let e=await U("users.profile.get",{user:t.user_id});return JSON.stringify({profile:e.profile})}case"slack_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});try{let e=await U("users.lookupByEmail",{email:t.email});return JSON.stringify({ok:!0,user:{id:e.user?.id,name:e.user?.real_name||e.user?.name,email:e.user?.profile?.email||t.email}})}catch(e){if(/users_not_found/.test(e.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw e}}case"slack_list_usergroups":{let e=await U("usergroups.list",{});return JSON.stringify({usergroups:(e.usergroups||[]).map(r=>({id:r.id,handle:r.handle,name:r.name,description:r.description||"",user_count:Number(r.user_count||0)}))})}case"slack_get_usergroup_members":{if(!t.usergroup)return JSON.stringify({error:"usergroup id is required"});let e=await U("usergroups.users.list",{usergroup:t.usergroup});return JSON.stringify({users:e.users||[]})}case"slack_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=[],n,o=5;for(let c=0;c<o;c+=1){let d={limit:200};n&&(d.cursor=n);let l=await U("users.list",d);for(let p of l.members||[])p.deleted||p.is_bot||i.push(p);if(n=l.response_metadata?.next_cursor,!n)break}let a=[];for(let c of i){let d=(c.real_name||"").toLowerCase(),l=(c.profile?.display_name||"").toLowerCase(),p=(c.name||"").toLowerCase(),u=0;d.includes(e)&&(u+=100-Math.abs(d.length-e.length)),l.includes(e)&&(u+=60-Math.abs(l.length-e.length)),p.includes(e)&&(u+=30-Math.abs(p.length-e.length)),(d===e||l===e)&&(u+=200),u>0&&a.push({id:c.id,name:c.real_name||c.profile?.display_name||c.name,email:c.profile?.email||void 0,_score:u})}return a.sort((c,d)=>d._score-c._score),JSON.stringify({ok:!0,matches:a.slice(0,r).map(({_score:c,...d})=>d),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"slack_list_channels",description:"List public channels in the workspace",input_schema:{type:"object",properties:{}}},{name:"slack_post_message",description:"Post a message to a Slack channel or DM. Pass `blocks` (Block Kit) for a rich card; `text` is the required notification fallback.",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID or name"},text:{type:"string",description:"Notification/fallback text (required)"},blocks:{type:"array",description:"Block Kit blocks for rich formatting (optional). Each block is a Slack Block Kit object (header/section/divider/context). section blocks may carry a button accessory with a url."}},required:["channel","text"]}},{name:"slack_reply_to_thread",description:"Reply to a specific message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"},text:{type:"string",description:"Reply text"}},required:["channel","thread_ts","text"]}},{name:"slack_add_reaction",description:"Add an emoji reaction to a message",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},timestamp:{type:"string",description:"Message timestamp"},reaction:{type:"string",description:"Emoji name without colons"}},required:["channel","timestamp","reaction"]}},{name:"slack_get_channel_history",description:"Get recent messages from a channel",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},limit:{type:"number",description:"Number of messages"}},required:["channel"]}},{name:"slack_get_thread_replies",description:"Get all replies in a message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"}},required:["channel","thread_ts"]}},{name:"slack_get_users",description:"List workspace users with basic profiles",input_schema:{type:"object",properties:{}}},{name:"slack_get_user_profile",description:"Get detailed profile for a specific user",input_schema:{type:"object",properties:{user_id:{type:"string",description:"Slack user ID"}},required:["user_id"]}},{name:"slack_lookup_user_by_email",description:"Find a Slack user by email. Returns { ok:true, user:{id,name,email} } on hit, { ok:false } when no user has that email. Prefer this over slack_get_users for email-based routing \u2014 single API call, exact match.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"slack_list_usergroups",description:"List workspace-defined user groups (e.g. @oncall, @platform). Each item has { id, handle, name, description, user_count }. Use the id with slack_get_usergroup_members to expand the membership.",input_schema:{type:"object",properties:{}}},{name:"slack_get_usergroup_members",description:"List user IDs that belong to a Slack usergroup. Pair with slack_post_message to DM each member, or use the group id directly in a channel message as <!subteam^ID> to @-mention.",input_schema:{type:"object",properties:{usergroup:{type:"string",description:"Usergroup id, e.g. S012ABC"}},required:["usergroup"]}},{name:"slack_search_users",description:'Fuzzy-search workspace users by display name or real name. Use when the user said something like "send to Sam" without an email. Returns up to `limit` ranked matches { id, name, email }. Slack has no native name-search API \u2014 this scans paginated users.list + does substring scoring (real_name > display_name > name). For large workspaces consider higher limit + ask the user to confirm if multiple hit.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}]};import{existsSync as fi}from"fs";import{fileURLToPath as hi}from"url";import{dirname as yi,resolve as gi}from"path";import{resolveIntegrationToken as _i}from"@zibby/core/backend-client.js";function bi(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let s=yi(hi(import.meta.url)),t=gi(s,"..","bin","mcp-lark.mjs");return fi(t)?t:null}var ki=6e3*1e3,he=null;async function wi(){let{appId:s,appSecret:t,host:e}=await _i("lark");if(he&&he.appId===s&&he.expiresAt>Date.now())return{token:he.token,host:e};let i=await(await fetch(`${e}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:s,app_secret:t})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return he={token:i.tenant_access_token,expiresAt:Date.now()+ki,appId:s},{token:i.tenant_access_token,host:e}}async function re(s,t,e={}){let{token:r,host:i}=await wi(),n=`${i}${t}`,o={method:s,headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json; charset=utf-8"}};s!=="GET"&&(o.body=JSON.stringify(e));let c=await(await fetch(n,o)).json();if(c.code!==0)throw new Error(`Lark API ${t} error: ${c.msg||c.code}`);return c.data||{}}function Tt(s){return JSON.stringify({text:s})}function Si(s){return!s||typeof s!="string"||s.startsWith("oc_")?"chat_id":s.startsWith("ou_")?"open_id":s.startsWith("on_")?"union_id":s.startsWith("cli_")?"app_id":s.includes("@")?"email":"chat_id"}var K={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:N.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark (connected)
|
|
312
|
+
- slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let s=mi();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"slack_list_channels":{let e=await U("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(e.channels||[]).map(r=>({id:r.id,name:r.name,topic:r.topic?.value}))})}case"slack_post_message":{if(!t.channel||!t.text)return JSON.stringify({error:"channel and text are required"});let e=await U("chat.postMessage",{channel:t.channel,text:t.text,...t.blocks?{blocks:t.blocks}:{}});return JSON.stringify({ok:!0,ts:e.ts,channel:e.channel})}case"slack_reply_to_thread":{if(!t.channel||!t.thread_ts||!t.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let e=await U("chat.postMessage",{channel:t.channel,thread_ts:t.thread_ts,text:t.text});return JSON.stringify({ok:!0,ts:e.ts})}case"slack_add_reaction":return!t.channel||!t.timestamp||!t.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await U("reactions.add",{channel:t.channel,timestamp:t.timestamp,name:t.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!t.channel)return JSON.stringify({error:"channel is required"});let e=await U("conversations.history",{channel:t.channel,limit:t.limit||20});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_thread_replies":{if(!t.channel||!t.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let e=await U("conversations.replies",{channel:t.channel,ts:t.thread_ts});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_users":{let e=await U("users.list",{limit:100});return JSON.stringify({users:(e.members||[]).filter(r=>!r.is_bot&&!r.deleted).map(r=>({id:r.id,name:r.real_name||r.name}))})}case"slack_get_user_profile":{if(!t.user_id)return JSON.stringify({error:"user_id is required"});let e=await U("users.profile.get",{user:t.user_id});return JSON.stringify({profile:e.profile})}case"slack_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});try{let e=await U("users.lookupByEmail",{email:t.email});return JSON.stringify({ok:!0,user:{id:e.user?.id,name:e.user?.real_name||e.user?.name,email:e.user?.profile?.email||t.email}})}catch(e){if(/users_not_found/.test(e.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw e}}case"slack_list_usergroups":{let e=await U("usergroups.list",{});return JSON.stringify({usergroups:(e.usergroups||[]).map(r=>({id:r.id,handle:r.handle,name:r.name,description:r.description||"",user_count:Number(r.user_count||0)}))})}case"slack_get_usergroup_members":{if(!t.usergroup)return JSON.stringify({error:"usergroup id is required"});let e=await U("usergroups.users.list",{usergroup:t.usergroup});return JSON.stringify({users:e.users||[]})}case"slack_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=[],n,o=5;for(let c=0;c<o;c+=1){let d={limit:200};n&&(d.cursor=n);let l=await U("users.list",d);for(let p of l.members||[])p.deleted||p.is_bot||i.push(p);if(n=l.response_metadata?.next_cursor,!n)break}let a=[];for(let c of i){let d=(c.real_name||"").toLowerCase(),l=(c.profile?.display_name||"").toLowerCase(),p=(c.name||"").toLowerCase(),u=0;d.includes(e)&&(u+=100-Math.abs(d.length-e.length)),l.includes(e)&&(u+=60-Math.abs(l.length-e.length)),p.includes(e)&&(u+=30-Math.abs(p.length-e.length)),(d===e||l===e)&&(u+=200),u>0&&a.push({id:c.id,name:c.real_name||c.profile?.display_name||c.name,email:c.profile?.email||void 0,_score:u})}return a.sort((c,d)=>d._score-c._score),JSON.stringify({ok:!0,matches:a.slice(0,r).map(({_score:c,...d})=>d),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"slack_list_channels",description:"List public channels in the workspace",input_schema:{type:"object",properties:{}}},{name:"slack_post_message",description:"Post a message to a Slack channel or DM. Pass `blocks` (Block Kit) for a rich card; `text` is the required notification fallback.",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID or name"},text:{type:"string",description:"Notification/fallback text (required)"},blocks:{type:"array",description:"Block Kit blocks for rich formatting (optional). Each block is a Slack Block Kit object (header/section/divider/context). section blocks may carry a button accessory with a url."}},required:["channel","text"]}},{name:"slack_reply_to_thread",description:"Reply to a specific message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"},text:{type:"string",description:"Reply text"}},required:["channel","thread_ts","text"]}},{name:"slack_add_reaction",description:"Add an emoji reaction to a message",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},timestamp:{type:"string",description:"Message timestamp"},reaction:{type:"string",description:"Emoji name without colons"}},required:["channel","timestamp","reaction"]}},{name:"slack_get_channel_history",description:"Get recent messages from a channel",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},limit:{type:"number",description:"Number of messages"}},required:["channel"]}},{name:"slack_get_thread_replies",description:"Get all replies in a message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"}},required:["channel","thread_ts"]}},{name:"slack_get_users",description:"List workspace users with basic profiles",input_schema:{type:"object",properties:{}}},{name:"slack_get_user_profile",description:"Get detailed profile for a specific user",input_schema:{type:"object",properties:{user_id:{type:"string",description:"Slack user ID"}},required:["user_id"]}},{name:"slack_lookup_user_by_email",description:"Find a Slack user by email. Returns { ok:true, user:{id,name,email} } on hit, { ok:false } when no user has that email. Prefer this over slack_get_users for email-based routing \u2014 single API call, exact match.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"slack_list_usergroups",description:"List workspace-defined user groups (e.g. @oncall, @platform). Each item has { id, handle, name, description, user_count }. Use the id with slack_get_usergroup_members to expand the membership.",input_schema:{type:"object",properties:{}}},{name:"slack_get_usergroup_members",description:"List user IDs that belong to a Slack usergroup. Pair with slack_post_message to DM each member, or use the group id directly in a channel message as <!subteam^ID> to @-mention.",input_schema:{type:"object",properties:{usergroup:{type:"string",description:"Usergroup id, e.g. S012ABC"}},required:["usergroup"]}},{name:"slack_search_users",description:'Fuzzy-search workspace users by display name or real name. Use when the user said something like "send to Sam" without an email. Returns up to `limit` ranked matches { id, name, email }. Slack has no native name-search API \u2014 this scans paginated users.list + does substring scoring (real_name > display_name > name). For large workspaces consider higher limit + ask the user to confirm if multiple hit.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}]};import{existsSync as fi}from"fs";import{fileURLToPath as hi}from"url";import{dirname as yi,resolve as gi}from"path";import{resolveIntegrationToken as _i}from"@zibby/core/backend-client.js";function bi(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let s=yi(hi(import.meta.url)),t=gi(s,"..","bin","mcp-lark.mjs");return fi(t)?t:null}var ki=6e3*1e3,he=null;async function wi(){let{appId:s,appSecret:t,host:e}=await _i("lark");if(he&&he.appId===s&&he.expiresAt>Date.now())return{token:he.token,host:e};let i=await(await fetch(`${e}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:s,app_secret:t})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return he={token:i.tenant_access_token,expiresAt:Date.now()+ki,appId:s},{token:i.tenant_access_token,host:e}}async function re(s,t,e={}){let{token:r,host:i}=await wi(),n=`${i}${t}`,o={method:s,headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json; charset=utf-8"}};s!=="GET"&&(o.body=JSON.stringify(e));let c=await(await fetch(n,o)).json();if(c.code!==0)throw new Error(`Lark API ${t} error: ${c.msg||c.code}`);return c.data||{}}function $t(s){return JSON.stringify({text:s})}function Si(s){return!s||typeof s!="string"||s.startsWith("oc_")?"chat_id":s.startsWith("ou_")?"open_id":s.startsWith("on_")?"union_id":s.startsWith("cli_")?"app_id":s.includes("@")?"email":"chat_id"}var K={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:N.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark (connected)
|
|
313
313
|
You can send messages and replies on Lark. Use:
|
|
314
314
|
- lark_send_message: post a message to a chat, user, or DM
|
|
315
315
|
- lark_reply: reply to an existing message (threaded)
|
|
316
316
|
- lark_list_chats: list chats the bot is a member of
|
|
317
317
|
- lark_get_chat_history: fetch recent messages in a chat
|
|
318
318
|
- lark_lookup_user_by_email: resolve an email \u2192 open_id for direct DM (prefer this over emailing through lark_send_message when the agent has a user_id already)
|
|
319
|
-
When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let s=bi();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},tools:[{name:"lark_send_message",description:"Send a text message to a Lark chat, user, or DM. receive_id can be a chat_id (oc_*), open_id (ou_*), union_id (on_*), or email.",input_schema:{type:"object",properties:{receive_id:{type:"string",description:"Target id: chat_id (oc_*), open_id (ou_*), union_id (on_*), or email"},text:{type:"string",description:"Message text"}},required:["receive_id","text"]}},{name:"lark_reply",description:"Reply to an existing Lark message (creates a thread). Use the message_id from the inbound event.",input_schema:{type:"object",properties:{message_id:{type:"string",description:"Lark message id (om_*) to reply to"},text:{type:"string",description:"Reply text"}},required:["message_id","text"]}},{name:"lark_list_chats",description:"List chats (groups + DMs) the bot is a member of.",input_schema:{type:"object",properties:{page_size:{type:"number",description:"Max results (default 50)"}}}},{name:"lark_get_chat_history",description:"Fetch recent messages in a chat.",input_schema:{type:"object",properties:{chat_id:{type:"string",description:"Chat id (oc_*)"},page_size:{type:"number",description:"Max messages (default 20)"}},required:["chat_id"]}},{name:"lark_lookup_user_by_email",description:"Resolve an email address to a Lark user id (open_id). Returns { ok:true, user:{open_id,email,name} } on hit, { ok:false } if no Lark user has that email. Use the open_id as `receive_id` in lark_send_message to DM.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"lark_search_users",description:'Fuzzy-search users by name across chats the bot is a member of. Lark has no public org-wide user search API for bots \u2014 this walks the bot\'s chat memberships and matches names client-side. Best for "send to Sam" style routing where you have a name but no email. Returns up to `limit` ranked matches { open_id, name }.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against user names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}],async handleToolCall(s,t){try{switch(s){case"lark_send_message":{if(!t.receive_id||!t.text)return JSON.stringify({error:"receive_id and text are required"});let e=Si(t.receive_id),r=await re("POST",`/open-apis/im/v1/messages?receive_id_type=${e}`,{receive_id:t.receive_id,msg_type:"text",content
|
|
319
|
+
When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let s=bi();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},tools:[{name:"lark_send_message",description:"Send a text message to a Lark chat, user, or DM. receive_id can be a chat_id (oc_*), open_id (ou_*), union_id (on_*), or email.",input_schema:{type:"object",properties:{receive_id:{type:"string",description:"Target id: chat_id (oc_*), open_id (ou_*), union_id (on_*), or email"},text:{type:"string",description:"Message text"}},required:["receive_id","text"]}},{name:"lark_reply",description:"Reply to an existing Lark message (creates a thread). Use the message_id from the inbound event.",input_schema:{type:"object",properties:{message_id:{type:"string",description:"Lark message id (om_*) to reply to"},text:{type:"string",description:"Reply text"}},required:["message_id","text"]}},{name:"lark_list_chats",description:"List chats (groups + DMs) the bot is a member of.",input_schema:{type:"object",properties:{page_size:{type:"number",description:"Max results (default 50)"}}}},{name:"lark_get_chat_history",description:"Fetch recent messages in a chat.",input_schema:{type:"object",properties:{chat_id:{type:"string",description:"Chat id (oc_*)"},page_size:{type:"number",description:"Max messages (default 20)"}},required:["chat_id"]}},{name:"lark_lookup_user_by_email",description:"Resolve an email address to a Lark user id (open_id). Returns { ok:true, user:{open_id,email,name} } on hit, { ok:false } if no Lark user has that email. Use the open_id as `receive_id` in lark_send_message to DM.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"lark_search_users",description:'Fuzzy-search users by name across chats the bot is a member of. Lark has no public org-wide user search API for bots \u2014 this walks the bot\'s chat memberships and matches names client-side. Best for "send to Sam" style routing where you have a name but no email. Returns up to `limit` ranked matches { open_id, name }.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against user names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}],async handleToolCall(s,t){try{switch(s){case"lark_send_message":{if(!t.receive_id||!t.text)return JSON.stringify({error:"receive_id and text are required"});let e=Si(t.receive_id),r=await re("POST",`/open-apis/im/v1/messages?receive_id_type=${e}`,{receive_id:t.receive_id,msg_type:"text",content:$t(t.text)});return JSON.stringify({ok:!0,message_id:r.message_id})}case"lark_reply":{if(!t.message_id||!t.text)return JSON.stringify({error:"message_id and text are required"});let e=await re("POST",`/open-apis/im/v1/messages/${encodeURIComponent(t.message_id)}/reply`,{msg_type:"text",content:$t(t.text)});return JSON.stringify({ok:!0,message_id:e.message_id})}case"lark_list_chats":{let e=t.page_size||50,i=((await re("GET",`/open-apis/im/v1/chats?page_size=${e}`)).items||[]).map(n=>({chat_id:n.chat_id,name:n.name,description:n.description,owner_id:n.owner_id,chat_mode:n.chat_mode}));return JSON.stringify({chats:i})}case"lark_get_chat_history":{if(!t.chat_id)return JSON.stringify({error:"chat_id is required"});let e=t.page_size||20,i=((await re("GET",`/open-apis/im/v1/messages?container_id_type=chat&container_id=${encodeURIComponent(t.chat_id)}&page_size=${e}&sort_type=ByCreateTimeDesc`)).items||[]).map(n=>({message_id:n.message_id,sender_id:n.sender?.id,sender_type:n.sender?.sender_type,msg_type:n.msg_type,content:n.body?.content,create_time:n.create_time}));return JSON.stringify({messages:i})}case"lark_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});let r=((await re("POST","/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id",{emails:[t.email]})).user_list||[]).find(i=>i.email===t.email&&i.user_id);return JSON.stringify(r?{ok:!0,user:{open_id:r.user_id,email:r.email,name:r.name||void 0}}:{ok:!1,reason:"no_lark_user_for_email"})}case"lark_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=200,o=((await re("GET","/open-apis/im/v1/chats?page_size=100")).items||[]).map(l=>l.chat_id),a=new Set,c=[];for(let l of o){if(c.length>=i)break;try{let p=await re("GET",`/open-apis/im/v1/chats/${encodeURIComponent(l)}/members?member_id_type=open_id&page_size=100`);for(let u of p.items||[])if(!(!u.member_id||a.has(u.member_id))&&(a.add(u.member_id),c.push({open_id:u.member_id,name:u.name||""}),c.length>=i))break}catch(p){console.warn(`[lark] member scan failed for ${l}: ${p.message}`)}}let d=[];for(let l of c){let p=(l.name||"").toLowerCase();if(!p)continue;let u=0;p.includes(e)&&(u+=100-Math.abs(p.length-e.length)),p===e&&(u+=200),u>0&&d.push({open_id:l.open_id,name:l.name,_score:u})}return d.sort((l,p)=>p._score-l._score),JSON.stringify({ok:!0,matches:d.slice(0,r).map(({_score:l,...p})=>p),scanned:c.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}}};import{existsSync as vi}from"fs";import{fileURLToPath as Ni}from"url";import{dirname as Ii,resolve as Oi}from"path";import{resolveIntegrationToken as Ri,clearTokenCache as Ai}from"@zibby/core/backend-client.js";function ji(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=Ii(Ni(import.meta.url)),t=Oi(s,"..","bin","mcp-skill.mjs");return vi(t)?t:null}var Ti="2022-06-28",$i="https://api.notion.com/v1",Ie=2e4,Et=25,Ei=25;function xt(s){if(!s||typeof s!="string")return null;let e=s.trim().split(/[?#]/)[0],r=e.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);if(r)return r[0].toLowerCase();let i=e.match(/[0-9a-fA-F]{32}/g);if(i&&i.length){let n=i[i.length-1].toLowerCase();return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20)}`}return null}async function He(s,t={}){let e=async()=>{let{token:r}=await Ri("notion");if(typeof r!="string"||!r)throw new Error(`Invalid notion token type: ${typeof r}`);let i=await fetch(`${$i}${s}`,{method:t.method||"GET",headers:{Authorization:`Bearer ${r}`,"Notion-Version":Ti,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Notion API ${i.status}: ${o.slice(0,300)}`)}let n=await i.text().catch(()=>"");if(!n||!n.trim())return{};try{return JSON.parse(n)}catch{return{raw:n}}};try{return await e()}catch(r){let i=String(r?.message||r||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw r;return Ai("notion"),e()}}function ye(s){if(!Array.isArray(s))return"";let t="";for(let e of s){let r=e?.plain_text??e?.text?.content??"";if(!r)continue;let i=e.annotations||{};i.code&&(r=`\`${r}\``),i.bold&&(r=`**${r}**`),i.italic&&(r=`_${r}_`),i.strikethrough&&(r=`~~${r}~~`);let n=e?.href||e?.text?.link?.url;n&&(r=`[${r}](${n})`),t+=r}return t}function xi(s,t,e){let r=s?.type,i=s?.[r]||{},n=" ".repeat(Math.max(0,t)),o=(d="rich_text")=>ye(i[d]),a;switch(r){case"paragraph":a=o();break;case"heading_1":a=`# ${o()}`;break;case"heading_2":a=`## ${o()}`;break;case"heading_3":a=`### ${o()}`;break;case"bulleted_list_item":a=`${n}- ${o()}`;break;case"numbered_list_item":a=`${n}1. ${o()}`;break;case"to_do":a=`${n}- [${i.checked?"x":" "}] ${o()}`;break;case"toggle":a=`${n}- ${o()}`;break;case"quote":a=`> ${o()}`;break;case"callout":{a=`> ${i.icon?.emoji?`${i.icon.emoji} `:""}${o()}`;break}case"code":{a=`\`\`\`${i.language||""}
|
|
320
320
|
${o()}
|
|
321
321
|
\`\`\``;break}case"divider":a="---";break;case"child_page":a=`[child page: ${i.title||""}]`;break;case"child_database":a=`[child database: ${i.title||""}]`;break;case"bookmark":case"embed":case"link_preview":a=i.url?`<${i.url}>`:"";break;case"equation":a=i.expression?`$${i.expression}$`:"";break;case"table":case"column_list":case"column":a="";break;case"table_row":{let d=(i.cells||[]).map(l=>ye(l).trim());a=`${n}| ${d.join(" | ")} |`;break}default:a=o();break}let c=[];return a&&a.trim()&&c.push(a),e&&e.trim()&&c.push(e),c.join(`
|
|
322
|
-
`)}async function
|
|
323
|
-
`)}function Lt(s){let t=s?.properties||{};for(let e of Object.values(t))if(e?.type==="title"){let r=ye(e.title).trim();if(r)return r}return""}function
|
|
322
|
+
`)}async function Ct(s,t,e){let r=[],i,n=0;do{if(e.used>=Ie)break;let o=new URLSearchParams({page_size:"100"});i&&o.set("start_cursor",i);let a=await He(`/blocks/${s}/children?${o.toString()}`),c=Array.isArray(a.results)?a.results:[];for(let d of c){let l="";d.has_children&&(l=await Ct(d.id,t+1,e));let p=xi(d,t,l);if(p&&(r.push(p),e.used+=p.length+1),e.used>=Ie)break}i=a.has_more?a.next_cursor:void 0,n+=1}while(i&&n<Ei);return r.join(`
|
|
323
|
+
`)}function Lt(s){let t=s?.properties||{};for(let e of Object.values(t))if(e?.type==="title"){let r=ye(e.title).trim();if(r)return r}return""}function Li(s){if(!s||!s.type)return"";switch(s.type){case"title":return ye(s.title).trim();case"rich_text":return ye(s.rich_text).trim();case"number":return s.number==null?"":String(s.number);case"select":return s.select?.name||"";case"status":return s.status?.name||"";case"multi_select":return(s.multi_select||[]).map(e=>e.name).join(", ");case"checkbox":return s.checkbox?"true":"false";case"url":return s.url||"";case"email":return s.email||"";case"phone_number":return s.phone_number||"";case"date":return s.date?.start||"";case"people":return(s.people||[]).map(e=>e.name||e.id).join(", ");default:return""}}var Pt={id:"notion",serverName:"notion",allowedTools:["mcp__notion__*"],requiresIntegration:N.NOTION,description:"Notion read-only context (pull a page/database as markdown)",promptFragment:`## Notion (connected, read-only context)
|
|
324
324
|
You can pull a referenced Notion page in as extra context. This is OPTIONAL \u2014 only use it when the task references a Notion page/URL (e.g. an engineering-standards or design doc to review against).
|
|
325
325
|
- notion_get_page: pass a Notion page id OR a full Notion URL; returns { id, title, url, text } where text is the page flattened to markdown (truncated to ~20k chars). Use the text as reference context.
|
|
326
326
|
- notion_query_database: pass a database id/URL; returns a small list of rows ({ id, title, url, props }). Use to find a specific page, then notion_get_page it.
|
|
327
|
-
Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" and continue.`,resolve(){let s=ji();return s?{type:"stdio",command:"node",args:[s,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(s,t){try{switch(s){case"notion_get_page":{let e=t?.pageId||t?.page||t?.url||t?.id,r=
|
|
327
|
+
Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" and continue.`,resolve(){let s=ji();return s?{type:"stdio",command:"node",args:[s,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(s,t){try{switch(s){case"notion_get_page":{let e=t?.pageId||t?.page||t?.url||t?.id,r=xt(e);if(!r)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await He(`/pages/${r}`),n=Lt(i),o=i?.url||`https://www.notion.so/${r.replace(/-/g,"")}`,c=await Ct(r,0,{used:0}),d=!1;return c.length>Ie&&(c=c.slice(0,Ie),d=!0),JSON.stringify({ok:!0,id:r,title:n,url:o,text:c,...d?{truncated:!0}:{}})}case"notion_query_database":{let e=t?.databaseId||t?.database||t?.url||t?.id,r=xt(e);if(!r)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let n={page_size:Math.max(1,Math.min(Number(t?.maxResults)||Et,Et))};t?.filter&&typeof t.filter=="object"&&(n.filter=t.filter);let o=await He(`/databases/${r}/query`,{method:"POST",body:n}),c=(Array.isArray(o.results)?o.results:[]).map(d=>{let l={};for(let[p,u]of Object.entries(d.properties||{})){let m=Li(u);m&&(l[p]=m)}return{id:d.id,title:Lt(d),url:d.url||`https://www.notion.so/${String(d.id||"").replace(/-/g,"")}`,props:l}});return JSON.stringify({ok:!0,id:r,count:c.length,hasMore:!!o.has_more,rows:c})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"notion_get_page",description:"Fetch a Notion page and its content flattened to markdown, for use as read-only context. Accepts a raw page id OR a full Notion URL. Returns { ok, id, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."}},required:["pageId"]}},{name:"notion_query_database",description:"Query a Notion database and return a bounded list of rows (id, title, url, key props). Accepts a database id OR full Notion URL. Optional Notion filter object. Returns at most 25 rows.",input_schema:{type:"object",properties:{databaseId:{type:"string",description:"Notion database id (dashed UUID or 32-char) OR a full Notion database URL."},filter:{type:"object",description:"Optional Notion filter object (Notion query filter syntax).",additionalProperties:!0},maxResults:{type:"number",description:"Max rows to return (default 25, max 25)."}},required:["databaseId"]}}]};var qt={id:"chat_notify",description:"Chat notification meta-skill \u2014 routes to whichever messaging integration (Slack OR Lark) the user has configured for this project.",envKeys:[...L.envKeys||[],...K.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return L.serverName;if(process.env.LARK_RECEIVE_ID)return K.serverName;if(process.env.SLACK_BOT_TOKEN)return L.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?L.allowedTools||[]:process.env.LARK_RECEIVE_ID?K.allowedTools||[]:process.env.SLACK_BOT_TOKEN?L.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
|
|
328
328
|
You can post chat messages via:
|
|
329
329
|
- slack_post_message (channel, text[, blocks]) \u2014 Slack. The \`channel\` is REQUIRED on every call.
|
|
330
330
|
- lark_send_message (receive_id, text) \u2014 Lark.
|
|
331
331
|
Where to post:
|
|
332
332
|
- If SLACK_CHANNEL / LARK_RECEIVE_ID is set, that is the default destination \u2014 use it.
|
|
333
333
|
- If NO destination env var is set but your instructions name a channel (e.g. "post to #bla"), post to THAT channel \u2014 pass it as the \`channel\` arg (a "#name" or "C0123" id both work).
|
|
334
|
-
- If neither an env var NOR an instruction gives you a channel, do NOT post \u2014 there is nowhere to send it.`,resolve(s){return process.env.SLACK_CHANNEL&&typeof
|
|
334
|
+
- If neither an env var NOR an instruction gives you a channel, do NOT post \u2014 there is nowhere to send it.`,resolve(s){return process.env.SLACK_CHANNEL&&typeof L.resolve=="function"?L.resolve(s):process.env.LARK_RECEIVE_ID&&typeof K.resolve=="function"?K.resolve(s):process.env.SLACK_BOT_TOKEN&&typeof L.resolve=="function"?L.resolve(s):null},async handleToolCall(s,t,e){return typeof s=="string"&&s.startsWith("slack_")?L.handleToolCall(s,t,e):typeof s=="string"&&s.startsWith("lark_")?K.handleToolCall(s,t,e):JSON.stringify({error:`chat_notify: unknown tool "${s}". Expected slack_* or lark_*.`})},get tools(){return[...L.tools||[],...K.tools||[]]}};import{createRequire as Ci}from"module";import{execFileSync as Pi}from"child_process";import{join as Jt}from"path";import{existsSync as qi}from"fs";var Ji=Ci(import.meta.url);function Ui(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return Ji.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var Ut={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:s}=await import("@zibby/ui-memory");return s()}catch{return null}},promptFragment:`BEFORE executing browser actions:
|
|
335
335
|
- Review any test memory/history above. Prefer selectors proven to work.
|
|
336
336
|
- If a previous run failed, avoid the same approach.
|
|
337
337
|
- After setup/login completes, navigate directly to the target page instead of clicking through menus.
|
|
@@ -346,7 +346,7 @@ AFTER completing the test, you MUST call memory_save_insight at least once:
|
|
|
346
346
|
- Be specific \u2014 future runs will read your insights.`,resolve(){let s=Ui();if(!s)throw new Error(`\u274C Memory MCP server not found
|
|
347
347
|
|
|
348
348
|
Install @zibby/ui-memory:
|
|
349
|
-
npm install @zibby/ui-memory`);let t=
|
|
349
|
+
npm install @zibby/ui-memory`);let t=Jt(process.cwd(),".zibby","memory");if(!qi(Jt(t,".dolt")))throw new Error(`\u274C Memory database not initialized
|
|
350
350
|
|
|
351
351
|
Run:
|
|
352
352
|
zibby init --mem`);try{let e=Pi("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:t,encoding:"utf-8",timeout:5e3}),r=JSON.parse(e.trim()).rows||[];if(!r[0]||r[0].cnt===0)return console.log("[memory] Database empty \u2014 memory tools activate after first completed run"),null}catch(e){throw new Error(`\u274C Dolt not found or memory database error
|
|
@@ -366,15 +366,17 @@ AFTER completing the test, you MUST call memory_save_insight at least once:
|
|
|
366
366
|
3. After OAuth completes, ask me to install Slack again`},sentry:{description:"Sentry error tracking \u2014 projects, issues, events",integrationProvider:"sentry",envKeys:[],setupInstructions:`To connect Sentry:
|
|
367
367
|
1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
|
|
368
368
|
2. Click "Connect Sentry" and authorize
|
|
369
|
-
3. After OAuth completes, ask me to install Sentry again`},runner:{description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],setupInstructions:"Ready to use. Runs zibby test workflows as background processes \u2014 each with its own browser and session."},browser:{description:"Playwright browser automation (navigate, click, fill, screenshot)",envKeys:[],setupInstructions:"Ready to use. Starts a Playwright browser for web automation."},memory:{description:"Test memory database (Dolt) \u2014 history, selectors, insights",envKeys:[],setupInstructions:"Ready to use. Requires Dolt (https://docs.dolthub.com/introduction/installation) and a memory DB via `zibby init --mem`."},"chat-memory":{description:"Persistent chat memory \u2014 remembers facts, decisions, and task history across sessions (Dolt-backed)",envKeys:[],setupInstructions:'Ready to use. Requires Dolt installed. Tables auto-create on first use. Install with: "add chat memory" or "install chat-memory".'},git:{description:"Clone and explore git repositories locally for codebase analysis",envKeys:[],setupInstructions:"Ready to use. Clone repos with git_checkout, explore with git_explore. Auto-authenticates with GitHub/GitLab tokens."}};function Fi(){let s=["## Available Skills"];for(let[t,e]of Object.entries(se)){let r=e.integrationProvider?`integration: ${e.integrationProvider}`:"ready";s.push(`- ${t}: ${e.description} [${r}]`)}return s.push(""),s.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),s.push(`Zibby third party Integration settings page: ${
|
|
370
|
-
`)}function Hi(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let s=Ki(Bi(),".zibby","config.json");return Mi(s)&&JSON.parse(Di(s,"utf-8")).sessionToken||null}catch{return null}}function zi(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function
|
|
371
|
-
`)}function an(s,t){let e=s.cwd?
|
|
369
|
+
3. After OAuth completes, ask me to install Sentry again`},runner:{description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],setupInstructions:"Ready to use. Runs zibby test workflows as background processes \u2014 each with its own browser and session."},browser:{description:"Playwright browser automation (navigate, click, fill, screenshot)",envKeys:[],setupInstructions:"Ready to use. Starts a Playwright browser for web automation."},memory:{description:"Test memory database (Dolt) \u2014 history, selectors, insights",envKeys:[],setupInstructions:"Ready to use. Requires Dolt (https://docs.dolthub.com/introduction/installation) and a memory DB via `zibby init --mem`."},"chat-memory":{description:"Persistent chat memory \u2014 remembers facts, decisions, and task history across sessions (Dolt-backed)",envKeys:[],setupInstructions:'Ready to use. Requires Dolt installed. Tables auto-create on first use. Install with: "add chat memory" or "install chat-memory".'},git:{description:"Clone and explore git repositories locally for codebase analysis",envKeys:[],setupInstructions:"Ready to use. Clone repos with git_checkout, explore with git_explore. Auto-authenticates with GitHub/GitLab tokens."}};function Fi(){let s=["## Available Skills"];for(let[t,e]of Object.entries(se)){let r=e.integrationProvider?`integration: ${e.integrationProvider}`:"ready";s.push(`- ${t}: ${e.description} [${r}]`)}return s.push(""),s.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),s.push(`Zibby third party Integration settings page: ${ze()}`),s.push(""),s.push("## Tool-First Policy (mandatory)"),s.push("CRITICAL RULES \u2014 follow these strictly:"),s.push("1. When user asks to do something and a matching skill is available but not installed, IMMEDIATELY call install_skill. Never ask for credentials or confirmation first."),s.push(`2. If install_skill succeeds, the skill's tools are now available. Use them RIGHT AWAY in the same turn \u2014 don't just say "it's connected", actually call the tools.`),s.push("3. If install_skill reports needsIntegration, tell the user to connect via the integration URL and try again after."),s.push("4. When the relevant skill is already installed, use its tools directly \u2014 don't ask for IDs or keys. Each skill's own instructions explain the workflow."),s.push("5. If a task needs multiple skills (e.g. data from one + execution from another), install all of them, then follow each skill's workflow instructions."),s.join(`
|
|
370
|
+
`)}function Hi(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let s=Ki(Bi(),".zibby","config.json");return Mi(s)&&JSON.parse(Di(s,"utf-8")).sessionToken||null}catch{return null}}function zi(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function ze(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function Wi(s){try{let t=process.platform;return Gi(t==="darwin"?"open":t==="win32"?"cmd":"xdg-open",t==="win32"?["/c","start","",s]:[s],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function Yi(){let s=Hi();if(!s)return{checked:!1,statuses:null,reason:"no-session-token"};try{let t=await fetch(`${zi()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${s}`}});return t.ok?{checked:!0,statuses:await t.json()||{},reason:null}:{checked:!1,statuses:null,reason:`status-${t.status}`}}catch{return{checked:!1,statuses:null,reason:"network-error"}}}function Mt(s,t){if(!t||!s)return{connected:null};let e=s[t];return!e||typeof e.connected!="boolean"?{connected:null,details:e||null}:{connected:e.connected,details:e}}var Dt={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:se,promptFragment:Fi,tools:[{name:"install_skill",description:"Install a skill into the current chat session so its tools become available",input_schema:{type:"object",properties:{skillId:{type:"string",description:'Skill identifier to install (e.g. "jira", "github", "browser", "memory")'}},required:["skillId"]}},{name:"uninstall_skill",description:"Remove a skill from the current chat session",input_schema:{type:"object",properties:{skillId:{type:"string",description:"Skill identifier to remove"}},required:["skillId"]}},{name:"list_available_skills",description:"List all skills that can be installed, with their env-var readiness status",input_schema:{type:"object",properties:{}}}],async handleToolCall(s,t,e){let{activeSkills:r}=e,i=await Yi();if(s==="list_available_skills"){let n=Object.entries(se).map(([o,a])=>{let c=r.includes(o),d=Mt(i.statuses,a.integrationProvider);return{id:o,description:a.description,installed:c,integrationProvider:a.integrationProvider||void 0,integrationConnected:d.connected,setupInstructions:d.connected===!1?a.setupInstructions:void 0}});return JSON.stringify({skills:n})}if(s==="install_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(r.includes(n)){let l=se[n],{getSkill:p}=await import("@zibby/agent-workflow"),m=(p(n)?.tools||[]).map(f=>f.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:n,description:l?.description,availableTools:m,integrationUrl:l?.integrationProvider?ze():void 0,hint:`${n} is already active. Tools available: ${m.join(", ")}. Use them directly.`})}if(!se[n])return JSON.stringify({ok:!1,error:`Unknown skill "${n}". Available: ${Object.keys(se).join(", ")}`});let o=se[n];if(o.integrationProvider){let l=Mt(i.statuses,o.integrationProvider),p=ze();if(i.checked&&l.connected===!1){let u=Wi(p);return JSON.stringify({ok:!1,error:`${o.integrationProvider} is not connected for this Zibby account yet`,needsIntegration:!0,integrationUrl:p,openedBrowser:u,setupInstructions:`Please connect ${o.integrationProvider} first at ${p}. After you finish OAuth, ask me to install ${n} again.`})}}r.push(n);let{getSkill:a}=await import("@zibby/agent-workflow"),d=(a(n)?.tools||[]).map(l=>l.name);return JSON.stringify({ok:!0,installed:n,description:o.description,availableTools:d,hint:`${n} is now active. You now have these tools: ${d.join(", ")}. Use them immediately to help the user \u2014 don't just confirm installation.`})}if(s==="uninstall_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(n==="skill-installer")return JSON.stringify({ok:!1,error:"Cannot uninstall the skill installer"});let o=r.indexOf(n);return o===-1?JSON.stringify({ok:!1,error:`${n} is not installed`}):(r.splice(o,1),JSON.stringify({ok:!0,uninstalled:n}))}return JSON.stringify({error:`Unknown tool: ${s}`})},resolve(){return null}};import{readFileSync as Zi,readdirSync as Vi,statSync as Kt,writeFileSync as Qi,mkdirSync as Xi}from"fs";import{join as Gt,resolve as en,relative as tn}from"path";import{execSync as Ft}from"child_process";var Bt=256*1024,rn=64*1024,Ht={id:"core-tools",description:"File read/write, directory listing, shell commands, open URLs, wait for async operations",envKeys:[],tools:[{name:"read_file",description:"Read the contents of a file. Returns the text content.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"}},required:["path"]}},{name:"write_file",description:"Write content to a file. Creates parent directories if needed.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"},content:{type:"string",description:"Content to write"}},required:["path","content"]}},{name:"list_directory",description:"List files and directories in a path. Returns names with type indicators (/ for dirs).",input_schema:{type:"object",properties:{path:{type:"string",description:"Directory path (relative to cwd or absolute). Defaults to cwd."}}}},{name:"run_command",description:"Run a shell command and return its output. Use for grep, git, npm, etc.",input_schema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute"},cwd:{type:"string",description:"Working directory (optional, defaults to project root)"}},required:["command"]}},{name:"open_url",description:"Open a URL in the user's default browser. Use for OAuth flows, documentation, integration setup pages.",input_schema:{type:"object",properties:{url:{type:"string",description:"URL to open"}},required:["url"]}},{name:"wait",description:"Wait for N seconds. Use this for async operations (tests, builds, deploys) \u2014 wait, then check status again.",input_schema:{type:"object",properties:{seconds:{type:"number",description:"Seconds to wait (default: 5, max: 300)"},reason:{type:"string",description:"Why waiting (for logging/clarity)"}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"read_file":return sn(t,r);case"write_file":return nn(t,r);case"list_directory":return on(t,r);case"run_command":return an(t,r);case"open_url":return cn(t);case"wait":return await ln(t,e?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function Oe(s,t){return en(t,s)}function sn(s,t){let e=Oe(s.path,t),r=Kt(e);return r.size>Bt?JSON.stringify({error:`File too large (${(r.size/1024).toFixed(0)}KB). Max: ${Bt/1024}KB`}):Zi(e,"utf-8")}function nn(s,t){let e=Oe(s.path,t),r=Gt(e,"..");return Xi(r,{recursive:!0}),Qi(e,s.content,"utf-8"),JSON.stringify({ok:!0,path:tn(t,e)})}function on(s,t){let e=Oe(s.path||".",t);return Vi(e).map(i=>{try{return Kt(Gt(e,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
|
|
371
|
+
`)}function an(s,t){let e=s.cwd?Oe(s.cwd,t):t;return Ft(s.command,{cwd:e,encoding:"utf-8",timeout:3e4,maxBuffer:rn,stdio:["pipe","pipe","pipe"]})||"(no output)"}function cn(s){let{url:t}=s;if(!t||!t.startsWith("http://")&&!t.startsWith("https://"))return JSON.stringify({error:"Invalid URL \u2014 must start with http:// or https://"});let e=process.platform,r=e==="darwin"?"open":e==="win32"?"start":"xdg-open";try{return Ft(`${r} "${t}"`,{stdio:"ignore",timeout:5e3}),JSON.stringify({ok:!0,opened:t})}catch{return JSON.stringify({ok:!1,error:`Could not open browser. Please visit: ${t}`})}}async function ln(s,t){let e=Math.min(Math.max(s.seconds||5,1),300),r=s.reason||"async operation",i=500,n=Date.now()+e*1e3;for(;Date.now()<n;){if(t?.aborted)return JSON.stringify({ok:!0,waited:Math.round((e*1e3-(n-Date.now()))/1e3),reason:r,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,n-Date.now())))}return JSON.stringify({ok:!0,waited:e,reason:r})}import{existsSync as dn}from"fs";import{fileURLToPath as pn}from"url";import{dirname as un,resolve as mn}from"path";import{resolveIntegrationToken as Ae}from"@zibby/core/backend-client.js";function fn(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let s=un(pn(import.meta.url)),t=mn(s,"..","bin","mcp-sentry.mjs");return dn(t)?t:null}async function zt(s,t={}){let{token:e,organizationSlug:r}=await Ae("sentry"),i=`https://sentry.io/api/0/organizations/${r}${s}`,n={method:t.method||"GET",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"}};t.body!=null&&(n.body=typeof t.body=="string"?t.body:JSON.stringify(t.body));let o=await fetch(i,n);if(!o.ok){let a=await o.text().catch(()=>"");throw new Error(`Sentry API ${o.status}: ${a.slice(0,300)}`)}return o.json()}async function hn(){return zt("/projects/?per_page=50")}async function yn({query:s="is:unresolved",sort:t="date",project:e,limit:r=25}={}){let i=`/issues/?query=${encodeURIComponent(s)}&sort=${t}&per_page=${r}`;return e&&(i+=`&project=${encodeURIComponent(e)}`),zt(i)}async function gn(s){if(!s)throw new Error("sentryGetIssue: issueId is required");let{token:t}=await Ae("sentry"),e=await fetch(`https://sentry.io/api/0/issues/${s}/`,{headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let r=await e.text().catch(()=>"");throw new Error(`Sentry API ${e.status}: ${r.slice(0,300)}`)}return e.json()}async function _n(s,t={}){if(!s)throw new Error("sentryUpdateIssue: issueId is required");let e={};for(let n of["status","statusDetails","assignedTo","isBookmarked","hasSeen"])t[n]!==void 0&&(e[n]=t[n]);if(Object.keys(e).length===0)throw new Error("sentryUpdateIssue: nothing to update (pass status / statusDetails / assignedTo / isBookmarked / hasSeen)");let{token:r}=await Ae("sentry"),i=await fetch(`https://sentry.io/api/0/issues/${s}/`,{method:"PUT",headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!i.ok){let n=await i.text().catch(()=>"");throw i.status===403?new Error(`Sentry API 403 updating issue ${s}: ${n.slice(0,200)}. The connected Sentry integration likely lacks the \`event:write\` scope \u2014 reconnect Sentry with write access to let Zibby resolve/comment on issues.`):new Error(`Sentry API ${i.status} updating issue ${s}: ${n.slice(0,300)}`)}return i.json()}async function bn(s,t){if(!s)throw new Error("sentryAddComment: issueId is required");if(!t||!String(t).trim())throw new Error("sentryAddComment: text is required");let{token:e}=await Ae("sentry"),r=await fetch(`https://sentry.io/api/0/issues/${s}/comments/`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({text:String(t)})});if(!r.ok){let i=await r.text().catch(()=>"");throw r.status===403?new Error(`Sentry API 403 commenting on issue ${s}: ${i.slice(0,200)}. The connected Sentry integration likely lacks the \`event:write\` scope \u2014 reconnect Sentry with write access.`):new Error(`Sentry API ${r.status} commenting on issue ${s}: ${i.slice(0,300)}`)}return r.json()}var Re={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:N.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry (connected)
|
|
372
372
|
You have access to the user's Sentry. Use these tools:
|
|
373
373
|
- sentry_list_projects: List projects in the organization
|
|
374
374
|
- sentry_list_issues: List errors/issues (supports Sentry search query, project filter, sort)
|
|
375
|
-
- sentry_get_issue: Get detailed info about a specific issue (requires issueId)
|
|
375
|
+
- sentry_get_issue: Get detailed info about a specific issue (requires issueId)
|
|
376
|
+
- sentry_update_issue: Change an issue's status (resolved / resolvedInNextRelease / ignored / unresolved / muted), assignment, or bookmark (requires issueId; needs write scope)
|
|
377
|
+
- sentry_add_comment: Post a comment/note on an issue (requires issueId + text; needs write scope)`,resolve(){let s=fn();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t={}){try{switch(s){case"sentry_list_projects":{let e=await hn();return JSON.stringify({projects:e.map(r=>({slug:r.slug,name:r.name,platform:r.platform}))})}case"sentry_list_issues":{let e=await yn({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(r=>({id:r.id,title:r.title,culprit:r.culprit,count:r.count,firstSeen:r.firstSeen,lastSeen:r.lastSeen,level:r.level,status:r.status}))})}case"sentry_get_issue":{let e=await gn(t.issueId);return JSON.stringify({id:e.id,title:e.title,culprit:e.culprit,metadata:e.metadata,count:e.count,userCount:e.userCount,firstSeen:e.firstSeen,lastSeen:e.lastSeen,level:e.level,status:e.status,project:{slug:e.project?.slug,name:e.project?.name}})}case"sentry_update_issue":{let e=await _n(t.issueId,{status:t.status,statusDetails:t.statusDetails,assignedTo:t.assignedTo,isBookmarked:t.isBookmarked,hasSeen:t.hasSeen});return JSON.stringify({ok:!0,id:e.id??t.issueId,status:e.status,assignedTo:e.assignedTo,isBookmarked:e.isBookmarked})}case"sentry_add_comment":{let e=await bn(t.issueId,t.text);return JSON.stringify({ok:!0,id:e.id,issueId:t.issueId})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},toolsForAssistant:[{name:"sentry_list_projects",description:"List Sentry projects",input_schema:{type:"object",properties:{}}},{name:"sentry_list_issues",description:"List Sentry issues (errors)",input_schema:{type:"object",properties:{project:{type:"string",description:"Project slug (optional)"},query:{type:"string",description:"Sentry search query (default: is:unresolved)"},sort:{type:"string",description:"Sort order: date, new, priority, freq, user (default: date)"},limit:{type:"number",description:"Max issues to return (default 25)"}}}},{name:"sentry_get_issue",description:"Get details of a specific Sentry issue",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"}},required:["issueId"]}},{name:"sentry_update_issue",description:"Update a Sentry issue's status, assignment, or bookmark (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},status:{type:"string",description:"resolved | resolvedInNextRelease | unresolved | ignored | muted"},statusDetails:{type:"object",description:'Optional status details, e.g. { "inRelease": "latest" }'},assignedTo:{type:"string",description:'Assignee actor id, e.g. "user:123" or "team:456" (optional)'},isBookmarked:{type:"boolean",description:"Bookmark/unbookmark the issue (optional)"},hasSeen:{type:"boolean",description:"Mark the issue seen/unseen (optional)"}},required:["issueId"]}},{name:"sentry_add_comment",description:"Post a comment/note on a Sentry issue (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},text:{type:"string",description:"Comment body (markdown)"}},required:["issueId","text"]}}]};Re.tools=Re.toolsForAssistant;import{spawn as sr}from"child_process";import{writeFileSync as kn,mkdirSync as Wt,existsSync as G,readdirSync as Ee,readFileSync as $e,unlinkSync as wn,createWriteStream as Sn,statSync as vn}from"fs";import{resolve as ie,join as B}from"path";import{resolveMaxParallelRuns as ir}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as Nn}from"@zibby/core/constants/zibby-scratch.js";var Ze="sessions",Ve=".zibby/output",je=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",In=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",nr=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",P=new Map,Q=[],On=0,We=0,Yt=3e3;function or(){return`run_${++On}_${Date.now().toString(36)}`}function Zt(s){let t=Math.floor(s/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function ar(s){return s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function C(s,t,e){if(!In)return;let r=`
|
|
376
378
|
${t} [${s}] ${e}
|
|
377
|
-
`;try{process.stderr.write(r)}catch{}}function
|
|
379
|
+
`;try{process.stderr.write(r)}catch{}}function Qe(){Q.length=0;for(let[,s]of P)if(s.status==="queued"&&(s.status="cancelled"),s.status==="running"&&s._child)try{s._child.kill("SIGTERM")}catch{}}process.on("exit",Qe);process.on("SIGINT",()=>{Qe(),process.exit(0)});process.on("SIGTERM",()=>{Qe(),process.exit(0)});var cr={id:"runner",description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],promptFragment:`## Test Runner
|
|
378
380
|
You can run zibby test workflows directly from chat:
|
|
379
381
|
|
|
380
382
|
**CRITICAL: When user asks to test a ticket:**
|
|
@@ -511,35 +513,35 @@ Each run generates:
|
|
|
511
513
|
- events.json: All browser events
|
|
512
514
|
- raw_stream_output.txt: Agent log
|
|
513
515
|
|
|
514
|
-
Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"run_generate":return await
|
|
515
|
-
`)){let S=ar(y).trim();S.startsWith("\u2705")?C(u,"\u2705",S.slice(2).trim()):S.startsWith("\u2713")&&C(u,"\u2714",S.slice(2).trim())}}),f.stderr.on("data",g=>{_+=g.toString()}),f.on("close",g=>{if(g!==0){C(u,"\u274C",`Generation failed (exit ${g})`),m(JSON.stringify({error:`zibby generate failed with exit code ${g}`,stderr:_.slice(-1e3)}));return}let b=ie(t,a||"test-specs"),y=[];try{let S=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";y
|
|
516
|
+
Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"run_generate":return await Rn(t,r);case"run_test":return await xn(t,r,e);case"run_status":return Ln(t);case"run_cancel":return Cn(t);case"run_artifacts":return Jn(t,r);case"run_diagnose":return Un(t,r);case"list_specs":return Mn(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"run_generate",description:"Generate specs from codebase. CRITICAL: DO NOT USE if ticket has test steps in comments. Only use when: (1) NO steps in ticket AND (2) local codebase exists (not external URLs). For tickets with steps, use run_test with inline format.",input_schema:{type:"object",properties:{ticket:{type:"string",description:"Jira ticket key (e.g. SCRUM-123). Auto-fetches ticket details."},description:{type:"string",description:"Ticket description text (use if no Jira key available)"},input:{type:"string",description:"Path to a file containing ticket/requirements text"},repo:{type:"string",description:"Path to the codebase (default: current directory)"},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},output:{type:"string",description:"Output directory for spec files (default: test-specs)"}}}},{name:"run_test",description:"Start a test (async, returns runId). spec = file path, or inline:+steps, or a Jira-shaped issue key (e.g. PROJ-123): when Jira is connected, the runner loads that issue's description+comments into an inline spec. After starting, tell the user and let them ask for progress via run_status.",input_schema:{type:"object",properties:{spec:{type:"string",description:"Workspace file path; or inline:+steps; or Jira issue key (KEY-123) to auto-fetch from Jira when the jira skill is active."},ticketKey:{type:"string",description:"Optional label (e.g. SCRUM-123). If spec is an issue key, this defaults to that key."},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},headless:{type:"boolean",description:"Run browser headless (default false)"},workflow:{type:"string",description:"Workflow override (e.g. quick-smoke)"}},required:["spec"]}},{name:"run_status",description:'Instant progress check \u2014 returns immediately. Use this whenever user asks about test progress. ALWAYS use runId="all".',input_schema:{type:"object",properties:{runId:{type:"string",description:'Use "all" to see all runs in this session (recommended). Or a specific run ID if known.'}},required:["runId"]}},{name:"run_cancel",description:'Cancel/kill a running test. ONLY use when the USER explicitly asks to cancel or stop a run. NEVER auto-cancel \u2014 tests take 1-5 minutes and "running" is normal. Use runId="all" to cancel all active runs.',input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID to cancel, or "all" to cancel all active runs'}},required:["runId"]}},{name:"run_artifacts",description:"Read artifacts from a test run session. Can list files, read results/events/logs, or search across all sessions.",input_schema:{type:"object",properties:{runId:{type:"string",description:"Run ID from run_test. Omit to search across all sessions."},type:{type:"string",enum:["list","result","events","log","search"],description:'What to retrieve: "list" = all files in session, "result" = result.json, "events" = events.json, "log" = raw output tail, "search" = search text across sessions'},node:{type:"string",description:'Node name to read from (e.g. "execute_live", "generate_script"). Default: "execute_live"'},query:{type:"string",description:'Search text (only for type="search"). Searches across all session logs/events.'},tail:{type:"number",description:"Number of characters from end of log to return (default: 3000)"}},required:["type"]}},{name:"run_diagnose",description:"Diagnose one or all runs, especially failed ones. Uses run logs + known error patterns and returns likely root cause with suggested next action.",input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID from run_test, or "all" (default) to diagnose all known runs'},tail:{type:"number",description:"Characters of run log tail to inspect (default: 2000)"}}}},{name:"list_specs",description:"List available test spec files in the project",input_schema:{type:"object",properties:{directory:{type:"string",description:'Directory to scan (default: "test-specs")'}}}}]};function Ye(){let s=0;for(let[,t]of P)t.status==="running"&&s++;return s}function Vt(){for(;Q.length>0;){let s=ir(Q[0]?.context?.options?.config);if(Ye()>=s)break;let{args:t,cwd:e,context:r}=Q.shift();lr(t,e,r)}}async function Rn(s,t){let{ticket:e,description:r,input:i,repo:n,agent:o,output:a}=s,c=["generate"];e&&c.push("--ticket",e),r&&c.push("--description",r),i&&c.push("--input",i),n&&c.push("--repo",n),a&&c.push("--output",a);let d=["assistant","cursor","claude","codex","gemini"],l=o||process.env.AGENT_TYPE,p=l&&d.includes(l)?l:null;p&&c.push("--agent",p);let u=e||"generate";return C(u,"\u{1F9EA}","Starting test spec generation (real agent with codebase access)..."),new Promise(m=>{nr&&console.error(`[zibby:spawn] skill=run_generate parentPid=${process.pid} \u2192 child zibby ${c.map(g=>/\s/.test(g)?JSON.stringify(g):g).join(" ")} cwd=${t}`);let f=sr("zibby",c,{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"],detached:!1}),h="",_="";f.stdout.on("data",g=>{let b=g.toString();h+=b;for(let y of b.split(`
|
|
517
|
+
`)){let S=ar(y).trim();S.startsWith("\u2705")?C(u,"\u2705",S.slice(2).trim()):S.startsWith("\u2713")&&C(u,"\u2714",S.slice(2).trim())}}),f.stderr.on("data",g=>{_+=g.toString()}),f.on("close",g=>{if(g!==0){C(u,"\u274C",`Generation failed (exit ${g})`),m(JSON.stringify({error:`zibby generate failed with exit code ${g}`,stderr:_.slice(-1e3)}));return}let b=ie(t,a||"test-specs"),y=[];try{let S=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";y=Ee(b).filter(j=>j.endsWith(".txt")&&(!S||j.startsWith(S))).map(j=>B(b,j))}catch{}C(u,"\u2705",`Generated ${y.length} test spec files`),m(JSON.stringify({success:!0,ticketKey:e||null,specFiles:y.map(S=>S.replace(`${t}/`,"")),total:y.length,message:`Generated ${y.length} specs. Now call run_test for each file.`}))}),f.on("error",g=>{C(u,"\u274C",`Spawn error: ${g.message}`),m(JSON.stringify({error:g.message}))})})}var Qt=1e5,Xt=/^[A-Z][A-Z0-9]+-\d+$/,An=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function jn(s,t){if(!t||!t.length)return s;let e=s;for(let r of t)r.type==="strong"?e=`**${e}**`:r.type==="em"?e=`_${e}_`:r.type==="code"?e=`\`${e}\``:r.type==="strike"?e=`~~${e}~~`:r.type==="link"&&r.attrs?.href&&(e=`[${e}](${r.attrs.href})`);return e}function Te(s,t=0){if(!Array.isArray(s))return"";let e=[];for(let r of s){if(r.type==="text"){e.push(jn(r.text||"",r.marks));continue}if(r.type==="hardBreak"){e.push(`
|
|
516
518
|
`);continue}if(r.type==="rule"){e.push(`
|
|
517
519
|
---
|
|
518
|
-
`);continue}let i=r.content?
|
|
520
|
+
`);continue}let i=r.content?Te(r.content,t+1):"";if(r.type==="listItem")e.push(i);else if(r.type==="bulletList"){let n=(r.content||[]).map(o=>`- ${Te(o.content||[],t+1).trim()}`);e.push(`
|
|
519
521
|
${n.join(`
|
|
520
522
|
`)}
|
|
521
|
-
`)}else if(r.type==="orderedList"){let n=(r.content||[]).map((o,a)=>`${a+1}. ${
|
|
523
|
+
`)}else if(r.type==="orderedList"){let n=(r.content||[]).map((o,a)=>`${a+1}. ${Te(o.content||[],t+1).trim()}`);e.push(`
|
|
522
524
|
${n.join(`
|
|
523
525
|
`)}
|
|
524
526
|
`)}else if(r.type==="heading"){let n=r.attrs?.level||2;e.push(`
|
|
525
527
|
|
|
526
528
|
${"#".repeat(n)} ${i.trim()}
|
|
527
529
|
|
|
528
|
-
`)}else
|
|
530
|
+
`)}else An.has(r.type)?e.push(`
|
|
529
531
|
|
|
530
532
|
${i}
|
|
531
533
|
`):e.push(i)}return e.join("").replace(/\n{3,}/g,`
|
|
532
534
|
|
|
533
|
-
`)}function
|
|
535
|
+
`)}function Tn(s){return s==null||s===""?"":typeof s=="string"?s.trim():typeof s=="object"&&Array.isArray(s.content)?Te(s.content).trim():""}async function $n(s){let{getSkill:t}=await import("@zibby/agent-workflow"),e=t("jira");if(!e||typeof e.handleToolCall!="function")return null;try{let r=await e.handleToolCall("jira_get_issue",{issueKey:s}),i=JSON.parse(r);if(i?.error)return null;let n=await e.handleToolCall("jira_get_comments",{issueKey:s,maxResults:50}),o=JSON.parse(n);if(o?.error)return null;let a=Tn(i.description),c=[];a&&c.push(a);let d=Array.isArray(o.comments)?o.comments:[];if(d.length>0){let p=d.map(u=>String(u.body||"").trim()).filter(Boolean).join(`
|
|
534
536
|
|
|
535
537
|
`);p&&c.push(p)}let l=c.join(`
|
|
536
538
|
|
|
537
539
|
`).trim();return l?(l.length>Qt&&(l=`${l.slice(0,Qt)}
|
|
538
540
|
|
|
539
|
-
...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:s}):null}catch{return null}}function
|
|
540
|
-
`);j=M.pop();for(let E of M)Y(E)}return b.stdout.on("data",
|
|
541
|
-
Spawn error: ${A.message}`,C(S,"\u274C",`Spawn error: ${A.message}`),f.end(),Vt()}),y._child=b,P.set(d,y),JSON.stringify({runId:d,spec:y.spec,ticketKey:y.ticketKey,status:"running",pid:b.pid,logFile:m})}function er(s){let t=Math.round(((s.endTime||Date.now())-s.startTime)/1e3),e=s.completedNodes||[],r=s.currentNode||null;if(s.status!=="running")return{elapsed:t,stage:s.status,completedNodes:e,currentNode:null};let i;return r?(i=`Actively executing node "${r}"`,e.length&&(i+=` (completed: ${e.join(", ")})`)):e.length?i=`Between nodes (completed: ${e.join(", ")})`:i="Starting up (initializing workflow)",i+=`. Elapsed: ${t}s. This is normal progress \u2014 do not cancel.`,{elapsed:t,stage:"running",currentNode:r,completedNodes:e,progress:i}}function
|
|
542
|
-
${e||""}`.toLowerCase(),n={runId:s?.runId||null,status:s?.status||null,exitCode:s?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return s?.status==="running"||s?.status==="queued"?{...n,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...n,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...n,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...n,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...n,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...n,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:n}function
|
|
541
|
+
...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:s}):null}catch{return null}}function En(s,t){try{let e=JSON.parse(s);return JSON.stringify({...e,...t})}catch{return s}}async function xn(s,t,e){let r={...s},i=String(r.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let n=null;if(Xt.test(i)&&!i.startsWith("inline:")){let l=await $n(i);l&&(i=l.inlineSpec,r.spec=i,String(r.ticketKey||"").trim()||(r.ticketKey=l.issueKey),n=l.issueKey)}let o=String(r.ticketKey||"").trim();if(o){for(let[l,p]of P.entries())if(p?.ticketKey===o&&!(p?.status!=="running"&&p?.status!=="queued"))return JSON.stringify({runId:l,ticketKey:o,status:p.status,reused:!0,message:`A run for ${o} is already ${p.status}. Reusing existing run instead of starting a duplicate.`})}if(!i.startsWith("inline:")){let l=ie(t,i);if(!G(l))return Xt.test(i)?JSON.stringify({error:`Invalid run_test spec: "${i}" is an issue id, not a spec.`,reason:"Jira auto-load was attempted but did not return usable text, or Jira is not configured.",doNext:["Confirm the jira skill is active and authenticated.",'Or call tracker tools yourself, then run_test with spec: "inline:" + steps.'],validExample:{spec:"inline:1. Open https://example.com \u2026 2. Verify \u2026",ticketKey:i},invalidExample:{spec:i,ticketKey:i}}):JSON.stringify({error:`Test spec not found: ${i}`,hint:'If this should be issue steps, load the issue with your tracker tools first, then run_test with spec: "inline:" + steps. Otherwise use a real file path.'})}let a=ir(e?.options?.config);if(Ye()>=a){let l=or(),p=r.ticketKey||l,u={runId:l,spec:r.ticketKey?`${r.ticketKey}: ${r.spec}`:r.spec,ticketKey:r.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};P.set(l,u),Q.push({args:{...r,_queuedRunId:l},cwd:t,context:e}),C(p,"\u23F3",`Queued (${Ye()}/${a} running, ${Q.length} queued)`);let m={runId:l,spec:u.spec,ticketKey:u.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${a} concurrent).`};return n&&(m.resolvedFromJiraIssue=n,m.message+=` (spec built from Jira ${n})`),JSON.stringify(m)}let c=Date.now()-We;c<Yt&&We>0&&await new Promise(l=>setTimeout(l,Yt-c)),We=Date.now();let d=lr(r,t,e);return n?En(d,{resolvedFromJiraIssue:n,message:`Spec was loaded from Jira issue ${n} (description + comments).`}):d}function lr(s,t,e){let{spec:r,ticketKey:i,agent:n,headless:o,workflow:a,_queuedRunId:c}=s,d=c||or(),l=r,p=!1;if(r.startsWith("inline:")){p=!0;let A=Nn(t);Wt(A,{recursive:!0}),l=B(A,`${d}.txt`),kn(l,r.slice(7).trim(),"utf-8")}let u=ie(t,".zibby","output","runs");Wt(u,{recursive:!0});let m=B(u,`${d}.log`),f=Sn(m,{flags:"a"}),_=n&&["assistant","cursor","claude","codex","gemini"].includes(n)?n:null,g=["test",l];_&&g.push("--agent",_),o&&g.push("--headless"),a&&g.push("--workflow",a),nr&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${g.map(A=>/\s/.test(A)?JSON.stringify(A):A).join(" ")} cwd=${t}`);let b=sr("zibby",g,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),y={runId:d,spec:i?`${i}: ${r}`:r,ticketKey:i||null,specPath:l,logPath:m,isInline:p,pid:b.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},S=i||d,j="";function Y(A){let O=ar(A).trim();if(!O)return;if(O.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let E=JSON.parse(O.slice(22));E.phase==="node_begin"?y.currentNode=E.node:E.phase==="node_end"&&(E.node&&!y.completedNodes.includes(E.node)&&y.completedNodes.push(E.node),y.currentNode===E.node&&(y.currentNode=null))}catch{}return}let M=O.match(/Session\s+(\S+)/);if(M&&!y.sessionId&&(y.sessionId=M[1],y.sessionPath=ie(t,Ve,Ze,y.sessionId)),O.startsWith("\u250C ")||O.startsWith("\u250C ")){let E=O.slice(2).trim();y.currentNode=E,je&&C(S,"\u25B6",`${E}`)}else if(O.startsWith("\u2514 ")||O.startsWith("\u2514 ")){let E=O.slice(2).trim();E.startsWith("done")?(y.currentNode&&!y.completedNodes.includes(y.currentNode)&&y.completedNodes.push(y.currentNode),je&&C(S,"\u2714",`${y.currentNode||"node"} done ${E.replace("done","").trim()}`),y.currentNode=null):E.startsWith("failed")&&(je&&C(S,"\u2718",`${y.currentNode||"node"} failed ${E.replace("failed","").trim()}`),y.currentNode=null)}else O.includes("Workflow completed")&&(y.currentNode=null,je&&C(S,"\u2714",`Workflow completed (${Zt(Date.now()-y.startTime)})`))}function Be(A){let O=A.toString();y.output+=O,f.write(O),y.output.length>5e4&&(y.output=y.output.slice(-3e4)),j+=O;let M=j.split(`
|
|
542
|
+
`);j=M.pop();for(let E of M)Y(E)}return b.stdout.on("data",Be),b.stderr.on("data",A=>{let O=A.toString();y.error+=O,f.write(O),y.error.length>2e4&&(y.error=y.error.slice(-1e4))}),b.on("close",A=>{y.status=A===0?"passed":"failed",y.exitCode=A,y.endTime=Date.now(),j&&Y(j),f.end();let O=Zt(Date.now()-y.startTime);if(A===0?C(S,"\u2705",`Passed (${O})`):C(S,"\u274C",`Failed (${O})`),y.isInline)try{wn(y.specPath)}catch{}Vt()}),b.on("error",A=>{y.status="error",y.error+=`
|
|
543
|
+
Spawn error: ${A.message}`,C(S,"\u274C",`Spawn error: ${A.message}`),f.end(),Vt()}),y._child=b,P.set(d,y),JSON.stringify({runId:d,spec:y.spec,ticketKey:y.ticketKey,status:"running",pid:b.pid,logFile:m})}function er(s){let t=Math.round(((s.endTime||Date.now())-s.startTime)/1e3),e=s.completedNodes||[],r=s.currentNode||null;if(s.status!=="running")return{elapsed:t,stage:s.status,completedNodes:e,currentNode:null};let i;return r?(i=`Actively executing node "${r}"`,e.length&&(i+=` (completed: ${e.join(", ")})`)):e.length?i=`Between nodes (completed: ${e.join(", ")})`:i="Starting up (initializing workflow)",i+=`. Elapsed: ${t}s. This is normal progress \u2014 do not cancel.`,{elapsed:t,stage:"running",currentNode:r,completedNodes:e,progress:i}}function Ln(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[...P.entries()].map(([l,p])=>{let u=er(p),m={runId:l,spec:p.spec,ticketKey:p.ticketKey,status:p.status,elapsed:u.elapsed,exitCode:p.exitCode,sessionId:p.sessionId||null};return p.status==="running"?(m.currentNode=u.currentNode,m.completedNodes=u.completedNodes,m.progress=u.progress):m.outputTail=p.output.slice(-500),m}),o=n.filter(l=>l.status==="running").length,a=n.filter(l=>l.status==="passed").length,c=n.filter(l=>l.status==="failed").length,d={total:n.length,running:o,passed:a,failed:c,runs:n};return o>0&&(d._hint="All running tests are progressing normally through their workflow nodes. Do NOT cancel, diagnose, or interpret as stuck. Just tell the user they are still running."),JSON.stringify(d)}let e=P.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let r=er(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:r.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=r.currentNode,i.completedNodes=r.completedNodes,i.progress=r.progress):(i.outputTail=e.output.slice(-1e3),i.errorTail=e.error.slice(-500)),e.status==="running"&&(i._hint="This run is actively progressing. Do NOT cancel, diagnose, or assume stuck. Just tell the user it is still running."),JSON.stringify(i)}function tr(s,t){if(t.status==="queued"){let e=Q.findIndex(r=>r.args._queuedRunId===s);return e>=0&&Q.splice(e,1),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}if(t.status!=="running")return{ok:!1,runId:s,error:`Run is not active (status: ${t.status})`};try{return t._child.kill("SIGTERM"),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}catch(e){return{ok:!1,runId:s,error:`Failed to cancel: ${e.message}`}}}function Cn(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let r=[];for(let[i,n]of P.entries())(n.status==="running"||n.status==="queued")&&r.push(tr(i,n));return r.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:r.length,results:r})}let e=P.get(t);return JSON.stringify(e?tr(t,e):{error:`Run not found: ${t}`})}function Pn(s,t){let e=P.get(s);if(e?.sessionPath&&G(e.sessionPath))return e.sessionPath;if(e?.sessionId){let r=ie(t,Ve,Ze,e.sessionId);if(G(r))return r}return null}function dr(s,t=""){let e=[];if(!G(s))return e;for(let r of Ee(s,{withFileTypes:!0})){let i=t?`${t}/${r.name}`:r.name;if(r.isDirectory())e.push(...dr(B(s,r.name),i));else{let n=vn(B(s,r.name));e.push({path:i,size:n.size})}}return e}function rr(s){if(!G(s))return null;try{return JSON.parse($e(s,"utf-8"))}catch{return null}}function pr(s,t=2e3){if(!s||!G(s))return"";try{return $e(s,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function qn({run:s,logTail:t,errorTail:e}){let i=`${t||""}
|
|
544
|
+
${e||""}`.toLowerCase(),n={runId:s?.runId||null,status:s?.status||null,exitCode:s?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return s?.status==="running"||s?.status==="queued"?{...n,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...n,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...n,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...n,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...n,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...n,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:n}function Jn(s,t){let{runId:e,type:r,node:i="execute_live",query:n,tail:o=3e3}=s;if(r==="search"){if(!n)return JSON.stringify({error:'query is required for type="search"'});let c=ie(t,Ve,Ze);if(!G(c))return JSON.stringify({matches:[],message:"No sessions found"});let d=[],l=n.toLowerCase();for(let p of Ee(c,{withFileTypes:!0})){if(!p.isDirectory())continue;let u=B(c,p.name),m=[{file:"execute_live/result.json",label:"result"},{file:"execute_live/events.json",label:"events"},{file:"execute_live/raw_stream_output.txt",label:"log"},{file:"generate_script/raw_stream_output.txt",label:"script_log"},{file:"title.txt",label:"title"}];for(let{file:f,label:h}of m){let _=B(u,f);if(G(_))try{let g=$e(_,"utf-8");if(g.toLowerCase().includes(l)){let b=g.toLowerCase().indexOf(l),y=Math.max(0,b-100),S=Math.min(g.length,b+n.length+100);d.push({sessionId:p.name,artifact:h,snippet:g.slice(y,S)})}}catch{}}if(d.length>=20)break}return JSON.stringify({query:n,matches:d,total:d.length})}if(!e)return JSON.stringify({error:"runId is required for this type"});if(r==="log"){let c=P.get(e),d=pr(c?.logPath,o);if(d)return JSON.stringify({runId:e,source:"run-log",totalLength:d.length,tail:d})}let a=Pn(e,t);if(!a)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(r){case"list":{let c=dr(a);return JSON.stringify({sessionId:a.split("/").pop(),files:c,total:c.length})}case"result":{let c=rr(B(a,i,"result.json"));return JSON.stringify(c?{sessionId:a.split("/").pop(),node:i,result:c}:{error:`No result.json found in ${i}`})}case"events":{let c=rr(B(a,i,"events.json"));if(!c)return JSON.stringify({error:`No events.json found in ${i}`});let d=Array.isArray(c)?c:c.events||[];return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalEvents:d.length,events:d.slice(-50)})}case"log":{let c=B(a,i,"raw_stream_output.txt");if(!G(c))return JSON.stringify({error:`No log found in ${i}`});let d=$e(c,"utf-8");return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalLength:d.length,tail:d.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${r}. Use: list, result, events, log, search`})}}function Un(s,t){let e=String(s?.runId||"all"),r=Number(s?.tail||2e3),i=e==="all"?[...P.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let n=i.map(c=>{let d=P.get(c);if(!d)return{runId:c,error:`Run not found: ${c}`};let l=pr(d.logPath,r),p=String(d.error||"").slice(-Math.max(200,r));return{...qn({run:d,logTail:l,errorTail:p}),ticketKey:d.ticketKey||null,spec:d.spec,logTail:l,errorTail:p}}),o=n.filter(c=>c.status==="failed"||c.status==="error"),a=n.filter(c=>c.status==="running"||c.status==="queued");return JSON.stringify({total:n.length,failed:o.length,active:a.length,diagnoses:n})}function Mn(s,t){let e=s?.directory||"test-specs",r=ie(t,e);if(!G(r))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let n=function(o,a){for(let c of Ee(o,{withFileTypes:!0})){let d=a?`${a}/${c.name}`:c.name;c.isDirectory()?n(B(o,c.name),d):(c.name.endsWith(".txt")||c.name.endsWith(".md"))&&i.push(d)}},i=[];return n(r,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}import{spawn as Dn}from"child_process";import{existsSync as F,mkdirSync as Bn,readdirSync as ur,statSync as Kn,readFileSync as Gn}from"fs";import{resolve as Xe,join as H,basename as Fn}from"path";var et=".zibby/repos";function xe(s,t,e={}){return new Promise((r,i)=>{let n=Dn(s,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",a="";n.stdout.on("data",c=>{o+=c.toString()}),n.stderr.on("data",c=>{a+=c.toString()}),n.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):r(o.trim())}),n.on("error",c=>i(c))})}var X={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],promptFragment:`## Git Repositories
|
|
543
545
|
You can clone and explore git repositories locally for codebase analysis:
|
|
544
546
|
- git_checkout: Clone a repo (or pull if already cloned). Supports GitHub and GitLab with auto-auth.
|
|
545
547
|
- git_list_repos: List locally cloned repos
|
|
@@ -550,7 +552,7 @@ When a test ticket lacks context, use this workflow:
|
|
|
550
552
|
2. Use git_explore to understand the project structure
|
|
551
553
|
3. Use shell commands (grep, cat) to read specific files for deeper understanding
|
|
552
554
|
4. Use GitHub/GitLab skills to read related PRs and commits
|
|
553
|
-
5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"git_checkout":return await
|
|
555
|
+
5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"git_checkout":return await Hn(t,r);case"git_list_repos":return zn(t,r);case"git_explore":return Wn(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"git_checkout",description:"Clone a git repository locally (or pull latest if already cloned). Auto-authenticates with GitHub/GitLab tokens if available.",input_schema:{type:"object",properties:{url:{type:"string",description:'Repository URL (e.g. "https://github.com/org/repo" or "org/repo" shorthand for GitHub)'},branch:{type:"string",description:"Branch to checkout (default: repo default branch)"},shallow:{type:"boolean",description:"Shallow clone with depth 1 (default: true, faster)"},name:{type:"string",description:"Local directory name override (default: repo name from URL)"}},required:["url"]}},{name:"git_list_repos",description:"List locally cloned repositories",input_schema:{type:"object",properties:{}}},{name:"git_explore",description:"Quick structural overview of a cloned repo: key files, package.json info, directory tree (top 2 levels), detected framework/language",input_schema:{type:"object",properties:{repo:{type:"string",description:"Repo name (as listed by git_list_repos)"},depth:{type:"number",description:"Directory tree depth (default: 2)"}},required:["repo"]}}]};async function Hn(s,t){let{url:e,branch:r,shallow:i=!0,name:n}=s;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=n||Fn(e.replace(/\.git$/,"")),a=Xe(t,et);Bn(a,{recursive:!0});let c=H(a,o),d=e,l=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,u=process.env.GITLAB_URL;if(e.includes("github.com")&&l)d=e.replace("https://github.com",`https://x-access-token:${l}@github.com`);else if(p&&u)try{let h=new URL(u).host;e.includes(h)&&(d=e.replace(`https://${h}`,`https://oauth2:${p}@${h}`))}catch{}if(F(H(c,".git"))){let h=r?`git -C "${c}" fetch origin ${r} && git -C "${c}" checkout ${r} && git -C "${c}" pull origin ${r}`:`git -C "${c}" pull`;await xe(h,t);let _=await xe(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:c,branch:r||"default",head:_})}let m=["git","clone"];i&&m.push("--depth","1"),r&&m.push("--branch",r),m.push(`"${d}"`,`"${c}"`),await xe(m.join(" "),t);let f=await xe(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:c,branch:r||"default",shallow:i,head:f})}function zn(s,t){let e=Xe(t,et);if(!F(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let r=[];for(let i of ur(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let n=H(e,i.name);if(!F(H(n,".git")))continue;let o=Kn(n);r.push({name:i.name,path:n,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:r,total:r.length,directory:e})}function Wn(s,t){let{repo:e,depth:r=2}=s,i=Xe(t,et,e);if(!F(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let n={repo:e,path:i},o=H(i,"package.json");if(F(o))try{let m=JSON.parse(Gn(o,"utf-8"));n.packageJson={name:m.name,version:m.version,scripts:m.scripts?Object.keys(m.scripts):[],dependencies:m.dependencies?Object.keys(m.dependencies).slice(0,30):[],devDependencies:m.devDependencies?Object.keys(m.devDependencies).slice(0,20):[]},m.dependencies?.react?n.framework="React":m.dependencies?.next?n.framework="Next.js":m.dependencies?.vue?n.framework="Vue":m.dependencies?.angular?n.framework="Angular":m.dependencies?.express?n.framework="Express":m.dependencies?.fastify&&(n.framework="Fastify")}catch{}let a=H(i,"pyproject.toml");F(a)&&(n.language="Python");let c=H(i,"go.mod");F(c)&&(n.language="Go");let d=H(i,"Cargo.toml");F(d)&&(n.language="Rust"),F(o)&&(n.language=n.language||"JavaScript/TypeScript");let l=[];function p(m,f,h){if(h>r)return;let _;try{_=ur(m,{withFileTypes:!0})}catch{return}let g=_.filter(b=>!b.name.startsWith(".")&&b.name!=="node_modules"&&b.name!=="__pycache__"&&b.name!=="dist"&&b.name!=="build"&&b.name!==".git").sort((b,y)=>b.isDirectory()!==y.isDirectory()?b.isDirectory()?-1:1:b.name.localeCompare(y.name));for(let b of g){let y=b.isDirectory();l.push(`${f}${y?"\u{1F4C1}":"\u{1F4C4}"} ${b.name}`),y&&h<r&&p(H(m,b.name),`${f} `,h+1)}}p(i,"",1),n.tree=l.slice(0,80),l.length>80&&(n.treeTruncated=!0);let u=["README.md","README.rst","src/App.tsx","src/App.jsx","src/App.js","src/routes.tsx","src/routes.js","app/routes.tsx","app/routes.js","src/index.tsx","src/index.ts","src/main.tsx","src/main.ts","pages/_app.tsx","pages/_app.js","app/layout.tsx","docker-compose.yml","Dockerfile",".env.example"];return n.keyFilesFound=u.filter(m=>F(H(i,m))),JSON.stringify(n)}function mr(s){let t=(s||"").match(/github\.com[/:]([^/]+)\/([^/]+?)(?:\.git)?$/);return t?{provider:"github",owner:t[1],repo:t[2]}:(t=(s||"").match(/gitlab\.com[/:](.+?)\/([^/]+?)(?:\.git)?$/),t?{provider:"gitlab",owner:t[1],repo:t[2]}:null)}var fr={...X,id:"git-write",envKeys:[...X.envKeys||[],...ae.envKeys||[],...ce.envKeys||[]].filter((s,t,e)=>e.indexOf(s)===t),promptFragment:`${X.promptFragment}
|
|
554
556
|
|
|
555
557
|
## Opening a pull request / merge request (git_open_pr)
|
|
556
558
|
After you have pushed a branch, OPEN the PR/MR with the provider-agnostic tool:
|
|
@@ -562,7 +564,7 @@ After you have pushed a branch, OPEN the PR/MR with the provider-agnostic tool:
|
|
|
562
564
|
To MERGE an open PR/MR, use the provider-agnostic tool:
|
|
563
565
|
- git_merge_pr: Merge a pull request (GitHub) or accept a merge request (GitLab) by number. Provider is auto-detected from \`repoUrl\`. Args:
|
|
564
566
|
{ repoUrl, number (the PR/MR number; GitLab alias: iid), mergeMethod? ('merge'|'squash'|'rebase', GitHub only; default 'squash') }
|
|
565
|
-
Returns { success:true, merged:true, sha } with the REAL merge SHA from the provider. Expected non-mergeable states (draft, failing checks, conflicts, head sha moved, pipeline not done) come back as { success:false, skippedReason } \u2014 a normal "not mergeable yet", not a hard failure.`,async handleToolCall(s,t,e){if(s!=="git_open_pr"&&s!=="git_merge_pr")return X.handleToolCall(s,t,e);try{let r=t||{},i=r.repoUrl||r.repo_url||r.url;if(!i)return JSON.stringify({error:"repoUrl is required (the github.com/gitlab.com repo to open/merge the PR/MR against)"});if(s==="git_merge_pr"){let l=r.number??r.iid??r.prNumber;if(l==null)return JSON.stringify({error:"number (the PR/MR number to merge; GitLab alias: iid) is required"});let p=mr(i);return p?p.provider==="github"?ae.handleToolCall("github_merge_pr",{owner:p.owner,repo:p.repo,number:l,mergeMethod:r.mergeMethod},e):ce.handleToolCall("gitlab_accept_mr",{project:`${p.owner}/${p.repo}`,iid:l},e):JSON.stringify({success:!1,skippedReason:`Unrecognized repo host: ${i}. git_merge_pr supports github.com and gitlab.com.`})}let n=r.head||r.source_branch||r.sourceBranch||r.branch,o=r.base||r.target_branch||r.targetBranch,{title:a,body:c}=r;if(!n||!a)return JSON.stringify({error:"head (the pushed source branch) and title are required"});let d=mr(i);return d?d.provider==="github"?ae.handleToolCall("github_create_pr",{owner:d.owner,repo:d.repo,head:n,base:o,title:a,body:c},e):ce.handleToolCall("gitlab_create_mr",{project:`${d.owner}/${d.repo}`,source_branch:n,target_branch:o,title:a,description:c},e):JSON.stringify({success:!1,skippedReason:`Unrecognized repo host: ${i}. git_open_pr supports github.com and gitlab.com.`})}catch(r){return JSON.stringify({error:r.message})}},tools:[...X.tools||[],{name:"git_open_pr",description:"Open a pull request (GitHub) or merge request (GitLab) from an already-pushed branch. The provider is auto-detected from repoUrl. Returns the REAL provider-returned url (pr_url = GitHub html_url / GitLab web_url) \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR/MR already exists, base==head) return { success:false, skippedReason } rather than erroring. Delegates to the github/gitlab provider APIs (the same auth path the github_*/gitlab_* tools use).",input_schema:{type:"object",properties:{repoUrl:{type:"string",description:'The repo URL the PR/MR is opened against (e.g. "https://github.com/org/repo" or "https://gitlab.com/group/repo"). Provider is detected from the host.'},head:{type:"string",description:"Source branch to merge FROM (must already be pushed). GitLab alias: source_branch."},base:{type:"string",description:"Target branch to merge INTO (default: the repo/project default branch). GitLab alias: target_branch."},title:{type:"string",description:"PR/MR title"},body:{type:"string",description:"PR/MR description (markdown)"}},required:["repoUrl","head","title"]}},{name:"git_merge_pr",description:"Merge a pull request (GitHub) or accept a merge request (GitLab) by number. The provider is auto-detected from repoUrl. Returns { success:true, merged:true, sha } with the REAL merge SHA from the provider \u2014 never fabricate it. Expected non-mergeable states (draft, failing checks, conflicts, head sha moved, pipeline not done) return { success:false, skippedReason } rather than erroring. Delegates to the github/gitlab provider APIs (the same auth path the github_*/gitlab_* tools use).",input_schema:{type:"object",properties:{repoUrl:{type:"string",description:'The repo URL the PR/MR belongs to (e.g. "https://github.com/org/repo" or "https://gitlab.com/group/repo"). Provider is detected from the host.'},number:{type:"number",description:"The PR (GitHub) / MR (GitLab) number to merge. GitLab alias: iid."},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (GitHub only; default: squash). Ignored for GitLab."}},required:["repoUrl","number"]}}]};import{execFileSync as br}from"child_process";import{existsSync as
|
|
567
|
+
Returns { success:true, merged:true, sha } with the REAL merge SHA from the provider. Expected non-mergeable states (draft, failing checks, conflicts, head sha moved, pipeline not done) come back as { success:false, skippedReason } \u2014 a normal "not mergeable yet", not a hard failure.`,async handleToolCall(s,t,e){if(s!=="git_open_pr"&&s!=="git_merge_pr")return X.handleToolCall(s,t,e);try{let r=t||{},i=r.repoUrl||r.repo_url||r.url;if(!i)return JSON.stringify({error:"repoUrl is required (the github.com/gitlab.com repo to open/merge the PR/MR against)"});if(s==="git_merge_pr"){let l=r.number??r.iid??r.prNumber;if(l==null)return JSON.stringify({error:"number (the PR/MR number to merge; GitLab alias: iid) is required"});let p=mr(i);return p?p.provider==="github"?ae.handleToolCall("github_merge_pr",{owner:p.owner,repo:p.repo,number:l,mergeMethod:r.mergeMethod},e):ce.handleToolCall("gitlab_accept_mr",{project:`${p.owner}/${p.repo}`,iid:l},e):JSON.stringify({success:!1,skippedReason:`Unrecognized repo host: ${i}. git_merge_pr supports github.com and gitlab.com.`})}let n=r.head||r.source_branch||r.sourceBranch||r.branch,o=r.base||r.target_branch||r.targetBranch,{title:a,body:c}=r;if(!n||!a)return JSON.stringify({error:"head (the pushed source branch) and title are required"});let d=mr(i);return d?d.provider==="github"?ae.handleToolCall("github_create_pr",{owner:d.owner,repo:d.repo,head:n,base:o,title:a,body:c},e):ce.handleToolCall("gitlab_create_mr",{project:`${d.owner}/${d.repo}`,source_branch:n,target_branch:o,title:a,description:c},e):JSON.stringify({success:!1,skippedReason:`Unrecognized repo host: ${i}. git_open_pr supports github.com and gitlab.com.`})}catch(r){return JSON.stringify({error:r.message})}},tools:[...X.tools||[],{name:"git_open_pr",description:"Open a pull request (GitHub) or merge request (GitLab) from an already-pushed branch. The provider is auto-detected from repoUrl. Returns the REAL provider-returned url (pr_url = GitHub html_url / GitLab web_url) \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR/MR already exists, base==head) return { success:false, skippedReason } rather than erroring. Delegates to the github/gitlab provider APIs (the same auth path the github_*/gitlab_* tools use).",input_schema:{type:"object",properties:{repoUrl:{type:"string",description:'The repo URL the PR/MR is opened against (e.g. "https://github.com/org/repo" or "https://gitlab.com/group/repo"). Provider is detected from the host.'},head:{type:"string",description:"Source branch to merge FROM (must already be pushed). GitLab alias: source_branch."},base:{type:"string",description:"Target branch to merge INTO (default: the repo/project default branch). GitLab alias: target_branch."},title:{type:"string",description:"PR/MR title"},body:{type:"string",description:"PR/MR description (markdown)"}},required:["repoUrl","head","title"]}},{name:"git_merge_pr",description:"Merge a pull request (GitHub) or accept a merge request (GitLab) by number. The provider is auto-detected from repoUrl. Returns { success:true, merged:true, sha } with the REAL merge SHA from the provider \u2014 never fabricate it. Expected non-mergeable states (draft, failing checks, conflicts, head sha moved, pipeline not done) return { success:false, skippedReason } rather than erroring. Delegates to the github/gitlab provider APIs (the same auth path the github_*/gitlab_* tools use).",input_schema:{type:"object",properties:{repoUrl:{type:"string",description:'The repo URL the PR/MR belongs to (e.g. "https://github.com/org/repo" or "https://gitlab.com/group/repo"). Provider is detected from the host.'},number:{type:"number",description:"The PR (GitHub) / MR (GitLab) number to merge. GitLab alias: iid."},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (GitHub only; default: squash). Ignored for GitLab."}},required:["repoUrl","number"]}}]};import{execFileSync as br}from"child_process";import{existsSync as ot,mkdirSync as kr}from"fs";import{join as z,basename as Yn}from"path";import{randomBytes as Zn}from"crypto";import{pathToFileURL as _e}from"url";import{createRequire as wr}from"module";var st=".zibby/memory",Sr="dolt",vr={encoding:"utf-8",stdio:["pipe","pipe","pipe"],timeout:15e3},it="mem0",tt=new Map,Le=new Map,Ce=!1,Vn=wr(import.meta.url),Ue=()=>Zn(8).toString("hex"),ne=()=>new Date().toISOString(),Qn=[`CREATE TABLE IF NOT EXISTS chat_memory (
|
|
566
568
|
id VARCHAR(64) PRIMARY KEY,
|
|
567
569
|
memory_key VARCHAR(160),
|
|
568
570
|
category VARCHAR(32) NOT NULL,
|
|
@@ -593,10 +595,10 @@ To MERGE an open PR/MR, use the provider-agnostic tool:
|
|
|
593
595
|
tasks_failed INT DEFAULT 0,
|
|
594
596
|
key_facts TEXT,
|
|
595
597
|
created_at VARCHAR(32) NOT NULL
|
|
596
|
-
)`],hr=new Set;function q(s,t){return br(Sr,t,{...vr,cwd:s})}function ee(s,t){try{let e=q(s,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function J(s,t){q(s,["sql","-q",t])}function
|
|
597
|
-
`)};`;J(s,t);try{J(s,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{J(s,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return hr.add(s),!0}function
|
|
598
|
+
)`],hr=new Set;function q(s,t){return br(Sr,t,{...vr,cwd:s})}function ee(s,t){try{let e=q(s,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function J(s,t){q(s,["sql","-q",t])}function Pe(s){if(hr.has(s))return!0;if(!ot(z(s,".dolt"))){if(!Xn())return!1;kr(s,{recursive:!0}),q(s,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let t=`${Qn.join(`;
|
|
599
|
+
`)};`;J(s,t);try{J(s,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{J(s,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return hr.add(s),!0}function Xn(){try{return br(Sr,["version"],{...vr,timeout:5e3}),!0}catch{return!1}}function w(s){return s==null?"NULL":`'${String(s).replace(/'/g,"''")}'`}function nt(s){return String(s||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function le(s){return s==="long"?3:s==="mid"?2:s==="short"?1:0}function at(s,t){let e=["short","mid","long"].includes(s)?s:"mid";return new Set(["fact","decision","preference","credential","url","workaround"]).has(String(t||"").toLowerCase())&&e==="short"?"mid":e}function Nr(s){let t=new Map;for(let e of s||[]){let r=nt(e.content),i=e.memory_key?`key:${e.memory_key}`:r?`norm:${r}`:"";if(!i)continue;let n=t.get(i);if(!n){t.set(i,e);continue}let o=le(n.tier),a=le(e.tier);if(a>o){t.set(i,e);continue}a===o&&Number(e.relevance||0)>Number(n.relevance||0)&&t.set(i,e)}return[...t.values()]}function Je(s,t){let e=String(s??"");return e.length<=t?e:t<=1?e.slice(0,t):`${e.slice(0,t-1)}\u2026`}function ge(s,t){let e={recentSessions:Array.isArray(s?.recentSessions)?s.recentSessions:[],topMemories:Array.isArray(s?.topMemories)?s.topMemories:[],taskStats:Array.isArray(s?.taskStats)?s.taskStats:[],ticketFilter:s?.ticketFilter||null,backend:t||String(s?.backend||it),error:s?.error||null};return e.backend==="mem0"?{...e,recentSessions:[],taskStats:[]}:e}function yr(s){let t=[];if(s.recentSessions?.length>0){t.push("Recent sessions:");for(let e of s.recentSessions.slice(0,3))e?.summary?.trim()&&t.push(`- ${Je(e.summary,150)}${e.tickets?` [${e.tickets}]`:""}`)}if(s.topMemories?.length>0){t.push("Known facts:");for(let e of s.topMemories.slice(0,10)){let r=e.tier==="long"?"\u2605":"\xB7";t.push(`${r} [${e.category}] ${Je(e.content,120)}`)}}return t.length===0?"":`## Memory Context
|
|
598
600
|
${t.join(`
|
|
599
|
-
`)}`}function
|
|
601
|
+
`)}`}function qe(s){return{backend:s.backend,recentSessions:s.recentSessions.slice(0,3).map(t=>({summary:Je(String(t?.summary||""),160),tickets:t?.tickets||null,created_at:t?.created_at||null})),topMemories:s.topMemories.slice(0,8).map(t=>({category:t?.category||null,tier:t?.tier||null,content:Je(String(t?.content||""),140),source:t?.source||null})),taskStats:s.taskStats,error:s.error||null}}async function eo(s,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let r=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(r==="mem0"||r==="dolt")return r;if(Le.has(s))return Le.get(s);try{let i=z(s,".zibby.config.mjs");if(ot(i)){let n=await import(_e(i).href),o=String(n?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Le.set(s,o),o}}catch{}return Le.set(s,it),it}function Ir(s){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${Yn(s||process.cwd())}`}var to="mem0";function Or(s){let t=z(s,st,to);return{dir:t,vectorDbPath:z(t,"vectors.db"),historyDbPath:z(t,"history.db")}}function ro(s){let t=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),r=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),i=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),n=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:a}=Or(s||process.cwd());return{llm:{provider:"openai",config:{model:r,baseURL:t,...e?{apiKey:e}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:n,baseURL:t,...e?{apiKey:e}:{}}},vectorStore:{provider:"memory",config:{dimension:n,dbPath:o}},historyDbPath:a}}async function Rr(s){let t=s||process.cwd();if(tt.has(t))return tt.get(t);let e;try{let a=wr(_e(z(t,"package.json")).href).resolve("mem0ai/oss");e=await import(_e(a).href)}catch{try{let o=Vn.resolve("mem0ai/oss");e=await import(_e(o).href)}catch(o){throw new Error(`Cannot find package 'mem0ai' for workspace "${t}". Install in that project: npm install mem0ai. (${o.message})`,{cause:o})}}let r=e?.Memory;if(!r)throw new Error("mem0ai/oss does not export Memory");let i=ro(t);if(i)try{kr(Or(t).dir,{recursive:!0})}catch{}let n=i?new r(i):new r;return tt.set(t,n),n}function gr(s,t="mid"){return(Array.isArray(s)?s:Array.isArray(s?.results)?s.results:[]).map(r=>({id:r?.id||Ue(),memory_key:r?.metadata?.memoryKey||r?.metadata?.memory_key||null,category:r?.metadata?.category||"fact",content:r?.memory||r?.content||"",source:r?.metadata?.source||"mem0",ticket_key:r?.metadata?.ticketKey||r?.metadata?.ticket_key||null,tier:at(r?.metadata?.tier||t,r?.metadata?.category||"fact"),relevance:Number(r?.score??r?.metadata?.relevance??.8),created_at:r?.created_at||r?.metadata?.created_at||ne()})).filter(r=>String(r.content||"").trim().length>0)}var de={id:"dolt",store:(s,t)=>jr(s,t),recall:(s,t)=>co(s,t),brief:(s,t)=>lo(s,t),endSession:(s,t)=>$r(s,t),logTask:(s,t)=>Er(s,t),taskHistory:(s,t)=>xr(s,t)},so={id:"mem0",store:(s,t,e)=>ao(s,t,e),recall:(s,t,e)=>Tr(s,t,e),brief:(s,t,e)=>po(s,t,e),endSession:(s,t)=>$r(s,t),logTask:(s,t)=>Er(s,t),taskHistory:(s,t)=>xr(s,t)},io={dolt:de,mem0:so};async function _r(s,t){let e=await eo(s,t);return io[e]||de}var Ar={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
|
|
600
602
|
You have persistent memory across sessions. Use it to avoid losing context:
|
|
601
603
|
- **memory_store**: Save important facts, decisions, or context. Anything worth remembering.
|
|
602
604
|
- **memory_recall**: Search your memory by keyword or category. Use this at the START of conversations to recall relevant context.
|
|
@@ -612,9 +614,9 @@ You have persistent memory across sessions. Use it to avoid losing context:
|
|
|
612
614
|
- When the user's request is complete: call memory_end_session
|
|
613
615
|
|
|
614
616
|
### Categories for memory_store
|
|
615
|
-
fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(s,t={}){let e=s?.options?.workspace||process.cwd(),r=z(e,
|
|
616
|
-
`)}catch{}}try{let d=await de.brief(t,r,e),l=JSON.parse(d||"{}"),p=ge({...l,backend:"dolt"},"dolt");return{backend:"dolt",brief:p,promptContext:yr(p),debugPreview:
|
|
617
|
-
`)}catch{}}try{return await c(de)}catch(l){return JSON.stringify({error:l.message,backend:"dolt",degradedFrom:"mem0"})}}return JSON.stringify({error:`mem0 unavailable (${d.message}); dolt fallback also unavailable`,backend:"mem0"})}return JSON.stringify({error:d.message})}},tools:[{name:"memory_store",description:"Save a fact, decision, or context to persistent memory. Survives across sessions.",input_schema:{type:"object",properties:{memoryKey:{type:"string",description:"Stable semantic identity key (e.g. user.jira.default_board)"},content:{type:"string",description:"The information to remember"},category:{type:"string",enum:["fact","decision","context","insight","preference","credential","url","error","workaround"],description:"Category of memory"},tier:{type:"string",enum:["short","mid","long"],description:"Memory tier: short (session/24h), mid (days/weeks), long (permanent)"},source:{type:"string",description:'Where this info came from (e.g. "jira", "github", "user", "test_run")'},ticketKey:{type:"string",description:"Related ticket key (optional)"},infer:{type:"boolean",description:"true = LLM distills/dedupes facts (costs tokens); false = store raw, embed-only, free",default:!1}},required:["content","category"]}},{name:"memory_recall",description:"Search persistent memory by keyword, category, ticket, or tier. Returns matching facts and context.",input_schema:{type:"object",properties:{query:{type:"string",description:"Search text (matches content)"},category:{type:"string",description:"Filter by category"},ticketKey:{type:"string",description:"Filter by ticket key"},tier:{type:"string",enum:["short","mid","long"],description:"Filter by memory tier"},limit:{type:"number",description:"Max results (default: 20)"}}}},{name:"memory_brief",description:"Get a compact briefing: recent session summaries + top relevant facts. Call at the start of a conversation.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Focus briefing on a specific ticket (optional)"}}}},{name:"memory_end_session",description:"End the current session and save a summary for future recall. Call when a task is complete.",input_schema:{type:"object",properties:{summary:{type:"string",description:"What happened in this session (1-3 sentences)"},tickets:{type:"string",description:"Comma-separated ticket keys covered"},tasksRun:{type:"number",description:"Number of tasks/tests run"},tasksPassed:{type:"number",description:"Number passed"},tasksFailed:{type:"number",description:"Number failed"},keyFacts:{type:"string",description:"Key facts worth remembering from this session (semicolon-separated)"}},required:["summary"]}},{name:"task_log",description:"Record a completed task (test run, analysis, generation) to persistent history.",input_schema:{type:"object",properties:{title:{type:"string",description:"Task description"},type:{type:"string",enum:["test_run","generate","analysis","research","other"],description:"Task type"},status:{type:"string",enum:["passed","failed","cancelled","error"],description:"Outcome"},ticketKey:{type:"string",description:"Related ticket key"},specPath:{type:"string",description:"Spec file path (if test run)"},resultSummary:{type:"string",description:"Brief result description"}},required:["title","type","status"]}},{name:"task_history",description:"Query past tasks by ticket, status, or type. See what was done before.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Filter by ticket key"},type:{type:"string",description:"Filter by task type"},status:{type:"string",description:"Filter by status"},limit:{type:"number",description:"Max results (default: 20)"}}}}]};function jr(s,t){let{content:e,category:r,source:i,ticketKey:n,tier:o,memoryKey:a}=s;if(!e||!r)return JSON.stringify({error:"content and category are required"});let c=
|
|
617
|
+
fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(s,t={}){let e=s?.options?.workspace||process.cwd(),r=z(e,st),i=await _r(e,s),n=i.id;if(n==="dolt"&&!Pe(r)){let o="Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation";return{backend:n,brief:ge({backend:n,error:o},n),promptContext:"",debugPreview:qe(ge({backend:n,error:o},n)),error:o}}try{let o=await i.brief(t,r,e),a=JSON.parse(o||"{}"),c=ge({...a,backend:n},n);return{backend:n,brief:c,promptContext:yr(c),debugPreview:qe(c),error:c.error||null}}catch(o){if(n==="mem0"&&i!==de&&Pe(r)){if(!Ce){Ce=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${o?.message||o}); degrading to dolt for this run
|
|
618
|
+
`)}catch{}}try{let d=await de.brief(t,r,e),l=JSON.parse(d||"{}"),p=ge({...l,backend:"dolt"},"dolt");return{backend:"dolt",brief:p,promptContext:yr(p),debugPreview:qe(p),error:p.error||null,degradedFrom:"mem0"}}catch{}}let a=String(o?.message||o),c=ge({backend:n,error:a},n);return{backend:n,brief:c,promptContext:"",debugPreview:qe(c),error:a}}},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd(),i=z(r,st),n=await _r(r,e),o=n.id;if((o==="dolt"||["memory_end_session","task_log","task_history"].includes(s))&&!Pe(i))return JSON.stringify({error:"Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation"});let c=d=>{switch(s){case"memory_store":return d.store(t,i,r);case"memory_recall":return d.recall(t,i,r);case"memory_brief":return d.brief(t,i,r);case"memory_end_session":return d.endSession(t,i,r);case"task_log":return d.logTask(t,i,r);case"task_history":return d.taskHistory(t,i,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}};try{return await c(n)}catch(d){if(o==="mem0"&&n!==de){if(Pe(i)){if(!Ce){Ce=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${d.message}); degrading to dolt for this run
|
|
619
|
+
`)}catch{}}try{return await c(de)}catch(l){return JSON.stringify({error:l.message,backend:"dolt",degradedFrom:"mem0"})}}return JSON.stringify({error:`mem0 unavailable (${d.message}); dolt fallback also unavailable`,backend:"mem0"})}return JSON.stringify({error:d.message})}},tools:[{name:"memory_store",description:"Save a fact, decision, or context to persistent memory. Survives across sessions.",input_schema:{type:"object",properties:{memoryKey:{type:"string",description:"Stable semantic identity key (e.g. user.jira.default_board)"},content:{type:"string",description:"The information to remember"},category:{type:"string",enum:["fact","decision","context","insight","preference","credential","url","error","workaround"],description:"Category of memory"},tier:{type:"string",enum:["short","mid","long"],description:"Memory tier: short (session/24h), mid (days/weeks), long (permanent)"},source:{type:"string",description:'Where this info came from (e.g. "jira", "github", "user", "test_run")'},ticketKey:{type:"string",description:"Related ticket key (optional)"},infer:{type:"boolean",description:"true = LLM distills/dedupes facts (costs tokens); false = store raw, embed-only, free",default:!1}},required:["content","category"]}},{name:"memory_recall",description:"Search persistent memory by keyword, category, ticket, or tier. Returns matching facts and context.",input_schema:{type:"object",properties:{query:{type:"string",description:"Search text (matches content)"},category:{type:"string",description:"Filter by category"},ticketKey:{type:"string",description:"Filter by ticket key"},tier:{type:"string",enum:["short","mid","long"],description:"Filter by memory tier"},limit:{type:"number",description:"Max results (default: 20)"}}}},{name:"memory_brief",description:"Get a compact briefing: recent session summaries + top relevant facts. Call at the start of a conversation.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Focus briefing on a specific ticket (optional)"}}}},{name:"memory_end_session",description:"End the current session and save a summary for future recall. Call when a task is complete.",input_schema:{type:"object",properties:{summary:{type:"string",description:"What happened in this session (1-3 sentences)"},tickets:{type:"string",description:"Comma-separated ticket keys covered"},tasksRun:{type:"number",description:"Number of tasks/tests run"},tasksPassed:{type:"number",description:"Number passed"},tasksFailed:{type:"number",description:"Number failed"},keyFacts:{type:"string",description:"Key facts worth remembering from this session (semicolon-separated)"}},required:["summary"]}},{name:"task_log",description:"Record a completed task (test run, analysis, generation) to persistent history.",input_schema:{type:"object",properties:{title:{type:"string",description:"Task description"},type:{type:"string",enum:["test_run","generate","analysis","research","other"],description:"Task type"},status:{type:"string",enum:["passed","failed","cancelled","error"],description:"Outcome"},ticketKey:{type:"string",description:"Related ticket key"},specPath:{type:"string",description:"Spec file path (if test run)"},resultSummary:{type:"string",description:"Brief result description"}},required:["title","type","status"]}},{name:"task_history",description:"Query past tasks by ticket, status, or type. See what was done before.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Filter by ticket key"},type:{type:"string",description:"Filter by task type"},status:{type:"string",description:"Filter by status"},limit:{type:"number",description:"Max results (default: 20)"}}}}]};function jr(s,t){let{content:e,category:r,source:i,ticketKey:n,tier:o,memoryKey:a}=s;if(!e||!r)return JSON.stringify({error:"content and category are required"});let c=nt(e);if(!c)return JSON.stringify({error:"content is empty after normalization"});let d=at(o,r),l=d==="long"?1:d==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let g=ee(t,`SELECT id, tier, relevance
|
|
618
620
|
FROM chat_memory
|
|
619
621
|
WHERE memory_key = ${w(p)}
|
|
620
622
|
ORDER BY created_at DESC
|
|
@@ -630,22 +632,22 @@ fact, decision, context, insight, credential, url, error, workaround`,resolve(){
|
|
|
630
632
|
FROM chat_memory
|
|
631
633
|
WHERE category = ${w(r)}
|
|
632
634
|
ORDER BY created_at DESC
|
|
633
|
-
LIMIT 200`).find(_=>
|
|
635
|
+
LIMIT 200`).find(_=>nt(_.content)===c);if(m){let _=String(m.tier||"mid"),g=Number(m.relevance||0),b=le(d)>le(_),y=l>g;if(b||y){J(t,`UPDATE chat_memory
|
|
634
636
|
SET tier = ${w(b?d:_)},
|
|
635
637
|
relevance = ${Math.max(l,g)}
|
|
636
|
-
WHERE id = ${w(m.id)}`);try{q(t,["add","."]),q(t,["commit","-m",`memory promote: ${r} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:m.id,category:r,tier:b?d:_,deduped:!0,promoted:!0})}return JSON.stringify({ok:!0,id:m.id,category:r,tier:_,deduped:!0,promoted:!1})}let f=
|
|
637
|
-
VALUES (${w(f)}, ${w(p||null)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(n)}, ${w(h)}, ${w(d)}, ${l}, ${w(ne())})`);try{q(t,["add","."]),q(t,["commit","-m",`memory: ${r} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:f,category:r,tier:d,memoryKey:p||null,stored:e.slice(0,100)})}function
|
|
638
|
+
WHERE id = ${w(m.id)}`);try{q(t,["add","."]),q(t,["commit","-m",`memory promote: ${r} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:m.id,category:r,tier:b?d:_,deduped:!0,promoted:!0})}return JSON.stringify({ok:!0,id:m.id,category:r,tier:_,deduped:!0,promoted:!1})}let f=Ue(),h=process.env.ZIBBY_CHAT_SESSION_ID||null;J(t,`INSERT INTO chat_memory (id, memory_key, category, content, source, ticket_key, session_id, tier, relevance, created_at)
|
|
639
|
+
VALUES (${w(f)}, ${w(p||null)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(n)}, ${w(h)}, ${w(d)}, ${l}, ${w(ne())})`);try{q(t,["add","."]),q(t,["commit","-m",`memory: ${r} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:f,category:r,tier:d,memoryKey:p||null,stored:e.slice(0,100)})}function no(s){let t=String(s||"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}var rt=new Map;async function oo(s,t){if(typeof s=="boolean")return s;if(process.env.ZIBBY_MEM0_INFER!=null&&String(process.env.ZIBBY_MEM0_INFER).trim()!=="")return no(process.env.ZIBBY_MEM0_INFER);let e=t||process.cwd();if(rt.has(e))return rt.get(e);let r=!1;try{let i=z(e,".zibby.config.mjs");ot(i)&&(r=(await import(_e(i).href))?.default?.memory?.infer===!0)}catch{}return rt.set(e,r),r}async function ao(s,t,e){let{content:r,category:i,source:n,ticketKey:o,tier:a,memoryKey:c,infer:d}=s;if(!r||!i)return JSON.stringify({error:"content and category are required"});try{let l=await Rr(e),p=Ir(e),u=at(a,i),m=await oo(d,e);return await l.add([{role:"user",content:String(r)}],{userId:p,infer:m,metadata:{memoryKey:c||null,category:i,tier:u,source:n||"zibby-chat",ticketKey:o||null,created_at:ne()}}),JSON.stringify({ok:!0,backend:"mem0",userId:p,category:i,tier:u,infer:m,memoryKey:c||null,stored:String(r).slice(0,100)})}catch(l){throw new Error(`mem0 store failed: ${l.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:l})}}function co(s,t){let{query:e,category:r,ticketKey:i,tier:n,limit:o=20}=s,a=[];e&&a.push(`content LIKE ${w(`%${e}%`)}`),r&&a.push(`category = ${w(r)}`),i&&a.push(`ticket_key = ${w(i)}`),n&&a.push(`tier = ${w(n)}`);let d=`SELECT id, memory_key, category, content, source, ticket_key, tier, relevance, created_at
|
|
638
640
|
FROM chat_memory ${a.length>0?`WHERE ${a.join(" AND ")}`:""}
|
|
639
641
|
ORDER BY relevance DESC, created_at DESC
|
|
640
|
-
LIMIT ${o}`,l=ee(t,d);return JSON.stringify({total:l.length,memories:l})}async function Tr(s,t,e){let{query:r,category:i,ticketKey:n,tier:o,limit:a=20}=s;try{let c=await
|
|
642
|
+
LIMIT ${o}`,l=ee(t,d);return JSON.stringify({total:l.length,memories:l})}async function Tr(s,t,e){let{query:r,category:i,ticketKey:n,tier:o,limit:a=20}=s;try{let c=await Rr(e),d=Ir(e),l=[];if(r&&String(r).trim()){let p=await c.search(String(r),{filters:{user_id:d},topK:a});l=gr(p)}else{let p=await c.getAll({filters:{user_id:d},topK:Math.max(a,50)});l=gr(p)}return i&&(l=l.filter(p=>p.category===i)),n&&(l=l.filter(p=>p.ticket_key===n)),o&&(l=l.filter(p=>p.tier===o)),l=l.slice(0,a),JSON.stringify({total:l.length,memories:l,backend:"mem0"})}catch(c){throw new Error(`mem0 recall failed: ${c.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:c})}}function lo(s,t){let{ticketKey:e}=s;mo(t);let i=ee(t,`SELECT session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, created_at
|
|
641
643
|
FROM chat_sessions ORDER BY created_at DESC LIMIT 5`),n=e?`AND ticket_key = ${w(e)}`:"",o=ee(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
|
|
642
644
|
WHERE tier = 'long' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 10`),a=ee(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
|
|
643
645
|
WHERE tier = 'mid' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 8`),d=ee(t,`SELECT type, status, COUNT(*) as cnt FROM chat_tasks
|
|
644
|
-
GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),l=Nr([...o,...a]);return JSON.stringify({recentSessions:i,topMemories:l,taskStats:d,ticketFilter:e||null})}async function
|
|
645
|
-
VALUES (${w(c)}, ${w(e)}, ${w(r)}, ${i}, ${n}, ${o}, ${w(a)}, ${w(ne())})`),a)for(let d of a.split(";").map(l=>l.trim()).filter(Boolean))jr({content:d,category:"fact",source:"session_summary",tier:"mid"},t);
|
|
646
|
-
VALUES (${w(c)}, ${w(n)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(o)}, ${w(d)}, ${w(a)}, ${w(ne())}, ${w(ne())})`);try{q(t,["add","."]),q(t,["commit","-m",`task: ${i} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:c,title:e,type:r,status:i})}function
|
|
646
|
+
GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),l=Nr([...o,...a]);return JSON.stringify({recentSessions:i,topMemories:l,taskStats:d,ticketFilter:e||null})}async function po(s,t,e){let{ticketKey:r}=s,i=await Tr({limit:80},t,e),n=JSON.parse(i||"{}"),o=Array.isArray(n.memories)?n.memories:[];r&&(o=o.filter(u=>u.ticket_key===r));let a=u=>{let m=Date.parse(String(u?.created_at||""))||0;return Number(u?.relevance||0)*1e12+m},c=(u,m)=>a(m)-a(u),d=o.filter(u=>u.tier==="long").sort(c).slice(0,10),l=o.filter(u=>u.tier==="mid").sort(c).slice(0,8),p=Nr([...d,...l]);return JSON.stringify({recentSessions:[],topMemories:p,taskStats:[],ticketFilter:r||null,backend:"mem0"})}function $r(s,t){let{summary:e,tickets:r,tasksRun:i=0,tasksPassed:n=0,tasksFailed:o=0,keyFacts:a}=s;if(!e)return JSON.stringify({error:"summary is required"});let c=process.env.ZIBBY_CHAT_SESSION_ID||`session_${Ue()}`;if(J(t,`INSERT INTO chat_sessions (session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, key_facts, created_at)
|
|
647
|
+
VALUES (${w(c)}, ${w(e)}, ${w(r)}, ${i}, ${n}, ${o}, ${w(a)}, ${w(ne())})`),a)for(let d of a.split(";").map(l=>l.trim()).filter(Boolean))jr({content:d,category:"fact",source:"session_summary",tier:"mid"},t);uo(t);try{q(t,["add","."]),q(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:c,summary:e.slice(0,200)})}function Er(s,t){let{title:e,type:r,status:i,ticketKey:n,specPath:o,resultSummary:a}=s;if(!e||!r||!i)return JSON.stringify({error:"title, type, and status are required"});let c=Ue(),d=process.env.ZIBBY_CHAT_SESSION_ID||null;J(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
|
|
648
|
+
VALUES (${w(c)}, ${w(n)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(o)}, ${w(d)}, ${w(a)}, ${w(ne())}, ${w(ne())})`);try{q(t,["add","."]),q(t,["commit","-m",`task: ${i} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:c,title:e,type:r,status:i})}function xr(s,t){let{ticketKey:e,type:r,status:i,limit:n=20}=s,o=[];e&&o.push(`ticket_key = ${w(e)}`),r&&o.push(`type = ${w(r)}`),i&&o.push(`status = ${w(i)}`);let c=`SELECT id, ticket_key, type, title, status, spec_path, result_summary, created_at, finished_at
|
|
647
649
|
FROM chat_tasks ${o.length>0?`WHERE ${o.join(" AND ")}`:""}
|
|
648
|
-
ORDER BY created_at DESC LIMIT ${n}`,d=ee(t,c);return JSON.stringify({total:d.length,tasks:d})}function
|
|
650
|
+
ORDER BY created_at DESC LIMIT ${n}`,d=ee(t,c);return JSON.stringify({total:d.length,tasks:d})}function uo(s){try{J(s,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),J(s,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),J(s,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),J(s,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function mo(s){try{let t=new Date(Date.now()-864e5).toISOString();J(s,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${w(t)}`)}catch{}}import{existsSync as Lr,readFileSync as fo}from"node:fs";import{homedir as ho}from"node:os";import{join as yo,dirname as go,resolve as _o}from"node:path";import{fileURLToPath as bo}from"node:url";function ko(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=go(bo(import.meta.url)),t=_o(s,"..","bin","mcp-skill.mjs");return Lr(t)?t:null}function wo(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let s=yo(ho(),".zibby","config.json");return Lr(s)&&JSON.parse(fo(s,"utf-8")).sessionToken||null}catch{return null}}function So(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function vo(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function ct(s){return`${vo()}:${s}`}async function lt(s,t){let e=wo();if(!e)throw new Error("No backend credential (PROJECT_API_TOKEN). KV memory is only available inside a Zibby run.");let r=`${So()}/credits/review-memory`,i=await fetch(r,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({op:s,...t})});if(!i.ok){let n=await i.text().catch(()=>"");throw new Error(`KV memory ${s} failed (${i.status}): ${n.slice(0,300)}`)}return i.json()}var Cr={id:"kv-memory",serverName:"kv_memory",allowedTools:["mcp__kv_memory__*"],description:"KV memory \u2014 a private, per-agent persistent key\u2192value store across stateless runs (auto-namespaced)",promptFragment:`## KV Memory (private, per-agent, persistent key-value store)
|
|
649
651
|
You have a PRIVATE per-agent key-value memory that survives across your
|
|
650
652
|
stateless runs. It is automatically namespaced to YOU (this agent type) \u2014 other
|
|
651
653
|
agents cannot see or collide with your entries, and you don't need to prefix
|
|
@@ -660,7 +662,7 @@ Tools:
|
|
|
660
662
|
Use to record durable facts \u2014 e.g. dedup markers, prior decisions, summaries.
|
|
661
663
|
|
|
662
664
|
Your namespace is added for you automatically; pass plain keys like
|
|
663
|
-
"seen#owner/repo#42" or "lastRun".`,resolve(){let s=
|
|
665
|
+
"seen#owner/repo#42" or "lastRun".`,resolve(){let s=ko();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/kvMemory.js","kvMemorySkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"kv_recall":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});let r=await lt("recall",{scope:ct(e)});return JSON.stringify(r)}case"kv_recall_prefix":{let e=typeof t?.keyPrefix=="string"?t.keyPrefix.trim():"";if(!e)return JSON.stringify({error:"keyPrefix is required"});let r=await lt("recall-prefix",{scopePrefix:ct(e)});return JSON.stringify(r)}case"kv_store":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});if(typeof t?.content!="string"||t.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let r={scope:ct(e),content:t.content};t.metadata!=null&&(r.metadata=t.metadata);let i=await lt("store",r);return JSON.stringify(i)}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"kv_recall",description:'Recall the value you stored under a plain key (exact match). Your per-agent namespace is added automatically \u2014 pass a plain key like "seen#owner/repo#42".',input_schema:{type:"object",properties:{key:{type:"string",description:'Plain storage key (no namespace prefix needed) \u2014 e.g. "seen#owner/repo#42" or "lastRun".'}},required:["key"]}},{name:"kv_recall_prefix",description:'List your entries whose plain key STARTS WITH a prefix (e.g. "seen#"). Your per-agent namespace is added automatically. Capped at 25.',input_schema:{type:"object",properties:{keyPrefix:{type:"string",description:'Plain key prefix to match (no namespace prefix needed) \u2014 e.g. "seen#".'}},required:["keyPrefix"]}},{name:"kv_store",description:"Store (overwrite) a value under a plain key so a later run of yours can recall it. Your per-agent namespace is added automatically.",input_schema:{type:"object",properties:{key:{type:"string",description:"Plain storage key (no namespace prefix needed). Same key you recall by."},content:{type:"string",description:"The value to persist. Free-form markdown/text."},metadata:{type:"object",description:"Optional structured metadata."}},required:["key","content"]}}]};import{spawnSync as No}from"node:child_process";import{existsSync as Me,mkdirSync as Pr,readdirSync as Io,writeFileSync as Oo}from"node:fs";import{createHash as Ro}from"node:crypto";import{join as De}from"node:path";function qr(){return process.env.CBM_BIN||"/usr/local/bin/codebase-memory-mcp"}function Jr(){if(process.env.CBM_CACHE_DIR)return process.env.CBM_CACHE_DIR;let s=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE;return s?De(s,".zibby","cbm-cache"):"/tmp/zibby-cbm-cache"}function Ao(){let s=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE||"/workspace",t=De(s,".zibby","repos");try{if(Me(t)){let e=Io(t,{withFileTypes:!0}).filter(r=>r.isDirectory()).map(r=>De(t,r.name));if(e.length===1)return e[0];if(e.length>1)return t}}catch{}return Me(s)?s:null}function jo(s){return Ro("sha256").update(s).digest("hex").slice(0,16)}var Ur={id:"codebase-memory",serverName:"codebase_memory",allowedTools:["mcp__codebase_memory__*"],description:"Codebase memory \u2014 code-graph + semantic index over the checked-out repo (architecture, graph search, dependency trace, change detection)",promptFragment:`## Codebase Memory (code-graph + semantic index over THIS repo)
|
|
664
666
|
The checked-out repository is indexed into a queryable code graph + semantic
|
|
665
667
|
index. Reach for these instead of blindly grepping when you need structure,
|
|
666
668
|
relationships, or "where does X live / what depends on Y":
|
|
@@ -672,8 +674,8 @@ relationships, or "where does X live / what depends on Y":
|
|
|
672
674
|
- get_code_snippet / search_code: pull the exact code for a node / text match.
|
|
673
675
|
- index_status / list_projects: confirm the index is present before querying.
|
|
674
676
|
The repo is indexed for you at the start of the run; if a query comes back
|
|
675
|
-
empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let s=Jr();try{Pr(s,{recursive:!0})}catch{}let t={CBM_CACHE_DIR:s};return process.env.WORKSPACE&&(t.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:qr(),args:[],env:t,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let s=
|
|
676
|
-
`)}catch{}}catch{}return{}}};import{existsSync as W,readFileSync as ke,readdirSync as
|
|
677
|
+
empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let s=Jr();try{Pr(s,{recursive:!0})}catch{}let t={CBM_CACHE_DIR:s};return process.env.WORKSPACE&&(t.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:qr(),args:[],env:t,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let s=Ao();if(!s)return{};let t=Jr();try{Pr(t,{recursive:!0})}catch{}let e=De(t,`.cbm-indexed-${jo(s)}`);if(Me(e))return{};let r=qr();if(!Me(r)&&!process.env.CBM_BIN)return{};let i=No(r,["cli","index_repository",JSON.stringify({repo_path:s})],{env:{...process.env,CBM_CACHE_DIR:t},encoding:"utf-8",timeout:300*1e3,maxBuffer:32*1024*1024});try{Oo(e,`${new Date().toISOString()} status=${i.status}
|
|
678
|
+
`)}catch{}}catch{}return{}}};import{existsSync as W,readFileSync as ke,readdirSync as dt,mkdirSync as To,writeFileSync as pe,statSync as Br}from"fs";import{join as R,resolve as pt,relative as Kr,dirname as Gr}from"path";import{fileURLToPath as $o}from"url";import{createRequire as Eo}from"module";var xo=Eo(import.meta.url),Lo=`## Workflow Builder
|
|
677
679
|
|
|
678
680
|
You can help users build custom AI workflows using the Zibby workflow framework.
|
|
679
681
|
|
|
@@ -783,9 +785,9 @@ Call with no arguments to see all available topics.
|
|
|
783
785
|
- Workflow names must be kebab-case (e.g., ticket-triage, pr-review).
|
|
784
786
|
- State flows through: each node's validated output is stored under its name in state (e.g., state.classify_ticket).
|
|
785
787
|
- Downstream nodes reference upstream outputs in their prompt function (e.g., \\\`\\\${JSON.stringify(state.classify_ticket, null, 2)}\\\`).
|
|
786
|
-
- Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Fr=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function Hr(s){return`${s.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function be(s){return`${s.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function
|
|
788
|
+
- Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Fr=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function Hr(s){return`${s.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function be(s){return`${s.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function Co(s){let t=s?.agent;return t?t.provider?t.provider:t.gemini?"gemini":t.codex?"codex":t.claude?"claude":t.cursor?"cursor":process.env.AGENT_TYPE||"cursor":process.env.AGENT_TYPE||"cursor"}async function Po(s){let t=pt(s,".zibby.config.mjs");if(!W(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function qo(){try{let s=Gr(xo.resolve("@zibby/core/package.json")),t=R(s,"templates","browser-test-automation"),e=ke(R(t,"nodes","preflight.mjs"),"utf-8"),r=ke(R(t,"graph.mjs"),"utf-8");return{preflight:e,graph:r}}catch{return null}}var Mr=Gr($o(import.meta.url));function zr(){let s=pt(Mr,"..","..","..","docsite","docs");if(W(s))return s;let t=pt(Mr,"..","docs");return W(t)?t:null}function Dr(){let s=zr();if(!s)return[];try{let t=(e,r="")=>{let i=[];for(let n of dt(e)){let o=R(e,n);try{if(Br(o).isDirectory())i=i.concat(t(o,`${r}${n}/`));else if(n.endsWith(".md")){let a=`${r}${n.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return t(s)}catch{return[]}}function Wr(s){let t=zr();if(!t)return null;let e=R(t,`${s}.md`);if(!W(e))return null;try{return ke(e,"utf-8")}catch{return null}}function Jo(s){let t=s.nodes.map(o=>{let a=o.inputFields?.length?`Input fields: ${o.inputFields.join(", ")}`:"Input: receives full state",c=o.outputFields?.length?`Output fields: ${o.outputFields.join(", ")}`:"Output: determined by task",d=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${a}. ${c}.${d?` ${d}`:""}`}).join(`
|
|
787
789
|
`),e=s.edges.map(o=>o.condition?`- ${o.from} \u2192 ${o.to} (conditional: ${o.condition})`:`- ${o.from} \u2192 ${o.to}`).join(`
|
|
788
|
-
`),r=
|
|
790
|
+
`),r=qo(),i=Wr("custom-workflows"),n="";return r&&(n+=`
|
|
789
791
|
## Real working examples from the Zibby framework
|
|
790
792
|
|
|
791
793
|
### Example node (preflight.mjs) \u2014 a prompt-only node with Zod schema and onComplete hook:
|
|
@@ -862,7 +864,7 @@ Return a JSON object with this exact structure:
|
|
|
862
864
|
}
|
|
863
865
|
}
|
|
864
866
|
|
|
865
|
-
IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function Yr(s,t){let e=await
|
|
867
|
+
IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function Yr(s,t){let e=await Po(t),r=Co(e);try{let{invokeAgent:i}=await import("@zibby/core"),n=Jo(s),o=await i(n,{state:{agentType:r,config:e,cwd:t,workspace:t}},{model:e?.agent?.[r]?.model||"auto",workspace:t,config:e,timeout:12e4}),c=(typeof o=="string"?o:o?.raw||JSON.stringify(o?.structured||o)).match(/\{[\s\S]*\}/);if(!c)throw new Error("Agent did not return valid JSON");return JSON.parse(c[0])}catch(i){return console.warn(`Agent code generation failed (${i.message}), using templates`),Uo(s)}}function Uo(s){let t={};for(let e of s.nodes){let r=be(e.name),i=`${e.name.split("_").map(c=>c.charAt(0).toUpperCase()+c.slice(1)).join("")}OutputSchema`,n=e.outputFields?.length?e.outputFields.map(c=>` ${c}: z.string().describe('${c}'),`).join(`
|
|
866
868
|
`):` summary: z.string().describe('Summary of the result'),
|
|
867
869
|
status: z.enum(['ok', 'warn', 'error']).describe('Overall status'),`,o=s.edges.filter(c=>c.to===e.name&&c.from!=="START").map(c=>`Previous step (${c.from}): \${JSON.stringify(state.${c.from} || {}, null, 2)}`).join(`
|
|
868
870
|
`),a=o?`${e.description}
|
|
@@ -884,7 +886,7 @@ export const ${r} = {
|
|
|
884
886
|
prompt: (state) => \`${a}\`,
|
|
885
887
|
outputSchema: ${i},
|
|
886
888
|
};
|
|
887
|
-
`}}return{nodes:t}}function
|
|
889
|
+
`}}return{nodes:t}}function Mo(s,t,e,r){let i=t.toLowerCase(),n=Hr(i),o=R(s,".zibby","workflows",i),a=R(o,"nodes");To(a,{recursive:!0});let c=e.nodes.map(g=>g.name);for(let g of e.nodes){let b=r.nodes?.[g.name]?.code;b&&pe(R(a,`${g.name.replace(/_/g,"-")}.mjs`),b,"utf-8")}let d=c.map(g=>{let b=be(g),y=g.replace(/_/g,"-");return`export { ${b} } from './${y}.mjs';`});pe(R(a,"index.mjs"),`${d.join(`
|
|
888
890
|
`)}
|
|
889
891
|
`,"utf-8");let l=c[0],p=c.map(g=>be(g)).join(", "),u=c.map(g=>` graph.addNode('${g}', ${be(g)});`).join(`
|
|
890
892
|
`),m=e.edges.map(g=>g.condition?` graph.addConditionalEdges('${g.from}', (state) => {
|
|
@@ -909,16 +911,16 @@ ${m}
|
|
|
909
911
|
console.log(\`[${i}] workflow complete \u2014 success: \${result.success !== false}\`);
|
|
910
912
|
}
|
|
911
913
|
}
|
|
912
|
-
`;pe(
|
|
913
|
-
`,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:Kr(s,o),files:_,className:n,slug:i}}async function
|
|
914
|
-
`,b=W(h)?ke(h,"utf-8"):"";return b.includes(_)||pe(h,b+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Bo(s,t){let{name:e,projectId:r}=s,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!r)return JSON.stringify({error:"projectId is required."});let n=O(t,".zibby","workflows",i);if(!W(n))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${O(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch{try{let{execSync:a}=await import("child_process"),c=a(`npx zibby deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch(a){return JSON.stringify({error:`Deploy failed: ${a.message}`})}}}function Ko(s){let t=O(s,".zibby","workflows");if(!W(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let r=lt(t).filter(i=>{try{return Br(O(t,i)).isDirectory()}catch{return!1}}).map(i=>{let n=O(t,i,"workflow.json"),o={};try{o=JSON.parse(ke(n,"utf-8"))}catch{}let a=O(t,i,"nodes"),c=0;try{c=lt(a).filter(d=>d.endsWith(".mjs")&&d!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Kr(s,O(t,i))}});return JSON.stringify({workflows:r})}var Zr={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Eo,tools:[{name:"design_workflow",description:"Design a workflow spec (nodes, edges, descriptions) for the user to review before building. Call this after understanding requirements.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name in kebab-case (e.g., ticket-triage)"},description:{type:"string",description:"What the workflow does"},nodes:{type:"array",items:{type:"object",properties:{name:{type:"string",description:"Node name in snake_case (e.g., classify_ticket)"},description:{type:"string",description:"What this node does \u2014 be specific about input/output"},inputFields:{type:"array",items:{type:"string"},description:"Key fields this node reads from state"},outputFields:{type:"array",items:{type:"string"},description:"Key fields this node produces"}},required:["name","description"]},description:"Workflow nodes (processing steps)"},edges:{type:"array",items:{type:"object",properties:{from:{type:"string",description:"Source node name"},to:{type:"string",description:'Target node name (or "END")'},condition:{type:"string",description:"JS expression for conditional routing (optional)"}},required:["from","to"]},description:"Edges connecting nodes. If omitted, nodes are wired linearly."}},required:["name","description","nodes"]}},{name:"build_workflow",description:"Generate real workflow code on disk from a design spec. Uses the configured AI agent for high-quality code generation.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name (from design_workflow)"},spec:{type:"object",description:"The full spec object returned by design_workflow",properties:{name:{type:"string"},description:{type:"string"},nodes:{type:"array",items:{type:"object"}},edges:{type:"array",items:{type:"object"}}}}},required:["name","spec"]}},{name:"add_node",description:"Add a new node to an existing workflow. Generates the node file and updates the barrel export.",input_schema:{type:"object",properties:{workflowName:{type:"string",description:"Existing workflow name (kebab-case)"},nodeName:{type:"string",description:"New node name (snake_case)"},description:{type:"string",description:"What this node does"},inputFields:{type:"array",items:{type:"string"},description:"Fields read from state"},outputFields:{type:"array",items:{type:"string"},description:"Fields produced"}},required:["workflowName","nodeName","description"]}},{name:"deploy_workflow",description:"Deploy a workflow to Zibby Cloud. Returns the trigger URL.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name to deploy"},projectId:{type:"string",description:"Target project ID"}},required:["name","projectId"]}},{name:"list_workflows",description:"List all local workflows in .zibby/workflows/.",input_schema:{type:"object",properties:{}}},{name:"explore_framework_docs",description:"Read Zibby framework documentation on demand. Call this before building complex workflows or when you need details on advanced patterns (middleware, conditional routing, skills, deployment, CLI commands).",input_schema:{type:"object",properties:{topic:{type:"string",description:'Doc topic to read (e.g., "workflow", "custom-workflows", "cli-reference", "packages/core", "packages/skills", "integrations/jira"). Call with no topic to list all available docs.'}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"design_workflow":return await Uo(t);case"build_workflow":return await Mo(t,r);case"add_node":return await Do(t,r);case"deploy_workflow":return await Bo(t,r);case"list_workflows":return Ko(r);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=Dr();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let n=Wr(i);if(!n){let o=Dr();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:n})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Go}from"@zibby/core/backend-client.js";var ut=Object.freeze({id:"openai_billing",requiresIntegration:N.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),mt=Object.freeze({id:"anthropic_billing",requiresIntegration:N.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),ft=Object.freeze({id:"cursor_admin",requiresIntegration:N.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Vr(s){return Math.floor(s/1e3)}function pt(s){return new Date(s).toISOString().slice(0,10)}function Qr(s){return new Date(s).toISOString()}async function we(s){let t=await Go(s);if(!t?.token)throw new Error(`${s} token resolver returned no token`);return t.token}async function Xr({startMs:s,endMs:t,groupBy:e=["project_id","line_item"]}){let r=await we("openai_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.openai.com/v1/organization/costs?${[`start_time=${Vr(s)}`,`end_time=${Vr(t)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{Authorization:`Bearer ${r}`}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`OpenAI costs API ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){n+=1;let f=pt((m.start_time||0)*1e3);for(let h of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(h.amount?.value??0),projectId:h.project_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.line_item||void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:n}}async function Fo(){let s=await we("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${s}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function es({startMs:s,endMs:t,groupBy:e=["workspace_id"]}){let r=await we("anthropic_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(Qr(s))}`,`ending_at=${encodeURIComponent(Qr(t))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`Anthropic cost_report ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){n+=1;let f=(m.starting_at||"").slice(0,10);for(let h of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(h.amount??h.cost??0),workspaceId:h.workspace_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.model||void 0,tokensIn:h.uncached_input_tokens!=null?Number(h.uncached_input_tokens):void 0,tokensOut:h.output_tokens!=null?Number(h.output_tokens):void 0,cachedTokens:h.cached_input_tokens!=null?Number(h.cached_input_tokens):void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:n}}async function Ho(){let s=await we("anthropic_billing"),e=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":s,"anthropic-version":"2023-06-01"}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function ts({startMs:s,endMs:t}){let e=await we("cursor_admin"),r=pt(s),i=pt(t),n=`https://api.cursor.com/teams/daily-usage-data?startDate=${r}&endDate=${i}`,o=await fetch(n,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${l.slice(0,200)}`)}let a=await o.json(),c=[],d=0;for(let l of a.data||[]){d+=1;let p=l.date;for(let u of l.userMetrics||[]){for(let m of u.modelUsage||[]){let f=Number(m.acceptedLines??0),h=Number(m.suggestedLines??0);c.push({provider:"cursor",day:p,costUsd:Number(m.totalCents??0)/100,userEmail:u.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:h>0?f/h:void 0})}(!u.modelUsage||u.modelUsage.length===0)&&c.push({provider:"cursor",day:p,costUsd:Number(u.totalCents??0)/100,userEmail:u.email})}}return{ok:!0,items:c,rawBuckets:d}}async function zo({startMs:s,endMs:t}){let[e,r,i]=await Promise.allSettled([Xr({startMs:s,endMs:t}),es({startMs:s,endMs:t}),ts({startMs:s,endMs:t})]),n=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=n(e),a=n(r),c=n(i),d=[{provider:"openai",totalUsd:o.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"anthropic",totalUsd:a.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"cursor",totalUsd:c.items.reduce((l,p)=>l+(p.costUsd||0),0)}];return{openai:o,anthropic:a,cursor:c,totals:d}}function Wo(s,t){let e=new Map;for(let r of s){let i=t(r);if(!i)continue;let n=e.get(i)||{key:i,totalUsd:0,count:0};n.totalUsd+=r.costUsd||0,n.count+=1,e.set(i,n)}return[...e.values()].sort((r,i)=>i.totalUsd-r.totalUsd)}function Yo(s){if(!s.length)return{mean:0,stddev:0};let t=s.reduce((r,i)=>r+i,0)/s.length,e=s.reduce((r,i)=>r+(i-t)**2,0)/s.length;return{mean:t,stddev:Math.sqrt(e)}}import{z as k}from"zod";var Se=["ok","info","warn","critical"],Zo=k.object({primary:k.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:k.object({value:k.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:k.enum(["up","down","flat"]).optional(),severity:k.enum(Se).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:k.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Vo=k.object({kind:k.literal("trend"),title:k.string().max(120).optional(),labels:k.array(k.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:k.array(k.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:k.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:k.enum(Se).optional()}),Qo=k.object({kind:k.literal("table"),title:k.string().max(120).optional(),headers:k.array(k.string().max(40)).min(1).max(8),rows:k.array(k.array(k.union([k.string().max(200),k.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),Xo=k.object({kind:k.literal("callouts"),title:k.string().max(120).optional(),tone:k.enum(Se).default("info").optional(),items:k.array(k.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),ea=k.object({kind:k.literal("breakdown"),title:k.string().max(120).optional(),rows:k.array(k.object({label:k.string().min(1).max(80),value:k.string().min(1).max(80),sub:k.string().max(120).optional(),severity:k.enum(Se).optional()})).min(1).max(20)}),ta=k.object({kind:k.literal("paragraph"),title:k.string().max(120).optional(),text:k.string().min(1).max(3e3)}),ra=k.discriminatedUnion("kind",[Vo,Qo,Xo,ea,ta]),ht=k.object({title:k.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:k.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:Zo,sections:k.array(ra).max(20).default([]).superRefine((s,t)=>{s.forEach((e,r)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"rows"],message:"every row must have headers.length entries"})})}),footer:k.object({viewUrl:k.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:k.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),te=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),rs=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),sa=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function ss(s,t,e=12){if(!Number.isFinite(s)||!Number.isFinite(t)||t<=0)return"";let r=Math.max(0,Math.min(1,s/t)),i=Math.round(r*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function yt(s,t){let e=String(s);return e.length>=t?e:e+" ".repeat(t-e.length)}function is(s,t){let e=String(s);return e.length>=t?e:" ".repeat(t-e.length)+e}function ns({headers:s,rows:t}){let e=s.map((o,a)=>{let c=Math.max(String(o).length,...t.map(d=>String(d[a]??"").length));return Math.min(c,32)}),r=o=>o.map((a,c)=>yt(a,e[c])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[r(s),i,...t.map(o=>r(o))].join(`
|
|
915
|
-
`)+"\n```"}function
|
|
916
|
-
`+t.headline.summary),e.push({type:"section",text:{type:"mrkdwn",text:i}});for(let n of t.sections)switch(e.push({type:"divider"}),n.title&&e.push({type:"section",text:{type:"mrkdwn",text:`*${n.title}*`}}),n.kind){case"trend":{let o=Math.max(...n.values),a=n.labels.map((c,d)=>{let l=n.values[d],p=ss(l,o),m=(n.highlight==="last"&&d===n.labels.length-1||n.highlight==="max"&&l===o||n.highlight==="min"&&l===Math.min(...n.values))&&n.severity?` ${te[n.severity]}`:"";return`${
|
|
914
|
+
`;pe(R(o,"graph.mjs"),f,"utf-8");let h={name:i,description:e.description||`${n} workflow`,entryClass:n,triggers:{api:!0}};pe(R(o,"workflow.json"),`${JSON.stringify(h,null,2)}
|
|
915
|
+
`,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:Kr(s,o),files:_,className:n,slug:i}}async function Do(s){let{name:t,description:e,nodes:r,edges:i}=s;if(!t||!Fr.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!r||r.length===0)return JSON.stringify({error:"At least one node is required."});let n={name:t.toLowerCase(),description:e||`${Hr(t.toLowerCase())} workflow`,nodes:r.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(n.edges.length===0&&n.nodes.length>0){for(let o=0;o<n.nodes.length-1;o++)n.edges.push({from:n.nodes[o].name,to:n.nodes[o+1].name});n.edges.push({from:n.nodes[n.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:n,message:`Workflow "${n.name}" designed with ${n.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:n.nodes.map(o=>o.name),flow:n.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Bo(s,t){let{name:e,spec:r}=s,i=(e||r?.name||"").toLowerCase();if(!i||!Fr.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!r||!r.nodes||r.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let n=R(t,".zibby","workflows",i);if(W(n))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await Yr(r,t),a=Mo(t,i,r,o);return JSON.stringify({ok:!0,...a,message:`Workflow "${i}" created at ${a.workflowDir}/`,nextSteps:[`Test locally: zibby start ${i}`,`Deploy to cloud: zibby deploy ${i} --project <project-id>`,`Tail logs: zibby logs --workflow ${i} --project <project-id>`]})}async function Ko(s,t){let{workflowName:e,nodeName:r,description:i,inputFields:n,outputFields:o}=s,a=(e||"").toLowerCase(),c=(r||"").replace(/-/g,"_"),d=R(t,".zibby","workflows",a);if(!W(d))return JSON.stringify({error:`Workflow "${a}" not found. Create it first with build_workflow.`});let l={name:a,description:"",nodes:[{name:c,description:i||`Process ${c}`,inputFields:n||[],outputFields:o||[]}],edges:[]},u=(await Yr(l,t)).nodes?.[c]?.code;if(!u)return JSON.stringify({error:"Failed to generate node code."});let m=R(d,"nodes"),f=`${c.replace(/_/g,"-")}.mjs`;pe(R(m,f),u,"utf-8");let h=R(m,"index.mjs"),_=be(c),g=`export { ${_} } from './${c.replace(/_/g,"-")}.mjs';
|
|
916
|
+
`,b=W(h)?ke(h,"utf-8"):"";return b.includes(_)||pe(h,b+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Go(s,t){let{name:e,projectId:r}=s,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!r)return JSON.stringify({error:"projectId is required."});let n=R(t,".zibby","workflows",i);if(!W(n))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${R(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch{try{let{execSync:a}=await import("child_process"),c=a(`npx zibby deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch(a){return JSON.stringify({error:`Deploy failed: ${a.message}`})}}}function Fo(s){let t=R(s,".zibby","workflows");if(!W(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let r=dt(t).filter(i=>{try{return Br(R(t,i)).isDirectory()}catch{return!1}}).map(i=>{let n=R(t,i,"workflow.json"),o={};try{o=JSON.parse(ke(n,"utf-8"))}catch{}let a=R(t,i,"nodes"),c=0;try{c=dt(a).filter(d=>d.endsWith(".mjs")&&d!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Kr(s,R(t,i))}});return JSON.stringify({workflows:r})}var Zr={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Lo,tools:[{name:"design_workflow",description:"Design a workflow spec (nodes, edges, descriptions) for the user to review before building. Call this after understanding requirements.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name in kebab-case (e.g., ticket-triage)"},description:{type:"string",description:"What the workflow does"},nodes:{type:"array",items:{type:"object",properties:{name:{type:"string",description:"Node name in snake_case (e.g., classify_ticket)"},description:{type:"string",description:"What this node does \u2014 be specific about input/output"},inputFields:{type:"array",items:{type:"string"},description:"Key fields this node reads from state"},outputFields:{type:"array",items:{type:"string"},description:"Key fields this node produces"}},required:["name","description"]},description:"Workflow nodes (processing steps)"},edges:{type:"array",items:{type:"object",properties:{from:{type:"string",description:"Source node name"},to:{type:"string",description:'Target node name (or "END")'},condition:{type:"string",description:"JS expression for conditional routing (optional)"}},required:["from","to"]},description:"Edges connecting nodes. If omitted, nodes are wired linearly."}},required:["name","description","nodes"]}},{name:"build_workflow",description:"Generate real workflow code on disk from a design spec. Uses the configured AI agent for high-quality code generation.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name (from design_workflow)"},spec:{type:"object",description:"The full spec object returned by design_workflow",properties:{name:{type:"string"},description:{type:"string"},nodes:{type:"array",items:{type:"object"}},edges:{type:"array",items:{type:"object"}}}}},required:["name","spec"]}},{name:"add_node",description:"Add a new node to an existing workflow. Generates the node file and updates the barrel export.",input_schema:{type:"object",properties:{workflowName:{type:"string",description:"Existing workflow name (kebab-case)"},nodeName:{type:"string",description:"New node name (snake_case)"},description:{type:"string",description:"What this node does"},inputFields:{type:"array",items:{type:"string"},description:"Fields read from state"},outputFields:{type:"array",items:{type:"string"},description:"Fields produced"}},required:["workflowName","nodeName","description"]}},{name:"deploy_workflow",description:"Deploy a workflow to Zibby Cloud. Returns the trigger URL.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name to deploy"},projectId:{type:"string",description:"Target project ID"}},required:["name","projectId"]}},{name:"list_workflows",description:"List all local workflows in .zibby/workflows/.",input_schema:{type:"object",properties:{}}},{name:"explore_framework_docs",description:"Read Zibby framework documentation on demand. Call this before building complex workflows or when you need details on advanced patterns (middleware, conditional routing, skills, deployment, CLI commands).",input_schema:{type:"object",properties:{topic:{type:"string",description:'Doc topic to read (e.g., "workflow", "custom-workflows", "cli-reference", "packages/core", "packages/skills", "integrations/jira"). Call with no topic to list all available docs.'}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"design_workflow":return await Do(t);case"build_workflow":return await Bo(t,r);case"add_node":return await Ko(t,r);case"deploy_workflow":return await Go(t,r);case"list_workflows":return Fo(r);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=Dr();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let n=Wr(i);if(!n){let o=Dr();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:n})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Ho}from"@zibby/core/backend-client.js";var mt=Object.freeze({id:"openai_billing",requiresIntegration:N.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),ft=Object.freeze({id:"anthropic_billing",requiresIntegration:N.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),ht=Object.freeze({id:"cursor_admin",requiresIntegration:N.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Vr(s){return Math.floor(s/1e3)}function ut(s){return new Date(s).toISOString().slice(0,10)}function Qr(s){return new Date(s).toISOString()}async function we(s){let t=await Ho(s);if(!t?.token)throw new Error(`${s} token resolver returned no token`);return t.token}async function Xr({startMs:s,endMs:t,groupBy:e=["project_id","line_item"]}){let r=await we("openai_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.openai.com/v1/organization/costs?${[`start_time=${Vr(s)}`,`end_time=${Vr(t)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{Authorization:`Bearer ${r}`}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`OpenAI costs API ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){n+=1;let f=ut((m.start_time||0)*1e3);for(let h of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(h.amount?.value??0),projectId:h.project_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.line_item||void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:n}}async function zo(){let s=await we("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${s}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function es({startMs:s,endMs:t,groupBy:e=["workspace_id"]}){let r=await we("anthropic_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(Qr(s))}`,`ending_at=${encodeURIComponent(Qr(t))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`Anthropic cost_report ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){n+=1;let f=(m.starting_at||"").slice(0,10);for(let h of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(h.amount??h.cost??0),workspaceId:h.workspace_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.model||void 0,tokensIn:h.uncached_input_tokens!=null?Number(h.uncached_input_tokens):void 0,tokensOut:h.output_tokens!=null?Number(h.output_tokens):void 0,cachedTokens:h.cached_input_tokens!=null?Number(h.cached_input_tokens):void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:n}}async function Wo(){let s=await we("anthropic_billing"),e=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":s,"anthropic-version":"2023-06-01"}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function ts({startMs:s,endMs:t}){let e=await we("cursor_admin"),r=ut(s),i=ut(t),n=`https://api.cursor.com/teams/daily-usage-data?startDate=${r}&endDate=${i}`,o=await fetch(n,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${l.slice(0,200)}`)}let a=await o.json(),c=[],d=0;for(let l of a.data||[]){d+=1;let p=l.date;for(let u of l.userMetrics||[]){for(let m of u.modelUsage||[]){let f=Number(m.acceptedLines??0),h=Number(m.suggestedLines??0);c.push({provider:"cursor",day:p,costUsd:Number(m.totalCents??0)/100,userEmail:u.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:h>0?f/h:void 0})}(!u.modelUsage||u.modelUsage.length===0)&&c.push({provider:"cursor",day:p,costUsd:Number(u.totalCents??0)/100,userEmail:u.email})}}return{ok:!0,items:c,rawBuckets:d}}async function Yo({startMs:s,endMs:t}){let[e,r,i]=await Promise.allSettled([Xr({startMs:s,endMs:t}),es({startMs:s,endMs:t}),ts({startMs:s,endMs:t})]),n=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=n(e),a=n(r),c=n(i),d=[{provider:"openai",totalUsd:o.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"anthropic",totalUsd:a.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"cursor",totalUsd:c.items.reduce((l,p)=>l+(p.costUsd||0),0)}];return{openai:o,anthropic:a,cursor:c,totals:d}}function Zo(s,t){let e=new Map;for(let r of s){let i=t(r);if(!i)continue;let n=e.get(i)||{key:i,totalUsd:0,count:0};n.totalUsd+=r.costUsd||0,n.count+=1,e.set(i,n)}return[...e.values()].sort((r,i)=>i.totalUsd-r.totalUsd)}function Vo(s){if(!s.length)return{mean:0,stddev:0};let t=s.reduce((r,i)=>r+i,0)/s.length,e=s.reduce((r,i)=>r+(i-t)**2,0)/s.length;return{mean:t,stddev:Math.sqrt(e)}}import{z as k}from"zod";var Se=["ok","info","warn","critical"],Qo=k.object({primary:k.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:k.object({value:k.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:k.enum(["up","down","flat"]).optional(),severity:k.enum(Se).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:k.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Xo=k.object({kind:k.literal("trend"),title:k.string().max(120).optional(),labels:k.array(k.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:k.array(k.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:k.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:k.enum(Se).optional()}),ea=k.object({kind:k.literal("table"),title:k.string().max(120).optional(),headers:k.array(k.string().max(40)).min(1).max(8),rows:k.array(k.array(k.union([k.string().max(200),k.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),ta=k.object({kind:k.literal("callouts"),title:k.string().max(120).optional(),tone:k.enum(Se).default("info").optional(),items:k.array(k.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),ra=k.object({kind:k.literal("breakdown"),title:k.string().max(120).optional(),rows:k.array(k.object({label:k.string().min(1).max(80),value:k.string().min(1).max(80),sub:k.string().max(120).optional(),severity:k.enum(Se).optional()})).min(1).max(20)}),sa=k.object({kind:k.literal("paragraph"),title:k.string().max(120).optional(),text:k.string().min(1).max(3e3)}),ia=k.discriminatedUnion("kind",[Xo,ea,ta,ra,sa]),yt=k.object({title:k.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:k.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:Qo,sections:k.array(ia).max(20).default([]).superRefine((s,t)=>{s.forEach((e,r)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"rows"],message:"every row must have headers.length entries"})})}),footer:k.object({viewUrl:k.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:k.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),te=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),rs=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),na=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function ss(s,t,e=12){if(!Number.isFinite(s)||!Number.isFinite(t)||t<=0)return"";let r=Math.max(0,Math.min(1,s/t)),i=Math.round(r*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function gt(s,t){let e=String(s);return e.length>=t?e:e+" ".repeat(t-e.length)}function is(s,t){let e=String(s);return e.length>=t?e:" ".repeat(t-e.length)+e}function ns({headers:s,rows:t}){let e=s.map((o,a)=>{let c=Math.max(String(o).length,...t.map(d=>String(d[a]??"").length));return Math.min(c,32)}),r=o=>o.map((a,c)=>gt(a,e[c])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[r(s),i,...t.map(o=>r(o))].join(`
|
|
917
|
+
`)+"\n```"}function oa(s){let t=yt.parse(s),e=[];e.push({type:"header",text:{type:"plain_text",text:t.title.slice(0,150),emoji:!0}}),t.subtitle&&e.push({type:"context",elements:[{type:"mrkdwn",text:t.subtitle}]});let r=[`*${t.headline.primary}*`];if(t.headline.delta){let n=rs[t.headline.delta.direction]||"",o=t.headline.delta.severity?te[t.headline.delta.severity]:"";r.push(`${n} ${t.headline.delta.value} ${o}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
|
|
918
|
+
`+t.headline.summary),e.push({type:"section",text:{type:"mrkdwn",text:i}});for(let n of t.sections)switch(e.push({type:"divider"}),n.title&&e.push({type:"section",text:{type:"mrkdwn",text:`*${n.title}*`}}),n.kind){case"trend":{let o=Math.max(...n.values),a=n.labels.map((c,d)=>{let l=n.values[d],p=ss(l,o),m=(n.highlight==="last"&&d===n.labels.length-1||n.highlight==="max"&&l===o||n.highlight==="min"&&l===Math.min(...n.values))&&n.severity?` ${te[n.severity]}`:"";return`${gt(c,10)} ${is(l.toLocaleString(),8)} ${p}${m}`});e.push({type:"section",text:{type:"mrkdwn",text:"```\n"+a.join(`
|
|
917
919
|
`)+"\n```"}});break}case"table":{e.push({type:"section",text:{type:"mrkdwn",text:ns(n)}});break}case"callouts":{let o=te[n.tone||"info"];e.push({type:"section",text:{type:"mrkdwn",text:n.items.map(a=>`${o} ${a}`).join(`
|
|
918
920
|
`)}});break}case"breakdown":{let o=n.rows.map(a=>({type:"mrkdwn",text:`*${a.label}*
|
|
919
921
|
${a.value}${a.sub?`
|
|
920
|
-
_${a.sub}_`:""}${a.severity?` ${te[a.severity]}`:""}`}));for(let a=0;a<o.length;a+=10)e.push({type:"section",fields:o.slice(a,a+10)});break}case"paragraph":{e.push({type:"section",text:{type:"mrkdwn",text:n.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let n=[];t.footer.viewUrl&&n.push({type:"button",text:{type:"plain_text",text:"View in Zibby"},url:t.footer.viewUrl,style:"primary"}),t.footer.rerunUrl&&n.push({type:"button",text:{type:"plain_text",text:"Run again"},url:t.footer.rerunUrl}),e.push({type:"divider"}),e.push({type:"actions",elements:n})}return e}function
|
|
921
|
-
`+t.headline.summary),e.push({tag:"div",text:{tag:"lark_md",content:i}});for(let o of t.sections)switch(e.push({tag:"hr"}),o.title&&e.push({tag:"div",text:{tag:"lark_md",content:`**${o.title}**`}}),o.kind){case"trend":{let a=Math.max(...o.values),c=o.labels.map((d,l)=>{let p=o.values[l],u=ss(p,a),f=(o.highlight==="last"&&l===o.labels.length-1||o.highlight==="max"&&p===a||o.highlight==="min"&&p===Math.min(...o.values))&&o.severity?` ${te[o.severity]}`:"";return`${
|
|
922
|
+
_${a.sub}_`:""}${a.severity?` ${te[a.severity]}`:""}`}));for(let a=0;a<o.length;a+=10)e.push({type:"section",fields:o.slice(a,a+10)});break}case"paragraph":{e.push({type:"section",text:{type:"mrkdwn",text:n.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let n=[];t.footer.viewUrl&&n.push({type:"button",text:{type:"plain_text",text:"View in Zibby"},url:t.footer.viewUrl,style:"primary"}),t.footer.rerunUrl&&n.push({type:"button",text:{type:"plain_text",text:"Run again"},url:t.footer.rerunUrl}),e.push({type:"divider"}),e.push({type:"actions",elements:n})}return e}function aa(s){let t=yt.parse(s),e=[],r=[`**${t.headline.primary}**`];if(t.headline.delta){let o=rs[t.headline.delta.direction]||"",a=t.headline.delta.severity?te[t.headline.delta.severity]:"";r.push(`${o} ${t.headline.delta.value} ${a}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
|
|
923
|
+
`+t.headline.summary),e.push({tag:"div",text:{tag:"lark_md",content:i}});for(let o of t.sections)switch(e.push({tag:"hr"}),o.title&&e.push({tag:"div",text:{tag:"lark_md",content:`**${o.title}**`}}),o.kind){case"trend":{let a=Math.max(...o.values),c=o.labels.map((d,l)=>{let p=o.values[l],u=ss(p,a),f=(o.highlight==="last"&&l===o.labels.length-1||o.highlight==="max"&&p===a||o.highlight==="min"&&p===Math.min(...o.values))&&o.severity?` ${te[o.severity]}`:"";return`${gt(d,10)} ${is(p.toLocaleString(),8)} ${u}${f}`});e.push({tag:"div",text:{tag:"lark_md",content:"```\n"+c.join(`
|
|
922
924
|
`)+"\n```"}});break}case"table":{e.push({tag:"div",text:{tag:"lark_md",content:ns(o)}});break}case"callouts":{let a=te[o.tone||"info"];e.push({tag:"div",text:{tag:"lark_md",content:o.items.map(c=>`${a} ${c}`).join(`
|
|
923
925
|
`)}});break}case"breakdown":{let a=o.rows.map(c=>{let d=c.severity?` ${te[c.severity]}`:"",l=c.sub?` *${c.sub}*`:"";return`**${c.label}** ${c.value}${l}${d}`});e.push({tag:"div",text:{tag:"lark_md",content:a.join(`
|
|
924
|
-
`)}});break}case"paragraph":{e.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let o=[];t.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:t.footer.viewUrl,type:"primary"}),t.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:t.footer.rerunUrl,type:"default"}),e.push({tag:"hr"}),e.push({tag:"action",actions:o})}let n="blue";return t.headline.delta?.severity&&(n=
|
|
926
|
+
`)}});break}case"paragraph":{e.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let o=[];t.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:t.footer.viewUrl,type:"primary"}),t.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:t.footer.rerunUrl,type:"default"}),e.push({tag:"hr"}),e.push({tag:"action",actions:o})}let n="blue";return t.headline.delta?.severity&&(n=na[t.headline.delta.severity]||"blue"),{config:{wide_screen_mode:!0},header:{title:{tag:"plain_text",content:t.title.slice(0,200)},subtitle:t.subtitle?{tag:"plain_text",content:t.subtitle.slice(0,200)}:void 0,template:n},elements:e}}var $l=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),El=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});import{createRequire as ca}from"module";import{fileURLToPath as la}from"url";import{registerHandlers as da}from"@zibby/core/function-skill-registry.js";import{registerSkill as pa}from"@zibby/agent-workflow";var ua=ca(import.meta.url);function ma(){try{return ua.resolve("@zibby/core/function-bridge.js")}catch{return null}}var fa=import.meta.url;function ha(){let s=Error.prepareStackTrace;try{Error.prepareStackTrace=(r,i)=>i;let e=new Error().stack;for(let r=2;r<e.length;r++){let i=e[r].getFileName();if(i&&i!==fa&&!i.startsWith("node:"))return i.startsWith("file://")?la(i):i}return null}finally{Error.prepareStackTrace=s}}function ya(s){if(!s||typeof s!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[r,i]of Object.entries(s))if(typeof i=="string")t[r]={type:i},e.push(r);else{let{required:n,...o}=i;t[r]=o,n!==!1&&e.push(r)}return{type:"object",properties:t,required:e}}function ga(s,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r={[s]:e.handler},i=[{name:s,description:e.description||"",input_schema:ya(e.input)}];return da(s,r,i),{id:s,type:"function",serverName:s,allowedTools:[`mcp__${s}__*`],description:e.description||`Function skill: ${s}`,envKeys:[],tools:i,resolve(){let n=ma();return n?{command:"node",args:[n,t,s]}:null}}}function _a(s,t){return{id:s,type:"mcp",serverName:t.serverName||s,allowedTools:t.allowedTools||[`mcp__${t.serverName||s}__*`],description:t.description||`MCP skill: ${s}`,envKeys:t.envKeys||[],tools:t.tools||[],resolve:t.resolve,...t.cursorKey&&{cursorKey:t.cursorKey},...t.sessionEnvKey&&{sessionEnvKey:t.sessionEnvKey}}}function os(s,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r=ha();if(!r)throw new Error(`Could not resolve caller file for skill "${s}".`);e=ga(s,r,t)}else if(typeof t.resolve=="function")e=_a(s,t);else throw new Error(`Skill "${s}" must have either a handler (function skill) or resolve (MCP skill).`);return pa(e),e}var ba=os;import{registerSkill as yd,getSkill as gd,hasSkill as _d,getAllSkills as bd,listSkillIds as kd}from"@zibby/agent-workflow";I(_t);I(wt);I(ae);I(ce);I(Nt);I(Ot);I(Rt);I(Tt);I(L);I(K);I(Pt);I(qt);I(Re);I(Ut);I(cr);I(X);I(fr);I(Dt);I(Ht);I(Ar);I(Cr);I(Ur);I(Zr);I(mt);I(ft);I(ht);I({...L,id:"slack_notify"});var dd={BROWSER:"browser",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",FIGMA:"figma",LINEAR:"linear",PLANE:"plane",OPEN_DESIGN:"open-design",GIT:"git",GIT_WRITE:"git-write",SLACK:"slack",LARK:"lark",NOTION:"notion",CHAT_NOTIFY:"chat_notify",SENTRY:"sentry",MEMORY:"memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools",CHAT_MEMORY:"chat-memory",KV_MEMORY:"kv-memory",CODEBASE_MEMORY:"codebase-memory",WORKFLOW_BUILDER:"workflow-builder",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin"};export{N as INTEGRATIONS,hs as INTEGRATION_REGISTRY,Se as REPORT_SEVERITIES,dd as SKILLS,ft as anthropicBillingSkill,_t as browserSkill,Ar as chatMemorySkill,qt as chatNotifySkill,Ur as codebaseMemorySkill,Ht as coreToolsSkill,ht as cursorAdminSkill,Yo as fetchAllProviders,es as fetchAnthropicCosts,Wo as fetchAnthropicWorkspaces,ts as fetchCursorSpend,Xr as fetchOpenAICosts,zo as fetchOpenAIProjects,Nt as figmaSkill,ba as functionSkill,bd as getAllSkills,gd as getSkill,X as gitSkill,fr as gitWriteSkill,ae as githubSkill,ce as gitlabSkill,Zo as groupByKey,_d as hasSkill,wt as jiraSkill,Cr as kvMemorySkill,K as larkSkill,Ot as linearSkill,kd as listSkillIds,Vo as meanStddev,Ut as memorySkill,Pt as notionSkill,mt as openaiBillingSkill,Tt as opendesignSkill,Rt as planeSkill,yd as registerSkill,yt as reportObjectSchema,oa as reportToBlockKit,aa as reportToLarkCard,cr as runnerSkill,Re as sentrySkill,os as skill,Dt as skillInstallerSkill,L as slackSkill,cr as testRunnerSkill,Zr as workflowBuilderSkill};
|