@zibby/skills 0.1.35 → 0.1.37

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
@@ -1,6 +1,6 @@
1
- import{registerSkill as A}from"@zibby/agent-workflow";import{createRequire as xr}from"module";import{join as Lr}from"path";var Cr=xr(import.meta.url);function Pr(){if(process.env.MCP_BROWSER_PATH)return process.env.MCP_BROWSER_PATH;try{return Cr.resolve("@zibby/mcp-browser/dist/bin/mcp-browser-zibby.js")}catch{return null}}var Jr="1280x720",Ur="1280x720";function qr({headless:s}={}){if(s===!0)return!0;if(s===!1)return!1;let t=process.env.ZIBBY_HEADLESS;return t==="1"||String(t).toLowerCase()==="true"}function Mr(s,t){let e=(s||[]).filter(r=>r!=="--headless");return t?[...e,"--headless"]:e}var st={id:"browser",serverName:"playwright",cursorKey:"playwright-official",allowedTools:["mcp__playwright__*"],sessionEnvKey:"ZIBBY_SESSION_INFO",description:"Playwright Browser MCP Server",envKeys:[],tools:[],promptFragment:`Execute this test using the browser tools available to you. You MUST make actual browser tool calls \u2014 do not fabricate results.
1
+ import{registerSkill as A}from"@zibby/agent-workflow";import{createRequire as Lr}from"module";import{join as xr}from"path";var Cr=Lr(import.meta.url);function Pr(){if(process.env.MCP_BROWSER_PATH)return process.env.MCP_BROWSER_PATH;try{return Cr.resolve("@zibby/mcp-browser/dist/bin/mcp-browser-zibby.js")}catch{return null}}var Jr="1280x720",Ur="1280x720";function qr({headless:s}={}){if(s===!0)return!0;if(s===!1)return!1;let t=process.env.ZIBBY_HEADLESS;return t==="1"||String(t).toLowerCase()==="true"}function Mr(s,t){let e=(s||[]).filter(r=>r!=="--headless");return t?[...e,"--headless"]:e}var st={id:"browser",serverName:"playwright",cursorKey:"playwright-official",allowedTools:["mcp__playwright__*"],sessionEnvKey:"ZIBBY_SESSION_INFO",description:"Playwright Browser MCP Server",envKeys:[],tools:[],promptFragment:`Execute this test using the browser tools available to you. You MUST make actual browser tool calls \u2014 do not fabricate results.
2
2
  If you DO NOT have access to browser tools \u2192 return {"success": false, "steps": [], "browserClosed": false, "notes": "No browser tools available"}.
3
- DO NOT return success: true unless you ACTUALLY called browser tools.`,resolve({sessionPath:s,workspace:t,nodeName:e,headless:r}={}){let i=Pr(),n=s&&e?Lr(s,e):null,o=n||s||t||"test-results",c=qr({headless:r}),a={};if(n&&(a.ZIBBY_NODE_SESSION_PATH=n),s&&(a.ZIBBY_SESSION_PATH=s),!i)throw new Error(`@zibby/mcp-browser is not installed.
3
+ DO NOT return success: true unless you ACTUALLY called browser tools.`,resolve({sessionPath:s,workspace:t,nodeName:e,headless:r}={}){let i=Pr(),n=s&&e?xr(s,e):null,o=n||s||t||"test-results",c=qr({headless:r}),a={};if(n&&(a.ZIBBY_NODE_SESSION_PATH=n),s&&(a.ZIBBY_SESSION_PATH=s),!i)throw new Error(`@zibby/mcp-browser is not installed.
4
4
  Cloud: verify the Fargate image has it (packages/Dockerfile installs it globally alongside @zibby/cli).
5
5
  Local: \`npm install @zibby/mcp-browser\` in your workflow, or use the global @zibby/cli install (which pulls it transitively).
6
6
  Override: set MCP_BROWSER_PATH to the path of mcp-browser-zibby.js.`);return{command:"node",args:Mr([i,"--isolated",`--save-video=${Jr}`,`--viewport-size=${Ur}`,`--output-dir=${o}`],c),env:a}}};import{createRequire as Br}from"module";import{resolveIntegrationToken as Kr,clearTokenCache as Gr}from"@zibby/core/backend-client.js";var O=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",PLANE:"plane",LINEAR:"linear"}),Dr=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark",connectPath:"/integrations?provider=lark"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"}});var Fr=Br(import.meta.url);function zr(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return Fr.resolve("@zibby/mcp-jira/index.js")}catch{return null}}var Wr=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Hr(s,t){if(!t||!t.length)return s;let e=s;for(let r of t)r.type==="strong"?e=`**${e}**`:r.type==="em"?e=`_${e}_`:r.type==="code"?e=`\`${e}\``:r.type==="strike"?e=`~~${e}~~`:r.type==="link"&&r.attrs?.href&&(e=`[${e}](${r.attrs.href})`);return e}function he(s,t=0){if(!Array.isArray(s))return"";let e=[];for(let r of s){if(r.type==="text"){e.push(Hr(r.text||"",r.marks));continue}if(r.type==="hardBreak"){e.push(`
@@ -71,7 +71,7 @@ When user asks to move/transition ticket status:
71
71
  3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
72
72
  4. Call jira_get_issue(issueKey) to verify final status before claiming success.
73
73
  5. If target wording differs (e.g. \u5DF2\u7ECF\u9A8C\u6536 vs \u5DF2\u9A8C\u6536), try toStatus first; only ask user to confirm when no reasonable match exists.
