@zibby/skills 0.2.3 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -21,7 +21,7 @@ ${"#".repeat(s)} ${i.trim()}
21
21
  ${i}
22
22
  `):t.push(i)}return t.join("").replace(/\n{3,}/g,`
23
23
 
24
- `)}function Le(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Ht(r){return Le(r).replace(/[a-z0-9]+/g,"")}function lt(r,e){let t=Le(r),n=Le(e);if(!t||!n)return 0;if(t===n)return 1;if(t.length===1||n.length===1)return t===n?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},s=i(t),o=i(n),a=0,c=0,d=0;for(let l of s.values())c+=l;for(let l of o.values())d+=l;for(let[l,p]of s.entries()){let u=o.get(l)||0;a+=Math.min(p,u)}return 2*a/Math.max(1,c+d)}function ue(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function bo(r,e=[]){let t=Array.isArray(e)?e:[];if(t.length===0)return{requested:r||null,resolved:null,strategy:"none"};let n=t.filter(a=>!a.subtask),i=n.length>0?n:t,s=ue(r);if(s){let a=i.find(l=>ue(l.name)===s);if(a)return{requested:r,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=>ue(u)===s))continue;let p=i.find(u=>l.some(m=>ue(m)===ue(u.name)));if(p)return{requested:r,resolved:p,strategy:"alias"}}let d=i.map(l=>({t:l,score:lt(r,l.name)})).sort((l,p)=>p.score-l.score);if(d[0]&&d[0].score>=.5)return{requested:r,resolved:d[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=i.find(d=>ue(d.name)===a);if(c)return{requested:r||null,resolved:c,strategy:"default-preferred"}}return{requested:r||null,resolved:i[0],strategy:"default-first"}}async function Fr(r){let e=`projectKeys=${encodeURIComponent(r)}&expand=projects.issuetypes`,t=await L(`/rest/api/3/issue/createmeta?${e}`),n=Array.isArray(t?.projects)?t.projects:[],s=n.find(a=>String(a?.key||"").toUpperCase()===String(r||"").toUpperCase())||n[0]||null;return(Array.isArray(s?.issuetypes)?s.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function Kr(r,e){if(!r)throw new Error("projectKey is required");let t="sprint is not EMPTY";e==="active"?t="sprint in openSprints()":e==="closed"?t="sprint in closedSprints()":e==="future"&&(t="sprint in futureSprints()");let n=`project = ${r} AND ${t} ORDER BY updated DESC`,i=`jql=${encodeURIComponent(n)}&maxResults=100&fields=customfield_10020`,s=await L(`/rest/api/3/search/jql?${i}`),o=new Map;for(let a of s.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 ko(r,{sprintId:e,sprintName:t,target:n}={}){let i=Array.isArray(r)?r:[];if(!i.length)return{sprint:null,selectedBy:"none"};if(e!=null&&String(e).trim()!=="")return{sprint:i.find(a=>String(a.id)===String(e))||null,selectedBy:"id"};if(t&&String(t).trim()){let o=String(t).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:lt(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 s=String(n||"current").trim().toLowerCase();return s==="active"||s==="current"||s==="latest"?{sprint:i[0],selectedBy:s}:{sprint:i[0],selectedBy:"default"}}function wo(r,e){let t=r?.fields?.customfield_10020;return Array.isArray(t)?t.some(n=>String(n?.id)===String(e)):!1}async function So({issueKey:r,projectKey:e,sprintId:t,attempts:n=3,delayMs:i=450}){let s=[];for(let o=0;o<n;o++){try{let a=`project = ${e} AND key = ${r} AND sprint = ${t}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,d=await L(`/rest/api/3/search/jql?${c}`);if(Number(d?.total||0)>0)return s.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:s};let p=await L(`/rest/api/3/issue/${r}?fields=customfield_10020,status`),u=wo(p,t);if(s.push({attempt:o+1,jql:!1,issueField:u}),u)return{ok:!0,method:"issue_field",traces:s}}catch(a){s.push({attempt:o+1,error:String(a?.message||a)})}o<n-1&&await new Promise(a=>setTimeout(a,i))}return{ok:!1,method:"none",traces:s}}async function zt({issueKey:r,projectKey:e,sprintId:t,sprintName:n,target:i}){if(!r)return{ok:!1,error:"issueKey is required"};let s=e;if(!s&&(s=(await L(`/rest/api/3/issue/${r}?fields=project`))?.fields?.project?.key||null,!s))return{ok:!1,error:`Could not resolve project for ${r}`};let o=await Kr(s,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${s}`};let{sprint:a,selectedBy:c}=ko(o,{sprintId:t,sprintName:n,target:i});if(!a)return{ok:!1,error:`No matching sprint found in ${s}`,requested:{sprintId:t??null,sprintName:n??null,target:i??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await L(`/rest/api/3/issue/${r}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let d=await So({issueKey:r,projectKey:s,sprintId:a.id}),l=d.ok;return{ok:l,issueKey:r,projectKey:s,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 ${r} in sprint ${a.id}`}}async function L(r,e={}){let t=async()=>{let{token:n,cloudId:i}=await mo("jira");if(typeof n!="string"||!n)throw new Error(`Invalid jira token type: ${typeof n}`);if(!i)throw new Error("Invalid jira cloudId: missing");let s=`https://api.atlassian.com/ex/jira/${i}${r}`,o=await fetch(s,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.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 t()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("403")||i.includes("substring")))throw n;return fo("jira"),t()}}var Gr={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)
24
+ `)}function Le(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Ht(r){return Le(r).replace(/[a-z0-9]+/g,"")}function lt(r,e){let t=Le(r),n=Le(e);if(!t||!n)return 0;if(t===n)return 1;if(t.length===1||n.length===1)return t===n?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},s=i(t),o=i(n),a=0,c=0,d=0;for(let l of s.values())c+=l;for(let l of o.values())d+=l;for(let[l,p]of s.entries()){let u=o.get(l)||0;a+=Math.min(p,u)}return 2*a/Math.max(1,c+d)}function ue(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function bo(r,e=[]){let t=Array.isArray(e)?e:[];if(t.length===0)return{requested:r||null,resolved:null,strategy:"none"};let n=t.filter(a=>!a.subtask),i=n.length>0?n:t,s=ue(r);if(s){let a=i.find(l=>ue(l.name)===s);if(a)return{requested:r,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=>ue(u)===s))continue;let p=i.find(u=>l.some(m=>ue(m)===ue(u.name)));if(p)return{requested:r,resolved:p,strategy:"alias"}}let d=i.map(l=>({t:l,score:lt(r,l.name)})).sort((l,p)=>p.score-l.score);if(d[0]&&d[0].score>=.5)return{requested:r,resolved:d[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=i.find(d=>ue(d.name)===a);if(c)return{requested:r||null,resolved:c,strategy:"default-preferred"}}return{requested:r||null,resolved:i[0],strategy:"default-first"}}async function Fr(r){let e=`projectKeys=${encodeURIComponent(r)}&expand=projects.issuetypes`,t=await L(`/rest/api/3/issue/createmeta?${e}`),n=Array.isArray(t?.projects)?t.projects:[],s=n.find(a=>String(a?.key||"").toUpperCase()===String(r||"").toUpperCase())||n[0]||null;return(Array.isArray(s?.issuetypes)?s.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function Kr(r,e){if(!r)throw new Error("projectKey is required");let t="sprint is not EMPTY";e==="active"?t="sprint in openSprints()":e==="closed"?t="sprint in closedSprints()":e==="future"&&(t="sprint in futureSprints()");let n=`project = ${r} AND ${t} ORDER BY updated DESC`,i=`jql=${encodeURIComponent(n)}&maxResults=100&fields=customfield_10020`,s=await L(`/rest/api/3/search/jql?${i}`),o=new Map;for(let a of s.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 ko(r,{sprintId:e,sprintName:t,target:n}={}){let i=Array.isArray(r)?r:[];if(!i.length)return{sprint:null,selectedBy:"none"};if(e!=null&&String(e).trim()!=="")return{sprint:i.find(a=>String(a.id)===String(e))||null,selectedBy:"id"};if(t&&String(t).trim()){let o=String(t).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:lt(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 s=String(n||"current").trim().toLowerCase();return s==="active"||s==="current"||s==="latest"?{sprint:i[0],selectedBy:s}:{sprint:i[0],selectedBy:"default"}}function wo(r,e){let t=r?.fields?.customfield_10020;return Array.isArray(t)?t.some(n=>String(n?.id)===String(e)):!1}async function So({issueKey:r,projectKey:e,sprintId:t,attempts:n=3,delayMs:i=450}){let s=[];for(let o=0;o<n;o++){try{let a=`project = ${e} AND key = ${r} AND sprint = ${t}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,d=await L(`/rest/api/3/search/jql?${c}`);if(Number(d?.total||0)>0)return s.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:s};let p=await L(`/rest/api/3/issue/${r}?fields=customfield_10020,status`),u=wo(p,t);if(s.push({attempt:o+1,jql:!1,issueField:u}),u)return{ok:!0,method:"issue_field",traces:s}}catch(a){s.push({attempt:o+1,error:String(a?.message||a)})}o<n-1&&await new Promise(a=>setTimeout(a,i))}return{ok:!1,method:"none",traces:s}}async function zt({issueKey:r,projectKey:e,sprintId:t,sprintName:n,target:i}){if(!r)return{ok:!1,error:"issueKey is required"};let s=e;if(!s&&(s=(await L(`/rest/api/3/issue/${r}?fields=project`))?.fields?.project?.key||null,!s))return{ok:!1,error:`Could not resolve project for ${r}`};let o=await Kr(s,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${s}`};let{sprint:a,selectedBy:c}=ko(o,{sprintId:t,sprintName:n,target:i});if(!a)return{ok:!1,error:`No matching sprint found in ${s}`,requested:{sprintId:t??null,sprintName:n??null,target:i??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await L(`/rest/api/3/issue/${r}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let d=await So({issueKey:r,projectKey:s,sprintId:a.id}),l=d.ok;return{ok:l,issueKey:r,projectKey:s,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 ${r} in sprint ${a.id}`}}async function L(r,e={}){let t=async()=>{let{token:n,cloudId:i}=await mo("jira");if(typeof n!="string"||!n)throw new Error(`Invalid jira token type: ${typeof n}`);if(!i)throw new Error("Invalid jira cloudId: missing");let s=`https://api.atlassian.com/ex/jira/${i}${r}`,o=await fetch(s,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.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 t()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("403")||i.includes("substring")))throw n;return fo("jira"),t()}}var Gr={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
25
25
  You have direct access to the user's Jira. Use these tools proactively:
26
26
 
27
27
  ### Issue tools
@@ -71,22 +71,21 @@ 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 r=yo();if(!r)return null;let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);process.env.ATLASSIAN_INSTANCE_URL&&(e.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let t of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[t]&&(e[t]=process.env[t]);return{command:"node",args:[r],env:e,description:this.description}},async handleToolCall(r,e){try{switch(r){case"jira_list_projects":{let t=await L("/rest/api/3/project"),n=(Array.isArray(t)?t:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:n.length,projects:n})}case"jira_list_statuses":{let{projectKey:t}=e||{};if(t){let s=await L(`/rest/api/3/project/${encodeURIComponent(t)}/statuses`),o=Array.isArray(s)?s:[],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:t,count:c.length,statuses:c})}let n=await L("/rest/api/3/status"),i=(Array.isArray(n)?n:[]).map(s=>({id:s.id,name:s.name,category:s.statusCategory?.name||null})).sort((s,o)=>String(s.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:t}=e||{};if(!t)return JSON.stringify({error:"projectKey is required"});let n=await Fr(t);return JSON.stringify({projectKey:t,count:n.length,issueTypes:n})}case"jira_search":{let t=e.jql||"",n=e.maxResults||20;t.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(t=`created >= -365d ${t}`.trim());let s=`jql=${encodeURIComponent(t)}&maxResults=${n}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await L(`/rest/api/3/search/jql?${s}`)).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 t=e.issueKey;if(!t)return JSON.stringify({error:"issueKey is required"});let n=await L(`/rest/api/3/issue/${t}`);return JSON.stringify({key:n.key,project:n.fields?.project?.key,summary:n.fields?.summary,description:n.fields?.description,status:n.fields?.status?.name,assignee:n.fields?.assignee?.displayName||"Unassigned",priority:n.fields?.priority?.name,type:n.fields?.issuetype?.name,labels:n.fields?.labels,created:n.fields?.created,updated:n.fields?.updated})}case"jira_create_issue":{let{projectKey:t,summary:n,issueType:i,description:s,priority:o,labels:a,assigneeId:c,moveToSprint:d,moveToActiveSprint:l,sprintId:p,sprintName:u,target:m}=e;if(!t||!n)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await Fr(t),f=bo(i,h)}catch{}let b={project:{key:t},summary:n,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};s&&(b.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}),o&&(b.priority={name:o}),a?.length&&(b.labels=a),c&&(b.assignee={id:c});let g=await L("/rest/api/3/issue",{method:"POST",body:{fields:b}}),_={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(_.issueType=f.resolved.name,_.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&ue(f.requested)!==ue(f.resolved.name)&&(_.issueTypeWarning=`Requested "${f.requested}" is not available in ${t}; used "${f.resolved.name}" instead.`)),h.length>0&&(_.availableIssueTypes=h.map(y=>y.name)),(d||l)&&(_.sprintMove=await zt({issueKey:g.key,projectKey:t,sprintId:p,sprintName:u,target:m})),JSON.stringify(_)}case"jira_list_sprints":{let{projectKey:t,state:n}=e,i=await Kr(t,n);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o}=e||{},a=await zt({issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o}=e||{},a=await zt({issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:t,sprintId:n,projectKey:i,status:s,maxResults:o}=e;if(!t&&!n)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=n?`sprint = ${n}`:`sprint = "${t}"`,d=i?`project = ${i} AND `:"",l=s?` AND status = "${s}"`:"",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 L(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(b=>({key:b.key,project:b.fields?.project?.key,summary:b.fields?.summary,status:b.fields?.status?.name,assignee:b.fields?.assignee?.displayName||"Unassigned",priority:b.fields?.priority?.name,type:b.fields?.issuetype?.name})),h={};for(let b of f)h[b.status]=(h[b.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:t,maxResults:n}=e;if(!t)return JSON.stringify({error:"issueKey is required"});let s=await L(`/rest/api/3/issue/${t}/comment?maxResults=${n||50}&orderBy=-created`),o=(s.comments||[]).map(a=>{let c="";return a.body?.content&&(c=ct(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:s.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:t,body:n}=e;return!t||!n?JSON.stringify({error:"issueKey and body are required"}):(await L(`/rest/api/3/issue/${t}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}}}),JSON.stringify({ok:!0,issueKey:t}))}case"jira_edit_issue":{let{issueKey:t,fields:n}=e;return!t||!n?JSON.stringify({error:"issueKey and fields are required"}):(await L(`/rest/api/3/issue/${t}`,{method:"PUT",body:{fields:n}}),JSON.stringify({ok:!0,issueKey:t}))}case"jira_transition_issue":{let{issueKey:t,transitionId:n,toStatus:i,statusName:s,status:o}=e;if(!t)return JSON.stringify({error:"issueKey is required"});let a=String(i||s||o||"").trim();if(!n&&!a){let p=((await L(`/rest/api/3/issue/${t}/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:t,availableTransitions:p})}let c=n;if(!c){let p=(await L(`/rest/api/3/issue/${t}/transitions`)).transitions||[],u=Le(a),m=p.find(f=>Le(f?.name||"")===u||Le(f?.to?.name||"")===u);if(!m){let f=Ht(a);f.length>=2&&(m=p.find(h=>{let b=Ht(h?.name||""),g=Ht(h?.to?.name||""),_=b.length>=2&&(b.includes(f)||f.includes(b)),y=g.length>=2&&(g.includes(f)||f.includes(g));return _||y}))}if(!m){let f=p.map(_=>{let y=lt(a,_?.name||""),k=lt(a,_?.to?.name||"");return{t:_,score:Math.max(y,k)}}).sort((_,y)=>y.score-_.score),h=f[0],b=f[1];h&&h.score>=.45&&(!b||h.score-b.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:t,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await L(`/rest/api/3/issue/${t}/transitions`,{method:"POST",body:{transition:{id:c}}});let d=await L(`/rest/api/3/issue/${t}?fields=status`);return JSON.stringify({ok:!0,issueKey:t,transitionId:c,statusAfter:d?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 Uo}from"fs";import{fileURLToPath as Jo}from"url";import{dirname as qo,resolve as Bo}from"path";import{resolveIntegrationToken as Vr}from"@zibby/core/backend-client.js";import{spawn as Io,execSync as vo}from"child_process";import{existsSync as V,mkdirSync as No,readdirSync as Yr,statSync as Oo,readFileSync as To}from"fs";import{resolve as Yt,join as Q,basename as Ro}from"path";var Wt=".zibby/repos";function Hr(r,e){try{let t=new URL(r);return t.protocol==="https:"&&t.host.toLowerCase()===e.toLowerCase()}catch{return!1}}function zr(r,e,t){let n=new URL(r);return n.username=encodeURIComponent(e),n.password=encodeURIComponent(t),n.toString()}function Ao(r){let e=String(r??"");for(let t of[process.env.GITHUB_TOKEN,process.env.GITLAB_TOKEN])t&&(e=e.split(t).join("***"));return e.replace(/x-access-token:[^@\s]*@/g,"x-access-token:***@").replace(/oauth2:[^@\s]*@/g,"oauth2:***@").replace(/https?:\/\/[^/@\s:]+:[^@\s]+@/g,t=>t.replace(/:[^@\s]+@/,":***@"))}function Ge(r,e,t,n,i="clone"){try{r(`git -C "${e}" remote set-url origin "${t}"`,{stdio:"pipe"})}catch(s){let o=String(s?.message||s);n&&(o=o.split(n).join("***")),console.error(`[${i}] WARNING: failed to strip token from .git/config: ${o}`)}}function dt(r,e,t={}){return new Promise((n,i)=>{let s=Io(r,{cwd:e,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...t}}),o="",a="";s.stdout.on("data",c=>{o+=c.toString()}),s.stderr.on("data",c=>{a+=c.toString()}),s.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):n(o.trim())}),s.on("error",c=>i(c))})}var me={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],promptFragment:`## Git Repositories
74
+ 6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=yo();if(!r)return null;let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);process.env.ATLASSIAN_INSTANCE_URL&&(e.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let t of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[t]&&(e[t]=process.env[t]);return{command:"node",args:[r],env:e,description:this.description}},async handleToolCall(r,e){try{switch(r){case"jira_list_projects":{let t=await L("/rest/api/3/project"),n=(Array.isArray(t)?t:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:n.length,projects:n})}case"jira_list_statuses":{let{projectKey:t}=e||{};if(t){let s=await L(`/rest/api/3/project/${encodeURIComponent(t)}/statuses`),o=Array.isArray(s)?s:[],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:t,count:c.length,statuses:c})}let n=await L("/rest/api/3/status"),i=(Array.isArray(n)?n:[]).map(s=>({id:s.id,name:s.name,category:s.statusCategory?.name||null})).sort((s,o)=>String(s.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:t}=e||{};if(!t)return JSON.stringify({error:"projectKey is required"});let n=await Fr(t);return JSON.stringify({projectKey:t,count:n.length,issueTypes:n})}case"jira_search":{let t=e.jql||"",n=e.maxResults||20;t.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(t=`created >= -365d ${t}`.trim());let s=`jql=${encodeURIComponent(t)}&maxResults=${n}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await L(`/rest/api/3/search/jql?${s}`)).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 t=e.issueKey;if(!t)return JSON.stringify({error:"issueKey is required"});let n=await L(`/rest/api/3/issue/${t}`);return JSON.stringify({key:n.key,project:n.fields?.project?.key,summary:n.fields?.summary,description:n.fields?.description,status:n.fields?.status?.name,assignee:n.fields?.assignee?.displayName||"Unassigned",priority:n.fields?.priority?.name,type:n.fields?.issuetype?.name,labels:n.fields?.labels,created:n.fields?.created,updated:n.fields?.updated})}case"jira_create_issue":{let{projectKey:t,summary:n,issueType:i,description:s,priority:o,labels:a,assigneeId:c,moveToSprint:d,moveToActiveSprint:l,sprintId:p,sprintName:u,target:m}=e;if(!t||!n)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await Fr(t),f=bo(i,h)}catch{}let b={project:{key:t},summary:n,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};s&&(b.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}),o&&(b.priority={name:o}),a?.length&&(b.labels=a),c&&(b.assignee={id:c});let g=await L("/rest/api/3/issue",{method:"POST",body:{fields:b}}),_={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(_.issueType=f.resolved.name,_.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&ue(f.requested)!==ue(f.resolved.name)&&(_.issueTypeWarning=`Requested "${f.requested}" is not available in ${t}; used "${f.resolved.name}" instead.`)),h.length>0&&(_.availableIssueTypes=h.map(y=>y.name)),(d||l)&&(_.sprintMove=await zt({issueKey:g.key,projectKey:t,sprintId:p,sprintName:u,target:m})),JSON.stringify(_)}case"jira_list_sprints":{let{projectKey:t,state:n}=e,i=await Kr(t,n);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o}=e||{},a=await zt({issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o}=e||{},a=await zt({issueKey:t,projectKey:n,sprintId:i,sprintName:s,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:t,sprintId:n,projectKey:i,status:s,maxResults:o}=e;if(!t&&!n)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=n?`sprint = ${n}`:`sprint = "${t}"`,d=i?`project = ${i} AND `:"",l=s?` AND status = "${s}"`:"",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 L(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(b=>({key:b.key,project:b.fields?.project?.key,summary:b.fields?.summary,status:b.fields?.status?.name,assignee:b.fields?.assignee?.displayName||"Unassigned",priority:b.fields?.priority?.name,type:b.fields?.issuetype?.name})),h={};for(let b of f)h[b.status]=(h[b.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:t,maxResults:n}=e;if(!t)return JSON.stringify({error:"issueKey is required"});let s=await L(`/rest/api/3/issue/${t}/comment?maxResults=${n||50}&orderBy=-created`),o=(s.comments||[]).map(a=>{let c="";return a.body?.content&&(c=ct(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:s.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:t,body:n}=e;return!t||!n?JSON.stringify({error:"issueKey and body are required"}):(await L(`/rest/api/3/issue/${t}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}}}),JSON.stringify({ok:!0,issueKey:t}))}case"jira_edit_issue":{let{issueKey:t,fields:n}=e;return!t||!n?JSON.stringify({error:"issueKey and fields are required"}):(await L(`/rest/api/3/issue/${t}`,{method:"PUT",body:{fields:n}}),JSON.stringify({ok:!0,issueKey:t}))}case"jira_transition_issue":{let{issueKey:t,transitionId:n,toStatus:i,statusName:s,status:o}=e;if(!t)return JSON.stringify({error:"issueKey is required"});let a=String(i||s||o||"").trim();if(!n&&!a){let p=((await L(`/rest/api/3/issue/${t}/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:t,availableTransitions:p})}let c=n;if(!c){let p=(await L(`/rest/api/3/issue/${t}/transitions`)).transitions||[],u=Le(a),m=p.find(f=>Le(f?.name||"")===u||Le(f?.to?.name||"")===u);if(!m){let f=Ht(a);f.length>=2&&(m=p.find(h=>{let b=Ht(h?.name||""),g=Ht(h?.to?.name||""),_=b.length>=2&&(b.includes(f)||f.includes(b)),y=g.length>=2&&(g.includes(f)||f.includes(g));return _||y}))}if(!m){let f=p.map(_=>{let y=lt(a,_?.name||""),k=lt(a,_?.to?.name||"");return{t:_,score:Math.max(y,k)}}).sort((_,y)=>y.score-_.score),h=f[0],b=f[1];h&&h.score>=.45&&(!b||h.score-b.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:t,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await L(`/rest/api/3/issue/${t}/transitions`,{method:"POST",body:{transition:{id:c}}});let d=await L(`/rest/api/3/issue/${t}?fields=status`);return JSON.stringify({ok:!0,issueKey:t,transitionId:c,statusAfter:d?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 Uo}from"fs";import{fileURLToPath as Jo}from"url";import{dirname as Bo,resolve as qo}from"path";import{resolveIntegrationToken as Vr}from"@zibby/core/backend-client.js";import{spawn as Io,execSync as vo}from"child_process";import{existsSync as V,mkdirSync as No,readdirSync as Yr,statSync as Oo,readFileSync as To}from"fs";import{resolve as Yt,join as Q,basename as Ro}from"path";var Wt=".zibby/repos";function Hr(r,e){try{let t=new URL(r);return t.protocol==="https:"&&t.host.toLowerCase()===e.toLowerCase()}catch{return!1}}function zr(r,e,t){let n=new URL(r);return n.username=encodeURIComponent(e),n.password=encodeURIComponent(t),n.toString()}function Ao(r){let e=String(r??"");for(let t of[process.env.GITHUB_TOKEN,process.env.GITLAB_TOKEN])t&&(e=e.split(t).join("***"));return e.replace(/x-access-token:[^@\s]*@/g,"x-access-token:***@").replace(/oauth2:[^@\s]*@/g,"oauth2:***@").replace(/https?:\/\/[^/@\s:]+:[^@\s]+@/g,t=>t.replace(/:[^@\s]+@/,":***@"))}function Ge(r,e,t,n,i="clone"){try{r(`git -C "${e}" remote set-url origin "${t}"`,{stdio:"pipe"})}catch(s){let o=String(s?.message||s);n&&(o=o.split(n).join("***")),console.error(`[${i}] WARNING: failed to strip token from .git/config: ${o}`)}}function dt(r,e,t={}){return new Promise((n,i)=>{let s=Io(r,{cwd:e,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...t}}),o="",a="";s.stdout.on("data",c=>{o+=c.toString()}),s.stderr.on("data",c=>{a+=c.toString()}),s.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):n(o.trim())}),s.on("error",c=>i(c))})}var me={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],inProcessOnly:!0,promptFragment:`## Git Repositories
75
75
  You can clone and explore git repositories locally for codebase analysis:
76
76
  - git_checkout: Clone a repo (or pull if already cloned). Supports GitHub and GitLab with auto-auth.
77
77
  - git_list_repos: List locally cloned repos
78
78
  - git_explore: Quick overview of a cloned repo's structure (key files, package.json, routes, etc.)
79
79
 
80
- When a test ticket lacks context, use this workflow:
80
+ When your task needs repository context you don't have yet:
81
81
  1. Clone the relevant repo with git_checkout
82
82
  2. Use git_explore to understand the project structure
83
83
  3. Use shell commands (grep, cat) to read specific files for deeper understanding
84
- 4. Use GitHub/GitLab skills to read related PRs and commits
85
- 5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await Eo(e,n);case"git_list_repos":return xo(e,n);case"git_explore":return Lo(e,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:Ao(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 Eo(r,e){let{url:t,branch:n,shallow:i=!0,name:s}=r;!t.includes("://")&&!t.startsWith("git@")&&(t=`https://github.com/${t}`);let o=s||Ro(t.replace(/\.git$/,"")),a=Yt(e,Wt);No(a,{recursive:!0});let c=Q(a,o),d=t,l=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,u=process.env.GITLAB_URL;if(Hr(t,"github.com")&&l)d=zr(t,"x-access-token",l);else if(p&&u)try{let h=new URL(u).host;Hr(t,h)&&(d=zr(t,"oauth2",p))}catch{}if(V(Q(c,".git"))){let h=n?`git -C "${c}" fetch "${d}" ${n} && git -C "${c}" checkout ${n} && git -C "${c}" merge --ff-only FETCH_HEAD`:`git -C "${c}" pull "${d}"`;await dt(h,e);let b=await dt(`git -C "${c}" log -1 --format="%h %s"`,e);return JSON.stringify({action:"updated",repo:o,path:c,branch:n||"default",head:b})}let m=["git","clone"];i&&m.push("--depth","1"),n&&m.push("--branch",n),m.push(`"${d}"`,`"${c}"`),await dt(m.join(" "),e),Ge(vo,c,t,l||p,"git_checkout");let f=await dt(`git -C "${c}" log -1 --format="%h %s"`,e);return JSON.stringify({action:"cloned",repo:o,path:c,branch:n||"default",shallow:i,head:f})}function xo(r,e){let t=Yt(e,Wt);if(!V(t))return JSON.stringify({repos:[],message:"No repos cloned yet"});let n=[];for(let i of Yr(t,{withFileTypes:!0})){if(!i.isDirectory())continue;let s=Q(t,i.name);if(!V(Q(s,".git")))continue;let o=Oo(s);n.push({name:i.name,path:s,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:n,total:n.length,directory:t})}function Lo(r,e){let{repo:t,depth:n=2}=r,i=Yt(e,Wt,t);if(!V(i))return JSON.stringify({error:`Repo not found: ${t}. Run git_checkout first.`});let s={repo:t,path:i},o=Q(i,"package.json");if(V(o))try{let m=JSON.parse(To(o,"utf-8"));s.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?s.framework="React":m.dependencies?.next?s.framework="Next.js":m.dependencies?.vue?s.framework="Vue":m.dependencies?.angular?s.framework="Angular":m.dependencies?.express?s.framework="Express":m.dependencies?.fastify&&(s.framework="Fastify")}catch{}let a=Q(i,"pyproject.toml");V(a)&&(s.language="Python");let c=Q(i,"go.mod");V(c)&&(s.language="Go");let d=Q(i,"Cargo.toml");V(d)&&(s.language="Rust"),V(o)&&(s.language=s.language||"JavaScript/TypeScript");let l=[];function p(m,f,h){if(h>n)return;let b;try{b=Yr(m,{withFileTypes:!0})}catch{return}let g=b.filter(_=>!_.name.startsWith(".")&&_.name!=="node_modules"&&_.name!=="__pycache__"&&_.name!=="dist"&&_.name!=="build"&&_.name!==".git").sort((_,y)=>_.isDirectory()!==y.isDirectory()?_.isDirectory()?-1:1:_.name.localeCompare(y.name));for(let _ of g){let y=_.isDirectory();l.push(`${f}${y?"\u{1F4C1}":"\u{1F4C4}"} ${_.name}`),y&&h<n&&p(Q(m,_.name),`${f} `,h+1)}}p(i,"",1),s.tree=l.slice(0,80),l.length>80&&(s.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 s.keyFilesFound=u.filter(m=>V(Q(i,m))),JSON.stringify(s)}import jo from"crypto";var Wr=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,Zr=/<!--\s*zbreview-summary\s*-->/i;function $o(r){return String(r||"").replace(Wr,"").replace(Zr,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function Po(r,e){return jo.createHash("sha256").update(`${String(r||"")}\0${$o(e)}`).digest("hex").slice(0,12)}function Co(r){return`
84
+ 4. Use GitHub/GitLab skills to read related PRs and commits when history matters`,resolve(){return null},async handleToolCall(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await Eo(e,n);case"git_list_repos":return xo(e,n);case"git_explore":return Lo(e,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:Ao(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 Eo(r,e){let{url:t,branch:n,shallow:i=!0,name:s}=r;!t.includes("://")&&!t.startsWith("git@")&&(t=`https://github.com/${t}`);let o=s||Ro(t.replace(/\.git$/,"")),a=Yt(e,Wt);No(a,{recursive:!0});let c=Q(a,o),d=t,l=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,u=process.env.GITLAB_URL;if(Hr(t,"github.com")&&l)d=zr(t,"x-access-token",l);else if(p&&u)try{let h=new URL(u).host;Hr(t,h)&&(d=zr(t,"oauth2",p))}catch{}if(V(Q(c,".git"))){let h=n?`git -C "${c}" fetch "${d}" ${n} && git -C "${c}" checkout ${n} && git -C "${c}" merge --ff-only FETCH_HEAD`:`git -C "${c}" pull "${d}"`;await dt(h,e);let b=await dt(`git -C "${c}" log -1 --format="%h %s"`,e);return JSON.stringify({action:"updated",repo:o,path:c,branch:n||"default",head:b})}let m=["git","clone"];i&&m.push("--depth","1"),n&&m.push("--branch",n),m.push(`"${d}"`,`"${c}"`),await dt(m.join(" "),e),Ge(vo,c,t,l||p,"git_checkout");let f=await dt(`git -C "${c}" log -1 --format="%h %s"`,e);return JSON.stringify({action:"cloned",repo:o,path:c,branch:n||"default",shallow:i,head:f})}function xo(r,e){let t=Yt(e,Wt);if(!V(t))return JSON.stringify({repos:[],message:"No repos cloned yet"});let n=[];for(let i of Yr(t,{withFileTypes:!0})){if(!i.isDirectory())continue;let s=Q(t,i.name);if(!V(Q(s,".git")))continue;let o=Oo(s);n.push({name:i.name,path:s,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:n,total:n.length,directory:t})}function Lo(r,e){let{repo:t,depth:n=2}=r,i=Yt(e,Wt,t);if(!V(i))return JSON.stringify({error:`Repo not found: ${t}. Run git_checkout first.`});let s={repo:t,path:i},o=Q(i,"package.json");if(V(o))try{let m=JSON.parse(To(o,"utf-8"));s.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?s.framework="React":m.dependencies?.next?s.framework="Next.js":m.dependencies?.vue?s.framework="Vue":m.dependencies?.angular?s.framework="Angular":m.dependencies?.express?s.framework="Express":m.dependencies?.fastify&&(s.framework="Fastify")}catch{}let a=Q(i,"pyproject.toml");V(a)&&(s.language="Python");let c=Q(i,"go.mod");V(c)&&(s.language="Go");let d=Q(i,"Cargo.toml");V(d)&&(s.language="Rust"),V(o)&&(s.language=s.language||"JavaScript/TypeScript");let l=[];function p(m,f,h){if(h>n)return;let b;try{b=Yr(m,{withFileTypes:!0})}catch{return}let g=b.filter(_=>!_.name.startsWith(".")&&_.name!=="node_modules"&&_.name!=="__pycache__"&&_.name!=="dist"&&_.name!=="build"&&_.name!==".git").sort((_,y)=>_.isDirectory()!==y.isDirectory()?_.isDirectory()?-1:1:_.name.localeCompare(y.name));for(let _ of g){let y=_.isDirectory();l.push(`${f}${y?"\u{1F4C1}":"\u{1F4C4}"} ${_.name}`),y&&h<n&&p(Q(m,_.name),`${f} `,h+1)}}p(i,"",1),s.tree=l.slice(0,80),l.length>80&&(s.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 s.keyFilesFound=u.filter(m=>V(Q(i,m))),JSON.stringify(s)}import jo from"crypto";var Wr=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,Zr=/<!--\s*zbreview-summary\s*-->/i;function $o(r){return String(r||"").replace(Wr,"").replace(Zr,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function Po(r,e){return jo.createHash("sha256").update(`${String(r||"")}\0${$o(e)}`).digest("hex").slice(0,12)}function Co(r){return`
86
85
 
87
86
  <!-- zbfp:${r} -->`}var pt=`
88
87
 
89
- <!-- zbreview-summary -->`;function ut(r){let e=Wr.exec(String(r||""));return e?e[1].toLowerCase():null}function mt(r){return Zr.test(String(r||""))}function ft(r,e){let t=new Set([...e||[]].map(s=>String(s).toLowerCase())),n=[],i=0;for(let s of Array.isArray(r)?r:[]){if(!s||!s.body)continue;let o=Po(s.path,s.body);if(t.has(o)){i+=1;continue}t.add(o),n.push({...s,_fp:o,body:`${String(s.body)}${Co(o)}`})}return{toPost:n,skipped:i}}function Do(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=qo(Jo(import.meta.url)),e=Bo(r,"..","bin","mcp-skill.mjs");return Uo(e)?e:null}async function v(r,e={}){let{token:t}=await Vr("github"),n=r.startsWith("https://")?r:`https://api.github.com${r}`,i={Authorization:`Bearer ${t}`,Accept:e.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...e.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:e.method||"GET",headers:i,body:e.body?JSON.stringify(e.body):void 0});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`GitHub API ${s.status}: ${o.slice(0,300)}`)}return e.raw?s.text():s.json()}var je={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)
88
+ <!-- zbreview-summary -->`;function ut(r){let e=Wr.exec(String(r||""));return e?e[1].toLowerCase():null}function mt(r){return Zr.test(String(r||""))}function ft(r,e){let t=new Set([...e||[]].map(s=>String(s).toLowerCase())),n=[],i=0;for(let s of Array.isArray(r)?r:[]){if(!s||!s.body)continue;let o=Po(s.path,s.body);if(t.has(o)){i+=1;continue}t.add(o),n.push({...s,_fp:o,body:`${String(s.body)}${Co(o)}`})}return{toPost:n,skipped:i}}function Do(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Bo(Jo(import.meta.url)),e=qo(r,"..","bin","mcp-skill.mjs");return Uo(e)?e:null}async function v(r,e={}){let{token:t}=await Vr("github"),n=r.startsWith("https://")?r:`https://api.github.com${r}`,i={Authorization:`Bearer ${t}`,Accept:e.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...e.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:e.method||"GET",headers:i,body:e.body?JSON.stringify(e.body):void 0});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`GitHub API ${s.status}: ${o.slice(0,300)}`)}return e.raw?s.text():s.json()}var je={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:N.GITHUB,envKeys:["GITHUB_TOKEN","PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"GitHub \u2014 issues, PRs, commits, code search, file reading",promptFragment:`## GitHub
90
89
  You have access to the user's GitHub repositories. Available tools:
91
90
 
92
91
  ### Discovery
@@ -131,7 +130,7 @@ When user says "check out repo-name" or "clone repo-name":
131
130
  When user just wants to "look at" or "read" files (not clone):
132
131
  - Use github_get_file to read individual files via API`,resolve(){let r=Do();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/github.js","githubSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"github_search_issues":{let t=e.query;if(!t)return JSON.stringify({error:"query is required"});let n=await v(`/search/issues?q=${encodeURIComponent(t)}&per_page=${e.limit||20}`),i=(n.items||[]).map(s=>({number:s.number,title:s.title,state:s.state,repo:s.repository_url?.split("/").slice(-2).join("/"),url:s.html_url,user:s.user?.login,isPR:!!s.pull_request,labels:(s.labels||[]).map(o=>o.name),createdAt:s.created_at}));return JSON.stringify({total:n.total_count,items:i})}case"github_search_code":{let t=e.query;if(!t)return JSON.stringify({error:"query is required"});let n=e.repo?`+repo:${e.repo}`:"",i=e.language?`+language:${e.language}`:"",s=await v(`/search/code?q=${encodeURIComponent(t)}${n}${i}&per_page=${e.limit||15}`),o=(s.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:s.total_count,items:o})}case"github_get_pr":{let{owner:t,repo:n,number:i}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/pulls/${i}`);return JSON.stringify({number:s.number,title:s.title,state:s.state,merged:s.merged,body:s.body?.slice(0,5e3),user:s.user?.login,branch:s.head?.ref,headSha:s.head?.sha,base:s.base?.ref,changedFiles:s.changed_files,additions:s.additions,deletions:s.deletions,createdAt:s.created_at,mergedAt:s.merged_at,url:s.html_url,labels:(s.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:t,repo:n,number:i}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=s.length>15e3;return JSON.stringify({number:i,diff:o?s.slice(0,15e3):s,truncated:o,totalLength:s.length})}case"github_list_pr_files":{let{owner:t,repo:n,number:i}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:s.length,files:s.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:t,repo:n,number:i}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/pulls/${i}/comments?per_page=50`),o=await v(`/repos/${t}/${n}/issues/${i}/comments?per_page=50`),a=[...s.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:t,repo:n,number:i,commentId:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await v(`/repos/${t}/${n}/pulls/comments/${s}`),a=o.in_reply_to_id||o.id,c=[];try{c=await v(`/repos/${t}/${n}/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:t,repo:n,number:i,commentId:s,body:o}=e||{};if(!t||!n||!i||!s||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await v(`/repos/${t}/${n}/pulls/${i}/comments/${s}/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:t,repo:n,number:i,body:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${t}/${n}/issues/${i}/comments`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:t,repo:n,number:i,body:s,event:o,comments:a}=e||{};if(!t||!n||!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(_=>_&&_.path&&_.body&&(_.line!=null||_.position!=null)).map(_=>{let y={path:_.path,body:String(_.body)};return _.line!=null?(y.line=Number(_.line),y.side=_.side==="LEFT"?"LEFT":"RIGHT"):y.position=Number(_.position),y}):[];if(c!=="APPROVE"&&!s&&d.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l=new Set,p=null;try{for(let _=1;_<=20;_+=1){let y=await v(`/repos/${t}/${n}/pulls/${i}/comments?per_page=100&page=${_}`);if(!Array.isArray(y)||y.length===0)break;for(let k of y){let O=ut(k.body);O&&l.add(O)}if(y.length<100)break}for(let _=1;_<=20&&p==null;_+=1){let y=await v(`/repos/${t}/${n}/issues/${i}/comments?per_page=100&page=${_}`);if(!Array.isArray(y)||y.length===0)break;for(let k of y)if(mt(k.body)){p=k.id;break}if(y.length<100)break}}catch{}let u=!1,m=!1;if(s){let _=`${String(s)}${pt}`;try{p!=null?(await v(`/repos/${t}/${n}/issues/comments/${p}`,{method:"PATCH",body:{body:_}}),u=!0):await v(`/repos/${t}/${n}/issues/${i}/comments`,{method:"POST",body:{body:_}}),m=!0}catch{}}let{toPost:f,skipped:h}=ft(d,l),b=f.map(({_fp:_,...y})=>y),g=null;if(b.length>0||c==="APPROVE"||c==="REQUEST_CHANGES"){let _={event:c};b.length>0&&(_.comments=b),b.length===0&&c==="REQUEST_CHANGES"&&(_.body="Changes requested \u2014 see the review summary comment."),g=await v(`/repos/${t}/${n}/pulls/${i}/reviews`,{method:"POST",body:_})}return JSON.stringify({ok:!0,id:g?g.id:void 0,state:g?g.state:void 0,event:c,notePosted:m,summaryUpdated:u,commentsPosted:b.length,inlineSkipped:h||void 0,url:g?g.html_url:void 0})}case"github_list_commits":{let{owner:t,repo:n,branch:i,path:s,limit:o,since:a,until:c,page:d}=e;if(!t||!n)return JSON.stringify({error:"owner and repo are required"});let l=Math.min(Number(o)||20,100),p=`/repos/${t}/${n}/commits?per_page=${l}&page=${Number(d)||1}`;i&&(p+=`&sha=${encodeURIComponent(i)}`),s&&(p+=`&path=${encodeURIComponent(s)}`),a&&(p+=`&since=${encodeURIComponent(a)}`),c&&(p+=`&until=${encodeURIComponent(c)}`);let u=await v(p);return JSON.stringify({total:u.length,page:Number(d)||1,hasMore:u.length>=l,commits:u.map(m=>({sha:m.sha?.slice(0,8),fullSha:m.sha,message:m.commit?.message?.slice(0,300),author:m.commit?.author?.name,authorEmail:m.commit?.author?.email,date:m.commit?.author?.date,url:m.html_url}))})}case"github_get_commit":{let{owner:t,repo:n,sha:i,includePrs:s}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let o=await v(`/repos/${t}/${n}/commits/${i}`),a;if(s)try{let c=await v(`/repos/${t}/${n}/commits/${i}/pulls`);a=(Array.isArray(c)?c:[]).map(d=>({number:d.number,title:d.title,state:d.state,merged:!!d.merged_at,webUrl:d.html_url}))}catch{a=[]}return JSON.stringify({sha:o.sha?.slice(0,8),message:o.commit?.message,author:o.commit?.author?.name,date:o.commit?.author?.date,stats:o.stats,files:(o.files||[]).map(c=>({filename:c.filename,status:c.status,additions:c.additions,deletions:c.deletions,patch:c.patch?.slice(0,3e3)})),...a?{pullRequests:a}:{}})}case"github_get_file":{let{owner:t,repo:n,path:i,ref:s}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${t}/${n}/contents/${encodeURIComponent(i)}`;s&&(o+=`?ref=${encodeURIComponent(s)}`);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 t=await v("/installation/repositories?per_page=1");if(t.repositories&&t.repositories.length>0){let n=t.repositories[0],i=n.owner.login,s=n.owner.type,o=s==="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:s,isOrg:s==="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(t){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${t.message})`})}case"github_list_orgs":try{let n=(await v("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of n)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 s=Array.from(i.values());return JSON.stringify({count:s.length,orgs:s,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(t){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${t.message}`})}case"github_clone":{let f=function(_){let y=_.replace(/^~(?=$|\/|\\)/,m);return a(y)},{owner:t,repo:n,destination:i}=e;if(!t||!n)return JSON.stringify({error:"owner and repo are required"});let{execSync:s}=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 Vr("github"),m=l(),h=i?f(i):o(m,"zibby-repos"),b=o(h,n);if(d(h,{recursive:!0}),c(b))return JSON.stringify({error:`Directory ${b} already exists. Remove it first or use a different destination.`,existingPath:b});let g=`https://x-access-token:${u}@github.com/${t}/${n}.git`;try{s(`git clone ${g} "${b}"`,{stdio:"pipe"});let _=`https://github.com/${t}/${n}.git`;Ge(s,b,_,u,"github_clone");let y=p()==="win32",k;return y?k=s(`dir "${b}"`,{encoding:"utf-8",shell:"cmd.exe"}):k=s(`ls -la "${b}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:b,message:`Cloned ${t}/${n} to ${b}`,contents:k.split(`
133
132
  `).slice(0,30).join(`
134
- `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(_){let k=String(_.message||_).split(u).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${k}`})}}case"github_search_repos":{let{query:t,limit:n}=e;if(!t)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),s=JSON.parse(i);if(s.error)return JSON.stringify(s);let o=t.toLowerCase(),a=s.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:t,count:a.length,repos:a.slice(0,n||20)})}case"github_list_repos":{let{owner:t,type:n,sort:i,direction:s,limit:o,query:a}=e,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 k=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(k)||y.fullName&&y.fullName.toLowerCase().includes(k)||y.description&&y.description.toLowerCase().includes(k)};if(!t){let y=1,k=!0;for(;k&&l.length<d;){let B=`/installation/repositories?per_page=${c}&page=${y}`,_e=(await v(B)).repositories||[];if(_e.length===0)break;l=l.concat(_e),k=_e.length===c,y++}let O=l.map(p).filter(u),H=O.slice(0,d),Ee=O.length>H.length,A=H.filter(B=>B.private).length,T=H.filter(B=>!B.private).length;return JSON.stringify({count:H.length,repos:H,truncated:Ee,privateCount:A,publicCount:T,message:`Found ${A} private and ${T} public repos`})}let m=await v(`/orgs/${t}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&l.length<d;){let y;m?y=`/orgs/${t}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`:y=`/users/${t}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`;let k=await v(y),O=Array.isArray(k)?k:[];if(O.length===0)break;l=l.concat(O),h=O.length===c,f++}let b=l.map(p).filter(u),g=b.slice(0,d),_=b.length>g.length;return JSON.stringify({count:g.length,repos:g,truncated:_})}case"github_create_pr":{let{owner:t,repo:n,head:i,title:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=e.base;if(!o)try{o=(await v(`/repos/${t}/${n}`)).default_branch||"main"}catch{o="main"}let a={title:String(s),head:String(i),base:String(o),body:e.body?String(e.body):"",draft:!!e.draft};try{let c=await v(`/repos/${t}/${n}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${t}/${n}`,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:`${t}/${n}`,provider:"github",skippedReason:d});throw c}}case"github_merge_pr":{let{owner:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=e.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(s))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${s})`});let o={merge_method:s};e.commitTitle&&(o.commit_title=String(e.commitTitle)),e.commitMessage&&(o.commit_message=String(e.commitMessage));try{let a=await v(`/repos/${t}/${n}/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:t,repo:n,title:i,body:s}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await v(`/repos/${t}/${n}/issues`,{method:"POST",body:{title:i,body:s||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:t,repo:n,state:i,labels:s,since:o,assignee:a,sort:c,direction:d,limit:l}=e||{};if(!t||!n)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"),s&&p.set("labels",Array.isArray(s)?s.join(","):s),o&&p.set("since",o),a&&p.set("assignee",a);let u=await v(`/repos/${t}/${n}/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:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/issues/${i}`);return s.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:s.number,title:s.title,body:s.body||"",state:s.state,stateReason:s.state_reason||null,labels:(s.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:s.assignee?.login||null,assignees:(s.assignees||[]).map(o=>o.login),user:s.user?.login,milestone:s.milestone?.title||null,comments:s.comments,url:s.html_url,createdAt:s.created_at,updatedAt:s.updated_at,closedAt:s.closed_at})}case"github_get_issue_comments":{let{owner:t,repo:n,number:i,limit:s}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await v(`/repos/${t}/${n}/issues/${i}/comments?per_page=${s||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:t,repo:n,number:i,body:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${t}/${n}/issues/${i}/comments`,{method:"POST",body:{body:s}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:t,repo:n,number:i,stateReason:s}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};s&&(o.state_reason=s);let a=await v(`/repos/${t}/${n}/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:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:s.number,state:s.state,url:s.html_url})}case"github_label_issue":{let{owner:t,repo:n,number:i,labels:s,mode:o}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(s)?s:s?[s]:[];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/${t}/${n}/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/${t}/${n}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await v(`/repos/${t}/${n}/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/${t}/${n}/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: ${r}`})}}catch(t){return JSON.stringify({error:t.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 commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). 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:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},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)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},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 Mo}from"fs";import{fileURLToPath as Fo}from"url";import{dirname as Ko,resolve as Go}from"path";function Ho(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Ko(Fo(import.meta.url)),e=Go(r,"..","bin","mcp-skill.mjs");return Mo(e)?e:null}function zo(){let r=process.env.GITLAB_API_URL;if(r)return r.replace(/\/+$/,"");let e=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(e)?e:`${e}/api/v4`}function Yo(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let r=process.env.GITLAB_TOKEN;if(!r)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":r}}async function R(r,e={}){let t=/^https?:\/\//.test(r)?r:`${zo()}${r}`,n={Accept:"application/json","User-Agent":"Zibby-App",...Yo(),...e.body?{"Content-Type":"application/json"}:{}},i=await fetch(t,{method:e.method||"GET",headers:n,body:e.body?JSON.stringify(e.body):void 0});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${s.slice(0,300)}`)}return e.raw?i.text():i.json()}function Qr(){let r=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(r?r.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function Wo(){return process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function j(r){let e=String(r);return/^\d+$/.test(e)?e:encodeURIComponent(e)}var $e={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)
133
+ `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(_){let k=String(_.message||_).split(u).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${k}`})}}case"github_search_repos":{let{query:t,limit:n}=e;if(!t)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),s=JSON.parse(i);if(s.error)return JSON.stringify(s);let o=t.toLowerCase(),a=s.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:t,count:a.length,repos:a.slice(0,n||20)})}case"github_list_repos":{let{owner:t,type:n,sort:i,direction:s,limit:o,query:a}=e,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 k=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(k)||y.fullName&&y.fullName.toLowerCase().includes(k)||y.description&&y.description.toLowerCase().includes(k)};if(!t){let y=1,k=!0;for(;k&&l.length<d;){let q=`/installation/repositories?per_page=${c}&page=${y}`,_e=(await v(q)).repositories||[];if(_e.length===0)break;l=l.concat(_e),k=_e.length===c,y++}let O=l.map(p).filter(u),H=O.slice(0,d),Ee=O.length>H.length,A=H.filter(q=>q.private).length,T=H.filter(q=>!q.private).length;return JSON.stringify({count:H.length,repos:H,truncated:Ee,privateCount:A,publicCount:T,message:`Found ${A} private and ${T} public repos`})}let m=await v(`/orgs/${t}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&l.length<d;){let y;m?y=`/orgs/${t}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`:y=`/users/${t}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`;let k=await v(y),O=Array.isArray(k)?k:[];if(O.length===0)break;l=l.concat(O),h=O.length===c,f++}let b=l.map(p).filter(u),g=b.slice(0,d),_=b.length>g.length;return JSON.stringify({count:g.length,repos:g,truncated:_})}case"github_create_pr":{let{owner:t,repo:n,head:i,title:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=e.base;if(!o)try{o=(await v(`/repos/${t}/${n}`)).default_branch||"main"}catch{o="main"}let a={title:String(s),head:String(i),base:String(o),body:e.body?String(e.body):"",draft:!!e.draft};try{let c=await v(`/repos/${t}/${n}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${t}/${n}`,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:`${t}/${n}`,provider:"github",skippedReason:d});throw c}}case"github_merge_pr":{let{owner:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=e.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(s))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${s})`});let o={merge_method:s};e.commitTitle&&(o.commit_title=String(e.commitTitle)),e.commitMessage&&(o.commit_message=String(e.commitMessage));try{let a=await v(`/repos/${t}/${n}/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:t,repo:n,title:i,body:s}=e;if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await v(`/repos/${t}/${n}/issues`,{method:"POST",body:{title:i,body:s||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:t,repo:n,state:i,labels:s,since:o,assignee:a,sort:c,direction:d,limit:l}=e||{};if(!t||!n)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"),s&&p.set("labels",Array.isArray(s)?s.join(","):s),o&&p.set("since",o),a&&p.set("assignee",a);let u=await v(`/repos/${t}/${n}/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:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/issues/${i}`);return s.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:s.number,title:s.title,body:s.body||"",state:s.state,stateReason:s.state_reason||null,labels:(s.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:s.assignee?.login||null,assignees:(s.assignees||[]).map(o=>o.login),user:s.user?.login,milestone:s.milestone?.title||null,comments:s.comments,url:s.html_url,createdAt:s.created_at,updatedAt:s.updated_at,closedAt:s.closed_at})}case"github_get_issue_comments":{let{owner:t,repo:n,number:i,limit:s}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await v(`/repos/${t}/${n}/issues/${i}/comments?per_page=${s||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:t,repo:n,number:i,body:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await v(`/repos/${t}/${n}/issues/${i}/comments`,{method:"POST",body:{body:s}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:t,repo:n,number:i,stateReason:s}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};s&&(o.state_reason=s);let a=await v(`/repos/${t}/${n}/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:t,repo:n,number:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await v(`/repos/${t}/${n}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:s.number,state:s.state,url:s.html_url})}case"github_label_issue":{let{owner:t,repo:n,number:i,labels:s,mode:o}=e||{};if(!t||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(s)?s:s?[s]:[];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/${t}/${n}/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/${t}/${n}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await v(`/repos/${t}/${n}/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/${t}/${n}/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: ${r}`})}}catch(t){return JSON.stringify({error:t.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 commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). 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:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},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)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},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 Mo}from"fs";import{fileURLToPath as Fo}from"url";import{dirname as Ko,resolve as Go}from"path";function Ho(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Ko(Fo(import.meta.url)),e=Go(r,"..","bin","mcp-skill.mjs");return Mo(e)?e:null}function zo(){let r=process.env.GITLAB_API_URL;if(r)return r.replace(/\/+$/,"");let e=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(e)?e:`${e}/api/v4`}function Yo(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let r=process.env.GITLAB_TOKEN;if(!r)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":r}}async function R(r,e={}){let t=/^https?:\/\//.test(r)?r:`${zo()}${r}`,n={Accept:"application/json","User-Agent":"Zibby-App",...Yo(),...e.body?{"Content-Type":"application/json"}:{}},i=await fetch(t,{method:e.method||"GET",headers:n,body:e.body?JSON.stringify(e.body):void 0});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${s.slice(0,300)}`)}return e.raw?i.text():i.json()}function Qr(){let r=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(r?r.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function Wo(){return process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function j(r){let e=String(r);return/^\d+$/.test(e)?e:encodeURIComponent(e)}var $e={id:"gitlab",serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:N.GITLAB,envKeys:["GITLAB_TOKEN","GITLAB_OAUTH_TOKEN","GITLAB_INSTANCE_URL","GITLAB_API_URL","PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"GitLab \u2014 merge requests, diffs, MR reviews/discussions, issues",promptFragment:`## GitLab
135
134
  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:
136
135
 
137
136
  ### Discovery
@@ -159,7 +158,7 @@ You have access to the user's GitLab projects via the REST API (cloud gitlab.com
159
158
  - 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.
160
159
  - 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 r=Ho();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/gitlab.js","gitlabSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"gitlab_clone":{let{projectPath:t,projectId:n,destination:i,branch:s}=e||{},o=t&&String(t).trim();if(!o&&n!=null&&(/^\d+$/.test(String(n))?o=(await R(`/projects/${j(n)}`))?.path_with_namespace:o=String(n).trim()),!o)return JSON.stringify({error:'projectPath (e.g. "group/repo") or a numeric projectId is required'});let a=Wo();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 b=Qr().replace(/^https?:\/\//,""),g=Qr().startsWith("http://")?"http":"https",_=`${g}://oauth2:${a}@${b}/${o}.git`,y=s?`--branch "${String(s).replace(/"/g,"")}" `:"";try{c(`git clone --depth 1 ${y}${_} "${h}"`,{stdio:"pipe",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}});let k=`${g}://${b}/${o}.git`;Ge(c,h,k,a,"gitlab_clone");let O=c(`ls -la "${h}"`,{encoding:"utf-8"});return JSON.stringify({success:!0,path:h,message:`Cloned ${o} to ${h}`,contents:O.split(`
161
160
  `).slice(0,30).join(`
162
- `)})}catch(k){let O=String(k.message||k).split(a).join("***").replace(/oauth2:[^@]*@/g,"oauth2:***@");return JSON.stringify({error:`Clone failed: ${O}`})}}case"gitlab_create_mr":{let t=e?.project??e?.projectId,n=e?.source_branch??e?.sourceBranch,{title:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let s=j(t),o=e?.target_branch??e?.targetBranch;if(!o)try{o=(await R(`/projects/${s}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(n),target_branch:String(o),title:String(i),description:e?.description?String(e.description):""};try{let c=await R(`/projects/${s}/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(t),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(t),provider:"gitlab",skippedReason:d});throw c}}case"gitlab_accept_mr":{let t=e?.project??e?.projectId,{iid:n}=e||{};if(!t||!n)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=j(t),s={};e.squash!=null&&(s.squash=!!e.squash),e.mergeCommitMessage&&(s.merge_commit_message=String(e.mergeCommitMessage)),e.mergeWhenPipelineSucceeds!=null&&(s.merge_when_pipeline_succeeds=!!e.mergeWhenPipelineSucceeds);try{let o=await R(`/projects/${i}/merge_requests/${n}/merge`,{method:"PUT",body:s});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??n,project:String(t),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:n,project:String(t),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/merge_requests/${n}`);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:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/merge_requests/${n}/changes`),s=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:s.length,diffRefs:i.diff_refs||null,files:s.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_commits":{let{projectId:t,since:n,until:i,refName:s,page:o,perPage:a,withStats:c}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let d=new URLSearchParams;d.set("per_page",String(Math.min(Number(a)||50,100))),d.set("page",String(Number(o)||1)),n&&d.set("since",n),i&&d.set("until",i),s&&d.set("ref_name",s),c!==!1&&d.set("with_stats","true");let l=await R(`/projects/${j(t)}/repository/commits?${d.toString()}`),p=(Array.isArray(l)?l:[]).map(u=>({id:u.id,shortId:u.short_id,title:u.title,authorName:u.author_name,authorEmail:u.author_email,authoredDate:u.authored_date,committedDate:u.committed_date,parentIds:Array.isArray(u.parent_ids)?u.parent_ids:[],stats:u.stats||null}));return JSON.stringify({page:Number(o)||1,count:p.length,hasMore:p.length>=Math.min(Number(a)||50,100),commits:p})}case"gitlab_get_commit":{let{projectId:t,sha:n,includeDiff:i,includeMrs:s}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and sha are required"});let o=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}`),a;if(s)try{let d=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}/merge_requests`);a=(Array.isArray(d)?d:[]).map(l=>({iid:l.iid,title:l.title,state:l.state,webUrl:l.web_url}))}catch{a=[]}let c;if(i!==!1){let d=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}/diff`);c=(Array.isArray(d)?d:[]).map(l=>({oldPath:l.old_path,newPath:l.new_path,newFile:!!l.new_file,deletedFile:!!l.deleted_file,renamedFile:!!l.renamed_file,diff:typeof l.diff=="string"?l.diff.slice(0,3e3):""}))}return JSON.stringify({id:o.id,shortId:o.short_id,title:o.title,message:typeof o.message=="string"?o.message.slice(0,2e3):"",authorName:o.author_name,authorEmail:o.author_email,authoredDate:o.authored_date,committedDate:o.committed_date,parentIds:Array.isArray(o.parent_ids)?o.parent_ids:[],stats:o.stats||null,webUrl:o.web_url,...c?{filesChanged:c.length,files:c}:{},...a?{mergeRequests:a}:{}})}case"gitlab_list_mrs":{let{projectId:t,state:n,targetBranch:i,sourceBranch:s,authorUsername:o,labels:a,search:c,sort:d,orderBy:l,limit:p}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"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),s&&u.set("source_branch",s),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await R(`/projects/${j(t)}/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:t,iid:n,limit:i}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(s)?s.length:0,notes:(Array.isArray(s)?s:[]).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:t,iid:n,body:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}case"gitlab_post_mr_discussion":{let{projectId:t,iid:n,path:i,oldPath:s,newLine:o,oldLine:a,body:c}=e||{};if(!t||!n||!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=j(t),l=e.diffRefs||null;if(l||(l=(await R(`/projects/${d}/merge_requests/${n}`)).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:s||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await R(`/projects/${d}/merge_requests/${n}/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:t,iid:n,body:i,comments:s}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let o=j(t),a=Array.isArray(s)?s.filter(g=>g&&g.path&&g.body&&(g.newLine!=null||g.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=e.diffRefs||null;a.length>0&&!c&&(c=(await R(`/projects/${o}/merge_requests/${n}`)).diff_refs||null);let d=new Set,l=null;try{for(let g=1;g<=20;g+=1){let _=await R(`/projects/${o}/merge_requests/${n}/discussions?per_page=100&page=${g}`);if(!Array.isArray(_)||_.length===0)break;for(let y of _)for(let k of y.notes||[]){let O=ut(k.body);O&&d.add(O),l==null&&mt(k.body)&&(l=k.id)}if(_.length<100)break}}catch{}let p=!1,u=!1;if(i){let g=`${String(i)}${pt}`;try{l!=null?(await R(`/projects/${o}/merge_requests/${n}/notes/${l}`,{method:"PUT",body:{body:g}}),u=!0):await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:g}}),p=!0}catch{await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:g}}),p=!0}}let{toPost:m,skipped:f}=ft(a,d),h=0,b=[];if(m.length>0&&c)for(let g of m){let _={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:g.path,old_path:g.oldPath||g.path};g.newLine!=null&&(_.new_line=Number(g.newLine)),g.oldLine!=null&&(_.old_line=Number(g.oldLine));try{await R(`/projects/${o}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(g.body),position:_}}),h+=1}catch(y){b.push(`${g.path}:${g.newLine??g.oldLine} \u2014 ${y.message}`)}}else m.length>0&&!c&&b.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:p,summaryUpdated:u,inlinePosted:h,inlineSkipped:f||void 0,inlineErrors:b.length?b:void 0})}case"gitlab_get_discussion":{let{projectId:t,iid:n,discussionId:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(s.notes)?s.notes:[],a=o.find(d=>d.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:s.id,individualNote:!!s.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:t,iid:n,discussionId:i,body:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await R(`/projects/${j(t)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:t,limit:n}=e||{},i=Math.min(Number(n)>0?Number(n):50,200),s=new URLSearchParams;s.set("membership","true"),s.set("simple","true"),s.set("order_by","last_activity_at"),s.set("sort","desc"),s.set("per_page",String(Math.min(i+1,100))),t&&s.set("search",String(t));let o=await R(`/projects?${s.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:t,state:n,labels:i,assigneeUsername:s,authorUsername:o,updatedAfter:a,search:c,sort:d,orderBy:l,limit:p}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"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),s&&u.set("assignee_username",s),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await R(`/projects/${j(t)}/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(b=>b.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:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/issues/${n}`);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(s=>s.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:t,iid:n,body:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${j(t)}/issues/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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_commits",description:"List a project's repository commits (the commit HISTORY \u2014 not MRs), optionally bounded by since/until ISO dates and a ref/branch, with per-commit stats (additions/deletions). Paginated: keep calling with page+1 while hasMore is true. This is the ONLY correct way to enumerate commits in a date window \u2014 gitlab_clone is shallow (depth 1) and its git log shows just one commit.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},since:{type:"string",description:'Only commits after this ISO-8601 date/time (inclusive), e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:'Only commits before this ISO-8601 date/time, e.g. "2026-07-01T00:00:00Z"'},refName:{type:"string",description:"Branch/tag to list (defaults to the default branch)"},page:{type:"number",description:"Page number, 1-based (default 1)"},perPage:{type:"number",description:"Commits per page, max 100 (default 50)"},withStats:{type:"boolean",description:"Include per-commit additions/deletions stats (default true)"}},required:["projectId"]}},{name:"gitlab_get_commit",description:"Get ONE commit's full detail \u2014 message, author, timestamps, stats, and (by default) its per-file diffs (each capped at 3000 chars) \u2014 so you can judge the nature/complexity of the change. Use after gitlab_list_commits.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},sha:{type:"string",description:"The commit sha (full or short)"},includeDiff:{type:"boolean",description:"Include per-file diffs (default true; set false for metadata-only)"},includeMrs:{type:"boolean",description:"Also return the merge request(s) containing this commit ({iid,title,state,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["projectId","sha"]}},{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 Zo}from"fs";import{fileURLToPath as Vo}from"url";import{dirname as Qo,resolve as Xo}from"path";import{resolveIntegrationToken as ea}from"@zibby/core/backend-client.js";function ta(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Qo(Vo(import.meta.url)),e=Xo(r,"..","bin","mcp-skill.mjs");return Zo(e)?e:null}async function Y(r,e={}){let{token:t}=await ea("figma"),n=r.startsWith("https://")?r:`https://api.figma.com${r}`,i={"X-Figma-Token":t,Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:e.method||"GET",headers:i,body:e.body?JSON.stringify(e.body):void 0});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Figma API ${s.status}: ${o.slice(0,300)}`)}return s.json()}function oe(r){let e=String(r||"").trim(),t=e.match(/figma\.com\/(?:file|design|board|proto)\/([A-Za-z0-9]+)/i);return t?t[1]:e}function ht(r){return r==null?void 0:(Array.isArray(r)?r:String(r).split(",")).map(t=>String(t).trim().replace(/-/g,":")).filter(Boolean).join(",")}function ra(r){let e=String(r||"").match(/[?&]node-id=([^&]+)/i);return e?decodeURIComponent(e[1]).replace(/-/g,":"):void 0}var X=r=>typeof r=="number"?Math.round(r*100)/100:r;function Zt(r){if(!r)return null;let e=n=>Math.round((n??0)*255).toString(16).padStart(2,"0"),t={hex:`#${e(r.r)}${e(r.g)}${e(r.b)}`.toUpperCase()};return r.a!=null&&r.a<1&&(t.opacity=X(r.a)),t}function Xr(r){return!r||r.visible===!1?null:r.type==="SOLID"?{type:"SOLID",...Zt(r.color),...r.opacity!=null?{opacity:r.opacity}:{}}:{type:r.type,...r.opacity!=null?{opacity:r.opacity}:{},...r.gradientStops?{stops:r.gradientStops.map(e=>({position:X(e.position),...Zt(e.color)}))}:{}}}function en(r,e){let t=r.absoluteBoundingBox,n={id:r.id,name:r.name,type:r.type};t&&(n.size={w:X(t.width),h:X(t.height)},n.position={x:X(t.x),y:X(t.y)}),r.opacity!=null&&r.opacity!==1&&(n.opacity=r.opacity),r.cornerRadius!=null&&(n.cornerRadius=r.cornerRadius),Array.isArray(r.rectangleCornerRadii)&&(n.cornerRadii=r.rectangleCornerRadii);let i=(r.fills||[]).map(Xr).filter(Boolean);i.length&&(n.fills=i);let s=(r.strokes||[]).map(Xr).filter(Boolean);s.length&&(n.strokes=s,r.strokeWeight!=null&&(n.strokeWeight=r.strokeWeight));let o=(r.effects||[]).filter(a=>a.visible!==!1).map(a=>({type:a.type,...a.radius!=null?{radius:a.radius}:{},...a.offset?{offset:{x:X(a.offset.x),y:X(a.offset.y)}}:{},...a.spread?{spread:a.spread}:{},...a.color?Zt(a.color):{}}));if(o.length&&(n.effects=o),r.layoutMode&&r.layoutMode!=="NONE"&&(n.autoLayout={direction:r.layoutMode,padding:{l:r.paddingLeft??0,r:r.paddingRight??0,t:r.paddingTop??0,b:r.paddingBottom??0},gap:r.itemSpacing??0,align:{primary:r.primaryAxisAlignItems,counter:r.counterAxisAlignItems}}),r.type==="TEXT"){let a=r.style||{};n.text=r.characters,n.textStyle={fontFamily:a.fontFamily,fontWeight:a.fontWeight,fontSize:a.fontSize,lineHeightPx:a.lineHeightPx!=null?X(a.lineHeightPx):void 0,letterSpacing:a.letterSpacing!=null?X(a.letterSpacing):void 0,align:a.textAlignHorizontal,case:a.textCase}}return e>0&&Array.isArray(r.children)&&r.children.length&&(n.children=r.children.map(a=>en(a,e-1))),n}var tn={id:"figma",serverName:"figma",allowedTools:["mcp__figma__*"],requiresIntegration:N.FIGMA,envKeys:[],description:"Figma \u2014 read files, nodes and comments; extract dev-handoff specs (sizes/colors/fonts/auto-layout); list versions and image fills; render frames to PNG/JPG/SVG/PDF; browse team projects/files; and post comments",promptFragment:`## Figma (connected)
161
+ `)})}catch(k){let O=String(k.message||k).split(a).join("***").replace(/oauth2:[^@]*@/g,"oauth2:***@");return JSON.stringify({error:`Clone failed: ${O}`})}}case"gitlab_create_mr":{let t=e?.project??e?.projectId,n=e?.source_branch??e?.sourceBranch,{title:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let s=j(t),o=e?.target_branch??e?.targetBranch;if(!o)try{o=(await R(`/projects/${s}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(n),target_branch:String(o),title:String(i),description:e?.description?String(e.description):""};try{let c=await R(`/projects/${s}/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(t),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(t),provider:"gitlab",skippedReason:d});throw c}}case"gitlab_accept_mr":{let t=e?.project??e?.projectId,{iid:n}=e||{};if(!t||!n)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=j(t),s={};e.squash!=null&&(s.squash=!!e.squash),e.mergeCommitMessage&&(s.merge_commit_message=String(e.mergeCommitMessage)),e.mergeWhenPipelineSucceeds!=null&&(s.merge_when_pipeline_succeeds=!!e.mergeWhenPipelineSucceeds);try{let o=await R(`/projects/${i}/merge_requests/${n}/merge`,{method:"PUT",body:s});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??n,project:String(t),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:n,project:String(t),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/merge_requests/${n}`);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:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/merge_requests/${n}/changes`),s=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:s.length,diffRefs:i.diff_refs||null,files:s.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_commits":{let{projectId:t,since:n,until:i,refName:s,page:o,perPage:a,withStats:c}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let d=new URLSearchParams;d.set("per_page",String(Math.min(Number(a)||50,100))),d.set("page",String(Number(o)||1)),n&&d.set("since",n),i&&d.set("until",i),s&&d.set("ref_name",s),c!==!1&&d.set("with_stats","true");let l=await R(`/projects/${j(t)}/repository/commits?${d.toString()}`),p=(Array.isArray(l)?l:[]).map(u=>({id:u.id,shortId:u.short_id,title:u.title,authorName:u.author_name,authorEmail:u.author_email,authoredDate:u.authored_date,committedDate:u.committed_date,parentIds:Array.isArray(u.parent_ids)?u.parent_ids:[],stats:u.stats||null}));return JSON.stringify({page:Number(o)||1,count:p.length,hasMore:p.length>=Math.min(Number(a)||50,100),commits:p})}case"gitlab_get_commit":{let{projectId:t,sha:n,includeDiff:i,includeMrs:s}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and sha are required"});let o=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}`),a;if(s)try{let d=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}/merge_requests`);a=(Array.isArray(d)?d:[]).map(l=>({iid:l.iid,title:l.title,state:l.state,webUrl:l.web_url}))}catch{a=[]}let c;if(i!==!1){let d=await R(`/projects/${j(t)}/repository/commits/${encodeURIComponent(n)}/diff`);c=(Array.isArray(d)?d:[]).map(l=>({oldPath:l.old_path,newPath:l.new_path,newFile:!!l.new_file,deletedFile:!!l.deleted_file,renamedFile:!!l.renamed_file,diff:typeof l.diff=="string"?l.diff.slice(0,3e3):""}))}return JSON.stringify({id:o.id,shortId:o.short_id,title:o.title,message:typeof o.message=="string"?o.message.slice(0,2e3):"",authorName:o.author_name,authorEmail:o.author_email,authoredDate:o.authored_date,committedDate:o.committed_date,parentIds:Array.isArray(o.parent_ids)?o.parent_ids:[],stats:o.stats||null,webUrl:o.web_url,...c?{filesChanged:c.length,files:c}:{},...a?{mergeRequests:a}:{}})}case"gitlab_list_mrs":{let{projectId:t,state:n,targetBranch:i,sourceBranch:s,authorUsername:o,labels:a,search:c,sort:d,orderBy:l,limit:p}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"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),s&&u.set("source_branch",s),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await R(`/projects/${j(t)}/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:t,iid:n,limit:i}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(s)?s.length:0,notes:(Array.isArray(s)?s:[]).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:t,iid:n,body:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}case"gitlab_post_mr_discussion":{let{projectId:t,iid:n,path:i,oldPath:s,newLine:o,oldLine:a,body:c}=e||{};if(!t||!n||!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=j(t),l=e.diffRefs||null;if(l||(l=(await R(`/projects/${d}/merge_requests/${n}`)).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:s||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await R(`/projects/${d}/merge_requests/${n}/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:t,iid:n,body:i,comments:s}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let o=j(t),a=Array.isArray(s)?s.filter(g=>g&&g.path&&g.body&&(g.newLine!=null||g.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=e.diffRefs||null;a.length>0&&!c&&(c=(await R(`/projects/${o}/merge_requests/${n}`)).diff_refs||null);let d=new Set,l=null;try{for(let g=1;g<=20;g+=1){let _=await R(`/projects/${o}/merge_requests/${n}/discussions?per_page=100&page=${g}`);if(!Array.isArray(_)||_.length===0)break;for(let y of _)for(let k of y.notes||[]){let O=ut(k.body);O&&d.add(O),l==null&&mt(k.body)&&(l=k.id)}if(_.length<100)break}}catch{}let p=!1,u=!1;if(i){let g=`${String(i)}${pt}`;try{l!=null?(await R(`/projects/${o}/merge_requests/${n}/notes/${l}`,{method:"PUT",body:{body:g}}),u=!0):await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:g}}),p=!0}catch{await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:g}}),p=!0}}let{toPost:m,skipped:f}=ft(a,d),h=0,b=[];if(m.length>0&&c)for(let g of m){let _={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:g.path,old_path:g.oldPath||g.path};g.newLine!=null&&(_.new_line=Number(g.newLine)),g.oldLine!=null&&(_.old_line=Number(g.oldLine));try{await R(`/projects/${o}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(g.body),position:_}}),h+=1}catch(y){b.push(`${g.path}:${g.newLine??g.oldLine} \u2014 ${y.message}`)}}else m.length>0&&!c&&b.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:p,summaryUpdated:u,inlinePosted:h,inlineSkipped:f||void 0,inlineErrors:b.length?b:void 0})}case"gitlab_get_discussion":{let{projectId:t,iid:n,discussionId:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let s=await R(`/projects/${j(t)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(s.notes)?s.notes:[],a=o.find(d=>d.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:s.id,individualNote:!!s.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:t,iid:n,discussionId:i,body:s}=e||{};if(!t||!n||!i||!s)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await R(`/projects/${j(t)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:t,limit:n}=e||{},i=Math.min(Number(n)>0?Number(n):50,200),s=new URLSearchParams;s.set("membership","true"),s.set("simple","true"),s.set("order_by","last_activity_at"),s.set("sort","desc"),s.set("per_page",String(Math.min(i+1,100))),t&&s.set("search",String(t));let o=await R(`/projects?${s.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:t,state:n,labels:i,assigneeUsername:s,authorUsername:o,updatedAfter:a,search:c,sort:d,orderBy:l,limit:p}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"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),s&&u.set("assignee_username",s),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await R(`/projects/${j(t)}/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(b=>b.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:t,iid:n}=e||{};if(!t||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${j(t)}/issues/${n}`);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(s=>s.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:t,iid:n,body:i}=e||{};if(!t||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${j(t)}/issues/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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_commits",description:"List a project's repository commits (the commit HISTORY \u2014 not MRs), optionally bounded by since/until ISO dates and a ref/branch, with per-commit stats (additions/deletions). Paginated: keep calling with page+1 while hasMore is true. This is the ONLY correct way to enumerate commits in a date window \u2014 gitlab_clone is shallow (depth 1) and its git log shows just one commit.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},since:{type:"string",description:'Only commits after this ISO-8601 date/time (inclusive), e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:'Only commits before this ISO-8601 date/time, e.g. "2026-07-01T00:00:00Z"'},refName:{type:"string",description:"Branch/tag to list (defaults to the default branch)"},page:{type:"number",description:"Page number, 1-based (default 1)"},perPage:{type:"number",description:"Commits per page, max 100 (default 50)"},withStats:{type:"boolean",description:"Include per-commit additions/deletions stats (default true)"}},required:["projectId"]}},{name:"gitlab_get_commit",description:"Get ONE commit's full detail \u2014 message, author, timestamps, stats, and (by default) its per-file diffs (each capped at 3000 chars) \u2014 so you can judge the nature/complexity of the change. Use after gitlab_list_commits.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},sha:{type:"string",description:"The commit sha (full or short)"},includeDiff:{type:"boolean",description:"Include per-file diffs (default true; set false for metadata-only)"},includeMrs:{type:"boolean",description:"Also return the merge request(s) containing this commit ({iid,title,state,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["projectId","sha"]}},{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 Zo}from"fs";import{fileURLToPath as Vo}from"url";import{dirname as Qo,resolve as Xo}from"path";import{resolveIntegrationToken as ea}from"@zibby/core/backend-client.js";function ta(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Qo(Vo(import.meta.url)),e=Xo(r,"..","bin","mcp-skill.mjs");return Zo(e)?e:null}async function Y(r,e={}){let{token:t}=await ea("figma"),n=r.startsWith("https://")?r:`https://api.figma.com${r}`,i={"X-Figma-Token":t,Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:e.method||"GET",headers:i,body:e.body?JSON.stringify(e.body):void 0});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Figma API ${s.status}: ${o.slice(0,300)}`)}return s.json()}function oe(r){let e=String(r||"").trim(),t=e.match(/figma\.com\/(?:file|design|board|proto)\/([A-Za-z0-9]+)/i);return t?t[1]:e}function ht(r){return r==null?void 0:(Array.isArray(r)?r:String(r).split(",")).map(t=>String(t).trim().replace(/-/g,":")).filter(Boolean).join(",")}function ra(r){let e=String(r||"").match(/[?&]node-id=([^&]+)/i);return e?decodeURIComponent(e[1]).replace(/-/g,":"):void 0}var X=r=>typeof r=="number"?Math.round(r*100)/100:r;function Zt(r){if(!r)return null;let e=n=>Math.round((n??0)*255).toString(16).padStart(2,"0"),t={hex:`#${e(r.r)}${e(r.g)}${e(r.b)}`.toUpperCase()};return r.a!=null&&r.a<1&&(t.opacity=X(r.a)),t}function Xr(r){return!r||r.visible===!1?null:r.type==="SOLID"?{type:"SOLID",...Zt(r.color),...r.opacity!=null?{opacity:r.opacity}:{}}:{type:r.type,...r.opacity!=null?{opacity:r.opacity}:{},...r.gradientStops?{stops:r.gradientStops.map(e=>({position:X(e.position),...Zt(e.color)}))}:{}}}function en(r,e){let t=r.absoluteBoundingBox,n={id:r.id,name:r.name,type:r.type};t&&(n.size={w:X(t.width),h:X(t.height)},n.position={x:X(t.x),y:X(t.y)}),r.opacity!=null&&r.opacity!==1&&(n.opacity=r.opacity),r.cornerRadius!=null&&(n.cornerRadius=r.cornerRadius),Array.isArray(r.rectangleCornerRadii)&&(n.cornerRadii=r.rectangleCornerRadii);let i=(r.fills||[]).map(Xr).filter(Boolean);i.length&&(n.fills=i);let s=(r.strokes||[]).map(Xr).filter(Boolean);s.length&&(n.strokes=s,r.strokeWeight!=null&&(n.strokeWeight=r.strokeWeight));let o=(r.effects||[]).filter(a=>a.visible!==!1).map(a=>({type:a.type,...a.radius!=null?{radius:a.radius}:{},...a.offset?{offset:{x:X(a.offset.x),y:X(a.offset.y)}}:{},...a.spread?{spread:a.spread}:{},...a.color?Zt(a.color):{}}));if(o.length&&(n.effects=o),r.layoutMode&&r.layoutMode!=="NONE"&&(n.autoLayout={direction:r.layoutMode,padding:{l:r.paddingLeft??0,r:r.paddingRight??0,t:r.paddingTop??0,b:r.paddingBottom??0},gap:r.itemSpacing??0,align:{primary:r.primaryAxisAlignItems,counter:r.counterAxisAlignItems}}),r.type==="TEXT"){let a=r.style||{};n.text=r.characters,n.textStyle={fontFamily:a.fontFamily,fontWeight:a.fontWeight,fontSize:a.fontSize,lineHeightPx:a.lineHeightPx!=null?X(a.lineHeightPx):void 0,letterSpacing:a.letterSpacing!=null?X(a.letterSpacing):void 0,align:a.textAlignHorizontal,case:a.textCase}}return e>0&&Array.isArray(r.children)&&r.children.length&&(n.children=r.children.map(a=>en(a,e-1))),n}var tn={id:"figma",serverName:"figma",allowedTools:["mcp__figma__*"],requiresIntegration:N.FIGMA,envKeys:[],description:"Figma \u2014 read files, nodes and comments; extract dev-handoff specs (sizes/colors/fonts/auto-layout); list versions and image fills; render frames to PNG/JPG/SVG/PDF; browse team projects/files; and post comments",promptFragment:`## Figma
163
162
  You have access to the user's Figma files via the Figma REST API. Every tool that takes a file accepts EITHER the raw file key OR a full figma.com URL (figma.com/file|design/<key>/...). Node ids accept URL form \`1-23\` or API form \`1:23\` interchangeably. Tools:
164
163
 
165
164
  ### Identity
@@ -204,7 +203,7 @@ You have access to the user's Figma files via the Figma REST API. Every tool tha
204
203
  assignee { id name displayName email }
205
204
  labels { nodes { id name color } }
206
205
  team { id key name }
207
- `,on={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)
206
+ `,on={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
208
207
  You have direct access to the user's Linear workspace (GraphQL API). Tools:
209
208
 
210
209
  ### Discovery
@@ -303,7 +302,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
303
302
  query IssueById($id: String!) {
304
303
  issue(id: $id) { ${e} }
305
304
  }
306
- `,{id:t}))?.issue||null}var an={id:"plane",serverName:"plane",allowedTools:["mcp__plane__*"],requiresIntegration:N.PLANE,envKeys:["PLANE_API_KEY","PLANE_WORKSPACE_SLUG","PLANE_BASE_URL"],description:"Plane \u2014 projects, work items, cycles, modules, epics, comments (official MCP, API key)",tools:[],promptFragment:`## Plane (connected)
305
+ `,{id:t}))?.issue||null}var an={id:"plane",serverName:"plane",allowedTools:["mcp__plane__*"],requiresIntegration:N.PLANE,envKeys:["PLANE_API_KEY","PLANE_WORKSPACE_SLUG","PLANE_BASE_URL"],description:"Plane \u2014 projects, work items, cycles, modules, epics, comments (official MCP, API key)",tools:[],promptFragment:`## Plane
307
306
  You have direct access to the user's Plane workspace via the official Plane MCP server. All Plane tools are available under the mcp__plane__* namespace \u2014 use them proactively to read and write projects, work items (issues), cycles, modules, epics, sub-issues, comments, labels, states, pages, and workspace data.
308
307
 
309
308
  - List/get projects and work items, then create/update/delete or search work items as needed.
@@ -331,21 +330,21 @@ You may have access to the user's OpenDesign workspace (the Zibby-managed design
331
330
 
332
331
  ### Notes
333
332
  - A design artifact lookup ALWAYS needs its projectId (it scopes the query).
334
- - After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=va();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"opendesign_health":{let{baseUrl:t}=await cn(),n=await fetch(`${t}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await ln(n,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let t=await he("/projects");return JSON.stringify(t)}case"opendesign_get_project":{let t=e?.id||e?.projectId;if(!t)return JSON.stringify({error:"id is required"});let n=await he(`/projects/${encodeURIComponent(t)}`);return JSON.stringify(n)}case"opendesign_list_designs":{let t=e?.projectId;if(!t)return JSON.stringify({error:"projectId is required"});let n=await he("/live-artifacts",{query:{projectId:t}});return JSON.stringify(n)}case"opendesign_get_design":{let t=e?.id,n=e?.projectId;if(!t)return JSON.stringify({error:"id is required"});if(!n)return JSON.stringify({error:"projectId is required"});let i=await he(`/live-artifacts/${encodeURIComponent(t)}`,{query:{projectId:n}});return JSON.stringify(i)}case"opendesign_export_pdf":{let t=e?.projectId||e?.id,{fileName:n,title:i,deck:s}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"fileName is required"});let o={fileName:n};i!==void 0&&(o.title=i),s!==void 0&&(o.deck=s);let a=await he(`/projects/${encodeURIComponent(t)}/export/pdf`,{method:"POST",body:o});return JSON.stringify(a)}case"opendesign_export_html":{let t=e?.projectId||e?.id,n=e?.path;if(!t)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"path is required (the export sub-path)"});let s=String(n).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),o=await he(`/projects/${encodeURIComponent(t)}/export/${s}`,{query:{inline:1}});return JSON.stringify(o)}case"opendesign_cli_run":{let{agentId:t,message:n,projectId:i,conversationId:s,model:o}=e||{};if(!t)return JSON.stringify({error:"agentId is required"});if(!n)return JSON.stringify({error:"message is required"});let a={agentId:t,message:n};i!==void 0&&(a.projectId=i),s!==void 0&&(a.conversationId=s),o!==void 0&&(a.model=o);let c=await he("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let t=e?.id||e?.runId;if(!t)return JSON.stringify({error:"id (runId) is required"});let n=await he(`/runs/${encodeURIComponent(t)}`);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 Na}from"fs";import{fileURLToPath as Oa}from"url";import{dirname as Ta,resolve as Ra}from"path";import{resolveIntegrationToken as Aa}from"@zibby/core/backend-client.js";function Ea(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let r=Ta(Oa(import.meta.url)),e=Ra(r,"..","bin","mcp-slack.mjs");return Na(e)?e:null}async function G(r,e={}){let{token:t}=await Aa("slack"),n=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(r),i=`https://slack.com/api/${r}`,s={Authorization:`Bearer ${t}`},o;if(n){let d=new URLSearchParams(e).toString();d&&(i+=`?${d}`)}else s["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(e);let c=await(await fetch(i,{method:n?"GET":"POST",headers:s,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var $={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:N.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack (connected)
333
+ - After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=va();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"opendesign_health":{let{baseUrl:t}=await cn(),n=await fetch(`${t}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await ln(n,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let t=await he("/projects");return JSON.stringify(t)}case"opendesign_get_project":{let t=e?.id||e?.projectId;if(!t)return JSON.stringify({error:"id is required"});let n=await he(`/projects/${encodeURIComponent(t)}`);return JSON.stringify(n)}case"opendesign_list_designs":{let t=e?.projectId;if(!t)return JSON.stringify({error:"projectId is required"});let n=await he("/live-artifacts",{query:{projectId:t}});return JSON.stringify(n)}case"opendesign_get_design":{let t=e?.id,n=e?.projectId;if(!t)return JSON.stringify({error:"id is required"});if(!n)return JSON.stringify({error:"projectId is required"});let i=await he(`/live-artifacts/${encodeURIComponent(t)}`,{query:{projectId:n}});return JSON.stringify(i)}case"opendesign_export_pdf":{let t=e?.projectId||e?.id,{fileName:n,title:i,deck:s}=e||{};if(!t)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"fileName is required"});let o={fileName:n};i!==void 0&&(o.title=i),s!==void 0&&(o.deck=s);let a=await he(`/projects/${encodeURIComponent(t)}/export/pdf`,{method:"POST",body:o});return JSON.stringify(a)}case"opendesign_export_html":{let t=e?.projectId||e?.id,n=e?.path;if(!t)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"path is required (the export sub-path)"});let s=String(n).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),o=await he(`/projects/${encodeURIComponent(t)}/export/${s}`,{query:{inline:1}});return JSON.stringify(o)}case"opendesign_cli_run":{let{agentId:t,message:n,projectId:i,conversationId:s,model:o}=e||{};if(!t)return JSON.stringify({error:"agentId is required"});if(!n)return JSON.stringify({error:"message is required"});let a={agentId:t,message:n};i!==void 0&&(a.projectId=i),s!==void 0&&(a.conversationId=s),o!==void 0&&(a.model=o);let c=await he("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let t=e?.id||e?.runId;if(!t)return JSON.stringify({error:"id (runId) is required"});let n=await he(`/runs/${encodeURIComponent(t)}`);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 Na}from"fs";import{fileURLToPath as Oa}from"url";import{dirname as Ta,resolve as Ra}from"path";import{resolveIntegrationToken as Aa}from"@zibby/core/backend-client.js";function Ea(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let r=Ta(Oa(import.meta.url)),e=Ra(r,"..","bin","mcp-slack.mjs");return Na(e)?e:null}async function G(r,e={}){let{token:t}=await Aa("slack"),n=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(r),i=`https://slack.com/api/${r}`,s={Authorization:`Bearer ${t}`},o;if(n){let d=new URLSearchParams(e).toString();d&&(i+=`?${d}`)}else s["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(e);let c=await(await fetch(i,{method:n?"GET":"POST",headers:s,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var $={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:N.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack
335
334
  You have access to the user's Slack workspace. Use these tools:
336
335
  - slack_list_channels, slack_post_message, slack_reply_to_thread
337
336
  - slack_add_reaction, slack_get_channel_history, slack_get_thread_replies
338
337
  - slack_get_users, slack_get_user_profile
339
338
  - slack_lookup_user_by_email (precise email\u2192user_id, prefer this over scanning slack_get_users)
340
- - slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let r=Ea();if(!r)return null;let e={};for(let t 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[t]&&(e[t]=process.env[t]);for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r],env:e,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"slack_list_channels":{let t=await G("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(t.channels||[]).map(n=>({id:n.id,name:n.name,topic:n.topic?.value}))})}case"slack_post_message":{if(!e.channel||!e.text)return JSON.stringify({error:"channel and text are required"});let t=await G("chat.postMessage",{channel:e.channel,text:e.text,...e.blocks?{blocks:e.blocks}:{}});return JSON.stringify({ok:!0,ts:t.ts,channel:t.channel})}case"slack_reply_to_thread":{if(!e.channel||!e.thread_ts||!e.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let t=await G("chat.postMessage",{channel:e.channel,thread_ts:e.thread_ts,text:e.text});return JSON.stringify({ok:!0,ts:t.ts})}case"slack_add_reaction":return!e.channel||!e.timestamp||!e.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await G("reactions.add",{channel:e.channel,timestamp:e.timestamp,name:e.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!e.channel)return JSON.stringify({error:"channel is required"});let t=await G("conversations.history",{channel:e.channel,limit:e.limit||20});return JSON.stringify({messages:(t.messages||[]).map(n=>({user:n.user,text:n.text,ts:n.ts}))})}case"slack_get_thread_replies":{if(!e.channel||!e.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let t=await G("conversations.replies",{channel:e.channel,ts:e.thread_ts});return JSON.stringify({messages:(t.messages||[]).map(n=>({user:n.user,text:n.text,ts:n.ts}))})}case"slack_get_users":{let t=await G("users.list",{limit:100});return JSON.stringify({users:(t.members||[]).filter(n=>!n.is_bot&&!n.deleted).map(n=>({id:n.id,name:n.real_name||n.name}))})}case"slack_get_user_profile":{if(!e.user_id)return JSON.stringify({error:"user_id is required"});let t=await G("users.profile.get",{user:e.user_id});return JSON.stringify({profile:t.profile})}case"slack_lookup_user_by_email":{if(!e.email)return JSON.stringify({error:"email is required"});try{let t=await G("users.lookupByEmail",{email:e.email});return JSON.stringify({ok:!0,user:{id:t.user?.id,name:t.user?.real_name||t.user?.name,email:t.user?.profile?.email||e.email}})}catch(t){if(/users_not_found/.test(t.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw t}}case"slack_list_usergroups":{let t=await G("usergroups.list",{});return JSON.stringify({usergroups:(t.usergroups||[]).map(n=>({id:n.id,handle:n.handle,name:n.name,description:n.description||"",user_count:Number(n.user_count||0)}))})}case"slack_get_usergroup_members":{if(!e.usergroup)return JSON.stringify({error:"usergroup id is required"});let t=await G("usergroups.users.list",{usergroup:e.usergroup});return JSON.stringify({users:t.users||[]})}case"slack_search_users":{if(!e.query||typeof e.query!="string")return JSON.stringify({error:"query is required"});let t=e.query.trim().toLowerCase();if(!t)return JSON.stringify({ok:!0,matches:[]});let n=Math.max(1,Math.min(Number(e.limit)||5,25)),i=[],s,o=5;for(let c=0;c<o;c+=1){let d={limit:200};s&&(d.cursor=s);let l=await G("users.list",d);for(let p of l.members||[])p.deleted||p.is_bot||i.push(p);if(s=l.response_metadata?.next_cursor,!s)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(t)&&(u+=100-Math.abs(d.length-t.length)),l.includes(t)&&(u+=60-Math.abs(l.length-t.length)),p.includes(t)&&(u+=30-Math.abs(p.length-t.length)),(d===t||l===t)&&(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,n).map(({_score:c,...d})=>d),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 xa}from"fs";import{fileURLToPath as La}from"url";import{dirname as ja,resolve as $a}from"path";import{resolveIntegrationToken as Pa}from"@zibby/core/backend-client.js";function Ca(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let r=ja(La(import.meta.url)),e=$a(r,"..","bin","mcp-lark.mjs");return xa(e)?e:null}var Ua=6e3*1e3,Ye=null;async function Ja(){let{appId:r,appSecret:e,host:t}=await Pa("lark");if(Ye&&Ye.appId===r&&Ye.expiresAt>Date.now())return{token:Ye.token,host:t};let i=await(await fetch(`${t}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:r,app_secret:e})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return Ye={token:i.tenant_access_token,expiresAt:Date.now()+Ua,appId:r},{token:i.tenant_access_token,host:t}}async function be(r,e,t={}){let{token:n,host:i}=await Ja(),s=`${i}${e}`,o={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&(o.body=JSON.stringify(t));let c=await(await fetch(s,o)).json();if(c.code!==0)throw new Error(`Lark API ${e} error: ${c.msg||c.code}`);return c.data||{}}function pn(r){return JSON.stringify({text:r})}function qa(r){return!r||typeof r!="string"||r.startsWith("oc_")?"chat_id":r.startsWith("ou_")?"open_id":r.startsWith("on_")?"union_id":r.startsWith("cli_")?"app_id":r.includes("@")?"email":"chat_id"}var D={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)
339
+ - slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let r=Ea();if(!r)return null;let e={};for(let t 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[t]&&(e[t]=process.env[t]);for(let t of this.envKeys)process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r],env:e,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"slack_list_channels":{let t=await G("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(t.channels||[]).map(n=>({id:n.id,name:n.name,topic:n.topic?.value}))})}case"slack_post_message":{if(!e.channel||!e.text)return JSON.stringify({error:"channel and text are required"});let t=await G("chat.postMessage",{channel:e.channel,text:e.text,...e.blocks?{blocks:e.blocks}:{}});return JSON.stringify({ok:!0,ts:t.ts,channel:t.channel})}case"slack_reply_to_thread":{if(!e.channel||!e.thread_ts||!e.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let t=await G("chat.postMessage",{channel:e.channel,thread_ts:e.thread_ts,text:e.text});return JSON.stringify({ok:!0,ts:t.ts})}case"slack_add_reaction":return!e.channel||!e.timestamp||!e.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await G("reactions.add",{channel:e.channel,timestamp:e.timestamp,name:e.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!e.channel)return JSON.stringify({error:"channel is required"});let t=await G("conversations.history",{channel:e.channel,limit:e.limit||20});return JSON.stringify({messages:(t.messages||[]).map(n=>({user:n.user,text:n.text,ts:n.ts}))})}case"slack_get_thread_replies":{if(!e.channel||!e.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let t=await G("conversations.replies",{channel:e.channel,ts:e.thread_ts});return JSON.stringify({messages:(t.messages||[]).map(n=>({user:n.user,text:n.text,ts:n.ts}))})}case"slack_get_users":{let t=await G("users.list",{limit:100});return JSON.stringify({users:(t.members||[]).filter(n=>!n.is_bot&&!n.deleted).map(n=>({id:n.id,name:n.real_name||n.name}))})}case"slack_get_user_profile":{if(!e.user_id)return JSON.stringify({error:"user_id is required"});let t=await G("users.profile.get",{user:e.user_id});return JSON.stringify({profile:t.profile})}case"slack_lookup_user_by_email":{if(!e.email)return JSON.stringify({error:"email is required"});try{let t=await G("users.lookupByEmail",{email:e.email});return JSON.stringify({ok:!0,user:{id:t.user?.id,name:t.user?.real_name||t.user?.name,email:t.user?.profile?.email||e.email}})}catch(t){if(/users_not_found/.test(t.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw t}}case"slack_list_usergroups":{let t=await G("usergroups.list",{});return JSON.stringify({usergroups:(t.usergroups||[]).map(n=>({id:n.id,handle:n.handle,name:n.name,description:n.description||"",user_count:Number(n.user_count||0)}))})}case"slack_get_usergroup_members":{if(!e.usergroup)return JSON.stringify({error:"usergroup id is required"});let t=await G("usergroups.users.list",{usergroup:e.usergroup});return JSON.stringify({users:t.users||[]})}case"slack_search_users":{if(!e.query||typeof e.query!="string")return JSON.stringify({error:"query is required"});let t=e.query.trim().toLowerCase();if(!t)return JSON.stringify({ok:!0,matches:[]});let n=Math.max(1,Math.min(Number(e.limit)||5,25)),i=[],s,o=5;for(let c=0;c<o;c+=1){let d={limit:200};s&&(d.cursor=s);let l=await G("users.list",d);for(let p of l.members||[])p.deleted||p.is_bot||i.push(p);if(s=l.response_metadata?.next_cursor,!s)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(t)&&(u+=100-Math.abs(d.length-t.length)),l.includes(t)&&(u+=60-Math.abs(l.length-t.length)),p.includes(t)&&(u+=30-Math.abs(p.length-t.length)),(d===t||l===t)&&(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,n).map(({_score:c,...d})=>d),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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 xa}from"fs";import{fileURLToPath as La}from"url";import{dirname as ja,resolve as $a}from"path";import{resolveIntegrationToken as Pa}from"@zibby/core/backend-client.js";function Ca(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let r=ja(La(import.meta.url)),e=$a(r,"..","bin","mcp-lark.mjs");return xa(e)?e:null}var Ua=6e3*1e3,Ye=null;async function Ja(){let{appId:r,appSecret:e,host:t}=await Pa("lark");if(Ye&&Ye.appId===r&&Ye.expiresAt>Date.now())return{token:Ye.token,host:t};let i=await(await fetch(`${t}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:r,app_secret:e})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return Ye={token:i.tenant_access_token,expiresAt:Date.now()+Ua,appId:r},{token:i.tenant_access_token,host:t}}async function be(r,e,t={}){let{token:n,host:i}=await Ja(),s=`${i}${e}`,o={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&(o.body=JSON.stringify(t));let c=await(await fetch(s,o)).json();if(c.code!==0)throw new Error(`Lark API ${e} error: ${c.msg||c.code}`);return c.data||{}}function pn(r){return JSON.stringify({text:r})}function Ba(r){return!r||typeof r!="string"||r.startsWith("oc_")?"chat_id":r.startsWith("ou_")?"open_id":r.startsWith("on_")?"union_id":r.startsWith("cli_")?"app_id":r.includes("@")?"email":"chat_id"}var D={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:N.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark
341
340
  You can send messages and replies on Lark. Use:
342
341
  - lark_send_message: post a message to a chat, user, or DM
343
342
  - lark_reply: reply to an existing message (threaded)
344
343
  - lark_list_chats: list chats the bot is a member of
345
344
  - lark_get_chat_history: fetch recent messages in a chat
346
345
  - 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)
347
- When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let r=Ca();if(!r)return null;let e={};for(let t 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[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r],env:e,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(r,e){try{switch(r){case"lark_send_message":{if(!e.receive_id||!e.text)return JSON.stringify({error:"receive_id and text are required"});let t=qa(e.receive_id),n=await be("POST",`/open-apis/im/v1/messages?receive_id_type=${t}`,{receive_id:e.receive_id,msg_type:"text",content:pn(e.text)});return JSON.stringify({ok:!0,message_id:n.message_id})}case"lark_reply":{if(!e.message_id||!e.text)return JSON.stringify({error:"message_id and text are required"});let t=await be("POST",`/open-apis/im/v1/messages/${encodeURIComponent(e.message_id)}/reply`,{msg_type:"text",content:pn(e.text)});return JSON.stringify({ok:!0,message_id:t.message_id})}case"lark_list_chats":{let t=e.page_size||50,i=((await be("GET",`/open-apis/im/v1/chats?page_size=${t}`)).items||[]).map(s=>({chat_id:s.chat_id,name:s.name,description:s.description,owner_id:s.owner_id,chat_mode:s.chat_mode}));return JSON.stringify({chats:i})}case"lark_get_chat_history":{if(!e.chat_id)return JSON.stringify({error:"chat_id is required"});let t=e.page_size||20,i=((await be("GET",`/open-apis/im/v1/messages?container_id_type=chat&container_id=${encodeURIComponent(e.chat_id)}&page_size=${t}&sort_type=ByCreateTimeDesc`)).items||[]).map(s=>({message_id:s.message_id,sender_id:s.sender?.id,sender_type:s.sender?.sender_type,msg_type:s.msg_type,content:s.body?.content,create_time:s.create_time}));return JSON.stringify({messages:i})}case"lark_lookup_user_by_email":{if(!e.email)return JSON.stringify({error:"email is required"});let n=((await be("POST","/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id",{emails:[e.email]})).user_list||[]).find(i=>i.email===e.email&&i.user_id);return JSON.stringify(n?{ok:!0,user:{open_id:n.user_id,email:n.email,name:n.name||void 0}}:{ok:!1,reason:"no_lark_user_for_email"})}case"lark_search_users":{if(!e.query||typeof e.query!="string")return JSON.stringify({error:"query is required"});let t=e.query.trim().toLowerCase();if(!t)return JSON.stringify({ok:!0,matches:[]});let n=Math.max(1,Math.min(Number(e.limit)||5,25)),i=200,o=((await be("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 be("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(t)&&(u+=100-Math.abs(p.length-t.length)),p===t&&(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,n).map(({_score:l,...p})=>p),scanned:c.length})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.message})}}};import{existsSync as Ba}from"fs";import{fileURLToPath as Da}from"url";import{dirname as Ma,resolve as Fa}from"path";import{resolveIntegrationToken as Ka}from"@zibby/core/backend-client.js";function Ga(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Ma(Da(import.meta.url)),e=Fa(r,"..","bin","mcp-skill.mjs");return Ba(e)?e:null}var Ha=process.env.DISCORD_API_URL||"https://discord.com/api/v10",za=2e3;function Ya(r,e=za){let t=String(r??"");if(!t.trim())return[];if(t.length<=e)return[t];let n=[],i=t;for(;i.length>e;){let o=i.slice(0,e).lastIndexOf(`
348
- `),a=o>e/2?o+1:e;n.push(i.slice(0,a)),i=i.slice(a)}return i&&n.push(i),n}async function un(){let r=(process.env.DISCORD_BOT_TOKEN||"").trim();if(r)return{token:r,guildId:(process.env.DISCORD_GUILD_ID||"").trim()};let e=await Ka(N.DISCORD),t=(e&&e.token?String(e.token):"").trim();if(!t)throw new Error("Discord is not connected: connect Discord in the Zibby dashboard or set DISCORD_BOT_TOKEN.");return{token:t,guildId:(e.guildId||"").trim()}}async function Vt(r,e,{token:t,body:n}={}){let i=t.startsWith("Bot ")?t:`Bot ${t}`,s=await fetch(`${Ha}${e}`,{method:r,headers:{Authorization:i,...n!==void 0?{"Content-Type":"application/json"}:{}},...n!==void 0?{body:JSON.stringify(n)}:{}}),o=await s.json().catch(()=>null);if(!s.ok){let a=o&&(o.message||o.error)?o.message||o.error:`HTTP ${s.status}`;throw new Error(`Discord API error (${s.status}): ${a}`)}return o}async function Wa({token:r,guildId:e},t){let n=String(t||"").trim()||e||(process.env.DISCORD_GUILD_ID||"").trim();if(n)return n;let i=await Vt("GET","/users/@me/guilds",{token:r}),s=Array.isArray(i)?i:[];if(s.length===1)return s[0].id;if(s.length===0)throw new Error("The bot is not in any Discord server \u2014 invite it to a server first.");let o=s.slice(0,10).map(a=>`${a.name} (${a.id})`).join(", ");throw new Error(`The bot is in ${s.length} servers \u2014 pass guildId explicitly. Servers: ${o}`)}var mn={id:"discord",serverName:"discord",allowedTools:["mcp__discord__*"],requiresIntegration:N.DISCORD,envKeys:["DISCORD_BOT_TOKEN","DISCORD_GUILD_ID"],description:"Discord bot tools (send messages, list channels)",promptFragment:`## Discord (connected)
346
+ When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let r=Ca();if(!r)return null;let e={};for(let t 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[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r],env:e,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(r,e){try{switch(r){case"lark_send_message":{if(!e.receive_id||!e.text)return JSON.stringify({error:"receive_id and text are required"});let t=Ba(e.receive_id),n=await be("POST",`/open-apis/im/v1/messages?receive_id_type=${t}`,{receive_id:e.receive_id,msg_type:"text",content:pn(e.text)});return JSON.stringify({ok:!0,message_id:n.message_id})}case"lark_reply":{if(!e.message_id||!e.text)return JSON.stringify({error:"message_id and text are required"});let t=await be("POST",`/open-apis/im/v1/messages/${encodeURIComponent(e.message_id)}/reply`,{msg_type:"text",content:pn(e.text)});return JSON.stringify({ok:!0,message_id:t.message_id})}case"lark_list_chats":{let t=e.page_size||50,i=((await be("GET",`/open-apis/im/v1/chats?page_size=${t}`)).items||[]).map(s=>({chat_id:s.chat_id,name:s.name,description:s.description,owner_id:s.owner_id,chat_mode:s.chat_mode}));return JSON.stringify({chats:i})}case"lark_get_chat_history":{if(!e.chat_id)return JSON.stringify({error:"chat_id is required"});let t=e.page_size||20,i=((await be("GET",`/open-apis/im/v1/messages?container_id_type=chat&container_id=${encodeURIComponent(e.chat_id)}&page_size=${t}&sort_type=ByCreateTimeDesc`)).items||[]).map(s=>({message_id:s.message_id,sender_id:s.sender?.id,sender_type:s.sender?.sender_type,msg_type:s.msg_type,content:s.body?.content,create_time:s.create_time}));return JSON.stringify({messages:i})}case"lark_lookup_user_by_email":{if(!e.email)return JSON.stringify({error:"email is required"});let n=((await be("POST","/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id",{emails:[e.email]})).user_list||[]).find(i=>i.email===e.email&&i.user_id);return JSON.stringify(n?{ok:!0,user:{open_id:n.user_id,email:n.email,name:n.name||void 0}}:{ok:!1,reason:"no_lark_user_for_email"})}case"lark_search_users":{if(!e.query||typeof e.query!="string")return JSON.stringify({error:"query is required"});let t=e.query.trim().toLowerCase();if(!t)return JSON.stringify({ok:!0,matches:[]});let n=Math.max(1,Math.min(Number(e.limit)||5,25)),i=200,o=((await be("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 be("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(t)&&(u+=100-Math.abs(p.length-t.length)),p===t&&(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,n).map(({_score:l,...p})=>p),scanned:c.length})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.message})}}};import{existsSync as qa}from"fs";import{fileURLToPath as Da}from"url";import{dirname as Ma,resolve as Fa}from"path";import{resolveIntegrationToken as Ka}from"@zibby/core/backend-client.js";function Ga(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Ma(Da(import.meta.url)),e=Fa(r,"..","bin","mcp-skill.mjs");return qa(e)?e:null}var Ha=process.env.DISCORD_API_URL||"https://discord.com/api/v10",za=2e3;function Ya(r,e=za){let t=String(r??"");if(!t.trim())return[];if(t.length<=e)return[t];let n=[],i=t;for(;i.length>e;){let o=i.slice(0,e).lastIndexOf(`
347
+ `),a=o>e/2?o+1:e;n.push(i.slice(0,a)),i=i.slice(a)}return i&&n.push(i),n}async function un(){let r=(process.env.DISCORD_BOT_TOKEN||"").trim();if(r)return{token:r,guildId:(process.env.DISCORD_GUILD_ID||"").trim()};let e=await Ka(N.DISCORD),t=(e&&e.token?String(e.token):"").trim();if(!t)throw new Error("Discord is not connected: connect Discord in the Zibby dashboard or set DISCORD_BOT_TOKEN.");return{token:t,guildId:(e.guildId||"").trim()}}async function Vt(r,e,{token:t,body:n}={}){let i=t.startsWith("Bot ")?t:`Bot ${t}`,s=await fetch(`${Ha}${e}`,{method:r,headers:{Authorization:i,...n!==void 0?{"Content-Type":"application/json"}:{}},...n!==void 0?{body:JSON.stringify(n)}:{}}),o=await s.json().catch(()=>null);if(!s.ok){let a=o&&(o.message||o.error)?o.message||o.error:`HTTP ${s.status}`;throw new Error(`Discord API error (${s.status}): ${a}`)}return o}async function Wa({token:r,guildId:e},t){let n=String(t||"").trim()||e||(process.env.DISCORD_GUILD_ID||"").trim();if(n)return n;let i=await Vt("GET","/users/@me/guilds",{token:r}),s=Array.isArray(i)?i:[];if(s.length===1)return s[0].id;if(s.length===0)throw new Error("The bot is not in any Discord server \u2014 invite it to a server first.");let o=s.slice(0,10).map(a=>`${a.name} (${a.id})`).join(", ");throw new Error(`The bot is in ${s.length} servers \u2014 pass guildId explicitly. Servers: ${o}`)}var mn={id:"discord",serverName:"discord",allowedTools:["mcp__discord__*"],requiresIntegration:N.DISCORD,envKeys:["DISCORD_BOT_TOKEN","DISCORD_GUILD_ID"],description:"Discord bot tools (send messages, list channels)",promptFragment:`## Discord
349
348
  You can post to the user's Discord server as their bot. Tools:
350
349
  - discord_send_message(channelId, text) \u2014 post a message to a channel (long text is auto-chunked to Discord's 2000-char limit)
351
350
  - discord_list_channels(guildId?) \u2014 list the server's text channels (id + name) to find where to post; guildId is optional when the bot is in one server`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);for(let t of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_SELF_HOST","DISCORD_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[t]&&(r[t]=process.env[t]);let e=Ga();return e?{type:"stdio",command:"node",args:[e,"../dist/discord.js","discordSkill"],env:r,description:this.description,alwaysLoad:!0}:{command:null,args:[],env:r,description:this.description}},async handleToolCall(r,e={}){try{switch(r){case"discord_send_message":{let t=String(e.channelId||"").trim(),n=String(e.text||"");if(!t||!n.trim())return JSON.stringify({ok:!1,error:"channelId and text are required"});let i=await un(),s=Ya(n),o=[];for(let a of s){let c=await Vt("POST",`/channels/${encodeURIComponent(t)}/messages`,{token:i.token,body:{content:a}});o.push(c&&c.id?c.id:"")}return JSON.stringify({ok:!0,channelId:t,messageIds:o,chunks:s.length})}case"discord_list_channels":{let t=await un(),n=await Wa(t,e.guildId),i=await Vt("GET",`/guilds/${encodeURIComponent(n)}/channels`,{token:t.token}),s=(Array.isArray(i)?i:[]).filter(o=>o&&(o.type===0||o.type===5)).map(o=>({id:o.id,name:o.name,type:o.type===5?"announcement":"text",...o.topic?{topic:o.topic}:{}}));return JSON.stringify({ok:!0,guildId:n,channels:s})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"discord_send_message",description:"Post a message to a Discord channel as the connected bot. Text over 2000 chars is automatically split into sequential messages.",input_schema:{type:"object",properties:{channelId:{type:"string",description:"Discord channel id (snowflake). Use discord_list_channels to find it."},text:{type:"string",description:"Message text (Discord markdown supported)"}},required:["channelId","text"]}},{name:"discord_list_channels",description:"List the text channels of the connected Discord server (id + name). Pass guildId only when the bot is in multiple servers.",input_schema:{type:"object",properties:{guildId:{type:"string",description:"Discord server (guild) id \u2014 optional when the bot is in exactly one server or one was captured at connect time"}}}}]};import{existsSync as bn,statSync as Za,readFileSync as Va}from"fs";import{fileURLToPath as Qa}from"url";import{basename as Xa,dirname as ec,resolve as tc}from"path";import{resolveIntegrationToken as rc,clearTokenCache as nc}from"@zibby/core/backend-client.js";function ic(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=ec(Qa(import.meta.url)),e=tc(r,"..","bin","mcp-skill.mjs");return bn(e)?e:null}var sc="2022-06-28",oc="https://api.notion.com/v1",yt=2e4,fn=25,ac=25,gt=100,hn=500,cc=20*1024*1024;function ae(r){if(!r||typeof r!="string")return null;let t=r.trim().split(/[?#]/)[0],n=t.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(n)return n[0].toLowerCase();let i=t.match(/[0-9a-fA-F]{32}/g);if(i&&i.length){let s=i[i.length-1].toLowerCase();return`${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20)}`}return null}async function te(r,e={}){let t=async()=>{let{token:n}=await rc("notion");if(typeof n!="string"||!n)throw new Error(`Invalid notion token type: ${typeof n}`);let i=await fetch(`${oc}${r}`,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,"Notion-Version":sc,Accept:"application/json",...e.body&&!e.formData?{"Content-Type":"application/json"}:{},...e.headers},body:e.formData?e.formData:e.body?JSON.stringify(e.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Notion API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await t()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return nc("notion"),t()}}function Ce(r){if(!Array.isArray(r))return"";let e="";for(let t of r){let n=t?.plain_text??t?.text?.content??"";if(!n)continue;let i=t.annotations||{};i.code&&(n=`\`${n}\``),i.bold&&(n=`**${n}**`),i.italic&&(n=`_${n}_`),i.strikethrough&&(n=`~~${n}~~`);let s=t?.href||t?.text?.link?.url;s&&(n=`[${n}](${s})`),e+=n}return e}function lc(r,e,t){let n=r?.type,i=r?.[n]||{},s=" ".repeat(Math.max(0,e)),o=(d="rich_text")=>Ce(i[d]),a;switch(n){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=`${s}- ${o()}`;break;case"numbered_list_item":a=`${s}1. ${o()}`;break;case"to_do":a=`${s}- [${i.checked?"x":" "}] ${o()}`;break;case"toggle":a=`${s}- ${o()}`;break;case"quote":a=`> ${o()}`;break;case"callout":{a=`> ${i.icon?.emoji?`${i.icon.emoji} `:""}${o()}`;break}case"code":{a=`\`\`\`${i.language||""}
@@ -354,7 +353,7 @@ ${o()}
354
353
  `)}async function kn(r,e,t){let n=[],i,s=0;do{if(t.used>=yt)break;let o=new URLSearchParams({page_size:"100"});i&&o.set("start_cursor",i);let a=await te(`/blocks/${r}/children?${o.toString()}`),c=Array.isArray(a.results)?a.results:[];for(let d of c){let l="";d.has_children&&(l=await kn(d.id,e+1,t));let p=lc(d,e,l);if(p&&(n.push(p),t.used+=p.length+1),t.used>=yt)break}i=a.has_more?a.next_cursor:void 0,s+=1}while(i&&s<ac);return n.join(`
355
354
  `)}function yn(r){let e=r?.properties||{};for(let t of Object.values(e))if(t?.type==="title"){let n=Ce(t.title).trim();if(n)return n}return""}function We(r){let e=String(r??"");if(!e)return[{type:"text",text:{content:""}}];let t=[];for(let n=0;n<e.length;n+=2e3)t.push({type:"text",text:{content:e.slice(n,n+2e3)}});return t}function dc(r){return{id:r?.id||"",discussionId:r?.discussion_id||"",text:Ce(r?.rich_text).trim(),author:r?.created_by?.id||"",createdTime:r?.created_time||""}}function pc(r){if(!r||!r.type)return"";switch(r.type){case"title":return Ce(r.title).trim();case"rich_text":return Ce(r.rich_text).trim();case"number":return r.number==null?"":String(r.number);case"select":return r.select?.name||"";case"status":return r.status?.name||"";case"multi_select":return(r.multi_select||[]).map(t=>t.name).join(", ");case"checkbox":return r.checkbox?"true":"false";case"url":return r.url||"";case"email":return r.email||"";case"phone_number":return r.phone_number||"";case"date":return r.date?.start||"";case"people":return(r.people||[]).map(t=>t.name||t.id).join(", ");default:return""}}function Qt(r){return`https://www.notion.so/${String(r||"").replace(/-/g,"")}`}function uc(r){let e=String(r??"").replace(/\r\n/g,`
356
355
  `),t=[];for(let n of e.split(`
357
- `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,d;s?(c=`heading_${s[1].length}`,d=s[2]):o?(c="bulleted_list_item",d=o[1]):a?(c="numbered_list_item",d=a[1]):(c="paragraph",d=i),t.push({object:"block",type:c,[c]:{rich_text:We(d)}})}return t}function gn(r){return Array.isArray(r?.blocks)&&r.blocks.length?r.blocks.slice(0,hn):typeof r?.markdown=="string"&&r.markdown.trim()?uc(r.markdown).slice(0,hn):null}async function _n(r,e){for(let t=0;t<e.length;t+=gt)await te(`/blocks/${r}/children`,{method:"PATCH",body:{children:e.slice(t,t+gt)}})}function mc(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!bn(e)||!Za(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=Va(e);if(t.length>cc)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 20MB (Notion single_part upload cap)`);return t}async function fc(r){let e=mc(r),t=Xa(r.trim()),n=/\.png$/i.test(t)?"image/png":"image/jpeg",s=(await te("/file_uploads",{method:"POST",body:{mode:"single_part",filename:t}}))?.id;if(!s)throw new Error("Notion file upload create returned no id");let o=new FormData;return o.set("file",new Blob([e],{type:n}),t),await te(`/file_uploads/${s}/send`,{method:"POST",formData:o}),s}var wn={id:"notion",serverName:"notion",allowedTools:["mcp__notion__*"],requiresIntegration:N.NOTION,description:"Notion \u2014 read pages/databases as context + create pages, append blocks, and insert images",promptFragment:`## Notion (connected)
356
+ `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,d;s?(c=`heading_${s[1].length}`,d=s[2]):o?(c="bulleted_list_item",d=o[1]):a?(c="numbered_list_item",d=a[1]):(c="paragraph",d=i),t.push({object:"block",type:c,[c]:{rich_text:We(d)}})}return t}function gn(r){return Array.isArray(r?.blocks)&&r.blocks.length?r.blocks.slice(0,hn):typeof r?.markdown=="string"&&r.markdown.trim()?uc(r.markdown).slice(0,hn):null}async function _n(r,e){for(let t=0;t<e.length;t+=gt)await te(`/blocks/${r}/children`,{method:"PATCH",body:{children:e.slice(t,t+gt)}})}function mc(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!bn(e)||!Za(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=Va(e);if(t.length>cc)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 20MB (Notion single_part upload cap)`);return t}async function fc(r){let e=mc(r),t=Xa(r.trim()),n=/\.png$/i.test(t)?"image/png":"image/jpeg",s=(await te("/file_uploads",{method:"POST",body:{mode:"single_part",filename:t}}))?.id;if(!s)throw new Error("Notion file upload create returned no id");let o=new FormData;return o.set("file",new Blob([e],{type:n}),t),await te(`/file_uploads/${s}/send`,{method:"POST",formData:o}),s}var wn={id:"notion",serverName:"notion",allowedTools:["mcp__notion__*"],requiresIntegration:N.NOTION,description:"Notion \u2014 read pages/databases as context + create pages, append blocks, and insert images",promptFragment:`## Notion
358
357
  You can read Notion content as context AND write to Notion (create pages, append blocks, insert images).
359
358
  - 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.
360
359
  - 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.
@@ -363,7 +362,7 @@ You can read Notion content as context AND write to Notion (create pages, append
363
362
  - notion_insert_image: append an image block to a page. Pass { pageId, imagePath } for a LOCAL png/jpg file (\u226420MB, uploaded via Notion's File Upload API) or { pageId, imageUrl } for an external, publicly reachable image URL. Optional caption. Returns { ok, pageId, url }.
364
363
  - notion_list_comments: pass a page/block id OR URL; returns the open comment discussions on it ({ id, discussionId, text, author }). Use to read the comment thread you are replying to.
365
364
  - notion_add_comment: post a comment. To REPLY in an existing discussion pass { discussionId, text }; to start a NEW top-level comment on a page pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment \u2014 reply in the SAME discussionId.
366
- 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" / "cannot deliver to Notion" and continue.`,resolve(){let r=ic();return r?{type:"stdio",command:"node",args:[r,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(r,e){try{switch(r){case"notion_get_page":{let t=e?.pageId||e?.page||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await te(`/pages/${n}`),s=yn(i),o=i?.url||`https://www.notion.so/${n.replace(/-/g,"")}`,c=await kn(n,0,{used:0}),d=!1;return c.length>yt&&(c=c.slice(0,yt),d=!0),JSON.stringify({ok:!0,id:n,title:s,url:o,text:c,...d?{truncated:!0}:{}})}case"notion_query_database":{let t=e?.databaseId||e?.database||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let s={page_size:Math.max(1,Math.min(Number(e?.maxResults)||fn,fn))};e?.filter&&typeof e.filter=="object"&&(s.filter=e.filter);let o=await te(`/databases/${n}/query`,{method:"POST",body:s}),c=(Array.isArray(o.results)?o.results:[]).map(d=>{let l={};for(let[p,u]of Object.entries(d.properties||{})){let m=pc(u);m&&(l[p]=m)}return{id:d.id,title:yn(d),url:d.url||`https://www.notion.so/${String(d.id||"").replace(/-/g,"")}`,props:l}});return JSON.stringify({ok:!0,id:n,count:c.length,hasMore:!!o.has_more,rows:c})}case"notion_create_page":{let t=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!t)return JSON.stringify({ok:!1,error:"title is required"});let n=e?.databaseId?ae(e.databaseId):null,i=e?.parentPageId?ae(e.parentPageId):ae(e?.parent||e?.pageId);if(!n&&!i)return JSON.stringify({ok:!1,error:"A valid parentPageId or databaseId is required"});let s=n?{database_id:n}:{page_id:i},o={title:{title:We(t)}},a=gn(e)||[],c=a.slice(0,gt),d=await te("/pages",{method:"POST",body:{parent:s,properties:o,...c.length?{children:c}:{}}}),l=d?.id;if(!l)return JSON.stringify({ok:!1,error:"Notion page create returned no id"});let p=a.slice(gt);return p.length&&await _n(l,p),JSON.stringify({ok:!0,pageId:l,url:d?.url||Qt(l)})}case"notion_append_blocks":{let t=ae(e?.pageId||e?.blockId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=gn(e);return!n||!n.length?JSON.stringify({ok:!1,error:"markdown or blocks content is required"}):(await _n(t,n),JSON.stringify({ok:!0,pageId:t,url:Qt(t)}))}case"notion_insert_image":{let t=ae(e?.pageId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=typeof e?.caption=="string"&&e.caption.trim()?We(e.caption.trim()):null,i,s;if(typeof e?.imagePath=="string"&&e.imagePath.trim())s=await fc(e.imagePath),i={type:"file_upload",file_upload:{id:s}};else if(typeof e?.imageUrl=="string"&&e.imageUrl.trim())i={type:"external",external:{url:e.imageUrl.trim()}};else return JSON.stringify({ok:!1,error:"imagePath (local png/jpg) or imageUrl is required"});return n&&(i.caption=n),await te(`/blocks/${t}/children`,{method:"PATCH",body:{children:[{object:"block",type:"image",image:i}]}}),JSON.stringify({ok:!0,pageId:t,url:Qt(t),...s?{fileUploadId:s}:{}})}case"notion_list_comments":{let t=e?.blockId||e?.pageId||e?.block||e?.page||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page/block id or URL is required"});let i=new URLSearchParams({block_id:n,page_size:"100"}),s=await te(`/comments?${i.toString()}`),a=(Array.isArray(s.results)?s.results:[]).map(dc);return JSON.stringify({ok:!0,id:n,count:a.length,comments:a})}case"notion_add_comment":{let t=typeof e?.text=="string"?e.text:typeof e?.body=="string"?e.body:"";if(!t||!t.trim())return JSON.stringify({ok:!1,error:"text is required"});let n=e?.discussionId||e?.discussion_id||null,i;if(n)i={discussion_id:String(n),rich_text:We(t)};else{let o=e?.pageId||e?.page||e?.url||e?.id,a=ae(o);if(!a)return JSON.stringify({ok:!1,error:"Either discussionId (to reply) or a valid pageId (to start a comment) is required"});i={parent:{page_id:a},rich_text:We(t)}}let s=await te("/comments",{method:"POST",body:i});return JSON.stringify({ok:!0,id:s?.id||"",discussionId:s?.discussion_id||n||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.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"]}},{name:"notion_create_page",description:"Create a new Notion page under a parent page (parentPageId) OR in a database (databaseId) \u2014 exactly one parent is required. Body from markdown (#/##/### headings, - bullets, 1. ordered lists; inline marks kept as literal text) or raw Notion block objects. Long bodies are chunked automatically (Notion caps 100 blocks/request). Returns { ok, pageId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{parentPageId:{type:"string",description:"Parent PAGE id/URL to create the page under (used when databaseId is absent)."},databaseId:{type:"string",description:"Parent DATABASE id/URL to create the page in (title goes into the title property)."},title:{type:"string",description:"Page title."},markdown:{type:"string",description:"Page body as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["title"]}},{name:"notion_append_blocks",description:"Append markdown (or raw Notion blocks) to the END of an existing Notion page. Accepts a page id or full Notion URL. Chunks automatically at Notion's 100-blocks-per-request cap. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["pageId"]}},{name:"notion_insert_image",description:"Append an image block to a Notion page. Pass imagePath for a LOCAL .png/.jpg file (max 20MB \u2014 uploaded via Notion's File Upload API, stored by Notion) or imageUrl for an external publicly-reachable image URL. Optional caption. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 20MB). Preferred for locally rendered charts."},imageUrl:{type:"string",description:"External image URL (must be publicly reachable; used when imagePath is absent)."},caption:{type:"string",description:"Optional image caption."}},required:["pageId"]}},{name:"notion_list_comments",description:"List the open comment discussions on a Notion page/block. Accepts a page/block id OR a full Notion URL. Returns { ok, comments:[{ id, discussionId, text, author }] }. Use to read the comment thread you are replying to.",input_schema:{type:"object",properties:{blockId:{type:"string",description:"Notion page or block id (dashed UUID or 32-char) OR a full Notion URL."}},required:["blockId"]}},{name:"notion_add_comment",description:"Post a comment on Notion. To REPLY within an existing discussion, pass { discussionId, text }. To start a NEW top-level comment on a page, pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment (reply in the same discussionId).",input_schema:{type:"object",properties:{discussionId:{type:"string",description:"The discussion_id to reply into (from notion_list_comments). Preferred for replies."},pageId:{type:"string",description:"Page id/URL to start a NEW top-level comment on (used when discussionId is absent)."},text:{type:"string",description:"The comment body (plain text)."}},required:["text"]}}]};import{existsSync as hc,readFileSync as yc}from"fs";import{fileURLToPath as gc}from"url";import{dirname as _c,resolve as bc}from"path";import{resolveIntegrationToken as Xt,clearTokenCache as kc}from"@zibby/core/backend-client.js";function wc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=_c(gc(import.meta.url)),e=bc(r,"..","bin","mcp-skill.mjs");return hc(e)?e:null}function Sc(){let r=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!r)return null;let e=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:r,memberId:e}}function Ic(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function vc(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var Nc="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function er(){let r=Sc();if(r)return r;if(Ic()||vc())throw new Error(Nc);return null}var Oc="202506",Tc="https://api.linkedin.com";function Sn(r){if(r==null)return null;let e=String(r).trim();if(!e)return null;let t=e.match(/urn:li:organization:(\d+)/i);return t?t[1]:/^\d+$/.test(e)?e:null}function In(r){if(!r)return"";if(r.localizedName)return String(r.localizedName);let e=r.name&&r.name.localized;if(e&&typeof e=="object"){let t=Object.values(e)[0];if(t)return String(t)}return""}function _t(r,e){return r?typeof r.get=="function"?r.get(e):r[e]||r[e.toLowerCase()]||null:null}async function ke(r,e={},t="linkedin_business"){let n=async()=>{let i;if(t==="linkedin_personal"){let d=er();d&&(i=d.token)}if(i||({token:i}=await Xt(t)),typeof i!="string"||!i)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let s=r.startsWith("https://")?r:`${Tc}${r}`,o=await fetch(s,{method:e.method||"GET",headers:{Authorization:`Bearer ${i}`,"LinkedIn-Version":Oc,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.body):void 0});if(!o.ok){let d=await o.text().catch(()=>"");throw new Error(`LinkedIn API ${o.status}: ${d.slice(0,300)}`)}let a=await o.text().catch(()=>""),c={};if(a&&a.trim())try{c=JSON.parse(a)}catch{c={raw:a}}return{status:o.status,headers:o.headers,body:c}};try{return await n()}catch(i){let s=String(i?.message||i||"").toLowerCase();if(!(s.includes("token")||s.includes("401")||s.includes("unauthorized")))throw i;return kc(t),n()}}async function Rc(r){let e;if(r==="linkedin_personal"){let t=er();t&&(e=t.token)}if(e||({token:e}=await Xt(r)),typeof e!="string"||!e)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");return e}function Ac(r){switch(String(r||"").toLowerCase().match(/\.([a-z0-9]+)$/)?.[1]){case"jpg":case"jpeg":return"image/jpeg";case"gif":return"image/gif";case"webp":return"image/webp";default:return"image/png"}}async function vn(r,e,t,n){if(typeof t!="string"||!t.trim())throw new Error("imagePath (a local image file path) is required to upload an image");let{body:i}=await ke("/rest/images?action=initializeUpload",{method:"POST",body:{initializeUploadRequest:{owner:e}}},r),s=i?.value?.uploadUrl,o=i?.value?.image;if(!s||!o)throw new Error(`LinkedIn image initializeUpload returned no uploadUrl/image (got: ${JSON.stringify(i).slice(0,200)})`);let a=yc(t),c=await Rc(r),d=await fetch(s,{method:"PUT",headers:{Authorization:`Bearer ${c}`,"Content-Type":n||Ac(t)},body:a});if(!d.ok){let l=await d.text().catch(()=>"");throw new Error(`LinkedIn image upload ${d.status}: ${l.slice(0,300)}`)}return o}var Nn={id:"linkedin",serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn (connected)
365
+ 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" / "cannot deliver to Notion" and continue.`,resolve(){let r=ic();return r?{type:"stdio",command:"node",args:[r,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(r,e){try{switch(r){case"notion_get_page":{let t=e?.pageId||e?.page||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await te(`/pages/${n}`),s=yn(i),o=i?.url||`https://www.notion.so/${n.replace(/-/g,"")}`,c=await kn(n,0,{used:0}),d=!1;return c.length>yt&&(c=c.slice(0,yt),d=!0),JSON.stringify({ok:!0,id:n,title:s,url:o,text:c,...d?{truncated:!0}:{}})}case"notion_query_database":{let t=e?.databaseId||e?.database||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let s={page_size:Math.max(1,Math.min(Number(e?.maxResults)||fn,fn))};e?.filter&&typeof e.filter=="object"&&(s.filter=e.filter);let o=await te(`/databases/${n}/query`,{method:"POST",body:s}),c=(Array.isArray(o.results)?o.results:[]).map(d=>{let l={};for(let[p,u]of Object.entries(d.properties||{})){let m=pc(u);m&&(l[p]=m)}return{id:d.id,title:yn(d),url:d.url||`https://www.notion.so/${String(d.id||"").replace(/-/g,"")}`,props:l}});return JSON.stringify({ok:!0,id:n,count:c.length,hasMore:!!o.has_more,rows:c})}case"notion_create_page":{let t=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!t)return JSON.stringify({ok:!1,error:"title is required"});let n=e?.databaseId?ae(e.databaseId):null,i=e?.parentPageId?ae(e.parentPageId):ae(e?.parent||e?.pageId);if(!n&&!i)return JSON.stringify({ok:!1,error:"A valid parentPageId or databaseId is required"});let s=n?{database_id:n}:{page_id:i},o={title:{title:We(t)}},a=gn(e)||[],c=a.slice(0,gt),d=await te("/pages",{method:"POST",body:{parent:s,properties:o,...c.length?{children:c}:{}}}),l=d?.id;if(!l)return JSON.stringify({ok:!1,error:"Notion page create returned no id"});let p=a.slice(gt);return p.length&&await _n(l,p),JSON.stringify({ok:!0,pageId:l,url:d?.url||Qt(l)})}case"notion_append_blocks":{let t=ae(e?.pageId||e?.blockId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=gn(e);return!n||!n.length?JSON.stringify({ok:!1,error:"markdown or blocks content is required"}):(await _n(t,n),JSON.stringify({ok:!0,pageId:t,url:Qt(t)}))}case"notion_insert_image":{let t=ae(e?.pageId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=typeof e?.caption=="string"&&e.caption.trim()?We(e.caption.trim()):null,i,s;if(typeof e?.imagePath=="string"&&e.imagePath.trim())s=await fc(e.imagePath),i={type:"file_upload",file_upload:{id:s}};else if(typeof e?.imageUrl=="string"&&e.imageUrl.trim())i={type:"external",external:{url:e.imageUrl.trim()}};else return JSON.stringify({ok:!1,error:"imagePath (local png/jpg) or imageUrl is required"});return n&&(i.caption=n),await te(`/blocks/${t}/children`,{method:"PATCH",body:{children:[{object:"block",type:"image",image:i}]}}),JSON.stringify({ok:!0,pageId:t,url:Qt(t),...s?{fileUploadId:s}:{}})}case"notion_list_comments":{let t=e?.blockId||e?.pageId||e?.block||e?.page||e?.url||e?.id,n=ae(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page/block id or URL is required"});let i=new URLSearchParams({block_id:n,page_size:"100"}),s=await te(`/comments?${i.toString()}`),a=(Array.isArray(s.results)?s.results:[]).map(dc);return JSON.stringify({ok:!0,id:n,count:a.length,comments:a})}case"notion_add_comment":{let t=typeof e?.text=="string"?e.text:typeof e?.body=="string"?e.body:"";if(!t||!t.trim())return JSON.stringify({ok:!1,error:"text is required"});let n=e?.discussionId||e?.discussion_id||null,i;if(n)i={discussion_id:String(n),rich_text:We(t)};else{let o=e?.pageId||e?.page||e?.url||e?.id,a=ae(o);if(!a)return JSON.stringify({ok:!1,error:"Either discussionId (to reply) or a valid pageId (to start a comment) is required"});i={parent:{page_id:a},rich_text:We(t)}}let s=await te("/comments",{method:"POST",body:i});return JSON.stringify({ok:!0,id:s?.id||"",discussionId:s?.discussion_id||n||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.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"]}},{name:"notion_create_page",description:"Create a new Notion page under a parent page (parentPageId) OR in a database (databaseId) \u2014 exactly one parent is required. Body from markdown (#/##/### headings, - bullets, 1. ordered lists; inline marks kept as literal text) or raw Notion block objects. Long bodies are chunked automatically (Notion caps 100 blocks/request). Returns { ok, pageId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{parentPageId:{type:"string",description:"Parent PAGE id/URL to create the page under (used when databaseId is absent)."},databaseId:{type:"string",description:"Parent DATABASE id/URL to create the page in (title goes into the title property)."},title:{type:"string",description:"Page title."},markdown:{type:"string",description:"Page body as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["title"]}},{name:"notion_append_blocks",description:"Append markdown (or raw Notion blocks) to the END of an existing Notion page. Accepts a page id or full Notion URL. Chunks automatically at Notion's 100-blocks-per-request cap. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["pageId"]}},{name:"notion_insert_image",description:"Append an image block to a Notion page. Pass imagePath for a LOCAL .png/.jpg file (max 20MB \u2014 uploaded via Notion's File Upload API, stored by Notion) or imageUrl for an external publicly-reachable image URL. Optional caption. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 20MB). Preferred for locally rendered charts."},imageUrl:{type:"string",description:"External image URL (must be publicly reachable; used when imagePath is absent)."},caption:{type:"string",description:"Optional image caption."}},required:["pageId"]}},{name:"notion_list_comments",description:"List the open comment discussions on a Notion page/block. Accepts a page/block id OR a full Notion URL. Returns { ok, comments:[{ id, discussionId, text, author }] }. Use to read the comment thread you are replying to.",input_schema:{type:"object",properties:{blockId:{type:"string",description:"Notion page or block id (dashed UUID or 32-char) OR a full Notion URL."}},required:["blockId"]}},{name:"notion_add_comment",description:"Post a comment on Notion. To REPLY within an existing discussion, pass { discussionId, text }. To start a NEW top-level comment on a page, pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment (reply in the same discussionId).",input_schema:{type:"object",properties:{discussionId:{type:"string",description:"The discussion_id to reply into (from notion_list_comments). Preferred for replies."},pageId:{type:"string",description:"Page id/URL to start a NEW top-level comment on (used when discussionId is absent)."},text:{type:"string",description:"The comment body (plain text)."}},required:["text"]}}]};import{existsSync as hc,readFileSync as yc}from"fs";import{fileURLToPath as gc}from"url";import{dirname as _c,resolve as bc}from"path";import{resolveIntegrationToken as Xt,clearTokenCache as kc}from"@zibby/core/backend-client.js";function wc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=_c(gc(import.meta.url)),e=bc(r,"..","bin","mcp-skill.mjs");return hc(e)?e:null}function Sc(){let r=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!r)return null;let e=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:r,memberId:e}}function Ic(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function vc(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var Nc="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function er(){let r=Sc();if(r)return r;if(Ic()||vc())throw new Error(Nc);return null}var Oc="202506",Tc="https://api.linkedin.com";function Sn(r){if(r==null)return null;let e=String(r).trim();if(!e)return null;let t=e.match(/urn:li:organization:(\d+)/i);return t?t[1]:/^\d+$/.test(e)?e:null}function In(r){if(!r)return"";if(r.localizedName)return String(r.localizedName);let e=r.name&&r.name.localized;if(e&&typeof e=="object"){let t=Object.values(e)[0];if(t)return String(t)}return""}function _t(r,e){return r?typeof r.get=="function"?r.get(e):r[e]||r[e.toLowerCase()]||null:null}async function ke(r,e={},t="linkedin_business"){let n=async()=>{let i;if(t==="linkedin_personal"){let d=er();d&&(i=d.token)}if(i||({token:i}=await Xt(t)),typeof i!="string"||!i)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let s=r.startsWith("https://")?r:`${Tc}${r}`,o=await fetch(s,{method:e.method||"GET",headers:{Authorization:`Bearer ${i}`,"LinkedIn-Version":Oc,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.body):void 0});if(!o.ok){let d=await o.text().catch(()=>"");throw new Error(`LinkedIn API ${o.status}: ${d.slice(0,300)}`)}let a=await o.text().catch(()=>""),c={};if(a&&a.trim())try{c=JSON.parse(a)}catch{c={raw:a}}return{status:o.status,headers:o.headers,body:c}};try{return await n()}catch(i){let s=String(i?.message||i||"").toLowerCase();if(!(s.includes("token")||s.includes("401")||s.includes("unauthorized")))throw i;return kc(t),n()}}async function Rc(r){let e;if(r==="linkedin_personal"){let t=er();t&&(e=t.token)}if(e||({token:e}=await Xt(r)),typeof e!="string"||!e)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");return e}function Ac(r){switch(String(r||"").toLowerCase().match(/\.([a-z0-9]+)$/)?.[1]){case"jpg":case"jpeg":return"image/jpeg";case"gif":return"image/gif";case"webp":return"image/webp";default:return"image/png"}}async function vn(r,e,t,n){if(typeof t!="string"||!t.trim())throw new Error("imagePath (a local image file path) is required to upload an image");let{body:i}=await ke("/rest/images?action=initializeUpload",{method:"POST",body:{initializeUploadRequest:{owner:e}}},r),s=i?.value?.uploadUrl,o=i?.value?.image;if(!s||!o)throw new Error(`LinkedIn image initializeUpload returned no uploadUrl/image (got: ${JSON.stringify(i).slice(0,200)})`);let a=yc(t),c=await Rc(r),d=await fetch(s,{method:"PUT",headers:{Authorization:`Bearer ${c}`,"Content-Type":n||Ac(t)},body:a});if(!d.ok){let l=await d.text().catch(()=>"");throw new Error(`LinkedIn image upload ${d.status}: ${l.slice(0,300)}`)}return o}var Nn={id:"linkedin",serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn
367
366
  You can post to LinkedIn two ways \u2014 an ORG company Page (business) and your own member PROFILE (personal). Each path needs its own LinkedIn integration connected.
368
367
 
369
368
  Business (company Page) \u2014 DRAFT only:
@@ -379,10 +378,10 @@ Attaching an image (optional, both tools):
379
378
  Notes:
380
379
  - Org-page posts are ALWAYS created as a DRAFT; personal-profile posts are ALWAYS published live \u2014 choose the tool accordingly.
381
380
  - PUBLISHING IS OUTWARD-FACING AND IRREVERSIBLE. linkedin_publish_post posts live to a real audience the instant you call it \u2014 there is no undo and no draft state for member profiles. Only call it after the human has EXPLICITLY approved publishing THIS specific text in THIS conversation. If you wrote or edited the text, show it and get an explicit "yes, publish" first; if you are unsure, HOLD/draft rather than publish. The org draft tool (linkedin_create_draft_post) is the safe default when a human still needs to review.
382
- - If the relevant LinkedIn integration is not connected these tools return { ok:false, error }; treat that as "LinkedIn unavailable" and continue.`,resolve(){let r=wc();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["ZIBBY_INJECTED_LINKEDIN_TOKEN","ZIBBY_INJECTED_LINKEDIN_MEMBER_ID","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/linkedin.js","linkedinSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"linkedin_list_organizations":{let{body:t}=await ke("/rest/organizationAcls?q=roleAssignee&role=ADMINISTRATOR&state=APPROVED",{},"linkedin_business"),n=Array.isArray(t.elements)?t.elements:[],i=[];for(let s of n){let o=s.organizationalTarget||s["organizationalTarget~"]||s.organization,a=Sn(o);if(!a)continue;let c="",d="";try{let l=(await ke(`/rest/organizations/${a}`,{},"linkedin_business")).body;c=In(l),d=l.vanityName||""}catch{}i.push({id:a,urn:`urn:li:organization:${a}`,name:c,vanityName:d})}return JSON.stringify({ok:!0,count:i.length,organizations:i})}case"linkedin_create_draft_post":{let t=e?.organizationUrn||e?.organizationId||e?.organization||e?.orgId,n=Sn(t);if(!n)return JSON.stringify({ok:!1,error:"A valid organizationId or organizationUrn (urn:li:organization:{id}) is required"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post commentary) is required"});let s=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:organization:${n}`,a=typeof e?.imagePath=="string"?e.imagePath.trim():"",c=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let u="";try{let m=(await ke(`/rest/organizations/${n}`,{},"linkedin_business")).body;u=In(m)}catch{}return JSON.stringify({dryRun:!0,target:"organization",wouldPostAs:{name:u,id:n,urn:o},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let d={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"DRAFT",isReshareDisabledByAuthor:!1};if(a){let u=await vn("linkedin_business",o,a);d.content={media:{id:u,altText:c||""}}}let l=await ke("/rest/posts",{method:"POST",body:d},"linkedin_business"),p=_t(l.headers,"x-restli-id")||_t(l.headers,"x-linkedin-id")||l.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"DRAFT",visibility:s,status:l.status})}case"linkedin_publish_post":{let t=er(),n=t?t.memberId:(await Xt("linkedin_personal")).memberId;if(!n)return JSON.stringify({ok:!1,error:"LinkedIn (personal) not connected or member id unavailable \u2014 reconnect LinkedIn Personal"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post body) is required"});let s=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:person:${n}`,a=typeof e?.imagePath=="string"?e.imagePath.trim():"",c=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let u=(await ke("/v2/userinfo",{},"linkedin_personal")).body,m=u?.name||[u?.given_name,u?.family_name].filter(Boolean).join(" ")||"",f=u?.sub?String(u.sub):n;return JSON.stringify({dryRun:!0,target:"member",wouldPostAs:{name:m,id:f,urn:`urn:li:person:${f}`},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let d={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"PUBLISHED",isReshareDisabledByAuthor:!1};if(a){let u=await vn("linkedin_personal",o,a);d.content={media:{id:u,altText:c||""}}}let l=await ke("/rest/posts",{method:"POST",body:d},"linkedin_personal"),p=_t(l.headers,"x-restli-id")||_t(l.headers,"x-linkedin-id")||l.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"PUBLISHED",visibility:s,status:l.status})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"linkedin_list_organizations",description:"List the LinkedIn Organizations (company Pages) the authenticated member ADMINISTERS. Returns [{ id, urn, name, vanityName }]. Call this first to choose the author org for a draft post.",input_schema:{type:"object",properties:{}}},{name:"linkedin_create_draft_post",description:"Create a DRAFT post on a LinkedIn Organization (company Page). The post is created in DRAFT state (never published automatically) so a human can review and publish it in LinkedIn. Returns the created post URN. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{organizationId:{type:"string",description:'The numeric organization id (e.g. "12345"). Alternative to organizationUrn.'},organizationUrn:{type:"string",description:'The organization URN, e.g. "urn:li:organization:12345". Alternative to organizationId.'},text:{type:"string",description:"The post commentary (the body text of the post)."},visibility:{type:"string",enum:["PUBLIC"],description:"Post visibility. Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}},{name:"linkedin_publish_post",description:"PUBLISH a post to the authenticated member's OWN LinkedIn profile feed (personal). UNLIKE linkedin_create_draft_post (which only drafts on a company Page), this PUBLISHES the post IMMEDIATELY \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns the created post URN. Requires the LinkedIn Personal integration connected. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{text:{type:"string",description:"The post body (the commentary text of the post)."},visibility:{type:"string",enum:["PUBLIC","CONNECTIONS"],description:"Post visibility: PUBLIC (anyone) or CONNECTIONS (your connections only). Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}}]};import{existsSync as An,statSync as Ec,readFileSync as xc}from"fs";import{fileURLToPath as Lc}from"url";import{basename as jc,dirname as $c,resolve as Pc}from"path";import{resolveIntegrationToken as Cc,clearTokenCache as Uc}from"@zibby/core/backend-client.js";function Jc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=$c(Lc(import.meta.url)),e=Pc(r,"..","bin","mcp-skill.mjs");return An(e)?e:null}var we="https://docs.googleapis.com/v1",On="https://www.googleapis.com/drive/v3",qc="https://www.googleapis.com/upload/drive/v3",Bc=5*1024*1024;function Dc(){let r=String(process.env.ZIBBY_INJECTED_GOOGLE_TOKEN||"").trim();if(!r)return null;let e=String(process.env.ZIBBY_INJECTED_GOOGLE_EMAIL||"").trim();return{token:r,email:e}}function Mc(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}function Fc(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}var Kc="You haven't connected your own Google account \u2014 connect it at https://studio.zibby.dev/integrations (Google Docs). For privacy, I can't use anyone else's Google (including the project owner's) on your behalf.",rr=2e4,Gc=25;function tr(r){if(!r||typeof r!="string")return null;let e=r.trim(),t=e.match(/\/document\/(?:u\/\d+\/)?d\/([a-zA-Z0-9_-]+)/);return t?t[1]:/^[a-zA-Z0-9_-]{20,}$/.test(e)?e:null}async function Hc(){let r,e=Dc();if(e)r=e.token;else{if(Fc()||Mc())throw new Error(Kc);({token:r}=await Cc("google"))}if(typeof r!="string"||!r)throw new Error(`Invalid google token type: ${typeof r}`);return r}async function re(r,e={}){let t=async()=>{let n=await Hc(),i=await fetch(r,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,Accept:"application/json",...e.rawBody&&e.contentType?{"Content-Type":e.contentType}:e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.rawBody?e.rawBody:e.body?JSON.stringify(e.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Google API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await t()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return Uc("google"),t()}}function zc(r){let e=[],t="",n=0;for(;n<r.length;){let i=/^\[([^\]]+)\]\(([^)\s]+)\)/.exec(r.slice(n));if(i){e.push({start:t.length,end:t.length+i[1].length,link:i[2]}),t+=i[1],n+=i[0].length;continue}let s=/^\*\*([^*]+)\*\*/.exec(r.slice(n));if(s){e.push({start:t.length,end:t.length+s[1].length,bold:!0}),t+=s[1],n+=s[0].length;continue}let o=/^`([^`]+)`/.exec(r.slice(n));if(o){e.push({start:t.length,end:t.length+o[1].length,code:!0}),t+=o[1],n+=o[0].length;continue}t+=r[n],n+=1}return{text:t,styles:e}}function Tn(r,e){let t=String(r??"").replace(/\r\n/g,`
381
+ - If the relevant LinkedIn integration is not connected these tools return { ok:false, error }; treat that as "LinkedIn unavailable" and continue.`,resolve(){let r=wc();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["ZIBBY_INJECTED_LINKEDIN_TOKEN","ZIBBY_INJECTED_LINKEDIN_MEMBER_ID","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/linkedin.js","linkedinSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"linkedin_list_organizations":{let{body:t}=await ke("/rest/organizationAcls?q=roleAssignee&role=ADMINISTRATOR&state=APPROVED",{},"linkedin_business"),n=Array.isArray(t.elements)?t.elements:[],i=[];for(let s of n){let o=s.organizationalTarget||s["organizationalTarget~"]||s.organization,a=Sn(o);if(!a)continue;let c="",d="";try{let l=(await ke(`/rest/organizations/${a}`,{},"linkedin_business")).body;c=In(l),d=l.vanityName||""}catch{}i.push({id:a,urn:`urn:li:organization:${a}`,name:c,vanityName:d})}return JSON.stringify({ok:!0,count:i.length,organizations:i})}case"linkedin_create_draft_post":{let t=e?.organizationUrn||e?.organizationId||e?.organization||e?.orgId,n=Sn(t);if(!n)return JSON.stringify({ok:!1,error:"A valid organizationId or organizationUrn (urn:li:organization:{id}) is required"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post commentary) is required"});let s=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:organization:${n}`,a=typeof e?.imagePath=="string"?e.imagePath.trim():"",c=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let u="";try{let m=(await ke(`/rest/organizations/${n}`,{},"linkedin_business")).body;u=In(m)}catch{}return JSON.stringify({dryRun:!0,target:"organization",wouldPostAs:{name:u,id:n,urn:o},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let d={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"DRAFT",isReshareDisabledByAuthor:!1};if(a){let u=await vn("linkedin_business",o,a);d.content={media:{id:u,altText:c||""}}}let l=await ke("/rest/posts",{method:"POST",body:d},"linkedin_business"),p=_t(l.headers,"x-restli-id")||_t(l.headers,"x-linkedin-id")||l.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"DRAFT",visibility:s,status:l.status})}case"linkedin_publish_post":{let t=er(),n=t?t.memberId:(await Xt("linkedin_personal")).memberId;if(!n)return JSON.stringify({ok:!1,error:"LinkedIn (personal) not connected or member id unavailable \u2014 reconnect LinkedIn Personal"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post body) is required"});let s=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:person:${n}`,a=typeof e?.imagePath=="string"?e.imagePath.trim():"",c=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let u=(await ke("/v2/userinfo",{},"linkedin_personal")).body,m=u?.name||[u?.given_name,u?.family_name].filter(Boolean).join(" ")||"",f=u?.sub?String(u.sub):n;return JSON.stringify({dryRun:!0,target:"member",wouldPostAs:{name:m,id:f,urn:`urn:li:person:${f}`},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let d={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"PUBLISHED",isReshareDisabledByAuthor:!1};if(a){let u=await vn("linkedin_personal",o,a);d.content={media:{id:u,altText:c||""}}}let l=await ke("/rest/posts",{method:"POST",body:d},"linkedin_personal"),p=_t(l.headers,"x-restli-id")||_t(l.headers,"x-linkedin-id")||l.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"PUBLISHED",visibility:s,status:l.status})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"linkedin_list_organizations",description:"List the LinkedIn Organizations (company Pages) the authenticated member ADMINISTERS. Returns [{ id, urn, name, vanityName }]. Call this first to choose the author org for a draft post.",input_schema:{type:"object",properties:{}}},{name:"linkedin_create_draft_post",description:"Create a DRAFT post on a LinkedIn Organization (company Page). The post is created in DRAFT state (never published automatically) so a human can review and publish it in LinkedIn. Returns the created post URN. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{organizationId:{type:"string",description:'The numeric organization id (e.g. "12345"). Alternative to organizationUrn.'},organizationUrn:{type:"string",description:'The organization URN, e.g. "urn:li:organization:12345". Alternative to organizationId.'},text:{type:"string",description:"The post commentary (the body text of the post)."},visibility:{type:"string",enum:["PUBLIC"],description:"Post visibility. Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}},{name:"linkedin_publish_post",description:"PUBLISH a post to the authenticated member's OWN LinkedIn profile feed (personal). UNLIKE linkedin_create_draft_post (which only drafts on a company Page), this PUBLISHES the post IMMEDIATELY \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns the created post URN. Requires the LinkedIn Personal integration connected. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{text:{type:"string",description:"The post body (the commentary text of the post)."},visibility:{type:"string",enum:["PUBLIC","CONNECTIONS"],description:"Post visibility: PUBLIC (anyone) or CONNECTIONS (your connections only). Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}}]};import{existsSync as An,statSync as Ec,readFileSync as xc}from"fs";import{fileURLToPath as Lc}from"url";import{basename as jc,dirname as $c,resolve as Pc}from"path";import{resolveIntegrationToken as Cc,clearTokenCache as Uc}from"@zibby/core/backend-client.js";function Jc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=$c(Lc(import.meta.url)),e=Pc(r,"..","bin","mcp-skill.mjs");return An(e)?e:null}var we="https://docs.googleapis.com/v1",On="https://www.googleapis.com/drive/v3",Bc="https://www.googleapis.com/upload/drive/v3",qc=5*1024*1024;function Dc(){let r=String(process.env.ZIBBY_INJECTED_GOOGLE_TOKEN||"").trim();if(!r)return null;let e=String(process.env.ZIBBY_INJECTED_GOOGLE_EMAIL||"").trim();return{token:r,email:e}}function Mc(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}function Fc(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}var Kc="You haven't connected your own Google account \u2014 connect it at https://studio.zibby.dev/integrations (Google Docs). For privacy, I can't use anyone else's Google (including the project owner's) on your behalf.",rr=2e4,Gc=25;function tr(r){if(!r||typeof r!="string")return null;let e=r.trim(),t=e.match(/\/document\/(?:u\/\d+\/)?d\/([a-zA-Z0-9_-]+)/);return t?t[1]:/^[a-zA-Z0-9_-]{20,}$/.test(e)?e:null}async function Hc(){let r,e=Dc();if(e)r=e.token;else{if(Fc()||Mc())throw new Error(Kc);({token:r}=await Cc("google"))}if(typeof r!="string"||!r)throw new Error(`Invalid google token type: ${typeof r}`);return r}async function re(r,e={}){let t=async()=>{let n=await Hc(),i=await fetch(r,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,Accept:"application/json",...e.rawBody&&e.contentType?{"Content-Type":e.contentType}:e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.rawBody?e.rawBody:e.body?JSON.stringify(e.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Google API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await t()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return Uc("google"),t()}}function zc(r){let e=[],t="",n=0;for(;n<r.length;){let i=/^\[([^\]]+)\]\(([^)\s]+)\)/.exec(r.slice(n));if(i){e.push({start:t.length,end:t.length+i[1].length,link:i[2]}),t+=i[1],n+=i[0].length;continue}let s=/^\*\*([^*]+)\*\*/.exec(r.slice(n));if(s){e.push({start:t.length,end:t.length+s[1].length,bold:!0}),t+=s[1],n+=s[0].length;continue}let o=/^`([^`]+)`/.exec(r.slice(n));if(o){e.push({start:t.length,end:t.length+o[1].length,code:!0}),t+=o[1],n+=o[0].length;continue}t+=r[n],n+=1}return{text:t,styles:e}}function Tn(r,e){let t=String(r??"").replace(/\r\n/g,`
383
382
  `);if(!t.trim())return{requests:[],endIndex:e};let n=t.split(`
384
383
  `),i="",s=[],o=[];for(let l of n){let p=l,u=null,m=null,f=/^(#{1,3})\s+(.*)$/.exec(p),h=/^\s*[-*]\s+(.*)$/.exec(p),b=/^\s*\d+[.)]\s+(.*)$/.exec(p);f?(u=`HEADING_${f[1].length}`,p=f[2]):h?(m="BULLET_DISC_CIRCLE_SQUARE",p=h[1]):b&&(m="NUMBERED_DECIMAL_ALPHA_ROMAN",p=b[1]);let{text:g,styles:_}=zc(p),y=e+i.length;for(let k of _)o.push({...k,start:y+k.start,end:y+k.end});i+=`${g}
385
- `,s.push({start:y,end:e+i.length,named:u,bullet:m})}if(!i)return{requests:[],endIndex:e};let a=[{insertText:{location:{index:e},text:i}}];for(let l of s)l.named&&a.push({updateParagraphStyle:{range:{startIndex:l.start,endIndex:l.end},paragraphStyle:{namedStyleType:l.named},fields:"namedStyleType"}});let c=null,d=()=>{c&&(a.push({createParagraphBullets:{range:{startIndex:c.start,endIndex:c.end},bulletPreset:c.preset}}),c=null)};for(let l of s)l.bullet?c&&c.preset===l.bullet?c.end=l.end:(d(),c={start:l.start,end:l.end,preset:l.bullet}):d();d();for(let l of o)l.end<=l.start||(l.bold?a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{bold:!0},fields:"bold"}}):l.link?a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{link:{url:l.link}},fields:"link"}}):l.code&&a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{weightedFontFamily:{fontFamily:"Courier New"}},fields:"weightedFontFamily"}}));return{requests:a,endIndex:e+i.length}}function Yc(r){let e="",t=n=>{for(let i of Array.isArray(n)?n:[]){if(e.length>=rr)return;if(i.paragraph)for(let s of i.paragraph.elements||[])e+=s?.textRun?.content||"";else if(i.table)for(let s of i.table.tableRows||[])for(let o of s.tableCells||[])t(o.content);else i.tableOfContents&&t(i.tableOfContents.content)}};return t(r?.content),e.slice(0,rr)}var Ze=r=>`https://docs.google.com/document/d/${r}/edit`;function Wc(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!An(e)||!Ec(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=xc(e);if(t.length>Bc)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 5MB (Drive multipart upload cap)`);return{bytes:t,fileName:jc(e),mimeType:/\.png$/i.test(e)?"image/png":"image/jpeg"}}function Zc(r,e,t){let n=`zibby-gdocs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`;return{rawBody:Buffer.concat([Buffer.from(`--${n}\r
384
+ `,s.push({start:y,end:e+i.length,named:u,bullet:m})}if(!i)return{requests:[],endIndex:e};let a=[{insertText:{location:{index:e},text:i}}];for(let l of s)l.named&&a.push({updateParagraphStyle:{range:{startIndex:l.start,endIndex:l.end},paragraphStyle:{namedStyleType:l.named},fields:"namedStyleType"}});let c=null,d=()=>{c&&(a.push({createParagraphBullets:{range:{startIndex:c.start,endIndex:c.end},bulletPreset:c.preset}}),c=null)};for(let l of s)l.bullet?c&&c.preset===l.bullet?c.end=l.end:(d(),c={start:l.start,end:l.end,preset:l.bullet}):d();d();for(let l of o)l.end<=l.start||(l.bold?a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{bold:!0},fields:"bold"}}):l.link?a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{link:{url:l.link}},fields:"link"}}):l.code&&a.push({updateTextStyle:{range:{startIndex:l.start,endIndex:l.end},textStyle:{weightedFontFamily:{fontFamily:"Courier New"}},fields:"weightedFontFamily"}}));return{requests:a,endIndex:e+i.length}}function Yc(r){let e="",t=n=>{for(let i of Array.isArray(n)?n:[]){if(e.length>=rr)return;if(i.paragraph)for(let s of i.paragraph.elements||[])e+=s?.textRun?.content||"";else if(i.table)for(let s of i.table.tableRows||[])for(let o of s.tableCells||[])t(o.content);else i.tableOfContents&&t(i.tableOfContents.content)}};return t(r?.content),e.slice(0,rr)}var Ze=r=>`https://docs.google.com/document/d/${r}/edit`;function Wc(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!An(e)||!Ec(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=xc(e);if(t.length>qc)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 5MB (Drive multipart upload cap)`);return{bytes:t,fileName:jc(e),mimeType:/\.png$/i.test(e)?"image/png":"image/jpeg"}}function Zc(r,e,t){let n=`zibby-gdocs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`;return{rawBody:Buffer.concat([Buffer.from(`--${n}\r
386
385
  Content-Type: application/json; charset=UTF-8\r
387
386
  \r
388
387
  ${JSON.stringify(r)}\r
@@ -391,7 +390,7 @@ Content-Type: ${t}\r
391
390
  \r
392
391
  `,"utf8"),e,Buffer.from(`\r
393
392
  --${n}--\r
394
- `,"utf8")]),contentType:`multipart/related; boundary=${n}`}}var Rn=r=>{let e=typeof r?.markdown=="string"?r.markdown:null,t=typeof r?.text=="string"?r.text:null;return e??t},En={id:"google-docs",serverName:"gdocs",allowedTools:["mcp__gdocs__*"],requiresIntegration:N.GOOGLE,description:"Google Docs \u2014 create, append to, insert images into, and read Google Docs (drive.file scoped)",promptFragment:`## Google Docs (connected)
393
+ `,"utf8")]),contentType:`multipart/related; boundary=${n}`}}var Rn=r=>{let e=typeof r?.markdown=="string"?r.markdown:null,t=typeof r?.text=="string"?r.text:null;return e??t},En={id:"google-docs",serverName:"gdocs",allowedTools:["mcp__gdocs__*"],requiresIntegration:N.GOOGLE,description:"Google Docs \u2014 create, append to, insert images into, and read Google Docs (drive.file scoped)",promptFragment:`## Google Docs
395
394
  You can create and edit Google Docs for the user. IMPORTANT visibility caveat: the integration uses Google's per-file drive.file scope, so you can only see docs this app CREATED (or the user explicitly picked) \u2014 not the user's whole Drive.
396
395
  Docs access is PER-USER: each teammate connects their OWN Google account (Integrations \u2192 Google Docs). In shared-chat contexts the runtime routes these tools to the SENDER's own Google; a teammate who hasn't connected their own Google gets { ok:false } with connect instructions \u2014 for privacy the project owner's Google is NEVER used on someone else's behalf. Relay those instructions rather than retrying.
397
396
  - gdocs_create_doc: create a new Google Doc from a title + markdown (headings/bold/bullets/links supported) or plain text; returns { documentId, url }. Share the url with the user.
@@ -400,9 +399,9 @@ Docs access is PER-USER: each teammate connects their OWN Google account (Integr
400
399
  - gdocs_get: read a doc back as plain text (works for app-created/user-picked docs only; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker \u2014 drive.file has no access to un-picked files).
401
400
  - gdocs_list_created: list the Google Docs visible to this app (drive.file \u2192 only docs it created or the user picked).
402
401
  These tools return { ok:false, error } on failure \u2014 treat an unavailable Google connection as "cannot deliver to Docs" and report it rather than blocking the task.`,resolve(){let r=Jc();if(!r)return null;let e={};for(let t of["ZIBBY_INJECTED_GOOGLE_TOKEN","ZIBBY_INJECTED_GOOGLE_EMAIL","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/googleDocs.js","googleDocsSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"gdocs_create_doc":{let t=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!t)return JSON.stringify({ok:!1,error:"title is required"});let i=(await re(`${we}/documents`,{method:"POST",body:{title:t}}))?.documentId;if(!i)return JSON.stringify({ok:!1,error:"Google Docs create returned no documentId"});let s=Rn(e);if(s&&s.trim()){let{requests:o}=Tn(s,1);o.length&&await re(`${we}/documents/${i}:batchUpdate`,{method:"POST",body:{requests:o}})}return JSON.stringify({ok:!0,documentId:i,title:t,url:Ze(i)})}case"gdocs_append":{let t=tr(e?.documentId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=Rn(e);if(!n||!n.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=(await re(`${we}/documents/${t}`))?.body,o=Array.isArray(s?.content)?s.content:[],a=o.length&&o[o.length-1].endIndex||2,c=Math.max(1,a-1),d=[],l=c;c>1&&(d.push({insertText:{location:{index:c},text:`
403
- `}}),l=c+1);let p=Tn(n,l);return d.push(...p.requests),await re(`${we}/documents/${t}:batchUpdate`,{method:"POST",body:{requests:d}}),JSON.stringify({ok:!0,documentId:t,url:Ze(t)})}case"gdocs_insert_image":{let t=tr(e?.documentId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});if(!e?.imagePath||typeof e.imagePath!="string"||!e.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let{bytes:n,fileName:i,mimeType:s}=Wc(e.imagePath),{rawBody:o,contentType:a}=Zc({name:i,mimeType:s},n,s),d=(await re(`${qc}/files?uploadType=multipart&fields=id`,{method:"POST",rawBody:o,contentType:a}))?.id;if(!d)return JSON.stringify({ok:!1,error:"Drive upload returned no file id"});await re(`${On}/files/${d}/permissions`,{method:"POST",body:{role:"reader",type:"anyone"}});let l=await re(`${we}/documents/${t}`),p=Array.isArray(l?.body?.content)?l.body.content:[],u=p.length&&p[p.length-1].endIndex||2,f={location:{index:Math.max(1,u-1)},uri:`https://drive.google.com/uc?export=download&id=${d}`},h=Number(e?.width),b=Number(e?.height);return(Number.isFinite(h)&&h>0||Number.isFinite(b)&&b>0)&&(f.objectSize={...Number.isFinite(h)&&h>0?{width:{magnitude:h,unit:"PT"}}:{},...Number.isFinite(b)&&b>0?{height:{magnitude:b,unit:"PT"}}:{}}),await re(`${we}/documents/${t}:batchUpdate`,{method:"POST",body:{requests:[{insertInlineImage:f}]}}),JSON.stringify({ok:!0,documentId:t,fileId:d,url:Ze(t)})}case"gdocs_get":{let t=tr(e?.documentId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=await re(`${we}/documents/${t}`),i=Yc(n?.body);return JSON.stringify({ok:!0,documentId:t,title:n?.title||"",url:Ze(t),text:i,...i.length>=rr?{truncated:!0}:{}})}case"gdocs_list_created":{let t=new URLSearchParams({q:"'me' in owners and mimeType='application/vnd.google-apps.document' and trashed=false",fields:"files(id,name,modifiedTime,webViewLink)",pageSize:String(Gc),orderBy:"modifiedTime desc"}),n=await re(`${On}/files?${t.toString()}`),i=(Array.isArray(n?.files)?n.files:[]).map(s=>({documentId:s.id,title:s.name,modifiedTime:s.modifiedTime,url:s.webViewLink||Ze(s.id)}));return JSON.stringify({ok:!0,count:i.length,files:i})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"gdocs_create_doc",description:"Create a new Google Doc with a title and optional content (markdown: #/##/### headings, - bullets, 1. numbered lists, **bold**, [links](url), `code`; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."}},required:["title"]}},{name:"gdocs_append",description:"Append markdown/text content to the END of an existing Google Doc. Only works on docs this app created or the user explicitly picked (drive.file scope). Accepts a documentId or a full docs.google.com URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"gdocs_insert_image",description:"Append a LOCAL image file (png/jpg, max 5MB) to the END of an existing Google Doc. The image is uploaded to the user's Drive, made link-readable (role reader / type anyone \u2014 required: the Docs API only renders publicly fetchable image URIs, <2KB URI length, image <50MB and <25 megapixels), then inserted inline. Optional width/height in points (PT). Returns { ok, documentId, fileId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 5MB)."},width:{type:"number",description:"Optional display width in points (PT)."},height:{type:"number",description:"Optional display height in points (PT)."}},required:["documentId","imagePath"]}},{name:"gdocs_get",description:"Read a Google Doc back as plain text (truncated to ~20k chars). The drive.file scope grants access ONLY to docs this app created or the user explicitly picked; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker (drive.file cannot see un-picked files). Returns { ok, documentId, title, url, text }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."}},required:["documentId"]}},{name:"gdocs_list_created",description:"List the Google Docs visible to this integration, newest first (max 25). NOTE: under the drive.file scope this lists ONLY docs the app created or the user explicitly picked \u2014 it is NOT a full Drive search. Returns { ok, count, files:[{ documentId, title, modifiedTime, url }] }.",input_schema:{type:"object",properties:{}}}]};import{existsSync as Cn,statSync as Vc,readFileSync as Qc}from"fs";import{fileURLToPath as Xc}from"url";import{basename as el,dirname as tl,resolve as rl}from"path";import{resolveIntegrationToken as nl}from"@zibby/core/backend-client.js";function il(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=tl(Xc(import.meta.url)),e=rl(r,"..","bin","mcp-skill.mjs");return Cn(e)?e:null}var xn=2e4,Ln=50,sl=10*1024*1024,ol=6e3*1e3,Ve=null;async function Un(){let{appId:r,appSecret:e,host:t}=await nl("lark");if(Ve&&Ve.appId===r&&Ve.expiresAt>Date.now())return{token:Ve.token,host:t};let i=await(await fetch(`${t}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:r,app_secret:e})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return Ve={token:i.tenant_access_token,expiresAt:Date.now()+ol,appId:r},{token:i.tenant_access_token,host:t}}async function ne(r,e,t){let{token:n,host:i}=await Un(),s={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&t!==void 0&&(s.body=JSON.stringify(t));let a=await(await fetch(`${i}${e}`,s)).json();if(a.code!==0)throw new Error(`Lark Docx API ${e} error: ${a.msg||a.code}`);return{data:a.data||{},host:i}}function bt(r,e){return String(r||"").includes("feishu")?`https://feishu.cn/docx/${e}`:`https://www.larksuite.com/docx/${e}`}function Se(r){if(!r||typeof r!="string")return null;let e=r.trim();if(!e)return null;let t=e.match(/\/(docx|wiki)\/([A-Za-z0-9]+)/);return t?{type:t[1],token:t[2]}:/^[A-Za-z0-9]{10,}$/.test(e)?{type:"docx",token:e}:null}async function Ue(r){let e=typeof r=="string"?Se(r):r;if(!e)throw new Error("A valid Lark doc id or URL is required");if(e.type==="docx")return e.token;let{data:t}=await ne("GET",`/open-apis/wiki/v2/spaces/get_node?token=${encodeURIComponent(e.token)}`),n=t?.node||{};if(n.obj_type!=="docx"||!n.obj_token)throw new Error(`Wiki node is not a docx document (obj_type=${n.obj_type||"unknown"})`);return n.obj_token}function jn(r){let e=String(r??"").replace(/\r\n/g,`
402
+ `}}),l=c+1);let p=Tn(n,l);return d.push(...p.requests),await re(`${we}/documents/${t}:batchUpdate`,{method:"POST",body:{requests:d}}),JSON.stringify({ok:!0,documentId:t,url:Ze(t)})}case"gdocs_insert_image":{let t=tr(e?.documentId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});if(!e?.imagePath||typeof e.imagePath!="string"||!e.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let{bytes:n,fileName:i,mimeType:s}=Wc(e.imagePath),{rawBody:o,contentType:a}=Zc({name:i,mimeType:s},n,s),d=(await re(`${Bc}/files?uploadType=multipart&fields=id`,{method:"POST",rawBody:o,contentType:a}))?.id;if(!d)return JSON.stringify({ok:!1,error:"Drive upload returned no file id"});await re(`${On}/files/${d}/permissions`,{method:"POST",body:{role:"reader",type:"anyone"}});let l=await re(`${we}/documents/${t}`),p=Array.isArray(l?.body?.content)?l.body.content:[],u=p.length&&p[p.length-1].endIndex||2,f={location:{index:Math.max(1,u-1)},uri:`https://drive.google.com/uc?export=download&id=${d}`},h=Number(e?.width),b=Number(e?.height);return(Number.isFinite(h)&&h>0||Number.isFinite(b)&&b>0)&&(f.objectSize={...Number.isFinite(h)&&h>0?{width:{magnitude:h,unit:"PT"}}:{},...Number.isFinite(b)&&b>0?{height:{magnitude:b,unit:"PT"}}:{}}),await re(`${we}/documents/${t}:batchUpdate`,{method:"POST",body:{requests:[{insertInlineImage:f}]}}),JSON.stringify({ok:!0,documentId:t,fileId:d,url:Ze(t)})}case"gdocs_get":{let t=tr(e?.documentId||e?.url||e?.id);if(!t)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=await re(`${we}/documents/${t}`),i=Yc(n?.body);return JSON.stringify({ok:!0,documentId:t,title:n?.title||"",url:Ze(t),text:i,...i.length>=rr?{truncated:!0}:{}})}case"gdocs_list_created":{let t=new URLSearchParams({q:"'me' in owners and mimeType='application/vnd.google-apps.document' and trashed=false",fields:"files(id,name,modifiedTime,webViewLink)",pageSize:String(Gc),orderBy:"modifiedTime desc"}),n=await re(`${On}/files?${t.toString()}`),i=(Array.isArray(n?.files)?n.files:[]).map(s=>({documentId:s.id,title:s.name,modifiedTime:s.modifiedTime,url:s.webViewLink||Ze(s.id)}));return JSON.stringify({ok:!0,count:i.length,files:i})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"gdocs_create_doc",description:"Create a new Google Doc with a title and optional content (markdown: #/##/### headings, - bullets, 1. numbered lists, **bold**, [links](url), `code`; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."}},required:["title"]}},{name:"gdocs_append",description:"Append markdown/text content to the END of an existing Google Doc. Only works on docs this app created or the user explicitly picked (drive.file scope). Accepts a documentId or a full docs.google.com URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"gdocs_insert_image",description:"Append a LOCAL image file (png/jpg, max 5MB) to the END of an existing Google Doc. The image is uploaded to the user's Drive, made link-readable (role reader / type anyone \u2014 required: the Docs API only renders publicly fetchable image URIs, <2KB URI length, image <50MB and <25 megapixels), then inserted inline. Optional width/height in points (PT). Returns { ok, documentId, fileId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 5MB)."},width:{type:"number",description:"Optional display width in points (PT)."},height:{type:"number",description:"Optional display height in points (PT)."}},required:["documentId","imagePath"]}},{name:"gdocs_get",description:"Read a Google Doc back as plain text (truncated to ~20k chars). The drive.file scope grants access ONLY to docs this app created or the user explicitly picked; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker (drive.file cannot see un-picked files). Returns { ok, documentId, title, url, text }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."}},required:["documentId"]}},{name:"gdocs_list_created",description:"List the Google Docs visible to this integration, newest first (max 25). NOTE: under the drive.file scope this lists ONLY docs the app created or the user explicitly picked \u2014 it is NOT a full Drive search. Returns { ok, count, files:[{ documentId, title, modifiedTime, url }] }.",input_schema:{type:"object",properties:{}}}]};import{existsSync as Cn,statSync as Vc,readFileSync as Qc}from"fs";import{fileURLToPath as Xc}from"url";import{basename as el,dirname as tl,resolve as rl}from"path";import{resolveIntegrationToken as nl}from"@zibby/core/backend-client.js";function il(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=tl(Xc(import.meta.url)),e=rl(r,"..","bin","mcp-skill.mjs");return Cn(e)?e:null}var xn=2e4,Ln=50,sl=10*1024*1024,ol=6e3*1e3,Ve=null;async function Un(){let{appId:r,appSecret:e,host:t}=await nl("lark");if(Ve&&Ve.appId===r&&Ve.expiresAt>Date.now())return{token:Ve.token,host:t};let i=await(await fetch(`${t}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:r,app_secret:e})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return Ve={token:i.tenant_access_token,expiresAt:Date.now()+ol,appId:r},{token:i.tenant_access_token,host:t}}async function ne(r,e,t){let{token:n,host:i}=await Un(),s={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&t!==void 0&&(s.body=JSON.stringify(t));let a=await(await fetch(`${i}${e}`,s)).json();if(a.code!==0)throw new Error(`Lark Docx API ${e} error: ${a.msg||a.code}`);return{data:a.data||{},host:i}}function bt(r,e){return String(r||"").includes("feishu")?`https://feishu.cn/docx/${e}`:`https://www.larksuite.com/docx/${e}`}function Se(r){if(!r||typeof r!="string")return null;let e=r.trim();if(!e)return null;let t=e.match(/\/(docx|wiki)\/([A-Za-z0-9]+)/);return t?{type:t[1],token:t[2]}:/^[A-Za-z0-9]{10,}$/.test(e)?{type:"docx",token:e}:null}async function Ue(r){let e=typeof r=="string"?Se(r):r;if(!e)throw new Error("A valid Lark doc id or URL is required");if(e.type==="docx")return e.token;let{data:t}=await ne("GET",`/open-apis/wiki/v2/spaces/get_node?token=${encodeURIComponent(e.token)}`),n=t?.node||{};if(n.obj_type!=="docx"||!n.obj_token)throw new Error(`Wiki node is not a docx document (obj_type=${n.obj_type||"unknown"})`);return n.obj_token}function jn(r){let e=String(r??"").replace(/\r\n/g,`
404
403
  `),t=[];for(let n of e.split(`
405
- `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,d,l;if(s){let p=s[1].length;c=`heading${p}`,d=2+p,l=s[2]}else o?(c="bullet",d=12,l=o[1]):a?(c="ordered",d=13,l=a[1]):(c="text",d=2,l=i);t.push({block_type:d,[c]:{elements:[{text_run:{content:l}}],style:{}}})}return t}function kt(r){let e=typeof r?.markdown=="string"?r.markdown:null,t=typeof r?.text=="string"?r.text:null;return e??t}async function $n(r,e){let t;for(let n=0;n<e.length;n+=Ln){let i=e.slice(n,n+Ln);t=(await ne("POST",`/open-apis/docx/v1/documents/${r}/blocks/${r}/children?document_revision_id=-1`,{children:i})).host}return t}function al(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!Cn(e)||!Vc(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=Qc(e);if(t.length>sl)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 10MB`);return t}async function cl({fileName:r,parentNode:e,bytes:t}){let{token:n,host:i}=await Un(),s=new FormData;s.set("file_name",r),s.set("parent_type","docx_image"),s.set("parent_node",e),s.set("size",String(t.length)),s.set("file",new Blob([t]),r);let a=await(await fetch(`${i}/open-apis/drive/v1/medias/upload_all`,{method:"POST",headers:{Authorization:`Bearer ${n}`},body:s})).json();if(a.code!==0)throw new Error(`Lark media upload_all error: ${a.msg||a.code}`);let c=a.data?.file_token;if(!c)throw new Error("Lark media upload_all returned no file_token");return c}var ll="docx",dl=50;function Pn(r){return[{type:"text_run",text_run:{text:String(r??"")}}]}function pl(r){return Array.isArray(r)?r.map(e=>e?.text_run?.text??e?.docs_link?.url??(e?.person?`@${e.person.user_id||""}`:"")).join(""):""}function ul(r){let e=Array.isArray(r?.reply_list?.replies)?r.reply_list.replies:[];return{commentId:r?.comment_id||"",resolved:!!r?.is_solved,replies:e.map(t=>({replyId:t?.reply_id||"",author:t?.user_id||"",text:pl(t?.content?.elements),createTime:t?.create_time||""}))}}function nr(r){return typeof r?.fileType=="string"&&r.fileType.trim()?r.fileType.trim():ll}var Jn={id:"lark-docs",serverName:"larkdocs",allowedTools:["mcp__larkdocs__*"],requiresIntegration:N.LARK,description:"Lark / Feishu Docs \u2014 read, create, append, and insert images into Lark documents (docx).",envKeys:[],promptFragment:`## Lark Docs (connected)
404
+ `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,d,l;if(s){let p=s[1].length;c=`heading${p}`,d=2+p,l=s[2]}else o?(c="bullet",d=12,l=o[1]):a?(c="ordered",d=13,l=a[1]):(c="text",d=2,l=i);t.push({block_type:d,[c]:{elements:[{text_run:{content:l}}],style:{}}})}return t}function kt(r){let e=typeof r?.markdown=="string"?r.markdown:null,t=typeof r?.text=="string"?r.text:null;return e??t}async function $n(r,e){let t;for(let n=0;n<e.length;n+=Ln){let i=e.slice(n,n+Ln);t=(await ne("POST",`/open-apis/docx/v1/documents/${r}/blocks/${r}/children?document_revision_id=-1`,{children:i})).host}return t}function al(r){let e=typeof r=="string"?r.trim():"";if(!e)throw new Error("imagePath is required");if(!Cn(e)||!Vc(e).isFile())throw new Error(`imagePath not found (or not a file): ${e}`);if(!/\.(png|jpe?g)$/i.test(e))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let t=Qc(e);if(t.length>sl)throw new Error(`image is ${(t.length/(1024*1024)).toFixed(1)}MB \u2014 max 10MB`);return t}async function cl({fileName:r,parentNode:e,bytes:t}){let{token:n,host:i}=await Un(),s=new FormData;s.set("file_name",r),s.set("parent_type","docx_image"),s.set("parent_node",e),s.set("size",String(t.length)),s.set("file",new Blob([t]),r);let a=await(await fetch(`${i}/open-apis/drive/v1/medias/upload_all`,{method:"POST",headers:{Authorization:`Bearer ${n}`},body:s})).json();if(a.code!==0)throw new Error(`Lark media upload_all error: ${a.msg||a.code}`);let c=a.data?.file_token;if(!c)throw new Error("Lark media upload_all returned no file_token");return c}var ll="docx",dl=50;function Pn(r){return[{type:"text_run",text_run:{text:String(r??"")}}]}function pl(r){return Array.isArray(r)?r.map(e=>e?.text_run?.text??e?.docs_link?.url??(e?.person?`@${e.person.user_id||""}`:"")).join(""):""}function ul(r){let e=Array.isArray(r?.reply_list?.replies)?r.reply_list.replies:[];return{commentId:r?.comment_id||"",resolved:!!r?.is_solved,replies:e.map(t=>({replyId:t?.reply_id||"",author:t?.user_id||"",text:pl(t?.content?.elements),createTime:t?.create_time||""}))}}function nr(r){return typeof r?.fileType=="string"&&r.fileType.trim()?r.fileType.trim():ll}var Jn={id:"lark-docs",serverName:"larkdocs",allowedTools:["mcp__larkdocs__*"],requiresIntegration:N.LARK,description:"Lark / Feishu Docs \u2014 read, create, append, and insert images into Lark documents (docx).",envKeys:[],promptFragment:`## Lark Docs
406
405
  You can read, create, and append Lark/Feishu documents (docx). This reuses the same connected Lark app as messaging.
407
406
  - larkdoc_get: pass a Lark doc id OR a full doc URL (a /docx/ or /wiki/ link); returns { ok, documentId, title, url, text } where text is the doc as plain text (truncated to ~20k chars). Use it as reference context.
408
407
  - larkdoc_create: create a new doc from a title + markdown/text (#/##/### headings, - bullets, 1. ordered supported); returns { ok, documentId, url }. Share the url.
@@ -411,14 +410,14 @@ You can read, create, and append Lark/Feishu documents (docx). This reuses the s
411
410
  - larkdoc_list_comments: list the comment threads on a doc (pass the documentId or doc URL); returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.
412
411
  - larkdoc_reply_comment: reply INSIDE an existing comment thread \u2014 pass { documentId, commentId, text }. Use this to answer a user who @mentioned Zibby in a doc comment (reply in the SAME commentId).
413
412
  - larkdoc_add_comment: post a NEW top-level comment on a doc \u2014 pass { documentId, text }.
414
- These tools return { ok:false, error } on failure \u2014 treat an unavailable Lark connection as "cannot read/deliver to Lark Docs" and continue rather than blocking the task.`,resolve(){let r=il();return r?{type:"stdio",command:"node",args:[r,"../dist/larkDocs.js","larkDocsSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(r,e){try{switch(r){case"larkdoc_get":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ue(n),s="";try{s=(await ne("GET",`/open-apis/docx/v1/documents/${i}`)).data?.document?.title||""}catch{}let{data:o,host:a}=await ne("GET",`/open-apis/docx/v1/documents/${i}/raw_content?lang=0`),c=String(o?.content||""),d=!1;return c.length>xn&&(c=c.slice(0,xn),d=!0),JSON.stringify({ok:!0,documentId:i,title:s,url:bt(a,i),text:c,...d?{truncated:!0}:{}})}case"larkdoc_create":{let t=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!t)return JSON.stringify({ok:!1,error:"title is required"});let{data:n,host:i}=await ne("POST","/open-apis/docx/v1/documents",{title:t,...e?.folderToken?{folder_token:String(e.folderToken)}:{}}),s=n?.document?.document_id;if(!s)return JSON.stringify({ok:!1,error:"Lark Docs create returned no document_id"});let o=kt(e);if(o&&o.trim()){let a=jn(o);a.length&&await $n(s,a)}return JSON.stringify({ok:!0,documentId:s,title:t,url:bt(i,s)})}case"larkdoc_append":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=kt(e);if(!i||!i.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=await Ue(n),o=jn(i);if(!o.length)return JSON.stringify({ok:!1,error:"no non-empty content to append"});let a=await $n(s,o);return JSON.stringify({ok:!0,documentId:s,url:bt(a,s)})}case"larkdoc_insert_image":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});if(!e?.imagePath||typeof e.imagePath!="string"||!e.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let i=await Ue(n),s=e.imagePath.trim(),o=al(s),a=el(s),d=(await ne("POST",`/open-apis/docx/v1/documents/${i}/blocks/${i}/children?document_revision_id=-1`,{children:[{block_type:27,image:{}}]})).data?.children?.[0]?.block_id;if(!d)return JSON.stringify({ok:!1,error:"Lark image block create returned no block_id"});let l=await cl({fileName:a,parentNode:d,bytes:o}),p={token:l},u=Number(e?.width),m=Number(e?.height);Number.isFinite(u)&&u>0&&(p.width=Math.round(u)),Number.isFinite(m)&&m>0&&(p.height=Math.round(m));let{host:f}=await ne("PATCH",`/open-apis/docx/v1/documents/${i}/blocks/${d}?document_revision_id=-1`,{replace_image:p});return JSON.stringify({ok:!0,documentId:i,blockId:d,fileToken:l,url:bt(f,i)})}case"larkdoc_list_comments":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ue(n),s=nr(e),o=new URLSearchParams({file_type:s,page_size:String(dl)}),{data:a}=await ne("GET",`/open-apis/drive/v1/files/${i}/comments?${o.toString()}`),d=(Array.isArray(a?.items)?a.items:[]).map(ul);return JSON.stringify({ok:!0,documentId:i,count:d.length,comments:d})}case"larkdoc_add_comment":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=kt({text:e?.text??e?.body});if(!i||!i.trim())return JSON.stringify({ok:!1,error:"text is required"});let s=await Ue(n),o=nr(e),{data:a}=await ne("POST",`/open-apis/drive/v1/files/${s}/comments?file_type=${encodeURIComponent(o)}`,{reply_list:{replies:[{content:{elements:Pn(i)}}]}});return JSON.stringify({ok:!0,documentId:s,commentId:a?.comment_id||""})}case"larkdoc_reply_comment":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=e?.commentId||e?.comment_id;if(!i)return JSON.stringify({ok:!1,error:"commentId is required"});let s=kt({text:e?.text??e?.body});if(!s||!s.trim())return JSON.stringify({ok:!1,error:"text is required"});let o=await Ue(n),a=nr(e),{data:c}=await ne("POST",`/open-apis/drive/v1/files/${o}/comments/${encodeURIComponent(i)}/replies?file_type=${encodeURIComponent(a)}`,{content:{elements:Pn(s)}});return JSON.stringify({ok:!0,documentId:o,commentId:String(i),replyId:c?.reply_id||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"larkdoc_get",description:"Read a Lark/Feishu document (docx) as plain text, for use as reference context. Accepts a raw doc id OR a full Lark doc URL (a /docx/ or /wiki/ link \u2014 wiki links are resolved to their backing docx). Returns { ok, documentId, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL (/docx/\u2026 or /wiki/\u2026)."}},required:["documentId"]}},{name:"larkdoc_create",description:"Create a new Lark/Feishu document (docx) with a title and optional content (markdown: #/##/### headings, - bullets, 1. ordered; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."},folderToken:{type:"string",description:"Optional Lark drive folder token to create the doc in. Absent = the app root."}},required:["title"]}},{name:"larkdoc_append",description:"Append markdown/text content to the END of an existing Lark/Feishu document (docx). Accepts a documentId or a full Lark doc URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"larkdoc_insert_image",description:"Append a LOCAL image file (png/jpg, max 10MB) to the END of an existing Lark/Feishu document (docx). Accepts a documentId or full doc URL plus a local file path. Optional width/height in pixels. Returns { ok, documentId, blockId, fileToken, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 10MB)."},width:{type:"number",description:"Optional display width in pixels."},height:{type:"number",description:"Optional display height in pixels."}},required:["documentId","imagePath"]}},{name:"larkdoc_list_comments",description:"List the comment threads on a Lark/Feishu document. Accepts a documentId or full doc URL. Returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'. Only change for non-docx files (doc/sheet/bitable/file/slides)."}},required:["documentId"]}},{name:"larkdoc_add_comment",description:"Post a NEW top-level comment on a Lark/Feishu document. Accepts a documentId or full doc URL plus text. Returns { ok, documentId, commentId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},text:{type:"string",description:"The comment body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","text"]}},{name:"larkdoc_reply_comment",description:"Reply INSIDE an existing comment thread on a Lark/Feishu document. Pass { documentId, commentId, text }. Use to answer a user who @mentioned Zibby in a doc comment (reply in the same commentId). Returns { ok, documentId, commentId, replyId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},commentId:{type:"string",description:"The comment_id of the thread to reply into (from larkdoc_list_comments or the webhook event)."},text:{type:"string",description:"The reply body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","commentId","text"]}}]};var qn={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:[...$.envKeys||[],...D.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return $.serverName;if(process.env.LARK_RECEIVE_ID)return D.serverName;if(process.env.SLACK_BOT_TOKEN)return $.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?$.allowedTools||[]:process.env.LARK_RECEIVE_ID?D.allowedTools||[]:process.env.SLACK_BOT_TOKEN?$.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
413
+ These tools return { ok:false, error } on failure \u2014 treat an unavailable Lark connection as "cannot read/deliver to Lark Docs" and continue rather than blocking the task.`,resolve(){let r=il();return r?{type:"stdio",command:"node",args:[r,"../dist/larkDocs.js","larkDocsSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(r,e){try{switch(r){case"larkdoc_get":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ue(n),s="";try{s=(await ne("GET",`/open-apis/docx/v1/documents/${i}`)).data?.document?.title||""}catch{}let{data:o,host:a}=await ne("GET",`/open-apis/docx/v1/documents/${i}/raw_content?lang=0`),c=String(o?.content||""),d=!1;return c.length>xn&&(c=c.slice(0,xn),d=!0),JSON.stringify({ok:!0,documentId:i,title:s,url:bt(a,i),text:c,...d?{truncated:!0}:{}})}case"larkdoc_create":{let t=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!t)return JSON.stringify({ok:!1,error:"title is required"});let{data:n,host:i}=await ne("POST","/open-apis/docx/v1/documents",{title:t,...e?.folderToken?{folder_token:String(e.folderToken)}:{}}),s=n?.document?.document_id;if(!s)return JSON.stringify({ok:!1,error:"Lark Docs create returned no document_id"});let o=kt(e);if(o&&o.trim()){let a=jn(o);a.length&&await $n(s,a)}return JSON.stringify({ok:!0,documentId:s,title:t,url:bt(i,s)})}case"larkdoc_append":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=kt(e);if(!i||!i.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=await Ue(n),o=jn(i);if(!o.length)return JSON.stringify({ok:!1,error:"no non-empty content to append"});let a=await $n(s,o);return JSON.stringify({ok:!0,documentId:s,url:bt(a,s)})}case"larkdoc_insert_image":{let t=e?.documentId||e?.url||e?.id,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});if(!e?.imagePath||typeof e.imagePath!="string"||!e.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let i=await Ue(n),s=e.imagePath.trim(),o=al(s),a=el(s),d=(await ne("POST",`/open-apis/docx/v1/documents/${i}/blocks/${i}/children?document_revision_id=-1`,{children:[{block_type:27,image:{}}]})).data?.children?.[0]?.block_id;if(!d)return JSON.stringify({ok:!1,error:"Lark image block create returned no block_id"});let l=await cl({fileName:a,parentNode:d,bytes:o}),p={token:l},u=Number(e?.width),m=Number(e?.height);Number.isFinite(u)&&u>0&&(p.width=Math.round(u)),Number.isFinite(m)&&m>0&&(p.height=Math.round(m));let{host:f}=await ne("PATCH",`/open-apis/docx/v1/documents/${i}/blocks/${d}?document_revision_id=-1`,{replace_image:p});return JSON.stringify({ok:!0,documentId:i,blockId:d,fileToken:l,url:bt(f,i)})}case"larkdoc_list_comments":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ue(n),s=nr(e),o=new URLSearchParams({file_type:s,page_size:String(dl)}),{data:a}=await ne("GET",`/open-apis/drive/v1/files/${i}/comments?${o.toString()}`),d=(Array.isArray(a?.items)?a.items:[]).map(ul);return JSON.stringify({ok:!0,documentId:i,count:d.length,comments:d})}case"larkdoc_add_comment":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=kt({text:e?.text??e?.body});if(!i||!i.trim())return JSON.stringify({ok:!1,error:"text is required"});let s=await Ue(n),o=nr(e),{data:a}=await ne("POST",`/open-apis/drive/v1/files/${s}/comments?file_type=${encodeURIComponent(o)}`,{reply_list:{replies:[{content:{elements:Pn(i)}}]}});return JSON.stringify({ok:!0,documentId:s,commentId:a?.comment_id||""})}case"larkdoc_reply_comment":{let t=e?.documentId||e?.url||e?.id||e?.fileToken,n=Se(t);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=e?.commentId||e?.comment_id;if(!i)return JSON.stringify({ok:!1,error:"commentId is required"});let s=kt({text:e?.text??e?.body});if(!s||!s.trim())return JSON.stringify({ok:!1,error:"text is required"});let o=await Ue(n),a=nr(e),{data:c}=await ne("POST",`/open-apis/drive/v1/files/${o}/comments/${encodeURIComponent(i)}/replies?file_type=${encodeURIComponent(a)}`,{content:{elements:Pn(s)}});return JSON.stringify({ok:!0,documentId:o,commentId:String(i),replyId:c?.reply_id||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({ok:!1,error:t.message})}},tools:[{name:"larkdoc_get",description:"Read a Lark/Feishu document (docx) as plain text, for use as reference context. Accepts a raw doc id OR a full Lark doc URL (a /docx/ or /wiki/ link \u2014 wiki links are resolved to their backing docx). Returns { ok, documentId, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL (/docx/\u2026 or /wiki/\u2026)."}},required:["documentId"]}},{name:"larkdoc_create",description:"Create a new Lark/Feishu document (docx) with a title and optional content (markdown: #/##/### headings, - bullets, 1. ordered; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."},folderToken:{type:"string",description:"Optional Lark drive folder token to create the doc in. Absent = the app root."}},required:["title"]}},{name:"larkdoc_append",description:"Append markdown/text content to the END of an existing Lark/Feishu document (docx). Accepts a documentId or a full Lark doc URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"larkdoc_insert_image",description:"Append a LOCAL image file (png/jpg, max 10MB) to the END of an existing Lark/Feishu document (docx). Accepts a documentId or full doc URL plus a local file path. Optional width/height in pixels. Returns { ok, documentId, blockId, fileToken, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 10MB)."},width:{type:"number",description:"Optional display width in pixels."},height:{type:"number",description:"Optional display height in pixels."}},required:["documentId","imagePath"]}},{name:"larkdoc_list_comments",description:"List the comment threads on a Lark/Feishu document. Accepts a documentId or full doc URL. Returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'. Only change for non-docx files (doc/sheet/bitable/file/slides)."}},required:["documentId"]}},{name:"larkdoc_add_comment",description:"Post a NEW top-level comment on a Lark/Feishu document. Accepts a documentId or full doc URL plus text. Returns { ok, documentId, commentId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},text:{type:"string",description:"The comment body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","text"]}},{name:"larkdoc_reply_comment",description:"Reply INSIDE an existing comment thread on a Lark/Feishu document. Pass { documentId, commentId, text }. Use to answer a user who @mentioned Zibby in a doc comment (reply in the same commentId). Returns { ok, documentId, commentId, replyId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},commentId:{type:"string",description:"The comment_id of the thread to reply into (from larkdoc_list_comments or the webhook event)."},text:{type:"string",description:"The reply body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","commentId","text"]}}]};var Bn={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:[...$.envKeys||[],...D.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return $.serverName;if(process.env.LARK_RECEIVE_ID)return D.serverName;if(process.env.SLACK_BOT_TOKEN)return $.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?$.allowedTools||[]:process.env.LARK_RECEIVE_ID?D.allowedTools||[]:process.env.SLACK_BOT_TOKEN?$.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
415
414
  You can post chat messages via:
416
415
  - slack_post_message (channel, text[, blocks]) \u2014 Slack. The \`channel\` is REQUIRED on every call.
417
416
  - lark_send_message (receive_id, text) \u2014 Lark.
418
417
  Where to post:
419
418
  - If SLACK_CHANNEL / LARK_RECEIVE_ID is set, that is the default destination \u2014 use it.
420
419
  - 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).
421
- - If neither an env var NOR an instruction gives you a channel, do NOT post \u2014 there is nowhere to send it.`,resolve(r){return process.env.SLACK_CHANNEL&&typeof $.resolve=="function"?$.resolve(r):process.env.LARK_RECEIVE_ID&&typeof D.resolve=="function"?D.resolve(r):process.env.SLACK_BOT_TOKEN&&typeof $.resolve=="function"?$.resolve(r):null},async handleToolCall(r,e,t){return typeof r=="string"&&r.startsWith("slack_")?$.handleToolCall(r,e,t):typeof r=="string"&&r.startsWith("lark_")?D.handleToolCall(r,e,t):JSON.stringify({error:`chat_notify: unknown tool "${r}". Expected slack_* or lark_*.`})},get tools(){return[...$.tools||[],...D.tools||[]]}};import{createRequire as ml}from"module";import{execFileSync as fl}from"child_process";import{join as Bn}from"path";import{existsSync as hl}from"fs";var yl=ml(import.meta.url);function gl(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return yl.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var Dn={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:r}=await import("@zibby/ui-memory");return r()}catch{return null}},promptFragment:`BEFORE executing browser actions:
420
+ - If neither an env var NOR an instruction gives you a channel, do NOT post \u2014 there is nowhere to send it.`,resolve(r){return process.env.SLACK_CHANNEL&&typeof $.resolve=="function"?$.resolve(r):process.env.LARK_RECEIVE_ID&&typeof D.resolve=="function"?D.resolve(r):process.env.SLACK_BOT_TOKEN&&typeof $.resolve=="function"?$.resolve(r):null},async handleToolCall(r,e,t){return typeof r=="string"&&r.startsWith("slack_")?$.handleToolCall(r,e,t):typeof r=="string"&&r.startsWith("lark_")?D.handleToolCall(r,e,t):JSON.stringify({error:`chat_notify: unknown tool "${r}". Expected slack_* or lark_*.`})},get tools(){return[...$.tools||[],...D.tools||[]]}};import{createRequire as ml}from"module";import{execFileSync as fl}from"child_process";import{join as qn}from"path";import{existsSync as hl}from"fs";var yl=ml(import.meta.url);function gl(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return yl.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var Dn={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:r}=await import("@zibby/ui-memory");return r()}catch{return null}},promptFragment:`BEFORE executing browser actions:
422
421
  - Review any test memory/history above. Prefer selectors proven to work.
423
422
  - If a previous run failed, avoid the same approach.
424
423
  - After setup/login completes, navigate directly to the target page instead of clicking through menus.
@@ -430,7 +429,7 @@ DURING execution \u2014 when a selector fails and you switch to a fallback:
430
429
  AFTER completing the test, you MUST call memory_save_insight at least once:
431
430
  - Save any useful finding: reliable selectors, timing quirks, navigation patterns, workarounds.
432
431
  - Category: selector_tip | timing | navigation | workaround | flaky | general
433
- - Be specific \u2014 future runs will read your insights.`,resolve(){let r=gl();if(!r)return console.warn("[memory] @zibby/ui-memory not found \u2014 memory tools disabled for this run"),null;let e=Bn(process.cwd(),".zibby","memory");if(!hl(Bn(e,".dolt")))return console.warn("[memory] DB/dolt unavailable \u2014 memory tools disabled for this run"),null;try{let t=fl("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:e,encoding:"utf-8",timeout:5e3}),n=JSON.parse(t.trim()).rows||[];if(!n[0]||n[0].cnt===0)return console.log("[memory] Database empty \u2014 memory tools activate after first completed run"),null}catch(t){return console.warn(`[memory] DB/dolt unavailable \u2014 memory tools disabled for this run (${t.message})`),null}return{command:"node",args:[r,"--db-path",e],description:this.description}},tools:[{name:"memory_get_test_history",description:"Query recent test runs with pass/fail results and timing",input_schema:{type:"object",properties:{specPath:{type:"string",description:"Filter by spec path (substring match)"},limit:{type:"number",description:"Max results (default 10)"}}}},{name:"memory_get_selectors",description:"Query known selectors for a page with stability metrics",input_schema:{type:"object",properties:{pageUrl:{type:"string",description:"Filter by page URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_get_page_model",description:"Query page structure \u2014 elements, roles, selectors",input_schema:{type:"object",properties:{url:{type:"string",description:"Filter by page URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_get_navigation",description:"Query known page-to-page transitions",input_schema:{type:"object",properties:{fromUrl:{type:"string",description:"Filter by source URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_save_insight",description:"Save a useful observation for future runs (selector tips, timing, workarounds)",input_schema:{type:"object",properties:{category:{type:"string",enum:["selector_tip","timing","navigation","workaround","flaky","general"],description:"Type of insight"},content:{type:"string",description:"The insight text \u2014 be specific and actionable"},specPath:{type:"string",description:"Related spec path"},sessionId:{type:"string",description:"Current session ID"}},required:["category","content"]}}]};import{existsSync as _l,readFileSync as bl}from"fs";import{homedir as kl}from"os";import{join as wl}from"path";import{spawn as Sl}from"child_process";var Ie={jira:{description:"Jira issue search, details, comments, transitions",integrationProvider:"jira",envKeys:[],setupInstructions:`To connect Jira:
432
+ - Be specific \u2014 future runs will read your insights.`,resolve(){let r=gl();if(!r)return console.warn("[memory] @zibby/ui-memory not found \u2014 memory tools disabled for this run"),null;let e=qn(process.cwd(),".zibby","memory");if(!hl(qn(e,".dolt")))return console.warn("[memory] DB/dolt unavailable \u2014 memory tools disabled for this run"),null;try{let t=fl("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:e,encoding:"utf-8",timeout:5e3}),n=JSON.parse(t.trim()).rows||[];if(!n[0]||n[0].cnt===0)return console.log("[memory] Database empty \u2014 memory tools activate after first completed run"),null}catch(t){return console.warn(`[memory] DB/dolt unavailable \u2014 memory tools disabled for this run (${t.message})`),null}return{command:"node",args:[r,"--db-path",e],description:this.description}},tools:[{name:"memory_get_test_history",description:"Query recent test runs with pass/fail results and timing",input_schema:{type:"object",properties:{specPath:{type:"string",description:"Filter by spec path (substring match)"},limit:{type:"number",description:"Max results (default 10)"}}}},{name:"memory_get_selectors",description:"Query known selectors for a page with stability metrics",input_schema:{type:"object",properties:{pageUrl:{type:"string",description:"Filter by page URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_get_page_model",description:"Query page structure \u2014 elements, roles, selectors",input_schema:{type:"object",properties:{url:{type:"string",description:"Filter by page URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_get_navigation",description:"Query known page-to-page transitions",input_schema:{type:"object",properties:{fromUrl:{type:"string",description:"Filter by source URL (substring match)"},limit:{type:"number",description:"Max results (default 20)"}}}},{name:"memory_save_insight",description:"Save a useful observation for future runs (selector tips, timing, workarounds)",input_schema:{type:"object",properties:{category:{type:"string",enum:["selector_tip","timing","navigation","workaround","flaky","general"],description:"Type of insight"},content:{type:"string",description:"The insight text \u2014 be specific and actionable"},specPath:{type:"string",description:"Related spec path"},sessionId:{type:"string",description:"Current session ID"}},required:["category","content"]}}]};import{existsSync as _l,readFileSync as bl}from"fs";import{homedir as kl}from"os";import{join as wl}from"path";import{spawn as Sl}from"child_process";var Ie={jira:{description:"Jira issue search, details, comments, transitions",integrationProvider:"jira",envKeys:[],setupInstructions:`To connect Jira:
434
433
  1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
435
434
  2. Click "Connect Jira" and authorize via Atlassian OAuth
436
435
  3. After OAuth completes, ask me to install Jira again`},github:{description:"GitHub issues, PRs, repository management",integrationProvider:"github",envKeys:[],setupInstructions:`To connect GitHub:
@@ -443,8 +442,8 @@ AFTER completing the test, you MUST call memory_save_insight at least once:
443
442
  1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
444
443
  2. Click "Connect Sentry" and authorize
445
444
  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 Il(){let r=["## Available Skills"];for(let[e,t]of Object.entries(Ie)){let n=t.integrationProvider?`integration: ${t.integrationProvider}`:"ready";r.push(`- ${e}: ${t.description} [${n}]`)}return r.push(""),r.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),r.push(`Zibby third party Integration settings page: ${ir()}`),r.push(""),r.push("## Tool-First Policy (mandatory)"),r.push("CRITICAL RULES \u2014 follow these strictly:"),r.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."),r.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.`),r.push("3. If install_skill reports needsIntegration, tell the user to connect via the integration URL and try again after."),r.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."),r.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."),r.join(`
446
- `)}function vl(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=wl(kl(),".zibby","config.json");return _l(r)&&JSON.parse(bl(r,"utf-8")).sessionToken||null}catch{return null}}function Nl(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function ir(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function Ol(r){try{let e=process.platform;return Sl(e==="darwin"?"open":e==="win32"?"cmd":"xdg-open",e==="win32"?["/c","start","",r]:[r],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function Tl(){let r=vl();if(!r)return{checked:!1,statuses:null,reason:"no-session-token"};try{let e=await fetch(`${Nl()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${r}`}});return e.ok?{checked:!0,statuses:await e.json()||{},reason:null}:{checked:!1,statuses:null,reason:`status-${e.status}`}}catch{return{checked:!1,statuses:null,reason:"network-error"}}}function Mn(r,e){if(!e||!r)return{connected:null};let t=r[e];return!t||typeof t.connected!="boolean"?{connected:null,details:t||null}:{connected:t.connected,details:t}}var Fn={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:Ie,promptFragment:Il,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(r,e,t){let{activeSkills:n}=t,i=await Tl();if(r==="list_available_skills"){let s=Object.entries(Ie).map(([o,a])=>{let c=n.includes(o),d=Mn(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:s})}if(r==="install_skill"){let{skillId:s}=e;if(!s)return JSON.stringify({ok:!1,error:"skillId is required"});if(n.includes(s)){let l=Ie[s],{getSkill:p}=await import("@zibby/agent-workflow"),m=(p(s)?.tools||[]).map(f=>f.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:s,description:l?.description,availableTools:m,integrationUrl:l?.integrationProvider?ir():void 0,hint:`${s} is already active. Tools available: ${m.join(", ")}. Use them directly.`})}if(!Ie[s])return JSON.stringify({ok:!1,error:`Unknown skill "${s}". Available: ${Object.keys(Ie).join(", ")}`});let o=Ie[s];if(o.integrationProvider){let l=Mn(i.statuses,o.integrationProvider),p=ir();if(i.checked&&l.connected===!1){let u=Ol(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 ${s} again.`})}}n.push(s);let{getSkill:a}=await import("@zibby/agent-workflow"),d=(a(s)?.tools||[]).map(l=>l.name);return JSON.stringify({ok:!0,installed:s,description:o.description,availableTools:d,hint:`${s} is now active. You now have these tools: ${d.join(", ")}. Use them immediately to help the user \u2014 don't just confirm installation.`})}if(r==="uninstall_skill"){let{skillId:s}=e;if(!s)return JSON.stringify({ok:!1,error:"skillId is required"});if(s==="skill-installer")return JSON.stringify({ok:!1,error:"Cannot uninstall the skill installer"});let o=n.indexOf(s);return o===-1?JSON.stringify({ok:!1,error:`${s} is not installed`}):(n.splice(o,1),JSON.stringify({ok:!0,uninstalled:s}))}return JSON.stringify({error:`Unknown tool: ${r}`})},resolve(){return null}};import{readFileSync as Rl,readdirSync as Al,statSync as Gn,writeFileSync as El,mkdirSync as xl}from"fs";import{join as Hn,resolve as Ll,relative as jl}from"path";import{execSync as zn}from"child_process";var Kn=256*1024,$l=64*1024,Yn={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(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"read_file":return Pl(e,n);case"write_file":return Cl(e,n);case"list_directory":return Ul(e,n);case"run_command":return Jl(e,n);case"open_url":return ql(e);case"wait":return await Bl(e,t?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function wt(r,e){return Ll(e,r)}function Pl(r,e){let t=wt(r.path,e),n=Gn(t);return n.size>Kn?JSON.stringify({error:`File too large (${(n.size/1024).toFixed(0)}KB). Max: ${Kn/1024}KB`}):Rl(t,"utf-8")}function Cl(r,e){let t=wt(r.path,e),n=Hn(t,"..");return xl(n,{recursive:!0}),El(t,r.content,"utf-8"),JSON.stringify({ok:!0,path:jl(e,t)})}function Ul(r,e){let t=wt(r.path||".",e);return Al(t).map(i=>{try{return Gn(Hn(t,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
447
- `)}function Jl(r,e){let t=r.cwd?wt(r.cwd,e):e;return zn(r.command,{cwd:t,encoding:"utf-8",timeout:3e4,maxBuffer:$l,stdio:["pipe","pipe","pipe"]})||"(no output)"}function ql(r){let{url:e}=r;if(!e||!e.startsWith("http://")&&!e.startsWith("https://"))return JSON.stringify({error:"Invalid URL \u2014 must start with http:// or https://"});let t=process.platform,n=t==="darwin"?"open":t==="win32"?"start":"xdg-open";try{return zn(`${n} "${e}"`,{stdio:"ignore",timeout:5e3}),JSON.stringify({ok:!0,opened:e})}catch{return JSON.stringify({ok:!1,error:`Could not open browser. Please visit: ${e}`})}}async function Bl(r,e){let t=Math.min(Math.max(r.seconds||5,1),300),n=r.reason||"async operation",i=500,s=Date.now()+t*1e3;for(;Date.now()<s;){if(e?.aborted)return JSON.stringify({ok:!0,waited:Math.round((t*1e3-(s-Date.now()))/1e3),reason:n,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,s-Date.now())))}return JSON.stringify({ok:!0,waited:t,reason:n})}import{existsSync as Dl}from"fs";import{fileURLToPath as Ml}from"url";import{dirname as Fl,resolve as Kl}from"path";import{resolveIntegrationToken as Qe}from"@zibby/core/backend-client.js";function Gl(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let r=Fl(Ml(import.meta.url)),e=Kl(r,"..","bin","mcp-sentry.mjs");return Dl(e)?e:null}function Xe(r){return(r||process.env.SENTRY_URL||"https://sentry.io").trim().replace(/\/+$/,"")}function Wn(r){let e=r||process.env.SENTRY_ORG;if(!e)throw new Error('Sentry organization not resolved \u2014 reconnect Sentry, or set SENTRY_ORG (self-hosted; the default org slug is "sentry").');return e}async function Zn(r,e={}){let{token:t,organizationSlug:n,baseUrl:i}=await Qe("sentry"),s=`${Xe(i)}/api/0/organizations/${Wn(n)}${r}`,o={method:e.method||"GET",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"}};e.body!=null&&(o.body=typeof e.body=="string"?e.body:JSON.stringify(e.body));let a=await fetch(s,o);if(!a.ok){let c=await a.text().catch(()=>"");throw new Error(`Sentry API ${a.status}: ${c.slice(0,300)}`)}return a.json()}async function Hl(){return Zn("/projects/?per_page=50")}async function zl({query:r="is:unresolved",sort:e="date",project:t,limit:n=25}={}){let i=`/issues/?query=${encodeURIComponent(r)}&sort=${e}&per_page=${n}`;return t&&(i+=`&project=${encodeURIComponent(t)}`),Zn(i)}async function sr(r){let e=String(r??"").trim();if(!e)throw new Error("resolveSentryIssueId: issueRef is required");if(/^\d+$/.test(e))return e;let{token:t,organizationSlug:n,baseUrl:i}=await Qe("sentry"),s=await fetch(`${Xe(i)}/api/0/organizations/${Wn(n)}/shortids/${encodeURIComponent(e)}/`,{headers:{Authorization:`Bearer ${t}`}});if(!s.ok){let c=await s.text().catch(()=>"");throw new Error(`Sentry API ${s.status} resolving shortId "${e}": ${c.slice(0,200)}`)}let o=await s.json(),a=o.groupId||o.group&&o.group.id;if(!a)throw new Error(`Sentry shortId "${e}" did not resolve to a numeric issue id`);return String(a)}async function Yl(r){if(!r)throw new Error("sentryGetIssue: issueId is required");let e=await sr(r),{token:t,baseUrl:n}=await Qe("sentry"),i=await fetch(`${Xe(n)}/api/0/issues/${e}/`,{headers:{Authorization:`Bearer ${t}`}});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`Sentry API ${i.status}: ${s.slice(0,300)}`)}return i.json()}async function Wl(r,e={}){if(!r)throw new Error("sentryUpdateIssue: issueId is required");let t={};for(let a of["status","statusDetails","assignedTo","isBookmarked","hasSeen"])e[a]!==void 0&&(t[a]=e[a]);if(Object.keys(t).length===0)throw new Error("sentryUpdateIssue: nothing to update (pass status / statusDetails / assignedTo / isBookmarked / hasSeen)");let n=await sr(r),{token:i,baseUrl:s}=await Qe("sentry"),o=await fetch(`${Xe(s)}/api/0/issues/${n}/`,{method:"PUT",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},body:JSON.stringify(t)});if(!o.ok){let a=await o.text().catch(()=>"");throw o.status===403?new Error(`Sentry API 403 updating issue ${r}: ${a.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 ${o.status} updating issue ${r}: ${a.slice(0,300)}`)}return o.json()}async function Zl(r,e){if(!r)throw new Error("sentryAddComment: issueId is required");if(!e||!String(e).trim())throw new Error("sentryAddComment: text is required");let t=await sr(r),{token:n,baseUrl:i}=await Qe("sentry"),s=await fetch(`${Xe(i)}/api/0/issues/${t}/comments/`,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify({text:String(e)})});if(!s.ok){let o=await s.text().catch(()=>"");throw s.status===403?new Error(`Sentry API 403 commenting on issue ${r}: ${o.slice(0,200)}. The connected Sentry integration likely lacks the \`event:write\` scope \u2014 reconnect Sentry with write access.`):new Error(`Sentry API ${s.status} commenting on issue ${r}: ${o.slice(0,300)}`)}return s.json()}var St={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:N.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry (connected)
445
+ `)}function vl(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=wl(kl(),".zibby","config.json");return _l(r)&&JSON.parse(bl(r,"utf-8")).sessionToken||null}catch{return null}}function Nl(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function ir(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function Ol(r){try{let e=process.platform;return Sl(e==="darwin"?"open":e==="win32"?"cmd":"xdg-open",e==="win32"?["/c","start","",r]:[r],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function Tl(){let r=vl();if(!r)return{checked:!1,statuses:null,reason:"no-session-token"};try{let e=await fetch(`${Nl()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${r}`}});return e.ok?{checked:!0,statuses:await e.json()||{},reason:null}:{checked:!1,statuses:null,reason:`status-${e.status}`}}catch{return{checked:!1,statuses:null,reason:"network-error"}}}function Mn(r,e){if(!e||!r)return{connected:null};let t=r[e];return!t||typeof t.connected!="boolean"?{connected:null,details:t||null}:{connected:t.connected,details:t}}var Fn={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:Ie,promptFragment:Il,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(r,e,t){let{activeSkills:n}=t,i=await Tl();if(r==="list_available_skills"){let s=Object.entries(Ie).map(([o,a])=>{let c=n.includes(o),d=Mn(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:s})}if(r==="install_skill"){let{skillId:s}=e;if(!s)return JSON.stringify({ok:!1,error:"skillId is required"});if(n.includes(s)){let l=Ie[s],{getSkill:p}=await import("@zibby/agent-workflow"),m=(p(s)?.tools||[]).map(f=>f.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:s,description:l?.description,availableTools:m,integrationUrl:l?.integrationProvider?ir():void 0,hint:`${s} is already active. Tools available: ${m.join(", ")}. Use them directly.`})}if(!Ie[s])return JSON.stringify({ok:!1,error:`Unknown skill "${s}". Available: ${Object.keys(Ie).join(", ")}`});let o=Ie[s];if(o.integrationProvider){let l=Mn(i.statuses,o.integrationProvider),p=ir();if(i.checked&&l.connected===!1){let u=Ol(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 ${s} again.`})}}n.push(s);let{getSkill:a}=await import("@zibby/agent-workflow"),d=(a(s)?.tools||[]).map(l=>l.name);return JSON.stringify({ok:!0,installed:s,description:o.description,availableTools:d,hint:`${s} is now active. You now have these tools: ${d.join(", ")}. Use them immediately to help the user \u2014 don't just confirm installation.`})}if(r==="uninstall_skill"){let{skillId:s}=e;if(!s)return JSON.stringify({ok:!1,error:"skillId is required"});if(s==="skill-installer")return JSON.stringify({ok:!1,error:"Cannot uninstall the skill installer"});let o=n.indexOf(s);return o===-1?JSON.stringify({ok:!1,error:`${s} is not installed`}):(n.splice(o,1),JSON.stringify({ok:!0,uninstalled:s}))}return JSON.stringify({error:`Unknown tool: ${r}`})},resolve(){return null}};import{readFileSync as Rl,readdirSync as Al,statSync as Gn,writeFileSync as El,mkdirSync as xl}from"fs";import{join as Hn,resolve as Ll,relative as jl}from"path";import{execSync as zn}from"child_process";var Kn=256*1024,$l=64*1024,Yn={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(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"read_file":return Pl(e,n);case"write_file":return Cl(e,n);case"list_directory":return Ul(e,n);case"run_command":return Jl(e,n);case"open_url":return Bl(e);case"wait":return await ql(e,t?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function wt(r,e){return Ll(e,r)}function Pl(r,e){let t=wt(r.path,e),n=Gn(t);return n.size>Kn?JSON.stringify({error:`File too large (${(n.size/1024).toFixed(0)}KB). Max: ${Kn/1024}KB`}):Rl(t,"utf-8")}function Cl(r,e){let t=wt(r.path,e),n=Hn(t,"..");return xl(n,{recursive:!0}),El(t,r.content,"utf-8"),JSON.stringify({ok:!0,path:jl(e,t)})}function Ul(r,e){let t=wt(r.path||".",e);return Al(t).map(i=>{try{return Gn(Hn(t,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
446
+ `)}function Jl(r,e){let t=r.cwd?wt(r.cwd,e):e;return zn(r.command,{cwd:t,encoding:"utf-8",timeout:3e4,maxBuffer:$l,stdio:["pipe","pipe","pipe"]})||"(no output)"}function Bl(r){let{url:e}=r;if(!e||!e.startsWith("http://")&&!e.startsWith("https://"))return JSON.stringify({error:"Invalid URL \u2014 must start with http:// or https://"});let t=process.platform,n=t==="darwin"?"open":t==="win32"?"start":"xdg-open";try{return zn(`${n} "${e}"`,{stdio:"ignore",timeout:5e3}),JSON.stringify({ok:!0,opened:e})}catch{return JSON.stringify({ok:!1,error:`Could not open browser. Please visit: ${e}`})}}async function ql(r,e){let t=Math.min(Math.max(r.seconds||5,1),300),n=r.reason||"async operation",i=500,s=Date.now()+t*1e3;for(;Date.now()<s;){if(e?.aborted)return JSON.stringify({ok:!0,waited:Math.round((t*1e3-(s-Date.now()))/1e3),reason:n,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,s-Date.now())))}return JSON.stringify({ok:!0,waited:t,reason:n})}import{existsSync as Dl}from"fs";import{fileURLToPath as Ml}from"url";import{dirname as Fl,resolve as Kl}from"path";import{resolveIntegrationToken as Qe}from"@zibby/core/backend-client.js";function Gl(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let r=Fl(Ml(import.meta.url)),e=Kl(r,"..","bin","mcp-sentry.mjs");return Dl(e)?e:null}function Xe(r){return(r||process.env.SENTRY_URL||"https://sentry.io").trim().replace(/\/+$/,"")}function Wn(r){let e=r||process.env.SENTRY_ORG;if(!e)throw new Error('Sentry organization not resolved \u2014 reconnect Sentry, or set SENTRY_ORG (self-hosted; the default org slug is "sentry").');return e}async function Zn(r,e={}){let{token:t,organizationSlug:n,baseUrl:i}=await Qe("sentry"),s=`${Xe(i)}/api/0/organizations/${Wn(n)}${r}`,o={method:e.method||"GET",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"}};e.body!=null&&(o.body=typeof e.body=="string"?e.body:JSON.stringify(e.body));let a=await fetch(s,o);if(!a.ok){let c=await a.text().catch(()=>"");throw new Error(`Sentry API ${a.status}: ${c.slice(0,300)}`)}return a.json()}async function Hl(){return Zn("/projects/?per_page=50")}async function zl({query:r="is:unresolved",sort:e="date",project:t,limit:n=25}={}){let i=`/issues/?query=${encodeURIComponent(r)}&sort=${e}&per_page=${n}`;return t&&(i+=`&project=${encodeURIComponent(t)}`),Zn(i)}async function sr(r){let e=String(r??"").trim();if(!e)throw new Error("resolveSentryIssueId: issueRef is required");if(/^\d+$/.test(e))return e;let{token:t,organizationSlug:n,baseUrl:i}=await Qe("sentry"),s=await fetch(`${Xe(i)}/api/0/organizations/${Wn(n)}/shortids/${encodeURIComponent(e)}/`,{headers:{Authorization:`Bearer ${t}`}});if(!s.ok){let c=await s.text().catch(()=>"");throw new Error(`Sentry API ${s.status} resolving shortId "${e}": ${c.slice(0,200)}`)}let o=await s.json(),a=o.groupId||o.group&&o.group.id;if(!a)throw new Error(`Sentry shortId "${e}" did not resolve to a numeric issue id`);return String(a)}async function Yl(r){if(!r)throw new Error("sentryGetIssue: issueId is required");let e=await sr(r),{token:t,baseUrl:n}=await Qe("sentry"),i=await fetch(`${Xe(n)}/api/0/issues/${e}/`,{headers:{Authorization:`Bearer ${t}`}});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`Sentry API ${i.status}: ${s.slice(0,300)}`)}return i.json()}async function Wl(r,e={}){if(!r)throw new Error("sentryUpdateIssue: issueId is required");let t={};for(let a of["status","statusDetails","assignedTo","isBookmarked","hasSeen"])e[a]!==void 0&&(t[a]=e[a]);if(Object.keys(t).length===0)throw new Error("sentryUpdateIssue: nothing to update (pass status / statusDetails / assignedTo / isBookmarked / hasSeen)");let n=await sr(r),{token:i,baseUrl:s}=await Qe("sentry"),o=await fetch(`${Xe(s)}/api/0/issues/${n}/`,{method:"PUT",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},body:JSON.stringify(t)});if(!o.ok){let a=await o.text().catch(()=>"");throw o.status===403?new Error(`Sentry API 403 updating issue ${r}: ${a.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 ${o.status} updating issue ${r}: ${a.slice(0,300)}`)}return o.json()}async function Zl(r,e){if(!r)throw new Error("sentryAddComment: issueId is required");if(!e||!String(e).trim())throw new Error("sentryAddComment: text is required");let t=await sr(r),{token:n,baseUrl:i}=await Qe("sentry"),s=await fetch(`${Xe(i)}/api/0/issues/${t}/comments/`,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify({text:String(e)})});if(!s.ok){let o=await s.text().catch(()=>"");throw s.status===403?new Error(`Sentry API 403 commenting on issue ${r}: ${o.slice(0,200)}. The connected Sentry integration likely lacks the \`event:write\` scope \u2014 reconnect Sentry with write access.`):new Error(`Sentry API ${s.status} commenting on issue ${r}: ${o.slice(0,300)}`)}return s.json()}var St={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:N.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry
448
447
  You have access to the user's Sentry. Use these tools:
449
448
  - sentry_list_projects: List projects in the organization
450
449
  - sentry_list_issues: List errors/issues (supports Sentry search query, project filter, sort)
@@ -614,8 +613,8 @@ ${i}
614
613
 
615
614
  `).trim();return l?(l.length>ti&&(l=`${l.slice(0,ti)}
616
615
 
617
- ...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:r}):null}catch{return null}}function ld(r,e){try{let t=JSON.parse(r);return JSON.stringify({...t,...e})}catch{return r}}async function dd(r,e,t){let n={...r},i=String(n.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let s=null;if(ri.test(i)&&!i.startsWith("inline:")){let l=await cd(i);l&&(i=l.inlineSpec,n.spec=i,String(n.ticketKey||"").trim()||(n.ticketKey=l.issueKey),s=l.issueKey)}let o=String(n.ticketKey||"").trim();if(o){for(let[l,p]of M.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=ve(e,i);if(!ie(l))return ri.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=ai(t?.options?.config);if(ar()>=a){let l=li(),p=n.ticketKey||l,u={runId:l,spec:n.ticketKey?`${n.ticketKey}: ${n.spec}`:n.spec,ticketKey:n.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};M.set(l,u),ye.push({args:{...n,_queuedRunId:l},cwd:e,context:t}),J(p,"\u23F3",`Queued (${ar()}/${a} running, ${ye.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 s&&(m.resolvedFromJiraIssue=s,m.message+=` (spec built from Jira ${s})`),JSON.stringify(m)}let c=Date.now()-or;c<Qn&&or>0&&await new Promise(l=>setTimeout(l,Qn-c)),or=Date.now();let d=ui(n,e,t);return s?ld(d,{resolvedFromJiraIssue:s,message:`Spec was loaded from Jira issue ${s} (description + comments).`}):d}function ui(r,e,t){let{spec:n,ticketKey:i,agent:s,headless:o,workflow:a,_queuedRunId:c}=r,d=c||li(),l=n,p=!1;if(n.startsWith("inline:")){p=!0;let A=td(e);Vn(A,{recursive:!0}),l=Z(A,`${d}.txt`),Vl(l,n.slice(7).trim(),"utf-8")}let u=ve(e,".zibby","output","runs");Vn(u,{recursive:!0});let m=Z(u,`${d}.log`),f=Xl(m,{flags:"a"}),b=s&&["assistant","cursor","claude","codex","gemini"].includes(s)?s:null,g=["test",l];b&&g.push("--agent",b),o&&g.push("--headless"),a&&g.push("--workflow",a),ci&&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=${e}`);let _=oi("zibby",g,{cwd:e,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),y={runId:d,spec:i?`${i}: ${n}`:n,ticketKey:i||null,specPath:l,logPath:m,isInline:p,pid:_.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},k=i||d,O="";function H(A){let T=di(A).trim();if(!T)return;if(T.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let x=JSON.parse(T.slice(22));x.phase==="node_begin"?y.currentNode=x.node:x.phase==="node_end"&&(x.node&&!y.completedNodes.includes(x.node)&&y.completedNodes.push(x.node),y.currentNode===x.node&&(y.currentNode=null))}catch{}return}let B=T.match(/Session\s+(\S+)/);if(B&&!y.sessionId&&(y.sessionId=B[1],y.sessionPath=ve(e,lr,cr,y.sessionId)),T.startsWith("\u250C ")||T.startsWith("\u250C ")){let x=T.slice(2).trim();y.currentNode=x,It&&J(k,"\u25B6",`${x}`)}else if(T.startsWith("\u2514 ")||T.startsWith("\u2514 ")){let x=T.slice(2).trim();x.startsWith("done")?(y.currentNode&&!y.completedNodes.includes(y.currentNode)&&y.completedNodes.push(y.currentNode),It&&J(k,"\u2714",`${y.currentNode||"node"} done ${x.replace("done","").trim()}`),y.currentNode=null):x.startsWith("failed")&&(It&&J(k,"\u2718",`${y.currentNode||"node"} failed ${x.replace("failed","").trim()}`),y.currentNode=null)}else T.includes("Workflow completed")&&(y.currentNode=null,It&&J(k,"\u2714",`Workflow completed (${Xn(Date.now()-y.startTime)})`))}function Ee(A){let T=A.toString();y.output+=T,f.write(T),y.output.length>5e4&&(y.output=y.output.slice(-3e4)),O+=T;let B=O.split(`
618
- `);O=B.pop();for(let x of B)H(x)}return _.stdout.on("data",Ee),_.stderr.on("data",A=>{let T=A.toString();y.error+=T,f.write(T),y.error.length>2e4&&(y.error=y.error.slice(-1e4))}),_.on("close",A=>{y.status=A===0?"passed":"failed",y.exitCode=A,y.endTime=Date.now(),O&&H(O),f.end();let T=Xn(Date.now()-y.startTime);if(A===0?J(k,"\u2705",`Passed (${T})`):J(k,"\u274C",`Failed (${T})`),y.isInline)try{Ql(y.specPath)}catch{}ei()}),_.on("error",A=>{y.status="error",y.error+=`
616
+ ...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:r}):null}catch{return null}}function ld(r,e){try{let t=JSON.parse(r);return JSON.stringify({...t,...e})}catch{return r}}async function dd(r,e,t){let n={...r},i=String(n.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let s=null;if(ri.test(i)&&!i.startsWith("inline:")){let l=await cd(i);l&&(i=l.inlineSpec,n.spec=i,String(n.ticketKey||"").trim()||(n.ticketKey=l.issueKey),s=l.issueKey)}let o=String(n.ticketKey||"").trim();if(o){for(let[l,p]of M.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=ve(e,i);if(!ie(l))return ri.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=ai(t?.options?.config);if(ar()>=a){let l=li(),p=n.ticketKey||l,u={runId:l,spec:n.ticketKey?`${n.ticketKey}: ${n.spec}`:n.spec,ticketKey:n.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};M.set(l,u),ye.push({args:{...n,_queuedRunId:l},cwd:e,context:t}),J(p,"\u23F3",`Queued (${ar()}/${a} running, ${ye.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 s&&(m.resolvedFromJiraIssue=s,m.message+=` (spec built from Jira ${s})`),JSON.stringify(m)}let c=Date.now()-or;c<Qn&&or>0&&await new Promise(l=>setTimeout(l,Qn-c)),or=Date.now();let d=ui(n,e,t);return s?ld(d,{resolvedFromJiraIssue:s,message:`Spec was loaded from Jira issue ${s} (description + comments).`}):d}function ui(r,e,t){let{spec:n,ticketKey:i,agent:s,headless:o,workflow:a,_queuedRunId:c}=r,d=c||li(),l=n,p=!1;if(n.startsWith("inline:")){p=!0;let A=td(e);Vn(A,{recursive:!0}),l=Z(A,`${d}.txt`),Vl(l,n.slice(7).trim(),"utf-8")}let u=ve(e,".zibby","output","runs");Vn(u,{recursive:!0});let m=Z(u,`${d}.log`),f=Xl(m,{flags:"a"}),b=s&&["assistant","cursor","claude","codex","gemini"].includes(s)?s:null,g=["test",l];b&&g.push("--agent",b),o&&g.push("--headless"),a&&g.push("--workflow",a),ci&&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=${e}`);let _=oi("zibby",g,{cwd:e,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),y={runId:d,spec:i?`${i}: ${n}`:n,ticketKey:i||null,specPath:l,logPath:m,isInline:p,pid:_.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},k=i||d,O="";function H(A){let T=di(A).trim();if(!T)return;if(T.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let x=JSON.parse(T.slice(22));x.phase==="node_begin"?y.currentNode=x.node:x.phase==="node_end"&&(x.node&&!y.completedNodes.includes(x.node)&&y.completedNodes.push(x.node),y.currentNode===x.node&&(y.currentNode=null))}catch{}return}let q=T.match(/Session\s+(\S+)/);if(q&&!y.sessionId&&(y.sessionId=q[1],y.sessionPath=ve(e,lr,cr,y.sessionId)),T.startsWith("\u250C ")||T.startsWith("\u250C ")){let x=T.slice(2).trim();y.currentNode=x,It&&J(k,"\u25B6",`${x}`)}else if(T.startsWith("\u2514 ")||T.startsWith("\u2514 ")){let x=T.slice(2).trim();x.startsWith("done")?(y.currentNode&&!y.completedNodes.includes(y.currentNode)&&y.completedNodes.push(y.currentNode),It&&J(k,"\u2714",`${y.currentNode||"node"} done ${x.replace("done","").trim()}`),y.currentNode=null):x.startsWith("failed")&&(It&&J(k,"\u2718",`${y.currentNode||"node"} failed ${x.replace("failed","").trim()}`),y.currentNode=null)}else T.includes("Workflow completed")&&(y.currentNode=null,It&&J(k,"\u2714",`Workflow completed (${Xn(Date.now()-y.startTime)})`))}function Ee(A){let T=A.toString();y.output+=T,f.write(T),y.output.length>5e4&&(y.output=y.output.slice(-3e4)),O+=T;let q=O.split(`
617
+ `);O=q.pop();for(let x of q)H(x)}return _.stdout.on("data",Ee),_.stderr.on("data",A=>{let T=A.toString();y.error+=T,f.write(T),y.error.length>2e4&&(y.error=y.error.slice(-1e4))}),_.on("close",A=>{y.status=A===0?"passed":"failed",y.exitCode=A,y.endTime=Date.now(),O&&H(O),f.end();let T=Xn(Date.now()-y.startTime);if(A===0?J(k,"\u2705",`Passed (${T})`):J(k,"\u274C",`Failed (${T})`),y.isInline)try{Ql(y.specPath)}catch{}ei()}),_.on("error",A=>{y.status="error",y.error+=`
619
618
  Spawn error: ${A.message}`,J(k,"\u274C",`Spawn error: ${A.message}`),f.end(),ei()}),y._child=_,M.set(d,y),JSON.stringify({runId:d,spec:y.spec,ticketKey:y.ticketKey,status:"running",pid:_.pid,logFile:m})}function ni(r){let e=Math.round(((r.endTime||Date.now())-r.startTime)/1e3),t=r.completedNodes||[],n=r.currentNode||null;if(r.status!=="running")return{elapsed:e,stage:r.status,completedNodes:t,currentNode:null};let i;return n?(i=`Actively executing node "${n}"`,t.length&&(i+=` (completed: ${t.join(", ")})`)):t.length?i=`Between nodes (completed: ${t.join(", ")})`:i="Starting up (initializing workflow)",i+=`. Elapsed: ${e}s. This is normal progress \u2014 do not cancel.`,{elapsed:e,stage:"running",currentNode:n,completedNodes:t,progress:i}}function pd(r){let{runId:e}=r;if(!e)return JSON.stringify({error:"runId is required"});if(e==="all"){let s=[...M.entries()].map(([l,p])=>{let u=ni(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=s.filter(l=>l.status==="running").length,a=s.filter(l=>l.status==="passed").length,c=s.filter(l=>l.status==="failed").length,d={total:s.length,running:o,passed:a,failed:c,runs:s};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 t=M.get(e);if(!t)return JSON.stringify({error:`Run not found: ${e}`});let n=ni(t),i={runId:e,spec:t.spec,ticketKey:t.ticketKey,status:t.status,elapsed:n.elapsed,exitCode:t.exitCode,sessionId:t.sessionId||null};return t.status==="running"?(i.currentNode=n.currentNode,i.completedNodes=n.completedNodes,i.progress=n.progress):(i.outputTail=t.output.slice(-1e3),i.errorTail=t.error.slice(-500)),t.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 ii(r,e){if(e.status==="queued"){let t=ye.findIndex(n=>n.args._queuedRunId===r);return t>=0&&ye.splice(t,1),e.status="cancelled",e.endTime=Date.now(),{ok:!0,runId:r,status:"cancelled"}}if(e.status!=="running")return{ok:!1,runId:r,error:`Run is not active (status: ${e.status})`};try{return e._child.kill("SIGTERM"),e.status="cancelled",e.endTime=Date.now(),{ok:!0,runId:r,status:"cancelled"}}catch(t){return{ok:!1,runId:r,error:`Failed to cancel: ${t.message}`}}}function ud(r){let{runId:e}=r;if(!e)return JSON.stringify({error:"runId is required"});if(e==="all"){let n=[];for(let[i,s]of M.entries())(s.status==="running"||s.status==="queued")&&n.push(ii(i,s));return n.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:n.length,results:n})}let t=M.get(e);return JSON.stringify(t?ii(e,t):{error:`Run not found: ${e}`})}function md(r,e){let t=M.get(r);if(t?.sessionPath&&ie(t.sessionPath))return t.sessionPath;if(t?.sessionId){let n=ve(e,lr,cr,t.sessionId);if(ie(n))return n}return null}function mi(r,e=""){let t=[];if(!ie(r))return t;for(let n of Ot(r,{withFileTypes:!0})){let i=e?`${e}/${n.name}`:n.name;if(n.isDirectory())t.push(...mi(Z(r,n.name),i));else{let s=ed(Z(r,n.name));t.push({path:i,size:s.size})}}return t}function si(r){if(!ie(r))return null;try{return JSON.parse(Nt(r,"utf-8"))}catch{return null}}function fi(r,e=2e3){if(!r||!ie(r))return"";try{return Nt(r,"utf-8").slice(-Math.max(200,Number(e)||2e3))}catch{return""}}function fd({run:r,logTail:e,errorTail:t}){let i=`${e||""}
620
619
  ${t||""}`.toLowerCase(),s={runId:r?.runId||null,status:r?.status||null,exitCode:r?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return r?.status==="running"||r?.status==="queued"?{...s,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")?{...s,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'")?{...s,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")?{...s,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")?{...s,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")?{...s,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" }).'}:s}function hd(r,e){let{runId:t,type:n,node:i="execute_live",query:s,tail:o=3e3}=r;if(n==="search"){if(!s)return JSON.stringify({error:'query is required for type="search"'});let c=ve(e,lr,cr);if(!ie(c))return JSON.stringify({matches:[],message:"No sessions found"});let d=[],l=s.toLowerCase();for(let p of Ot(c,{withFileTypes:!0})){if(!p.isDirectory())continue;let u=Z(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=Z(u,f);if(ie(b))try{let g=Nt(b,"utf-8");if(g.toLowerCase().includes(l)){let _=g.toLowerCase().indexOf(l),y=Math.max(0,_-100),k=Math.min(g.length,_+s.length+100);d.push({sessionId:p.name,artifact:h,snippet:g.slice(y,k)})}}catch{}}if(d.length>=20)break}return JSON.stringify({query:s,matches:d,total:d.length})}if(!t)return JSON.stringify({error:"runId is required for this type"});if(n==="log"){let c=M.get(t),d=fi(c?.logPath,o);if(d)return JSON.stringify({runId:t,source:"run-log",totalLength:d.length,tail:d})}let a=md(t,e);if(!a)return JSON.stringify({error:`No session found for run ${t}. The run may still be starting.`});switch(n){case"list":{let c=mi(a);return JSON.stringify({sessionId:a.split("/").pop(),files:c,total:c.length})}case"result":{let c=si(Z(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=si(Z(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=Z(a,i,"raw_stream_output.txt");if(!ie(c))return JSON.stringify({error:`No log found in ${i}`});let d=Nt(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: ${n}. Use: list, result, events, log, search`})}}function yd(r,e){let t=String(r?.runId||"all"),n=Number(r?.tail||2e3),i=t==="all"?[...M.keys()]:[t];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let s=i.map(c=>{let d=M.get(c);if(!d)return{runId:c,error:`Run not found: ${c}`};let l=fi(d.logPath,n),p=String(d.error||"").slice(-Math.max(200,n));return{...fd({run:d,logTail:l,errorTail:p}),ticketKey:d.ticketKey||null,spec:d.spec,logTail:l,errorTail:p}}),o=s.filter(c=>c.status==="failed"||c.status==="error"),a=s.filter(c=>c.status==="running"||c.status==="queued");return JSON.stringify({total:s.length,failed:o.length,active:a.length,diagnoses:s})}function gd(r,e){let t=r?.directory||"test-specs",n=ve(e,t);if(!ie(n))return JSON.stringify({specs:[],directory:t,message:`Directory not found: ${t}`});try{let s=function(o,a){for(let c of Ot(o,{withFileTypes:!0})){let d=a?`${a}/${c.name}`:c.name;c.isDirectory()?s(Z(o,c.name),d):(c.name.endsWith(".txt")||c.name.endsWith(".md"))&&i.push(d)}},i=[];return s(n,""),JSON.stringify({specs:i.map(o=>`${t}/${o}`),total:i.length,directory:t})}catch(i){return JSON.stringify({error:i.message})}}function hi(r){let e=(r||"").match(/github\.com[/:]([^/]+)\/([^/]+?)(?:\.git)?$/);return e?{provider:"github",owner:e[1],repo:e[2]}:(e=(r||"").match(/gitlab\.com[/:](.+?)\/([^/]+?)(?:\.git)?$/),e?{provider:"gitlab",owner:e[1],repo:e[2]}:null)}var yi={...me,id:"git-write",envKeys:[...me.envKeys||[],...je.envKeys||[],...$e.envKeys||[]].filter((r,e,t)=>t.indexOf(r)===e),promptFragment:`${me.promptFragment}
621
620
 
@@ -663,7 +662,7 @@ To MERGE an open PR/MR, use the provider-agnostic tool:
663
662
  )`],gi=new Set;function F(r,e){return wi(vi,e,{...Ni,cwd:r})}function ge(r,e){try{let t=F(r,["sql","-q",e,"-r","json"]);return JSON.parse(t.trim()).rows||[]}catch{return[]}}function K(r,e){F(r,["sql","-q",e])}function At(r){if(gi.has(r))return!0;if(!yr(ce(r,".dolt"))){if(!Sd())return!1;Si(r,{recursive:!0}),F(r,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let e=`${wd.join(`;
664
663
  `)};`;K(r,e);try{K(r,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{K(r,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return gi.add(r),!0}function Sd(){try{return wi(vi,["version"],{...Ni,timeout:5e3}),!0}catch{return!1}}function S(r){return r==null?"NULL":`'${String(r).replace(/'/g,"''")}'`}function hr(r){return String(r||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function Je(r){return r==="long"?3:r==="mid"?2:r==="short"?1:0}function gr(r,e){let t=["short","mid","long"].includes(r)?r:"mid";return new Set(["fact","decision","preference","credential","url","workaround"]).has(String(e||"").toLowerCase())&&t==="short"?"mid":t}function Oi(r){let e=new Map;for(let t of r||[]){let n=hr(t.content),i=t.memory_key?`key:${t.memory_key}`:n?`norm:${n}`:"";if(!i)continue;let s=e.get(i);if(!s){e.set(i,t);continue}let o=Je(s.tier),a=Je(t.tier);if(a>o){e.set(i,t);continue}a===o&&Number(t.relevance||0)>Number(s.relevance||0)&&e.set(i,t)}return[...e.values()]}function xt(r,e){let t=String(r??"");return t.length<=e?t:e<=1?t.slice(0,e):`${t.slice(0,e-1)}\u2026`}function et(r,e){let t={recentSessions:Array.isArray(r?.recentSessions)?r.recentSessions:[],topMemories:Array.isArray(r?.topMemories)?r.topMemories:[],taskStats:Array.isArray(r?.taskStats)?r.taskStats:[],ticketFilter:r?.ticketFilter||null,backend:e||String(r?.backend||fr),error:r?.error||null};return t.backend==="mem0"?{...t,recentSessions:[],taskStats:[]}:t}function _i(r){let e=[];if(r.recentSessions?.length>0){e.push("Recent sessions:");for(let t of r.recentSessions.slice(0,3))t?.summary?.trim()&&e.push(`- ${xt(t.summary,150)}${t.tickets?` [${t.tickets}]`:""}`)}if(r.topMemories?.length>0){e.push("Known facts:");for(let t of r.topMemories.slice(0,10)){let n=t.tier==="long"?"\u2605":"\xB7";e.push(`${n} [${t.category}] ${xt(t.content,120)}`)}}return e.length===0?"":`## Memory Context
665
664
  ${e.join(`
666
- `)}`}function Et(r){return{backend:r.backend,recentSessions:r.recentSessions.slice(0,3).map(e=>({summary:xt(String(e?.summary||""),160),tickets:e?.tickets||null,created_at:e?.created_at||null})),topMemories:r.topMemories.slice(0,8).map(e=>({category:e?.category||null,tier:e?.tier||null,content:xt(String(e?.content||""),140),source:e?.source||null})),taskStats:r.taskStats,error:r.error||null}}async function Id(r,e){let t=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(t==="mem0"||t==="dolt")return t;let n=String(e?.options?.memoryBackend||e?.options?.config?.memory?.backend||"").trim().toLowerCase();if(n==="mem0"||n==="dolt")return n;if(Tt.has(r))return Tt.get(r);try{let i=ce(r,".zibby.config.mjs");if(yr(i)){let s=await import(tt(i).href),o=String(s?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Tt.set(r,o),o}}catch{}return Tt.set(r,fr),fr}function Ti(r){let e=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return e||`workspace:${_d(r||process.cwd())}`}var vd="mem0";function Ri(r){let e=ce(r,mr,vd);return{dir:e,vectorDbPath:ce(e,"vectors.db"),historyDbPath:ce(e,"history.db")}}function Nd(r){let e=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!e)return null;let t=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),n=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(),s=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:a}=Ri(r||process.cwd());return{llm:{provider:"openai",config:{model:n,baseURL:e,...t?{apiKey:t}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:s,baseURL:e,...t?{apiKey:t}:{}}},vectorStore:{provider:"memory",config:{dimension:s,dbPath:o}},historyDbPath:a}}async function Ai(r){let e=r||process.cwd();if(pr.has(e))return pr.get(e);let t;try{let a=Ii(tt(ce(e,"package.json")).href).resolve("mem0ai/oss");t=await import(tt(a).href)}catch{try{let o=kd.resolve("mem0ai/oss");t=await import(tt(o).href)}catch(o){throw new Error(`Cannot find package 'mem0ai' for workspace "${e}". Install in that project: npm install mem0ai. (${o.message})`,{cause:o})}}let n=t?.Memory;if(!n)throw new Error("mem0ai/oss does not export Memory");let i=Nd(e);if(i)try{Si(Ri(e).dir,{recursive:!0})}catch{}let s=i?new n(i):new n;return pr.set(e,s),s}function bi(r,e="mid"){return(Array.isArray(r)?r:Array.isArray(r?.results)?r.results:[]).map(n=>({id:n?.id||Lt(),memory_key:n?.metadata?.memoryKey||n?.metadata?.memory_key||null,category:n?.metadata?.category||"fact",content:n?.memory||n?.content||"",source:n?.metadata?.source||"mem0",ticket_key:n?.metadata?.ticketKey||n?.metadata?.ticket_key||null,tier:gr(n?.metadata?.tier||e,n?.metadata?.category||"fact"),relevance:Number(n?.score??n?.metadata?.relevance??.8),created_at:n?.created_at||n?.metadata?.created_at||Ne()})).filter(n=>String(n.content||"").trim().length>0)}var qe={id:"dolt",store:(r,e)=>xi(r,e),recall:(r,e)=>xd(r,e),brief:(r,e)=>Ld(r,e),endSession:(r,e)=>ji(r,e),logTask:(r,e)=>$i(r,e),taskHistory:(r,e)=>Pi(r,e)},Od={id:"mem0",store:(r,e,t)=>Ed(r,e,t),recall:(r,e,t)=>Li(r,e,t),brief:(r,e,t)=>jd(r,e,t),endSession:(r,e)=>ji(r,e),logTask:(r,e)=>$i(r,e),taskHistory:(r,e)=>Pi(r,e)},Td={dolt:qe,mem0:Od};async function ki(r,e){let t=await Id(r,e);return Td[t]||qe}var Ei={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
665
+ `)}`}function Et(r){return{backend:r.backend,recentSessions:r.recentSessions.slice(0,3).map(e=>({summary:xt(String(e?.summary||""),160),tickets:e?.tickets||null,created_at:e?.created_at||null})),topMemories:r.topMemories.slice(0,8).map(e=>({category:e?.category||null,tier:e?.tier||null,content:xt(String(e?.content||""),140),source:e?.source||null})),taskStats:r.taskStats,error:r.error||null}}async function Id(r,e){let t=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(t==="mem0"||t==="dolt")return t;let n=String(e?.options?.memoryBackend||e?.options?.config?.memory?.backend||"").trim().toLowerCase();if(n==="mem0"||n==="dolt")return n;if(Tt.has(r))return Tt.get(r);try{let i=ce(r,".zibby.config.mjs");if(yr(i)){let s=await import(tt(i).href),o=String(s?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Tt.set(r,o),o}}catch{}return Tt.set(r,fr),fr}function Ti(r){let e=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return e||`workspace:${_d(r||process.cwd())}`}var vd="mem0";function Ri(r){let e=ce(r,mr,vd);return{dir:e,vectorDbPath:ce(e,"vectors.db"),historyDbPath:ce(e,"history.db")}}function Nd(r){let e=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!e)return null;let t=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),n=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(),s=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:a}=Ri(r||process.cwd());return{llm:{provider:"openai",config:{model:n,baseURL:e,...t?{apiKey:t}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:s,baseURL:e,...t?{apiKey:t}:{}}},vectorStore:{provider:"memory",config:{dimension:s,dbPath:o}},historyDbPath:a}}async function Ai(r){let e=r||process.cwd();if(pr.has(e))return pr.get(e);let t;try{let a=Ii(tt(ce(e,"package.json")).href).resolve("mem0ai/oss");t=await import(tt(a).href)}catch{try{let o=kd.resolve("mem0ai/oss");t=await import(tt(o).href)}catch(o){throw new Error(`Cannot find package 'mem0ai' for workspace "${e}". Install in that project: npm install mem0ai. (${o.message})`,{cause:o})}}let n=t?.Memory;if(!n)throw new Error("mem0ai/oss does not export Memory");let i=Nd(e);if(i)try{Si(Ri(e).dir,{recursive:!0})}catch{}let s=i?new n(i):new n;return pr.set(e,s),s}function bi(r,e="mid"){return(Array.isArray(r)?r:Array.isArray(r?.results)?r.results:[]).map(n=>({id:n?.id||Lt(),memory_key:n?.metadata?.memoryKey||n?.metadata?.memory_key||null,category:n?.metadata?.category||"fact",content:n?.memory||n?.content||"",source:n?.metadata?.source||"mem0",ticket_key:n?.metadata?.ticketKey||n?.metadata?.ticket_key||null,tier:gr(n?.metadata?.tier||e,n?.metadata?.category||"fact"),relevance:Number(n?.score??n?.metadata?.relevance??.8),created_at:n?.created_at||n?.metadata?.created_at||Ne()})).filter(n=>String(n.content||"").trim().length>0)}var Be={id:"dolt",store:(r,e)=>xi(r,e),recall:(r,e)=>xd(r,e),brief:(r,e)=>Ld(r,e),endSession:(r,e)=>ji(r,e),logTask:(r,e)=>$i(r,e),taskHistory:(r,e)=>Pi(r,e)},Od={id:"mem0",store:(r,e,t)=>Ed(r,e,t),recall:(r,e,t)=>Li(r,e,t),brief:(r,e,t)=>jd(r,e,t),endSession:(r,e)=>ji(r,e),logTask:(r,e)=>$i(r,e),taskHistory:(r,e)=>Pi(r,e)},Td={dolt:Be,mem0:Od};async function ki(r,e){let t=await Id(r,e);return Td[t]||Be}var Ei={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
667
666
  You have persistent memory across sessions. Use it to avoid losing context:
668
667
  - **memory_store**: Save important facts, decisions, or context. Anything worth remembering.
669
668
  - **memory_recall**: Search your memory by keyword or category. Use this at the START of conversations to recall relevant context.
@@ -679,9 +678,9 @@ You have persistent memory across sessions. Use it to avoid losing context:
679
678
  - When the user's request is complete: call memory_end_session
680
679
 
681
680
  ### Categories for memory_store
682
- fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(r,e={}){let t=r?.options?.workspace||process.cwd(),n=ce(t,mr),i=await ki(t,r),s=i.id;if(s==="dolt"&&!At(n)){let o="Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation";return{backend:s,brief:et({backend:s,error:o},s),promptContext:"",debugPreview:Et(et({backend:s,error:o},s)),error:o}}try{let o=await i.brief(e,n,t),a=JSON.parse(o||"{}"),c=et({...a,backend:s},s);return{backend:s,brief:c,promptContext:_i(c),debugPreview:Et(c),error:c.error||null}}catch(o){if(s==="mem0"&&i!==qe&&At(n)){if(!Rt){Rt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${o?.message||o}); degrading to dolt for this run
683
- `)}catch{}}try{let d=await qe.brief(e,n,t),l=JSON.parse(d||"{}"),p=et({...l,backend:"dolt"},"dolt");return{backend:"dolt",brief:p,promptContext:_i(p),debugPreview:Et(p),error:p.error||null,degradedFrom:"mem0"}}catch{}}let a=String(o?.message||o),c=et({backend:s,error:a},s);return{backend:s,brief:c,promptContext:"",debugPreview:Et(c),error:a}}},async handleToolCall(r,e,t){let n=t?.options?.workspace||process.cwd(),i=ce(n,mr),s=await ki(n,t),o=s.id;if((o==="dolt"||["memory_end_session","task_log","task_history"].includes(r))&&!At(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(r){case"memory_store":return d.store(e,i,n);case"memory_recall":return d.recall(e,i,n);case"memory_brief":return d.brief(e,i,n);case"memory_end_session":return d.endSession(e,i,n);case"task_log":return d.logTask(e,i,n);case"task_history":return d.taskHistory(e,i,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}};try{return await c(s)}catch(d){if(o==="mem0"&&s!==qe){if(At(i)){if(!Rt){Rt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${d.message}); degrading to dolt for this run
684
- `)}catch{}}try{return await c(qe)}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 xi(r,e){let{content:t,category:n,source:i,ticketKey:s,tier:o,memoryKey:a}=r;if(!t||!n)return JSON.stringify({error:"content and category are required"});let c=hr(t);if(!c)return JSON.stringify({error:"content is empty after normalization"});let d=gr(o,n),l=d==="long"?1:d==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let g=ge(e,`SELECT id, tier, relevance
681
+ fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(r,e={}){let t=r?.options?.workspace||process.cwd(),n=ce(t,mr),i=await ki(t,r),s=i.id;if(s==="dolt"&&!At(n)){let o="Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation";return{backend:s,brief:et({backend:s,error:o},s),promptContext:"",debugPreview:Et(et({backend:s,error:o},s)),error:o}}try{let o=await i.brief(e,n,t),a=JSON.parse(o||"{}"),c=et({...a,backend:s},s);return{backend:s,brief:c,promptContext:_i(c),debugPreview:Et(c),error:c.error||null}}catch(o){if(s==="mem0"&&i!==Be&&At(n)){if(!Rt){Rt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${o?.message||o}); degrading to dolt for this run
682
+ `)}catch{}}try{let d=await Be.brief(e,n,t),l=JSON.parse(d||"{}"),p=et({...l,backend:"dolt"},"dolt");return{backend:"dolt",brief:p,promptContext:_i(p),debugPreview:Et(p),error:p.error||null,degradedFrom:"mem0"}}catch{}}let a=String(o?.message||o),c=et({backend:s,error:a},s);return{backend:s,brief:c,promptContext:"",debugPreview:Et(c),error:a}}},async handleToolCall(r,e,t){let n=t?.options?.workspace||process.cwd(),i=ce(n,mr),s=await ki(n,t),o=s.id;if((o==="dolt"||["memory_end_session","task_log","task_history"].includes(r))&&!At(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(r){case"memory_store":return d.store(e,i,n);case"memory_recall":return d.recall(e,i,n);case"memory_brief":return d.brief(e,i,n);case"memory_end_session":return d.endSession(e,i,n);case"task_log":return d.logTask(e,i,n);case"task_history":return d.taskHistory(e,i,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}};try{return await c(s)}catch(d){if(o==="mem0"&&s!==Be){if(At(i)){if(!Rt){Rt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${d.message}); degrading to dolt for this run
683
+ `)}catch{}}try{return await c(Be)}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 xi(r,e){let{content:t,category:n,source:i,ticketKey:s,tier:o,memoryKey:a}=r;if(!t||!n)return JSON.stringify({error:"content and category are required"});let c=hr(t);if(!c)return JSON.stringify({error:"content is empty after normalization"});let d=gr(o,n),l=d==="long"?1:d==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let g=ge(e,`SELECT id, tier, relevance
685
684
  FROM chat_memory
686
685
  WHERE memory_key = ${S(p)}
687
686
  ORDER BY created_at DESC
@@ -712,7 +711,7 @@ fact, decision, context, insight, credential, url, error, workaround`,resolve(){
712
711
  VALUES (${S(c)}, ${S(t)}, ${S(n)}, ${i}, ${s}, ${o}, ${S(a)}, ${S(Ne())})`),a)for(let d of a.split(";").map(l=>l.trim()).filter(Boolean))xi({content:d,category:"fact",source:"session_summary",tier:"mid"},e);$d(e);try{F(e,["add","."]),F(e,["commit","-m",`session end: ${t.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:c,summary:t.slice(0,200)})}function $i(r,e){let{title:t,type:n,status:i,ticketKey:s,specPath:o,resultSummary:a}=r;if(!t||!n||!i)return JSON.stringify({error:"title, type, and status are required"});let c=Lt(),d=process.env.ZIBBY_CHAT_SESSION_ID||null;K(e,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
713
712
  VALUES (${S(c)}, ${S(s)}, ${S(n)}, ${S(t)}, ${S(i)}, ${S(o)}, ${S(d)}, ${S(a)}, ${S(Ne())}, ${S(Ne())})`);try{F(e,["add","."]),F(e,["commit","-m",`task: ${i} \u2014 ${t.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:c,title:t,type:n,status:i})}function Pi(r,e){let{ticketKey:t,type:n,status:i,limit:s=20}=r,o=[];t&&o.push(`ticket_key = ${S(t)}`),n&&o.push(`type = ${S(n)}`),i&&o.push(`status = ${S(i)}`);let c=`SELECT id, ticket_key, type, title, status, spec_path, result_summary, created_at, finished_at
714
713
  FROM chat_tasks ${o.length>0?`WHERE ${o.join(" AND ")}`:""}
715
- ORDER BY created_at DESC LIMIT ${s}`,d=ge(e,c);return JSON.stringify({total:d.length,tasks:d})}function $d(r){try{K(r,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),K(r,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),K(r,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),K(r,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function Pd(r){try{let e=new Date(Date.now()-864e5).toISOString();K(r,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${S(e)}`)}catch{}}import{existsSync as Ci,readFileSync as Cd}from"node:fs";import{homedir as Ud}from"node:os";import{join as Jd,dirname as qd,resolve as Bd}from"node:path";import{fileURLToPath as Dd}from"node:url";function Md(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=qd(Dd(import.meta.url)),e=Bd(r,"..","bin","mcp-skill.mjs");return Ci(e)?e:null}function Fd(){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 r=Jd(Ud(),".zibby","config.json");return Ci(r)&&JSON.parse(Cd(r,"utf-8")).sessionToken||null}catch{return null}}function Kd(){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 Gd(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function _r(r){return`${Gd()}:${r}`}async function br(r,e){let t=Fd();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). KV memory is only available inside a Zibby run.");let n=`${Kd()}/credits/review-memory`,i=await fetch(n,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify({op:r,...e})});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`KV memory ${r} failed (${i.status}): ${s.slice(0,300)}`)}return i.json()}var Ui={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)
714
+ ORDER BY created_at DESC LIMIT ${s}`,d=ge(e,c);return JSON.stringify({total:d.length,tasks:d})}function $d(r){try{K(r,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),K(r,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),K(r,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),K(r,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function Pd(r){try{let e=new Date(Date.now()-864e5).toISOString();K(r,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${S(e)}`)}catch{}}import{existsSync as Ci,readFileSync as Cd}from"node:fs";import{homedir as Ud}from"node:os";import{join as Jd,dirname as Bd,resolve as qd}from"node:path";import{fileURLToPath as Dd}from"node:url";function Md(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Bd(Dd(import.meta.url)),e=qd(r,"..","bin","mcp-skill.mjs");return Ci(e)?e:null}function Fd(){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 r=Jd(Ud(),".zibby","config.json");return Ci(r)&&JSON.parse(Cd(r,"utf-8")).sessionToken||null}catch{return null}}function Kd(){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 Gd(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function _r(r){return`${Gd()}:${r}`}async function br(r,e){let t=Fd();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). KV memory is only available inside a Zibby run.");let n=`${Kd()}/credits/review-memory`,i=await fetch(n,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify({op:r,...e})});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`KV memory ${r} failed (${i.status}): ${s.slice(0,300)}`)}return i.json()}var Ui={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)
716
715
  You have a PRIVATE per-agent key-value memory that survives across your
717
716
  stateless runs. It is automatically namespaced to YOU (this agent type) \u2014 other
718
717
  agents cannot see or collide with your entries, and you don't need to prefix
@@ -727,7 +726,7 @@ Tools:
727
726
  Use to record durable facts \u2014 e.g. dedup markers, prior decisions, summaries.
728
727
 
729
728
  Your namespace is added for you automatically; pass plain keys like
730
- "seen#owner/repo#42" or "lastRun".`,resolve(){let r=Md();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/kvMemory.js","kvMemorySkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"kv_recall":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});let n=await br("recall",{scope:_r(t)});return JSON.stringify(n)}case"kv_recall_prefix":{let t=typeof e?.keyPrefix=="string"?e.keyPrefix.trim():"";if(!t)return JSON.stringify({error:"keyPrefix is required"});let n=await br("recall-prefix",{scopePrefix:_r(t)});return JSON.stringify(n)}case"kv_store":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});if(typeof e?.content!="string"||e.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let n={scope:_r(t),content:e.content};e.metadata!=null&&(n.metadata=e.metadata);let i=await br("store",n);return JSON.stringify(i)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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{existsSync as qi,readFileSync as Hd}from"node:fs";import{homedir as zd}from"node:os";import{join as Yd,dirname as Wd,resolve as Zd}from"node:path";import{fileURLToPath as Vd}from"node:url";function Qd(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Wd(Vd(import.meta.url)),e=Zd(r,"..","bin","mcp-skill.mjs");return qi(e)?e:null}function Bi(){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 r=Yd(zd(),".zibby","config.json");return qi(r)&&JSON.parse(Hd(r,"utf-8")).sessionToken||null}catch{return null}}function Di(){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 Ji(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function Xd(){let r={};for(let[e,t]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(e);if(!n)continue;let i=typeof t=="string"?t.trim():"";i&&(r[n[1]]=i)}return r}var Mi={};function Oe(r){let e={...Xd(),...Mi},t=Object.keys(e),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(e,n)?{storeId:e[n],name:n}:{error:`unknown store '${n}'; available: ${t.join(", ")}`}:t.length===1?{storeId:e[t[0]],name:t[0]}:t.length===0?{error:"no stores bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${t.join(", ")})`}}async function ep(r){let e=Bi();if(!e)throw new Error("No backend credential (PROJECT_API_TOKEN). Stores are only available inside a Zibby run.");let t=await fetch(`${Di()}/datasets/stores/ensure`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!t.ok){let n=await t.text().catch(()=>"");throw new Error(`ensure_store failed (${t.status}): ${n.slice(0,300)}`)}return t.json()}async function le(r,e,t){let n=Bi();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Dataset store is only available inside a Zibby run.");let i=`${Di()}/datasets/stores/${encodeURIComponent(r)}/${e}`,s=await fetch(i,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(t)});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Store ${e} failed (${s.status}): ${o.slice(0,300)}`)}return s.json()}var tp=Math.floor(3.5*1024*1024);async function rp(r,e,t,n){let i=await le(r,"put-url",{path:e,contentType:n});if(!i?.url)throw new Error("put-url did not return an upload URL");let s=await fetch(i.url,{method:i.method||"PUT",headers:i.headers||{"Content-Type":n},body:t});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`direct upload failed (${s.status}): ${o.slice(0,200)}`)}return{ok:!0,path:i.path||e,size:t.length,contentType:i.contentType||n,via:"presign"}}async function np(r,e){let t=await le(r,"get-url",{path:e});if(!t?.url)throw new Error("get-url did not return a download URL");let n=await fetch(t.url,{method:t.method||"GET"});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`direct download failed (${n.status}): ${s.slice(0,200)}`)}let i=await n.arrayBuffer();return{buf:Buffer.from(i),contentType:n.headers.get("content-type")||"application/octet-stream"}}var Fi={id:"dataset-store",serverName:"dataset_store",allowedTools:["mcp__dataset_store__*"],description:"Dataset store \u2014 a durable, queryable store for structured JSON records; append rows now, run SQL-style aggregations/reports later",promptFragment:`## Dataset Store (durable, queryable structured-record store)
729
+ "seen#owner/repo#42" or "lastRun".`,resolve(){let r=Md();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/kvMemory.js","kvMemorySkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"kv_recall":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});let n=await br("recall",{scope:_r(t)});return JSON.stringify(n)}case"kv_recall_prefix":{let t=typeof e?.keyPrefix=="string"?e.keyPrefix.trim():"";if(!t)return JSON.stringify({error:"keyPrefix is required"});let n=await br("recall-prefix",{scopePrefix:_r(t)});return JSON.stringify(n)}case"kv_store":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});if(typeof e?.content!="string"||e.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let n={scope:_r(t),content:e.content};e.metadata!=null&&(n.metadata=e.metadata);let i=await br("store",n);return JSON.stringify(i)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.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{existsSync as Bi,readFileSync as Hd}from"node:fs";import{homedir as zd}from"node:os";import{join as Yd,dirname as Wd,resolve as Zd}from"node:path";import{fileURLToPath as Vd}from"node:url";function Qd(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Wd(Vd(import.meta.url)),e=Zd(r,"..","bin","mcp-skill.mjs");return Bi(e)?e:null}function qi(){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 r=Yd(zd(),".zibby","config.json");return Bi(r)&&JSON.parse(Hd(r,"utf-8")).sessionToken||null}catch{return null}}function Di(){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 Ji(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function Xd(){let r={};for(let[e,t]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(e);if(!n)continue;let i=typeof t=="string"?t.trim():"";i&&(r[n[1]]=i)}return r}var Mi={};function Oe(r){let e={...Xd(),...Mi},t=Object.keys(e),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(e,n)?{storeId:e[n],name:n}:{error:`unknown store '${n}'; available: ${t.join(", ")}`}:t.length===1?{storeId:e[t[0]],name:t[0]}:t.length===0?{error:"no stores bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${t.join(", ")})`}}async function ep(r){let e=qi();if(!e)throw new Error("No backend credential (PROJECT_API_TOKEN). Stores are only available inside a Zibby run.");let t=await fetch(`${Di()}/datasets/stores/ensure`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!t.ok){let n=await t.text().catch(()=>"");throw new Error(`ensure_store failed (${t.status}): ${n.slice(0,300)}`)}return t.json()}async function le(r,e,t){let n=qi();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Dataset store is only available inside a Zibby run.");let i=`${Di()}/datasets/stores/${encodeURIComponent(r)}/${e}`,s=await fetch(i,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(t)});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Store ${e} failed (${s.status}): ${o.slice(0,300)}`)}return s.json()}var tp=Math.floor(3.5*1024*1024);async function rp(r,e,t,n){let i=await le(r,"put-url",{path:e,contentType:n});if(!i?.url)throw new Error("put-url did not return an upload URL");let s=await fetch(i.url,{method:i.method||"PUT",headers:i.headers||{"Content-Type":n},body:t});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`direct upload failed (${s.status}): ${o.slice(0,200)}`)}return{ok:!0,path:i.path||e,size:t.length,contentType:i.contentType||n,via:"presign"}}async function np(r,e){let t=await le(r,"get-url",{path:e});if(!t?.url)throw new Error("get-url did not return a download URL");let n=await fetch(t.url,{method:t.method||"GET"});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`direct download failed (${n.status}): ${s.slice(0,200)}`)}let i=await n.arrayBuffer();return{buf:Buffer.from(i),contentType:n.headers.get("content-type")||"application/octet-stream"}}var Fi={id:"dataset-store",serverName:"dataset_store",allowedTools:["mcp__dataset_store__*"],description:"Dataset store \u2014 a durable, queryable store for structured JSON records; append rows now, run SQL-style aggregations/reports later",promptFragment:`## Dataset Store (durable, queryable structured-record store)
731
730
  You have one or more durable stores for STRUCTURED records that survive across
732
731
  your stateless runs. Unlike key-value memory (for picking up where you left
733
732
  off), this is for accumulating DATA you want to QUERY and AGGREGATE later \u2014 e.g.
@@ -795,13 +794,13 @@ Tools:
795
794
  To recall WHAT YOU HAVE ALREADY PUBLISHED, use your kv-memory tool
796
795
  kv_recall_prefix with keyPrefix "artifact:" \u2014 each entry is the index record
797
796
  { id, title, url, kind, createdAt, summary } for a page you made. (Publishing
798
- records this automatically; you don't store it yourself.)`,resolve(){let r=pp();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/artifact.js","artifactSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"artifact_publish":{let t=typeof e?.title=="string"?e.title.trim():"";if(!t)return JSON.stringify({error:"title is required"});let n=Hi(e);if(!n)return JSON.stringify({error:"provide exactly one of html or markdown (non-empty string)"});let i={title:t,[n.format]:n.content};typeof e?.kind=="string"&&e.kind.trim()&&(i.kind=e.kind.trim()),typeof e?.favicon=="string"&&e.favicon.trim()&&(i.favicon=e.favicon.trim());let s=await Ki(i),o=s?.id,a=s?.url;if(!o||!a)return JSON.stringify({error:"artifact write returned no id/url",response:s});let c={id:o,title:t,url:a,kind:i.kind||null,createdAt:s.createdAt||new Date().toISOString(),summary:typeof e?.summary=="string"&&e.summary.trim()?e.summary.trim():t};try{await Gi(o,c)}catch(d){return JSON.stringify({id:o,url:a,indexWarning:d.message})}return JSON.stringify({id:o,url:a})}case"artifact_update":{let t=typeof e?.id=="string"?e.id.trim():"";if(!t)return JSON.stringify({error:"id is required"});let n=Hi(e),i=typeof e?.title=="string"?e.title.trim():"";if(!n&&!i)return JSON.stringify({error:"nothing to update \u2014 pass a new title and/or html|markdown"});let s={id:t};i&&(s.title=i),n&&(s[n.format]=n.content),typeof e?.kind=="string"&&e.kind.trim()&&(s.kind=e.kind.trim()),typeof e?.favicon=="string"&&e.favicon.trim()&&(s.favicon=e.favicon.trim());let o=await Ki(s),a=o?.url;if(!a)return JSON.stringify({error:"artifact update returned no url",response:o});let c=await fp(t)||{},d={...c,id:t,url:a,title:i||c.title||"Untitled",kind:s.kind||c.kind||null,createdAt:c.createdAt||o.createdAt||new Date().toISOString(),updatedAt:o.updatedAt||new Date().toISOString()};typeof e?.summary=="string"&&e.summary.trim()?d.summary=e.summary.trim():d.summary||(d.summary=d.title);try{await Gi(t,d)}catch(l){return JSON.stringify({id:t,url:a,indexWarning:l.message})}return JSON.stringify({id:t,url:a})}case"artifact_get":{let t=typeof e?.id=="string"?e.id.trim():"";if(!t)return JSON.stringify({error:"id is required"});let n=await mp(t);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.message})}},tools:[{name:"artifact_publish",description:"Publish a NEW self-contained, shareable page (report/plan/table/dashboard/diagram/write-up) and get back a shareable URL. Pass a title and EITHER html OR markdown. Keep all CSS/JS/images INLINE (inline <style>/<script>, data: URIs) \u2014 the page is sandboxed on view and external URLs are blocked. Returns { id, url }.",input_schema:{type:"object",properties:{title:{type:"string",description:"The page title (also the browser tab title)."},html:{type:"string",description:"The page content as a self-contained HTML document (or fragment). Provide this OR markdown, not both."},markdown:{type:"string",description:"The page content as Markdown (rendered to HTML on serve). Provide this OR html, not both."},kind:{type:"string",description:'Optional label for what this is, e.g. "report", "plan", "dashboard", "diagram". Stored in your index.'},favicon:{type:"string",description:'Optional emoji used as the browser-tab icon, e.g. "\u{1F4CA}".'},summary:{type:"string",description:"Optional one-line summary for your own index (defaults to the title). Helps you recall later what this page was."}},required:["title"]}},{name:"artifact_update",description:"Revise an EXISTING artifact by id \u2014 the shareable URL stays the same, the content is replaced (new version). Pass the fields to change (title and/or html|markdown). Returns { id, url }.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to update (from a prior artifact_publish, or your kv-memory "artifact:" index).'},title:{type:"string",description:"New title (optional)."},html:{type:"string",description:"New HTML content (optional). Provide this OR markdown."},markdown:{type:"string",description:"New Markdown content (optional). Provide this OR html."},kind:{type:"string",description:"Optional updated kind label."},favicon:{type:"string",description:"Optional updated emoji favicon."},summary:{type:"string",description:"Optional updated one-line index summary."}},required:["id"]}},{name:"artifact_get",description:'Fetch ONE artifact you published, by id \u2192 { metadata, content }. Use to reuse / edit / re-publish a page. To LIST what you have published, use your kv-memory tool kv_recall_prefix with keyPrefix "artifact:".',input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id."}},required:["id"]}}]};import{createRequire as hp}from"node:module";import{existsSync as Xi,mkdirSync as yp,writeFileSync as Zi}from"node:fs";import{dirname as es,join as Be,resolve as ts}from"node:path";import{fileURLToPath as rs}from"node:url";var ns=hp(import.meta.url),kr=null;function gp(){return kr||(kr=ns("echarts")),kr}var wr=null;function _p(){return wr||(wr=ns("@resvg/resvg-js")),wr}var bp=800,kp=600,wp=4096,Sp=16,Vi=60,is="Noto Sans";function Ip(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=es(rs(import.meta.url)),e=ts(r,"..","bin","mcp-skill.mjs");return Xi(e)?e:null}function vp(){let r=es(rs(import.meta.url)),e=ts(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(t=>Be(e,t)).filter(t=>Xi(t))}function Np(){let r=process.env.ZIBBY_NODE_SESSION_PATH,e=process.env.ZIBBY_SESSION_PATH,t=r||(e?Be(e,"chart-render"):Be(process.cwd(),".zibby","output","charts"));return yp(t,{recursive:!0}),t}function Te(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function Qi(r,e){let t=Number(r);return Number.isFinite(t)?Math.max(Sp,Math.min(wp,Math.round(t))):e}function Sr(r){return typeof r!="string"||r.length<=Vi?r:`${r.slice(0,Vi-1)}\u2026`}function Pt(r){if(Array.isArray(r))for(let e=0;e<r.length;e++){let t=r[e];typeof t=="string"?r[e]=Sr(t):Te(t)&&typeof t.name=="string"&&(t.name=Sr(t.name))}}function Op(r){for(let n of["xAxis","yAxis"]){let i=Array.isArray(r[n])?r[n]:r[n]?[r[n]]:[];for(let s of i)Te(s)&&Pt(s.data)}let e=Array.isArray(r.radar)?r.radar:r.radar?[r.radar]:[];for(let n of e)Te(n)&&Pt(n.indicator);Te(r.legend)&&Pt(r.legend.data);let t=Array.isArray(r.series)?r.series:r.series?[r.series]:[];for(let n of t)Te(n)&&(typeof n.name=="string"&&(n.name=Sr(n.name)),Pt(n.data))}function Tp(r){let e=JSON.parse(JSON.stringify(r));return e.animation=!1,e.backgroundColor==null&&(e.backgroundColor="#fff"),Te(e.textStyle)||(e.textStyle={}),e.textStyle.fontFamily==null&&(e.textStyle.fontFamily=is),Op(e),e}function Rp(r){return typeof r!="string"?null:r.trim().replace(/\.(svg|png)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Ap(r,e,t){let i=gp().init(null,null,{renderer:"svg",ssr:!0,width:e,height:t});try{return i.setOption(r),i.renderToSVGString()}finally{i.dispose()}}function Ep(r){let{Resvg:e}=_p();return new e(r,{font:{fontFiles:vp(),loadSystemFonts:!0,defaultFontFamily:is}}).render().asPng()}var ss={id:"chart-render",serverName:"chart_render",allowedTools:["mcp__chart_render__*"],description:"Chart render \u2014 local server-side chart rendering (Apache ECharts SVG SSR + resvg PNG); data never leaves the box",promptFragment:`## Chart Render (local, no external service)
797
+ records this automatically; you don't store it yourself.)`,resolve(){let r=pp();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/artifact.js","artifactSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"artifact_publish":{let t=typeof e?.title=="string"?e.title.trim():"";if(!t)return JSON.stringify({error:"title is required"});let n=Hi(e);if(!n)return JSON.stringify({error:"provide exactly one of html or markdown (non-empty string)"});let i={title:t,[n.format]:n.content};typeof e?.kind=="string"&&e.kind.trim()&&(i.kind=e.kind.trim()),typeof e?.favicon=="string"&&e.favicon.trim()&&(i.favicon=e.favicon.trim());let s=await Ki(i),o=s?.id,a=s?.url;if(!o||!a)return JSON.stringify({error:"artifact write returned no id/url",response:s});let c={id:o,title:t,url:a,kind:i.kind||null,createdAt:s.createdAt||new Date().toISOString(),summary:typeof e?.summary=="string"&&e.summary.trim()?e.summary.trim():t};try{await Gi(o,c)}catch(d){return JSON.stringify({id:o,url:a,indexWarning:d.message})}return JSON.stringify({id:o,url:a})}case"artifact_update":{let t=typeof e?.id=="string"?e.id.trim():"";if(!t)return JSON.stringify({error:"id is required"});let n=Hi(e),i=typeof e?.title=="string"?e.title.trim():"";if(!n&&!i)return JSON.stringify({error:"nothing to update \u2014 pass a new title and/or html|markdown"});let s={id:t};i&&(s.title=i),n&&(s[n.format]=n.content),typeof e?.kind=="string"&&e.kind.trim()&&(s.kind=e.kind.trim()),typeof e?.favicon=="string"&&e.favicon.trim()&&(s.favicon=e.favicon.trim());let o=await Ki(s),a=o?.url;if(!a)return JSON.stringify({error:"artifact update returned no url",response:o});let c=await fp(t)||{},d={...c,id:t,url:a,title:i||c.title||"Untitled",kind:s.kind||c.kind||null,createdAt:c.createdAt||o.createdAt||new Date().toISOString(),updatedAt:o.updatedAt||new Date().toISOString()};typeof e?.summary=="string"&&e.summary.trim()?d.summary=e.summary.trim():d.summary||(d.summary=d.title);try{await Gi(t,d)}catch(l){return JSON.stringify({id:t,url:a,indexWarning:l.message})}return JSON.stringify({id:t,url:a})}case"artifact_get":{let t=typeof e?.id=="string"?e.id.trim():"";if(!t)return JSON.stringify({error:"id is required"});let n=await mp(t);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.message})}},tools:[{name:"artifact_publish",description:"Publish a NEW self-contained, shareable page (report/plan/table/dashboard/diagram/write-up) and get back a shareable URL. Pass a title and EITHER html OR markdown. Keep all CSS/JS/images INLINE (inline <style>/<script>, data: URIs) \u2014 the page is sandboxed on view and external URLs are blocked. Returns { id, url }.",input_schema:{type:"object",properties:{title:{type:"string",description:"The page title (also the browser tab title)."},html:{type:"string",description:"The page content as a self-contained HTML document (or fragment). Provide this OR markdown, not both."},markdown:{type:"string",description:"The page content as Markdown (rendered to HTML on serve). Provide this OR html, not both."},kind:{type:"string",description:'Optional label for what this is, e.g. "report", "plan", "dashboard", "diagram". Stored in your index.'},favicon:{type:"string",description:'Optional emoji used as the browser-tab icon, e.g. "\u{1F4CA}".'},summary:{type:"string",description:"Optional one-line summary for your own index (defaults to the title). Helps you recall later what this page was."}},required:["title"]}},{name:"artifact_update",description:"Revise an EXISTING artifact by id \u2014 the shareable URL stays the same, the content is replaced (new version). Pass the fields to change (title and/or html|markdown). Returns { id, url }.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to update (from a prior artifact_publish, or your kv-memory "artifact:" index).'},title:{type:"string",description:"New title (optional)."},html:{type:"string",description:"New HTML content (optional). Provide this OR markdown."},markdown:{type:"string",description:"New Markdown content (optional). Provide this OR html."},kind:{type:"string",description:"Optional updated kind label."},favicon:{type:"string",description:"Optional updated emoji favicon."},summary:{type:"string",description:"Optional updated one-line index summary."}},required:["id"]}},{name:"artifact_get",description:'Fetch ONE artifact you published, by id \u2192 { metadata, content }. Use to reuse / edit / re-publish a page. To LIST what you have published, use your kv-memory tool kv_recall_prefix with keyPrefix "artifact:".',input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id."}},required:["id"]}}]};import{createRequire as hp}from"node:module";import{existsSync as Xi,mkdirSync as yp,writeFileSync as Zi}from"node:fs";import{dirname as es,join as qe,resolve as ts}from"node:path";import{fileURLToPath as rs}from"node:url";var ns=hp(import.meta.url),kr=null;function gp(){return kr||(kr=ns("echarts")),kr}var wr=null;function _p(){return wr||(wr=ns("@resvg/resvg-js")),wr}var bp=800,kp=600,wp=4096,Sp=16,Vi=60,is="Noto Sans";function Ip(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=es(rs(import.meta.url)),e=ts(r,"..","bin","mcp-skill.mjs");return Xi(e)?e:null}function vp(){let r=es(rs(import.meta.url)),e=ts(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(t=>qe(e,t)).filter(t=>Xi(t))}function Np(){let r=process.env.ZIBBY_NODE_SESSION_PATH,e=process.env.ZIBBY_SESSION_PATH,t=r||(e?qe(e,"chart-render"):qe(process.cwd(),".zibby","output","charts"));return yp(t,{recursive:!0}),t}function Te(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function Qi(r,e){let t=Number(r);return Number.isFinite(t)?Math.max(Sp,Math.min(wp,Math.round(t))):e}function Sr(r){return typeof r!="string"||r.length<=Vi?r:`${r.slice(0,Vi-1)}\u2026`}function Pt(r){if(Array.isArray(r))for(let e=0;e<r.length;e++){let t=r[e];typeof t=="string"?r[e]=Sr(t):Te(t)&&typeof t.name=="string"&&(t.name=Sr(t.name))}}function Op(r){for(let n of["xAxis","yAxis"]){let i=Array.isArray(r[n])?r[n]:r[n]?[r[n]]:[];for(let s of i)Te(s)&&Pt(s.data)}let e=Array.isArray(r.radar)?r.radar:r.radar?[r.radar]:[];for(let n of e)Te(n)&&Pt(n.indicator);Te(r.legend)&&Pt(r.legend.data);let t=Array.isArray(r.series)?r.series:r.series?[r.series]:[];for(let n of t)Te(n)&&(typeof n.name=="string"&&(n.name=Sr(n.name)),Pt(n.data))}function Tp(r){let e=JSON.parse(JSON.stringify(r));return e.animation=!1,e.backgroundColor==null&&(e.backgroundColor="#fff"),Te(e.textStyle)||(e.textStyle={}),e.textStyle.fontFamily==null&&(e.textStyle.fontFamily=is),Op(e),e}function Rp(r){return typeof r!="string"?null:r.trim().replace(/\.(svg|png)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Ap(r,e,t){let i=gp().init(null,null,{renderer:"svg",ssr:!0,width:e,height:t});try{return i.setOption(r),i.renderToSVGString()}finally{i.dispose()}}function Ep(r){let{Resvg:e}=_p();return new e(r,{font:{fontFiles:vp(),loadSystemFonts:!0,defaultFontFamily:is}}).render().asPng()}var ss={id:"chart-render",serverName:"chart_render",allowedTools:["mcp__chart_render__*"],description:"Chart render \u2014 local server-side chart rendering (Apache ECharts SVG SSR + resvg PNG); data never leaves the box",promptFragment:`## Chart Render (local, no external service)
799
798
  You can render charts LOCALLY with the chart_render tool \u2014 pass a standard
800
799
  Apache ECharts option object as \`spec\` (any chart type: bar, line, pie,
801
800
  radar, scatter, heatmap, \u2026). It renders server-side to SVG/PNG files in the
802
801
  run's output folder (auto-attached to the run as artifacts) and returns the
803
802
  file paths. No browser, no external chart service \u2014 the data never leaves
804
- the machine. Don't set animation (it's forced off). Default 800\xD7600 PNG.`,resolve({sessionPath:r,nodeName:e}={}){let t=Ip();if(!t)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&e?Be(r,e):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[t,"../dist/chartRender.js","chartRenderSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){if(r!=="chart_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=e?.spec;if(!Te(t))return JSON.stringify({error:"spec must be a plain ECharts option OBJECT (e.g. { xAxis: {...}, yAxis: {...}, series: [...] }) \u2014 got "+(t===null?"null":Array.isArray(t)?"an array":typeof t)+". Pass the option object itself, not a string or an array."});let n=Qi(e?.width,bp),i=Qi(e?.height,kp),s=["svg","png","both"].includes(e?.output)?e.output:"png",o=Rp(e?.filename)||`chart-${Date.now()}`,a;try{a=Ap(Tp(t),n,i)}catch(l){return JSON.stringify({error:`Chart render failed: ${l.message}. The spec must be a valid Apache ECharts option (check series[].type, and that xAxis/yAxis/radar match the series type). Fix the spec and retry.`})}if(typeof a!="string"||!a.includes("<svg"))return JSON.stringify({error:"Chart render produced no SVG \u2014 the spec likely describes an empty chart (no series?). Add at least one series and retry."});let c=Np(),d=[];if(s==="svg"||s==="both"){let l=Be(c,`${o}.svg`);Zi(l,a,"utf-8"),d.push({path:l,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}if(s==="png"||s==="both"){let l;try{l=Ep(a)}catch(u){return JSON.stringify({error:`PNG rasterization failed: ${u.message}. Retry with output:'svg' if you only need the vector.`})}let p=Be(c,`${o}.png`);Zi(p,l),d.push({path:p,format:"png",bytes:l.length})}return JSON.stringify({ok:!0,width:n,height:i,files:d})}catch(t){return JSON.stringify({error:`chart_render failed: ${t.message}`})}},tools:[{name:"chart_render",description:'Render a chart LOCALLY (no external service) from a standard Apache ECharts option and save it as SVG/PNG files in the run output folder. Pass the raw ECharts option as `spec` \u2014 every ECharts chart type works (bar, line, pie, radar, scatter, heatmap, \u2026). Returns the written file path(s). animation is forced off; background defaults to white. Bar example: {"xAxis":{"type":"category","data":["Q1","Q2"]},"yAxis":{},"series":[{"type":"bar","data":[12,30]}]}. Radar example: {"legend":{"data":["A","B"]},"radar":{"indicator":[{"name":"speed","max":10},{"name":"cost","max":10},{"name":"quality","max":10}]},"series":[{"type":"radar","data":[{"name":"A","value":[7,4,9]},{"name":"B","value":[5,8,6]}]}]}.',input_schema:{type:"object",properties:{spec:{type:"object",description:"The Apache ECharts option object, passed through as-is (series, xAxis/yAxis, radar, legend, title, \u2026)."},width:{type:"number",description:"Image width in px (default 800, max 4096)."},height:{type:"number",description:"Image height in px (default 600, max 4096)."},output:{type:"string",enum:["svg","png","both"],description:"Which file(s) to write (default 'png')."},filename:{type:"string",description:"Optional file basename (no extension); defaults to chart-<timestamp>."}},required:["spec"]}}]};import{existsSync as xp}from"fs";import{fileURLToPath as Lp}from"url";import{dirname as jp,resolve as $p}from"path";function Pp(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=jp(Lp(import.meta.url)),e=$p(r,"..","bin","mcp-skill.mjs");return xp(e)?e:null}var Cp=[{name:"trivial",max:5},{name:"small",max:30},{name:"medium",max:150},{name:"large",max:600},{name:"huge",max:1/0}];function Up(r,e){let t=(Number(r)||0)+(Number(e)||0);for(let n of Cp)if(t<=n.max)return n.name;return"huge"}function Jp(r){let t=String(r||"").toLowerCase().split("/").pop()||"",n=t.match(/\.(test|spec)\.[a-z0-9]+$/);if(n)return`.${n[1]}`;let i=t.lastIndexOf(".");return i<=0?/^(dockerfile|makefile|jenkinsfile|procfile|gemfile|rakefile)$/i.test(t)?t.toLowerCase():"":t.slice(i)}var qp={code:[".js",".jsx",".ts",".tsx",".mjs",".cjs",".py",".go",".rs",".java",".kt",".rb",".php",".c",".cc",".cpp",".h",".hpp",".cs",".swift",".scala",".m",".dart",".ex",".exs",".clj",".sh",".bash"],test:[".test",".spec"],docs:[".md",".mdx",".rst",".txt",".adoc"],config:[".json",".yml",".yaml",".toml",".ini",".env",".cfg",".conf",".lock",".xml",".properties","dockerfile","makefile","jenkinsfile","procfile",".tf",".gradle"],style:[".css",".scss",".sass",".less",".styl"],data:[".csv",".tsv",".sql",".parquet",".proto",".graphql",".gql"]},Bp=(()=>{let r={};for(let[e,t]of Object.entries(qp))for(let n of t)r[n]=e;return r})();function Dp(r){return Bp[String(r||"").toLowerCase()]||"other"}function Mp(r,e={}){let t=Array.isArray(r)?r:[],n=[],i={},s={code:0,test:0,docs:0,config:0,style:0,data:0,other:0},o=0,a=0,c={path:"",changed:-1};for(let m of t){if(!m||typeof m!="object")continue;let f=String(m.path||m.newPath||m.filename||m.new_path||"").trim();if(!f)continue;n.push(f);let h=Number(m.additions??m.add??0)||0,b=Number(m.deletions??m.del??0)||0;o+=h,a+=b;let g=Jp(f);i[g||"(none)"]=(i[g||"(none)"]||0)+1,s[Dp(g)]+=1;let _=h+b;_>c.changed&&(c={path:f,changed:_})}let d=Number(e.additions),l=Number(e.deletions),p=Number.isFinite(d)?d:o,u=Number.isFinite(l)?l:a;return{filesChanged:n.length,filePaths:n,extCounts:i,kindCounts:s,additions:p,deletions:u,sizeBucket:Up(p,u),largestFile:c.path||null,dirs:[...new Set(n.map(m=>m.includes("/")?m.split("/")[0]:"(root)"))].sort()}}function Fp(r){let e="",t=String(r||"");for(let n=0;n<t.length;n++){let i=t[n];i==="*"?t[n+1]==="*"?(e+=".*",n++,t[n+1]==="/"&&n++):e+="[^/]*":i==="?"?e+="[^/]":"\\^$.|+()[]{}".includes(i)?e+=`\\${i}`:e+=i}return new RegExp(`^${e}$`)}function Kp(r,e){let t=Array.isArray(r)?r.map(String):[],n=(Array.isArray(e)?e:[]).filter(Boolean).map(Fp);if(!n.length)return{total:t.length,hits:0,ratio:0,matched:[]};let i=t.filter(s=>n.some(o=>o.test(s)));return{total:t.length,hits:i.length,ratio:t.length?Number((i.length/t.length).toFixed(4)):0,matched:i}}function Gp(r,e){let t=(Array.isArray(r)?r:[]).map(Number).filter(s=>Number.isFinite(s)),n=Number(e);if(!t.length||!Number.isFinite(n))return null;let i=t.filter(s=>s<=n).length;return Number((i/t.length*100).toFixed(1))}var os={id:"code-stats",serverName:"code_stats",allowedTools:["mcp__code_stats__*"],description:"Deterministic code statistics \u2014 pure, reproducible facts from changed-file lists + numbers (extension/work-kind mix, size bucket, core-path glob coverage, percentile rank). Zero LLM, zero network.",promptFragment:`## Code Stats (DETERMINISTIC facts \u2014 pure, reproducible, zero-LLM)
803
+ the machine. Don't set animation (it's forced off). Default 800\xD7600 PNG.`,resolve({sessionPath:r,nodeName:e}={}){let t=Ip();if(!t)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&e?qe(r,e):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[t,"../dist/chartRender.js","chartRenderSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){if(r!=="chart_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=e?.spec;if(!Te(t))return JSON.stringify({error:"spec must be a plain ECharts option OBJECT (e.g. { xAxis: {...}, yAxis: {...}, series: [...] }) \u2014 got "+(t===null?"null":Array.isArray(t)?"an array":typeof t)+". Pass the option object itself, not a string or an array."});let n=Qi(e?.width,bp),i=Qi(e?.height,kp),s=["svg","png","both"].includes(e?.output)?e.output:"png",o=Rp(e?.filename)||`chart-${Date.now()}`,a;try{a=Ap(Tp(t),n,i)}catch(l){return JSON.stringify({error:`Chart render failed: ${l.message}. The spec must be a valid Apache ECharts option (check series[].type, and that xAxis/yAxis/radar match the series type). Fix the spec and retry.`})}if(typeof a!="string"||!a.includes("<svg"))return JSON.stringify({error:"Chart render produced no SVG \u2014 the spec likely describes an empty chart (no series?). Add at least one series and retry."});let c=Np(),d=[];if(s==="svg"||s==="both"){let l=qe(c,`${o}.svg`);Zi(l,a,"utf-8"),d.push({path:l,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}if(s==="png"||s==="both"){let l;try{l=Ep(a)}catch(u){return JSON.stringify({error:`PNG rasterization failed: ${u.message}. Retry with output:'svg' if you only need the vector.`})}let p=qe(c,`${o}.png`);Zi(p,l),d.push({path:p,format:"png",bytes:l.length})}return JSON.stringify({ok:!0,width:n,height:i,files:d})}catch(t){return JSON.stringify({error:`chart_render failed: ${t.message}`})}},tools:[{name:"chart_render",description:'Render a chart LOCALLY (no external service) from a standard Apache ECharts option and save it as SVG/PNG files in the run output folder. Pass the raw ECharts option as `spec` \u2014 every ECharts chart type works (bar, line, pie, radar, scatter, heatmap, \u2026). Returns the written file path(s). animation is forced off; background defaults to white. Bar example: {"xAxis":{"type":"category","data":["Q1","Q2"]},"yAxis":{},"series":[{"type":"bar","data":[12,30]}]}. Radar example: {"legend":{"data":["A","B"]},"radar":{"indicator":[{"name":"speed","max":10},{"name":"cost","max":10},{"name":"quality","max":10}]},"series":[{"type":"radar","data":[{"name":"A","value":[7,4,9]},{"name":"B","value":[5,8,6]}]}]}.',input_schema:{type:"object",properties:{spec:{type:"object",description:"The Apache ECharts option object, passed through as-is (series, xAxis/yAxis, radar, legend, title, \u2026)."},width:{type:"number",description:"Image width in px (default 800, max 4096)."},height:{type:"number",description:"Image height in px (default 600, max 4096)."},output:{type:"string",enum:["svg","png","both"],description:"Which file(s) to write (default 'png')."},filename:{type:"string",description:"Optional file basename (no extension); defaults to chart-<timestamp>."}},required:["spec"]}}]};import{existsSync as xp}from"fs";import{fileURLToPath as Lp}from"url";import{dirname as jp,resolve as $p}from"path";function Pp(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=jp(Lp(import.meta.url)),e=$p(r,"..","bin","mcp-skill.mjs");return xp(e)?e:null}var Cp=[{name:"trivial",max:5},{name:"small",max:30},{name:"medium",max:150},{name:"large",max:600},{name:"huge",max:1/0}];function Up(r,e){let t=(Number(r)||0)+(Number(e)||0);for(let n of Cp)if(t<=n.max)return n.name;return"huge"}function Jp(r){let t=String(r||"").toLowerCase().split("/").pop()||"",n=t.match(/\.(test|spec)\.[a-z0-9]+$/);if(n)return`.${n[1]}`;let i=t.lastIndexOf(".");return i<=0?/^(dockerfile|makefile|jenkinsfile|procfile|gemfile|rakefile)$/i.test(t)?t.toLowerCase():"":t.slice(i)}var Bp={code:[".js",".jsx",".ts",".tsx",".mjs",".cjs",".py",".go",".rs",".java",".kt",".rb",".php",".c",".cc",".cpp",".h",".hpp",".cs",".swift",".scala",".m",".dart",".ex",".exs",".clj",".sh",".bash"],test:[".test",".spec"],docs:[".md",".mdx",".rst",".txt",".adoc"],config:[".json",".yml",".yaml",".toml",".ini",".env",".cfg",".conf",".lock",".xml",".properties","dockerfile","makefile","jenkinsfile","procfile",".tf",".gradle"],style:[".css",".scss",".sass",".less",".styl"],data:[".csv",".tsv",".sql",".parquet",".proto",".graphql",".gql"]},qp=(()=>{let r={};for(let[e,t]of Object.entries(Bp))for(let n of t)r[n]=e;return r})();function Dp(r){return qp[String(r||"").toLowerCase()]||"other"}function Mp(r,e={}){let t=Array.isArray(r)?r:[],n=[],i={},s={code:0,test:0,docs:0,config:0,style:0,data:0,other:0},o=0,a=0,c={path:"",changed:-1};for(let m of t){if(!m||typeof m!="object")continue;let f=String(m.path||m.newPath||m.filename||m.new_path||"").trim();if(!f)continue;n.push(f);let h=Number(m.additions??m.add??0)||0,b=Number(m.deletions??m.del??0)||0;o+=h,a+=b;let g=Jp(f);i[g||"(none)"]=(i[g||"(none)"]||0)+1,s[Dp(g)]+=1;let _=h+b;_>c.changed&&(c={path:f,changed:_})}let d=Number(e.additions),l=Number(e.deletions),p=Number.isFinite(d)?d:o,u=Number.isFinite(l)?l:a;return{filesChanged:n.length,filePaths:n,extCounts:i,kindCounts:s,additions:p,deletions:u,sizeBucket:Up(p,u),largestFile:c.path||null,dirs:[...new Set(n.map(m=>m.includes("/")?m.split("/")[0]:"(root)"))].sort()}}function Fp(r){let e="",t=String(r||"");for(let n=0;n<t.length;n++){let i=t[n];i==="*"?t[n+1]==="*"?(e+=".*",n++,t[n+1]==="/"&&n++):e+="[^/]*":i==="?"?e+="[^/]":"\\^$.|+()[]{}".includes(i)?e+=`\\${i}`:e+=i}return new RegExp(`^${e}$`)}function Kp(r,e){let t=Array.isArray(r)?r.map(String):[],n=(Array.isArray(e)?e:[]).filter(Boolean).map(Fp);if(!n.length)return{total:t.length,hits:0,ratio:0,matched:[]};let i=t.filter(s=>n.some(o=>o.test(s)));return{total:t.length,hits:i.length,ratio:t.length?Number((i.length/t.length).toFixed(4)):0,matched:i}}function Gp(r,e){let t=(Array.isArray(r)?r:[]).map(Number).filter(s=>Number.isFinite(s)),n=Number(e);if(!t.length||!Number.isFinite(n))return null;let i=t.filter(s=>s<=n).length;return Number((i/t.length*100).toFixed(1))}var os={id:"code-stats",serverName:"code_stats",allowedTools:["mcp__code_stats__*"],description:"Deterministic code statistics \u2014 pure, reproducible facts from changed-file lists + numbers (extension/work-kind mix, size bucket, core-path glob coverage, percentile rank). Zero LLM, zero network.",promptFragment:`## Code Stats (DETERMINISTIC facts \u2014 pure, reproducible, zero-LLM)
805
804
  These tools COMPUTE reproducible facts from data you already have. Use them so
806
805
  your numbers are auditable and survive challenge (same input \u2192 same output).
807
806
 
@@ -830,7 +829,7 @@ notify. Post brief milestones so they know it's alive:
830
829
  you have it (provider + chatId); otherwise it resolves from the runtime.
831
830
  Fire-and-forget \u2014 if it can't post, just keep working; never treat a failed
832
831
  progress ping as an error.`,resolve(){let r=Zp();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","SLACK_BOT_TOKEN","SLACK_TEAM_ID","ZIBBY_PROGRESS_PROVIDER","ZIBBY_PROGRESS_CHAT_ID","ZIBBY_PROGRESS_MENTION","SLACK_CHANNEL","LARK_RECEIVE_ID"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/chatProgress.js","chatProgressSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){if(r!=="report_progress")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=String(e?.message||"").trim().slice(0,2e3);if(!t)return JSON.stringify({ok:!1,skipped:"empty message"});let{provider:n,chatId:i,mention:s}=Vp(e);if(!n||!i)return JSON.stringify({ok:!1,skipped:"no chat target"});let o=s&&n==="slack"?`<@${s}> ${t}`:t,a;n==="lark"?a=await D.handleToolCall("lark_send_message",{receive_id:i,text:t}):a=await $.handleToolCall("slack_post_message",{channel:i,text:o});let c=null;try{c=JSON.parse(a)}catch{}return c&&c.error?JSON.stringify({ok:!1,skipped:`post failed: ${c.error}`}):JSON.stringify({ok:!0,provider:n,posted:!0})}catch(t){return JSON.stringify({ok:!1,skipped:`error: ${t.message}`})}},tools:[{name:"report_progress",description:"Post a ONE-LINE progress status to the chat that triggered this run (so the human sees the long job is alive). Fire-and-forget \u2014 never fails the run. Target resolves from your notify input (provider + chatId) or the runtime; you usually just pass the message.",input_schema:{type:"object",properties:{message:{type:"string",description:'A short human status line, e.g. "Scored 60/188 commits, continuing\u2026".'},provider:{type:"string",enum:["lark","slack"],description:"Optional \u2014 the chat provider (from your notify input). Defaults from the runtime."},chatId:{type:"string",description:"Optional \u2014 the target chat/channel id (from your notify input). Defaults from the runtime."}},required:["message"]}}]};import{createRequire as Qp}from"node:module";import{existsSync as ps,mkdirSync as Xp,writeFileSync as cs}from"node:fs";import{dirname as us,join as Me,resolve as ms}from"node:path";import{fileURLToPath as fs}from"node:url";var eu=Qp(import.meta.url),Ir=null;function tu(){return Ir||(Ir=eu("@resvg/resvg-js")),Ir}var hs=1200,ru=627,nu=4096,iu=320,su="#3b82f6",Re="Noto Sans",ou=3;function au(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=us(fs(import.meta.url)),e=ms(r,"..","bin","mcp-skill.mjs");return ps(e)?e:null}function cu(){let r=us(fs(import.meta.url)),e=ms(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(t=>Me(e,t)).filter(t=>ps(t))}function lu(){let r=process.env.ZIBBY_NODE_SESSION_PATH,e=process.env.ZIBBY_SESSION_PATH,t=r||(e?Me(e,"social-card"):Me(process.cwd(),".zibby","output","social-cards"));return Xp(t,{recursive:!0}),t}function ls(r,e){let t=Number(r);return Number.isFinite(t)?Math.max(iu,Math.min(nu,Math.round(t))):e}function De(r){return String(r??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function du(r){return typeof r!="string"?null:r.trim().replace(/\.(png|svg)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function pu(r,e){if(typeof r!="string")return e;let t=r.trim();return/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(t)?t:e}function ys(r,e,t){return String(r).length*e*t}function vr(r,e,t,n){let i=String(r).trim().split(/\s+/).filter(Boolean),s=[],o="";for(let a of i){let c=o?`${o} ${a}`:a;o&&ys(c,t,n)>e?(s.push(o),o=a):o=c}return o&&s.push(o),s.length?s:[""]}function uu(r){return r==="light"?{bg:"#ffffff",fg:"#0b0f14",muted:"#5b6673",pillText:"#0b0f14",checkFg:"#ffffff",divider:"#e2e6ea"}:{bg:"#0b0f14",fg:"#e9edf1",muted:"#8b98a5",pillText:"#e9edf1",checkFg:"#0b0f14",divider:"#22303c"}}function ds(r,e,t,n,i){let s=(Array.isArray(r)?r:[]).map(b=>String(b??"").trim()).filter(Boolean).slice(0,ou);if(s.length<2)return null;let o=24,a=54,c=26,d=90,l=17,p=s.map(b=>Math.max(96,ys(b,o,.58)+c*2)),u=p.reduce((b,g)=>b+g,0)+d*(s.length-1),m=e-u/2,f=t+a/2,h=[];for(let b=0;b<s.length;b++){let g=p[b];if(h.push(`<rect x="${m.toFixed(1)}" y="${t}" width="${g.toFixed(1)}" height="${a}" rx="${a/2}" fill="${i}" fill-opacity="0.12" stroke="${i}" stroke-opacity="0.55" stroke-width="1.5"/>`,`<text x="${(m+g/2).toFixed(1)}" y="${(f+o*.35).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${o}" font-weight="700" fill="${n.pillText}">${De(s[b])}</text>`),m+=g,b<s.length-1){let _=m,y=m+d,k=(_+y)/2;h.push(`<line x1="${_.toFixed(1)}" y1="${f}" x2="${y.toFixed(1)}" y2="${f}" stroke="${i}" stroke-opacity="0.55" stroke-width="2"/>`,`<circle cx="${k.toFixed(1)}" cy="${f}" r="${l}" fill="${i}"/>`,`<path d="M ${(k-8).toFixed(1)} ${f.toFixed(1)} l 5 5 l 9 -11" fill="none" stroke="${n.checkFg}" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>`),m=y}}return{svg:h.join(`
833
- `),height:a}}function mu(r){let{width:e,height:t,theme:n,accent:i}=r,s=uu(n),o=e/2,a=Math.round(e*.07),c=e-a*2,d=String(r.headline).trim(),l=r.eyebrow?String(r.eyebrow).trim().toUpperCase():"",p=r.subhead?String(r.subhead).trim():"",u=r.stat?String(r.stat).trim():"",m=r.footer?String(r.footer).trim():"",f=e/hs,h=Math.round(22*f),b=Math.round(29*f),g=p?vr(p,c,b,.52):[],_=Math.round(b*1.28),y=4,k=Math.round(26*f),O=Math.round(20*f),H=Math.round(24*f),Ee=Math.round(30*f),A=!!(u||m),T=a,B=A?Math.round(110*f):a,x=t-T-B,_e=ds(r.diagram,o,0,s,i),Br=(P,pe)=>{let Ke=y+k;return l&&(Ke+=h+O),Ke+=pe.length*Math.round(P*1.16),g.length&&(Ke+=H+g.length*_),_e&&(Ke+=Ee+_e.height),Ke},Kt=[76,66,58,50,44,38].map(P=>Math.round(P*f)),Xs=4,xe=Kt[Kt.length-1],Gt=vr(d,c,xe,.6);for(let P of Kt){let pe=vr(d,c,P,.6);if(pe.length<=Xs&&Br(P,pe)<=x){xe=P,Gt=pe;break}}let eo=Math.round(xe*1.16),to=Br(xe,Gt),z=T+Math.max(0,(x-to)/2),se=[];se.push(`<rect x="0" y="0" width="${e}" height="${t}" fill="${s.bg}"/>`);let Dr=Math.round(60*f);se.push(`<rect x="${(o-Dr/2).toFixed(1)}" y="${z}" width="${Dr}" height="${y}" rx="2" fill="${i}"/>`),z+=y+k,l&&(se.push(`<text x="${o}" y="${(z+h*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${h}" font-weight="700" letter-spacing="3" fill="${i}">${De(l)}</text>`),z+=h+O);for(let P of Gt)se.push(`<text x="${o}" y="${(z+xe*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${xe}" font-weight="700" fill="${s.fg}">${De(P)}</text>`),z+=eo;if(g.length){z+=H;for(let P of g)se.push(`<text x="${o}" y="${(z+b*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${b}" font-weight="400" fill="${s.muted}">${De(P)}</text>`),z+=_}if(_e){z+=Ee;let P=ds(r.diagram,o,z,s,i);P&&se.push(P.svg)}if(A){let P=Math.round(24*f),pe=t-Math.round(46*f);m&&se.push(`<text x="${a}" y="${pe}" text-anchor="start" font-family="${Re}" font-size="${P}" font-weight="400" fill="${s.muted}">${De(m)}</text>`),u&&se.push(`<text x="${e-a}" y="${pe}" text-anchor="end" font-family="${Re}" font-size="${P}" font-weight="700" fill="${i}">${De(u)}</text>`)}return`<svg xmlns="http://www.w3.org/2000/svg" width="${e}" height="${t}" viewBox="0 0 ${e} ${t}">
832
+ `),height:a}}function mu(r){let{width:e,height:t,theme:n,accent:i}=r,s=uu(n),o=e/2,a=Math.round(e*.07),c=e-a*2,d=String(r.headline).trim(),l=r.eyebrow?String(r.eyebrow).trim().toUpperCase():"",p=r.subhead?String(r.subhead).trim():"",u=r.stat?String(r.stat).trim():"",m=r.footer?String(r.footer).trim():"",f=e/hs,h=Math.round(22*f),b=Math.round(29*f),g=p?vr(p,c,b,.52):[],_=Math.round(b*1.28),y=4,k=Math.round(26*f),O=Math.round(20*f),H=Math.round(24*f),Ee=Math.round(30*f),A=!!(u||m),T=a,q=A?Math.round(110*f):a,x=t-T-q,_e=ds(r.diagram,o,0,s,i),qr=(P,pe)=>{let Ke=y+k;return l&&(Ke+=h+O),Ke+=pe.length*Math.round(P*1.16),g.length&&(Ke+=H+g.length*_),_e&&(Ke+=Ee+_e.height),Ke},Kt=[76,66,58,50,44,38].map(P=>Math.round(P*f)),Xs=4,xe=Kt[Kt.length-1],Gt=vr(d,c,xe,.6);for(let P of Kt){let pe=vr(d,c,P,.6);if(pe.length<=Xs&&qr(P,pe)<=x){xe=P,Gt=pe;break}}let eo=Math.round(xe*1.16),to=qr(xe,Gt),z=T+Math.max(0,(x-to)/2),se=[];se.push(`<rect x="0" y="0" width="${e}" height="${t}" fill="${s.bg}"/>`);let Dr=Math.round(60*f);se.push(`<rect x="${(o-Dr/2).toFixed(1)}" y="${z}" width="${Dr}" height="${y}" rx="2" fill="${i}"/>`),z+=y+k,l&&(se.push(`<text x="${o}" y="${(z+h*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${h}" font-weight="700" letter-spacing="3" fill="${i}">${De(l)}</text>`),z+=h+O);for(let P of Gt)se.push(`<text x="${o}" y="${(z+xe*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${xe}" font-weight="700" fill="${s.fg}">${De(P)}</text>`),z+=eo;if(g.length){z+=H;for(let P of g)se.push(`<text x="${o}" y="${(z+b*.82).toFixed(1)}" text-anchor="middle" font-family="${Re}" font-size="${b}" font-weight="400" fill="${s.muted}">${De(P)}</text>`),z+=_}if(_e){z+=Ee;let P=ds(r.diagram,o,z,s,i);P&&se.push(P.svg)}if(A){let P=Math.round(24*f),pe=t-Math.round(46*f);m&&se.push(`<text x="${a}" y="${pe}" text-anchor="start" font-family="${Re}" font-size="${P}" font-weight="400" fill="${s.muted}">${De(m)}</text>`),u&&se.push(`<text x="${e-a}" y="${pe}" text-anchor="end" font-family="${Re}" font-size="${P}" font-weight="700" fill="${i}">${De(u)}</text>`)}return`<svg xmlns="http://www.w3.org/2000/svg" width="${e}" height="${t}" viewBox="0 0 ${e} ${t}">
834
833
  ${se.join(`
835
834
  `)}
836
835
  </svg>`}function fu(r){let{Resvg:e}=tu();return new e(r,{font:{fontFiles:cu(),loadSystemFonts:!0,defaultFontFamily:Re}}).render().asPng()}var gs={id:"social-card",serverName:"social_card",allowedTools:["mcp__social_card__*"],description:'Social card \u2014 render a branded LinkedIn "concept card" PNG locally (bold headline + eyebrow + optional stat/footer/diagram); nothing leaves the box',promptFragment:`## Social Card (branded concept card, local)
@@ -847,15 +846,15 @@ fields that capture the ONE key idea of your post:
847
846
  It renders server-side to a PNG in the run's output folder and returns
848
847
  { ok:true, files:[{ path, format:'png', bytes }] }. Pass the returned \`path\` as
849
848
  \`imagePath\` when you draft/publish a LinkedIn post to ATTACH the card as the
850
- post image. No browser, no external service \u2014 the data never leaves the machine.`,resolve({sessionPath:r,nodeName:e}={}){let t=au();if(!t)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&e?Me(r,e):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[t,"../dist/socialCard.js","socialCardSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){if(r!=="social_card_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=e?.headline;if(typeof t!="string"||!t.trim())return JSON.stringify({error:"headline (the big bold line) is required and must be a non-empty string."});let n=ls(e?.width,hs),i=ls(e?.height,ru),s=e?.theme==="light"?"light":"dark",o=pu(e?.accent,su),a;try{a=mu({width:n,height:i,theme:s,accent:o,headline:t,eyebrow:e?.eyebrow,subhead:e?.subhead,stat:e?.stat,footer:e?.footer,diagram:e?.diagram})}catch(m){return JSON.stringify({error:`Card layout failed: ${m.message}`})}let c;try{c=fu(a)}catch(m){return JSON.stringify({error:`PNG rasterization failed: ${m.message}`})}let d=lu(),l=du(e?.filename)||`social-card-${Date.now()}`,p=Me(d,`${l}.png`);cs(p,c);let u=[{path:p,format:"png",bytes:c.length}];if(e?.output==="both"||e?.output==="svg"){let m=Me(d,`${l}.svg`);cs(m,a,"utf-8"),u.push({path:m,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}return JSON.stringify({ok:!0,width:n,height:i,theme:s,files:u})}catch(t){return JSON.stringify({error:`social_card_render failed: ${t.message}`})}},tools:[{name:"social_card_render",description:'Render a BRANDED "concept card" PNG LOCALLY (no external service) from structured fields \u2014 the clean LinkedIn concept-card style: bold headline + small uppercase eyebrow + optional supporting subhead, stat, footer, and an A\u2014\u2713\u2014B diagram. Returns { ok:true, files:[{ path, format:"png", bytes }] }. Pass the returned `path` as `imagePath` to a LinkedIn post tool to attach it as the post image. Example: { "headline":"No more copy-paste between AI tools", "eyebrow":"MY WORKFLOW", "stat":"11.8k stars", "footer":"Apache 2.0", "diagram":["Claude Code","Codex"] }.',input_schema:{type:"object",properties:{headline:{type:"string",description:"REQUIRED. The big, bold line \u2014 the single key idea/takeaway. Word-wrapped + auto-sized."},eyebrow:{type:"string",description:'Small uppercase kicker above the headline (e.g. "MY WORKFLOW", "OPEN SOURCE"). Rendered uppercased in the accent color.'},subhead:{type:"string",description:"One supporting line under the headline (muted)."},stat:{type:"string",description:'Optional stat, shown bottom-right in the accent color (e.g. "11.8k stars", "3x faster").'},footer:{type:"string",description:'Optional footer, shown bottom-left (muted) (e.g. "Apache 2.0", a repo name).'},diagram:{type:"array",items:{type:"string"},description:'Optional 2-3 short labels rendered as a chain of pills joined by a checkmark (A \u2014\u2713\u2014 B), e.g. ["Claude Code","Codex"].'},theme:{type:"string",enum:["dark","light"],description:"Card theme (default 'dark' \u2014 near-black bg, off-white text)."},accent:{type:"string",description:'Accent hex color (e.g. "#f97316"). Defaults to a tasteful blue (#3b82f6).'},width:{type:"number",description:"Image width in px (default 1200 \u2014 LinkedIn 1.91:1 link image)."},height:{type:"number",description:"Image height in px (default 627)."},filename:{type:"string",description:"Optional file basename (no extension); defaults to social-card-<timestamp>."},output:{type:"string",enum:["png","both"],description:"Which file(s) to write (default 'png'; 'both' also writes the .svg)."}},required:["headline"]}}]};import{spawnSync as hu}from"node:child_process";import{existsSync as q,readdirSync as ks,statSync as ws,writeFileSync as Or,mkdirSync as Tr}from"node:fs";import{dirname as Nr,extname as qt,join as C,relative as yu,resolve as Jt}from"node:path";import{tmpdir as Rr}from"node:os";import{fileURLToPath as gu}from"node:url";import{SKILL_META as _u}from"@zibby/skill-ids";import{binPath as bu}from"@zibby/bin-oxlint";import{binPath as ku}from"@zibby/bin-semgrep";function wu(){if(process.env.OXLINT_BIN)return process.env.OXLINT_BIN;try{let r=bu();if(r&&q(r))return r}catch{}return"oxlint"}function Su(){if(process.env.SEMGREP_CORE_BIN)return process.env.SEMGREP_CORE_BIN;try{let r=ku();if(r&&q(r))return r}catch{}return"semgrep-core"}function Iu(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Nr(gu(import.meta.url)),e=Jt(r,"..","bin","mcp-skill.mjs");return q(e)?e:null}var Ss=new Set(["node_modules",".git","dist","build","out","vendor","target",".venv","venv","__pycache__",".next",".turbo","coverage",".zibby"]),vu=400,Nu={plugins:["react","typescript","unicorn","oxc"],categories:{correctness:"error",suspicious:"warn"},rules:{"react/react-in-jsx-scope":"off","react/jsx-max-depth":"off","react/no-array-index-key":"off","react/jsx-key":"error","react/no-unknown-property":"error","no-unused-vars":"warn",eqeqeq:"warn"}},Ou=[".oxlintrc.json",".oxlintrc","oxlint.json"],Ct=null;function Tu(){if(Ct&&q(Ct))return Ct;try{let r=C(Rr(),"zibby-code-scan");Tr(r,{recursive:!0});let e=C(r,"oxlintrc.curated.json");return Or(e,JSON.stringify(Nu),"utf-8"),Ct=e,e}catch{return null}}var Is={".java":"java",".py":"python",".go":"go",".rb":"ruby",".php":"php"},_s=Object.keys(Is),vs={rules:[{id:"zibby-java-command-injection",languages:["java"],severity:"ERROR",message:"Command execution (Runtime.exec / ProcessBuilder) \u2014 command injection risk if the argument is attacker-influenced. Validate/allow-list the input or avoid a shell.",patterns:[{"pattern-either":[{pattern:"Runtime.getRuntime().exec(...)"},{pattern:"new ProcessBuilder(...)"}]}]},{id:"zibby-python-subprocess-shell",languages:["python"],severity:"ERROR",message:"subprocess call with shell=True \u2014 command injection risk. Pass an argv list and shell=False.",pattern:"subprocess.$F(..., shell=True, ...)"},{id:"zibby-python-yaml-load",languages:["python"],severity:"WARNING",message:"yaml.load without a safe loader can instantiate arbitrary Python objects. Use yaml.safe_load.",pattern:"yaml.load(...)"},{id:"zibby-go-command-injection",languages:["go"],severity:"WARNING",message:"os/exec with a non-constant command \u2014 verify the value is not attacker-controlled (command injection).",pattern:"exec.Command($CMD, ...)"},{id:"zibby-ruby-command-injection",languages:["ruby"],severity:"ERROR",message:"Shell/eval execution (system / eval) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...)"},{pattern:"eval(...)"}]}]},{id:"zibby-php-command-injection",languages:["php"],severity:"ERROR",message:"Shell/eval execution (system / exec / shell_exec) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...);"},{pattern:"exec(...);"},{pattern:"shell_exec(...);"}]}]}]},Ru=[".semgrep.yml",".semgrep.yaml","semgrep.yml","semgrep.yaml"],Ut=null;function Au(){if(Ut&&q(Ut))return Ut;try{let r=C(Rr(),"zibby-code-scan");Tr(r,{recursive:!0});let e=C(r,"semgrep.curated.rules.json");return Or(e,JSON.stringify(vs),"utf-8"),Ut=e,e}catch{return null}}function Eu(r){return Ru.map(t=>C(r,t)).find(t=>q(t))||Au()}function xu(r){let e=[];for(let t of Array.isArray(r)?r:[]){if(typeof t!="string"||!t)continue;let n=Is[qt(t).toLowerCase()];if(!n)continue;let i=t.replace(/\\/g,"/");e.push(["CodeTarget",{path:{fpath:i,ppath:`/${i.replace(/^\/+/,"")}`},analyzer:n,products:["sast"]}])}return["Targets",e]}var Lu=0;function ju(r){let e=xu(r),t=e[1].length,n=C(Rr(),"zibby-code-scan");Tr(n,{recursive:!0});let i=C(n,`semgrep.targets.${process.pid}.${Lu++}.json`);return Or(i,JSON.stringify(e),"utf-8"),{path:i,count:t}}function bs(r){let e=typeof r=="string"?r.toUpperCase():"";return e==="ERROR"?"error":e==="INFO"||e==="INVENTORY"||e==="EXPERIMENT"?"info":"warning"}var $u=Object.fromEntries(vs.rules.map(r=>[r.id,r.severity]));function Pu(r,e){if(e)return bs(e);let t=$u[r];return t?bs(t):"warning"}function Cu(r){let e=String(r||""),t=e.indexOf("{");if(t<0)return[];let n;try{n=JSON.parse(e.slice(t))}catch{return[]}return(n&&Array.isArray(n.results)?n.results:[]).map(s=>{if(!s||typeof s!="object")return null;let o=s.start&&typeof s.start=="object"?s.start:{},a=s.extra&&typeof s.extra=="object"?s.extra:{};return{file:s.path||"",line:Number.isFinite(o.line)?o.line:"",severity:Pu(s.check_id,a.severity),rule:s.check_id||"",message:(a.message||"").trim()}}).filter(s=>s&&(s.file||s.message))}function Uu(r,e,t=4e3){let n=new Set(e.map(o=>o.toLowerCase())),i=[r],s=0;for(;i.length;){let o=i.pop(),a;try{a=ks(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(++s>t)return!1;if(c.isDirectory())!Ss.has(c.name)&&!c.name.startsWith(".")&&i.push(C(o,c.name));else if(c.isFile()&&n.has(qt(c.name).toLowerCase()))return!0}}return!1}function Ju(r){let e=String(r||"").trim();if(!e)return[];let t;try{t=JSON.parse(e)}catch{return[]}return(Array.isArray(t)?t:t&&Array.isArray(t.diagnostics)?t.diagnostics:[]).map(i=>{if(!i||typeof i!="object")return null;let s=Array.isArray(i.labels)&&i.labels.length?i.labels[0]:null,o=s&&s.span?s.span:null;return{file:i.filename||o&&o.filename||"",line:o&&Number.isFinite(o.line)?o.line:"",severity:i.severity||"warning",rule:i.code||"",message:i.message||""}}).filter(i=>i&&(i.file||i.message))}function qu(r){let e=String(r||"").trim();if(!e)return[];let t;try{t=JSON.parse(e)}catch{return[]}return Array.isArray(t)?t.map(n=>n&&typeof n=="object"?{file:n.filename||"",line:n.location&&Number.isFinite(n.location.row)?n.location.row:"",severity:"warning",rule:n.code||"",message:n.message||""}:null).filter(n=>n&&(n.file||n.message)):[]}function Bu(r){let e=String(r||"").trim();if(!e)return[];let t=[];for(let n of e.split(`
851
- `)){let i=n.trim();if(!i)continue;let s;try{s=JSON.parse(i)}catch{continue}if(!s||typeof s!="object")continue;let o=s.location||{};t.push({file:o.file||"",line:Number.isFinite(o.line)?o.line:"",severity:s.severity||"warning",rule:s.code||"",message:s.message||""})}return t.filter(n=>n.file||n.message)}var Du=[{id:"oxlint",detect:r=>q(C(r,"package.json")),langs:[".ts",".tsx",".js",".jsx",".mjs",".cjs"],bin:()=>wu(),args:(r,e={})=>{let t=e.baseDir||".",i=Ou.some(o=>q(C(t,o)))?null:Tu();return["--format","json",...i?["--config",i]:[],...r]},parse:Ju},{id:"semgrep",detect:r=>Uu(r,_s),langs:_s,bin:()=>Su(),args:(r,e={})=>{let t=e.baseDir||".",n=Eu(t),{path:i}=ju(r);return[...n?["-rules",n]:[],"-targets",i,"-json"]},parse:Cu},{id:"ruff",detect:r=>q(C(r,"pyproject.toml"))||q(C(r,"requirements.txt"))||q(C(r,"setup.py")),langs:[".py"],bin:()=>process.env.RUFF_BIN||"ruff",args:r=>["check","--output-format","json",...r],parse:qu},{id:"staticcheck",detect:r=>q(C(r,"go.mod")),langs:[".go"],bin:()=>process.env.STATICCHECK_BIN||"staticcheck",args:r=>["-f","json",...r],parse:Bu}];function Mu(r,e,t){let n=[],i=new Set(e.map(o=>o.toLowerCase())),s=[r];for(;s.length&&n.length<t;){let o=s.pop(),a;try{a=ks(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(n.length>=t)break;c.isDirectory()?!Ss.has(c.name)&&!c.name.startsWith(".")&&s.push(C(o,c.name)):c.isFile()&&i.has(qt(c.name).toLowerCase())&&n.push(C(o,c.name))}}return n}function Fu(r,e,t){let n=t.map(a=>yu(e,a)).filter(Boolean);if(!n.length)return{scanner:r.id,skipped:"no matching files"};let i=r.bin(),s=hu(i,r.args(n,{baseDir:e}),{cwd:e,encoding:"utf-8",timeout:180*1e3,maxBuffer:32*1024*1024});if(s.error){let a=s.error.code==="ENOENT"?`binary not installed (${i})`:String(s.error.message||s.error);return{scanner:r.id,skipped:a}}let o=[];try{let a=r.parse(s.stdout,s.stderr,s.status);o=Array.isArray(a)?a.filter(Boolean):[]}catch{o=[]}return{scanner:r.id,filesScanned:n.length,findings:o}}var Ns={id:"code-scan",serverName:"code_scan",meta:_u["code-scan"],allowedTools:["mcp__code_scan__*"],description:"Code scan \u2014 run the RIGHT deterministic linter/analyzer for a checked-out repo (auto-detects the stack: JS/TS\u2192oxlint; Java/Python/Go/Ruby/PHP\u2192semgrep) and return structured findings. Fully local; the code never leaves the box.",promptFragment:`## Code Scan (deterministic linter, auto-detects the stack)
849
+ post image. No browser, no external service \u2014 the data never leaves the machine.`,resolve({sessionPath:r,nodeName:e}={}){let t=au();if(!t)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&e?Me(r,e):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[t,"../dist/socialCard.js","socialCardSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){if(r!=="social_card_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=e?.headline;if(typeof t!="string"||!t.trim())return JSON.stringify({error:"headline (the big bold line) is required and must be a non-empty string."});let n=ls(e?.width,hs),i=ls(e?.height,ru),s=e?.theme==="light"?"light":"dark",o=pu(e?.accent,su),a;try{a=mu({width:n,height:i,theme:s,accent:o,headline:t,eyebrow:e?.eyebrow,subhead:e?.subhead,stat:e?.stat,footer:e?.footer,diagram:e?.diagram})}catch(m){return JSON.stringify({error:`Card layout failed: ${m.message}`})}let c;try{c=fu(a)}catch(m){return JSON.stringify({error:`PNG rasterization failed: ${m.message}`})}let d=lu(),l=du(e?.filename)||`social-card-${Date.now()}`,p=Me(d,`${l}.png`);cs(p,c);let u=[{path:p,format:"png",bytes:c.length}];if(e?.output==="both"||e?.output==="svg"){let m=Me(d,`${l}.svg`);cs(m,a,"utf-8"),u.push({path:m,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}return JSON.stringify({ok:!0,width:n,height:i,theme:s,files:u})}catch(t){return JSON.stringify({error:`social_card_render failed: ${t.message}`})}},tools:[{name:"social_card_render",description:'Render a BRANDED "concept card" PNG LOCALLY (no external service) from structured fields \u2014 the clean LinkedIn concept-card style: bold headline + small uppercase eyebrow + optional supporting subhead, stat, footer, and an A\u2014\u2713\u2014B diagram. Returns { ok:true, files:[{ path, format:"png", bytes }] }. Pass the returned `path` as `imagePath` to a LinkedIn post tool to attach it as the post image. Example: { "headline":"No more copy-paste between AI tools", "eyebrow":"MY WORKFLOW", "stat":"11.8k stars", "footer":"Apache 2.0", "diagram":["Claude Code","Codex"] }.',input_schema:{type:"object",properties:{headline:{type:"string",description:"REQUIRED. The big, bold line \u2014 the single key idea/takeaway. Word-wrapped + auto-sized."},eyebrow:{type:"string",description:'Small uppercase kicker above the headline (e.g. "MY WORKFLOW", "OPEN SOURCE"). Rendered uppercased in the accent color.'},subhead:{type:"string",description:"One supporting line under the headline (muted)."},stat:{type:"string",description:'Optional stat, shown bottom-right in the accent color (e.g. "11.8k stars", "3x faster").'},footer:{type:"string",description:'Optional footer, shown bottom-left (muted) (e.g. "Apache 2.0", a repo name).'},diagram:{type:"array",items:{type:"string"},description:'Optional 2-3 short labels rendered as a chain of pills joined by a checkmark (A \u2014\u2713\u2014 B), e.g. ["Claude Code","Codex"].'},theme:{type:"string",enum:["dark","light"],description:"Card theme (default 'dark' \u2014 near-black bg, off-white text)."},accent:{type:"string",description:'Accent hex color (e.g. "#f97316"). Defaults to a tasteful blue (#3b82f6).'},width:{type:"number",description:"Image width in px (default 1200 \u2014 LinkedIn 1.91:1 link image)."},height:{type:"number",description:"Image height in px (default 627)."},filename:{type:"string",description:"Optional file basename (no extension); defaults to social-card-<timestamp>."},output:{type:"string",enum:["png","both"],description:"Which file(s) to write (default 'png'; 'both' also writes the .svg)."}},required:["headline"]}}]};import{spawnSync as hu}from"node:child_process";import{existsSync as B,readdirSync as ks,statSync as ws,writeFileSync as Or,mkdirSync as Tr}from"node:fs";import{dirname as Nr,extname as Bt,join as C,relative as yu,resolve as Jt}from"node:path";import{tmpdir as Rr}from"node:os";import{fileURLToPath as gu}from"node:url";import{SKILL_META as _u}from"@zibby/skill-ids";import{binPath as bu}from"@zibby/bin-oxlint";import{binPath as ku}from"@zibby/bin-semgrep";function wu(){if(process.env.OXLINT_BIN)return process.env.OXLINT_BIN;try{let r=bu();if(r&&B(r))return r}catch{}return"oxlint"}function Su(){if(process.env.SEMGREP_CORE_BIN)return process.env.SEMGREP_CORE_BIN;try{let r=ku();if(r&&B(r))return r}catch{}return"semgrep-core"}function Iu(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Nr(gu(import.meta.url)),e=Jt(r,"..","bin","mcp-skill.mjs");return B(e)?e:null}var Ss=new Set(["node_modules",".git","dist","build","out","vendor","target",".venv","venv","__pycache__",".next",".turbo","coverage",".zibby"]),vu=400,Nu={plugins:["react","typescript","unicorn","oxc"],categories:{correctness:"error",suspicious:"warn"},rules:{"react/react-in-jsx-scope":"off","react/jsx-max-depth":"off","react/no-array-index-key":"off","react/jsx-key":"error","react/no-unknown-property":"error","no-unused-vars":"warn",eqeqeq:"warn"}},Ou=[".oxlintrc.json",".oxlintrc","oxlint.json"],Ct=null;function Tu(){if(Ct&&B(Ct))return Ct;try{let r=C(Rr(),"zibby-code-scan");Tr(r,{recursive:!0});let e=C(r,"oxlintrc.curated.json");return Or(e,JSON.stringify(Nu),"utf-8"),Ct=e,e}catch{return null}}var Is={".java":"java",".py":"python",".go":"go",".rb":"ruby",".php":"php"},_s=Object.keys(Is),vs={rules:[{id:"zibby-java-command-injection",languages:["java"],severity:"ERROR",message:"Command execution (Runtime.exec / ProcessBuilder) \u2014 command injection risk if the argument is attacker-influenced. Validate/allow-list the input or avoid a shell.",patterns:[{"pattern-either":[{pattern:"Runtime.getRuntime().exec(...)"},{pattern:"new ProcessBuilder(...)"}]}]},{id:"zibby-python-subprocess-shell",languages:["python"],severity:"ERROR",message:"subprocess call with shell=True \u2014 command injection risk. Pass an argv list and shell=False.",pattern:"subprocess.$F(..., shell=True, ...)"},{id:"zibby-python-yaml-load",languages:["python"],severity:"WARNING",message:"yaml.load without a safe loader can instantiate arbitrary Python objects. Use yaml.safe_load.",pattern:"yaml.load(...)"},{id:"zibby-go-command-injection",languages:["go"],severity:"WARNING",message:"os/exec with a non-constant command \u2014 verify the value is not attacker-controlled (command injection).",pattern:"exec.Command($CMD, ...)"},{id:"zibby-ruby-command-injection",languages:["ruby"],severity:"ERROR",message:"Shell/eval execution (system / eval) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...)"},{pattern:"eval(...)"}]}]},{id:"zibby-php-command-injection",languages:["php"],severity:"ERROR",message:"Shell/eval execution (system / exec / shell_exec) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...);"},{pattern:"exec(...);"},{pattern:"shell_exec(...);"}]}]}]},Ru=[".semgrep.yml",".semgrep.yaml","semgrep.yml","semgrep.yaml"],Ut=null;function Au(){if(Ut&&B(Ut))return Ut;try{let r=C(Rr(),"zibby-code-scan");Tr(r,{recursive:!0});let e=C(r,"semgrep.curated.rules.json");return Or(e,JSON.stringify(vs),"utf-8"),Ut=e,e}catch{return null}}function Eu(r){return Ru.map(t=>C(r,t)).find(t=>B(t))||Au()}function xu(r){let e=[];for(let t of Array.isArray(r)?r:[]){if(typeof t!="string"||!t)continue;let n=Is[Bt(t).toLowerCase()];if(!n)continue;let i=t.replace(/\\/g,"/");e.push(["CodeTarget",{path:{fpath:i,ppath:`/${i.replace(/^\/+/,"")}`},analyzer:n,products:["sast"]}])}return["Targets",e]}var Lu=0;function ju(r){let e=xu(r),t=e[1].length,n=C(Rr(),"zibby-code-scan");Tr(n,{recursive:!0});let i=C(n,`semgrep.targets.${process.pid}.${Lu++}.json`);return Or(i,JSON.stringify(e),"utf-8"),{path:i,count:t}}function bs(r){let e=typeof r=="string"?r.toUpperCase():"";return e==="ERROR"?"error":e==="INFO"||e==="INVENTORY"||e==="EXPERIMENT"?"info":"warning"}var $u=Object.fromEntries(vs.rules.map(r=>[r.id,r.severity]));function Pu(r,e){if(e)return bs(e);let t=$u[r];return t?bs(t):"warning"}function Cu(r){let e=String(r||""),t=e.indexOf("{");if(t<0)return[];let n;try{n=JSON.parse(e.slice(t))}catch{return[]}return(n&&Array.isArray(n.results)?n.results:[]).map(s=>{if(!s||typeof s!="object")return null;let o=s.start&&typeof s.start=="object"?s.start:{},a=s.extra&&typeof s.extra=="object"?s.extra:{};return{file:s.path||"",line:Number.isFinite(o.line)?o.line:"",severity:Pu(s.check_id,a.severity),rule:s.check_id||"",message:(a.message||"").trim()}}).filter(s=>s&&(s.file||s.message))}function Uu(r,e,t=4e3){let n=new Set(e.map(o=>o.toLowerCase())),i=[r],s=0;for(;i.length;){let o=i.pop(),a;try{a=ks(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(++s>t)return!1;if(c.isDirectory())!Ss.has(c.name)&&!c.name.startsWith(".")&&i.push(C(o,c.name));else if(c.isFile()&&n.has(Bt(c.name).toLowerCase()))return!0}}return!1}function Ju(r){let e=String(r||"").trim();if(!e)return[];let t;try{t=JSON.parse(e)}catch{return[]}return(Array.isArray(t)?t:t&&Array.isArray(t.diagnostics)?t.diagnostics:[]).map(i=>{if(!i||typeof i!="object")return null;let s=Array.isArray(i.labels)&&i.labels.length?i.labels[0]:null,o=s&&s.span?s.span:null;return{file:i.filename||o&&o.filename||"",line:o&&Number.isFinite(o.line)?o.line:"",severity:i.severity||"warning",rule:i.code||"",message:i.message||""}}).filter(i=>i&&(i.file||i.message))}function Bu(r){let e=String(r||"").trim();if(!e)return[];let t;try{t=JSON.parse(e)}catch{return[]}return Array.isArray(t)?t.map(n=>n&&typeof n=="object"?{file:n.filename||"",line:n.location&&Number.isFinite(n.location.row)?n.location.row:"",severity:"warning",rule:n.code||"",message:n.message||""}:null).filter(n=>n&&(n.file||n.message)):[]}function qu(r){let e=String(r||"").trim();if(!e)return[];let t=[];for(let n of e.split(`
850
+ `)){let i=n.trim();if(!i)continue;let s;try{s=JSON.parse(i)}catch{continue}if(!s||typeof s!="object")continue;let o=s.location||{};t.push({file:o.file||"",line:Number.isFinite(o.line)?o.line:"",severity:s.severity||"warning",rule:s.code||"",message:s.message||""})}return t.filter(n=>n.file||n.message)}var Du=[{id:"oxlint",detect:r=>B(C(r,"package.json")),langs:[".ts",".tsx",".js",".jsx",".mjs",".cjs"],bin:()=>wu(),args:(r,e={})=>{let t=e.baseDir||".",i=Ou.some(o=>B(C(t,o)))?null:Tu();return["--format","json",...i?["--config",i]:[],...r]},parse:Ju},{id:"semgrep",detect:r=>Uu(r,_s),langs:_s,bin:()=>Su(),args:(r,e={})=>{let t=e.baseDir||".",n=Eu(t),{path:i}=ju(r);return[...n?["-rules",n]:[],"-targets",i,"-json"]},parse:Cu},{id:"ruff",detect:r=>B(C(r,"pyproject.toml"))||B(C(r,"requirements.txt"))||B(C(r,"setup.py")),langs:[".py"],bin:()=>process.env.RUFF_BIN||"ruff",args:r=>["check","--output-format","json",...r],parse:Bu},{id:"staticcheck",detect:r=>B(C(r,"go.mod")),langs:[".go"],bin:()=>process.env.STATICCHECK_BIN||"staticcheck",args:r=>["-f","json",...r],parse:qu}];function Mu(r,e,t){let n=[],i=new Set(e.map(o=>o.toLowerCase())),s=[r];for(;s.length&&n.length<t;){let o=s.pop(),a;try{a=ks(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(n.length>=t)break;c.isDirectory()?!Ss.has(c.name)&&!c.name.startsWith(".")&&s.push(C(o,c.name)):c.isFile()&&i.has(Bt(c.name).toLowerCase())&&n.push(C(o,c.name))}}return n}function Fu(r,e,t){let n=t.map(a=>yu(e,a)).filter(Boolean);if(!n.length)return{scanner:r.id,skipped:"no matching files"};let i=r.bin(),s=hu(i,r.args(n,{baseDir:e}),{cwd:e,encoding:"utf-8",timeout:180*1e3,maxBuffer:32*1024*1024});if(s.error){let a=s.error.code==="ENOENT"?`binary not installed (${i})`:String(s.error.message||s.error);return{scanner:r.id,skipped:a}}let o=[];try{let a=r.parse(s.stdout,s.stderr,s.status);o=Array.isArray(a)?a.filter(Boolean):[]}catch{o=[]}return{scanner:r.id,filesScanned:n.length,findings:o}}var Ns={id:"code-scan",serverName:"code_scan",meta:_u["code-scan"],allowedTools:["mcp__code_scan__*"],description:"Code scan \u2014 run the RIGHT deterministic linter/analyzer for a checked-out repo (auto-detects the stack: JS/TS\u2192oxlint; Java/Python/Go/Ruby/PHP\u2192semgrep) and return structured findings. Fully local; the code never leaves the box.",promptFragment:`## Code Scan (deterministic linter, auto-detects the stack)
852
851
  After you've cloned the repo, call \`scan_code\` to get DETERMINISTIC linter
853
852
  findings for WHATEVER stack this repo is \u2014 it auto-detects (JS/TS\u2192oxlint;
854
853
  Java/Python/Go/Ruby/PHP\u2192semgrep) and runs the matching tool. Pass \`files\` (the changed files, ideal for
855
854
  a review) or \`dir\` (a directory to scan). Findings are GROUND-TRUTH CANDIDATES:
856
855
  triage them for THIS change, verify each in context (false positives exist \u2014
857
856
  trace before asserting), fold noise, and turn the real ones into inline
858
- suggestions. Don't hand-lint what the tool already covers, and don't re-run it.`,resolve(){let r=Iu();return r?{type:"stdio",command:"node",args:[r,"../dist/code-scan.js","codeScanSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,e){if(r!=="scan_code")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=Array.isArray(e?.files)?e.files.filter(a=>typeof a=="string"&&a.trim()):null,n;if(e?.dir&&typeof e.dir=="string"?n=Jt(e.dir):t&&t.length?n=Ku(t.map(a=>Jt(a))):n=process.cwd(),!q(n)||!ws(n).isDirectory())return JSON.stringify({error:`dir does not exist or is not a directory: ${n}`});let i=t?t.map(a=>Jt(n,a)):null,s=[],o=0;for(let a of Du){let c=!1;try{c=!!a.detect(n)}catch{c=!1}if(!c)continue;let d=new Set(a.langs.map(u=>u.toLowerCase())),l=i?i.filter(u=>d.has(qt(u).toLowerCase())):Mu(n,a.langs,vu),p=Fu(a,n,l);Array.isArray(p.findings)&&(o+=p.findings.length),s.push(p)}return s.length?JSON.stringify({ok:!0,baseDir:n,totalFindings:o,scanners:s}):JSON.stringify({ok:!0,baseDir:n,scanners:[],totalFindings:0,note:"No known stack detected (no package.json / pyproject / go.mod \u2026). Review by hand."})}catch(t){return JSON.stringify({error:`scan_code failed: ${t.message}`})}},tools:[{name:"scan_code",description:"Run the right deterministic linter for a checked-out repo and return structured findings. Auto-detects the stack (JS/TS \u2192 oxlint; Java/Python/Go/Ruby/PHP \u2192 semgrep OSS) and runs each matching tool, scoped to files in its languages. Pass `files` (e.g. the changed files of the PR \u2014 recommended for a review) OR `dir` (a directory to scan). Returns { scanners: [ { scanner, findings: [ { file, line, severity, rule, message } ] } ] }. Findings are CANDIDATES \u2014 verify each in context before asserting. Best-effort: a stack whose linter is not installed is skipped with a note.",input_schema:{type:"object",properties:{dir:{type:"string",description:"Absolute path to the checked-out repo (or subdirectory) to scan. Defaults to the current working directory."},files:{type:"array",items:{type:"string"},description:"Explicit list of files to scan (paths relative to `dir`, or absolute). Best for a code review \u2014 pass the PR's changed files. When omitted, the whole `dir` is walked (bounded)."}}}}]};function Ku(r){if(!r.length)return process.cwd();if(r.length===1)return Nr(r[0]);let e=r.map(s=>s.split("/")),t=e[0],n=[];for(let s=0;s<t.length;s++){let o=t[s];if(e.every(a=>a[s]===o))n.push(o);else break}let i=n.join("/");return i&&q(i)&&ws(i).isDirectory()?i:Nr(r[0])}import{dirname as Gu,resolve as Hu}from"path";import{fileURLToPath as zu}from"url";import{existsSync as Yu}from"fs";function Wu(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Gu(zu(import.meta.url)),e=Hu(r,"..","bin","mcp-skill.mjs");return Yu(e)?e:null}function Zu(){return process.env.PROJECT_API_TOKEN||process.env.ZIBBY_USER_TOKEN||null}function Vu(){return((process.env.PROGRESS_API_URL||"").replace(/\/executions\/?$/,"")||process.env.ZIBBY_ACCOUNT_API_URL||process.env.ZIBBY_PROD_ACCOUNT_API_URL||(process.env.ZIBBY_ENV==="local"?"http://localhost:3001":"https://api-prod.zibby.app")).replace(/\/+$/,"")}var Qu={name:"trigger_agent",description:"Trigger another Zibby workflow/agent run in THIS project (fire-and-forget). Call it once per run you want to start \u2014 the agent decides which and how many. Omit workflowType to re-run THIS same agent (self-dispatch, e.g. with a different trigger input). Returns the started run's executionId; does NOT wait for it to finish.",input_schema:{type:"object",properties:{workflowType:{type:"string",description:"Which workflow to trigger (its type/slug in this project). Omit to trigger THIS same agent (self-dispatch)."},input:{type:"object",description:"The trigger payload passed to the target workflow (validated against its state schema)."}},required:[]}},Os={id:"trigger-agent",serverName:"trigger",allowedTools:["mcp__trigger__*"],envKeys:[],description:"Trigger another Zibby workflow/agent run in this project (agent-driven, fire-and-forget; cloud + self-hosted).",promptFragment:"## Trigger another agent (agent-driven)\nYou can start another Zibby agent run yourself with the `trigger_agent`\ntool \u2014 and YOU decide when and how many times to call it. Each call starts ONE\nindependent run (fire-and-forget) and returns its executionId; it does NOT wait for\nthat run to finish.\n- To re-run THIS same agent (self-dispatch) \u2014 e.g. to hand an item to another of\n this agent's scenarios \u2014 OMIT `workflowType` and pass the `input` for that run.\n- To trigger a DIFFERENT agent in the project, pass its `workflowType` + `input`.\nCall it once per run you want to start (loop over your items and call it for each).\nIt never throws \u2014 a failure comes back as { ok:false, error }; log it and move on.",resolve(){let r=Wu();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","PROJECT_ID","WORKFLOW_TYPE","PROGRESS_API_URL","ZIBBY_ACCOUNT_API_URL","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_USER_TOKEN"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/triggerAgent.js","triggerAgentSkill"],env:e,description:this.description,alwaysLoad:!1}},async handleToolCall(r,e={}){if(r!=="trigger_agent")return JSON.stringify({ok:!1,error:`unknown tool: ${r}`});try{let t=process.env.PROJECT_ID,n=Zu(),i=typeof e.workflowType=="string"&&e.workflowType.trim()?e.workflowType.trim():(process.env.WORKFLOW_TYPE||"").trim();if(!t)return JSON.stringify({ok:!1,error:"PROJECT_ID not set \u2014 cannot resolve the target project."});if(!n)return JSON.stringify({ok:!1,error:"PROJECT_API_TOKEN not set \u2014 cannot authenticate the trigger."});if(!i)return JSON.stringify({ok:!1,error:"No workflowType given and WORKFLOW_TYPE is unset \u2014 nothing to trigger."});let s=`${Vu()}/projects/${encodeURIComponent(t)}/workflows/${encodeURIComponent(i)}/trigger`,o=new AbortController,a=setTimeout(()=>o.abort(),2e4),c;try{c=await fetch(s,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${n}`},body:JSON.stringify({input:e.input&&typeof e.input=="object"?e.input:{}}),signal:o.signal})}finally{clearTimeout(a)}let d=await c.text().catch(()=>""),l;try{l=d?JSON.parse(d):{}}catch{l={raw:d}}if(!c.ok)return JSON.stringify({ok:!1,error:`trigger failed (HTTP ${c.status})`,detail:l&&(l.error||l.message)||d.slice(0,300)});let p=l.executionId||l.execution?.id||l.id||null;return JSON.stringify({ok:!0,workflowType:i,executionId:p,note:"run started (fire-and-forget)"})}catch(t){return JSON.stringify({ok:!1,error:`trigger_agent failed: ${t?.message||String(t)}`})}},tools:[Qu]};import{spawnSync as Xu}from"node:child_process";import{existsSync as Ar,mkdirSync as Ts,readdirSync as em,writeFileSync as tm}from"node:fs";import{createHash as rm}from"node:crypto";import{join as Bt}from"node:path";import{SKILL_META as nm}from"@zibby/skill-ids";function Rs(){return process.env.CBM_BIN||"/usr/local/bin/codebase-memory-mcp"}function As(){if(process.env.CBM_CACHE_DIR)return process.env.CBM_CACHE_DIR;let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE;return r?Bt(r,".zibby","cbm-cache"):"/tmp/zibby-cbm-cache"}function im(){let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE||"/workspace",e=Bt(r,".zibby","repos");try{if(Ar(e)){let t=em(e,{withFileTypes:!0}).filter(n=>n.isDirectory()).map(n=>Bt(e,n.name));if(t.length===1)return t[0];if(t.length>1)return e}}catch{}return null}function sm(r){return rm("sha256").update(r).digest("hex").slice(0,16)}var Es={id:"codebase-memory",serverName:"codebase_memory",meta:nm["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)
857
+ suggestions. Don't hand-lint what the tool already covers, and don't re-run it.`,resolve(){let r=Iu();return r?{type:"stdio",command:"node",args:[r,"../dist/code-scan.js","codeScanSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,e){if(r!=="scan_code")return JSON.stringify({error:`Unknown tool: ${r}`});try{let t=Array.isArray(e?.files)?e.files.filter(a=>typeof a=="string"&&a.trim()):null,n;if(e?.dir&&typeof e.dir=="string"?n=Jt(e.dir):t&&t.length?n=Ku(t.map(a=>Jt(a))):n=process.cwd(),!B(n)||!ws(n).isDirectory())return JSON.stringify({error:`dir does not exist or is not a directory: ${n}`});let i=t?t.map(a=>Jt(n,a)):null,s=[],o=0;for(let a of Du){let c=!1;try{c=!!a.detect(n)}catch{c=!1}if(!c)continue;let d=new Set(a.langs.map(u=>u.toLowerCase())),l=i?i.filter(u=>d.has(Bt(u).toLowerCase())):Mu(n,a.langs,vu),p=Fu(a,n,l);Array.isArray(p.findings)&&(o+=p.findings.length),s.push(p)}return s.length?JSON.stringify({ok:!0,baseDir:n,totalFindings:o,scanners:s}):JSON.stringify({ok:!0,baseDir:n,scanners:[],totalFindings:0,note:"No known stack detected (no package.json / pyproject / go.mod \u2026). Review by hand."})}catch(t){return JSON.stringify({error:`scan_code failed: ${t.message}`})}},tools:[{name:"scan_code",description:"Run the right deterministic linter for a checked-out repo and return structured findings. Auto-detects the stack (JS/TS \u2192 oxlint; Java/Python/Go/Ruby/PHP \u2192 semgrep OSS) and runs each matching tool, scoped to files in its languages. Pass `files` (e.g. the changed files of the PR \u2014 recommended for a review) OR `dir` (a directory to scan). Returns { scanners: [ { scanner, findings: [ { file, line, severity, rule, message } ] } ] }. Findings are CANDIDATES \u2014 verify each in context before asserting. Best-effort: a stack whose linter is not installed is skipped with a note.",input_schema:{type:"object",properties:{dir:{type:"string",description:"Absolute path to the checked-out repo (or subdirectory) to scan. Defaults to the current working directory."},files:{type:"array",items:{type:"string"},description:"Explicit list of files to scan (paths relative to `dir`, or absolute). Best for a code review \u2014 pass the PR's changed files. When omitted, the whole `dir` is walked (bounded)."}}}}]};function Ku(r){if(!r.length)return process.cwd();if(r.length===1)return Nr(r[0]);let e=r.map(s=>s.split("/")),t=e[0],n=[];for(let s=0;s<t.length;s++){let o=t[s];if(e.every(a=>a[s]===o))n.push(o);else break}let i=n.join("/");return i&&B(i)&&ws(i).isDirectory()?i:Nr(r[0])}import{dirname as Gu,resolve as Hu}from"path";import{fileURLToPath as zu}from"url";import{existsSync as Yu}from"fs";function Wu(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Gu(zu(import.meta.url)),e=Hu(r,"..","bin","mcp-skill.mjs");return Yu(e)?e:null}function Zu(){return process.env.PROJECT_API_TOKEN||process.env.ZIBBY_USER_TOKEN||null}function Vu(){return((process.env.PROGRESS_API_URL||"").replace(/\/executions\/?$/,"")||process.env.ZIBBY_ACCOUNT_API_URL||process.env.ZIBBY_PROD_ACCOUNT_API_URL||(process.env.ZIBBY_ENV==="local"?"http://localhost:3001":"https://api-prod.zibby.app")).replace(/\/+$/,"")}var Qu={name:"trigger_agent",description:"Trigger another Zibby workflow/agent run in THIS project (fire-and-forget). Call it once per run you want to start \u2014 the agent decides which and how many. Omit workflowType to re-run THIS same agent (self-dispatch, e.g. with a different trigger input). Returns the started run's executionId; does NOT wait for it to finish.",input_schema:{type:"object",properties:{workflowType:{type:"string",description:"Which workflow to trigger (its type/slug in this project). Omit to trigger THIS same agent (self-dispatch)."},input:{type:"object",description:"The trigger payload passed to the target workflow (validated against its state schema)."}},required:[]}},Os={id:"trigger-agent",serverName:"trigger",allowedTools:["mcp__trigger__*"],envKeys:[],description:"Trigger another Zibby workflow/agent run in this project (agent-driven, fire-and-forget; cloud + self-hosted).",promptFragment:"## Trigger another agent (agent-driven)\nYou can start another Zibby agent run yourself with the `trigger_agent`\ntool \u2014 and YOU decide when and how many times to call it. Each call starts ONE\nindependent run (fire-and-forget) and returns its executionId; it does NOT wait for\nthat run to finish.\n- To re-run THIS same agent (self-dispatch) \u2014 e.g. to hand an item to another of\n this agent's scenarios \u2014 OMIT `workflowType` and pass the `input` for that run.\n- To trigger a DIFFERENT agent in the project, pass its `workflowType` + `input`.\nCall it once per run you want to start (loop over your items and call it for each).\nIt never throws \u2014 a failure comes back as { ok:false, error }; log it and move on.",resolve(){let r=Wu();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","PROJECT_ID","WORKFLOW_TYPE","PROGRESS_API_URL","ZIBBY_ACCOUNT_API_URL","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_USER_TOKEN"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/triggerAgent.js","triggerAgentSkill"],env:e,description:this.description,alwaysLoad:!1}},async handleToolCall(r,e={}){if(r!=="trigger_agent")return JSON.stringify({ok:!1,error:`unknown tool: ${r}`});try{let t=process.env.PROJECT_ID,n=Zu(),i=typeof e.workflowType=="string"&&e.workflowType.trim()?e.workflowType.trim():(process.env.WORKFLOW_TYPE||"").trim();if(!t)return JSON.stringify({ok:!1,error:"PROJECT_ID not set \u2014 cannot resolve the target project."});if(!n)return JSON.stringify({ok:!1,error:"PROJECT_API_TOKEN not set \u2014 cannot authenticate the trigger."});if(!i)return JSON.stringify({ok:!1,error:"No workflowType given and WORKFLOW_TYPE is unset \u2014 nothing to trigger."});let s=`${Vu()}/projects/${encodeURIComponent(t)}/workflows/${encodeURIComponent(i)}/trigger`,o=new AbortController,a=setTimeout(()=>o.abort(),2e4),c;try{c=await fetch(s,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${n}`},body:JSON.stringify({input:e.input&&typeof e.input=="object"?e.input:{}}),signal:o.signal})}finally{clearTimeout(a)}let d=await c.text().catch(()=>""),l;try{l=d?JSON.parse(d):{}}catch{l={raw:d}}if(!c.ok)return JSON.stringify({ok:!1,error:`trigger failed (HTTP ${c.status})`,detail:l&&(l.error||l.message)||d.slice(0,300)});let p=l.executionId||l.execution?.id||l.id||null;return JSON.stringify({ok:!0,workflowType:i,executionId:p,note:"run started (fire-and-forget)"})}catch(t){return JSON.stringify({ok:!1,error:`trigger_agent failed: ${t?.message||String(t)}`})}},tools:[Qu]};import{spawnSync as Xu}from"node:child_process";import{existsSync as Ar,mkdirSync as Ts,readdirSync as em,writeFileSync as tm}from"node:fs";import{createHash as rm}from"node:crypto";import{join as qt}from"node:path";import{SKILL_META as nm}from"@zibby/skill-ids";function Rs(){return process.env.CBM_BIN||"/usr/local/bin/codebase-memory-mcp"}function As(){if(process.env.CBM_CACHE_DIR)return process.env.CBM_CACHE_DIR;let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE;return r?qt(r,".zibby","cbm-cache"):"/tmp/zibby-cbm-cache"}function im(){let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE||"/workspace",e=qt(r,".zibby","repos");try{if(Ar(e)){let t=em(e,{withFileTypes:!0}).filter(n=>n.isDirectory()).map(n=>qt(e,n.name));if(t.length===1)return t[0];if(t.length>1)return e}}catch{}return null}function sm(r){return rm("sha256").update(r).digest("hex").slice(0,16)}var Es={id:"codebase-memory",serverName:"codebase_memory",meta:nm["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)
859
858
  The checked-out repository is indexed into a queryable code graph + semantic
860
859
  index. Reach for these instead of blindly grepping when you need structure,
861
860
  relationships, or "where does X live / what depends on Y":
@@ -867,7 +866,7 @@ relationships, or "where does X live / what depends on Y":
867
866
  - get_code_snippet / search_code: pull the exact code for a node / text match.
868
867
  - index_status / list_projects: confirm the index is present before querying.
869
868
  The repo is indexed for you at the start of the run; if a query comes back
870
- empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let r=As();try{Ts(r,{recursive:!0})}catch{}let e={CBM_CACHE_DIR:r};return process.env.WORKSPACE&&(e.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:Rs(),args:[],env:e,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let r=im();if(!r)return{};let e=As();try{Ts(e,{recursive:!0})}catch{}let t=Bt(e,`.cbm-indexed-${sm(r)}`);if(Ar(t))return{};let n=Rs();if(!Ar(n)&&!process.env.CBM_BIN)return{};let i=Xu(n,["cli","index_repository",JSON.stringify({repo_path:r})],{env:{...process.env,CBM_CACHE_DIR:e},encoding:"utf-8",timeout:300*1e3,maxBuffer:32*1024*1024});try{tm(t,`${new Date().toISOString()} status=${i.status}
869
+ empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let r=As();try{Ts(r,{recursive:!0})}catch{}let e={CBM_CACHE_DIR:r};return process.env.WORKSPACE&&(e.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:Rs(),args:[],env:e,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let r=im();if(!r)return{};let e=As();try{Ts(e,{recursive:!0})}catch{}let t=qt(e,`.cbm-indexed-${sm(r)}`);if(Ar(t))return{};let n=Rs();if(!Ar(n)&&!process.env.CBM_BIN)return{};let i=Xu(n,["cli","index_repository",JSON.stringify({repo_path:r})],{env:{...process.env,CBM_CACHE_DIR:e},encoding:"utf-8",timeout:300*1e3,maxBuffer:32*1024*1024});try{tm(t,`${new Date().toISOString()} status=${i.status}
871
870
  `)}catch{}}catch{}return{}}};import{existsSync as xs,readFileSync as om}from"node:fs";import{homedir as am}from"node:os";import{join as cm,dirname as lm,resolve as dm}from"node:path";import{fileURLToPath as pm}from"node:url";import{SKILL_META as um}from"@zibby/skill-ids";var mm=3e4,Er=1;function fm(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=lm(pm(import.meta.url)),e=dm(r,"..","bin","mcp-skill.mjs");return xs(e)?e:null}function hm(){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 r=cm(am(),".zibby","config.json");return xs(r)&&JSON.parse(om(r,"utf-8")).sessionToken||null}catch{return null}}function ym(){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 gm(){let r={};for(let[e,t]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(e);if(!n)continue;let i=typeof t=="string"?t.trim():"";i&&(r[n[1]]=i)}return r}function xr(r){let e=gm(),t=Object.keys(e),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(e,n)?{storeId:e[n],name:n}:{error:`unknown store '${n}'; available: ${t.join(", ")}`}:t.length===1?{storeId:e[t[0]],name:t[0]}:t.length===0?{error:"no knowledge-base store is bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${t.join(", ")})`}}async function Lr(r,e,t){let n=hm();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). The knowledge base is only available inside a Zibby run.");let i=`${ym()}/datasets/stores/${encodeURIComponent(r)}/${e}`,s={Authorization:`Bearer ${n}`,"Content-Type":"application/json"},o=JSON.stringify(t),a;for(let c=0;c<=Er;c++){let d=new AbortController,l=setTimeout(()=>d.abort(),mm);try{let p=await fetch(i,{method:"POST",headers:s,body:o,signal:d.signal}),u=await p.text().catch(()=>"");if(p.status>=500&&c<Er){a=new Error(`store ${p.status}`);continue}if(!p.ok)throw new Error(`gbrain ${e} failed (${p.status}): ${u.slice(0,300)}`);try{return JSON.parse(u)}catch{throw new Error(`store returned non-JSON: ${u.slice(0,200)}`)}}catch(p){if(a=p,!((p?.name==="AbortError"||p?.code==="ECONNREFUSED"||/fetch failed|network/i.test(String(p?.message)))&&c<Er))break}finally{clearTimeout(l)}}throw a||new Error(`gbrain ${e} request failed`)}var Ls={id:"gbrain",serverName:"gbrain",allowedTools:["mcp__gbrain__*"],meta:um.gbrain,description:"Knowledge base (GBrain) \u2014 ingest source documents into, semantically query, and prune a per-tenant Postgres/pgvector brain (a `postgres`-type store, brokered by the control-plane)",promptFragment:`## Knowledge Base (GBrain \u2014 per-tenant document brain)
872
871
  You have a per-tenant KNOWLEDGE BASE (a Postgres + pgvector "brain"), bound as a
873
872
  \`postgres\`-type store in the "AVAILABLE STORES" block below. Ingested documents
@@ -989,7 +988,7 @@ Call with no arguments to see all available topics.
989
988
  - Workflow names must be kebab-case (e.g., ticket-triage, pr-review).
990
989
  - State flows through: each node's validated output is stored under its name in state (e.g., state.classify_ticket).
991
990
  - Downstream nodes reference upstream outputs in their prompt function (e.g., \\\`\\\${JSON.stringify(state.classify_ticket, null, 2)}\\\`).
992
- - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Js=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function qs(r){return`${r.split("-").map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join("")}Workflow`}function rt(r){return`${r.replace(/_([a-z])/g,(e,t)=>t.toUpperCase())}Node`}function Im(r){let e=r?.agent;return e?e.provider?e.provider:e.gemini?"gemini":e.codex?"codex":e.claude?"claude":e.cursor?"cursor":process.env.AGENT_TYPE||"cursor":process.env.AGENT_TYPE||"cursor"}async function vm(r){let e=$r(r,".zibby.config.mjs");if(!de(e))return{};try{return(await import(e)).default||{}}catch{return{}}}function Nm(){try{let r=Us(wm.resolve("@zibby/core/package.json")),e=E(r,"templates","browser-test-automation"),t=nt(E(e,"nodes","preflight.mjs"),"utf-8"),n=nt(E(e,"graph.mjs"),"utf-8");return{preflight:t,graph:n}}catch{return null}}var js=Us(bm(import.meta.url));function Bs(){let r=$r(js,"..","..","..","docsite","docs");if(de(r))return r;let e=$r(js,"..","docs");return de(e)?e:null}function $s(){let r=Bs();if(!r)return[];try{let e=(t,n="")=>{let i=[];for(let s of jr(t)){let o=E(t,s);try{if(Ps(o).isDirectory())i=i.concat(e(o,`${n}${s}/`));else if(s.endsWith(".md")){let a=`${n}${s.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return e(r)}catch{return[]}}function Ds(r){let e=Bs();if(!e)return null;let t=E(e,`${r}.md`);if(!de(t))return null;try{return nt(t,"utf-8")}catch{return null}}function Om(r){let e=r.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(`
991
+ - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Js=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function Bs(r){return`${r.split("-").map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join("")}Workflow`}function rt(r){return`${r.replace(/_([a-z])/g,(e,t)=>t.toUpperCase())}Node`}function Im(r){let e=r?.agent;return e?e.provider?e.provider:e.gemini?"gemini":e.codex?"codex":e.claude?"claude":e.cursor?"cursor":process.env.AGENT_TYPE||"cursor":process.env.AGENT_TYPE||"cursor"}async function vm(r){let e=$r(r,".zibby.config.mjs");if(!de(e))return{};try{return(await import(e)).default||{}}catch{return{}}}function Nm(){try{let r=Us(wm.resolve("@zibby/core/package.json")),e=E(r,"templates","browser-test-automation"),t=nt(E(e,"nodes","preflight.mjs"),"utf-8"),n=nt(E(e,"graph.mjs"),"utf-8");return{preflight:t,graph:n}}catch{return null}}var js=Us(bm(import.meta.url));function qs(){let r=$r(js,"..","..","..","docsite","docs");if(de(r))return r;let e=$r(js,"..","docs");return de(e)?e:null}function $s(){let r=qs();if(!r)return[];try{let e=(t,n="")=>{let i=[];for(let s of jr(t)){let o=E(t,s);try{if(Ps(o).isDirectory())i=i.concat(e(o,`${n}${s}/`));else if(s.endsWith(".md")){let a=`${n}${s.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return e(r)}catch{return[]}}function Ds(r){let e=qs();if(!e)return null;let t=E(e,`${r}.md`);if(!de(t))return null;try{return nt(t,"utf-8")}catch{return null}}function Om(r){let e=r.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(`
993
992
  `),t=r.edges.map(o=>o.condition?`- ${o.from} \u2192 ${o.to} (conditional: ${o.condition})`:`- ${o.from} \u2192 ${o.to}`).join(`
994
993
  `),n=Nm(),i=Ds("custom-workflows"),s="";return n&&(s+=`
995
994
  ## Real working examples from the Zibby framework
@@ -1090,7 +1089,7 @@ export const ${n} = {
1090
1089
  prompt: (state) => \`${a}\`,
1091
1090
  outputSchema: ${i},
1092
1091
  };
1093
- `}}return{nodes:e}}function Rm(r,e,t,n){let i=e.toLowerCase(),s=qs(i),o=E(r,".zibby","workflows",i),a=E(o,"nodes");_m(a,{recursive:!0});let c=t.nodes.map(g=>g.name);for(let g of t.nodes){let _=n.nodes?.[g.name]?.code;_&&Fe(E(a,`${g.name.replace(/_/g,"-")}.mjs`),_,"utf-8")}let d=c.map(g=>{let _=rt(g),y=g.replace(/_/g,"-");return`export { ${_} } from './${y}.mjs';`});Fe(E(a,"index.mjs"),`${d.join(`
1092
+ `}}return{nodes:e}}function Rm(r,e,t,n){let i=e.toLowerCase(),s=Bs(i),o=E(r,".zibby","workflows",i),a=E(o,"nodes");_m(a,{recursive:!0});let c=t.nodes.map(g=>g.name);for(let g of t.nodes){let _=n.nodes?.[g.name]?.code;_&&Fe(E(a,`${g.name.replace(/_/g,"-")}.mjs`),_,"utf-8")}let d=c.map(g=>{let _=rt(g),y=g.replace(/_/g,"-");return`export { ${_} } from './${y}.mjs';`});Fe(E(a,"index.mjs"),`${d.join(`
1094
1093
  `)}
1095
1094
  `,"utf-8");let l=c[0],p=c.map(g=>rt(g)).join(", "),u=c.map(g=>` graph.addNode('${g}', ${rt(g)});`).join(`
1096
1095
  `),m=t.edges.map(g=>g.condition?` graph.addConditionalEdges('${g.from}', (state) => {
@@ -1116,8 +1115,8 @@ ${m}
1116
1115
  }
1117
1116
  }
1118
1117
  `;Fe(E(o,"graph.mjs"),f,"utf-8");let h={name:i,description:t.description||`${s} workflow`,entryClass:s,triggers:{api:!0}};Fe(E(o,"workflow.json"),`${JSON.stringify(h,null,2)}
1119
- `,"utf-8");let b=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:Cs(r,o),files:b,className:s,slug:i}}async function Am(r){let{name:e,description:t,nodes:n,edges:i}=r;if(!e||!Js.test(e.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${e}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!n||n.length===0)return JSON.stringify({error:"At least one node is required."});let s={name:e.toLowerCase(),description:t||`${qs(e.toLowerCase())} workflow`,nodes:n.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(s.edges.length===0&&s.nodes.length>0){for(let o=0;o<s.nodes.length-1;o++)s.edges.push({from:s.nodes[o].name,to:s.nodes[o+1].name});s.edges.push({from:s.nodes[s.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:s,message:`Workflow "${s.name}" designed with ${s.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:s.nodes.map(o=>o.name),flow:s.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Em(r,e){let{name:t,spec:n}=r,i=(t||n?.name||"").toLowerCase();if(!i||!Js.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!n||!n.nodes||n.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let s=E(e,".zibby","workflows",i);if(de(s))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await Ms(n,e),a=Rm(e,i,n,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 xm(r,e){let{workflowName:t,nodeName:n,description:i,inputFields:s,outputFields:o}=r,a=(t||"").toLowerCase(),c=(n||"").replace(/-/g,"_"),d=E(e,".zibby","workflows",a);if(!de(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:s||[],outputFields:o||[]}],edges:[]},u=(await Ms(l,e)).nodes?.[c]?.code;if(!u)return JSON.stringify({error:"Failed to generate node code."});let m=E(d,"nodes"),f=`${c.replace(/_/g,"-")}.mjs`;Fe(E(m,f),u,"utf-8");let h=E(m,"index.mjs"),b=rt(c),g=`export { ${b} } from './${c.replace(/_/g,"-")}.mjs';
1120
- `,_=de(h)?nt(h,"utf-8"):"";return _.includes(b)||Fe(h,_+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:b,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Lm(r,e){let{name:t,projectId:n}=r,i=(t||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!n)return JSON.stringify({error:"projectId is required."});let s=E(e,".zibby","workflows",i);if(!de(s))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${E(e,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${n}`,{cwd:e,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 ${n}`,{cwd:e,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 jm(r){let e=E(r,".zibby","workflows");if(!de(e))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let n=jr(e).filter(i=>{try{return Ps(E(e,i)).isDirectory()}catch{return!1}}).map(i=>{let s=E(e,i,"workflow.json"),o={};try{o=JSON.parse(nt(s,"utf-8"))}catch{}let a=E(e,i,"nodes"),c=0;try{c=jr(a).filter(d=>d.endsWith(".mjs")&&d!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Cs(r,E(e,i))}});return JSON.stringify({workflows:n})}var Fs={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Sm,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(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await Am(e);case"build_workflow":return await Em(e,n);case"add_node":return await xm(e,n);case"deploy_workflow":return await Lm(e,n);case"list_workflows":return jm(n);case"explore_framework_docs":{let i=(e.topic||"").trim();if(!i){let o=$s();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let s=Ds(i);if(!s){let o=$s();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:s})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as $m}from"@zibby/core/backend-client.js";var Cr=Object.freeze({id:"openai_billing",requiresIntegration:N.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),Ur=Object.freeze({id:"anthropic_billing",requiresIntegration:N.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),Jr=Object.freeze({id:"cursor_admin",requiresIntegration:N.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Ks(r){return Math.floor(r/1e3)}function Pr(r){return new Date(r).toISOString().slice(0,10)}function Gs(r){return new Date(r).toISOString()}async function it(r){let e=await $m(r);if(!e?.token)throw new Error(`${r} token resolver returned no token`);return e.token}async function Hs({startMs:r,endMs:e,groupBy:t=["project_id","line_item"]}){let n=await it("openai_billing"),i=[],s=0,o=t.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=${Ks(r)}`,`end_time=${Ks(e)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{Authorization:`Bearer ${n}`}});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||[]){s+=1;let f=Pr((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:s}}async function Pm(){let r=await it("openai_billing"),t=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${r}`}});if(!t.ok){let s=await t.text().catch(()=>"");throw new Error(`OpenAI projects API ${t.status}: ${s.slice(0,200)}`)}let n=await t.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function zs({startMs:r,endMs:e,groupBy:t=["workspace_id"]}){let n=await it("anthropic_billing"),i=[],s=0,o=t.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(Gs(r))}`,`ending_at=${encodeURIComponent(Gs(e))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{"x-api-key":n,"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||[]){s+=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:s}}async function Cm(){let r=await it("anthropic_billing"),t=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!t.ok){let s=await t.text().catch(()=>"");throw new Error(`Anthropic workspaces ${t.status}: ${s.slice(0,200)}`)}let n=await t.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function Ys({startMs:r,endMs:e}){let t=await it("cursor_admin"),n=Pr(r),i=Pr(e),s=`https://api.cursor.com/teams/daily-usage-data?startDate=${n}&endDate=${i}`,o=await fetch(s,{headers:{Authorization:`Bearer ${t}`}});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 Um({startMs:r,endMs:e}){let[t,n,i]=await Promise.allSettled([Hs({startMs:r,endMs:e}),zs({startMs:r,endMs:e}),Ys({startMs:r,endMs:e})]),s=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=s(t),a=s(n),c=s(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 Jm(r,e){let t=new Map;for(let n of r){let i=e(n);if(!i)continue;let s=t.get(i)||{key:i,totalUsd:0,count:0};s.totalUsd+=n.costUsd||0,s.count+=1,t.set(i,s)}return[...t.values()].sort((n,i)=>i.totalUsd-n.totalUsd)}function qm(r){if(!r.length)return{mean:0,stddev:0};let e=r.reduce((n,i)=>n+i,0)/r.length,t=r.reduce((n,i)=>n+(i-e)**2,0)/r.length;return{mean:e,stddev:Math.sqrt(t)}}import{SKILL_IDS as W_}from"@zibby/skill-ids";import{z as w}from"zod";var st=["ok","info","warn","critical"],Bm=w.object({primary:w.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:w.object({value:w.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:w.enum(["up","down","flat"]).optional(),severity:w.enum(st).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:w.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Dm=w.object({kind:w.literal("trend"),title:w.string().max(120).optional(),labels:w.array(w.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:w.array(w.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:w.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:w.enum(st).optional()}),Mm=w.object({kind:w.literal("table"),title:w.string().max(120).optional(),headers:w.array(w.string().max(40)).min(1).max(8),rows:w.array(w.array(w.union([w.string().max(200),w.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),Fm=w.object({kind:w.literal("callouts"),title:w.string().max(120).optional(),tone:w.enum(st).default("info").optional(),items:w.array(w.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),Km=w.object({kind:w.literal("breakdown"),title:w.string().max(120).optional(),rows:w.array(w.object({label:w.string().min(1).max(80),value:w.string().min(1).max(80),sub:w.string().max(120).optional(),severity:w.enum(st).optional()})).min(1).max(20)}),Gm=w.object({kind:w.literal("paragraph"),title:w.string().max(120).optional(),text:w.string().min(1).max(3e3)}),Hm=w.discriminatedUnion("kind",[Dm,Mm,Fm,Km,Gm]),ot=w.object({title:w.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:w.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:Bm,sections:w.array(Hm).max(20).default([]).superRefine((r,e)=>{r.forEach((t,n)=>{t.kind==="trend"&&t.labels.length!==t.values.length&&e.addIssue({code:w.ZodIssueCode.custom,path:[n,"values"],message:"labels.length must equal values.length"}),t.kind==="table"&&!t.rows.every(i=>i.length===t.headers.length)&&e.addIssue({code:w.ZodIssueCode.custom,path:[n,"rows"],message:"every row must have headers.length entries"})})}),footer:w.object({viewUrl:w.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:w.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),U=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),Dt=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),zm=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function Mt(r,e,t=12){if(!Number.isFinite(r)||!Number.isFinite(e)||e<=0)return"";let n=Math.max(0,Math.min(1,r/e)),i=Math.round(n*t);return"\u2593".repeat(i)+"\u2591".repeat(t-i)}function at(r,e){let t=String(r);return t.length>=e?t:t+" ".repeat(e-t.length)}function Ft(r,e){let t=String(r);return t.length>=e?t:" ".repeat(e-t.length)+t}function Vs({headers:r,rows:e}){let t=r.map((o,a)=>{let c=Math.max(String(o).length,...e.map(d=>String(d[a]??"").length));return Math.min(c,32)}),n=o=>o.map((a,c)=>at(a,t[c])).join(" "),i=t.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[n(r),i,...e.map(o=>n(o))].join(`
1118
+ `,"utf-8");let b=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:Cs(r,o),files:b,className:s,slug:i}}async function Am(r){let{name:e,description:t,nodes:n,edges:i}=r;if(!e||!Js.test(e.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${e}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!n||n.length===0)return JSON.stringify({error:"At least one node is required."});let s={name:e.toLowerCase(),description:t||`${Bs(e.toLowerCase())} workflow`,nodes:n.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(s.edges.length===0&&s.nodes.length>0){for(let o=0;o<s.nodes.length-1;o++)s.edges.push({from:s.nodes[o].name,to:s.nodes[o+1].name});s.edges.push({from:s.nodes[s.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:s,message:`Workflow "${s.name}" designed with ${s.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:s.nodes.map(o=>o.name),flow:s.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Em(r,e){let{name:t,spec:n}=r,i=(t||n?.name||"").toLowerCase();if(!i||!Js.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!n||!n.nodes||n.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let s=E(e,".zibby","workflows",i);if(de(s))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await Ms(n,e),a=Rm(e,i,n,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 xm(r,e){let{workflowName:t,nodeName:n,description:i,inputFields:s,outputFields:o}=r,a=(t||"").toLowerCase(),c=(n||"").replace(/-/g,"_"),d=E(e,".zibby","workflows",a);if(!de(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:s||[],outputFields:o||[]}],edges:[]},u=(await Ms(l,e)).nodes?.[c]?.code;if(!u)return JSON.stringify({error:"Failed to generate node code."});let m=E(d,"nodes"),f=`${c.replace(/_/g,"-")}.mjs`;Fe(E(m,f),u,"utf-8");let h=E(m,"index.mjs"),b=rt(c),g=`export { ${b} } from './${c.replace(/_/g,"-")}.mjs';
1119
+ `,_=de(h)?nt(h,"utf-8"):"";return _.includes(b)||Fe(h,_+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:b,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Lm(r,e){let{name:t,projectId:n}=r,i=(t||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!n)return JSON.stringify({error:"projectId is required."});let s=E(e,".zibby","workflows",i);if(!de(s))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${E(e,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${n}`,{cwd:e,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 ${n}`,{cwd:e,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 jm(r){let e=E(r,".zibby","workflows");if(!de(e))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let n=jr(e).filter(i=>{try{return Ps(E(e,i)).isDirectory()}catch{return!1}}).map(i=>{let s=E(e,i,"workflow.json"),o={};try{o=JSON.parse(nt(s,"utf-8"))}catch{}let a=E(e,i,"nodes"),c=0;try{c=jr(a).filter(d=>d.endsWith(".mjs")&&d!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Cs(r,E(e,i))}});return JSON.stringify({workflows:n})}var Fs={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Sm,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(r,e,t){let n=t?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await Am(e);case"build_workflow":return await Em(e,n);case"add_node":return await xm(e,n);case"deploy_workflow":return await Lm(e,n);case"list_workflows":return jm(n);case"explore_framework_docs":{let i=(e.topic||"").trim();if(!i){let o=$s();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let s=Ds(i);if(!s){let o=$s();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:s})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as $m}from"@zibby/core/backend-client.js";var Cr=Object.freeze({id:"openai_billing",requiresIntegration:N.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),Ur=Object.freeze({id:"anthropic_billing",requiresIntegration:N.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),Jr=Object.freeze({id:"cursor_admin",requiresIntegration:N.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Ks(r){return Math.floor(r/1e3)}function Pr(r){return new Date(r).toISOString().slice(0,10)}function Gs(r){return new Date(r).toISOString()}async function it(r){let e=await $m(r);if(!e?.token)throw new Error(`${r} token resolver returned no token`);return e.token}async function Hs({startMs:r,endMs:e,groupBy:t=["project_id","line_item"]}){let n=await it("openai_billing"),i=[],s=0,o=t.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=${Ks(r)}`,`end_time=${Ks(e)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{Authorization:`Bearer ${n}`}});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||[]){s+=1;let f=Pr((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:s}}async function Pm(){let r=await it("openai_billing"),t=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${r}`}});if(!t.ok){let s=await t.text().catch(()=>"");throw new Error(`OpenAI projects API ${t.status}: ${s.slice(0,200)}`)}let n=await t.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function zs({startMs:r,endMs:e,groupBy:t=["workspace_id"]}){let n=await it("anthropic_billing"),i=[],s=0,o=t.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(Gs(r))}`,`ending_at=${encodeURIComponent(Gs(e))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{"x-api-key":n,"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||[]){s+=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:s}}async function Cm(){let r=await it("anthropic_billing"),t=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!t.ok){let s=await t.text().catch(()=>"");throw new Error(`Anthropic workspaces ${t.status}: ${s.slice(0,200)}`)}let n=await t.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function Ys({startMs:r,endMs:e}){let t=await it("cursor_admin"),n=Pr(r),i=Pr(e),s=`https://api.cursor.com/teams/daily-usage-data?startDate=${n}&endDate=${i}`,o=await fetch(s,{headers:{Authorization:`Bearer ${t}`}});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 Um({startMs:r,endMs:e}){let[t,n,i]=await Promise.allSettled([Hs({startMs:r,endMs:e}),zs({startMs:r,endMs:e}),Ys({startMs:r,endMs:e})]),s=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=s(t),a=s(n),c=s(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 Jm(r,e){let t=new Map;for(let n of r){let i=e(n);if(!i)continue;let s=t.get(i)||{key:i,totalUsd:0,count:0};s.totalUsd+=n.costUsd||0,s.count+=1,t.set(i,s)}return[...t.values()].sort((n,i)=>i.totalUsd-n.totalUsd)}function Bm(r){if(!r.length)return{mean:0,stddev:0};let e=r.reduce((n,i)=>n+i,0)/r.length,t=r.reduce((n,i)=>n+(i-e)**2,0)/r.length;return{mean:e,stddev:Math.sqrt(t)}}import{SKILL_IDS as W_}from"@zibby/skill-ids";import{z as w}from"zod";var st=["ok","info","warn","critical"],qm=w.object({primary:w.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:w.object({value:w.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:w.enum(["up","down","flat"]).optional(),severity:w.enum(st).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:w.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Dm=w.object({kind:w.literal("trend"),title:w.string().max(120).optional(),labels:w.array(w.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:w.array(w.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:w.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:w.enum(st).optional()}),Mm=w.object({kind:w.literal("table"),title:w.string().max(120).optional(),headers:w.array(w.string().max(40)).min(1).max(8),rows:w.array(w.array(w.union([w.string().max(200),w.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),Fm=w.object({kind:w.literal("callouts"),title:w.string().max(120).optional(),tone:w.enum(st).default("info").optional(),items:w.array(w.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),Km=w.object({kind:w.literal("breakdown"),title:w.string().max(120).optional(),rows:w.array(w.object({label:w.string().min(1).max(80),value:w.string().min(1).max(80),sub:w.string().max(120).optional(),severity:w.enum(st).optional()})).min(1).max(20)}),Gm=w.object({kind:w.literal("paragraph"),title:w.string().max(120).optional(),text:w.string().min(1).max(3e3)}),Hm=w.discriminatedUnion("kind",[Dm,Mm,Fm,Km,Gm]),ot=w.object({title:w.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:w.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:qm,sections:w.array(Hm).max(20).default([]).superRefine((r,e)=>{r.forEach((t,n)=>{t.kind==="trend"&&t.labels.length!==t.values.length&&e.addIssue({code:w.ZodIssueCode.custom,path:[n,"values"],message:"labels.length must equal values.length"}),t.kind==="table"&&!t.rows.every(i=>i.length===t.headers.length)&&e.addIssue({code:w.ZodIssueCode.custom,path:[n,"rows"],message:"every row must have headers.length entries"})})}),footer:w.object({viewUrl:w.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:w.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),U=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),Dt=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),zm=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function Mt(r,e,t=12){if(!Number.isFinite(r)||!Number.isFinite(e)||e<=0)return"";let n=Math.max(0,Math.min(1,r/e)),i=Math.round(n*t);return"\u2593".repeat(i)+"\u2591".repeat(t-i)}function at(r,e){let t=String(r);return t.length>=e?t:t+" ".repeat(e-t.length)}function Ft(r,e){let t=String(r);return t.length>=e?t:" ".repeat(e-t.length)+t}function Vs({headers:r,rows:e}){let t=r.map((o,a)=>{let c=Math.max(String(o).length,...e.map(d=>String(d[a]??"").length));return Math.min(c,32)}),n=o=>o.map((a,c)=>at(a,t[c])).join(" "),i=t.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[n(r),i,...e.map(o=>n(o))].join(`
1121
1120
  `)+"\n```"}function Ym(r){let e=ot.parse(r),t=[];t.push({type:"header",text:{type:"plain_text",text:e.title.slice(0,150),emoji:!0}}),e.subtitle&&t.push({type:"context",elements:[{type:"mrkdwn",text:e.subtitle}]});let n=[`*${e.headline.primary}*`];if(e.headline.delta){let s=Dt[e.headline.delta.direction]||"",o=e.headline.delta.severity?U[e.headline.delta.severity]:"";n.push(`${s} ${e.headline.delta.value} ${o}`.trim())}let i=n.join(" ");e.headline.summary&&(i+=`
1122
1121
  `+e.headline.summary),t.push({type:"section",text:{type:"mrkdwn",text:i}});for(let s of e.sections)switch(t.push({type:"divider"}),s.title&&t.push({type:"section",text:{type:"mrkdwn",text:`*${s.title}*`}}),s.kind){case"trend":{let o=Math.max(...s.values),a=s.labels.map((c,d)=>{let l=s.values[d],p=Mt(l,o),m=(s.highlight==="last"&&d===s.labels.length-1||s.highlight==="max"&&l===o||s.highlight==="min"&&l===Math.min(...s.values))&&s.severity?` ${U[s.severity]}`:"";return`${at(c,10)} ${Ft(l.toLocaleString(),8)} ${p}${m}`});t.push({type:"section",text:{type:"mrkdwn",text:"```\n"+a.join(`
1123
1122
  `)+"\n```"}});break}case"table":{t.push({type:"section",text:{type:"mrkdwn",text:Vs(s)}});break}case"callouts":{let o=U[s.tone||"info"];t.push({type:"section",text:{type:"mrkdwn",text:s.items.map(a=>`${o} ${a}`).join(`
@@ -1127,6 +1126,6 @@ _${a.sub}_`:""}${a.severity?` ${U[a.severity]}`:""}`}));for(let a=0;a<o.length;a
1127
1126
  `+e.headline.summary),t.push({tag:"div",text:{tag:"lark_md",content:i}});for(let o of e.sections)switch(t.push({tag:"hr"}),o.title&&t.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=Mt(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?` ${U[o.severity]}`:"";return`${at(d,10)} ${Ft(p.toLocaleString(),8)} ${u}${f}`});t.push({tag:"div",text:{tag:"lark_md",content:"```\n"+c.join(`
1128
1127
  `)+"\n```"}});break}case"table":{t.push({tag:"div",text:{tag:"lark_md",content:Vs(o)}});break}case"callouts":{let a=U[o.tone||"info"];t.push({tag:"div",text:{tag:"lark_md",content:o.items.map(c=>`${a} ${c}`).join(`
1129
1128
  `)}});break}case"breakdown":{let a=o.rows.map(c=>{let d=c.severity?` ${U[c.severity]}`:"",l=c.sub?` *${c.sub}*`:"";return`**${c.label}** ${c.value}${l}${d}`});t.push({tag:"div",text:{tag:"lark_md",content:a.join(`
1130
- `)}});break}case"paragraph":{t.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)){let o=[];e.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:e.footer.viewUrl,type:"primary"}),e.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:e.footer.rerunUrl,type:"default"}),t.push({tag:"hr"}),t.push({tag:"action",actions:o})}let s="blue";return e.headline.delta?.severity&&(s=zm[e.headline.delta.severity]||"blue"),{config:{wide_screen_mode:!0},header:{title:{tag:"plain_text",content:e.title.slice(0,200)},subtitle:e.subtitle?{tag:"plain_text",content:e.subtitle.slice(0,200)}:void 0,template:s},elements:t}}var Zm=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),Ws=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});function Ae(r,e={}){let t={type:"text",text:{content:String(r).slice(0,2e3)}};return e.annotations&&(t.annotations=e.annotations),[t]}function qr(r,e){let t={object:"block",type:"paragraph",paragraph:{rich_text:Ae(r)}};return e&&(t.paragraph.color=e),t}function Vm(r){return{object:"block",type:"code",code:{rich_text:Ae(r),language:"plain text"}}}function Qm(r){let e=ot.parse(r),t=[];t.push({object:"block",type:"heading_1",heading_1:{rich_text:Ae(e.title.slice(0,200))}}),e.subtitle&&t.push(qr(e.subtitle,"gray_background"));let n=[{type:"text",text:{content:e.headline.primary.slice(0,200)},annotations:{bold:!0}}];if(e.headline.delta){let s=Dt[e.headline.delta.direction]||"",o=e.headline.delta.severity?U[e.headline.delta.severity]:"",a=` ${s} ${e.headline.delta.value} ${o}`.trimEnd();n.push({type:"text",text:{content:a}})}t.push({object:"block",type:"paragraph",paragraph:{rich_text:n}}),e.headline.summary&&t.push(qr(e.headline.summary));for(let s of e.sections)switch(t.push({object:"block",type:"divider",divider:{}}),s.title&&t.push({object:"block",type:"heading_2",heading_2:{rich_text:Ae(s.title)}}),s.kind){case"trend":{let o=Math.max(...s.values),a=Math.min(...s.values),c=s.labels.map((d,l)=>{let p=s.values[l],u=Mt(p,o),f=(s.highlight==="last"&&l===s.labels.length-1||s.highlight==="max"&&p===o||s.highlight==="min"&&p===a)&&s.severity?` ${U[s.severity]}`:"";return`${at(d,10)} ${Ft(p.toLocaleString(),8)} ${u}${f}`});t.push(Vm(c.join(`
1131
- `)));break}case"table":{let o={object:"block",type:"table_row",table_row:{cells:s.headers.map(c=>Ae(c))}},a=s.rows.map(c=>({object:"block",type:"table_row",table_row:{cells:c.map(d=>Ae(String(d)))}}));t.push({object:"block",type:"table",table:{table_width:s.headers.length,has_column_header:!0,has_row_header:!1,children:[o,...a]}});break}case"callouts":{let o=s.tone||"info",a=Ws[o],c=Zm[o];for(let d of s.items)t.push({object:"block",type:"callout",callout:{rich_text:Ae(d),icon:{type:"emoji",emoji:a},color:c}});break}case"breakdown":{for(let o of s.rows){let a=[{type:"text",text:{content:`${o.label}: `},annotations:{bold:!0}},{type:"text",text:{content:String(o.value)}}];o.sub&&a.push({type:"text",text:{content:` (${o.sub})`},annotations:{italic:!0}}),o.severity&&a.push({type:"text",text:{content:` ${U[o.severity]}`}}),t.push({object:"block",type:"bulleted_list_item",bulleted_list_item:{rich_text:a}})}break}case"paragraph":{t.push(qr(s.text));break}}e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)&&(t.push({object:"block",type:"divider",divider:{}}),e.footer.viewUrl&&t.push({object:"block",type:"embed",embed:{url:e.footer.viewUrl}}),e.footer.rerunUrl&&t.push({object:"block",type:"embed",embed:{url:e.footer.rerunUrl}}));let i=e.headline.delta?.severity?Ws[e.headline.delta.severity]:void 0;return{blocks:t,title:e.title.slice(0,200),icon:i}}function Zs(r){return String(r??"").replace(/\|/g,"\\|")}function Xm(r){let e=ot.parse(r),t=[];t.push(`# ${e.title}`),e.subtitle&&t.push("",e.subtitle);let n=[`**${e.headline.primary}**`];if(e.headline.delta){let i=Dt[e.headline.delta.direction]||"",s=e.headline.delta.severity?U[e.headline.delta.severity]:"";n.push(`${i} ${e.headline.delta.value} ${s}`.trim())}t.push("",n.join(" ")),e.headline.summary&&t.push("",e.headline.summary);for(let i of e.sections)switch(t.push("","---",""),i.title&&t.push(`## ${i.title}`,""),i.kind){case"trend":{let s=Math.max(...i.values),o=Math.min(...i.values),a=i.labels.map((c,d)=>{let l=i.values[d],p=Mt(l,s),m=(i.highlight==="last"&&d===i.labels.length-1||i.highlight==="max"&&l===s||i.highlight==="min"&&l===o)&&i.severity?` ${U[i.severity]}`:"";return`${at(c,10)} ${Ft(l.toLocaleString(),8)} ${p}${m}`});t.push("```",...a,"```");break}case"table":{t.push(`| ${i.headers.map(Zs).join(" | ")} |`),t.push(`| ${i.headers.map(()=>"---").join(" | ")} |`);for(let s of i.rows)t.push(`| ${s.map(Zs).join(" | ")} |`);break}case"callouts":{let s=U[i.tone||"info"];for(let o of i.items)t.push(`- ${s} ${o}`);break}case"breakdown":{for(let s of i.rows){let o=s.sub?` _${s.sub}_`:"",a=s.severity?` ${U[s.severity]}`:"";t.push(`- **${s.label}**: ${s.value}${o}${a}`)}break}case"paragraph":{t.push(i.text);break}}if(e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)){let i=[];e.footer.viewUrl&&i.push(`[View in Zibby](${e.footer.viewUrl})`),e.footer.rerunUrl&&i.push(`[Run again](${e.footer.rerunUrl})`),t.push("","---","",i.join(" \xB7 "))}return t.join(`
1132
- `)}import{createRequire as ef}from"module";import{fileURLToPath as tf}from"url";import{registerHandlers as rf}from"@zibby/core/function-skill-registry.js";import{registerSkill as nf}from"@zibby/agent-workflow";var sf=ef(import.meta.url);function of(){try{return sf.resolve("@zibby/core/function-bridge.js")}catch{return null}}var af=import.meta.url;function cf(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(n,i)=>i;let t=new Error().stack;for(let n=2;n<t.length;n++){let i=t[n].getFileName();if(i&&i!==af&&!i.startsWith("node:"))return i.startsWith("file://")?tf(i):i}return null}finally{Error.prepareStackTrace=r}}function lf(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let e={},t=[];for(let[n,i]of Object.entries(r))if(typeof i=="string")e[n]={type:i},t.push(n);else{let{required:s,...o}=i;e[n]=o,s!==!1&&t.push(n)}return{type:"object",properties:e,required:t}}function df(r,e,t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n={[r]:t.handler},i=[{name:r,description:t.description||"",input_schema:lf(t.input)}];return rf(r,n,i),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:t.description||`Function skill: ${r}`,envKeys:[],tools:i,resolve(){let s=of();return s?{command:"node",args:[s,e,r]}:null}}}function pf(r,e){return{id:r,type:"mcp",serverName:e.serverName||r,allowedTools:e.allowedTools||[`mcp__${e.serverName||r}__*`],description:e.description||`MCP skill: ${r}`,envKeys:e.envKeys||[],tools:e.tools||[],resolve:e.resolve,...e.cursorKey&&{cursorKey:e.cursorKey},...e.sessionEnvKey&&{sessionEnvKey:e.sessionEnvKey}}}function Qs(r,e){let t;if("handler"in e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n=cf();if(!n)throw new Error(`Could not resolve caller file for skill "${r}".`);t=df(r,n,e)}else if(typeof e.resolve=="function")t=pf(r,e);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return nf(t),t}var uf=Qs;import{registerSkill as eb,getSkill as tb,hasSkill as rb,getAllSkills as nb,listSkillIds as ib}from"@zibby/agent-workflow";I(Mr);I(Gr);I(je);I($e);I(tn);I(nn);I(on);I(an);I(dn);I($);I(D);I(mn);I(wn);I(Nn);I(En);I(Jn);I(qn);I(St);I(Dn);I(pi);I(me);I(yi);I(Fn);I(Yn);I(Ei);I(Ui);I(Fi);I(Wi);I(ss);I(os);I(as);I(gs);I(Ns);I(Os);I(Es);I(Ls);I(Fs);I(Cr);I(Ur);I(Jr);I({...$,id:"slack_notify"});export{N as INTEGRATIONS,po as INTEGRATION_REGISTRY,st as REPORT_SEVERITIES,W_ as SKILLS,Ur as anthropicBillingSkill,Wi as artifactSkill,Mr as browserSkill,ss as chartRenderSkill,Ei as chatMemorySkill,qn as chatNotifySkill,as as chatProgressSkill,Ns as codeScanSkill,os as codeStatsSkill,Es as codebaseMemorySkill,Yn as coreToolsSkill,Jr as cursorAdminSkill,Fi as datasetStoreSkill,mn as discordSkill,Um as fetchAllProviders,zs as fetchAnthropicCosts,Cm as fetchAnthropicWorkspaces,Ys as fetchCursorSpend,Hs as fetchOpenAICosts,Pm as fetchOpenAIProjects,tn as figmaSkill,uf as functionSkill,Ls as gbrainSkill,nb as getAllSkills,tb as getSkill,me as gitSkill,yi as gitWriteSkill,je as githubSkill,$e as gitlabSkill,En as googleDocsSkill,Jm as groupByKey,rb as hasSkill,nn as hubspotSkill,Gr as jiraSkill,Ui as kvMemorySkill,Jn as larkDocsSkill,D as larkSkill,on as linearSkill,Nn as linkedinSkill,ib as listSkillIds,qm as meanStddev,Dn as memorySkill,wn as notionSkill,Cr as openaiBillingSkill,dn as opendesignSkill,an as planeSkill,eb as registerSkill,ot as reportObjectSchema,Ym as reportToBlockKit,Wm as reportToLarkCard,Xm as reportToMarkdown,Qm as reportToNotionBlocks,pi as runnerSkill,St as sentrySkill,Qs as skill,Fn as skillInstallerSkill,$ as slackSkill,gs as socialCardSkill,pi as testRunnerSkill,Fs as workflowBuilderSkill};
1129
+ `)}});break}case"paragraph":{t.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)){let o=[];e.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:e.footer.viewUrl,type:"primary"}),e.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:e.footer.rerunUrl,type:"default"}),t.push({tag:"hr"}),t.push({tag:"action",actions:o})}let s="blue";return e.headline.delta?.severity&&(s=zm[e.headline.delta.severity]||"blue"),{config:{wide_screen_mode:!0},header:{title:{tag:"plain_text",content:e.title.slice(0,200)},subtitle:e.subtitle?{tag:"plain_text",content:e.subtitle.slice(0,200)}:void 0,template:s},elements:t}}var Zm=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),Ws=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});function Ae(r,e={}){let t={type:"text",text:{content:String(r).slice(0,2e3)}};return e.annotations&&(t.annotations=e.annotations),[t]}function Br(r,e){let t={object:"block",type:"paragraph",paragraph:{rich_text:Ae(r)}};return e&&(t.paragraph.color=e),t}function Vm(r){return{object:"block",type:"code",code:{rich_text:Ae(r),language:"plain text"}}}function Qm(r){let e=ot.parse(r),t=[];t.push({object:"block",type:"heading_1",heading_1:{rich_text:Ae(e.title.slice(0,200))}}),e.subtitle&&t.push(Br(e.subtitle,"gray_background"));let n=[{type:"text",text:{content:e.headline.primary.slice(0,200)},annotations:{bold:!0}}];if(e.headline.delta){let s=Dt[e.headline.delta.direction]||"",o=e.headline.delta.severity?U[e.headline.delta.severity]:"",a=` ${s} ${e.headline.delta.value} ${o}`.trimEnd();n.push({type:"text",text:{content:a}})}t.push({object:"block",type:"paragraph",paragraph:{rich_text:n}}),e.headline.summary&&t.push(Br(e.headline.summary));for(let s of e.sections)switch(t.push({object:"block",type:"divider",divider:{}}),s.title&&t.push({object:"block",type:"heading_2",heading_2:{rich_text:Ae(s.title)}}),s.kind){case"trend":{let o=Math.max(...s.values),a=Math.min(...s.values),c=s.labels.map((d,l)=>{let p=s.values[l],u=Mt(p,o),f=(s.highlight==="last"&&l===s.labels.length-1||s.highlight==="max"&&p===o||s.highlight==="min"&&p===a)&&s.severity?` ${U[s.severity]}`:"";return`${at(d,10)} ${Ft(p.toLocaleString(),8)} ${u}${f}`});t.push(Vm(c.join(`
1130
+ `)));break}case"table":{let o={object:"block",type:"table_row",table_row:{cells:s.headers.map(c=>Ae(c))}},a=s.rows.map(c=>({object:"block",type:"table_row",table_row:{cells:c.map(d=>Ae(String(d)))}}));t.push({object:"block",type:"table",table:{table_width:s.headers.length,has_column_header:!0,has_row_header:!1,children:[o,...a]}});break}case"callouts":{let o=s.tone||"info",a=Ws[o],c=Zm[o];for(let d of s.items)t.push({object:"block",type:"callout",callout:{rich_text:Ae(d),icon:{type:"emoji",emoji:a},color:c}});break}case"breakdown":{for(let o of s.rows){let a=[{type:"text",text:{content:`${o.label}: `},annotations:{bold:!0}},{type:"text",text:{content:String(o.value)}}];o.sub&&a.push({type:"text",text:{content:` (${o.sub})`},annotations:{italic:!0}}),o.severity&&a.push({type:"text",text:{content:` ${U[o.severity]}`}}),t.push({object:"block",type:"bulleted_list_item",bulleted_list_item:{rich_text:a}})}break}case"paragraph":{t.push(Br(s.text));break}}e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)&&(t.push({object:"block",type:"divider",divider:{}}),e.footer.viewUrl&&t.push({object:"block",type:"embed",embed:{url:e.footer.viewUrl}}),e.footer.rerunUrl&&t.push({object:"block",type:"embed",embed:{url:e.footer.rerunUrl}}));let i=e.headline.delta?.severity?Ws[e.headline.delta.severity]:void 0;return{blocks:t,title:e.title.slice(0,200),icon:i}}function Zs(r){return String(r??"").replace(/\|/g,"\\|")}function Xm(r){let e=ot.parse(r),t=[];t.push(`# ${e.title}`),e.subtitle&&t.push("",e.subtitle);let n=[`**${e.headline.primary}**`];if(e.headline.delta){let i=Dt[e.headline.delta.direction]||"",s=e.headline.delta.severity?U[e.headline.delta.severity]:"";n.push(`${i} ${e.headline.delta.value} ${s}`.trim())}t.push("",n.join(" ")),e.headline.summary&&t.push("",e.headline.summary);for(let i of e.sections)switch(t.push("","---",""),i.title&&t.push(`## ${i.title}`,""),i.kind){case"trend":{let s=Math.max(...i.values),o=Math.min(...i.values),a=i.labels.map((c,d)=>{let l=i.values[d],p=Mt(l,s),m=(i.highlight==="last"&&d===i.labels.length-1||i.highlight==="max"&&l===s||i.highlight==="min"&&l===o)&&i.severity?` ${U[i.severity]}`:"";return`${at(c,10)} ${Ft(l.toLocaleString(),8)} ${p}${m}`});t.push("```",...a,"```");break}case"table":{t.push(`| ${i.headers.map(Zs).join(" | ")} |`),t.push(`| ${i.headers.map(()=>"---").join(" | ")} |`);for(let s of i.rows)t.push(`| ${s.map(Zs).join(" | ")} |`);break}case"callouts":{let s=U[i.tone||"info"];for(let o of i.items)t.push(`- ${s} ${o}`);break}case"breakdown":{for(let s of i.rows){let o=s.sub?` _${s.sub}_`:"",a=s.severity?` ${U[s.severity]}`:"";t.push(`- **${s.label}**: ${s.value}${o}${a}`)}break}case"paragraph":{t.push(i.text);break}}if(e.footer&&(e.footer.viewUrl||e.footer.rerunUrl)){let i=[];e.footer.viewUrl&&i.push(`[View in Zibby](${e.footer.viewUrl})`),e.footer.rerunUrl&&i.push(`[Run again](${e.footer.rerunUrl})`),t.push("","---","",i.join(" \xB7 "))}return t.join(`
1131
+ `)}import{createRequire as ef}from"module";import{fileURLToPath as tf}from"url";import{registerHandlers as rf}from"@zibby/core/function-skill-registry.js";import{registerSkill as nf}from"@zibby/agent-workflow";var sf=ef(import.meta.url);function of(){try{return sf.resolve("@zibby/core/function-bridge.js")}catch{return null}}var af=import.meta.url;function cf(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(n,i)=>i;let t=new Error().stack;for(let n=2;n<t.length;n++){let i=t[n].getFileName();if(i&&i!==af&&!i.startsWith("node:"))return i.startsWith("file://")?tf(i):i}return null}finally{Error.prepareStackTrace=r}}function lf(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let e={},t=[];for(let[n,i]of Object.entries(r))if(typeof i=="string")e[n]={type:i},t.push(n);else{let{required:s,...o}=i;e[n]=o,s!==!1&&t.push(n)}return{type:"object",properties:e,required:t}}function df(r,e,t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n={[r]:t.handler},i=[{name:r,description:t.description||"",input_schema:lf(t.input)}];return rf(r,n,i),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:t.description||`Function skill: ${r}`,envKeys:[],tools:i,resolve(){let s=of();return s?{command:"node",args:[s,e,r]}:null}}}function pf(r,e){return{id:r,type:"mcp",serverName:e.serverName||r,allowedTools:e.allowedTools||[`mcp__${e.serverName||r}__*`],description:e.description||`MCP skill: ${r}`,envKeys:e.envKeys||[],tools:e.tools||[],resolve:e.resolve,...e.cursorKey&&{cursorKey:e.cursorKey},...e.sessionEnvKey&&{sessionEnvKey:e.sessionEnvKey}}}function Qs(r,e){let t;if("handler"in e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n=cf();if(!n)throw new Error(`Could not resolve caller file for skill "${r}".`);t=df(r,n,e)}else if(typeof e.resolve=="function")t=pf(r,e);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return nf(t),t}var uf=Qs;import{registerSkill as eb,getSkill as tb,hasSkill as rb,getAllSkills as nb,listSkillIds as ib}from"@zibby/agent-workflow";I(Mr);I(Gr);I(je);I($e);I(tn);I(nn);I(on);I(an);I(dn);I($);I(D);I(mn);I(wn);I(Nn);I(En);I(Jn);I(Bn);I(St);I(Dn);I(pi);I(me);I(yi);I(Fn);I(Yn);I(Ei);I(Ui);I(Fi);I(Wi);I(ss);I(os);I(as);I(gs);I(Ns);I(Os);I(Es);I(Ls);I(Fs);I(Cr);I(Ur);I(Jr);I({...$,id:"slack_notify"});export{N as INTEGRATIONS,po as INTEGRATION_REGISTRY,st as REPORT_SEVERITIES,W_ as SKILLS,Ur as anthropicBillingSkill,Wi as artifactSkill,Mr as browserSkill,ss as chartRenderSkill,Ei as chatMemorySkill,Bn as chatNotifySkill,as as chatProgressSkill,Ns as codeScanSkill,os as codeStatsSkill,Es as codebaseMemorySkill,Yn as coreToolsSkill,Jr as cursorAdminSkill,Fi as datasetStoreSkill,mn as discordSkill,Um as fetchAllProviders,zs as fetchAnthropicCosts,Cm as fetchAnthropicWorkspaces,Ys as fetchCursorSpend,Hs as fetchOpenAICosts,Pm as fetchOpenAIProjects,tn as figmaSkill,uf as functionSkill,Ls as gbrainSkill,nb as getAllSkills,tb as getSkill,me as gitSkill,yi as gitWriteSkill,je as githubSkill,$e as gitlabSkill,En as googleDocsSkill,Jm as groupByKey,rb as hasSkill,nn as hubspotSkill,Gr as jiraSkill,Ui as kvMemorySkill,Jn as larkDocsSkill,D as larkSkill,on as linearSkill,Nn as linkedinSkill,ib as listSkillIds,Bm as meanStddev,Dn as memorySkill,wn as notionSkill,Cr as openaiBillingSkill,dn as opendesignSkill,an as planeSkill,eb as registerSkill,ot as reportObjectSchema,Ym as reportToBlockKit,Wm as reportToLarkCard,Xm as reportToMarkdown,Qm as reportToNotionBlocks,pi as runnerSkill,St as sentrySkill,Qs as skill,Fn as skillInstallerSkill,$ as slackSkill,gs as socialCardSkill,pi as testRunnerSkill,Fs as workflowBuilderSkill};