74
- 6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=zr();if(!s)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL),{command:"node",args:[s],env:t,description:this.description}},async handleToolCall(s,t){try{switch(s){case"jira_list_projects":{let e=await R("/rest/api/3/project"),r=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:r.length,projects:r})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let n=await R(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],c=new Map;for(let u of o)for(let l of u.statuses||[])l?.id&&(c.has(l.id)||c.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let a=[...c.values()].sort((u,l)=>String(u.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:a.length,statuses:a})}let r=await R("/rest/api/3/status"),i=(Array.isArray(r)?r:[]).map(n=>({id:n.id,name:n.name,category:n.statusCategory?.name||null})).sort((n,o)=>String(n.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let r=await it(e);return JSON.stringify({projectKey:e,count:r.length,issueTypes:r})}case"jira_search":{let e=t.jql||"",r=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${r}&fields=summary,status,assignee,priority,updated,issuetype,project`,c=((await R(`/rest/api/3/search/jql?${n}`)).issues||[]).map(a=>({key:a.key,project:a.fields?.project?.key,summary:a.fields?.summary,status:a.fields?.status?.name,assignee:a.fields?.assignee?.displayName||"Unassigned",priority:a.fields?.priority?.name,type:a.fields?.issuetype?.name}));return JSON.stringify({count:c.length,issues:c})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let r=await R(`/rest/api/3/issue/${e}`);return JSON.stringify({key:r.key,project:r.fields?.project?.key,summary:r.fields?.summary,description:r.fields?.description,status:r.fields?.status?.name,assignee:r.fields?.assignee?.displayName||"Unassigned",priority:r.fields?.priority?.name,type:r.fields?.issuetype?.name,labels:r.fields?.labels,created:r.fields?.created,updated:r.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:r,issueType:i,description:n,priority:o,labels:c,assigneeId:a,moveToSprint:u,moveToActiveSprint:l,sprintId:d,sprintName:p,target:m}=t;if(!e||!r)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},y=[];try{y=await it(e),f=Yr(i,y)}catch{}let _={project:{key:e},summary:r,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};n&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(_.priority={name:o}),c?.length&&(_.labels=c),a&&(_.assignee={id:a});let g=await R("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&H(f.requested)!==H(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),y.length>0&&(b.availableIssueTypes=y.map(h=>h.name)),(u||l)&&(b.sprintMove=await Ee({issueKey:g.key,projectKey:e,sprintId:d,sprintName:p,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:r}=t,i=await nt(e,r);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},c=await Ee({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o||"current"});return JSON.stringify(c)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},c=await Ee({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o});return JSON.stringify(c)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:r,projectKey:i,status:n,maxResults:o}=t;if(!e&&!r)return JSON.stringify({error:"sprintName or sprintId is required"});let c=o||50,a=r?`sprint = ${r}`:`sprint = "${e}"`,u=i?`project = ${i} AND `:"",l=n?` AND status = "${n}"`:"",d=`${u}${a}${l} ORDER BY status ASC, priority DESC`,p=`jql=${encodeURIComponent(d)}&maxResults=${c}&fields=summary,status,assignee,priority,issuetype,project`,m=await R(`/rest/api/3/search/jql?${p}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),y={};for(let _ of f)y[_.status]=(y[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:y,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:r}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await R(`/rest/api/3/issue/${e}/comment?maxResults=${r||50}&orderBy=-created`),o=(n.comments||[]).map(c=>{let a="";return c.body?.content&&(a=he(c.body.content)),{id:c.id,author:c.author?.displayName||"Unknown",body:a,created:c.created,updated:c.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:r}=t;return!e||!r?JSON.stringify({error:"issueKey and body are required"}):(await R(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:r}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:r}=t;return!e||!r?JSON.stringify({error:"issueKey and fields are required"}):(await R(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:r}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:r,toStatus:i,statusName:n,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let c=String(i||n||o||"").trim();if(!r&&!c){let d=((await R(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(p=>({id:p.id,name:p.name,to:p.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:d})}let a=r;if(!a){let d=(await R(`/rest/api/3/issue/${e}/transitions`)).transitions||[],p=re(c),m=d.find(f=>re(f?.name||"")===p||re(f?.to?.name||"")===p);if(!m){let f=Te(c);f.length>=2&&(m=d.find(y=>{let _=Te(y?.name||""),g=Te(y?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),h=g.length>=2&&(g.includes(f)||f.includes(g));return b||h}))}if(!m){let f=d.map(b=>{let h=ge(c,b?.name||""),v=ge(c,b?.to?.name||"");return{t:b,score:Math.max(h,v)}}).sort((b,h)=>h.score-b.score),y=f[0],_=f[1];y&&y.score>=.45&&(!_||y.score-_.score>=.12)&&(m=y.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${c}"`,issueKey:e,availableTransitions:d.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});a=m.id}await R(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:a}}});let u=await R(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:a,statusAfter:u?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description (plain text)"},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text (plain text)"}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, story points, labels, priority)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};import{resolveIntegrationToken as at}from"@zibby/core/backend-client.js";async function S(s,t={}){let{token:e}=await at("github"),r=s.startsWith("https://")?s:`https://api.github.com${s}`,i={Authorization:`Bearer ${e}`,Accept:t.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`GitHub API ${n.status}: ${o.slice(0,300)}`)}return t.raw?n.text():n.json()}var ct={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:O.GITHUB,envKeys:["GITHUB_TOKEN"],description:"GitHub \u2014 issues, PRs, commits, code search, file reading",promptFragment:`## GitHub (connected)
74
+ 6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let s=zr();if(!s)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL),{command:"node",args:[s],env:t,description:this.description}},async handleToolCall(s,t){try{switch(s){case"jira_list_projects":{let e=await R("/rest/api/3/project"),r=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:r.length,projects:r})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let n=await R(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],c=new Map;for(let u of o)for(let l of u.statuses||[])l?.id&&(c.has(l.id)||c.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let a=[...c.values()].sort((u,l)=>String(u.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:a.length,statuses:a})}let r=await R("/rest/api/3/status"),i=(Array.isArray(r)?r:[]).map(n=>({id:n.id,name:n.name,category:n.statusCategory?.name||null})).sort((n,o)=>String(n.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let r=await it(e);return JSON.stringify({projectKey:e,count:r.length,issueTypes:r})}case"jira_search":{let e=t.jql||"",r=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${r}&fields=summary,status,assignee,priority,updated,issuetype,project`,c=((await R(`/rest/api/3/search/jql?${n}`)).issues||[]).map(a=>({key:a.key,project:a.fields?.project?.key,summary:a.fields?.summary,status:a.fields?.status?.name,assignee:a.fields?.assignee?.displayName||"Unassigned",priority:a.fields?.priority?.name,type:a.fields?.issuetype?.name}));return JSON.stringify({count:c.length,issues:c})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let r=await R(`/rest/api/3/issue/${e}`);return JSON.stringify({key:r.key,project:r.fields?.project?.key,summary:r.fields?.summary,description:r.fields?.description,status:r.fields?.status?.name,assignee:r.fields?.assignee?.displayName||"Unassigned",priority:r.fields?.priority?.name,type:r.fields?.issuetype?.name,labels:r.fields?.labels,created:r.fields?.created,updated:r.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:r,issueType:i,description:n,priority:o,labels:c,assigneeId:a,moveToSprint:u,moveToActiveSprint:l,sprintId:d,sprintName:p,target:m}=t;if(!e||!r)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},y=[];try{y=await it(e),f=Yr(i,y)}catch{}let _={project:{key:e},summary:r,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};n&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(_.priority={name:o}),c?.length&&(_.labels=c),a&&(_.assignee={id:a});let g=await R("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&H(f.requested)!==H(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),y.length>0&&(b.availableIssueTypes=y.map(h=>h.name)),(u||l)&&(b.sprintMove=await Ee({issueKey:g.key,projectKey:e,sprintId:d,sprintName:p,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:r}=t,i=await nt(e,r);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},c=await Ee({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o||"current"});return JSON.stringify(c)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o}=t||{},c=await Ee({issueKey:e,projectKey:r,sprintId:i,sprintName:n,target:o});return JSON.stringify(c)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:r,projectKey:i,status:n,maxResults:o}=t;if(!e&&!r)return JSON.stringify({error:"sprintName or sprintId is required"});let c=o||50,a=r?`sprint = ${r}`:`sprint = "${e}"`,u=i?`project = ${i} AND `:"",l=n?` AND status = "${n}"`:"",d=`${u}${a}${l} ORDER BY status ASC, priority DESC`,p=`jql=${encodeURIComponent(d)}&maxResults=${c}&fields=summary,status,assignee,priority,issuetype,project`,m=await R(`/rest/api/3/search/jql?${p}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),y={};for(let _ of f)y[_.status]=(y[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:y,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:r}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await R(`/rest/api/3/issue/${e}/comment?maxResults=${r||50}&orderBy=-created`),o=(n.comments||[]).map(c=>{let a="";return c.body?.content&&(a=he(c.body.content)),{id:c.id,author:c.author?.displayName||"Unknown",body:a,created:c.created,updated:c.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:r}=t;return!e||!r?JSON.stringify({error:"issueKey and body are required"}):(await R(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:r}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:r}=t;return!e||!r?JSON.stringify({error:"issueKey and fields are required"}):(await R(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:r}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:r,toStatus:i,statusName:n,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let c=String(i||n||o||"").trim();if(!r&&!c){let d=((await R(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(p=>({id:p.id,name:p.name,to:p.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:d})}let a=r;if(!a){let d=(await R(`/rest/api/3/issue/${e}/transitions`)).transitions||[],p=re(c),m=d.find(f=>re(f?.name||"")===p||re(f?.to?.name||"")===p);if(!m){let f=Te(c);f.length>=2&&(m=d.find(y=>{let _=Te(y?.name||""),g=Te(y?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),h=g.length>=2&&(g.includes(f)||f.includes(g));return b||h}))}if(!m){let f=d.map(b=>{let h=ge(c,b?.name||""),v=ge(c,b?.to?.name||"");return{t:b,score:Math.max(h,v)}}).sort((b,h)=>h.score-b.score),y=f[0],_=f[1];y&&y.score>=.45&&(!_||y.score-_.score>=.12)&&(m=y.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${c}"`,issueKey:e,availableTransitions:d.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});a=m.id}await R(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:a}}});let u=await R(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:a,statusAfter:u?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description (plain text)"},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text (plain text)"}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, story points, labels, priority)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};import{existsSync as Xr}from"fs";import{fileURLToPath as es}from"url";import{dirname as ts,resolve as rs}from"path";import{resolveIntegrationToken as at}from"@zibby/core/backend-client.js";function ss(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=ts(es(import.meta.url)),t=rs(s,"..","bin","mcp-skill.mjs");return Xr(t)?t:null}async function S(s,t={}){let{token:e}=await at("github"),r=s.startsWith("https://")?s:`https://api.github.com${s}`,i={Authorization:`Bearer ${e}`,Accept:t.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...t.body?{"Content-Type":"application/json"}:{}},n=await fetch(r,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`GitHub API ${n.status}: ${o.slice(0,300)}`)}return t.raw?n.text():n.json()}var ct={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:O.GITHUB,envKeys:["GITHUB_TOKEN"],description:"GitHub \u2014 issues, PRs, commits, code search, file reading",promptFragment:`## GitHub (connected)
75
75
  You have access to the user's GitHub repositories. Available tools:
76
76
 
77
77
  ### Discovery
@@ -109,9 +109,9 @@ When user says "check out repo-name" or "clone repo-name":
109
109
  3. STOP. Do not offer to inspect files or ask what to do next.
110
110
 
111
111
  When user just wants to "look at" or "read" files (not clone):
112
- - Use github_get_file to read individual files via API`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{command:"npx",args:["-y","@modelcontextprotocol/server-github@latest"],env:s}},async handleToolCall(s,t){try{switch(s){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=await S(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(r.items||[]).map(n=>({number:n.number,title:n.title,state:n.state,repo:n.repository_url?.split("/").slice(-2).join("/"),url:n.html_url,user:n.user?.login,isPR:!!n.pull_request,labels:(n.labels||[]).map(o=>o.name),createdAt:n.created_at}));return JSON.stringify({total:r.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",n=await S(`/search/code?q=${encodeURIComponent(e)}${r}${i}&per_page=${t.limit||15}`),o=(n.items||[]).map(c=>({name:c.name,path:c.path,repo:c.repository?.full_name,url:c.html_url,score:c.score}));return JSON.stringify({total:n.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}`);return JSON.stringify({number:n.number,title:n.title,state:n.state,merged:n.merged,body:n.body?.slice(0,5e3),user:n.user?.login,branch:n.head?.ref,base:n.base?.ref,changedFiles:n.changed_files,additions:n.additions,deletions:n.deletions,createdAt:n.created_at,mergedAt:n.merged_at,url:n.html_url,labels:(n.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=n.length>15e3;return JSON.stringify({number:i,diff:o?n.slice(0,15e3):n,truncated:o,totalLength:n.length})}case"github_list_pr_files":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:n.length,files:n.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}/comments?per_page=50`),o=await S(`/repos/${e}/${r}/issues/${i}/comments?per_page=50`),c=[...n.map(a=>({type:"review",user:a.user?.login,body:a.body?.slice(0,1e3),path:a.path,line:a.line,createdAt:a.created_at})),...o.map(a=>({type:"issue",user:a.user?.login,body:a.body?.slice(0,1e3),createdAt:a.created_at}))].sort((a,u)=>new Date(a.createdAt)-new Date(u.createdAt));return JSON.stringify({total:c.length,comments:c})}case"github_create_review":{let{owner:e,repo:r,number:i,body:n,event:o,comments:c}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(a))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let u=Array.isArray(c)?c.filter(p=>p&&p.path&&p.body&&(p.line!=null||p.position!=null)).map(p=>{let m={path:p.path,body:String(p.body)};return p.line!=null?(m.line=Number(p.line),m.side=p.side==="LEFT"?"LEFT":"RIGHT"):m.position=Number(p.position),m}):[];if(a!=="APPROVE"&&!n&&u.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l={event:a};n&&(l.body=String(n)),u.length>0&&(l.comments=u);let d=await S(`/repos/${e}/${r}/pulls/${i}/reviews`,{method:"POST",body:l});return JSON.stringify({ok:!0,id:d.id,state:d.state,event:a,commentsPosted:u.length,url:d.html_url})}case"github_list_commits":{let{owner:e,repo:r,branch:i,path:n,limit:o}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let c=`/repos/${e}/${r}/commits?per_page=${o||20}`;i&&(c+=`&sha=${encodeURIComponent(i)}`),n&&(c+=`&path=${encodeURIComponent(n)}`);let a=await S(c);return JSON.stringify({total:a.length,commits:a.map(u=>({sha:u.sha?.slice(0,8),fullSha:u.sha,message:u.commit?.message?.slice(0,300),author:u.commit?.author?.name,date:u.commit?.author?.date,url:u.html_url}))})}case"github_get_commit":{let{owner:e,repo:r,sha:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let n=await S(`/repos/${e}/${r}/commits/${i}`);return JSON.stringify({sha:n.sha?.slice(0,8),message:n.commit?.message,author:n.commit?.author?.name,date:n.commit?.author?.date,stats:n.stats,files:(n.files||[]).map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_get_file":{let{owner:e,repo:r,path:i,ref:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${r}/contents/${encodeURIComponent(i)}`;n&&(o+=`?ref=${encodeURIComponent(n)}`);let c=await S(o);if(c.type!=="file")return Array.isArray(c)?JSON.stringify({type:"directory",path:i,entries:c.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${c.type}`});let a=Buffer.from(c.content||"","base64").toString("utf-8"),u=a.length>2e4;return JSON.stringify({path:c.path,size:c.size,sha:c.sha?.slice(0,8),content:u?a.slice(0,2e4):a,truncated:u})}case"github_get_user":try{let e=await S("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let r=e.repositories[0],i=r.owner.login,n=r.owner.type,o=n==="Organization"?`/orgs/${i}`:`/users/${i}`,c=await S(o);return JSON.stringify({login:c.login,name:c.name||c.login,avatar:c.avatar_url,bio:c.bio||c.description,type:n,isOrg:n==="Organization",publicRepos:c.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let r=(await S("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of r)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let n=Array.from(i.values());return JSON.stringify({count:n.length,orgs:n,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(g){let b=g.replace(/^~(?=$|\/|\\)/,m);return c(b)},{owner:e,repo:r,destination:i}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let{execSync:n}=await import("child_process"),{join:o,resolve:c}=await import("path"),{existsSync:a,mkdirSync:u}=await import("fs"),{homedir:l,platform:d}=await import("os"),{token:p}=await at("github"),m=l(),y=i?f(i):o(m,"zibby-repos"),_=o(y,r);if(u(y,{recursive:!0}),a(_))return JSON.stringify({error:`Directory ${_} already exists. Remove it first or use a different destination.`,existingPath:_});try{let g=`https://x-access-token:${p}@github.com/${e}/${r}.git`;n(`git clone ${g} "${_}"`,{stdio:"pipe"});let b=d()==="win32",h;return b?h=n(`dir "${_}"`,{encoding:"utf-8",shell:"cmd.exe"}):h=n(`ls -la "${_}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:_,message:`Cloned ${e}/${r} to ${_}`,contents:h.split(`
112
+ - Use github_get_file to read individual files via API`,resolve(){let s=ss();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/github.js","githubSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=await S(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(r.items||[]).map(n=>({number:n.number,title:n.title,state:n.state,repo:n.repository_url?.split("/").slice(-2).join("/"),url:n.html_url,user:n.user?.login,isPR:!!n.pull_request,labels:(n.labels||[]).map(o=>o.name),createdAt:n.created_at}));return JSON.stringify({total:r.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let r=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",n=await S(`/search/code?q=${encodeURIComponent(e)}${r}${i}&per_page=${t.limit||15}`),o=(n.items||[]).map(c=>({name:c.name,path:c.path,repo:c.repository?.full_name,url:c.html_url,score:c.score}));return JSON.stringify({total:n.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}`);return JSON.stringify({number:n.number,title:n.title,state:n.state,merged:n.merged,body:n.body?.slice(0,5e3),user:n.user?.login,branch:n.head?.ref,base:n.base?.ref,changedFiles:n.changed_files,additions:n.additions,deletions:n.deletions,createdAt:n.created_at,mergedAt:n.merged_at,url:n.html_url,labels:(n.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=n.length>15e3;return JSON.stringify({number:i,diff:o?n.slice(0,15e3):n,truncated:o,totalLength:n.length})}case"github_list_pr_files":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:n.length,files:n.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:r,number:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/pulls/${i}/comments?per_page=50`),o=await S(`/repos/${e}/${r}/issues/${i}/comments?per_page=50`),c=[...n.map(a=>({type:"review",user:a.user?.login,body:a.body?.slice(0,1e3),path:a.path,line:a.line,createdAt:a.created_at})),...o.map(a=>({type:"issue",user:a.user?.login,body:a.body?.slice(0,1e3),createdAt:a.created_at}))].sort((a,u)=>new Date(a.createdAt)-new Date(u.createdAt));return JSON.stringify({total:c.length,comments:c})}case"github_create_review":{let{owner:e,repo:r,number:i,body:n,event:o,comments:c}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(a))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let u=Array.isArray(c)?c.filter(p=>p&&p.path&&p.body&&(p.line!=null||p.position!=null)).map(p=>{let m={path:p.path,body:String(p.body)};return p.line!=null?(m.line=Number(p.line),m.side=p.side==="LEFT"?"LEFT":"RIGHT"):m.position=Number(p.position),m}):[];if(a!=="APPROVE"&&!n&&u.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l={event:a};n&&(l.body=String(n)),u.length>0&&(l.comments=u);let d=await S(`/repos/${e}/${r}/pulls/${i}/reviews`,{method:"POST",body:l});return JSON.stringify({ok:!0,id:d.id,state:d.state,event:a,commentsPosted:u.length,url:d.html_url})}case"github_list_commits":{let{owner:e,repo:r,branch:i,path:n,limit:o}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let c=`/repos/${e}/${r}/commits?per_page=${o||20}`;i&&(c+=`&sha=${encodeURIComponent(i)}`),n&&(c+=`&path=${encodeURIComponent(n)}`);let a=await S(c);return JSON.stringify({total:a.length,commits:a.map(u=>({sha:u.sha?.slice(0,8),fullSha:u.sha,message:u.commit?.message?.slice(0,300),author:u.commit?.author?.name,date:u.commit?.author?.date,url:u.html_url}))})}case"github_get_commit":{let{owner:e,repo:r,sha:i}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let n=await S(`/repos/${e}/${r}/commits/${i}`);return JSON.stringify({sha:n.sha?.slice(0,8),message:n.commit?.message,author:n.commit?.author?.name,date:n.commit?.author?.date,stats:n.stats,files:(n.files||[]).map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_get_file":{let{owner:e,repo:r,path:i,ref:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${r}/contents/${encodeURIComponent(i)}`;n&&(o+=`?ref=${encodeURIComponent(n)}`);let c=await S(o);if(c.type!=="file")return Array.isArray(c)?JSON.stringify({type:"directory",path:i,entries:c.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${c.type}`});let a=Buffer.from(c.content||"","base64").toString("utf-8"),u=a.length>2e4;return JSON.stringify({path:c.path,size:c.size,sha:c.sha?.slice(0,8),content:u?a.slice(0,2e4):a,truncated:u})}case"github_get_user":try{let e=await S("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let r=e.repositories[0],i=r.owner.login,n=r.owner.type,o=n==="Organization"?`/orgs/${i}`:`/users/${i}`,c=await S(o);return JSON.stringify({login:c.login,name:c.name||c.login,avatar:c.avatar_url,bio:c.bio||c.description,type:n,isOrg:n==="Organization",publicRepos:c.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let r=(await S("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of r)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let n=Array.from(i.values());return JSON.stringify({count:n.length,orgs:n,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(g){let b=g.replace(/^~(?=$|\/|\\)/,m);return c(b)},{owner:e,repo:r,destination:i}=t;if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let{execSync:n}=await import("child_process"),{join:o,resolve:c}=await import("path"),{existsSync:a,mkdirSync:u}=await import("fs"),{homedir:l,platform:d}=await import("os"),{token:p}=await at("github"),m=l(),y=i?f(i):o(m,"zibby-repos"),_=o(y,r);if(u(y,{recursive:!0}),a(_))return JSON.stringify({error:`Directory ${_} already exists. Remove it first or use a different destination.`,existingPath:_});try{let g=`https://x-access-token:${p}@github.com/${e}/${r}.git`;n(`git clone ${g} "${_}"`,{stdio:"pipe"});let b=d()==="win32",h;return b?h=n(`dir "${_}"`,{encoding:"utf-8",shell:"cmd.exe"}):h=n(`ls -la "${_}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:_,message:`Cloned ${e}/${r} to ${_}`,contents:h.split(`
113
113
  `).slice(0,30).join(`
114
- `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(g){return JSON.stringify({error:`Clone failed: ${g.message}`})}}case"github_search_repos":{let{query:e,limit:r}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),n=JSON.parse(i);if(n.error)return JSON.stringify(n);let o=e.toLowerCase(),c=n.repos.filter(a=>a.name.toLowerCase().includes(o)||a.fullName.toLowerCase().includes(o)||a.description&&a.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:c.length,repos:c.slice(0,r||20)})}case"github_list_repos":{let{owner:e,type:r,sort:i,direction:n,limit:o}=t,c=100,a=o||200,u=[];if(!e){let f=1,y=!0;for(;y&&u.length<a;){let h=`/installation/repositories?per_page=${c}&page=${f}`,T=(await S(h)).repositories||[];if(T.length===0)break;u=u.concat(T),y=T.length===c,f++}let _=u.slice(0,a).map(h=>({name:h.name,fullName:h.full_name,private:h.private,description:h.description,language:h.language,defaultBranch:h.default_branch,updatedAt:h.updated_at,stars:h.stargazers_count,url:h.html_url})),g=_.filter(h=>h.private).length,b=_.filter(h=>!h.private).length;return JSON.stringify({count:_.length,repos:_,privateCount:g,publicCount:b,message:`Found ${g} private and ${b} public repos`})}let l=await S(`/orgs/${e}`).then(()=>!0).catch(()=>!1),d=1,p=!0;for(;p&&u.length<a;){let f;l?f=`/orgs/${e}/repos?per_page=${c}&page=${d}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`:f=`/users/${e}/repos?per_page=${c}&page=${d}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`;let y=await S(f),_=Array.isArray(y)?y:[];if(_.length===0)break;u=u.concat(_),p=_.length===c,d++}let m=u.slice(0,a).map(f=>({name:f.name,fullName:f.full_name,private:f.private,description:f.description,language:f.language,defaultBranch:f.default_branch,updatedAt:f.updated_at,stars:f.stargazers_count,url:f.html_url}));return JSON.stringify({count:m.length,repos:m})}case"github_create_issue":{let{owner:e,repo:r,title:i,body:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await S(`/repos/${e}/${r}/issues`,{method:"POST",body:{title:i,body:n||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:r,state:i,labels:n,since:o,assignee:c,sort:a,direction:u,limit:l}=t||{};if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let d=new URLSearchParams;d.set("state",i||"open"),d.set("per_page",String(l||30)),d.set("sort",a||"updated"),d.set("direction",u||"desc"),n&&d.set("labels",Array.isArray(n)?n.join(","):n),o&&d.set("since",o),c&&d.set("assignee",c);let p=await S(`/repos/${e}/${r}/issues?${d.toString()}`),m=(Array.isArray(p)?p:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(y=>typeof y=="string"?y:y.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(y=>y.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/issues/${i}`);return n.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:n.number,title:n.title,body:n.body||"",state:n.state,stateReason:n.state_reason||null,labels:(n.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:n.assignee?.login||null,assignees:(n.assignees||[]).map(o=>o.login),user:n.user?.login,milestone:n.milestone?.title||null,comments:n.comments,url:n.html_url,createdAt:n.created_at,updatedAt:n.updated_at,closedAt:n.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:r,number:i,limit:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await S(`/repos/${e}/${r}/issues/${i}/comments?per_page=${n||100}`),c=(Array.isArray(o)?o:[]).map(a=>({id:a.id,user:a.user?.login,body:a.body||"",createdAt:a.created_at,updatedAt:a.updated_at,url:a.html_url}));return JSON.stringify({count:c.length,comments:c})}case"github_add_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await S(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:n}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:r,number:i,stateReason:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};n&&(o.state_reason=n);let c=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:c.number,state:c.state,stateReason:c.state_reason||null,url:c.html_url})}case"github_reopen_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:n.number,state:n.state,url:n.html_url})}case"github_label_issue":{let{owner:e,repo:r,number:i,labels:n,mode:o}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=Array.isArray(n)?n:n?[n]:[];if(!c.length)return JSON.stringify({error:"labels (string or array) is required"});let a=o||"add";if(a==="set"){let l=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{labels:c}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(d=>typeof d=="string"?d:d.name)})}if(a==="remove"){for(let d of c)await S(`/repos/${e}/${r}/issues/${i}/labels/${encodeURIComponent(d)}`,{method:"DELETE"});let l=await S(`/repos/${e}/${r}/issues/${i}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(d=>typeof d=="string"?d:d.name)})}let u=await S(`/repos/${e}/${r}/issues/${i}/labels`,{method:"POST",body:{labels:c}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(u)?u:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List repositories for a user or org. If no owner given, lists the authenticated user's repos.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list your own repos."},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: 30)"}}}},{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_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List recent commits on a branch, optionally filtered by file path",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Max commits (default: 20)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_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"]}}]};function Xr(){let s=process.env.GITLAB_API_URL;if(s)return s.replace(/\/+$/,"");let t=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(t)?t:`${t}/api/v4`}function es(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let s=process.env.GITLAB_TOKEN;if(!s)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":s}}async function x(s,t={}){let e=/^https?:\/\//.test(s)?s:`${Xr()}${s}`,r={Accept:"application/json","User-Agent":"Zibby-App",...es(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:r,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let n=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${n.slice(0,300)}`)}return t.raw?i.text():i.json()}function D(s){let t=String(s);return/^\d+$/.test(t)?t:encodeURIComponent(t)}var lt={id:"gitlab",serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:O.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)
114
+ `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(g){return JSON.stringify({error:`Clone failed: ${g.message}`})}}case"github_search_repos":{let{query:e,limit:r}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),n=JSON.parse(i);if(n.error)return JSON.stringify(n);let o=e.toLowerCase(),c=n.repos.filter(a=>a.name.toLowerCase().includes(o)||a.fullName.toLowerCase().includes(o)||a.description&&a.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:c.length,repos:c.slice(0,r||20)})}case"github_list_repos":{let{owner:e,type:r,sort:i,direction:n,limit:o}=t,c=100,a=o||200,u=[];if(!e){let f=1,y=!0;for(;y&&u.length<a;){let h=`/installation/repositories?per_page=${c}&page=${f}`,T=(await S(h)).repositories||[];if(T.length===0)break;u=u.concat(T),y=T.length===c,f++}let _=u.slice(0,a).map(h=>({name:h.name,fullName:h.full_name,private:h.private,description:h.description,language:h.language,defaultBranch:h.default_branch,updatedAt:h.updated_at,stars:h.stargazers_count,url:h.html_url})),g=_.filter(h=>h.private).length,b=_.filter(h=>!h.private).length;return JSON.stringify({count:_.length,repos:_,privateCount:g,publicCount:b,message:`Found ${g} private and ${b} public repos`})}let l=await S(`/orgs/${e}`).then(()=>!0).catch(()=>!1),d=1,p=!0;for(;p&&u.length<a;){let f;l?f=`/orgs/${e}/repos?per_page=${c}&page=${d}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`:f=`/users/${e}/repos?per_page=${c}&page=${d}&type=${r||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`;let y=await S(f),_=Array.isArray(y)?y:[];if(_.length===0)break;u=u.concat(_),p=_.length===c,d++}let m=u.slice(0,a).map(f=>({name:f.name,fullName:f.full_name,private:f.private,description:f.description,language:f.language,defaultBranch:f.default_branch,updatedAt:f.updated_at,stars:f.stargazers_count,url:f.html_url}));return JSON.stringify({count:m.length,repos:m})}case"github_create_issue":{let{owner:e,repo:r,title:i,body:n}=t;if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await S(`/repos/${e}/${r}/issues`,{method:"POST",body:{title:i,body:n||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:r,state:i,labels:n,since:o,assignee:c,sort:a,direction:u,limit:l}=t||{};if(!e||!r)return JSON.stringify({error:"owner and repo are required"});let d=new URLSearchParams;d.set("state",i||"open"),d.set("per_page",String(l||30)),d.set("sort",a||"updated"),d.set("direction",u||"desc"),n&&d.set("labels",Array.isArray(n)?n.join(","):n),o&&d.set("since",o),c&&d.set("assignee",c);let p=await S(`/repos/${e}/${r}/issues?${d.toString()}`),m=(Array.isArray(p)?p:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(y=>typeof y=="string"?y:y.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(y=>y.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/issues/${i}`);return n.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:n.number,title:n.title,body:n.body||"",state:n.state,stateReason:n.state_reason||null,labels:(n.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:n.assignee?.login||null,assignees:(n.assignees||[]).map(o=>o.login),user:n.user?.login,milestone:n.milestone?.title||null,comments:n.comments,url:n.html_url,createdAt:n.created_at,updatedAt:n.updated_at,closedAt:n.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:r,number:i,limit:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await S(`/repos/${e}/${r}/issues/${i}/comments?per_page=${n||100}`),c=(Array.isArray(o)?o:[]).map(a=>({id:a.id,user:a.user?.login,body:a.body||"",createdAt:a.created_at,updatedAt:a.updated_at,url:a.html_url}));return JSON.stringify({count:c.length,comments:c})}case"github_add_issue_comment":{let{owner:e,repo:r,number:i,body:n}=t||{};if(!e||!r||!i||!n)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await S(`/repos/${e}/${r}/issues/${i}/comments`,{method:"POST",body:{body:n}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:r,number:i,stateReason:n}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};n&&(o.state_reason=n);let c=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:c.number,state:c.state,stateReason:c.state_reason||null,url:c.html_url})}case"github_reopen_issue":{let{owner:e,repo:r,number:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:n.number,state:n.state,url:n.html_url})}case"github_label_issue":{let{owner:e,repo:r,number:i,labels:n,mode:o}=t||{};if(!e||!r||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=Array.isArray(n)?n:n?[n]:[];if(!c.length)return JSON.stringify({error:"labels (string or array) is required"});let a=o||"add";if(a==="set"){let l=await S(`/repos/${e}/${r}/issues/${i}`,{method:"PATCH",body:{labels:c}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(d=>typeof d=="string"?d:d.name)})}if(a==="remove"){for(let d of c)await S(`/repos/${e}/${r}/issues/${i}/labels/${encodeURIComponent(d)}`,{method:"DELETE"});let l=await S(`/repos/${e}/${r}/issues/${i}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(d=>typeof d=="string"?d:d.name)})}let u=await S(`/repos/${e}/${r}/issues/${i}/labels`,{method:"POST",body:{labels:c}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(u)?u:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List repositories for a user or org. If no owner given, lists the authenticated user's repos.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list your own repos."},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: 30)"}}}},{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_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List recent commits on a branch, optionally filtered by file path",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Max commits (default: 20)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_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 is}from"fs";import{fileURLToPath as ns}from"url";import{dirname as os,resolve as as}from"path";function cs(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=os(ns(import.meta.url)),t=as(s,"..","bin","mcp-skill.mjs");return is(t)?t:null}function ls(){let s=process.env.GITLAB_API_URL;if(s)return s.replace(/\/+$/,"");let t=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(t)?t:`${t}/api/v4`}function us(){if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let s=process.env.GITLAB_TOKEN;if(!s)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":s}}async function L(s,t={}){let e=/^https?:\/\//.test(s)?s:`${ls()}${s}`,r={Accept:"application/json","User-Agent":"Zibby-App",...us(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:r,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let n=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${n.slice(0,300)}`)}return t.raw?i.text():i.json()}function D(s){let t=String(s);return/^\d+$/.test(t)?t:encodeURIComponent(t)}var lt={id:"gitlab",serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:O.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)
115
115
  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:
116
116
 
117
117
  ### Merge requests
@@ -129,7 +129,7 @@ You have access to the user's GitLab projects via the REST API (cloud gitlab.com
129
129
 
130
130
  ### Notes
131
131
  - 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.
132
- - If an inline position is rejected by GitLab (bad line anchor), fall back to gitlab_post_mr_note with the file/line in the text.`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{command:null,args:[],env:s,description:this.description}},async handleToolCall(s,t){try{switch(s){case"gitlab_get_mr":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await x(`/projects/${D(e)}/merge_requests/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await x(`/projects/${D(e)}/merge_requests/${r}/changes`),n=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:n.length,diffRefs:i.diff_refs||null,files:n.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_mrs":{let{projectId:e,state:r,targetBranch:i,sourceBranch:n,authorUsername:o,labels:c,search:a,sort:u,orderBy:l,limit:d}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let p=new URLSearchParams;p.set("state",r||"opened"),p.set("per_page",String(d||20)),p.set("order_by",l||"updated_at"),p.set("sort",u||"desc"),i&&p.set("target_branch",i),n&&p.set("source_branch",n),o&&p.set("author_username",o),c&&p.set("labels",Array.isArray(c)?c.join(","):c),a&&p.set("search",a);let m=await x(`/projects/${D(e)}/merge_requests?${p.toString()}`),f=(Array.isArray(m)?m:[]).map(y=>({iid:y.iid,title:y.title,state:y.state,author:y.author?.username,sourceBranch:y.source_branch,targetBranch:y.target_branch,draft:y.draft??y.work_in_progress??!1,labels:Array.isArray(y.labels)?y.labels:[],webUrl:y.web_url,createdAt:y.created_at,updatedAt:y.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:r,limit:i}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let n=await x(`/projects/${D(e)}/merge_requests/${r}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(n)?n.length:0,notes:(Array.isArray(n)?n:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await x(`/projects/${D(e)}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:r,path:i,oldPath:n,newLine:o,oldLine:c,body:a}=t||{};if(!e||!r||!i||!a)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&c==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let u=D(e),l=t.diffRefs||null;if(l||(l=(await x(`/projects/${u}/merge_requests/${r}`)).diff_refs||null),!l||!l.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let d={base_sha:l.base_sha,start_sha:l.start_sha,head_sha:l.head_sha,position_type:"text",new_path:i,old_path:n||i};o!=null&&(d.new_line=Number(o)),c!=null&&(d.old_line=Number(c));try{let p=await x(`/projects/${u}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(a),position:d}});return JSON.stringify({ok:!0,discussionId:p.id})}catch(p){return JSON.stringify({ok:!1,error:`inline anchor rejected (${p.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:r,body:i,comments:n}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let o=D(e),c=Array.isArray(n)?n.filter(p=>p&&p.path&&p.body&&(p.newLine!=null||p.oldLine!=null)):[];if(!i&&c.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let a=t.diffRefs||null;c.length>0&&!a&&(a=(await x(`/projects/${o}/merge_requests/${r}`)).diff_refs||null);let u=!1;i&&(await x(`/projects/${o}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}}),u=!0);let l=0,d=[];if(c.length>0&&a)for(let p of c){let m={base_sha:a.base_sha,start_sha:a.start_sha,head_sha:a.head_sha,position_type:"text",new_path:p.path,old_path:p.oldPath||p.path};p.newLine!=null&&(m.new_line=Number(p.newLine)),p.oldLine!=null&&(m.old_line=Number(p.oldLine));try{await x(`/projects/${o}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(p.body),position:m}}),l+=1}catch(f){d.push(`${p.path}:${p.newLine??p.oldLine} \u2014 ${f.message}`)}}else c.length>0&&!a&&d.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:u,inlinePosted:l,inlineErrors:d.length?d:void 0})}case"gitlab_list_issues":{let{projectId:e,state:r,labels:i,assigneeUsername:n,authorUsername:o,updatedAfter:c,search:a,sort:u,orderBy:l,limit:d}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let p=new URLSearchParams;p.set("state",r||"opened"),p.set("per_page",String(d||30)),p.set("order_by",l||"updated_at"),p.set("sort",u||"desc"),i&&p.set("labels",Array.isArray(i)?i.join(","):i),n&&p.set("assignee_username",n),o&&p.set("author_username",o),c&&p.set("updated_after",c),a&&p.set("search",a);let m=await x(`/projects/${D(e)}/issues?${p.toString()}`),f=(Array.isArray(m)?m:[]).map(y=>({iid:y.iid,title:y.title,state:y.state,labels:Array.isArray(y.labels)?y.labels:[],author:y.author?.username,assignees:(y.assignees||[]).map(_=>_.username),userNotesCount:y.user_notes_count,webUrl:y.web_url,createdAt:y.created_at,updatedAt:y.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await x(`/projects/${D(e)}/issues/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(n=>n.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await x(`/projects/${D(e)}/issues/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"gitlab_get_mr",description:"Get a GitLab merge request \u2014 title, description, branches, state, author, web url, and diff_refs (needed to anchor inline review comments).",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_get_mr_changes",description:"Get the changed files of a GitLab merge request with per-file diffs \u2014 the actual code changes to review. Also returns diff_refs for inline comments.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid"}},required:["projectId","iid"]}},{name:"gitlab_list_mrs",description:"List a GitLab project's merge requests, filtered by state and other criteria. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","merged","locked","all"],description:"Filter by state (default: opened)"},targetBranch:{type:"string",description:"Filter by target branch"},sourceBranch:{type:"string",description:"Filter by source branch"},authorUsername:{type:"string",description:"Filter by author username"},labels:{type:"array",items:{type:"string"},description:"Only MRs carrying ALL of these labels"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at","title"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max MRs (default: 20)"}},required:["projectId"]}},{name:"gitlab_list_mr_notes",description:"List the discussion notes on a GitLab merge request (chronological).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},limit:{type:"number",description:"Max notes (default 50)"}},required:["projectId","iid"]}},{name:"gitlab_post_mr_note",description:"Post a general (non-inline) comment on a GitLab merge request. Use for a review summary or a top-level remark.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}},{name:"gitlab_post_mr_discussion",description:"Post an INLINE review comment anchored to a file + line in a GitLab merge request diff. Provide newLine (added/changed line) or oldLine (removed/context line). Pass diffRefs from gitlab_get_mr/gitlab_get_mr_changes, or omit to have the tool fetch them. If the line anchor is rejected, fall back to gitlab_post_mr_note.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr. Omit and the tool fetches them."}},required:["projectId","iid","path","body"]}},{name:"gitlab_create_mr_review",description:"Post a full review on a GitLab merge request in one call: a summary note plus optional inline comments anchored to file/line in the diff. Convenience wrapper over gitlab_post_mr_note + gitlab_post_mr_discussion.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"The review summary (markdown). Posted as a top-level MR note."},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr \u2014 required to anchor inline comments. Omit and the tool fetches them."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line in a file.",items:{type:"object",properties:{path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","body"]}}},required:["projectId","iid"]}},{name:"gitlab_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"]}}]};var ts=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function rs(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let s=process.env.LINEAR_API_KEY;if(!s)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return s}async function U(s,t={}){let e=await fetch(ts,{method:"POST",headers:{Authorization:rs(),"Content-Type":"application/json"},body:JSON.stringify({query:s,variables:t})});if(!e.ok){let i=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${i.slice(0,300)}`)}let r=await e.json().catch(()=>null);if(!r)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(r.errors)&&r.errors.length){let i=r.errors.map(n=>n?.message||String(n)).join("; ");throw new Error(`Linear GraphQL error: ${i.slice(0,300)}`)}return r.data}function ce(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function ss(s,t){let e=ce(s),r=ce(t);if(!e||!r)return 0;if(e===r)return 1;if(e.length===1||r.length===1)return e===r?1:0;let i=l=>{let d=new Map;for(let p=0;p<l.length-1;p++){let m=l.slice(p,p+2);d.set(m,(d.get(m)||0)+1)}return d},n=i(e),o=i(r),c=0,a=0,u=0;for(let l of n.values())a+=l;for(let l of o.values())u+=l;for(let[l,d]of n.entries())c+=Math.min(d,o.get(l)||0);return 2*c/Math.max(1,a+u)}function is(s,t){let e=Array.isArray(s)?s:[];if(!e.length)return{state:null,strategy:"no-states"};let r=ce(t);if(!r)return{state:null,strategy:"no-target"};let i=e.find(c=>ce(c.name)===r);if(i)return{state:i,strategy:"exact"};let n={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[c,a]of Object.entries(n)){if(!a.some(l=>ce(l)===r))continue;let u=e.find(l=>l.type===c);if(u)return{state:u,strategy:"type-alias"}}let o=e.map(c=>({s:c,score:ss(t,c.name)})).sort((c,a)=>a.score-c.score);return o[0]&&o[0].score>=.5?{state:o[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var ns=`
132
+ - If an inline position is rejected by GitLab (bad line anchor), fall back to gitlab_post_mr_note with the file/line in the text.`,resolve(){let s=cs();if(!s)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s,"../dist/gitlab.js","gitlabSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"gitlab_get_mr":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await L(`/projects/${D(e)}/merge_requests/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await L(`/projects/${D(e)}/merge_requests/${r}/changes`),n=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:n.length,diffRefs:i.diff_refs||null,files:n.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_mrs":{let{projectId:e,state:r,targetBranch:i,sourceBranch:n,authorUsername:o,labels:c,search:a,sort:u,orderBy:l,limit:d}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let p=new URLSearchParams;p.set("state",r||"opened"),p.set("per_page",String(d||20)),p.set("order_by",l||"updated_at"),p.set("sort",u||"desc"),i&&p.set("target_branch",i),n&&p.set("source_branch",n),o&&p.set("author_username",o),c&&p.set("labels",Array.isArray(c)?c.join(","):c),a&&p.set("search",a);let m=await L(`/projects/${D(e)}/merge_requests?${p.toString()}`),f=(Array.isArray(m)?m:[]).map(y=>({iid:y.iid,title:y.title,state:y.state,author:y.author?.username,sourceBranch:y.source_branch,targetBranch:y.target_branch,draft:y.draft??y.work_in_progress??!1,labels:Array.isArray(y.labels)?y.labels:[],webUrl:y.web_url,createdAt:y.created_at,updatedAt:y.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:r,limit:i}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let n=await L(`/projects/${D(e)}/merge_requests/${r}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(n)?n.length:0,notes:(Array.isArray(n)?n:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await L(`/projects/${D(e)}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:r,path:i,oldPath:n,newLine:o,oldLine:c,body:a}=t||{};if(!e||!r||!i||!a)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&c==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let u=D(e),l=t.diffRefs||null;if(l||(l=(await L(`/projects/${u}/merge_requests/${r}`)).diff_refs||null),!l||!l.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let d={base_sha:l.base_sha,start_sha:l.start_sha,head_sha:l.head_sha,position_type:"text",new_path:i,old_path:n||i};o!=null&&(d.new_line=Number(o)),c!=null&&(d.old_line=Number(c));try{let p=await L(`/projects/${u}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(a),position:d}});return JSON.stringify({ok:!0,discussionId:p.id})}catch(p){return JSON.stringify({ok:!1,error:`inline anchor rejected (${p.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:r,body:i,comments:n}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let o=D(e),c=Array.isArray(n)?n.filter(p=>p&&p.path&&p.body&&(p.newLine!=null||p.oldLine!=null)):[];if(!i&&c.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let a=t.diffRefs||null;c.length>0&&!a&&(a=(await L(`/projects/${o}/merge_requests/${r}`)).diff_refs||null);let u=!1;i&&(await L(`/projects/${o}/merge_requests/${r}/notes`,{method:"POST",body:{body:String(i)}}),u=!0);let l=0,d=[];if(c.length>0&&a)for(let p of c){let m={base_sha:a.base_sha,start_sha:a.start_sha,head_sha:a.head_sha,position_type:"text",new_path:p.path,old_path:p.oldPath||p.path};p.newLine!=null&&(m.new_line=Number(p.newLine)),p.oldLine!=null&&(m.old_line=Number(p.oldLine));try{await L(`/projects/${o}/merge_requests/${r}/discussions`,{method:"POST",body:{body:String(p.body),position:m}}),l+=1}catch(f){d.push(`${p.path}:${p.newLine??p.oldLine} \u2014 ${f.message}`)}}else c.length>0&&!a&&d.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:u,inlinePosted:l,inlineErrors:d.length?d:void 0})}case"gitlab_list_issues":{let{projectId:e,state:r,labels:i,assigneeUsername:n,authorUsername:o,updatedAfter:c,search:a,sort:u,orderBy:l,limit:d}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let p=new URLSearchParams;p.set("state",r||"opened"),p.set("per_page",String(d||30)),p.set("order_by",l||"updated_at"),p.set("sort",u||"desc"),i&&p.set("labels",Array.isArray(i)?i.join(","):i),n&&p.set("assignee_username",n),o&&p.set("author_username",o),c&&p.set("updated_after",c),a&&p.set("search",a);let m=await L(`/projects/${D(e)}/issues?${p.toString()}`),f=(Array.isArray(m)?m:[]).map(y=>({iid:y.iid,title:y.title,state:y.state,labels:Array.isArray(y.labels)?y.labels:[],author:y.author?.username,assignees:(y.assignees||[]).map(_=>_.username),userNotesCount:y.user_notes_count,webUrl:y.web_url,createdAt:y.created_at,updatedAt:y.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:r}=t||{};if(!e||!r)return JSON.stringify({error:"projectId and iid are required"});let i=await L(`/projects/${D(e)}/issues/${r}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(n=>n.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:r,body:i}=t||{};if(!e||!r||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let n=await L(`/projects/${D(e)}/issues/${r}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:n.id,createdAt:n.created_at})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"gitlab_get_mr",description:"Get a GitLab merge request \u2014 title, description, branches, state, author, web url, and diff_refs (needed to anchor inline review comments).",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid (the per-project MR number in the URL)"}},required:["projectId","iid"]}},{name:"gitlab_get_mr_changes",description:"Get the changed files of a GitLab merge request with per-file diffs \u2014 the actual code changes to review. Also returns diff_refs for inline comments.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},iid:{type:"number",description:"Merge request iid"}},required:["projectId","iid"]}},{name:"gitlab_list_mrs",description:"List a GitLab project's merge requests, filtered by state and other criteria. Returns newest-updated first.",input_schema:{type:"object",properties:{projectId:{type:"string",description:'Project numeric id OR full path (e.g. "group/repo")'},state:{type:"string",enum:["opened","closed","merged","locked","all"],description:"Filter by state (default: opened)"},targetBranch:{type:"string",description:"Filter by target branch"},sourceBranch:{type:"string",description:"Filter by source branch"},authorUsername:{type:"string",description:"Filter by author username"},labels:{type:"array",items:{type:"string"},description:"Only MRs carrying ALL of these labels"},search:{type:"string",description:"Search title and description"},orderBy:{type:"string",enum:["created_at","updated_at","title"],description:"Sort field (default: updated_at)"},sort:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max MRs (default: 20)"}},required:["projectId"]}},{name:"gitlab_list_mr_notes",description:"List the discussion notes on a GitLab merge request (chronological).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},limit:{type:"number",description:"Max notes (default 50)"}},required:["projectId","iid"]}},{name:"gitlab_post_mr_note",description:"Post a general (non-inline) comment on a GitLab merge request. Use for a review summary or a top-level remark.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"Comment body (markdown)"}},required:["projectId","iid","body"]}},{name:"gitlab_post_mr_discussion",description:"Post an INLINE review comment anchored to a file + line in a GitLab merge request diff. Provide newLine (added/changed line) or oldLine (removed/context line). Pass diffRefs from gitlab_get_mr/gitlab_get_mr_changes, or omit to have the tool fetch them. If the line anchor is rejected, fall back to gitlab_post_mr_note.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr. Omit and the tool fetches them."}},required:["projectId","iid","path","body"]}},{name:"gitlab_create_mr_review",description:"Post a full review on a GitLab merge request in one call: a summary note plus optional inline comments anchored to file/line in the diff. Convenience wrapper over gitlab_post_mr_note + gitlab_post_mr_discussion.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"Project numeric id OR full path"},iid:{type:"number",description:"Merge request iid"},body:{type:"string",description:"The review summary (markdown). Posted as a top-level MR note."},diffRefs:{type:"object",description:"The MR diff_refs ({ base_sha, start_sha, head_sha }) from gitlab_get_mr \u2014 required to anchor inline comments. Omit and the tool fetches them."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line in a file.",items:{type:"object",properties:{path:{type:"string",description:"New file path as it appears in the diff"},oldPath:{type:"string",description:"Old file path (defaults to path)"},newLine:{type:"number",description:"Line number in the NEW version of the file (for added/changed lines)"},oldLine:{type:"number",description:"Line number in the OLD version (for removed/context lines)"},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","body"]}}},required:["projectId","iid"]}},{name:"gitlab_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 ds}from"fs";import{fileURLToPath as ps}from"url";import{dirname as ms,resolve as fs}from"path";function ys(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=ms(ps(import.meta.url)),t=fs(s,"..","bin","mcp-skill.mjs");return ds(t)?t:null}var hs=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function gs(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let s=process.env.LINEAR_API_KEY;if(!s)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return s}async function U(s,t={}){let e=await fetch(hs,{method:"POST",headers:{Authorization:gs(),"Content-Type":"application/json"},body:JSON.stringify({query:s,variables:t})});if(!e.ok){let i=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${i.slice(0,300)}`)}let r=await e.json().catch(()=>null);if(!r)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(r.errors)&&r.errors.length){let i=r.errors.map(n=>n?.message||String(n)).join("; ");throw new Error(`Linear GraphQL error: ${i.slice(0,300)}`)}return r.data}function ce(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function _s(s,t){let e=ce(s),r=ce(t);if(!e||!r)return 0;if(e===r)return 1;if(e.length===1||r.length===1)return e===r?1:0;let i=l=>{let d=new Map;for(let p=0;p<l.length-1;p++){let m=l.slice(p,p+2);d.set(m,(d.get(m)||0)+1)}return d},n=i(e),o=i(r),c=0,a=0,u=0;for(let l of n.values())a+=l;for(let l of o.values())u+=l;for(let[l,d]of n.entries())c+=Math.min(d,o.get(l)||0);return 2*c/Math.max(1,a+u)}function bs(s,t){let e=Array.isArray(s)?s:[];if(!e.length)return{state:null,strategy:"no-states"};let r=ce(t);if(!r)return{state:null,strategy:"no-target"};let i=e.find(c=>ce(c.name)===r);if(i)return{state:i,strategy:"exact"};let n={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[c,a]of Object.entries(n)){if(!a.some(l=>ce(l)===r))continue;let u=e.find(l=>l.type===c);if(u)return{state:u,strategy:"type-alias"}}let o=e.map(c=>({s:c,score:_s(t,c.name)})).sort((c,a)=>a.score-c.score);return o[0]&&o[0].score>=.5?{state:o[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var ks=`
133
133
  id
134
134
  identifier
135
135
  number
@@ -161,7 +161,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
161
161
 
162
162
  ### Notes
163
163
  - Always resolve a team first when you need states or want to create/move issues by state name \u2014 states only make sense within their team.
164
- - Issue identifier (ENG-123) and internal id (uuid) are both accepted by get/update tools.`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return process.env.LINEAR_API_URL&&(s.LINEAR_API_URL=process.env.LINEAR_API_URL),{command:null,args:[],env:s,description:this.description}},async handleToolCall(s,t){try{switch(s){case"linear_list_teams":{let r=(await U(`
164
+ - Issue identifier (ENG-123) and internal id (uuid) are both accepted by get/update tools.`,resolve(){let s={};for(let e of this.envKeys)process.env[e]&&(s[e]=process.env[e]);process.env.LINEAR_API_URL&&(s.LINEAR_API_URL=process.env.LINEAR_API_URL);let t=ys();return t?{type:"stdio",command:"node",args:[t,"../dist/linear.js","linearSkill"],env:s,description:this.description,alwaysLoad:!0}:{command:null,args:[],env:s,description:this.description}},async handleToolCall(s,t){try{switch(s){case"linear_list_teams":{let r=(await U(`
165
165
  query Teams($first: Int) {
166
166
  teams(first: $first) {
167
167
  nodes { id key name description }
@@ -214,7 +214,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
214
214
  id identifier
215
215
  state { id name type }
216
216
  team { id key states { nodes { id name type position } } }
217
- `);if(!c)return JSON.stringify({error:`Issue not found: ${e}`});let a=r,u=r?{strategy:"explicit-id"}:null;if(!a){let p=String(i||n||o||"").trim(),m=(c.team?.states?.nodes||[]).slice().sort((y,_)=>(y.position||0)-(_.position||0));if(!p)return JSON.stringify({ok:!1,error:"stateId or stateName/toStatus is required",issue:c.identifier,availableStates:m.map(y=>({id:y.id,name:y.name,type:y.type}))});let f=is(m,p);if(!f.state)return JSON.stringify({ok:!1,error:`No workflow state matches "${p}" in team ${c.team?.key}`,issue:c.identifier,availableStates:m.map(y=>({id:y.id,name:y.name,type:y.type}))});a=f.state.id,u={strategy:f.strategy,matchedName:f.state.name}}let d=(await U(`
217
+ `);if(!c)return JSON.stringify({error:`Issue not found: ${e}`});let a=r,u=r?{strategy:"explicit-id"}:null;if(!a){let p=String(i||n||o||"").trim(),m=(c.team?.states?.nodes||[]).slice().sort((y,_)=>(y.position||0)-(_.position||0));if(!p)return JSON.stringify({ok:!1,error:"stateId or stateName/toStatus is required",issue:c.identifier,availableStates:m.map(y=>({id:y.id,name:y.name,type:y.type}))});let f=bs(m,p);if(!f.state)return JSON.stringify({ok:!1,error:`No workflow state matches "${p}" in team ${c.team?.key}`,issue:c.identifier,availableStates:m.map(y=>({id:y.id,name:y.name,type:y.type}))});a=f.state.id,u={strategy:f.strategy,matchedName:f.state.name}}let d=(await U(`
218
218
  mutation MoveIssue($id: String!, $input: IssueUpdateInput!) {
219
219
  issueUpdate(id: $id, input: $input) {
220
220
  success
@@ -232,7 +232,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
232
232
  query TeamByKey($filter: TeamFilter) {
233
233
  teams(first: 1, filter: $filter) { nodes { id key } }
234
234
  }
235
- `,{filter:{key:{eq:s}}}))?.teams?.nodes?.[0]?.id||null}async function ae(s,t=ns){let e=String(s).trim(),r=/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/.exec(e);if(r){let n=r[1].toUpperCase(),o=Number(r[2]);return(await U(`
235
+ `,{filter:{key:{eq:s}}}))?.teams?.nodes?.[0]?.id||null}async function ae(s,t=ks){let e=String(s).trim(),r=/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/.exec(e);if(r){let n=r[1].toUpperCase(),o=Number(r[2]);return(await U(`
236
236
  query IssueByIdentifier($filter: IssueFilter) {
237
237
  issues(first: 1, filter: $filter) {
238
238
  nodes { ${t} }
@@ -248,24 +248,24 @@ You have direct access to the user's Plane workspace via the official Plane MCP
248
248
  - List/get projects and work items, then create/update/delete or search work items as needed.
249
249
  - For status changes, read the project's available states first, then set the work item's state.
250
250
  - Cycles and modules group work items \u2014 list them to scope queries before drilling into items.
251
- - Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:s,description:this.description}}};import{existsSync as os}from"fs";import{fileURLToPath as as}from"url";import{dirname as cs,resolve as ls}from"path";import{resolveIntegrationToken as us}from"@zibby/core/backend-client.js";function ds(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let s=cs(as(import.meta.url)),t=ls(s,"..","bin","mcp-slack.mjs");return os(t)?t:null}async function J(s,t={}){let{token:e}=await us("slack"),r=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(s),i=`https://slack.com/api/${s}`,n={Authorization:`Bearer ${e}`},o;if(r){let u=new URLSearchParams(t).toString();u&&(i+=`?${u}`)}else n["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let a=await(await fetch(i,{method:r?"GET":"POST",headers:n,body:o})).json();if(!a.ok)throw new Error(`Slack API error: ${a.error}`);return a}var q={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:O.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack (connected)
251
+ - Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let s={};for(let t of this.envKeys)process.env[t]&&(s[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:s,description:this.description}}};import{existsSync as ws}from"fs";import{fileURLToPath as Ss}from"url";import{dirname as vs,resolve as Ns}from"path";import{resolveIntegrationToken as Is}from"@zibby/core/backend-client.js";function Os(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let s=vs(Ss(import.meta.url)),t=Ns(s,"..","bin","mcp-slack.mjs");return ws(t)?t:null}async function J(s,t={}){let{token:e}=await Is("slack"),r=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(s),i=`https://slack.com/api/${s}`,n={Authorization:`Bearer ${e}`},o;if(r){let u=new URLSearchParams(t).toString();u&&(i+=`?${u}`)}else n["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let a=await(await fetch(i,{method:r?"GET":"POST",headers:n,body:o})).json();if(!a.ok)throw new Error(`Slack API error: ${a.error}`);return a}var q={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:O.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack (connected)
252
252
  You have access to the user's Slack workspace. Use these tools:
253
253
  - slack_list_channels, slack_post_message, slack_reply_to_thread
254
254
  - slack_add_reaction, slack_get_channel_history, slack_get_thread_replies
255
255
  - slack_get_users, slack_get_user_profile
256
256
  - slack_lookup_user_by_email (precise email\u2192user_id, prefer this over scanning slack_get_users)
257
- - slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let s=ds();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"slack_list_channels":{let e=await J("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(e.channels||[]).map(r=>({id:r.id,name:r.name,topic:r.topic?.value}))})}case"slack_post_message":{if(!t.channel||!t.text)return JSON.stringify({error:"channel and text are required"});let e=await J("chat.postMessage",{channel:t.channel,text:t.text,...t.blocks?{blocks:t.blocks}:{}});return JSON.stringify({ok:!0,ts:e.ts,channel:e.channel})}case"slack_reply_to_thread":{if(!t.channel||!t.thread_ts||!t.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let e=await J("chat.postMessage",{channel:t.channel,thread_ts:t.thread_ts,text:t.text});return JSON.stringify({ok:!0,ts:e.ts})}case"slack_add_reaction":return!t.channel||!t.timestamp||!t.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await J("reactions.add",{channel:t.channel,timestamp:t.timestamp,name:t.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!t.channel)return JSON.stringify({error:"channel is required"});let e=await J("conversations.history",{channel:t.channel,limit:t.limit||20});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_thread_replies":{if(!t.channel||!t.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let e=await J("conversations.replies",{channel:t.channel,ts:t.thread_ts});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_users":{let e=await J("users.list",{limit:100});return JSON.stringify({users:(e.members||[]).filter(r=>!r.is_bot&&!r.deleted).map(r=>({id:r.id,name:r.real_name||r.name}))})}case"slack_get_user_profile":{if(!t.user_id)return JSON.stringify({error:"user_id is required"});let e=await J("users.profile.get",{user:t.user_id});return JSON.stringify({profile:e.profile})}case"slack_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});try{let e=await J("users.lookupByEmail",{email:t.email});return JSON.stringify({ok:!0,user:{id:e.user?.id,name:e.user?.real_name||e.user?.name,email:e.user?.profile?.email||t.email}})}catch(e){if(/users_not_found/.test(e.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw e}}case"slack_list_usergroups":{let e=await J("usergroups.list",{});return JSON.stringify({usergroups:(e.usergroups||[]).map(r=>({id:r.id,handle:r.handle,name:r.name,description:r.description||"",user_count:Number(r.user_count||0)}))})}case"slack_get_usergroup_members":{if(!t.usergroup)return JSON.stringify({error:"usergroup id is required"});let e=await J("usergroups.users.list",{usergroup:t.usergroup});return JSON.stringify({users:e.users||[]})}case"slack_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=[],n,o=5;for(let a=0;a<o;a+=1){let u={limit:200};n&&(u.cursor=n);let l=await J("users.list",u);for(let d of l.members||[])d.deleted||d.is_bot||i.push(d);if(n=l.response_metadata?.next_cursor,!n)break}let c=[];for(let a of i){let u=(a.real_name||"").toLowerCase(),l=(a.profile?.display_name||"").toLowerCase(),d=(a.name||"").toLowerCase(),p=0;u.includes(e)&&(p+=100-Math.abs(u.length-e.length)),l.includes(e)&&(p+=60-Math.abs(l.length-e.length)),d.includes(e)&&(p+=30-Math.abs(d.length-e.length)),(u===e||l===e)&&(p+=200),p>0&&c.push({id:a.id,name:a.real_name||a.profile?.display_name||a.name,email:a.profile?.email||void 0,_score:p})}return c.sort((a,u)=>u._score-a._score),JSON.stringify({ok:!0,matches:c.slice(0,r).map(({_score:a,...u})=>u),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"slack_list_channels",description:"List public channels in the workspace",input_schema:{type:"object",properties:{}}},{name:"slack_post_message",description:"Post a message to a Slack channel or DM. Pass `blocks` (Block Kit) for a rich card; `text` is the required notification fallback.",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID or name"},text:{type:"string",description:"Notification/fallback text (required)"},blocks:{type:"array",description:"Block Kit blocks for rich formatting (optional). Each block is a Slack Block Kit object (header/section/divider/context). section blocks may carry a button accessory with a url."}},required:["channel","text"]}},{name:"slack_reply_to_thread",description:"Reply to a specific message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"},text:{type:"string",description:"Reply text"}},required:["channel","thread_ts","text"]}},{name:"slack_add_reaction",description:"Add an emoji reaction to a message",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},timestamp:{type:"string",description:"Message timestamp"},reaction:{type:"string",description:"Emoji name without colons"}},required:["channel","timestamp","reaction"]}},{name:"slack_get_channel_history",description:"Get recent messages from a channel",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},limit:{type:"number",description:"Number of messages"}},required:["channel"]}},{name:"slack_get_thread_replies",description:"Get all replies in a message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"}},required:["channel","thread_ts"]}},{name:"slack_get_users",description:"List workspace users with basic profiles",input_schema:{type:"object",properties:{}}},{name:"slack_get_user_profile",description:"Get detailed profile for a specific user",input_schema:{type:"object",properties:{user_id:{type:"string",description:"Slack user ID"}},required:["user_id"]}},{name:"slack_lookup_user_by_email",description:"Find a Slack user by email. Returns { ok:true, user:{id,name,email} } on hit, { ok:false } when no user has that email. Prefer this over slack_get_users for email-based routing \u2014 single API call, exact match.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"slack_list_usergroups",description:"List workspace-defined user groups (e.g. @oncall, @platform). Each item has { id, handle, name, description, user_count }. Use the id with slack_get_usergroup_members to expand the membership.",input_schema:{type:"object",properties:{}}},{name:"slack_get_usergroup_members",description:"List user IDs that belong to a Slack usergroup. Pair with slack_post_message to DM each member, or use the group id directly in a channel message as <!subteam^ID> to @-mention.",input_schema:{type:"object",properties:{usergroup:{type:"string",description:"Usergroup id, e.g. S012ABC"}},required:["usergroup"]}},{name:"slack_search_users",description:'Fuzzy-search workspace users by display name or real name. Use when the user said something like "send to Sam" without an email. Returns up to `limit` ranked matches { id, name, email }. Slack has no native name-search API \u2014 this scans paginated users.list + does substring scoring (real_name > display_name > name). For large workspaces consider higher limit + ask the user to confirm if multiple hit.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}]};import{existsSync as ps}from"fs";import{fileURLToPath as ms}from"url";import{dirname as fs,resolve as ys}from"path";import{resolveIntegrationToken as hs}from"@zibby/core/backend-client.js";function gs(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let s=fs(ms(import.meta.url)),t=ys(s,"..","bin","mcp-lark.mjs");return ps(t)?t:null}var _s=6e3*1e3,le=null;async function bs(){let{appId:s,appSecret:t,host:e}=await hs("lark");if(le&&le.appId===s&&le.expiresAt>Date.now())return{token:le.token,host:e};let i=await(await fetch(`${e}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:s,app_secret:t})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return le={token:i.tenant_access_token,expiresAt:Date.now()+_s,appId:s},{token:i.tenant_access_token,host:e}}async function Q(s,t,e={}){let{token:r,host:i}=await bs(),n=`${i}${t}`,o={method:s,headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json; charset=utf-8"}};s!=="GET"&&(o.body=JSON.stringify(e));let a=await(await fetch(n,o)).json();if(a.code!==0)throw new Error(`Lark API ${t} error: ${a.msg||a.code}`);return a.data||{}}function mt(s){return JSON.stringify({text:s})}function ks(s){return!s||typeof s!="string"||s.startsWith("oc_")?"chat_id":s.startsWith("ou_")?"open_id":s.startsWith("on_")?"union_id":s.startsWith("cli_")?"app_id":s.includes("@")?"email":"chat_id"}var B={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:O.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark (connected)
257
+ - slack_list_usergroups, slack_get_usergroup_members (workspace-defined teams like @oncall, @platform)`,resolve(){let s=Os();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t){try{switch(s){case"slack_list_channels":{let e=await J("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(e.channels||[]).map(r=>({id:r.id,name:r.name,topic:r.topic?.value}))})}case"slack_post_message":{if(!t.channel||!t.text)return JSON.stringify({error:"channel and text are required"});let e=await J("chat.postMessage",{channel:t.channel,text:t.text,...t.blocks?{blocks:t.blocks}:{}});return JSON.stringify({ok:!0,ts:e.ts,channel:e.channel})}case"slack_reply_to_thread":{if(!t.channel||!t.thread_ts||!t.text)return JSON.stringify({error:"channel, thread_ts, and text are required"});let e=await J("chat.postMessage",{channel:t.channel,thread_ts:t.thread_ts,text:t.text});return JSON.stringify({ok:!0,ts:e.ts})}case"slack_add_reaction":return!t.channel||!t.timestamp||!t.reaction?JSON.stringify({error:"channel, timestamp, and reaction are required"}):(await J("reactions.add",{channel:t.channel,timestamp:t.timestamp,name:t.reaction}),JSON.stringify({ok:!0}));case"slack_get_channel_history":{if(!t.channel)return JSON.stringify({error:"channel is required"});let e=await J("conversations.history",{channel:t.channel,limit:t.limit||20});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_thread_replies":{if(!t.channel||!t.thread_ts)return JSON.stringify({error:"channel and thread_ts are required"});let e=await J("conversations.replies",{channel:t.channel,ts:t.thread_ts});return JSON.stringify({messages:(e.messages||[]).map(r=>({user:r.user,text:r.text,ts:r.ts}))})}case"slack_get_users":{let e=await J("users.list",{limit:100});return JSON.stringify({users:(e.members||[]).filter(r=>!r.is_bot&&!r.deleted).map(r=>({id:r.id,name:r.real_name||r.name}))})}case"slack_get_user_profile":{if(!t.user_id)return JSON.stringify({error:"user_id is required"});let e=await J("users.profile.get",{user:t.user_id});return JSON.stringify({profile:e.profile})}case"slack_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});try{let e=await J("users.lookupByEmail",{email:t.email});return JSON.stringify({ok:!0,user:{id:e.user?.id,name:e.user?.real_name||e.user?.name,email:e.user?.profile?.email||t.email}})}catch(e){if(/users_not_found/.test(e.message))return JSON.stringify({ok:!1,reason:"users_not_found"});throw e}}case"slack_list_usergroups":{let e=await J("usergroups.list",{});return JSON.stringify({usergroups:(e.usergroups||[]).map(r=>({id:r.id,handle:r.handle,name:r.name,description:r.description||"",user_count:Number(r.user_count||0)}))})}case"slack_get_usergroup_members":{if(!t.usergroup)return JSON.stringify({error:"usergroup id is required"});let e=await J("usergroups.users.list",{usergroup:t.usergroup});return JSON.stringify({users:e.users||[]})}case"slack_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=[],n,o=5;for(let a=0;a<o;a+=1){let u={limit:200};n&&(u.cursor=n);let l=await J("users.list",u);for(let d of l.members||[])d.deleted||d.is_bot||i.push(d);if(n=l.response_metadata?.next_cursor,!n)break}let c=[];for(let a of i){let u=(a.real_name||"").toLowerCase(),l=(a.profile?.display_name||"").toLowerCase(),d=(a.name||"").toLowerCase(),p=0;u.includes(e)&&(p+=100-Math.abs(u.length-e.length)),l.includes(e)&&(p+=60-Math.abs(l.length-e.length)),d.includes(e)&&(p+=30-Math.abs(d.length-e.length)),(u===e||l===e)&&(p+=200),p>0&&c.push({id:a.id,name:a.real_name||a.profile?.display_name||a.name,email:a.profile?.email||void 0,_score:p})}return c.sort((a,u)=>u._score-a._score),JSON.stringify({ok:!0,matches:c.slice(0,r).map(({_score:a,...u})=>u),scanned:i.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"slack_list_channels",description:"List public channels in the workspace",input_schema:{type:"object",properties:{}}},{name:"slack_post_message",description:"Post a message to a Slack channel or DM. Pass `blocks` (Block Kit) for a rich card; `text` is the required notification fallback.",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID or name"},text:{type:"string",description:"Notification/fallback text (required)"},blocks:{type:"array",description:"Block Kit blocks for rich formatting (optional). Each block is a Slack Block Kit object (header/section/divider/context). section blocks may carry a button accessory with a url."}},required:["channel","text"]}},{name:"slack_reply_to_thread",description:"Reply to a specific message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"},text:{type:"string",description:"Reply text"}},required:["channel","thread_ts","text"]}},{name:"slack_add_reaction",description:"Add an emoji reaction to a message",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},timestamp:{type:"string",description:"Message timestamp"},reaction:{type:"string",description:"Emoji name without colons"}},required:["channel","timestamp","reaction"]}},{name:"slack_get_channel_history",description:"Get recent messages from a channel",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},limit:{type:"number",description:"Number of messages"}},required:["channel"]}},{name:"slack_get_thread_replies",description:"Get all replies in a message thread",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID"},thread_ts:{type:"string",description:"Thread timestamp"}},required:["channel","thread_ts"]}},{name:"slack_get_users",description:"List workspace users with basic profiles",input_schema:{type:"object",properties:{}}},{name:"slack_get_user_profile",description:"Get detailed profile for a specific user",input_schema:{type:"object",properties:{user_id:{type:"string",description:"Slack user ID"}},required:["user_id"]}},{name:"slack_lookup_user_by_email",description:"Find a Slack user by email. Returns { ok:true, user:{id,name,email} } on hit, { ok:false } when no user has that email. Prefer this over slack_get_users for email-based routing \u2014 single API call, exact match.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"slack_list_usergroups",description:"List workspace-defined user groups (e.g. @oncall, @platform). Each item has { id, handle, name, description, user_count }. Use the id with slack_get_usergroup_members to expand the membership.",input_schema:{type:"object",properties:{}}},{name:"slack_get_usergroup_members",description:"List user IDs that belong to a Slack usergroup. Pair with slack_post_message to DM each member, or use the group id directly in a channel message as <!subteam^ID> to @-mention.",input_schema:{type:"object",properties:{usergroup:{type:"string",description:"Usergroup id, e.g. S012ABC"}},required:["usergroup"]}},{name:"slack_search_users",description:'Fuzzy-search workspace users by display name or real name. Use when the user said something like "send to Sam" without an email. Returns up to `limit` ranked matches { id, name, email }. Slack has no native name-search API \u2014 this scans paginated users.list + does substring scoring (real_name > display_name > name). For large workspaces consider higher limit + ask the user to confirm if multiple hit.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}]};import{existsSync as As}from"fs";import{fileURLToPath as Rs}from"url";import{dirname as $s,resolve as js}from"path";import{resolveIntegrationToken as Ts}from"@zibby/core/backend-client.js";function Es(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let s=$s(Rs(import.meta.url)),t=js(s,"..","bin","mcp-lark.mjs");return As(t)?t:null}var Ls=6e3*1e3,le=null;async function xs(){let{appId:s,appSecret:t,host:e}=await Ts("lark");if(le&&le.appId===s&&le.expiresAt>Date.now())return{token:le.token,host:e};let i=await(await fetch(`${e}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:s,app_secret:t})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return le={token:i.tenant_access_token,expiresAt:Date.now()+Ls,appId:s},{token:i.tenant_access_token,host:e}}async function Q(s,t,e={}){let{token:r,host:i}=await xs(),n=`${i}${t}`,o={method:s,headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json; charset=utf-8"}};s!=="GET"&&(o.body=JSON.stringify(e));let a=await(await fetch(n,o)).json();if(a.code!==0)throw new Error(`Lark API ${t} error: ${a.msg||a.code}`);return a.data||{}}function mt(s){return JSON.stringify({text:s})}function Cs(s){return!s||typeof s!="string"||s.startsWith("oc_")?"chat_id":s.startsWith("ou_")?"open_id":s.startsWith("on_")?"union_id":s.startsWith("cli_")?"app_id":s.includes("@")?"email":"chat_id"}var B={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:O.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark (connected)
258
258
  You can send messages and replies on Lark. Use:
259
259
  - lark_send_message: post a message to a chat, user, or DM
260
260
  - lark_reply: reply to an existing message (threaded)
261
261
  - lark_list_chats: list chats the bot is a member of
262
262
  - lark_get_chat_history: fetch recent messages in a chat
263
263
  - 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)
264
- When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let s=gs();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},tools:[{name:"lark_send_message",description:"Send a text message to a Lark chat, user, or DM. receive_id can be a chat_id (oc_*), open_id (ou_*), union_id (on_*), or email.",input_schema:{type:"object",properties:{receive_id:{type:"string",description:"Target id: chat_id (oc_*), open_id (ou_*), union_id (on_*), or email"},text:{type:"string",description:"Message text"}},required:["receive_id","text"]}},{name:"lark_reply",description:"Reply to an existing Lark message (creates a thread). Use the message_id from the inbound event.",input_schema:{type:"object",properties:{message_id:{type:"string",description:"Lark message id (om_*) to reply to"},text:{type:"string",description:"Reply text"}},required:["message_id","text"]}},{name:"lark_list_chats",description:"List chats (groups + DMs) the bot is a member of.",input_schema:{type:"object",properties:{page_size:{type:"number",description:"Max results (default 50)"}}}},{name:"lark_get_chat_history",description:"Fetch recent messages in a chat.",input_schema:{type:"object",properties:{chat_id:{type:"string",description:"Chat id (oc_*)"},page_size:{type:"number",description:"Max messages (default 20)"}},required:["chat_id"]}},{name:"lark_lookup_user_by_email",description:"Resolve an email address to a Lark user id (open_id). Returns { ok:true, user:{open_id,email,name} } on hit, { ok:false } if no Lark user has that email. Use the open_id as `receive_id` in lark_send_message to DM.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"lark_search_users",description:'Fuzzy-search users by name across chats the bot is a member of. Lark has no public org-wide user search API for bots \u2014 this walks the bot\'s chat memberships and matches names client-side. Best for "send to Sam" style routing where you have a name but no email. Returns up to `limit` ranked matches { open_id, name }.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against user names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}],async handleToolCall(s,t){try{switch(s){case"lark_send_message":{if(!t.receive_id||!t.text)return JSON.stringify({error:"receive_id and text are required"});let e=ks(t.receive_id),r=await Q("POST",`/open-apis/im/v1/messages?receive_id_type=${e}`,{receive_id:t.receive_id,msg_type:"text",content:mt(t.text)});return JSON.stringify({ok:!0,message_id:r.message_id})}case"lark_reply":{if(!t.message_id||!t.text)return JSON.stringify({error:"message_id and text are required"});let e=await Q("POST",`/open-apis/im/v1/messages/${encodeURIComponent(t.message_id)}/reply`,{msg_type:"text",content:mt(t.text)});return JSON.stringify({ok:!0,message_id:e.message_id})}case"lark_list_chats":{let e=t.page_size||50,i=((await Q("GET",`/open-apis/im/v1/chats?page_size=${e}`)).items||[]).map(n=>({chat_id:n.chat_id,name:n.name,description:n.description,owner_id:n.owner_id,chat_mode:n.chat_mode}));return JSON.stringify({chats:i})}case"lark_get_chat_history":{if(!t.chat_id)return JSON.stringify({error:"chat_id is required"});let e=t.page_size||20,i=((await Q("GET",`/open-apis/im/v1/messages?container_id_type=chat&container_id=${encodeURIComponent(t.chat_id)}&page_size=${e}&sort_type=ByCreateTimeDesc`)).items||[]).map(n=>({message_id:n.message_id,sender_id:n.sender?.id,sender_type:n.sender?.sender_type,msg_type:n.msg_type,content:n.body?.content,create_time:n.create_time}));return JSON.stringify({messages:i})}case"lark_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});let r=((await Q("POST","/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id",{emails:[t.email]})).user_list||[]).find(i=>i.email===t.email&&i.user_id);return JSON.stringify(r?{ok:!0,user:{open_id:r.user_id,email:r.email,name:r.name||void 0}}:{ok:!1,reason:"no_lark_user_for_email"})}case"lark_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=200,o=((await Q("GET","/open-apis/im/v1/chats?page_size=100")).items||[]).map(l=>l.chat_id),c=new Set,a=[];for(let l of o){if(a.length>=i)break;try{let d=await Q("GET",`/open-apis/im/v1/chats/${encodeURIComponent(l)}/members?member_id_type=open_id&page_size=100`);for(let p of d.items||[])if(!(!p.member_id||c.has(p.member_id))&&(c.add(p.member_id),a.push({open_id:p.member_id,name:p.name||""}),a.length>=i))break}catch(d){console.warn(`[lark] member scan failed for ${l}: ${d.message}`)}}let u=[];for(let l of a){let d=(l.name||"").toLowerCase();if(!d)continue;let p=0;d.includes(e)&&(p+=100-Math.abs(d.length-e.length)),d===e&&(p+=200),p>0&&u.push({open_id:l.open_id,name:l.name,_score:p})}return u.sort((l,d)=>d._score-l._score),JSON.stringify({ok:!0,matches:u.slice(0,r).map(({_score:l,...d})=>d),scanned:a.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}}};var ft={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:[...q.envKeys||[],...B.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return q.serverName;if(process.env.LARK_RECEIVE_ID)return B.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?q.allowedTools||[]:process.env.LARK_RECEIVE_ID?B.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
264
+ When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let s=Es();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},tools:[{name:"lark_send_message",description:"Send a text message to a Lark chat, user, or DM. receive_id can be a chat_id (oc_*), open_id (ou_*), union_id (on_*), or email.",input_schema:{type:"object",properties:{receive_id:{type:"string",description:"Target id: chat_id (oc_*), open_id (ou_*), union_id (on_*), or email"},text:{type:"string",description:"Message text"}},required:["receive_id","text"]}},{name:"lark_reply",description:"Reply to an existing Lark message (creates a thread). Use the message_id from the inbound event.",input_schema:{type:"object",properties:{message_id:{type:"string",description:"Lark message id (om_*) to reply to"},text:{type:"string",description:"Reply text"}},required:["message_id","text"]}},{name:"lark_list_chats",description:"List chats (groups + DMs) the bot is a member of.",input_schema:{type:"object",properties:{page_size:{type:"number",description:"Max results (default 50)"}}}},{name:"lark_get_chat_history",description:"Fetch recent messages in a chat.",input_schema:{type:"object",properties:{chat_id:{type:"string",description:"Chat id (oc_*)"},page_size:{type:"number",description:"Max messages (default 20)"}},required:["chat_id"]}},{name:"lark_lookup_user_by_email",description:"Resolve an email address to a Lark user id (open_id). Returns { ok:true, user:{open_id,email,name} } on hit, { ok:false } if no Lark user has that email. Use the open_id as `receive_id` in lark_send_message to DM.",input_schema:{type:"object",properties:{email:{type:"string",description:"Email address to look up"}},required:["email"]}},{name:"lark_search_users",description:'Fuzzy-search users by name across chats the bot is a member of. Lark has no public org-wide user search API for bots \u2014 this walks the bot\'s chat memberships and matches names client-side. Best for "send to Sam" style routing where you have a name but no email. Returns up to `limit` ranked matches { open_id, name }.',input_schema:{type:"object",properties:{query:{type:"string",description:"Substring to match against user names (case-insensitive)"},limit:{type:"number",description:"Max matches to return (default 5, max 25)"}},required:["query"]}}],async handleToolCall(s,t){try{switch(s){case"lark_send_message":{if(!t.receive_id||!t.text)return JSON.stringify({error:"receive_id and text are required"});let e=Cs(t.receive_id),r=await Q("POST",`/open-apis/im/v1/messages?receive_id_type=${e}`,{receive_id:t.receive_id,msg_type:"text",content:mt(t.text)});return JSON.stringify({ok:!0,message_id:r.message_id})}case"lark_reply":{if(!t.message_id||!t.text)return JSON.stringify({error:"message_id and text are required"});let e=await Q("POST",`/open-apis/im/v1/messages/${encodeURIComponent(t.message_id)}/reply`,{msg_type:"text",content:mt(t.text)});return JSON.stringify({ok:!0,message_id:e.message_id})}case"lark_list_chats":{let e=t.page_size||50,i=((await Q("GET",`/open-apis/im/v1/chats?page_size=${e}`)).items||[]).map(n=>({chat_id:n.chat_id,name:n.name,description:n.description,owner_id:n.owner_id,chat_mode:n.chat_mode}));return JSON.stringify({chats:i})}case"lark_get_chat_history":{if(!t.chat_id)return JSON.stringify({error:"chat_id is required"});let e=t.page_size||20,i=((await Q("GET",`/open-apis/im/v1/messages?container_id_type=chat&container_id=${encodeURIComponent(t.chat_id)}&page_size=${e}&sort_type=ByCreateTimeDesc`)).items||[]).map(n=>({message_id:n.message_id,sender_id:n.sender?.id,sender_type:n.sender?.sender_type,msg_type:n.msg_type,content:n.body?.content,create_time:n.create_time}));return JSON.stringify({messages:i})}case"lark_lookup_user_by_email":{if(!t.email)return JSON.stringify({error:"email is required"});let r=((await Q("POST","/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id",{emails:[t.email]})).user_list||[]).find(i=>i.email===t.email&&i.user_id);return JSON.stringify(r?{ok:!0,user:{open_id:r.user_id,email:r.email,name:r.name||void 0}}:{ok:!1,reason:"no_lark_user_for_email"})}case"lark_search_users":{if(!t.query||typeof t.query!="string")return JSON.stringify({error:"query is required"});let e=t.query.trim().toLowerCase();if(!e)return JSON.stringify({ok:!0,matches:[]});let r=Math.max(1,Math.min(Number(t.limit)||5,25)),i=200,o=((await Q("GET","/open-apis/im/v1/chats?page_size=100")).items||[]).map(l=>l.chat_id),c=new Set,a=[];for(let l of o){if(a.length>=i)break;try{let d=await Q("GET",`/open-apis/im/v1/chats/${encodeURIComponent(l)}/members?member_id_type=open_id&page_size=100`);for(let p of d.items||[])if(!(!p.member_id||c.has(p.member_id))&&(c.add(p.member_id),a.push({open_id:p.member_id,name:p.name||""}),a.length>=i))break}catch(d){console.warn(`[lark] member scan failed for ${l}: ${d.message}`)}}let u=[];for(let l of a){let d=(l.name||"").toLowerCase();if(!d)continue;let p=0;d.includes(e)&&(p+=100-Math.abs(d.length-e.length)),d===e&&(p+=200),p>0&&u.push({open_id:l.open_id,name:l.name,_score:p})}return u.sort((l,d)=>d._score-l._score),JSON.stringify({ok:!0,matches:u.slice(0,r).map(({_score:l,...d})=>d),scanned:a.length})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}}};var ft={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:[...q.envKeys||[],...B.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return q.serverName;if(process.env.LARK_RECEIVE_ID)return B.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?q.allowedTools||[]:process.env.LARK_RECEIVE_ID?B.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
265
265
  You can post chat messages via either:
266
266
  - slack_post_message (channel, text) \u2014 Slack, when SLACK_CHANNEL is set
267
267
  - lark_send_message (receive_id, text) \u2014 Lark, when LARK_RECEIVE_ID is set
268
- Use whichever the user has configured.`,resolve(s){return process.env.SLACK_CHANNEL&&typeof q.resolve=="function"?q.resolve(s):process.env.LARK_RECEIVE_ID&&typeof B.resolve=="function"?B.resolve(s):null},async handleToolCall(s,t,e){return typeof s=="string"&&s.startsWith("slack_")?q.handleToolCall(s,t,e):typeof s=="string"&&s.startsWith("lark_")?B.handleToolCall(s,t,e):JSON.stringify({error:`chat_notify: unknown tool "${s}". Expected slack_* or lark_*.`})},get tools(){return[...q.tools||[],...B.tools||[]]}};import{createRequire as ws}from"module";import{execFileSync as Ss}from"child_process";import{join as yt}from"path";import{existsSync as vs}from"fs";var Ns=ws(import.meta.url);function Is(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return Ns.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var ht={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:s}=await import("@zibby/ui-memory");return s()}catch{return null}},promptFragment:`BEFORE executing browser actions:
268
+ Use whichever the user has configured.`,resolve(s){return process.env.SLACK_CHANNEL&&typeof q.resolve=="function"?q.resolve(s):process.env.LARK_RECEIVE_ID&&typeof B.resolve=="function"?B.resolve(s):null},async handleToolCall(s,t,e){return typeof s=="string"&&s.startsWith("slack_")?q.handleToolCall(s,t,e):typeof s=="string"&&s.startsWith("lark_")?B.handleToolCall(s,t,e):JSON.stringify({error:`chat_notify: unknown tool "${s}". Expected slack_* or lark_*.`})},get tools(){return[...q.tools||[],...B.tools||[]]}};import{createRequire as Ps}from"module";import{execFileSync as Js}from"child_process";import{join as yt}from"path";import{existsSync as Us}from"fs";var qs=Ps(import.meta.url);function Ms(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return qs.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var ht={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:s}=await import("@zibby/ui-memory");return s()}catch{return null}},promptFragment:`BEFORE executing browser actions:
269
269
  - Review any test memory/history above. Prefer selectors proven to work.
270
270
  - If a previous run failed, avoid the same approach.
271
271
  - After setup/login completes, navigate directly to the target page instead of clicking through menus.
@@ -277,18 +277,18 @@ DURING execution \u2014 when a selector fails and you switch to a fallback:
277
277
  AFTER completing the test, you MUST call memory_save_insight at least once:
278
278
  - Save any useful finding: reliable selectors, timing quirks, navigation patterns, workarounds.
279
279
  - Category: selector_tip | timing | navigation | workaround | flaky | general
280
- - Be specific \u2014 future runs will read your insights.`,resolve(){let s=Is();if(!s)throw new Error(`\u274C Memory MCP server not found
280
+ - Be specific \u2014 future runs will read your insights.`,resolve(){let s=Ms();if(!s)throw new Error(`\u274C Memory MCP server not found
281
281
 
282
282
  Install @zibby/ui-memory:
283
- npm install @zibby/ui-memory`);let t=yt(process.cwd(),".zibby","memory");if(!vs(yt(t,".dolt")))throw new Error(`\u274C Memory database not initialized
283
+ npm install @zibby/ui-memory`);let t=yt(process.cwd(),".zibby","memory");if(!Us(yt(t,".dolt")))throw new Error(`\u274C Memory database not initialized
284
284
 
285
285
  Run:
286
- zibby init --mem`);try{let e=Ss("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:t,encoding:"utf-8",timeout:5e3}),r=JSON.parse(e.trim()).rows||[];if(!r[0]||r[0].cnt===0)return console.log("[memory] Database empty \u2014 memory tools activate after first completed run"),null}catch(e){throw new Error(`\u274C Dolt not found or memory database error
286
+ zibby init --mem`);try{let e=Js("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:t,encoding:"utf-8",timeout:5e3}),r=JSON.parse(e.trim()).rows||[];if(!r[0]||r[0].cnt===0)return console.log("[memory] Database empty \u2014 memory tools activate after first completed run"),null}catch(e){throw new Error(`\u274C Dolt not found or memory database error
287
287
 
288
288
  Install Dolt:
289
289
  https://docs.dolthub.com/introduction/installation
290
290
 
291
- Error: ${e.message}`,{cause:e})}return{command:"node",args:[s,"--db-path",t],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 Os,readFileSync as As}from"fs";import{homedir as Rs}from"os";import{join as $s}from"path";import{spawn as js}from"child_process";var X={jira:{description:"Jira issue search, details, comments, transitions",integrationProvider:"jira",envKeys:[],setupInstructions:`To connect Jira:
291
+ Error: ${e.message}`,{cause:e})}return{command:"node",args:[s,"--db-path",t],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 Ds,readFileSync as Bs}from"fs";import{homedir as Ks}from"os";import{join as Gs}from"path";import{spawn as Fs}from"child_process";var X={jira:{description:"Jira issue search, details, comments, transitions",integrationProvider:"jira",envKeys:[],setupInstructions:`To connect Jira:
292
292
  1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
293
293
  2. Click "Connect Jira" and authorize via Atlassian OAuth
294
294
  3. After OAuth completes, ask me to install Jira again`},github:{description:"GitHub issues, PRs, repository management",integrationProvider:"github",envKeys:[],setupInstructions:`To connect GitHub:
@@ -300,15 +300,15 @@ AFTER completing the test, you MUST call memory_save_insight at least once:
300
300
  3. After OAuth completes, ask me to install Slack again`},sentry:{description:"Sentry error tracking \u2014 projects, issues, events",integrationProvider:"sentry",envKeys:[],setupInstructions:`To connect Sentry:
301
301
  1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
302
302
  2. Click "Connect Sentry" and authorize
303
- 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 Ts(){let s=["## Available Skills"];for(let[t,e]of Object.entries(X)){let r=e.integrationProvider?`integration: ${e.integrationProvider}`:"ready";s.push(`- ${t}: ${e.description} [${r}]`)}return s.push(""),s.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),s.push(`Zibby third party Integration settings page: ${xe()}`),s.push(""),s.push("## Tool-First Policy (mandatory)"),s.push("CRITICAL RULES \u2014 follow these strictly:"),s.push("1. When user asks to do something and a matching skill is available but not installed, IMMEDIATELY call install_skill. Never ask for credentials or confirmation first."),s.push(`2. If install_skill succeeds, the skill's tools are now available. Use them RIGHT AWAY in the same turn \u2014 don't just say "it's connected", actually call the tools.`),s.push("3. If install_skill reports needsIntegration, tell the user to connect via the integration URL and try again after."),s.push("4. When the relevant skill is already installed, use its tools directly \u2014 don't ask for IDs or keys. Each skill's own instructions explain the workflow."),s.push("5. If a task needs multiple skills (e.g. data from one + execution from another), install all of them, then follow each skill's workflow instructions."),s.join(`
304
- `)}function Es(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let s=$s(Rs(),".zibby","config.json");return Os(s)&&JSON.parse(As(s,"utf-8")).sessionToken||null}catch{return null}}function xs(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function xe(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function Ls(s){try{let t=process.platform;return js(t==="darwin"?"open":t==="win32"?"cmd":"xdg-open",t==="win32"?["/c","start","",s]:[s],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function Cs(){let s=Es();if(!s)return{checked:!1,statuses:null,reason:"no-session-token"};try{let t=await fetch(`${xs()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${s}`}});return t.ok?{checked:!0,statuses:await t.json()||{},reason:null}:{checked:!1,statuses:null,reason:`status-${t.status}`}}catch{return{checked:!1,statuses:null,reason:"network-error"}}}function gt(s,t){if(!t||!s)return{connected:null};let e=s[t];return!e||typeof e.connected!="boolean"?{connected:null,details:e||null}:{connected:e.connected,details:e}}var _t={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:X,promptFragment:Ts,tools:[{name:"install_skill",description:"Install a skill into the current chat session so its tools become available",input_schema:{type:"object",properties:{skillId:{type:"string",description:'Skill identifier to install (e.g. "jira", "github", "browser", "memory")'}},required:["skillId"]}},{name:"uninstall_skill",description:"Remove a skill from the current chat session",input_schema:{type:"object",properties:{skillId:{type:"string",description:"Skill identifier to remove"}},required:["skillId"]}},{name:"list_available_skills",description:"List all skills that can be installed, with their env-var readiness status",input_schema:{type:"object",properties:{}}}],async handleToolCall(s,t,e){let{activeSkills:r}=e,i=await Cs();if(s==="list_available_skills"){let n=Object.entries(X).map(([o,c])=>{let a=r.includes(o),u=gt(i.statuses,c.integrationProvider);return{id:o,description:c.description,installed:a,integrationProvider:c.integrationProvider||void 0,integrationConnected:u.connected,setupInstructions:u.connected===!1?c.setupInstructions:void 0}});return JSON.stringify({skills:n})}if(s==="install_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(r.includes(n)){let l=X[n],{getSkill:d}=await import("@zibby/agent-workflow"),m=(d(n)?.tools||[]).map(f=>f.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:n,description:l?.description,availableTools:m,integrationUrl:l?.integrationProvider?xe():void 0,hint:`${n} is already active. Tools available: ${m.join(", ")}. Use them directly.`})}if(!X[n])return JSON.stringify({ok:!1,error:`Unknown skill "${n}". Available: ${Object.keys(X).join(", ")}`});let o=X[n];if(o.integrationProvider){let l=gt(i.statuses,o.integrationProvider),d=xe();if(i.checked&&l.connected===!1){let p=Ls(d);return JSON.stringify({ok:!1,error:`${o.integrationProvider} is not connected for this Zibby account yet`,needsIntegration:!0,integrationUrl:d,openedBrowser:p,setupInstructions:`Please connect ${o.integrationProvider} first at ${d}. After you finish OAuth, ask me to install ${n} again.`})}}r.push(n);let{getSkill:c}=await import("@zibby/agent-workflow"),u=(c(n)?.tools||[]).map(l=>l.name);return JSON.stringify({ok:!0,installed:n,description:o.description,availableTools:u,hint:`${n} is now active. You now have these tools: ${u.join(", ")}. Use them immediately to help the user \u2014 don't just confirm installation.`})}if(s==="uninstall_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(n==="skill-installer")return JSON.stringify({ok:!1,error:"Cannot uninstall the skill installer"});let o=r.indexOf(n);return o===-1?JSON.stringify({ok:!1,error:`${n} is not installed`}):(r.splice(o,1),JSON.stringify({ok:!0,uninstalled:n}))}return JSON.stringify({error:`Unknown tool: ${s}`})},resolve(){return null}};import{readFileSync as Ps,readdirSync as Js,statSync as kt,writeFileSync as Us,mkdirSync as qs}from"fs";import{join as wt,resolve as Ms,relative as Ds}from"path";import{execSync as St}from"child_process";var bt=256*1024,Bs=64*1024,vt={id:"core-tools",description:"File read/write, directory listing, shell commands, open URLs, wait for async operations",envKeys:[],tools:[{name:"read_file",description:"Read the contents of a file. Returns the text content.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"}},required:["path"]}},{name:"write_file",description:"Write content to a file. Creates parent directories if needed.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"},content:{type:"string",description:"Content to write"}},required:["path","content"]}},{name:"list_directory",description:"List files and directories in a path. Returns names with type indicators (/ for dirs).",input_schema:{type:"object",properties:{path:{type:"string",description:"Directory path (relative to cwd or absolute). Defaults to cwd."}}}},{name:"run_command",description:"Run a shell command and return its output. Use for grep, git, npm, etc.",input_schema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute"},cwd:{type:"string",description:"Working directory (optional, defaults to project root)"}},required:["command"]}},{name:"open_url",description:"Open a URL in the user's default browser. Use for OAuth flows, documentation, integration setup pages.",input_schema:{type:"object",properties:{url:{type:"string",description:"URL to open"}},required:["url"]}},{name:"wait",description:"Wait for N seconds. Use this for async operations (tests, builds, deploys) \u2014 wait, then check status again.",input_schema:{type:"object",properties:{seconds:{type:"number",description:"Seconds to wait (default: 5, max: 300)"},reason:{type:"string",description:"Why waiting (for logging/clarity)"}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"read_file":return Ks(t,r);case"write_file":return Gs(t,r);case"list_directory":return Fs(t,r);case"run_command":return zs(t,r);case"open_url":return Ws(t);case"wait":return await Hs(t,e?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function _e(s,t){return Ms(t,s)}function Ks(s,t){let e=_e(s.path,t),r=kt(e);return r.size>bt?JSON.stringify({error:`File too large (${(r.size/1024).toFixed(0)}KB). Max: ${bt/1024}KB`}):Ps(e,"utf-8")}function Gs(s,t){let e=_e(s.path,t),r=wt(e,"..");return qs(r,{recursive:!0}),Us(e,s.content,"utf-8"),JSON.stringify({ok:!0,path:Ds(t,e)})}function Fs(s,t){let e=_e(s.path||".",t);return Js(e).map(i=>{try{return kt(wt(e,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
305
- `)}function zs(s,t){let e=s.cwd?_e(s.cwd,t):t;return St(s.command,{cwd:e,encoding:"utf-8",timeout:3e4,maxBuffer:Bs,stdio:["pipe","pipe","pipe"]})||"(no output)"}function Ws(s){let{url:t}=s;if(!t||!t.startsWith("http://")&&!t.startsWith("https://"))return JSON.stringify({error:"Invalid URL \u2014 must start with http:// or https://"});let e=process.platform,r=e==="darwin"?"open":e==="win32"?"start":"xdg-open";try{return St(`${r} "${t}"`,{stdio:"ignore",timeout:5e3}),JSON.stringify({ok:!0,opened:t})}catch{return JSON.stringify({ok:!1,error:`Could not open browser. Please visit: ${t}`})}}async function Hs(s,t){let e=Math.min(Math.max(s.seconds||5,1),300),r=s.reason||"async operation",i=500,n=Date.now()+e*1e3;for(;Date.now()<n;){if(t?.aborted)return JSON.stringify({ok:!0,waited:Math.round((e*1e3-(n-Date.now()))/1e3),reason:r,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,n-Date.now())))}return JSON.stringify({ok:!0,waited:e,reason:r})}import{existsSync as Ys}from"fs";import{fileURLToPath as Zs}from"url";import{dirname as Vs,resolve as Qs}from"path";import{resolveIntegrationToken as Nt}from"@zibby/core/backend-client.js";function Xs(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let s=Vs(Zs(import.meta.url)),t=Qs(s,"..","bin","mcp-sentry.mjs");return Ys(t)?t:null}async function It(s,t={}){let{token:e,organizationSlug:r}=await Nt("sentry"),i=`https://sentry.io/api/0/organizations/${r}${s}`,n=await fetch(i,{method:t.method||"GET",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"}});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`Sentry API ${n.status}: ${o.slice(0,300)}`)}return n.json()}async function ei(){return It("/projects/?per_page=50")}async function ti({query:s="is:unresolved",sort:t="date",project:e,limit:r=25}={}){let i=`/issues/?query=${encodeURIComponent(s)}&sort=${t}&per_page=${r}`;return e&&(i+=`&project=${encodeURIComponent(e)}`),It(i)}async function ri(s){if(!s)throw new Error("sentryGetIssue: issueId is required");let{token:t}=await Nt("sentry"),e=await fetch(`https://sentry.io/api/0/issues/${s}/`,{headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let r=await e.text().catch(()=>"");throw new Error(`Sentry API ${e.status}: ${r.slice(0,300)}`)}return e.json()}var be={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:O.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry (connected)
303
+ 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 zs(){let s=["## Available Skills"];for(let[t,e]of Object.entries(X)){let r=e.integrationProvider?`integration: ${e.integrationProvider}`:"ready";s.push(`- ${t}: ${e.description} [${r}]`)}return s.push(""),s.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),s.push(`Zibby third party Integration settings page: ${Le()}`),s.push(""),s.push("## Tool-First Policy (mandatory)"),s.push("CRITICAL RULES \u2014 follow these strictly:"),s.push("1. When user asks to do something and a matching skill is available but not installed, IMMEDIATELY call install_skill. Never ask for credentials or confirmation first."),s.push(`2. If install_skill succeeds, the skill's tools are now available. Use them RIGHT AWAY in the same turn \u2014 don't just say "it's connected", actually call the tools.`),s.push("3. If install_skill reports needsIntegration, tell the user to connect via the integration URL and try again after."),s.push("4. When the relevant skill is already installed, use its tools directly \u2014 don't ask for IDs or keys. Each skill's own instructions explain the workflow."),s.push("5. If a task needs multiple skills (e.g. data from one + execution from another), install all of them, then follow each skill's workflow instructions."),s.join(`
304
+ `)}function Ws(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let s=Gs(Ks(),".zibby","config.json");return Ds(s)&&JSON.parse(Bs(s,"utf-8")).sessionToken||null}catch{return null}}function Hs(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function Le(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function Ys(s){try{let t=process.platform;return Fs(t==="darwin"?"open":t==="win32"?"cmd":"xdg-open",t==="win32"?["/c","start","",s]:[s],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function Zs(){let s=Ws();if(!s)return{checked:!1,statuses:null,reason:"no-session-token"};try{let t=await fetch(`${Hs()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${s}`}});return t.ok?{checked:!0,statuses:await t.json()||{},reason:null}:{checked:!1,statuses:null,reason:`status-${t.status}`}}catch{return{checked:!1,statuses:null,reason:"network-error"}}}function gt(s,t){if(!t||!s)return{connected:null};let e=s[t];return!e||typeof e.connected!="boolean"?{connected:null,details:e||null}:{connected:e.connected,details:e}}var _t={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:X,promptFragment:zs,tools:[{name:"install_skill",description:"Install a skill into the current chat session so its tools become available",input_schema:{type:"object",properties:{skillId:{type:"string",description:'Skill identifier to install (e.g. "jira", "github", "browser", "memory")'}},required:["skillId"]}},{name:"uninstall_skill",description:"Remove a skill from the current chat session",input_schema:{type:"object",properties:{skillId:{type:"string",description:"Skill identifier to remove"}},required:["skillId"]}},{name:"list_available_skills",description:"List all skills that can be installed, with their env-var readiness status",input_schema:{type:"object",properties:{}}}],async handleToolCall(s,t,e){let{activeSkills:r}=e,i=await Zs();if(s==="list_available_skills"){let n=Object.entries(X).map(([o,c])=>{let a=r.includes(o),u=gt(i.statuses,c.integrationProvider);return{id:o,description:c.description,installed:a,integrationProvider:c.integrationProvider||void 0,integrationConnected:u.connected,setupInstructions:u.connected===!1?c.setupInstructions:void 0}});return JSON.stringify({skills:n})}if(s==="install_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(r.includes(n)){let l=X[n],{getSkill:d}=await import("@zibby/agent-workflow"),m=(d(n)?.tools||[]).map(f=>f.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:n,description:l?.description,availableTools:m,integrationUrl:l?.integrationProvider?Le():void 0,hint:`${n} is already active. Tools available: ${m.join(", ")}. Use them directly.`})}if(!X[n])return JSON.stringify({ok:!1,error:`Unknown skill "${n}". Available: ${Object.keys(X).join(", ")}`});let o=X[n];if(o.integrationProvider){let l=gt(i.statuses,o.integrationProvider),d=Le();if(i.checked&&l.connected===!1){let p=Ys(d);return JSON.stringify({ok:!1,error:`${o.integrationProvider} is not connected for this Zibby account yet`,needsIntegration:!0,integrationUrl:d,openedBrowser:p,setupInstructions:`Please connect ${o.integrationProvider} first at ${d}. After you finish OAuth, ask me to install ${n} again.`})}}r.push(n);let{getSkill:c}=await import("@zibby/agent-workflow"),u=(c(n)?.tools||[]).map(l=>l.name);return JSON.stringify({ok:!0,installed:n,description:o.description,availableTools:u,hint:`${n} is now active. You now have these tools: ${u.join(", ")}. Use them immediately to help the user \u2014 don't just confirm installation.`})}if(s==="uninstall_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(n==="skill-installer")return JSON.stringify({ok:!1,error:"Cannot uninstall the skill installer"});let o=r.indexOf(n);return o===-1?JSON.stringify({ok:!1,error:`${n} is not installed`}):(r.splice(o,1),JSON.stringify({ok:!0,uninstalled:n}))}return JSON.stringify({error:`Unknown tool: ${s}`})},resolve(){return null}};import{readFileSync as Vs,readdirSync as Qs,statSync as kt,writeFileSync as Xs,mkdirSync as ei}from"fs";import{join as wt,resolve as ti,relative as ri}from"path";import{execSync as St}from"child_process";var bt=256*1024,si=64*1024,vt={id:"core-tools",description:"File read/write, directory listing, shell commands, open URLs, wait for async operations",envKeys:[],tools:[{name:"read_file",description:"Read the contents of a file. Returns the text content.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"}},required:["path"]}},{name:"write_file",description:"Write content to a file. Creates parent directories if needed.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"},content:{type:"string",description:"Content to write"}},required:["path","content"]}},{name:"list_directory",description:"List files and directories in a path. Returns names with type indicators (/ for dirs).",input_schema:{type:"object",properties:{path:{type:"string",description:"Directory path (relative to cwd or absolute). Defaults to cwd."}}}},{name:"run_command",description:"Run a shell command and return its output. Use for grep, git, npm, etc.",input_schema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute"},cwd:{type:"string",description:"Working directory (optional, defaults to project root)"}},required:["command"]}},{name:"open_url",description:"Open a URL in the user's default browser. Use for OAuth flows, documentation, integration setup pages.",input_schema:{type:"object",properties:{url:{type:"string",description:"URL to open"}},required:["url"]}},{name:"wait",description:"Wait for N seconds. Use this for async operations (tests, builds, deploys) \u2014 wait, then check status again.",input_schema:{type:"object",properties:{seconds:{type:"number",description:"Seconds to wait (default: 5, max: 300)"},reason:{type:"string",description:"Why waiting (for logging/clarity)"}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"read_file":return ii(t,r);case"write_file":return ni(t,r);case"list_directory":return oi(t,r);case"run_command":return ai(t,r);case"open_url":return ci(t);case"wait":return await li(t,e?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function _e(s,t){return ti(t,s)}function ii(s,t){let e=_e(s.path,t),r=kt(e);return r.size>bt?JSON.stringify({error:`File too large (${(r.size/1024).toFixed(0)}KB). Max: ${bt/1024}KB`}):Vs(e,"utf-8")}function ni(s,t){let e=_e(s.path,t),r=wt(e,"..");return ei(r,{recursive:!0}),Xs(e,s.content,"utf-8"),JSON.stringify({ok:!0,path:ri(t,e)})}function oi(s,t){let e=_e(s.path||".",t);return Qs(e).map(i=>{try{return kt(wt(e,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
305
+ `)}function ai(s,t){let e=s.cwd?_e(s.cwd,t):t;return St(s.command,{cwd:e,encoding:"utf-8",timeout:3e4,maxBuffer:si,stdio:["pipe","pipe","pipe"]})||"(no output)"}function ci(s){let{url:t}=s;if(!t||!t.startsWith("http://")&&!t.startsWith("https://"))return JSON.stringify({error:"Invalid URL \u2014 must start with http:// or https://"});let e=process.platform,r=e==="darwin"?"open":e==="win32"?"start":"xdg-open";try{return St(`${r} "${t}"`,{stdio:"ignore",timeout:5e3}),JSON.stringify({ok:!0,opened:t})}catch{return JSON.stringify({ok:!1,error:`Could not open browser. Please visit: ${t}`})}}async function li(s,t){let e=Math.min(Math.max(s.seconds||5,1),300),r=s.reason||"async operation",i=500,n=Date.now()+e*1e3;for(;Date.now()<n;){if(t?.aborted)return JSON.stringify({ok:!0,waited:Math.round((e*1e3-(n-Date.now()))/1e3),reason:r,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,n-Date.now())))}return JSON.stringify({ok:!0,waited:e,reason:r})}import{existsSync as ui}from"fs";import{fileURLToPath as di}from"url";import{dirname as pi,resolve as mi}from"path";import{resolveIntegrationToken as Nt}from"@zibby/core/backend-client.js";function fi(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let s=pi(di(import.meta.url)),t=mi(s,"..","bin","mcp-sentry.mjs");return ui(t)?t:null}async function It(s,t={}){let{token:e,organizationSlug:r}=await Nt("sentry"),i=`https://sentry.io/api/0/organizations/${r}${s}`,n=await fetch(i,{method:t.method||"GET",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"}});if(!n.ok){let o=await n.text().catch(()=>"");throw new Error(`Sentry API ${n.status}: ${o.slice(0,300)}`)}return n.json()}async function yi(){return It("/projects/?per_page=50")}async function hi({query:s="is:unresolved",sort:t="date",project:e,limit:r=25}={}){let i=`/issues/?query=${encodeURIComponent(s)}&sort=${t}&per_page=${r}`;return e&&(i+=`&project=${encodeURIComponent(e)}`),It(i)}async function gi(s){if(!s)throw new Error("sentryGetIssue: issueId is required");let{token:t}=await Nt("sentry"),e=await fetch(`https://sentry.io/api/0/issues/${s}/`,{headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let r=await e.text().catch(()=>"");throw new Error(`Sentry API ${e.status}: ${r.slice(0,300)}`)}return e.json()}var be={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:O.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry (connected)
306
306
  You have access to the user's Sentry. Use these tools:
307
307
  - sentry_list_projects: List projects in the organization
308
308
  - sentry_list_issues: List errors/issues (supports Sentry search query, project filter, sort)
309
- - sentry_get_issue: Get detailed info about a specific issue (requires issueId)`,resolve(){let s=Xs();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t={}){try{switch(s){case"sentry_list_projects":{let e=await ei();return JSON.stringify({projects:e.map(r=>({slug:r.slug,name:r.name,platform:r.platform}))})}case"sentry_list_issues":{let e=await ti({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(r=>({id:r.id,title:r.title,culprit:r.culprit,count:r.count,firstSeen:r.firstSeen,lastSeen:r.lastSeen,level:r.level,status:r.status}))})}case"sentry_get_issue":{let e=await ri(t.issueId);return JSON.stringify({id:e.id,title:e.title,culprit:e.culprit,metadata:e.metadata,count:e.count,userCount:e.userCount,firstSeen:e.firstSeen,lastSeen:e.lastSeen,level:e.level,status:e.status,project:{slug:e.project?.slug,name:e.project?.name}})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},toolsForAssistant:[{name:"sentry_list_projects",description:"List Sentry projects",input_schema:{type:"object",properties:{}}},{name:"sentry_list_issues",description:"List Sentry issues (errors)",input_schema:{type:"object",properties:{project:{type:"string",description:"Project slug (optional)"},query:{type:"string",description:"Sentry search query (default: is:unresolved)"},sort:{type:"string",description:"Sort order: date, new, priority, freq, user (default: date)"},limit:{type:"number",description:"Max issues to return (default 25)"}}}},{name:"sentry_get_issue",description:"Get details of a specific Sentry issue",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"}},required:["issueId"]}}]};be.tools=be.toolsForAssistant;import{spawn as Ct}from"child_process";import{writeFileSync as si,mkdirSync as Ot,existsSync as K,readdirSync as ve,readFileSync as Se,unlinkSync as ii,createWriteStream as ni,statSync as oi}from"fs";import{resolve as ee,join as M}from"path";import{resolveMaxParallelRuns as Pt}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as ai}from"@zibby/core/constants/zibby-scratch.js";var Pe="sessions",Je=".zibby/output",ke=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",ci=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",Jt=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",L=new Map,Y=[],li=0,Le=0,At=3e3;function Ut(){return`run_${++li}_${Date.now().toString(36)}`}function Rt(s){let t=Math.floor(s/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function qt(s){return s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function E(s,t,e){if(!ci)return;let r=`
309
+ - sentry_get_issue: Get detailed info about a specific issue (requires issueId)`,resolve(){let s=fi();if(!s)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[s],env:t,alwaysLoad:!0}},async handleToolCall(s,t={}){try{switch(s){case"sentry_list_projects":{let e=await yi();return JSON.stringify({projects:e.map(r=>({slug:r.slug,name:r.name,platform:r.platform}))})}case"sentry_list_issues":{let e=await hi({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(r=>({id:r.id,title:r.title,culprit:r.culprit,count:r.count,firstSeen:r.firstSeen,lastSeen:r.lastSeen,level:r.level,status:r.status}))})}case"sentry_get_issue":{let e=await gi(t.issueId);return JSON.stringify({id:e.id,title:e.title,culprit:e.culprit,metadata:e.metadata,count:e.count,userCount:e.userCount,firstSeen:e.firstSeen,lastSeen:e.lastSeen,level:e.level,status:e.status,project:{slug:e.project?.slug,name:e.project?.name}})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(e){return JSON.stringify({error:e.message})}},toolsForAssistant:[{name:"sentry_list_projects",description:"List Sentry projects",input_schema:{type:"object",properties:{}}},{name:"sentry_list_issues",description:"List Sentry issues (errors)",input_schema:{type:"object",properties:{project:{type:"string",description:"Project slug (optional)"},query:{type:"string",description:"Sentry search query (default: is:unresolved)"},sort:{type:"string",description:"Sort order: date, new, priority, freq, user (default: date)"},limit:{type:"number",description:"Max issues to return (default 25)"}}}},{name:"sentry_get_issue",description:"Get details of a specific Sentry issue",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"}},required:["issueId"]}}]};be.tools=be.toolsForAssistant;import{spawn as Ct}from"child_process";import{writeFileSync as _i,mkdirSync as Ot,existsSync as K,readdirSync as ve,readFileSync as Se,unlinkSync as bi,createWriteStream as ki,statSync as wi}from"fs";import{resolve as ee,join as M}from"path";import{resolveMaxParallelRuns as Pt}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as Si}from"@zibby/core/constants/zibby-scratch.js";var Pe="sessions",Je=".zibby/output",ke=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",vi=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",Jt=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",x=new Map,Y=[],Ni=0,xe=0,At=3e3;function Ut(){return`run_${++Ni}_${Date.now().toString(36)}`}function Rt(s){let t=Math.floor(s/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function qt(s){return s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function E(s,t,e){if(!vi)return;let r=`
310
310
  ${t} [${s}] ${e}
311
- `;try{process.stderr.write(r)}catch{}}function Ue(){Y.length=0;for(let[,s]of L)if(s.status==="queued"&&(s.status="cancelled"),s.status==="running"&&s._child)try{s._child.kill("SIGTERM")}catch{}}process.on("exit",Ue);process.on("SIGINT",()=>{Ue(),process.exit(0)});process.on("SIGTERM",()=>{Ue(),process.exit(0)});var Mt={id:"runner",description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],promptFragment:`## Test Runner
311
+ `;try{process.stderr.write(r)}catch{}}function Ue(){Y.length=0;for(let[,s]of x)if(s.status==="queued"&&(s.status="cancelled"),s.status==="running"&&s._child)try{s._child.kill("SIGTERM")}catch{}}process.on("exit",Ue);process.on("SIGINT",()=>{Ue(),process.exit(0)});process.on("SIGTERM",()=>{Ue(),process.exit(0)});var Mt={id:"runner",description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],promptFragment:`## Test Runner
312
312
  You can run zibby test workflows directly from chat:
313
313
 
314
314
  **CRITICAL: When user asks to test a ticket:**
@@ -445,8 +445,8 @@ Each run generates:
445
445
  - events.json: All browser events
446
446
  - raw_stream_output.txt: Agent log
447
447
 
448
- Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"run_generate":return await ui(t,r);case"run_test":return await hi(t,r,e);case"run_status":return gi(t);case"run_cancel":return _i(t);case"run_artifacts":return wi(t,r);case"run_diagnose":return Si(t,r);case"list_specs":return vi(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"run_generate",description:"Generate specs from codebase. CRITICAL: DO NOT USE if ticket has test steps in comments. Only use when: (1) NO steps in ticket AND (2) local codebase exists (not external URLs). For tickets with steps, use run_test with inline format.",input_schema:{type:"object",properties:{ticket:{type:"string",description:"Jira ticket key (e.g. SCRUM-123). Auto-fetches ticket details."},description:{type:"string",description:"Ticket description text (use if no Jira key available)"},input:{type:"string",description:"Path to a file containing ticket/requirements text"},repo:{type:"string",description:"Path to the codebase (default: current directory)"},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},output:{type:"string",description:"Output directory for spec files (default: test-specs)"}}}},{name:"run_test",description:"Start a test (async, returns runId). spec = file path, or inline:+steps, or a Jira-shaped issue key (e.g. PROJ-123): when Jira is connected, the runner loads that issue's description+comments into an inline spec. After starting, tell the user and let them ask for progress via run_status.",input_schema:{type:"object",properties:{spec:{type:"string",description:"Workspace file path; or inline:+steps; or Jira issue key (KEY-123) to auto-fetch from Jira when the jira skill is active."},ticketKey:{type:"string",description:"Optional label (e.g. SCRUM-123). If spec is an issue key, this defaults to that key."},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},headless:{type:"boolean",description:"Run browser headless (default false)"},workflow:{type:"string",description:"Workflow override (e.g. quick-smoke)"}},required:["spec"]}},{name:"run_status",description:'Instant progress check \u2014 returns immediately. Use this whenever user asks about test progress. ALWAYS use runId="all".',input_schema:{type:"object",properties:{runId:{type:"string",description:'Use "all" to see all runs in this session (recommended). Or a specific run ID if known.'}},required:["runId"]}},{name:"run_cancel",description:'Cancel/kill a running test. ONLY use when the USER explicitly asks to cancel or stop a run. NEVER auto-cancel \u2014 tests take 1-5 minutes and "running" is normal. Use runId="all" to cancel all active runs.',input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID to cancel, or "all" to cancel all active runs'}},required:["runId"]}},{name:"run_artifacts",description:"Read artifacts from a test run session. Can list files, read results/events/logs, or search across all sessions.",input_schema:{type:"object",properties:{runId:{type:"string",description:"Run ID from run_test. Omit to search across all sessions."},type:{type:"string",enum:["list","result","events","log","search"],description:'What to retrieve: "list" = all files in session, "result" = result.json, "events" = events.json, "log" = raw output tail, "search" = search text across sessions'},node:{type:"string",description:'Node name to read from (e.g. "execute_live", "generate_script"). Default: "execute_live"'},query:{type:"string",description:'Search text (only for type="search"). Searches across all session logs/events.'},tail:{type:"number",description:"Number of characters from end of log to return (default: 3000)"}},required:["type"]}},{name:"run_diagnose",description:"Diagnose one or all runs, especially failed ones. Uses run logs + known error patterns and returns likely root cause with suggested next action.",input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID from run_test, or "all" (default) to diagnose all known runs'},tail:{type:"number",description:"Characters of run log tail to inspect (default: 2000)"}}}},{name:"list_specs",description:"List available test spec files in the project",input_schema:{type:"object",properties:{directory:{type:"string",description:'Directory to scan (default: "test-specs")'}}}}]};function Ce(){let s=0;for(let[,t]of L)t.status==="running"&&s++;return s}function $t(){for(;Y.length>0;){let s=Pt(Y[0]?.context?.options?.config);if(Ce()>=s)break;let{args:t,cwd:e,context:r}=Y.shift();Dt(t,e,r)}}async function ui(s,t){let{ticket:e,description:r,input:i,repo:n,agent:o,output:c}=s,a=["generate"];e&&a.push("--ticket",e),r&&a.push("--description",r),i&&a.push("--input",i),n&&a.push("--repo",n),c&&a.push("--output",c);let u=["assistant","cursor","claude","codex","gemini"],l=o||process.env.AGENT_TYPE,d=l&&u.includes(l)?l:null;d&&a.push("--agent",d);let p=e||"generate";return E(p,"\u{1F9EA}","Starting test spec generation (real agent with codebase access)..."),new Promise(m=>{Jt&&console.error(`[zibby:spawn] skill=run_generate parentPid=${process.pid} \u2192 child zibby ${a.map(g=>/\s/.test(g)?JSON.stringify(g):g).join(" ")} cwd=${t}`);let f=Ct("zibby",a,{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"],detached:!1}),y="",_="";f.stdout.on("data",g=>{let b=g.toString();y+=b;for(let h of b.split(`
449
- `)){let v=qt(h).trim();v.startsWith("\u2705")?E(p,"\u2705",v.slice(2).trim()):v.startsWith("\u2713")&&E(p,"\u2714",v.slice(2).trim())}}),f.stderr.on("data",g=>{_+=g.toString()}),f.on("close",g=>{if(g!==0){E(p,"\u274C",`Generation failed (exit ${g})`),m(JSON.stringify({error:`zibby generate failed with exit code ${g}`,stderr:_.slice(-1e3)}));return}let b=ee(t,c||"test-specs"),h=[];try{let v=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";h=ve(b).filter(T=>T.endsWith(".txt")&&(!v||T.startsWith(v))).map(T=>M(b,T))}catch{}E(p,"\u2705",`Generated ${h.length} test spec files`),m(JSON.stringify({success:!0,ticketKey:e||null,specFiles:h.map(v=>v.replace(`${t}/`,"")),total:h.length,message:`Generated ${h.length} specs. Now call run_test for each file.`}))}),f.on("error",g=>{E(p,"\u274C",`Spawn error: ${g.message}`),m(JSON.stringify({error:g.message}))})})}var jt=1e5,Tt=/^[A-Z][A-Z0-9]+-\d+$/,di=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function pi(s,t){if(!t||!t.length)return s;let e=s;for(let r of t)r.type==="strong"?e=`**${e}**`:r.type==="em"?e=`_${e}_`:r.type==="code"?e=`\`${e}\``:r.type==="strike"?e=`~~${e}~~`:r.type==="link"&&r.attrs?.href&&(e=`[${e}](${r.attrs.href})`);return e}function we(s,t=0){if(!Array.isArray(s))return"";let e=[];for(let r of s){if(r.type==="text"){e.push(pi(r.text||"",r.marks));continue}if(r.type==="hardBreak"){e.push(`
448
+ Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"run_generate":return await Ii(t,r);case"run_test":return await Ti(t,r,e);case"run_status":return Ei(t);case"run_cancel":return Li(t);case"run_artifacts":return Pi(t,r);case"run_diagnose":return Ji(t,r);case"list_specs":return Ui(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"run_generate",description:"Generate specs from codebase. CRITICAL: DO NOT USE if ticket has test steps in comments. Only use when: (1) NO steps in ticket AND (2) local codebase exists (not external URLs). For tickets with steps, use run_test with inline format.",input_schema:{type:"object",properties:{ticket:{type:"string",description:"Jira ticket key (e.g. SCRUM-123). Auto-fetches ticket details."},description:{type:"string",description:"Ticket description text (use if no Jira key available)"},input:{type:"string",description:"Path to a file containing ticket/requirements text"},repo:{type:"string",description:"Path to the codebase (default: current directory)"},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},output:{type:"string",description:"Output directory for spec files (default: test-specs)"}}}},{name:"run_test",description:"Start a test (async, returns runId). spec = file path, or inline:+steps, or a Jira-shaped issue key (e.g. PROJ-123): when Jira is connected, the runner loads that issue's description+comments into an inline spec. After starting, tell the user and let them ask for progress via run_status.",input_schema:{type:"object",properties:{spec:{type:"string",description:"Workspace file path; or inline:+steps; or Jira issue key (KEY-123) to auto-fetch from Jira when the jira skill is active."},ticketKey:{type:"string",description:"Optional label (e.g. SCRUM-123). If spec is an issue key, this defaults to that key."},agent:{type:"string",description:"Optional agent override (cursor, gemini, claude, codex, assistant). Omit to use configured agent."},headless:{type:"boolean",description:"Run browser headless (default false)"},workflow:{type:"string",description:"Workflow override (e.g. quick-smoke)"}},required:["spec"]}},{name:"run_status",description:'Instant progress check \u2014 returns immediately. Use this whenever user asks about test progress. ALWAYS use runId="all".',input_schema:{type:"object",properties:{runId:{type:"string",description:'Use "all" to see all runs in this session (recommended). Or a specific run ID if known.'}},required:["runId"]}},{name:"run_cancel",description:'Cancel/kill a running test. ONLY use when the USER explicitly asks to cancel or stop a run. NEVER auto-cancel \u2014 tests take 1-5 minutes and "running" is normal. Use runId="all" to cancel all active runs.',input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID to cancel, or "all" to cancel all active runs'}},required:["runId"]}},{name:"run_artifacts",description:"Read artifacts from a test run session. Can list files, read results/events/logs, or search across all sessions.",input_schema:{type:"object",properties:{runId:{type:"string",description:"Run ID from run_test. Omit to search across all sessions."},type:{type:"string",enum:["list","result","events","log","search"],description:'What to retrieve: "list" = all files in session, "result" = result.json, "events" = events.json, "log" = raw output tail, "search" = search text across sessions'},node:{type:"string",description:'Node name to read from (e.g. "execute_live", "generate_script"). Default: "execute_live"'},query:{type:"string",description:'Search text (only for type="search"). Searches across all session logs/events.'},tail:{type:"number",description:"Number of characters from end of log to return (default: 3000)"}},required:["type"]}},{name:"run_diagnose",description:"Diagnose one or all runs, especially failed ones. Uses run logs + known error patterns and returns likely root cause with suggested next action.",input_schema:{type:"object",properties:{runId:{type:"string",description:'Run ID from run_test, or "all" (default) to diagnose all known runs'},tail:{type:"number",description:"Characters of run log tail to inspect (default: 2000)"}}}},{name:"list_specs",description:"List available test spec files in the project",input_schema:{type:"object",properties:{directory:{type:"string",description:'Directory to scan (default: "test-specs")'}}}}]};function Ce(){let s=0;for(let[,t]of x)t.status==="running"&&s++;return s}function $t(){for(;Y.length>0;){let s=Pt(Y[0]?.context?.options?.config);if(Ce()>=s)break;let{args:t,cwd:e,context:r}=Y.shift();Dt(t,e,r)}}async function Ii(s,t){let{ticket:e,description:r,input:i,repo:n,agent:o,output:c}=s,a=["generate"];e&&a.push("--ticket",e),r&&a.push("--description",r),i&&a.push("--input",i),n&&a.push("--repo",n),c&&a.push("--output",c);let u=["assistant","cursor","claude","codex","gemini"],l=o||process.env.AGENT_TYPE,d=l&&u.includes(l)?l:null;d&&a.push("--agent",d);let p=e||"generate";return E(p,"\u{1F9EA}","Starting test spec generation (real agent with codebase access)..."),new Promise(m=>{Jt&&console.error(`[zibby:spawn] skill=run_generate parentPid=${process.pid} \u2192 child zibby ${a.map(g=>/\s/.test(g)?JSON.stringify(g):g).join(" ")} cwd=${t}`);let f=Ct("zibby",a,{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"],detached:!1}),y="",_="";f.stdout.on("data",g=>{let b=g.toString();y+=b;for(let h of b.split(`
449
+ `)){let v=qt(h).trim();v.startsWith("\u2705")?E(p,"\u2705",v.slice(2).trim()):v.startsWith("\u2713")&&E(p,"\u2714",v.slice(2).trim())}}),f.stderr.on("data",g=>{_+=g.toString()}),f.on("close",g=>{if(g!==0){E(p,"\u274C",`Generation failed (exit ${g})`),m(JSON.stringify({error:`zibby generate failed with exit code ${g}`,stderr:_.slice(-1e3)}));return}let b=ee(t,c||"test-specs"),h=[];try{let v=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";h=ve(b).filter(T=>T.endsWith(".txt")&&(!v||T.startsWith(v))).map(T=>M(b,T))}catch{}E(p,"\u2705",`Generated ${h.length} test spec files`),m(JSON.stringify({success:!0,ticketKey:e||null,specFiles:h.map(v=>v.replace(`${t}/`,"")),total:h.length,message:`Generated ${h.length} specs. Now call run_test for each file.`}))}),f.on("error",g=>{E(p,"\u274C",`Spawn error: ${g.message}`),m(JSON.stringify({error:g.message}))})})}var jt=1e5,Tt=/^[A-Z][A-Z0-9]+-\d+$/,Oi=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Ai(s,t){if(!t||!t.length)return s;let e=s;for(let r of t)r.type==="strong"?e=`**${e}**`:r.type==="em"?e=`_${e}_`:r.type==="code"?e=`\`${e}\``:r.type==="strike"?e=`~~${e}~~`:r.type==="link"&&r.attrs?.href&&(e=`[${e}](${r.attrs.href})`);return e}function we(s,t=0){if(!Array.isArray(s))return"";let e=[];for(let r of s){if(r.type==="text"){e.push(Ai(r.text||"",r.marks));continue}if(r.type==="hardBreak"){e.push(`
450
450
  `);continue}if(r.type==="rule"){e.push(`
451
451
  ---
452
452
  `);continue}let i=r.content?we(r.content,t+1):"";if(r.type==="listItem")e.push(i);else if(r.type==="bulletList"){let n=(r.content||[]).map(o=>`- ${we(o.content||[],t+1).trim()}`);e.push(`
@@ -459,21 +459,21 @@ ${n.join(`
459
459
 
460
460
  ${"#".repeat(n)} ${i.trim()}
461
461
 
462
- `)}else di.has(r.type)?e.push(`
462
+ `)}else Oi.has(r.type)?e.push(`
463
463
 
464
464
  ${i}
465
465
  `):e.push(i)}return e.join("").replace(/\n{3,}/g,`
466
466
 
467
- `)}function mi(s){return s==null||s===""?"":typeof s=="string"?s.trim():typeof s=="object"&&Array.isArray(s.content)?we(s.content).trim():""}async function fi(s){let{getSkill:t}=await import("@zibby/agent-workflow"),e=t("jira");if(!e||typeof e.handleToolCall!="function")return null;try{let r=await e.handleToolCall("jira_get_issue",{issueKey:s}),i=JSON.parse(r);if(i?.error)return null;let n=await e.handleToolCall("jira_get_comments",{issueKey:s,maxResults:50}),o=JSON.parse(n);if(o?.error)return null;let c=mi(i.description),a=[];c&&a.push(c);let u=Array.isArray(o.comments)?o.comments:[];if(u.length>0){let d=u.map(p=>String(p.body||"").trim()).filter(Boolean).join(`
467
+ `)}function Ri(s){return s==null||s===""?"":typeof s=="string"?s.trim():typeof s=="object"&&Array.isArray(s.content)?we(s.content).trim():""}async function $i(s){let{getSkill:t}=await import("@zibby/agent-workflow"),e=t("jira");if(!e||typeof e.handleToolCall!="function")return null;try{let r=await e.handleToolCall("jira_get_issue",{issueKey:s}),i=JSON.parse(r);if(i?.error)return null;let n=await e.handleToolCall("jira_get_comments",{issueKey:s,maxResults:50}),o=JSON.parse(n);if(o?.error)return null;let c=Ri(i.description),a=[];c&&a.push(c);let u=Array.isArray(o.comments)?o.comments:[];if(u.length>0){let d=u.map(p=>String(p.body||"").trim()).filter(Boolean).join(`
468
468
 
469
469
  `);d&&a.push(d)}let l=a.join(`
470
470
 
471
471
  `).trim();return l?(l.length>jt&&(l=`${l.slice(0,jt)}
472
472
 
473
- ...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:s}):null}catch{return null}}function yi(s,t){try{let e=JSON.parse(s);return JSON.stringify({...e,...t})}catch{return s}}async function hi(s,t,e){let r={...s},i=String(r.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let n=null;if(Tt.test(i)&&!i.startsWith("inline:")){let l=await fi(i);l&&(i=l.inlineSpec,r.spec=i,String(r.ticketKey||"").trim()||(r.ticketKey=l.issueKey),n=l.issueKey)}let o=String(r.ticketKey||"").trim();if(o){for(let[l,d]of L.entries())if(d?.ticketKey===o&&!(d?.status!=="running"&&d?.status!=="queued"))return JSON.stringify({runId:l,ticketKey:o,status:d.status,reused:!0,message:`A run for ${o} is already ${d.status}. Reusing existing run instead of starting a duplicate.`})}if(!i.startsWith("inline:")){let l=ee(t,i);if(!K(l))return Tt.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 c=Pt(e?.options?.config);if(Ce()>=c){let l=Ut(),d=r.ticketKey||l,p={runId:l,spec:r.ticketKey?`${r.ticketKey}: ${r.spec}`:r.spec,ticketKey:r.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};L.set(l,p),Y.push({args:{...r,_queuedRunId:l},cwd:t,context:e}),E(d,"\u23F3",`Queued (${Ce()}/${c} running, ${Y.length} queued)`);let m={runId:l,spec:p.spec,ticketKey:p.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${c} concurrent).`};return n&&(m.resolvedFromJiraIssue=n,m.message+=` (spec built from Jira ${n})`),JSON.stringify(m)}let a=Date.now()-Le;a<At&&Le>0&&await new Promise(l=>setTimeout(l,At-a)),Le=Date.now();let u=Dt(r,t,e);return n?yi(u,{resolvedFromJiraIssue:n,message:`Spec was loaded from Jira issue ${n} (description + comments).`}):u}function Dt(s,t,e){let{spec:r,ticketKey:i,agent:n,headless:o,workflow:c,_queuedRunId:a}=s,u=a||Ut(),l=r,d=!1;if(r.startsWith("inline:")){d=!0;let $=ai(t);Ot($,{recursive:!0}),l=M($,`${u}.txt`),si(l,r.slice(7).trim(),"utf-8")}let p=ee(t,".zibby","output","runs");Ot(p,{recursive:!0});let m=M(p,`${u}.log`),f=ni(m,{flags:"a"}),_=n&&["assistant","cursor","claude","codex","gemini"].includes(n)?n:null,g=["test",l];_&&g.push("--agent",_),o&&g.push("--headless"),c&&g.push("--workflow",c),Jt&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${g.map($=>/\s/.test($)?JSON.stringify($):$).join(" ")} cwd=${t}`);let b=Ct("zibby",g,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),h={runId:u,spec:i?`${i}: ${r}`:r,ticketKey:i||null,specPath:l,logPath:m,isInline:d,pid:b.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},v=i||u,T="";function rt($){let I=qt($).trim();if(!I)return;if(I.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let j=JSON.parse(I.slice(22));j.phase==="node_begin"?h.currentNode=j.node:j.phase==="node_end"&&(j.node&&!h.completedNodes.includes(j.node)&&h.completedNodes.push(j.node),h.currentNode===j.node&&(h.currentNode=null))}catch{}return}let oe=I.match(/Session\s+(\S+)/);if(oe&&!h.sessionId&&(h.sessionId=oe[1],h.sessionPath=ee(t,Je,Pe,h.sessionId)),I.startsWith("\u250C ")||I.startsWith("\u250C ")){let j=I.slice(2).trim();h.currentNode=j,ke&&E(v,"\u25B6",`${j}`)}else if(I.startsWith("\u2514 ")||I.startsWith("\u2514 ")){let j=I.slice(2).trim();j.startsWith("done")?(h.currentNode&&!h.completedNodes.includes(h.currentNode)&&h.completedNodes.push(h.currentNode),ke&&E(v,"\u2714",`${h.currentNode||"node"} done ${j.replace("done","").trim()}`),h.currentNode=null):j.startsWith("failed")&&(ke&&E(v,"\u2718",`${h.currentNode||"node"} failed ${j.replace("failed","").trim()}`),h.currentNode=null)}else I.includes("Workflow completed")&&(h.currentNode=null,ke&&E(v,"\u2714",`Workflow completed (${Rt(Date.now()-h.startTime)})`))}function Er($){let I=$.toString();h.output+=I,f.write(I),h.output.length>5e4&&(h.output=h.output.slice(-3e4)),T+=I;let oe=T.split(`
474
- `);T=oe.pop();for(let j of oe)rt(j)}return b.stdout.on("data",Er),b.stderr.on("data",$=>{let I=$.toString();h.error+=I,f.write(I),h.error.length>2e4&&(h.error=h.error.slice(-1e4))}),b.on("close",$=>{h.status=$===0?"passed":"failed",h.exitCode=$,h.endTime=Date.now(),T&&rt(T),f.end();let I=Rt(Date.now()-h.startTime);if($===0?E(v,"\u2705",`Passed (${I})`):E(v,"\u274C",`Failed (${I})`),h.isInline)try{ii(h.specPath)}catch{}$t()}),b.on("error",$=>{h.status="error",h.error+=`
475
- Spawn error: ${$.message}`,E(v,"\u274C",`Spawn error: ${$.message}`),f.end(),$t()}),h._child=b,L.set(u,h),JSON.stringify({runId:u,spec:h.spec,ticketKey:h.ticketKey,status:"running",pid:b.pid,logFile:m})}function Et(s){let t=Math.round(((s.endTime||Date.now())-s.startTime)/1e3),e=s.completedNodes||[],r=s.currentNode||null;if(s.status!=="running")return{elapsed:t,stage:s.status,completedNodes:e,currentNode:null};let i;return r?(i=`Actively executing node "${r}"`,e.length&&(i+=` (completed: ${e.join(", ")})`)):e.length?i=`Between nodes (completed: ${e.join(", ")})`:i="Starting up (initializing workflow)",i+=`. Elapsed: ${t}s. This is normal progress \u2014 do not cancel.`,{elapsed:t,stage:"running",currentNode:r,completedNodes:e,progress:i}}function gi(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[...L.entries()].map(([l,d])=>{let p=Et(d),m={runId:l,spec:d.spec,ticketKey:d.ticketKey,status:d.status,elapsed:p.elapsed,exitCode:d.exitCode,sessionId:d.sessionId||null};return d.status==="running"?(m.currentNode=p.currentNode,m.completedNodes=p.completedNodes,m.progress=p.progress):m.outputTail=d.output.slice(-500),m}),o=n.filter(l=>l.status==="running").length,c=n.filter(l=>l.status==="passed").length,a=n.filter(l=>l.status==="failed").length,u={total:n.length,running:o,passed:c,failed:a,runs:n};return o>0&&(u._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(u)}let e=L.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let r=Et(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:r.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=r.currentNode,i.completedNodes=r.completedNodes,i.progress=r.progress):(i.outputTail=e.output.slice(-1e3),i.errorTail=e.error.slice(-500)),e.status==="running"&&(i._hint="This run is actively progressing. Do NOT cancel, diagnose, or assume stuck. Just tell the user it is still running."),JSON.stringify(i)}function xt(s,t){if(t.status==="queued"){let e=Y.findIndex(r=>r.args._queuedRunId===s);return e>=0&&Y.splice(e,1),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}if(t.status!=="running")return{ok:!1,runId:s,error:`Run is not active (status: ${t.status})`};try{return t._child.kill("SIGTERM"),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}catch(e){return{ok:!1,runId:s,error:`Failed to cancel: ${e.message}`}}}function _i(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let r=[];for(let[i,n]of L.entries())(n.status==="running"||n.status==="queued")&&r.push(xt(i,n));return r.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:r.length,results:r})}let e=L.get(t);return JSON.stringify(e?xt(t,e):{error:`Run not found: ${t}`})}function bi(s,t){let e=L.get(s);if(e?.sessionPath&&K(e.sessionPath))return e.sessionPath;if(e?.sessionId){let r=ee(t,Je,Pe,e.sessionId);if(K(r))return r}return null}function Bt(s,t=""){let e=[];if(!K(s))return e;for(let r of ve(s,{withFileTypes:!0})){let i=t?`${t}/${r.name}`:r.name;if(r.isDirectory())e.push(...Bt(M(s,r.name),i));else{let n=oi(M(s,r.name));e.push({path:i,size:n.size})}}return e}function Lt(s){if(!K(s))return null;try{return JSON.parse(Se(s,"utf-8"))}catch{return null}}function Kt(s,t=2e3){if(!s||!K(s))return"";try{return Se(s,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function ki({run:s,logTail:t,errorTail:e}){let i=`${t||""}
476
- ${e||""}`.toLowerCase(),n={runId:s?.runId||null,status:s?.status||null,exitCode:s?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return s?.status==="running"||s?.status==="queued"?{...n,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...n,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...n,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...n,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...n,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...n,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:n}function wi(s,t){let{runId:e,type:r,node:i="execute_live",query:n,tail:o=3e3}=s;if(r==="search"){if(!n)return JSON.stringify({error:'query is required for type="search"'});let a=ee(t,Je,Pe);if(!K(a))return JSON.stringify({matches:[],message:"No sessions found"});let u=[],l=n.toLowerCase();for(let d of ve(a,{withFileTypes:!0})){if(!d.isDirectory())continue;let p=M(a,d.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:y}of m){let _=M(p,f);if(K(_))try{let g=Se(_,"utf-8");if(g.toLowerCase().includes(l)){let b=g.toLowerCase().indexOf(l),h=Math.max(0,b-100),v=Math.min(g.length,b+n.length+100);u.push({sessionId:d.name,artifact:y,snippet:g.slice(h,v)})}}catch{}}if(u.length>=20)break}return JSON.stringify({query:n,matches:u,total:u.length})}if(!e)return JSON.stringify({error:"runId is required for this type"});if(r==="log"){let a=L.get(e),u=Kt(a?.logPath,o);if(u)return JSON.stringify({runId:e,source:"run-log",totalLength:u.length,tail:u})}let c=bi(e,t);if(!c)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(r){case"list":{let a=Bt(c);return JSON.stringify({sessionId:c.split("/").pop(),files:a,total:a.length})}case"result":{let a=Lt(M(c,i,"result.json"));return JSON.stringify(a?{sessionId:c.split("/").pop(),node:i,result:a}:{error:`No result.json found in ${i}`})}case"events":{let a=Lt(M(c,i,"events.json"));if(!a)return JSON.stringify({error:`No events.json found in ${i}`});let u=Array.isArray(a)?a:a.events||[];return JSON.stringify({sessionId:c.split("/").pop(),node:i,totalEvents:u.length,events:u.slice(-50)})}case"log":{let a=M(c,i,"raw_stream_output.txt");if(!K(a))return JSON.stringify({error:`No log found in ${i}`});let u=Se(a,"utf-8");return JSON.stringify({sessionId:c.split("/").pop(),node:i,totalLength:u.length,tail:u.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${r}. Use: list, result, events, log, search`})}}function Si(s,t){let e=String(s?.runId||"all"),r=Number(s?.tail||2e3),i=e==="all"?[...L.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let n=i.map(a=>{let u=L.get(a);if(!u)return{runId:a,error:`Run not found: ${a}`};let l=Kt(u.logPath,r),d=String(u.error||"").slice(-Math.max(200,r));return{...ki({run:u,logTail:l,errorTail:d}),ticketKey:u.ticketKey||null,spec:u.spec,logTail:l,errorTail:d}}),o=n.filter(a=>a.status==="failed"||a.status==="error"),c=n.filter(a=>a.status==="running"||a.status==="queued");return JSON.stringify({total:n.length,failed:o.length,active:c.length,diagnoses:n})}function vi(s,t){let e=s?.directory||"test-specs",r=ee(t,e);if(!K(r))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let n=function(o,c){for(let a of ve(o,{withFileTypes:!0})){let u=c?`${c}/${a.name}`:a.name;a.isDirectory()?n(M(o,a.name),u):(a.name.endsWith(".txt")||a.name.endsWith(".md"))&&i.push(u)}},i=[];return n(r,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}import{spawn as Ni}from"child_process";import{existsSync as G,mkdirSync as Ii,readdirSync as Gt,statSync as Oi,readFileSync as Ai}from"fs";import{resolve as qe,join as F,basename as Ri}from"path";var Me=".zibby/repos";function Ne(s,t,e={}){return new Promise((r,i)=>{let n=Ni(s,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",c="";n.stdout.on("data",a=>{o+=a.toString()}),n.stderr.on("data",a=>{c+=a.toString()}),n.on("close",a=>{a!==0?i(new Error(`Exit ${a}: ${c.trim()||o.trim()}`)):r(o.trim())}),n.on("error",a=>i(a))})}var Ft={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],promptFragment:`## Git Repositories
473
+ ...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:s}):null}catch{return null}}function ji(s,t){try{let e=JSON.parse(s);return JSON.stringify({...e,...t})}catch{return s}}async function Ti(s,t,e){let r={...s},i=String(r.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let n=null;if(Tt.test(i)&&!i.startsWith("inline:")){let l=await $i(i);l&&(i=l.inlineSpec,r.spec=i,String(r.ticketKey||"").trim()||(r.ticketKey=l.issueKey),n=l.issueKey)}let o=String(r.ticketKey||"").trim();if(o){for(let[l,d]of x.entries())if(d?.ticketKey===o&&!(d?.status!=="running"&&d?.status!=="queued"))return JSON.stringify({runId:l,ticketKey:o,status:d.status,reused:!0,message:`A run for ${o} is already ${d.status}. Reusing existing run instead of starting a duplicate.`})}if(!i.startsWith("inline:")){let l=ee(t,i);if(!K(l))return Tt.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 c=Pt(e?.options?.config);if(Ce()>=c){let l=Ut(),d=r.ticketKey||l,p={runId:l,spec:r.ticketKey?`${r.ticketKey}: ${r.spec}`:r.spec,ticketKey:r.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};x.set(l,p),Y.push({args:{...r,_queuedRunId:l},cwd:t,context:e}),E(d,"\u23F3",`Queued (${Ce()}/${c} running, ${Y.length} queued)`);let m={runId:l,spec:p.spec,ticketKey:p.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${c} concurrent).`};return n&&(m.resolvedFromJiraIssue=n,m.message+=` (spec built from Jira ${n})`),JSON.stringify(m)}let a=Date.now()-xe;a<At&&xe>0&&await new Promise(l=>setTimeout(l,At-a)),xe=Date.now();let u=Dt(r,t,e);return n?ji(u,{resolvedFromJiraIssue:n,message:`Spec was loaded from Jira issue ${n} (description + comments).`}):u}function Dt(s,t,e){let{spec:r,ticketKey:i,agent:n,headless:o,workflow:c,_queuedRunId:a}=s,u=a||Ut(),l=r,d=!1;if(r.startsWith("inline:")){d=!0;let $=Si(t);Ot($,{recursive:!0}),l=M($,`${u}.txt`),_i(l,r.slice(7).trim(),"utf-8")}let p=ee(t,".zibby","output","runs");Ot(p,{recursive:!0});let m=M(p,`${u}.log`),f=ki(m,{flags:"a"}),_=n&&["assistant","cursor","claude","codex","gemini"].includes(n)?n:null,g=["test",l];_&&g.push("--agent",_),o&&g.push("--headless"),c&&g.push("--workflow",c),Jt&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${g.map($=>/\s/.test($)?JSON.stringify($):$).join(" ")} cwd=${t}`);let b=Ct("zibby",g,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),h={runId:u,spec:i?`${i}: ${r}`:r,ticketKey:i||null,specPath:l,logPath:m,isInline:d,pid:b.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},v=i||u,T="";function rt($){let I=qt($).trim();if(!I)return;if(I.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let j=JSON.parse(I.slice(22));j.phase==="node_begin"?h.currentNode=j.node:j.phase==="node_end"&&(j.node&&!h.completedNodes.includes(j.node)&&h.completedNodes.push(j.node),h.currentNode===j.node&&(h.currentNode=null))}catch{}return}let oe=I.match(/Session\s+(\S+)/);if(oe&&!h.sessionId&&(h.sessionId=oe[1],h.sessionPath=ee(t,Je,Pe,h.sessionId)),I.startsWith("\u250C ")||I.startsWith("\u250C ")){let j=I.slice(2).trim();h.currentNode=j,ke&&E(v,"\u25B6",`${j}`)}else if(I.startsWith("\u2514 ")||I.startsWith("\u2514 ")){let j=I.slice(2).trim();j.startsWith("done")?(h.currentNode&&!h.completedNodes.includes(h.currentNode)&&h.completedNodes.push(h.currentNode),ke&&E(v,"\u2714",`${h.currentNode||"node"} done ${j.replace("done","").trim()}`),h.currentNode=null):j.startsWith("failed")&&(ke&&E(v,"\u2718",`${h.currentNode||"node"} failed ${j.replace("failed","").trim()}`),h.currentNode=null)}else I.includes("Workflow completed")&&(h.currentNode=null,ke&&E(v,"\u2714",`Workflow completed (${Rt(Date.now()-h.startTime)})`))}function Er($){let I=$.toString();h.output+=I,f.write(I),h.output.length>5e4&&(h.output=h.output.slice(-3e4)),T+=I;let oe=T.split(`
474
+ `);T=oe.pop();for(let j of oe)rt(j)}return b.stdout.on("data",Er),b.stderr.on("data",$=>{let I=$.toString();h.error+=I,f.write(I),h.error.length>2e4&&(h.error=h.error.slice(-1e4))}),b.on("close",$=>{h.status=$===0?"passed":"failed",h.exitCode=$,h.endTime=Date.now(),T&&rt(T),f.end();let I=Rt(Date.now()-h.startTime);if($===0?E(v,"\u2705",`Passed (${I})`):E(v,"\u274C",`Failed (${I})`),h.isInline)try{bi(h.specPath)}catch{}$t()}),b.on("error",$=>{h.status="error",h.error+=`
475
+ Spawn error: ${$.message}`,E(v,"\u274C",`Spawn error: ${$.message}`),f.end(),$t()}),h._child=b,x.set(u,h),JSON.stringify({runId:u,spec:h.spec,ticketKey:h.ticketKey,status:"running",pid:b.pid,logFile:m})}function Et(s){let t=Math.round(((s.endTime||Date.now())-s.startTime)/1e3),e=s.completedNodes||[],r=s.currentNode||null;if(s.status!=="running")return{elapsed:t,stage:s.status,completedNodes:e,currentNode:null};let i;return r?(i=`Actively executing node "${r}"`,e.length&&(i+=` (completed: ${e.join(", ")})`)):e.length?i=`Between nodes (completed: ${e.join(", ")})`:i="Starting up (initializing workflow)",i+=`. Elapsed: ${t}s. This is normal progress \u2014 do not cancel.`,{elapsed:t,stage:"running",currentNode:r,completedNodes:e,progress:i}}function Ei(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[...x.entries()].map(([l,d])=>{let p=Et(d),m={runId:l,spec:d.spec,ticketKey:d.ticketKey,status:d.status,elapsed:p.elapsed,exitCode:d.exitCode,sessionId:d.sessionId||null};return d.status==="running"?(m.currentNode=p.currentNode,m.completedNodes=p.completedNodes,m.progress=p.progress):m.outputTail=d.output.slice(-500),m}),o=n.filter(l=>l.status==="running").length,c=n.filter(l=>l.status==="passed").length,a=n.filter(l=>l.status==="failed").length,u={total:n.length,running:o,passed:c,failed:a,runs:n};return o>0&&(u._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(u)}let e=x.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let r=Et(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:r.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=r.currentNode,i.completedNodes=r.completedNodes,i.progress=r.progress):(i.outputTail=e.output.slice(-1e3),i.errorTail=e.error.slice(-500)),e.status==="running"&&(i._hint="This run is actively progressing. Do NOT cancel, diagnose, or assume stuck. Just tell the user it is still running."),JSON.stringify(i)}function Lt(s,t){if(t.status==="queued"){let e=Y.findIndex(r=>r.args._queuedRunId===s);return e>=0&&Y.splice(e,1),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}if(t.status!=="running")return{ok:!1,runId:s,error:`Run is not active (status: ${t.status})`};try{return t._child.kill("SIGTERM"),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:s,status:"cancelled"}}catch(e){return{ok:!1,runId:s,error:`Failed to cancel: ${e.message}`}}}function Li(s){let{runId:t}=s;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let r=[];for(let[i,n]of x.entries())(n.status==="running"||n.status==="queued")&&r.push(Lt(i,n));return r.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:r.length,results:r})}let e=x.get(t);return JSON.stringify(e?Lt(t,e):{error:`Run not found: ${t}`})}function xi(s,t){let e=x.get(s);if(e?.sessionPath&&K(e.sessionPath))return e.sessionPath;if(e?.sessionId){let r=ee(t,Je,Pe,e.sessionId);if(K(r))return r}return null}function Bt(s,t=""){let e=[];if(!K(s))return e;for(let r of ve(s,{withFileTypes:!0})){let i=t?`${t}/${r.name}`:r.name;if(r.isDirectory())e.push(...Bt(M(s,r.name),i));else{let n=wi(M(s,r.name));e.push({path:i,size:n.size})}}return e}function xt(s){if(!K(s))return null;try{return JSON.parse(Se(s,"utf-8"))}catch{return null}}function Kt(s,t=2e3){if(!s||!K(s))return"";try{return Se(s,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function Ci({run:s,logTail:t,errorTail:e}){let i=`${t||""}
476
+ ${e||""}`.toLowerCase(),n={runId:s?.runId||null,status:s?.status||null,exitCode:s?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return s?.status==="running"||s?.status==="queued"?{...n,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...n,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...n,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...n,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...n,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...n,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:n}function Pi(s,t){let{runId:e,type:r,node:i="execute_live",query:n,tail:o=3e3}=s;if(r==="search"){if(!n)return JSON.stringify({error:'query is required for type="search"'});let a=ee(t,Je,Pe);if(!K(a))return JSON.stringify({matches:[],message:"No sessions found"});let u=[],l=n.toLowerCase();for(let d of ve(a,{withFileTypes:!0})){if(!d.isDirectory())continue;let p=M(a,d.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:y}of m){let _=M(p,f);if(K(_))try{let g=Se(_,"utf-8");if(g.toLowerCase().includes(l)){let b=g.toLowerCase().indexOf(l),h=Math.max(0,b-100),v=Math.min(g.length,b+n.length+100);u.push({sessionId:d.name,artifact:y,snippet:g.slice(h,v)})}}catch{}}if(u.length>=20)break}return JSON.stringify({query:n,matches:u,total:u.length})}if(!e)return JSON.stringify({error:"runId is required for this type"});if(r==="log"){let a=x.get(e),u=Kt(a?.logPath,o);if(u)return JSON.stringify({runId:e,source:"run-log",totalLength:u.length,tail:u})}let c=xi(e,t);if(!c)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(r){case"list":{let a=Bt(c);return JSON.stringify({sessionId:c.split("/").pop(),files:a,total:a.length})}case"result":{let a=xt(M(c,i,"result.json"));return JSON.stringify(a?{sessionId:c.split("/").pop(),node:i,result:a}:{error:`No result.json found in ${i}`})}case"events":{let a=xt(M(c,i,"events.json"));if(!a)return JSON.stringify({error:`No events.json found in ${i}`});let u=Array.isArray(a)?a:a.events||[];return JSON.stringify({sessionId:c.split("/").pop(),node:i,totalEvents:u.length,events:u.slice(-50)})}case"log":{let a=M(c,i,"raw_stream_output.txt");if(!K(a))return JSON.stringify({error:`No log found in ${i}`});let u=Se(a,"utf-8");return JSON.stringify({sessionId:c.split("/").pop(),node:i,totalLength:u.length,tail:u.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${r}. Use: list, result, events, log, search`})}}function Ji(s,t){let e=String(s?.runId||"all"),r=Number(s?.tail||2e3),i=e==="all"?[...x.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let n=i.map(a=>{let u=x.get(a);if(!u)return{runId:a,error:`Run not found: ${a}`};let l=Kt(u.logPath,r),d=String(u.error||"").slice(-Math.max(200,r));return{...Ci({run:u,logTail:l,errorTail:d}),ticketKey:u.ticketKey||null,spec:u.spec,logTail:l,errorTail:d}}),o=n.filter(a=>a.status==="failed"||a.status==="error"),c=n.filter(a=>a.status==="running"||a.status==="queued");return JSON.stringify({total:n.length,failed:o.length,active:c.length,diagnoses:n})}function Ui(s,t){let e=s?.directory||"test-specs",r=ee(t,e);if(!K(r))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let n=function(o,c){for(let a of ve(o,{withFileTypes:!0})){let u=c?`${c}/${a.name}`:a.name;a.isDirectory()?n(M(o,a.name),u):(a.name.endsWith(".txt")||a.name.endsWith(".md"))&&i.push(u)}},i=[];return n(r,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}import{spawn as qi}from"child_process";import{existsSync as G,mkdirSync as Mi,readdirSync as Gt,statSync as Di,readFileSync as Bi}from"fs";import{resolve as qe,join as F,basename as Ki}from"path";var Me=".zibby/repos";function Ne(s,t,e={}){return new Promise((r,i)=>{let n=qi(s,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",c="";n.stdout.on("data",a=>{o+=a.toString()}),n.stderr.on("data",a=>{c+=a.toString()}),n.on("close",a=>{a!==0?i(new Error(`Exit ${a}: ${c.trim()||o.trim()}`)):r(o.trim())}),n.on("error",a=>i(a))})}var Ft={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],promptFragment:`## Git Repositories
477
477
  You can clone and explore git repositories locally for codebase analysis:
478
478
  - git_checkout: Clone a repo (or pull if already cloned). Supports GitHub and GitLab with auto-auth.
479
479
  - git_list_repos: List locally cloned repos
@@ -484,7 +484,7 @@ When a test ticket lacks context, use this workflow:
484
484
  2. Use git_explore to understand the project structure
485
485
  3. Use shell commands (grep, cat) to read specific files for deeper understanding
486
486
  4. Use GitHub/GitLab skills to read related PRs and commits
487
- 5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"git_checkout":return await $i(t,r);case"git_list_repos":return ji(t,r);case"git_explore":return Ti(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"git_checkout",description:"Clone a git repository locally (or pull latest if already cloned). Auto-authenticates with GitHub/GitLab tokens if available.",input_schema:{type:"object",properties:{url:{type:"string",description:'Repository URL (e.g. "https://github.com/org/repo" or "org/repo" shorthand for GitHub)'},branch:{type:"string",description:"Branch to checkout (default: repo default branch)"},shallow:{type:"boolean",description:"Shallow clone with depth 1 (default: true, faster)"},name:{type:"string",description:"Local directory name override (default: repo name from URL)"}},required:["url"]}},{name:"git_list_repos",description:"List locally cloned repositories",input_schema:{type:"object",properties:{}}},{name:"git_explore",description:"Quick structural overview of a cloned repo: key files, package.json info, directory tree (top 2 levels), detected framework/language",input_schema:{type:"object",properties:{repo:{type:"string",description:"Repo name (as listed by git_list_repos)"},depth:{type:"number",description:"Directory tree depth (default: 2)"}},required:["repo"]}}]};async function $i(s,t){let{url:e,branch:r,shallow:i=!0,name:n}=s;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=n||Ri(e.replace(/\.git$/,"")),c=qe(t,Me);Ii(c,{recursive:!0});let a=F(c,o),u=e,l=process.env.GITHUB_TOKEN,d=process.env.GITLAB_TOKEN,p=process.env.GITLAB_URL;if(e.includes("github.com")&&l)u=e.replace("https://github.com",`https://x-access-token:${l}@github.com`);else if(d&&p)try{let y=new URL(p).host;e.includes(y)&&(u=e.replace(`https://${y}`,`https://oauth2:${d}@${y}`))}catch{}if(G(F(a,".git"))){let y=r?`git -C "${a}" fetch origin ${r} && git -C "${a}" checkout ${r} && git -C "${a}" pull origin ${r}`:`git -C "${a}" pull`;await Ne(y,t);let _=await Ne(`git -C "${a}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:a,branch:r||"default",head:_})}let m=["git","clone"];i&&m.push("--depth","1"),r&&m.push("--branch",r),m.push(`"${u}"`,`"${a}"`),await Ne(m.join(" "),t);let f=await Ne(`git -C "${a}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:a,branch:r||"default",shallow:i,head:f})}function ji(s,t){let e=qe(t,Me);if(!G(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let r=[];for(let i of Gt(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let n=F(e,i.name);if(!G(F(n,".git")))continue;let o=Oi(n);r.push({name:i.name,path:n,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:r,total:r.length,directory:e})}function Ti(s,t){let{repo:e,depth:r=2}=s,i=qe(t,Me,e);if(!G(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let n={repo:e,path:i},o=F(i,"package.json");if(G(o))try{let m=JSON.parse(Ai(o,"utf-8"));n.packageJson={name:m.name,version:m.version,scripts:m.scripts?Object.keys(m.scripts):[],dependencies:m.dependencies?Object.keys(m.dependencies).slice(0,30):[],devDependencies:m.devDependencies?Object.keys(m.devDependencies).slice(0,20):[]},m.dependencies?.react?n.framework="React":m.dependencies?.next?n.framework="Next.js":m.dependencies?.vue?n.framework="Vue":m.dependencies?.angular?n.framework="Angular":m.dependencies?.express?n.framework="Express":m.dependencies?.fastify&&(n.framework="Fastify")}catch{}let c=F(i,"pyproject.toml");G(c)&&(n.language="Python");let a=F(i,"go.mod");G(a)&&(n.language="Go");let u=F(i,"Cargo.toml");G(u)&&(n.language="Rust"),G(o)&&(n.language=n.language||"JavaScript/TypeScript");let l=[];function d(m,f,y){if(y>r)return;let _;try{_=Gt(m,{withFileTypes:!0})}catch{return}let g=_.filter(b=>!b.name.startsWith(".")&&b.name!=="node_modules"&&b.name!=="__pycache__"&&b.name!=="dist"&&b.name!=="build"&&b.name!==".git").sort((b,h)=>b.isDirectory()!==h.isDirectory()?b.isDirectory()?-1:1:b.name.localeCompare(h.name));for(let b of g){let h=b.isDirectory();l.push(`${f}${h?"\u{1F4C1}":"\u{1F4C4}"} ${b.name}`),h&&y<r&&d(F(m,b.name),`${f} `,y+1)}}d(i,"",1),n.tree=l.slice(0,80),l.length>80&&(n.treeTruncated=!0);let p=["README.md","README.rst","src/App.tsx","src/App.jsx","src/App.js","src/routes.tsx","src/routes.js","app/routes.tsx","app/routes.js","src/index.tsx","src/index.ts","src/main.tsx","src/main.ts","pages/_app.tsx","pages/_app.js","app/layout.tsx","docker-compose.yml","Dockerfile",".env.example"];return n.keyFilesFound=p.filter(m=>G(F(i,m))),JSON.stringify(n)}import{execFileSync as Zt}from"child_process";import{existsSync as ze,mkdirSync as Vt}from"fs";import{join as z,basename as Ei}from"path";import{randomBytes as xi}from"crypto";import{pathToFileURL as de}from"url";import{createRequire as Qt}from"module";var Ke=".zibby/memory",Xt="dolt",er={encoding:"utf-8",stdio:["pipe","pipe","pipe"],timeout:15e3},Ge="mem0",De=new Map,Ie=new Map,Oe=!1,Li=Qt(import.meta.url),je=()=>xi(8).toString("hex"),te=()=>new Date().toISOString(),Ci=[`CREATE TABLE IF NOT EXISTS chat_memory (
487
+ 5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"git_checkout":return await Gi(t,r);case"git_list_repos":return Fi(t,r);case"git_explore":return zi(t,r);default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},tools:[{name:"git_checkout",description:"Clone a git repository locally (or pull latest if already cloned). Auto-authenticates with GitHub/GitLab tokens if available.",input_schema:{type:"object",properties:{url:{type:"string",description:'Repository URL (e.g. "https://github.com/org/repo" or "org/repo" shorthand for GitHub)'},branch:{type:"string",description:"Branch to checkout (default: repo default branch)"},shallow:{type:"boolean",description:"Shallow clone with depth 1 (default: true, faster)"},name:{type:"string",description:"Local directory name override (default: repo name from URL)"}},required:["url"]}},{name:"git_list_repos",description:"List locally cloned repositories",input_schema:{type:"object",properties:{}}},{name:"git_explore",description:"Quick structural overview of a cloned repo: key files, package.json info, directory tree (top 2 levels), detected framework/language",input_schema:{type:"object",properties:{repo:{type:"string",description:"Repo name (as listed by git_list_repos)"},depth:{type:"number",description:"Directory tree depth (default: 2)"}},required:["repo"]}}]};async function Gi(s,t){let{url:e,branch:r,shallow:i=!0,name:n}=s;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=n||Ki(e.replace(/\.git$/,"")),c=qe(t,Me);Mi(c,{recursive:!0});let a=F(c,o),u=e,l=process.env.GITHUB_TOKEN,d=process.env.GITLAB_TOKEN,p=process.env.GITLAB_URL;if(e.includes("github.com")&&l)u=e.replace("https://github.com",`https://x-access-token:${l}@github.com`);else if(d&&p)try{let y=new URL(p).host;e.includes(y)&&(u=e.replace(`https://${y}`,`https://oauth2:${d}@${y}`))}catch{}if(G(F(a,".git"))){let y=r?`git -C "${a}" fetch origin ${r} && git -C "${a}" checkout ${r} && git -C "${a}" pull origin ${r}`:`git -C "${a}" pull`;await Ne(y,t);let _=await Ne(`git -C "${a}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:a,branch:r||"default",head:_})}let m=["git","clone"];i&&m.push("--depth","1"),r&&m.push("--branch",r),m.push(`"${u}"`,`"${a}"`),await Ne(m.join(" "),t);let f=await Ne(`git -C "${a}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:a,branch:r||"default",shallow:i,head:f})}function Fi(s,t){let e=qe(t,Me);if(!G(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let r=[];for(let i of Gt(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let n=F(e,i.name);if(!G(F(n,".git")))continue;let o=Di(n);r.push({name:i.name,path:n,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:r,total:r.length,directory:e})}function zi(s,t){let{repo:e,depth:r=2}=s,i=qe(t,Me,e);if(!G(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let n={repo:e,path:i},o=F(i,"package.json");if(G(o))try{let m=JSON.parse(Bi(o,"utf-8"));n.packageJson={name:m.name,version:m.version,scripts:m.scripts?Object.keys(m.scripts):[],dependencies:m.dependencies?Object.keys(m.dependencies).slice(0,30):[],devDependencies:m.devDependencies?Object.keys(m.devDependencies).slice(0,20):[]},m.dependencies?.react?n.framework="React":m.dependencies?.next?n.framework="Next.js":m.dependencies?.vue?n.framework="Vue":m.dependencies?.angular?n.framework="Angular":m.dependencies?.express?n.framework="Express":m.dependencies?.fastify&&(n.framework="Fastify")}catch{}let c=F(i,"pyproject.toml");G(c)&&(n.language="Python");let a=F(i,"go.mod");G(a)&&(n.language="Go");let u=F(i,"Cargo.toml");G(u)&&(n.language="Rust"),G(o)&&(n.language=n.language||"JavaScript/TypeScript");let l=[];function d(m,f,y){if(y>r)return;let _;try{_=Gt(m,{withFileTypes:!0})}catch{return}let g=_.filter(b=>!b.name.startsWith(".")&&b.name!=="node_modules"&&b.name!=="__pycache__"&&b.name!=="dist"&&b.name!=="build"&&b.name!==".git").sort((b,h)=>b.isDirectory()!==h.isDirectory()?b.isDirectory()?-1:1:b.name.localeCompare(h.name));for(let b of g){let h=b.isDirectory();l.push(`${f}${h?"\u{1F4C1}":"\u{1F4C4}"} ${b.name}`),h&&y<r&&d(F(m,b.name),`${f} `,y+1)}}d(i,"",1),n.tree=l.slice(0,80),l.length>80&&(n.treeTruncated=!0);let p=["README.md","README.rst","src/App.tsx","src/App.jsx","src/App.js","src/routes.tsx","src/routes.js","app/routes.tsx","app/routes.js","src/index.tsx","src/index.ts","src/main.tsx","src/main.ts","pages/_app.tsx","pages/_app.js","app/layout.tsx","docker-compose.yml","Dockerfile",".env.example"];return n.keyFilesFound=p.filter(m=>G(F(i,m))),JSON.stringify(n)}import{execFileSync as Zt}from"child_process";import{existsSync as ze,mkdirSync as Vt}from"fs";import{join as z,basename as Wi}from"path";import{randomBytes as Hi}from"crypto";import{pathToFileURL as de}from"url";import{createRequire as Qt}from"module";var Ke=".zibby/memory",Xt="dolt",er={encoding:"utf-8",stdio:["pipe","pipe","pipe"],timeout:15e3},Ge="mem0",De=new Map,Ie=new Map,Oe=!1,Yi=Qt(import.meta.url),je=()=>Hi(8).toString("hex"),te=()=>new Date().toISOString(),Zi=[`CREATE TABLE IF NOT EXISTS chat_memory (
488
488
  id VARCHAR(64) PRIMARY KEY,
489
489
  memory_key VARCHAR(160),
490
490
  category VARCHAR(32) NOT NULL,
@@ -515,10 +515,10 @@ When a test ticket lacks context, use this workflow:
515
515
  tasks_failed INT DEFAULT 0,
516
516
  key_facts TEXT,
517
517
  created_at VARCHAR(32) NOT NULL
518
- )`],zt=new Set;function C(s,t){return Zt(Xt,t,{...er,cwd:s})}function Z(s,t){try{let e=C(s,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function P(s,t){C(s,["sql","-q",t])}function Ae(s){if(zt.has(s))return!0;if(!ze(z(s,".dolt"))){if(!Pi())return!1;Vt(s,{recursive:!0}),C(s,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let t=`${Ci.join(`;
519
- `)};`;P(s,t);try{P(s,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{P(s,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return zt.add(s),!0}function Pi(){try{return Zt(Xt,["version"],{...er,timeout:5e3}),!0}catch{return!1}}function w(s){return s==null?"NULL":`'${String(s).replace(/'/g,"''")}'`}function Fe(s){return String(s||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function se(s){return s==="long"?3:s==="mid"?2:s==="short"?1:0}function We(s,t){let e=["short","mid","long"].includes(s)?s:"mid";return new Set(["fact","decision","preference","credential","url","workaround"]).has(String(t||"").toLowerCase())&&e==="short"?"mid":e}function tr(s){let t=new Map;for(let e of s||[]){let r=Fe(e.content),i=e.memory_key?`key:${e.memory_key}`:r?`norm:${r}`:"";if(!i)continue;let n=t.get(i);if(!n){t.set(i,e);continue}let o=se(n.tier),c=se(e.tier);if(c>o){t.set(i,e);continue}c===o&&Number(e.relevance||0)>Number(n.relevance||0)&&t.set(i,e)}return[...t.values()]}function $e(s,t){let e=String(s??"");return e.length<=t?e:t<=1?e.slice(0,t):`${e.slice(0,t-1)}\u2026`}function ue(s,t){let e={recentSessions:Array.isArray(s?.recentSessions)?s.recentSessions:[],topMemories:Array.isArray(s?.topMemories)?s.topMemories:[],taskStats:Array.isArray(s?.taskStats)?s.taskStats:[],ticketFilter:s?.ticketFilter||null,backend:t||String(s?.backend||Ge),error:s?.error||null};return e.backend==="mem0"?{...e,recentSessions:[],taskStats:[]}:e}function Wt(s){let t=[];if(s.recentSessions?.length>0){t.push("Recent sessions:");for(let e of s.recentSessions.slice(0,3))e?.summary?.trim()&&t.push(`- ${$e(e.summary,150)}${e.tickets?` [${e.tickets}]`:""}`)}if(s.topMemories?.length>0){t.push("Known facts:");for(let e of s.topMemories.slice(0,10)){let r=e.tier==="long"?"\u2605":"\xB7";t.push(`${r} [${e.category}] ${$e(e.content,120)}`)}}return t.length===0?"":`## Memory Context
518
+ )`],zt=new Set;function C(s,t){return Zt(Xt,t,{...er,cwd:s})}function Z(s,t){try{let e=C(s,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function P(s,t){C(s,["sql","-q",t])}function Ae(s){if(zt.has(s))return!0;if(!ze(z(s,".dolt"))){if(!Vi())return!1;Vt(s,{recursive:!0}),C(s,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let t=`${Zi.join(`;
519
+ `)};`;P(s,t);try{P(s,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{P(s,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return zt.add(s),!0}function Vi(){try{return Zt(Xt,["version"],{...er,timeout:5e3}),!0}catch{return!1}}function w(s){return s==null?"NULL":`'${String(s).replace(/'/g,"''")}'`}function Fe(s){return String(s||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function se(s){return s==="long"?3:s==="mid"?2:s==="short"?1:0}function We(s,t){let e=["short","mid","long"].includes(s)?s:"mid";return new Set(["fact","decision","preference","credential","url","workaround"]).has(String(t||"").toLowerCase())&&e==="short"?"mid":e}function tr(s){let t=new Map;for(let e of s||[]){let r=Fe(e.content),i=e.memory_key?`key:${e.memory_key}`:r?`norm:${r}`:"";if(!i)continue;let n=t.get(i);if(!n){t.set(i,e);continue}let o=se(n.tier),c=se(e.tier);if(c>o){t.set(i,e);continue}c===o&&Number(e.relevance||0)>Number(n.relevance||0)&&t.set(i,e)}return[...t.values()]}function $e(s,t){let e=String(s??"");return e.length<=t?e:t<=1?e.slice(0,t):`${e.slice(0,t-1)}\u2026`}function ue(s,t){let e={recentSessions:Array.isArray(s?.recentSessions)?s.recentSessions:[],topMemories:Array.isArray(s?.topMemories)?s.topMemories:[],taskStats:Array.isArray(s?.taskStats)?s.taskStats:[],ticketFilter:s?.ticketFilter||null,backend:t||String(s?.backend||Ge),error:s?.error||null};return e.backend==="mem0"?{...e,recentSessions:[],taskStats:[]}:e}function Wt(s){let t=[];if(s.recentSessions?.length>0){t.push("Recent sessions:");for(let e of s.recentSessions.slice(0,3))e?.summary?.trim()&&t.push(`- ${$e(e.summary,150)}${e.tickets?` [${e.tickets}]`:""}`)}if(s.topMemories?.length>0){t.push("Known facts:");for(let e of s.topMemories.slice(0,10)){let r=e.tier==="long"?"\u2605":"\xB7";t.push(`${r} [${e.category}] ${$e(e.content,120)}`)}}return t.length===0?"":`## Memory Context
520
520
  ${t.join(`
521
- `)}`}function Re(s){return{backend:s.backend,recentSessions:s.recentSessions.slice(0,3).map(t=>({summary:$e(String(t?.summary||""),160),tickets:t?.tickets||null,created_at:t?.created_at||null})),topMemories:s.topMemories.slice(0,8).map(t=>({category:t?.category||null,tier:t?.tier||null,content:$e(String(t?.content||""),140),source:t?.source||null})),taskStats:s.taskStats,error:s.error||null}}async function Ji(s,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let r=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(r==="mem0"||r==="dolt")return r;if(Ie.has(s))return Ie.get(s);try{let i=z(s,".zibby.config.mjs");if(ze(i)){let n=await import(de(i).href),o=String(n?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Ie.set(s,o),o}}catch{}return Ie.set(s,Ge),Ge}function rr(s){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${Ei(s||process.cwd())}`}var Ui="mem0";function sr(s){let t=z(s,Ke,Ui);return{dir:t,vectorDbPath:z(t,"vectors.db"),historyDbPath:z(t,"history.db")}}function qi(s){let t=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),r=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),i=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),n=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:c}=sr(s||process.cwd());return{llm:{provider:"openai",config:{model:r,baseURL:t,...e?{apiKey:e}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:n,baseURL:t,...e?{apiKey:e}:{}}},vectorStore:{provider:"memory",config:{dimension:n,dbPath:o}},historyDbPath:c}}async function ir(s){let t=s||process.cwd();if(De.has(t))return De.get(t);let e;try{let c=Qt(de(z(t,"package.json")).href).resolve("mem0ai/oss");e=await import(de(c).href)}catch{try{let o=Li.resolve("mem0ai/oss");e=await import(de(o).href)}catch(o){throw new Error(`Cannot find package 'mem0ai' for workspace "${t}". Install in that project: npm install mem0ai. (${o.message})`,{cause:o})}}let r=e?.Memory;if(!r)throw new Error("mem0ai/oss does not export Memory");let i=qi(t);if(i)try{Vt(sr(t).dir,{recursive:!0})}catch{}let n=i?new r(i):new r;return De.set(t,n),n}function Ht(s,t="mid"){return(Array.isArray(s)?s:Array.isArray(s?.results)?s.results:[]).map(r=>({id:r?.id||je(),memory_key:r?.metadata?.memoryKey||r?.metadata?.memory_key||null,category:r?.metadata?.category||"fact",content:r?.memory||r?.content||"",source:r?.metadata?.source||"mem0",ticket_key:r?.metadata?.ticketKey||r?.metadata?.ticket_key||null,tier:We(r?.metadata?.tier||t,r?.metadata?.category||"fact"),relevance:Number(r?.score??r?.metadata?.relevance??.8),created_at:r?.created_at||r?.metadata?.created_at||te()})).filter(r=>String(r.content||"").trim().length>0)}var ie={id:"dolt",store:(s,t)=>or(s,t),recall:(s,t)=>Fi(s,t),brief:(s,t)=>zi(s,t),endSession:(s,t)=>cr(s,t),logTask:(s,t)=>lr(s,t),taskHistory:(s,t)=>ur(s,t)},Mi={id:"mem0",store:(s,t,e)=>Gi(s,t,e),recall:(s,t,e)=>ar(s,t,e),brief:(s,t,e)=>Wi(s,t,e),endSession:(s,t)=>cr(s,t),logTask:(s,t)=>lr(s,t),taskHistory:(s,t)=>ur(s,t)},Di={dolt:ie,mem0:Mi};async function Yt(s,t){let e=await Ji(s,t);return Di[e]||ie}var nr={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
521
+ `)}`}function Re(s){return{backend:s.backend,recentSessions:s.recentSessions.slice(0,3).map(t=>({summary:$e(String(t?.summary||""),160),tickets:t?.tickets||null,created_at:t?.created_at||null})),topMemories:s.topMemories.slice(0,8).map(t=>({category:t?.category||null,tier:t?.tier||null,content:$e(String(t?.content||""),140),source:t?.source||null})),taskStats:s.taskStats,error:s.error||null}}async function Qi(s,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let r=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(r==="mem0"||r==="dolt")return r;if(Ie.has(s))return Ie.get(s);try{let i=z(s,".zibby.config.mjs");if(ze(i)){let n=await import(de(i).href),o=String(n?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Ie.set(s,o),o}}catch{}return Ie.set(s,Ge),Ge}function rr(s){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${Wi(s||process.cwd())}`}var Xi="mem0";function sr(s){let t=z(s,Ke,Xi);return{dir:t,vectorDbPath:z(t,"vectors.db"),historyDbPath:z(t,"history.db")}}function en(s){let t=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),r=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),i=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),n=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:c}=sr(s||process.cwd());return{llm:{provider:"openai",config:{model:r,baseURL:t,...e?{apiKey:e}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:n,baseURL:t,...e?{apiKey:e}:{}}},vectorStore:{provider:"memory",config:{dimension:n,dbPath:o}},historyDbPath:c}}async function ir(s){let t=s||process.cwd();if(De.has(t))return De.get(t);let e;try{let c=Qt(de(z(t,"package.json")).href).resolve("mem0ai/oss");e=await import(de(c).href)}catch{try{let o=Yi.resolve("mem0ai/oss");e=await import(de(o).href)}catch(o){throw new Error(`Cannot find package 'mem0ai' for workspace "${t}". Install in that project: npm install mem0ai. (${o.message})`,{cause:o})}}let r=e?.Memory;if(!r)throw new Error("mem0ai/oss does not export Memory");let i=en(t);if(i)try{Vt(sr(t).dir,{recursive:!0})}catch{}let n=i?new r(i):new r;return De.set(t,n),n}function Ht(s,t="mid"){return(Array.isArray(s)?s:Array.isArray(s?.results)?s.results:[]).map(r=>({id:r?.id||je(),memory_key:r?.metadata?.memoryKey||r?.metadata?.memory_key||null,category:r?.metadata?.category||"fact",content:r?.memory||r?.content||"",source:r?.metadata?.source||"mem0",ticket_key:r?.metadata?.ticketKey||r?.metadata?.ticket_key||null,tier:We(r?.metadata?.tier||t,r?.metadata?.category||"fact"),relevance:Number(r?.score??r?.metadata?.relevance??.8),created_at:r?.created_at||r?.metadata?.created_at||te()})).filter(r=>String(r.content||"").trim().length>0)}var ie={id:"dolt",store:(s,t)=>or(s,t),recall:(s,t)=>an(s,t),brief:(s,t)=>cn(s,t),endSession:(s,t)=>cr(s,t),logTask:(s,t)=>lr(s,t),taskHistory:(s,t)=>ur(s,t)},tn={id:"mem0",store:(s,t,e)=>on(s,t,e),recall:(s,t,e)=>ar(s,t,e),brief:(s,t,e)=>ln(s,t,e),endSession:(s,t)=>cr(s,t),logTask:(s,t)=>lr(s,t),taskHistory:(s,t)=>ur(s,t)},rn={dolt:ie,mem0:tn};async function Yt(s,t){let e=await Qi(s,t);return rn[e]||ie}var nr={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
522
522
  You have persistent memory across sessions. Use it to avoid losing context:
523
523
  - **memory_store**: Save important facts, decisions, or context. Anything worth remembering.
524
524
  - **memory_recall**: Search your memory by keyword or category. Use this at the START of conversations to recall relevant context.
@@ -556,18 +556,18 @@ fact, decision, context, insight, credential, url, error, workaround`,resolve(){
556
556
  SET tier = ${w(b?u:_)},
557
557
  relevance = ${Math.max(l,g)}
558
558
  WHERE id = ${w(m.id)}`);try{C(t,["add","."]),C(t,["commit","-m",`memory promote: ${r} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:m.id,category:r,tier:b?u:_,deduped:!0,promoted:!0})}return JSON.stringify({ok:!0,id:m.id,category:r,tier:_,deduped:!0,promoted:!1})}let f=je(),y=process.env.ZIBBY_CHAT_SESSION_ID||null;P(t,`INSERT INTO chat_memory (id, memory_key, category, content, source, ticket_key, session_id, tier, relevance, created_at)
559
- VALUES (${w(f)}, ${w(d||null)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(n)}, ${w(y)}, ${w(u)}, ${l}, ${w(te())})`);try{C(t,["add","."]),C(t,["commit","-m",`memory: ${r} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:f,category:r,tier:u,memoryKey:d||null,stored:e.slice(0,100)})}function Bi(s){let t=String(s||"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}var Be=new Map;async function Ki(s,t){if(typeof s=="boolean")return s;if(process.env.ZIBBY_MEM0_INFER!=null&&String(process.env.ZIBBY_MEM0_INFER).trim()!=="")return Bi(process.env.ZIBBY_MEM0_INFER);let e=t||process.cwd();if(Be.has(e))return Be.get(e);let r=!1;try{let i=z(e,".zibby.config.mjs");ze(i)&&(r=(await import(de(i).href))?.default?.memory?.infer===!0)}catch{}return Be.set(e,r),r}async function Gi(s,t,e){let{content:r,category:i,source:n,ticketKey:o,tier:c,memoryKey:a,infer:u}=s;if(!r||!i)return JSON.stringify({error:"content and category are required"});try{let l=await ir(e),d=rr(e),p=We(c,i),m=await Ki(u,e);return await l.add([{role:"user",content:String(r)}],{userId:d,infer:m,metadata:{memoryKey:a||null,category:i,tier:p,source:n||"zibby-chat",ticketKey:o||null,created_at:te()}}),JSON.stringify({ok:!0,backend:"mem0",userId:d,category:i,tier:p,infer:m,memoryKey:a||null,stored:String(r).slice(0,100)})}catch(l){throw new Error(`mem0 store failed: ${l.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:l})}}function Fi(s,t){let{query:e,category:r,ticketKey:i,tier:n,limit:o=20}=s,c=[];e&&c.push(`content LIKE ${w(`%${e}%`)}`),r&&c.push(`category = ${w(r)}`),i&&c.push(`ticket_key = ${w(i)}`),n&&c.push(`tier = ${w(n)}`);let u=`SELECT id, memory_key, category, content, source, ticket_key, tier, relevance, created_at
559
+ VALUES (${w(f)}, ${w(d||null)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(n)}, ${w(y)}, ${w(u)}, ${l}, ${w(te())})`);try{C(t,["add","."]),C(t,["commit","-m",`memory: ${r} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:f,category:r,tier:u,memoryKey:d||null,stored:e.slice(0,100)})}function sn(s){let t=String(s||"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}var Be=new Map;async function nn(s,t){if(typeof s=="boolean")return s;if(process.env.ZIBBY_MEM0_INFER!=null&&String(process.env.ZIBBY_MEM0_INFER).trim()!=="")return sn(process.env.ZIBBY_MEM0_INFER);let e=t||process.cwd();if(Be.has(e))return Be.get(e);let r=!1;try{let i=z(e,".zibby.config.mjs");ze(i)&&(r=(await import(de(i).href))?.default?.memory?.infer===!0)}catch{}return Be.set(e,r),r}async function on(s,t,e){let{content:r,category:i,source:n,ticketKey:o,tier:c,memoryKey:a,infer:u}=s;if(!r||!i)return JSON.stringify({error:"content and category are required"});try{let l=await ir(e),d=rr(e),p=We(c,i),m=await nn(u,e);return await l.add([{role:"user",content:String(r)}],{userId:d,infer:m,metadata:{memoryKey:a||null,category:i,tier:p,source:n||"zibby-chat",ticketKey:o||null,created_at:te()}}),JSON.stringify({ok:!0,backend:"mem0",userId:d,category:i,tier:p,infer:m,memoryKey:a||null,stored:String(r).slice(0,100)})}catch(l){throw new Error(`mem0 store failed: ${l.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:l})}}function an(s,t){let{query:e,category:r,ticketKey:i,tier:n,limit:o=20}=s,c=[];e&&c.push(`content LIKE ${w(`%${e}%`)}`),r&&c.push(`category = ${w(r)}`),i&&c.push(`ticket_key = ${w(i)}`),n&&c.push(`tier = ${w(n)}`);let u=`SELECT id, memory_key, category, content, source, ticket_key, tier, relevance, created_at
560
560
  FROM chat_memory ${c.length>0?`WHERE ${c.join(" AND ")}`:""}
561
561
  ORDER BY relevance DESC, created_at DESC
562
- LIMIT ${o}`,l=Z(t,u);return JSON.stringify({total:l.length,memories:l})}async function ar(s,t,e){let{query:r,category:i,ticketKey:n,tier:o,limit:c=20}=s;try{let a=await ir(e),u=rr(e),l=[];if(r&&String(r).trim()){let d=await a.search(String(r),{filters:{user_id:u},topK:c});l=Ht(d)}else{let d=await a.getAll({filters:{user_id:u},topK:Math.max(c,50)});l=Ht(d)}return i&&(l=l.filter(d=>d.category===i)),n&&(l=l.filter(d=>d.ticket_key===n)),o&&(l=l.filter(d=>d.tier===o)),l=l.slice(0,c),JSON.stringify({total:l.length,memories:l,backend:"mem0"})}catch(a){throw new Error(`mem0 recall failed: ${a.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:a})}}function zi(s,t){let{ticketKey:e}=s;Yi(t);let i=Z(t,`SELECT session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, created_at
562
+ LIMIT ${o}`,l=Z(t,u);return JSON.stringify({total:l.length,memories:l})}async function ar(s,t,e){let{query:r,category:i,ticketKey:n,tier:o,limit:c=20}=s;try{let a=await ir(e),u=rr(e),l=[];if(r&&String(r).trim()){let d=await a.search(String(r),{filters:{user_id:u},topK:c});l=Ht(d)}else{let d=await a.getAll({filters:{user_id:u},topK:Math.max(c,50)});l=Ht(d)}return i&&(l=l.filter(d=>d.category===i)),n&&(l=l.filter(d=>d.ticket_key===n)),o&&(l=l.filter(d=>d.tier===o)),l=l.slice(0,c),JSON.stringify({total:l.length,memories:l,backend:"mem0"})}catch(a){throw new Error(`mem0 recall failed: ${a.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:a})}}function cn(s,t){let{ticketKey:e}=s;dn(t);let i=Z(t,`SELECT session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, created_at
563
563
  FROM chat_sessions ORDER BY created_at DESC LIMIT 5`),n=e?`AND ticket_key = ${w(e)}`:"",o=Z(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
564
564
  WHERE tier = 'long' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 10`),c=Z(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
565
565
  WHERE tier = 'mid' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 8`),u=Z(t,`SELECT type, status, COUNT(*) as cnt FROM chat_tasks
566
- GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),l=tr([...o,...c]);return JSON.stringify({recentSessions:i,topMemories:l,taskStats:u,ticketFilter:e||null})}async function Wi(s,t,e){let{ticketKey:r}=s,i=await ar({limit:80},t,e),n=JSON.parse(i||"{}"),o=Array.isArray(n.memories)?n.memories:[];r&&(o=o.filter(p=>p.ticket_key===r));let c=p=>{let m=Date.parse(String(p?.created_at||""))||0;return Number(p?.relevance||0)*1e12+m},a=(p,m)=>c(m)-c(p),u=o.filter(p=>p.tier==="long").sort(a).slice(0,10),l=o.filter(p=>p.tier==="mid").sort(a).slice(0,8),d=tr([...u,...l]);return JSON.stringify({recentSessions:[],topMemories:d,taskStats:[],ticketFilter:r||null,backend:"mem0"})}function cr(s,t){let{summary:e,tickets:r,tasksRun:i=0,tasksPassed:n=0,tasksFailed:o=0,keyFacts:c}=s;if(!e)return JSON.stringify({error:"summary is required"});let a=process.env.ZIBBY_CHAT_SESSION_ID||`session_${je()}`;if(P(t,`INSERT INTO chat_sessions (session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, key_facts, created_at)
567
- VALUES (${w(a)}, ${w(e)}, ${w(r)}, ${i}, ${n}, ${o}, ${w(c)}, ${w(te())})`),c)for(let u of c.split(";").map(l=>l.trim()).filter(Boolean))or({content:u,category:"fact",source:"session_summary",tier:"mid"},t);Hi(t);try{C(t,["add","."]),C(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:a,summary:e.slice(0,200)})}function lr(s,t){let{title:e,type:r,status:i,ticketKey:n,specPath:o,resultSummary:c}=s;if(!e||!r||!i)return JSON.stringify({error:"title, type, and status are required"});let a=je(),u=process.env.ZIBBY_CHAT_SESSION_ID||null;P(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
566
+ GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),l=tr([...o,...c]);return JSON.stringify({recentSessions:i,topMemories:l,taskStats:u,ticketFilter:e||null})}async function ln(s,t,e){let{ticketKey:r}=s,i=await ar({limit:80},t,e),n=JSON.parse(i||"{}"),o=Array.isArray(n.memories)?n.memories:[];r&&(o=o.filter(p=>p.ticket_key===r));let c=p=>{let m=Date.parse(String(p?.created_at||""))||0;return Number(p?.relevance||0)*1e12+m},a=(p,m)=>c(m)-c(p),u=o.filter(p=>p.tier==="long").sort(a).slice(0,10),l=o.filter(p=>p.tier==="mid").sort(a).slice(0,8),d=tr([...u,...l]);return JSON.stringify({recentSessions:[],topMemories:d,taskStats:[],ticketFilter:r||null,backend:"mem0"})}function cr(s,t){let{summary:e,tickets:r,tasksRun:i=0,tasksPassed:n=0,tasksFailed:o=0,keyFacts:c}=s;if(!e)return JSON.stringify({error:"summary is required"});let a=process.env.ZIBBY_CHAT_SESSION_ID||`session_${je()}`;if(P(t,`INSERT INTO chat_sessions (session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, key_facts, created_at)
567
+ VALUES (${w(a)}, ${w(e)}, ${w(r)}, ${i}, ${n}, ${o}, ${w(c)}, ${w(te())})`),c)for(let u of c.split(";").map(l=>l.trim()).filter(Boolean))or({content:u,category:"fact",source:"session_summary",tier:"mid"},t);un(t);try{C(t,["add","."]),C(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:a,summary:e.slice(0,200)})}function lr(s,t){let{title:e,type:r,status:i,ticketKey:n,specPath:o,resultSummary:c}=s;if(!e||!r||!i)return JSON.stringify({error:"title, type, and status are required"});let a=je(),u=process.env.ZIBBY_CHAT_SESSION_ID||null;P(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
568
568
  VALUES (${w(a)}, ${w(n)}, ${w(r)}, ${w(e)}, ${w(i)}, ${w(o)}, ${w(u)}, ${w(c)}, ${w(te())}, ${w(te())})`);try{C(t,["add","."]),C(t,["commit","-m",`task: ${i} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:a,title:e,type:r,status:i})}function ur(s,t){let{ticketKey:e,type:r,status:i,limit:n=20}=s,o=[];e&&o.push(`ticket_key = ${w(e)}`),r&&o.push(`type = ${w(r)}`),i&&o.push(`status = ${w(i)}`);let a=`SELECT id, ticket_key, type, title, status, spec_path, result_summary, created_at, finished_at
569
569
  FROM chat_tasks ${o.length>0?`WHERE ${o.join(" AND ")}`:""}
570
- ORDER BY created_at DESC LIMIT ${n}`,u=Z(t,a);return JSON.stringify({total:u.length,tasks:u})}function Hi(s){try{P(s,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),P(s,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),P(s,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),P(s,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function Yi(s){try{let t=new Date(Date.now()-864e5).toISOString();P(s,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${w(t)}`)}catch{}}import{existsSync as W,readFileSync as me,readdirSync as He,mkdirSync as Zi,writeFileSync as ne,statSync as mr}from"fs";import{join as N,resolve as Ye,relative as fr,dirname as yr}from"path";import{fileURLToPath as Vi}from"url";import{createRequire as Qi}from"module";var Xi=Qi(import.meta.url),en=`## Workflow Builder
570
+ ORDER BY created_at DESC LIMIT ${n}`,u=Z(t,a);return JSON.stringify({total:u.length,tasks:u})}function un(s){try{P(s,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),P(s,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),P(s,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),P(s,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function dn(s){try{let t=new Date(Date.now()-864e5).toISOString();P(s,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${w(t)}`)}catch{}}import{existsSync as W,readFileSync as me,readdirSync as He,mkdirSync as pn,writeFileSync as ne,statSync as mr}from"fs";import{join as N,resolve as Ye,relative as fr,dirname as yr}from"path";import{fileURLToPath as mn}from"url";import{createRequire as fn}from"module";var yn=fn(import.meta.url),hn=`## Workflow Builder
571
571
 
572
572
  You can help users build custom AI workflows using the Zibby workflow framework.
573
573
 
@@ -677,9 +677,9 @@ Call with no arguments to see all available topics.
677
677
  - Workflow names must be kebab-case (e.g., ticket-triage, pr-review).
678
678
  - State flows through: each node's validated output is stored under its name in state (e.g., state.classify_ticket).
679
679
  - Downstream nodes reference upstream outputs in their prompt function (e.g., \\\`\\\${JSON.stringify(state.classify_ticket, null, 2)}\\\`).
680
- - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,hr=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function gr(s){return`${s.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function pe(s){return`${s.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function tn(s){let t=s?.agent;return t?t.provider?t.provider:t.gemini?"gemini":t.codex?"codex":t.claude?"claude":t.cursor?"cursor":process.env.AGENT_TYPE||"cursor":process.env.AGENT_TYPE||"cursor"}async function rn(s){let t=Ye(s,".zibby.config.mjs");if(!W(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function sn(){try{let s=yr(Xi.resolve("@zibby/core/package.json")),t=N(s,"templates","browser-test-automation"),e=me(N(t,"nodes","preflight.mjs"),"utf-8"),r=me(N(t,"graph.mjs"),"utf-8");return{preflight:e,graph:r}}catch{return null}}var dr=yr(Vi(import.meta.url));function _r(){let s=Ye(dr,"..","..","..","docsite","docs");if(W(s))return s;let t=Ye(dr,"..","docs");return W(t)?t:null}function pr(){let s=_r();if(!s)return[];try{let t=(e,r="")=>{let i=[];for(let n of He(e)){let o=N(e,n);try{if(mr(o).isDirectory())i=i.concat(t(o,`${r}${n}/`));else if(n.endsWith(".md")){let c=`${r}${n.replace(/\.md$/,"")}`;i.push(c)}}catch{}}return i};return t(s)}catch{return[]}}function br(s){let t=_r();if(!t)return null;let e=N(t,`${s}.md`);if(!W(e))return null;try{return me(e,"utf-8")}catch{return null}}function nn(s){let t=s.nodes.map(o=>{let c=o.inputFields?.length?`Input fields: ${o.inputFields.join(", ")}`:"Input: receives full state",a=o.outputFields?.length?`Output fields: ${o.outputFields.join(", ")}`:"Output: determined by task",u=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${c}. ${a}.${u?` ${u}`:""}`}).join(`
680
+ - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,hr=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function gr(s){return`${s.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function pe(s){return`${s.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function gn(s){let t=s?.agent;return t?t.provider?t.provider:t.gemini?"gemini":t.codex?"codex":t.claude?"claude":t.cursor?"cursor":process.env.AGENT_TYPE||"cursor":process.env.AGENT_TYPE||"cursor"}async function _n(s){let t=Ye(s,".zibby.config.mjs");if(!W(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function bn(){try{let s=yr(yn.resolve("@zibby/core/package.json")),t=N(s,"templates","browser-test-automation"),e=me(N(t,"nodes","preflight.mjs"),"utf-8"),r=me(N(t,"graph.mjs"),"utf-8");return{preflight:e,graph:r}}catch{return null}}var dr=yr(mn(import.meta.url));function _r(){let s=Ye(dr,"..","..","..","docsite","docs");if(W(s))return s;let t=Ye(dr,"..","docs");return W(t)?t:null}function pr(){let s=_r();if(!s)return[];try{let t=(e,r="")=>{let i=[];for(let n of He(e)){let o=N(e,n);try{if(mr(o).isDirectory())i=i.concat(t(o,`${r}${n}/`));else if(n.endsWith(".md")){let c=`${r}${n.replace(/\.md$/,"")}`;i.push(c)}}catch{}}return i};return t(s)}catch{return[]}}function br(s){let t=_r();if(!t)return null;let e=N(t,`${s}.md`);if(!W(e))return null;try{return me(e,"utf-8")}catch{return null}}function kn(s){let t=s.nodes.map(o=>{let c=o.inputFields?.length?`Input fields: ${o.inputFields.join(", ")}`:"Input: receives full state",a=o.outputFields?.length?`Output fields: ${o.outputFields.join(", ")}`:"Output: determined by task",u=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${c}. ${a}.${u?` ${u}`:""}`}).join(`
681
681
  `),e=s.edges.map(o=>o.condition?`- ${o.from} \u2192 ${o.to} (conditional: ${o.condition})`:`- ${o.from} \u2192 ${o.to}`).join(`
682
- `),r=sn(),i=br("custom-workflows"),n="";return r&&(n+=`
682
+ `),r=bn(),i=br("custom-workflows"),n="";return r&&(n+=`
683
683
  ## Real working examples from the Zibby framework
684
684
 
685
685
  ### Example node (preflight.mjs) \u2014 a prompt-only node with Zod schema and onComplete hook:
@@ -756,7 +756,7 @@ Return a JSON object with this exact structure:
756
756
  }
757
757
  }
758
758
 
759
- IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function kr(s,t){let e=await rn(t),r=tn(e);try{let{invokeAgent:i}=await import("@zibby/core"),n=nn(s),o=await i(n,{state:{agentType:r,config:e,cwd:t,workspace:t}},{model:e?.agent?.[r]?.model||"auto",workspace:t,config:e,timeout:12e4}),a=(typeof o=="string"?o:o?.raw||JSON.stringify(o?.structured||o)).match(/\{[\s\S]*\}/);if(!a)throw new Error("Agent did not return valid JSON");return JSON.parse(a[0])}catch(i){return console.warn(`Agent code generation failed (${i.message}), using templates`),on(s)}}function on(s){let t={};for(let e of s.nodes){let r=pe(e.name),i=`${e.name.split("_").map(a=>a.charAt(0).toUpperCase()+a.slice(1)).join("")}OutputSchema`,n=e.outputFields?.length?e.outputFields.map(a=>` ${a}: z.string().describe('${a}'),`).join(`
759
+ IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function kr(s,t){let e=await _n(t),r=gn(e);try{let{invokeAgent:i}=await import("@zibby/core"),n=kn(s),o=await i(n,{state:{agentType:r,config:e,cwd:t,workspace:t}},{model:e?.agent?.[r]?.model||"auto",workspace:t,config:e,timeout:12e4}),a=(typeof o=="string"?o:o?.raw||JSON.stringify(o?.structured||o)).match(/\{[\s\S]*\}/);if(!a)throw new Error("Agent did not return valid JSON");return JSON.parse(a[0])}catch(i){return console.warn(`Agent code generation failed (${i.message}), using templates`),wn(s)}}function wn(s){let t={};for(let e of s.nodes){let r=pe(e.name),i=`${e.name.split("_").map(a=>a.charAt(0).toUpperCase()+a.slice(1)).join("")}OutputSchema`,n=e.outputFields?.length?e.outputFields.map(a=>` ${a}: z.string().describe('${a}'),`).join(`
760
760
  `):` summary: z.string().describe('Summary of the result'),
761
761
  status: z.enum(['ok', 'warn', 'error']).describe('Overall status'),`,o=s.edges.filter(a=>a.to===e.name&&a.from!=="START").map(a=>`Previous step (${a.from}): \${JSON.stringify(state.${a.from} || {}, null, 2)}`).join(`
762
762
  `),c=o?`${e.description}
@@ -778,7 +778,7 @@ export const ${r} = {
778
778
  prompt: (state) => \`${c}\`,
779
779
  outputSchema: ${i},
780
780
  };
781
- `}}return{nodes:t}}function an(s,t,e,r){let i=t.toLowerCase(),n=gr(i),o=N(s,".zibby","workflows",i),c=N(o,"nodes");Zi(c,{recursive:!0});let a=e.nodes.map(g=>g.name);for(let g of e.nodes){let b=r.nodes?.[g.name]?.code;b&&ne(N(c,`${g.name.replace(/_/g,"-")}.mjs`),b,"utf-8")}let u=a.map(g=>{let b=pe(g),h=g.replace(/_/g,"-");return`export { ${b} } from './${h}.mjs';`});ne(N(c,"index.mjs"),`${u.join(`
781
+ `}}return{nodes:t}}function Sn(s,t,e,r){let i=t.toLowerCase(),n=gr(i),o=N(s,".zibby","workflows",i),c=N(o,"nodes");pn(c,{recursive:!0});let a=e.nodes.map(g=>g.name);for(let g of e.nodes){let b=r.nodes?.[g.name]?.code;b&&ne(N(c,`${g.name.replace(/_/g,"-")}.mjs`),b,"utf-8")}let u=a.map(g=>{let b=pe(g),h=g.replace(/_/g,"-");return`export { ${b} } from './${h}.mjs';`});ne(N(c,"index.mjs"),`${u.join(`
782
782
  `)}
783
783
  `,"utf-8");let l=a[0],d=a.map(g=>pe(g)).join(", "),p=a.map(g=>` graph.addNode('${g}', ${pe(g)});`).join(`
784
784
  `),m=e.edges.map(g=>g.condition?` graph.addConditionalEdges('${g.from}', (state) => {
@@ -804,15 +804,15 @@ ${m}
804
804
  }
805
805
  }
806
806
  `;ne(N(o,"graph.mjs"),f,"utf-8");let y={name:i,description:e.description||`${n} workflow`,entryClass:n,triggers:{api:!0}};ne(N(o,"workflow.json"),`${JSON.stringify(y,null,2)}
807
- `,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...a.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:fr(s,o),files:_,className:n,slug:i}}async function cn(s){let{name:t,description:e,nodes:r,edges:i}=s;if(!t||!hr.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!r||r.length===0)return JSON.stringify({error:"At least one node is required."});let n={name:t.toLowerCase(),description:e||`${gr(t.toLowerCase())} workflow`,nodes:r.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(n.edges.length===0&&n.nodes.length>0){for(let o=0;o<n.nodes.length-1;o++)n.edges.push({from:n.nodes[o].name,to:n.nodes[o+1].name});n.edges.push({from:n.nodes[n.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:n,message:`Workflow "${n.name}" designed with ${n.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:n.nodes.map(o=>o.name),flow:n.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function ln(s,t){let{name:e,spec:r}=s,i=(e||r?.name||"").toLowerCase();if(!i||!hr.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!r||!r.nodes||r.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let n=N(t,".zibby","workflows",i);if(W(n))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await kr(r,t),c=an(t,i,r,o);return JSON.stringify({ok:!0,...c,message:`Workflow "${i}" created at ${c.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 un(s,t){let{workflowName:e,nodeName:r,description:i,inputFields:n,outputFields:o}=s,c=(e||"").toLowerCase(),a=(r||"").replace(/-/g,"_"),u=N(t,".zibby","workflows",c);if(!W(u))return JSON.stringify({error:`Workflow "${c}" not found. Create it first with build_workflow.`});let l={name:c,description:"",nodes:[{name:a,description:i||`Process ${a}`,inputFields:n||[],outputFields:o||[]}],edges:[]},p=(await kr(l,t)).nodes?.[a]?.code;if(!p)return JSON.stringify({error:"Failed to generate node code."});let m=N(u,"nodes"),f=`${a.replace(/_/g,"-")}.mjs`;ne(N(m,f),p,"utf-8");let y=N(m,"index.mjs"),_=pe(a),g=`export { ${_} } from './${a.replace(/_/g,"-")}.mjs';
808
- `,b=W(y)?me(y,"utf-8"):"";return b.includes(_)||ne(y,b+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${a}" added. Update graph.mjs to wire it into the graph.`})}async function dn(s,t){let{name:e,projectId:r}=s,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!r)return JSON.stringify({error:"projectId is required."});let n=N(t,".zibby","workflows",i);if(!W(n))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),c=o(`node "${N(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch{try{let{execSync:c}=await import("child_process"),a=c(`npx zibby deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch(c){return JSON.stringify({error:`Deploy failed: ${c.message}`})}}}function pn(s){let t=N(s,".zibby","workflows");if(!W(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let r=He(t).filter(i=>{try{return mr(N(t,i)).isDirectory()}catch{return!1}}).map(i=>{let n=N(t,i,"workflow.json"),o={};try{o=JSON.parse(me(n,"utf-8"))}catch{}let c=N(t,i,"nodes"),a=0;try{a=He(c).filter(u=>u.endsWith(".mjs")&&u!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:a,path:fr(s,N(t,i))}});return JSON.stringify({workflows:r})}var wr={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:en,tools:[{name:"design_workflow",description:"Design a workflow spec (nodes, edges, descriptions) for the user to review before building. Call this after understanding requirements.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name in kebab-case (e.g., ticket-triage)"},description:{type:"string",description:"What the workflow does"},nodes:{type:"array",items:{type:"object",properties:{name:{type:"string",description:"Node name in snake_case (e.g., classify_ticket)"},description:{type:"string",description:"What this node does \u2014 be specific about input/output"},inputFields:{type:"array",items:{type:"string"},description:"Key fields this node reads from state"},outputFields:{type:"array",items:{type:"string"},description:"Key fields this node produces"}},required:["name","description"]},description:"Workflow nodes (processing steps)"},edges:{type:"array",items:{type:"object",properties:{from:{type:"string",description:"Source node name"},to:{type:"string",description:'Target node name (or "END")'},condition:{type:"string",description:"JS expression for conditional routing (optional)"}},required:["from","to"]},description:"Edges connecting nodes. If omitted, nodes are wired linearly."}},required:["name","description","nodes"]}},{name:"build_workflow",description:"Generate real workflow code on disk from a design spec. Uses the configured AI agent for high-quality code generation.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name (from design_workflow)"},spec:{type:"object",description:"The full spec object returned by design_workflow",properties:{name:{type:"string"},description:{type:"string"},nodes:{type:"array",items:{type:"object"}},edges:{type:"array",items:{type:"object"}}}}},required:["name","spec"]}},{name:"add_node",description:"Add a new node to an existing workflow. Generates the node file and updates the barrel export.",input_schema:{type:"object",properties:{workflowName:{type:"string",description:"Existing workflow name (kebab-case)"},nodeName:{type:"string",description:"New node name (snake_case)"},description:{type:"string",description:"What this node does"},inputFields:{type:"array",items:{type:"string"},description:"Fields read from state"},outputFields:{type:"array",items:{type:"string"},description:"Fields produced"}},required:["workflowName","nodeName","description"]}},{name:"deploy_workflow",description:"Deploy a workflow to Zibby Cloud. Returns the trigger URL.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name to deploy"},projectId:{type:"string",description:"Target project ID"}},required:["name","projectId"]}},{name:"list_workflows",description:"List all local workflows in .zibby/workflows/.",input_schema:{type:"object",properties:{}}},{name:"explore_framework_docs",description:"Read Zibby framework documentation on demand. Call this before building complex workflows or when you need details on advanced patterns (middleware, conditional routing, skills, deployment, CLI commands).",input_schema:{type:"object",properties:{topic:{type:"string",description:'Doc topic to read (e.g., "workflow", "custom-workflows", "cli-reference", "packages/core", "packages/skills", "integrations/jira"). Call with no topic to list all available docs.'}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"design_workflow":return await cn(t);case"build_workflow":return await ln(t,r);case"add_node":return await un(t,r);case"deploy_workflow":return await dn(t,r);case"list_workflows":return pn(r);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=pr();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let n=br(i);if(!n){let o=pr();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:n})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as mn}from"@zibby/core/backend-client.js";var Ve=Object.freeze({id:"openai_billing",requiresIntegration:O.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),Qe=Object.freeze({id:"anthropic_billing",requiresIntegration:O.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),Xe=Object.freeze({id:"cursor_admin",requiresIntegration:O.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Sr(s){return Math.floor(s/1e3)}function Ze(s){return new Date(s).toISOString().slice(0,10)}function vr(s){return new Date(s).toISOString()}async function fe(s){let t=await mn(s);if(!t?.token)throw new Error(`${s} token resolver returned no token`);return t.token}async function Nr({startMs:s,endMs:t,groupBy:e=["project_id","line_item"]}){let r=await fe("openai_billing"),i=[],n=0,o=e.map(a=>`group_by[]=${encodeURIComponent(a)}`).join("&"),c=null;for(let a=0;a<50;a++){let l=`https://api.openai.com/v1/organization/costs?${[`start_time=${Sr(s)}`,`end_time=${Sr(t)}`,"bucket_width=1d","limit=180",o,c?`page=${encodeURIComponent(c)}`:""].filter(Boolean).join("&")}`,d=await fetch(l,{headers:{Authorization:`Bearer ${r}`}});if(!d.ok){let m=await d.text().catch(()=>"");throw new Error(`OpenAI costs API ${d.status}: ${m.slice(0,200)}`)}let p=await d.json();for(let m of p.data||[]){n+=1;let f=Ze((m.start_time||0)*1e3);for(let y of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(y.amount?.value??0),projectId:y.project_id||void 0,apiKeyId:y.api_key_id||void 0,model:y.line_item||void 0})}if(!p.has_more||!p.next_page)break;c=p.next_page}return{ok:!0,items:i,rawBuckets:n}}async function fn(){let s=await fe("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${s}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function Ir({startMs:s,endMs:t,groupBy:e=["workspace_id"]}){let r=await fe("anthropic_billing"),i=[],n=0,o=e.map(a=>`group_by[]=${encodeURIComponent(a)}`).join("&"),c=null;for(let a=0;a<50;a++){let l=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(vr(s))}`,`ending_at=${encodeURIComponent(vr(t))}`,"bucket=1d","limit=100",o,c?`page=${encodeURIComponent(c)}`:""].filter(Boolean).join("&")}`,d=await fetch(l,{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!d.ok){let m=await d.text().catch(()=>"");throw new Error(`Anthropic cost_report ${d.status}: ${m.slice(0,200)}`)}let p=await d.json();for(let m of p.data||[]){n+=1;let f=(m.starting_at||"").slice(0,10);for(let y of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(y.amount??y.cost??0),workspaceId:y.workspace_id||void 0,apiKeyId:y.api_key_id||void 0,model:y.model||void 0,tokensIn:y.uncached_input_tokens!=null?Number(y.uncached_input_tokens):void 0,tokensOut:y.output_tokens!=null?Number(y.output_tokens):void 0,cachedTokens:y.cached_input_tokens!=null?Number(y.cached_input_tokens):void 0})}if(!p.has_more||!p.next_page)break;c=p.next_page}return{ok:!0,items:i,rawBuckets:n}}async function yn(){let s=await fe("anthropic_billing"),e=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":s,"anthropic-version":"2023-06-01"}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function Or({startMs:s,endMs:t}){let e=await fe("cursor_admin"),r=Ze(s),i=Ze(t),n=`https://api.cursor.com/teams/daily-usage-data?startDate=${r}&endDate=${i}`,o=await fetch(n,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${l.slice(0,200)}`)}let c=await o.json(),a=[],u=0;for(let l of c.data||[]){u+=1;let d=l.date;for(let p of l.userMetrics||[]){for(let m of p.modelUsage||[]){let f=Number(m.acceptedLines??0),y=Number(m.suggestedLines??0);a.push({provider:"cursor",day:d,costUsd:Number(m.totalCents??0)/100,userEmail:p.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:y>0?f/y:void 0})}(!p.modelUsage||p.modelUsage.length===0)&&a.push({provider:"cursor",day:d,costUsd:Number(p.totalCents??0)/100,userEmail:p.email})}}return{ok:!0,items:a,rawBuckets:u}}async function hn({startMs:s,endMs:t}){let[e,r,i]=await Promise.allSettled([Nr({startMs:s,endMs:t}),Ir({startMs:s,endMs:t}),Or({startMs:s,endMs:t})]),n=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=n(e),c=n(r),a=n(i),u=[{provider:"openai",totalUsd:o.items.reduce((l,d)=>l+(d.costUsd||0),0)},{provider:"anthropic",totalUsd:c.items.reduce((l,d)=>l+(d.costUsd||0),0)},{provider:"cursor",totalUsd:a.items.reduce((l,d)=>l+(d.costUsd||0),0)}];return{openai:o,anthropic:c,cursor:a,totals:u}}function gn(s,t){let e=new Map;for(let r of s){let i=t(r);if(!i)continue;let n=e.get(i)||{key:i,totalUsd:0,count:0};n.totalUsd+=r.costUsd||0,n.count+=1,e.set(i,n)}return[...e.values()].sort((r,i)=>i.totalUsd-r.totalUsd)}function _n(s){if(!s.length)return{mean:0,stddev:0};let t=s.reduce((r,i)=>r+i,0)/s.length,e=s.reduce((r,i)=>r+(i-t)**2,0)/s.length;return{mean:t,stddev:Math.sqrt(e)}}import{z as k}from"zod";var ye=["ok","info","warn","critical"],bn=k.object({primary:k.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:k.object({value:k.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:k.enum(["up","down","flat"]).optional(),severity:k.enum(ye).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:k.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),kn=k.object({kind:k.literal("trend"),title:k.string().max(120).optional(),labels:k.array(k.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:k.array(k.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:k.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:k.enum(ye).optional()}),wn=k.object({kind:k.literal("table"),title:k.string().max(120).optional(),headers:k.array(k.string().max(40)).min(1).max(8),rows:k.array(k.array(k.union([k.string().max(200),k.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),Sn=k.object({kind:k.literal("callouts"),title:k.string().max(120).optional(),tone:k.enum(ye).default("info").optional(),items:k.array(k.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),vn=k.object({kind:k.literal("breakdown"),title:k.string().max(120).optional(),rows:k.array(k.object({label:k.string().min(1).max(80),value:k.string().min(1).max(80),sub:k.string().max(120).optional(),severity:k.enum(ye).optional()})).min(1).max(20)}),Nn=k.object({kind:k.literal("paragraph"),title:k.string().max(120).optional(),text:k.string().min(1).max(3e3)}),In=k.discriminatedUnion("kind",[kn,wn,Sn,vn,Nn]),et=k.object({title:k.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:k.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:bn,sections:k.array(In).max(20).default([]).superRefine((s,t)=>{s.forEach((e,r)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"rows"],message:"every row must have headers.length entries"})})}),footer:k.object({viewUrl:k.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:k.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),V=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),Ar=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),On=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function Rr(s,t,e=12){if(!Number.isFinite(s)||!Number.isFinite(t)||t<=0)return"";let r=Math.max(0,Math.min(1,s/t)),i=Math.round(r*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function tt(s,t){let e=String(s);return e.length>=t?e:e+" ".repeat(t-e.length)}function $r(s,t){let e=String(s);return e.length>=t?e:" ".repeat(t-e.length)+e}function jr({headers:s,rows:t}){let e=s.map((o,c)=>{let a=Math.max(String(o).length,...t.map(u=>String(u[c]??"").length));return Math.min(a,32)}),r=o=>o.map((c,a)=>tt(c,e[a])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[r(s),i,...t.map(o=>r(o))].join(`
809
- `)+"\n```"}function An(s){let t=et.parse(s),e=[];e.push({type:"header",text:{type:"plain_text",text:t.title.slice(0,150),emoji:!0}}),t.subtitle&&e.push({type:"context",elements:[{type:"mrkdwn",text:t.subtitle}]});let r=[`*${t.headline.primary}*`];if(t.headline.delta){let n=Ar[t.headline.delta.direction]||"",o=t.headline.delta.severity?V[t.headline.delta.severity]:"";r.push(`${n} ${t.headline.delta.value} ${o}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
807
+ `,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...a.map(g=>`nodes/${g.replace(/_/g,"-")}.mjs`)];return{workflowDir:fr(s,o),files:_,className:n,slug:i}}async function vn(s){let{name:t,description:e,nodes:r,edges:i}=s;if(!t||!hr.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!r||r.length===0)return JSON.stringify({error:"At least one node is required."});let n={name:t.toLowerCase(),description:e||`${gr(t.toLowerCase())} workflow`,nodes:r.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(n.edges.length===0&&n.nodes.length>0){for(let o=0;o<n.nodes.length-1;o++)n.edges.push({from:n.nodes[o].name,to:n.nodes[o+1].name});n.edges.push({from:n.nodes[n.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:n,message:`Workflow "${n.name}" designed with ${n.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:n.nodes.map(o=>o.name),flow:n.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Nn(s,t){let{name:e,spec:r}=s,i=(e||r?.name||"").toLowerCase();if(!i||!hr.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!r||!r.nodes||r.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let n=N(t,".zibby","workflows",i);if(W(n))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await kr(r,t),c=Sn(t,i,r,o);return JSON.stringify({ok:!0,...c,message:`Workflow "${i}" created at ${c.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 In(s,t){let{workflowName:e,nodeName:r,description:i,inputFields:n,outputFields:o}=s,c=(e||"").toLowerCase(),a=(r||"").replace(/-/g,"_"),u=N(t,".zibby","workflows",c);if(!W(u))return JSON.stringify({error:`Workflow "${c}" not found. Create it first with build_workflow.`});let l={name:c,description:"",nodes:[{name:a,description:i||`Process ${a}`,inputFields:n||[],outputFields:o||[]}],edges:[]},p=(await kr(l,t)).nodes?.[a]?.code;if(!p)return JSON.stringify({error:"Failed to generate node code."});let m=N(u,"nodes"),f=`${a.replace(/_/g,"-")}.mjs`;ne(N(m,f),p,"utf-8");let y=N(m,"index.mjs"),_=pe(a),g=`export { ${_} } from './${a.replace(/_/g,"-")}.mjs';
808
+ `,b=W(y)?me(y,"utf-8"):"";return b.includes(_)||ne(y,b+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${a}" added. Update graph.mjs to wire it into the graph.`})}async function On(s,t){let{name:e,projectId:r}=s,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!r)return JSON.stringify({error:"projectId is required."});let n=N(t,".zibby","workflows",i);if(!W(n))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),c=o(`node "${N(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch{try{let{execSync:c}=await import("child_process"),a=c(`npx zibby deploy ${i} --project ${r}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch(c){return JSON.stringify({error:`Deploy failed: ${c.message}`})}}}function An(s){let t=N(s,".zibby","workflows");if(!W(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let r=He(t).filter(i=>{try{return mr(N(t,i)).isDirectory()}catch{return!1}}).map(i=>{let n=N(t,i,"workflow.json"),o={};try{o=JSON.parse(me(n,"utf-8"))}catch{}let c=N(t,i,"nodes"),a=0;try{a=He(c).filter(u=>u.endsWith(".mjs")&&u!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:a,path:fr(s,N(t,i))}});return JSON.stringify({workflows:r})}var wr={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:hn,tools:[{name:"design_workflow",description:"Design a workflow spec (nodes, edges, descriptions) for the user to review before building. Call this after understanding requirements.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name in kebab-case (e.g., ticket-triage)"},description:{type:"string",description:"What the workflow does"},nodes:{type:"array",items:{type:"object",properties:{name:{type:"string",description:"Node name in snake_case (e.g., classify_ticket)"},description:{type:"string",description:"What this node does \u2014 be specific about input/output"},inputFields:{type:"array",items:{type:"string"},description:"Key fields this node reads from state"},outputFields:{type:"array",items:{type:"string"},description:"Key fields this node produces"}},required:["name","description"]},description:"Workflow nodes (processing steps)"},edges:{type:"array",items:{type:"object",properties:{from:{type:"string",description:"Source node name"},to:{type:"string",description:'Target node name (or "END")'},condition:{type:"string",description:"JS expression for conditional routing (optional)"}},required:["from","to"]},description:"Edges connecting nodes. If omitted, nodes are wired linearly."}},required:["name","description","nodes"]}},{name:"build_workflow",description:"Generate real workflow code on disk from a design spec. Uses the configured AI agent for high-quality code generation.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name (from design_workflow)"},spec:{type:"object",description:"The full spec object returned by design_workflow",properties:{name:{type:"string"},description:{type:"string"},nodes:{type:"array",items:{type:"object"}},edges:{type:"array",items:{type:"object"}}}}},required:["name","spec"]}},{name:"add_node",description:"Add a new node to an existing workflow. Generates the node file and updates the barrel export.",input_schema:{type:"object",properties:{workflowName:{type:"string",description:"Existing workflow name (kebab-case)"},nodeName:{type:"string",description:"New node name (snake_case)"},description:{type:"string",description:"What this node does"},inputFields:{type:"array",items:{type:"string"},description:"Fields read from state"},outputFields:{type:"array",items:{type:"string"},description:"Fields produced"}},required:["workflowName","nodeName","description"]}},{name:"deploy_workflow",description:"Deploy a workflow to Zibby Cloud. Returns the trigger URL.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name to deploy"},projectId:{type:"string",description:"Target project ID"}},required:["name","projectId"]}},{name:"list_workflows",description:"List all local workflows in .zibby/workflows/.",input_schema:{type:"object",properties:{}}},{name:"explore_framework_docs",description:"Read Zibby framework documentation on demand. Call this before building complex workflows or when you need details on advanced patterns (middleware, conditional routing, skills, deployment, CLI commands).",input_schema:{type:"object",properties:{topic:{type:"string",description:'Doc topic to read (e.g., "workflow", "custom-workflows", "cli-reference", "packages/core", "packages/skills", "integrations/jira"). Call with no topic to list all available docs.'}}}}],async handleToolCall(s,t,e){let r=e?.options?.workspace||process.cwd();try{switch(s){case"design_workflow":return await vn(t);case"build_workflow":return await Nn(t,r);case"add_node":return await In(t,r);case"deploy_workflow":return await On(t,r);case"list_workflows":return An(r);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=pr();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let n=br(i);if(!n){let o=pr();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:n})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Rn}from"@zibby/core/backend-client.js";var Ve=Object.freeze({id:"openai_billing",requiresIntegration:O.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),Qe=Object.freeze({id:"anthropic_billing",requiresIntegration:O.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),Xe=Object.freeze({id:"cursor_admin",requiresIntegration:O.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Sr(s){return Math.floor(s/1e3)}function Ze(s){return new Date(s).toISOString().slice(0,10)}function vr(s){return new Date(s).toISOString()}async function fe(s){let t=await Rn(s);if(!t?.token)throw new Error(`${s} token resolver returned no token`);return t.token}async function Nr({startMs:s,endMs:t,groupBy:e=["project_id","line_item"]}){let r=await fe("openai_billing"),i=[],n=0,o=e.map(a=>`group_by[]=${encodeURIComponent(a)}`).join("&"),c=null;for(let a=0;a<50;a++){let l=`https://api.openai.com/v1/organization/costs?${[`start_time=${Sr(s)}`,`end_time=${Sr(t)}`,"bucket_width=1d","limit=180",o,c?`page=${encodeURIComponent(c)}`:""].filter(Boolean).join("&")}`,d=await fetch(l,{headers:{Authorization:`Bearer ${r}`}});if(!d.ok){let m=await d.text().catch(()=>"");throw new Error(`OpenAI costs API ${d.status}: ${m.slice(0,200)}`)}let p=await d.json();for(let m of p.data||[]){n+=1;let f=Ze((m.start_time||0)*1e3);for(let y of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(y.amount?.value??0),projectId:y.project_id||void 0,apiKeyId:y.api_key_id||void 0,model:y.line_item||void 0})}if(!p.has_more||!p.next_page)break;c=p.next_page}return{ok:!0,items:i,rawBuckets:n}}async function $n(){let s=await fe("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${s}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function Ir({startMs:s,endMs:t,groupBy:e=["workspace_id"]}){let r=await fe("anthropic_billing"),i=[],n=0,o=e.map(a=>`group_by[]=${encodeURIComponent(a)}`).join("&"),c=null;for(let a=0;a<50;a++){let l=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(vr(s))}`,`ending_at=${encodeURIComponent(vr(t))}`,"bucket=1d","limit=100",o,c?`page=${encodeURIComponent(c)}`:""].filter(Boolean).join("&")}`,d=await fetch(l,{headers:{"x-api-key":r,"anthropic-version":"2023-06-01"}});if(!d.ok){let m=await d.text().catch(()=>"");throw new Error(`Anthropic cost_report ${d.status}: ${m.slice(0,200)}`)}let p=await d.json();for(let m of p.data||[]){n+=1;let f=(m.starting_at||"").slice(0,10);for(let y of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(y.amount??y.cost??0),workspaceId:y.workspace_id||void 0,apiKeyId:y.api_key_id||void 0,model:y.model||void 0,tokensIn:y.uncached_input_tokens!=null?Number(y.uncached_input_tokens):void 0,tokensOut:y.output_tokens!=null?Number(y.output_tokens):void 0,cachedTokens:y.cached_input_tokens!=null?Number(y.cached_input_tokens):void 0})}if(!p.has_more||!p.next_page)break;c=p.next_page}return{ok:!0,items:i,rawBuckets:n}}async function jn(){let s=await fe("anthropic_billing"),e=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":s,"anthropic-version":"2023-06-01"}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${n.slice(0,200)}`)}let r=await e.json(),i=new Map;for(let n of r.data||[])i.set(n.id,n.name);return i}async function Or({startMs:s,endMs:t}){let e=await fe("cursor_admin"),r=Ze(s),i=Ze(t),n=`https://api.cursor.com/teams/daily-usage-data?startDate=${r}&endDate=${i}`,o=await fetch(n,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${l.slice(0,200)}`)}let c=await o.json(),a=[],u=0;for(let l of c.data||[]){u+=1;let d=l.date;for(let p of l.userMetrics||[]){for(let m of p.modelUsage||[]){let f=Number(m.acceptedLines??0),y=Number(m.suggestedLines??0);a.push({provider:"cursor",day:d,costUsd:Number(m.totalCents??0)/100,userEmail:p.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:y>0?f/y:void 0})}(!p.modelUsage||p.modelUsage.length===0)&&a.push({provider:"cursor",day:d,costUsd:Number(p.totalCents??0)/100,userEmail:p.email})}}return{ok:!0,items:a,rawBuckets:u}}async function Tn({startMs:s,endMs:t}){let[e,r,i]=await Promise.allSettled([Nr({startMs:s,endMs:t}),Ir({startMs:s,endMs:t}),Or({startMs:s,endMs:t})]),n=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=n(e),c=n(r),a=n(i),u=[{provider:"openai",totalUsd:o.items.reduce((l,d)=>l+(d.costUsd||0),0)},{provider:"anthropic",totalUsd:c.items.reduce((l,d)=>l+(d.costUsd||0),0)},{provider:"cursor",totalUsd:a.items.reduce((l,d)=>l+(d.costUsd||0),0)}];return{openai:o,anthropic:c,cursor:a,totals:u}}function En(s,t){let e=new Map;for(let r of s){let i=t(r);if(!i)continue;let n=e.get(i)||{key:i,totalUsd:0,count:0};n.totalUsd+=r.costUsd||0,n.count+=1,e.set(i,n)}return[...e.values()].sort((r,i)=>i.totalUsd-r.totalUsd)}function Ln(s){if(!s.length)return{mean:0,stddev:0};let t=s.reduce((r,i)=>r+i,0)/s.length,e=s.reduce((r,i)=>r+(i-t)**2,0)/s.length;return{mean:t,stddev:Math.sqrt(e)}}import{z as k}from"zod";var ye=["ok","info","warn","critical"],xn=k.object({primary:k.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:k.object({value:k.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:k.enum(["up","down","flat"]).optional(),severity:k.enum(ye).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:k.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Cn=k.object({kind:k.literal("trend"),title:k.string().max(120).optional(),labels:k.array(k.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:k.array(k.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:k.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:k.enum(ye).optional()}),Pn=k.object({kind:k.literal("table"),title:k.string().max(120).optional(),headers:k.array(k.string().max(40)).min(1).max(8),rows:k.array(k.array(k.union([k.string().max(200),k.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),Jn=k.object({kind:k.literal("callouts"),title:k.string().max(120).optional(),tone:k.enum(ye).default("info").optional(),items:k.array(k.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),Un=k.object({kind:k.literal("breakdown"),title:k.string().max(120).optional(),rows:k.array(k.object({label:k.string().min(1).max(80),value:k.string().min(1).max(80),sub:k.string().max(120).optional(),severity:k.enum(ye).optional()})).min(1).max(20)}),qn=k.object({kind:k.literal("paragraph"),title:k.string().max(120).optional(),text:k.string().min(1).max(3e3)}),Mn=k.discriminatedUnion("kind",[Cn,Pn,Jn,Un,qn]),et=k.object({title:k.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:k.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:xn,sections:k.array(Mn).max(20).default([]).superRefine((s,t)=>{s.forEach((e,r)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:k.ZodIssueCode.custom,path:[r,"rows"],message:"every row must have headers.length entries"})})}),footer:k.object({viewUrl:k.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:k.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),V=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),Ar=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),Dn=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function Rr(s,t,e=12){if(!Number.isFinite(s)||!Number.isFinite(t)||t<=0)return"";let r=Math.max(0,Math.min(1,s/t)),i=Math.round(r*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function tt(s,t){let e=String(s);return e.length>=t?e:e+" ".repeat(t-e.length)}function $r(s,t){let e=String(s);return e.length>=t?e:" ".repeat(t-e.length)+e}function jr({headers:s,rows:t}){let e=s.map((o,c)=>{let a=Math.max(String(o).length,...t.map(u=>String(u[c]??"").length));return Math.min(a,32)}),r=o=>o.map((c,a)=>tt(c,e[a])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[r(s),i,...t.map(o=>r(o))].join(`
809
+ `)+"\n```"}function Bn(s){let t=et.parse(s),e=[];e.push({type:"header",text:{type:"plain_text",text:t.title.slice(0,150),emoji:!0}}),t.subtitle&&e.push({type:"context",elements:[{type:"mrkdwn",text:t.subtitle}]});let r=[`*${t.headline.primary}*`];if(t.headline.delta){let n=Ar[t.headline.delta.direction]||"",o=t.headline.delta.severity?V[t.headline.delta.severity]:"";r.push(`${n} ${t.headline.delta.value} ${o}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
810
810
  `+t.headline.summary),e.push({type:"section",text:{type:"mrkdwn",text:i}});for(let n of t.sections)switch(e.push({type:"divider"}),n.title&&e.push({type:"section",text:{type:"mrkdwn",text:`*${n.title}*`}}),n.kind){case"trend":{let o=Math.max(...n.values),c=n.labels.map((a,u)=>{let l=n.values[u],d=Rr(l,o),m=(n.highlight==="last"&&u===n.labels.length-1||n.highlight==="max"&&l===o||n.highlight==="min"&&l===Math.min(...n.values))&&n.severity?` ${V[n.severity]}`:"";return`${tt(a,10)} ${$r(l.toLocaleString(),8)} ${d}${m}`});e.push({type:"section",text:{type:"mrkdwn",text:"```\n"+c.join(`
811
811
  `)+"\n```"}});break}case"table":{e.push({type:"section",text:{type:"mrkdwn",text:jr(n)}});break}case"callouts":{let o=V[n.tone||"info"];e.push({type:"section",text:{type:"mrkdwn",text:n.items.map(c=>`${o} ${c}`).join(`
812
812
  `)}});break}case"breakdown":{let o=n.rows.map(c=>({type:"mrkdwn",text:`*${c.label}*
813
813
  ${c.value}${c.sub?`
814
- _${c.sub}_`:""}${c.severity?` ${V[c.severity]}`:""}`}));for(let c=0;c<o.length;c+=10)e.push({type:"section",fields:o.slice(c,c+10)});break}case"paragraph":{e.push({type:"section",text:{type:"mrkdwn",text:n.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let n=[];t.footer.viewUrl&&n.push({type:"button",text:{type:"plain_text",text:"View in Zibby"},url:t.footer.viewUrl,style:"primary"}),t.footer.rerunUrl&&n.push({type:"button",text:{type:"plain_text",text:"Run again"},url:t.footer.rerunUrl}),e.push({type:"divider"}),e.push({type:"actions",elements:n})}return e}function Rn(s){let t=et.parse(s),e=[],r=[`**${t.headline.primary}**`];if(t.headline.delta){let o=Ar[t.headline.delta.direction]||"",c=t.headline.delta.severity?V[t.headline.delta.severity]:"";r.push(`${o} ${t.headline.delta.value} ${c}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
814
+ _${c.sub}_`:""}${c.severity?` ${V[c.severity]}`:""}`}));for(let c=0;c<o.length;c+=10)e.push({type:"section",fields:o.slice(c,c+10)});break}case"paragraph":{e.push({type:"section",text:{type:"mrkdwn",text:n.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let n=[];t.footer.viewUrl&&n.push({type:"button",text:{type:"plain_text",text:"View in Zibby"},url:t.footer.viewUrl,style:"primary"}),t.footer.rerunUrl&&n.push({type:"button",text:{type:"plain_text",text:"Run again"},url:t.footer.rerunUrl}),e.push({type:"divider"}),e.push({type:"actions",elements:n})}return e}function Kn(s){let t=et.parse(s),e=[],r=[`**${t.headline.primary}**`];if(t.headline.delta){let o=Ar[t.headline.delta.direction]||"",c=t.headline.delta.severity?V[t.headline.delta.severity]:"";r.push(`${o} ${t.headline.delta.value} ${c}`.trim())}let i=r.join(" ");t.headline.summary&&(i+=`
815
815
  `+t.headline.summary),e.push({tag:"div",text:{tag:"lark_md",content:i}});for(let o of t.sections)switch(e.push({tag:"hr"}),o.title&&e.push({tag:"div",text:{tag:"lark_md",content:`**${o.title}**`}}),o.kind){case"trend":{let c=Math.max(...o.values),a=o.labels.map((u,l)=>{let d=o.values[l],p=Rr(d,c),f=(o.highlight==="last"&&l===o.labels.length-1||o.highlight==="max"&&d===c||o.highlight==="min"&&d===Math.min(...o.values))&&o.severity?` ${V[o.severity]}`:"";return`${tt(u,10)} ${$r(d.toLocaleString(),8)} ${p}${f}`});e.push({tag:"div",text:{tag:"lark_md",content:"```\n"+a.join(`
816
816
  `)+"\n```"}});break}case"table":{e.push({tag:"div",text:{tag:"lark_md",content:jr(o)}});break}case"callouts":{let c=V[o.tone||"info"];e.push({tag:"div",text:{tag:"lark_md",content:o.items.map(a=>`${c} ${a}`).join(`
817
817
  `)}});break}case"breakdown":{let c=o.rows.map(a=>{let u=a.severity?` ${V[a.severity]}`:"",l=a.sub?` *${a.sub}*`:"";return`**${a.label}** ${a.value}${l}${u}`});e.push({tag:"div",text:{tag:"lark_md",content:c.join(`
818
- `)}});break}case"paragraph":{e.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let o=[];t.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:t.footer.viewUrl,type:"primary"}),t.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:t.footer.rerunUrl,type:"default"}),e.push({tag:"hr"}),e.push({tag:"action",actions:o})}let n="blue";return t.headline.delta?.severity&&(n=On[t.headline.delta.severity]||"blue"),{config:{wide_screen_mode:!0},header:{title:{tag:"plain_text",content:t.title.slice(0,200)},subtitle:t.subtitle?{tag:"plain_text",content:t.subtitle.slice(0,200)}:void 0,template:n},elements:e}}var pa=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),ma=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});import{createRequire as $n}from"module";import{fileURLToPath as jn}from"url";import{registerHandlers as Tn}from"@zibby/core/function-skill-registry.js";import{registerSkill as En}from"@zibby/agent-workflow";var xn=$n(import.meta.url);function Ln(){try{return xn.resolve("@zibby/core/function-bridge.js")}catch{return null}}var Cn=import.meta.url;function Pn(){let s=Error.prepareStackTrace;try{Error.prepareStackTrace=(r,i)=>i;let e=new Error().stack;for(let r=2;r<e.length;r++){let i=e[r].getFileName();if(i&&i!==Cn&&!i.startsWith("node:"))return i.startsWith("file://")?jn(i):i}return null}finally{Error.prepareStackTrace=s}}function Jn(s){if(!s||typeof s!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[r,i]of Object.entries(s))if(typeof i=="string")t[r]={type:i},e.push(r);else{let{required:n,...o}=i;t[r]=o,n!==!1&&e.push(r)}return{type:"object",properties:t,required:e}}function Un(s,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r={[s]:e.handler},i=[{name:s,description:e.description||"",input_schema:Jn(e.input)}];return Tn(s,r,i),{id:s,type:"function",serverName:s,allowedTools:[`mcp__${s}__*`],description:e.description||`Function skill: ${s}`,envKeys:[],tools:i,resolve(){let n=Ln();return n?{command:"node",args:[n,t,s]}:null}}}function qn(s,t){return{id:s,type:"mcp",serverName:t.serverName||s,allowedTools:t.allowedTools||[`mcp__${t.serverName||s}__*`],description:t.description||`MCP skill: ${s}`,envKeys:t.envKeys||[],tools:t.tools||[],resolve:t.resolve,...t.cursorKey&&{cursorKey:t.cursorKey},...t.sessionEnvKey&&{sessionEnvKey:t.sessionEnvKey}}}function Tr(s,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r=Pn();if(!r)throw new Error(`Could not resolve caller file for skill "${s}".`);e=Un(s,r,t)}else if(typeof t.resolve=="function")e=qn(s,t);else throw new Error(`Skill "${s}" must have either a handler (function skill) or resolve (MCP skill).`);return En(e),e}var Mn=Tr;import{registerSkill as Fa,getSkill as za,hasSkill as Wa,getAllSkills as Ha,listSkillIds as Ya}from"@zibby/agent-workflow";A(st);A(ot);A(ct);A(lt);A(dt);A(pt);A(q);A(B);A(ft);A(be);A(ht);A(Mt);A(Ft);A(_t);A(vt);A(nr);A(wr);A(Ve);A(Qe);A(Xe);A({...q,id:"slack_notify"});var qa={BROWSER:"browser",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",LINEAR:"linear",PLANE:"plane",GIT:"git",SLACK:"slack",LARK:"lark",CHAT_NOTIFY:"chat_notify",SENTRY:"sentry",MEMORY:"memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools",CHAT_MEMORY:"chat-memory",WORKFLOW_BUILDER:"workflow-builder",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin"};export{O as INTEGRATIONS,Dr as INTEGRATION_REGISTRY,ye as REPORT_SEVERITIES,qa as SKILLS,Qe as anthropicBillingSkill,st as browserSkill,nr as chatMemorySkill,ft as chatNotifySkill,vt as coreToolsSkill,Xe as cursorAdminSkill,hn as fetchAllProviders,Ir as fetchAnthropicCosts,yn as fetchAnthropicWorkspaces,Or as fetchCursorSpend,Nr as fetchOpenAICosts,fn as fetchOpenAIProjects,Mn as functionSkill,Ha as getAllSkills,za as getSkill,Ft as gitSkill,ct as githubSkill,lt as gitlabSkill,gn as groupByKey,Wa as hasSkill,ot as jiraSkill,B as larkSkill,dt as linearSkill,Ya as listSkillIds,_n as meanStddev,ht as memorySkill,Ve as openaiBillingSkill,pt as planeSkill,Fa as registerSkill,et as reportObjectSchema,An as reportToBlockKit,Rn as reportToLarkCard,Mt as runnerSkill,be as sentrySkill,Tr as skill,_t as skillInstallerSkill,q as slackSkill,Mt as testRunnerSkill,wr as workflowBuilderSkill};
818
+ `)}});break}case"paragraph":{e.push({tag:"div",text:{tag:"lark_md",content:o.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let o=[];t.footer.viewUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"View in Zibby"},url:t.footer.viewUrl,type:"primary"}),t.footer.rerunUrl&&o.push({tag:"button",text:{tag:"plain_text",content:"Run again"},url:t.footer.rerunUrl,type:"default"}),e.push({tag:"hr"}),e.push({tag:"action",actions:o})}let n="blue";return t.headline.delta?.severity&&(n=Dn[t.headline.delta.severity]||"blue"),{config:{wide_screen_mode:!0},header:{title:{tag:"plain_text",content:t.title.slice(0,200)},subtitle:t.subtitle?{tag:"plain_text",content:t.subtitle.slice(0,200)}:void 0,template:n},elements:e}}var Pa=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),Ja=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});import{createRequire as Gn}from"module";import{fileURLToPath as Fn}from"url";import{registerHandlers as zn}from"@zibby/core/function-skill-registry.js";import{registerSkill as Wn}from"@zibby/agent-workflow";var Hn=Gn(import.meta.url);function Yn(){try{return Hn.resolve("@zibby/core/function-bridge.js")}catch{return null}}var Zn=import.meta.url;function Vn(){let s=Error.prepareStackTrace;try{Error.prepareStackTrace=(r,i)=>i;let e=new Error().stack;for(let r=2;r<e.length;r++){let i=e[r].getFileName();if(i&&i!==Zn&&!i.startsWith("node:"))return i.startsWith("file://")?Fn(i):i}return null}finally{Error.prepareStackTrace=s}}function Qn(s){if(!s||typeof s!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[r,i]of Object.entries(s))if(typeof i=="string")t[r]={type:i},e.push(r);else{let{required:n,...o}=i;t[r]=o,n!==!1&&e.push(r)}return{type:"object",properties:t,required:e}}function Xn(s,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r={[s]:e.handler},i=[{name:s,description:e.description||"",input_schema:Qn(e.input)}];return zn(s,r,i),{id:s,type:"function",serverName:s,allowedTools:[`mcp__${s}__*`],description:e.description||`Function skill: ${s}`,envKeys:[],tools:i,resolve(){let n=Yn();return n?{command:"node",args:[n,t,s]}:null}}}function eo(s,t){return{id:s,type:"mcp",serverName:t.serverName||s,allowedTools:t.allowedTools||[`mcp__${t.serverName||s}__*`],description:t.description||`MCP skill: ${s}`,envKeys:t.envKeys||[],tools:t.tools||[],resolve:t.resolve,...t.cursorKey&&{cursorKey:t.cursorKey},...t.sessionEnvKey&&{sessionEnvKey:t.sessionEnvKey}}}function Tr(s,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${s}" must have a handler function`);let r=Vn();if(!r)throw new Error(`Could not resolve caller file for skill "${s}".`);e=Xn(s,r,t)}else if(typeof t.resolve=="function")e=eo(s,t);else throw new Error(`Skill "${s}" must have either a handler (function skill) or resolve (MCP skill).`);return Wn(e),e}var to=Tr;import{registerSkill as yc,getSkill as hc,hasSkill as gc,getAllSkills as _c,listSkillIds as bc}from"@zibby/agent-workflow";A(st);A(ot);A(ct);A(lt);A(dt);A(pt);A(q);A(B);A(ft);A(be);A(ht);A(Mt);A(Ft);A(_t);A(vt);A(nr);A(wr);A(Ve);A(Qe);A(Xe);A({...q,id:"slack_notify"});var lc={BROWSER:"browser",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",LINEAR:"linear",PLANE:"plane",GIT:"git",SLACK:"slack",LARK:"lark",CHAT_NOTIFY:"chat_notify",SENTRY:"sentry",MEMORY:"memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools",CHAT_MEMORY:"chat-memory",WORKFLOW_BUILDER:"workflow-builder",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin"};export{O as INTEGRATIONS,Dr as INTEGRATION_REGISTRY,ye as REPORT_SEVERITIES,lc as SKILLS,Qe as anthropicBillingSkill,st as browserSkill,nr as chatMemorySkill,ft as chatNotifySkill,vt as coreToolsSkill,Xe as cursorAdminSkill,Tn as fetchAllProviders,Ir as fetchAnthropicCosts,jn as fetchAnthropicWorkspaces,Or as fetchCursorSpend,Nr as fetchOpenAICosts,$n as fetchOpenAIProjects,to as functionSkill,_c as getAllSkills,hc as getSkill,Ft as gitSkill,ct as githubSkill,lt as gitlabSkill,En as groupByKey,gc as hasSkill,ot as jiraSkill,B as larkSkill,dt as linearSkill,bc as listSkillIds,Ln as meanStddev,ht as memorySkill,Ve as openaiBillingSkill,pt as planeSkill,yc as registerSkill,et as reportObjectSchema,Bn as reportToBlockKit,Kn as reportToLarkCard,Mt as runnerSkill,be as sentrySkill,Tr as skill,_t as skillInstallerSkill,q as slackSkill,Mt as testRunnerSkill,wr as workflowBuilderSkill};