@zibby/skills 0.1.25 → 0.1.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/mcp-sentry.mjs +15 -36
- package/dist/chat-notify.js +15 -0
- package/dist/github.js +3 -3
- package/dist/index.js +107 -93
- package/dist/integrations.js +1 -1
- package/dist/jira.js +12 -12
- package/dist/lark.js +2 -2
- package/dist/llm-billing.js +1 -0
- package/dist/package.json +11 -5
- package/dist/report.js +12 -0
- package/dist/sentry.js +2 -2
- package/dist/slack.js +2 -2
- package/docs/get-started/install.md +1 -1
- package/docs/get-started/trigger-and-logs.md +1 -1
- package/docs/get-started/use-from-agents.md +153 -0
- package/docs/intro.md +1 -0
- package/docs/legacy/test-automation.md +1 -2
- package/docs/packages/mcp-cli.md +176 -0
- package/docs/recipes/test.md +1 -1
- package/package.json +11 -5
package/dist/index.js
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
import{registerSkill as
|
|
1
|
+
import{registerSkill as $}from"@zibby/agent-workflow";import{createRequire as gr}from"module";import{join as _r}from"path";var kr=gr(import.meta.url);function br(){if(process.env.MCP_BROWSER_PATH)return process.env.MCP_BROWSER_PATH;try{return kr.resolve("@zibby/mcp-browser/dist/bin/mcp-browser-zibby.js")}catch{return null}}var wr="1280x720",Sr="1280x720";function vr({headless:r}={}){if(r===!0)return!0;if(r===!1)return!1;let t=process.env.ZIBBY_HEADLESS;return t==="1"||String(t).toLowerCase()==="true"}function Nr(r,t){let e=(r||[]).filter(s=>s!=="--headless");return t?[...e,"--headless"]:e}var We={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:r,workspace:t,nodeName:e,headless:s}={}){let
|
|
3
|
+
DO NOT return success: true unless you ACTUALLY called browser tools.`,resolve({sessionPath:r,workspace:t,nodeName:e,headless:s}={}){let i=br(),n=r&&e?_r(r,e):null,o=n||r||t||"test-results",a=vr({headless:s}),c={};if(n&&(c.ZIBBY_NODE_SESSION_PATH=n),r&&(c.ZIBBY_SESSION_PATH=r),!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
|
-
Override: set MCP_BROWSER_PATH to the path of mcp-browser-zibby.js.`);return{command:"node",args:
|
|
6
|
+
Override: set MCP_BROWSER_PATH to the path of mcp-browser-zibby.js.`);return{command:"node",args:Nr([i,"--isolated",`--save-video=${wr}`,`--viewport-size=${Sr}`,`--output-dir=${o}`],a),env:c}}};import{createRequire as Ir}from"module";import{resolveIntegrationToken as $r,clearTokenCache as Rr}from"@zibby/core/backend-client.js";var A=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"}),Or=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"}});var jr=Ir(import.meta.url);function xr(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return jr.resolve("@zibby/mcp-jira/index.js")}catch{return null}}var Ar=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Tr(r,t){if(!t||!t.length)return r;let e=r;for(let s of t)s.type==="strong"?e=`**${e}**`:s.type==="em"?e=`_${e}_`:s.type==="code"?e=`\`${e}\``:s.type==="strike"?e=`~~${e}~~`:s.type==="link"&&s.attrs?.href&&(e=`[${e}](${s.attrs.href})`);return e}function ae(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let s of r){if(s.type==="text"){e.push(Tr(s.text||"",s.marks));continue}if(s.type==="hardBreak"){e.push(`
|
|
7
7
|
`);continue}if(s.type==="rule"){e.push(`
|
|
8
8
|
---
|
|
9
|
-
`);continue}let
|
|
10
|
-
${
|
|
9
|
+
`);continue}let i=s.content?ae(s.content,t+1):"";if(s.type==="listItem")e.push(i);else if(s.type==="bulletList"){let n=(s.content||[]).map(o=>`- ${ae(o.content||[],t+1).trim()}`);e.push(`
|
|
10
|
+
${n.join(`
|
|
11
11
|
`)}
|
|
12
|
-
`)}else if(s.type==="orderedList"){let
|
|
13
|
-
${
|
|
12
|
+
`)}else if(s.type==="orderedList"){let n=(s.content||[]).map((o,a)=>`${a+1}. ${ae(o.content||[],t+1).trim()}`);e.push(`
|
|
13
|
+
${n.join(`
|
|
14
14
|
`)}
|
|
15
|
-
`)}else if(s.type==="heading"){let
|
|
15
|
+
`)}else if(s.type==="heading"){let n=s.attrs?.level||2;e.push(`
|
|
16
16
|
|
|
17
|
-
${"#".repeat(
|
|
17
|
+
${"#".repeat(n)} ${i.trim()}
|
|
18
18
|
|
|
19
|
-
`)}else
|
|
19
|
+
`)}else Ar.has(s.type)?e.push(`
|
|
20
20
|
|
|
21
|
-
${
|
|
22
|
-
`):e.push(
|
|
21
|
+
${i}
|
|
22
|
+
`):e.push(i)}return e.join("").replace(/\n{3,}/g,`
|
|
23
23
|
|
|
24
|
-
`)}function
|
|
24
|
+
`)}function V(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Se(r){return V(r).replace(/[a-z0-9]+/g,"")}function ce(r,t){let e=V(r),s=V(t);if(!e||!s)return 0;if(e===s)return 1;if(e.length===1||s.length===1)return e===s?1:0;let i=l=>{let p=new Map;for(let m=0;m<l.length-1;m++){let d=l.slice(m,m+2);p.set(d,(p.get(d)||0)+1)}return p},n=i(e),o=i(s),a=0,c=0,u=0;for(let l of n.values())c+=l;for(let l of o.values())u+=l;for(let[l,p]of n.entries()){let m=o.get(l)||0;a+=Math.min(p,m)}return 2*a/Math.max(1,c+u)}function K(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Er(r,t=[]){let e=Array.isArray(t)?t:[];if(e.length===0)return{requested:r||null,resolved:null,strategy:"none"};let s=e.filter(a=>!a.subtask),i=s.length>0?s:e,n=K(r);if(n){let a=i.find(l=>K(l.name)===n);if(a)return{requested:r,resolved:a,strategy:"exact"};let c={task:["task","\u4EFB\u52A1","\u4E8B\u9879","to do","todo"],story:["story","\u7528\u6237\u6545\u4E8B","\u9700\u6C42"],bug:["bug","\u7F3A\u9677","\u95EE\u9898"],improvement:["improvement","\u4F18\u5316","\u6539\u8FDB"],epic:["epic","\u53F2\u8BD7"]};for(let l of Object.values(c)){if(!l.some(m=>K(m)===n))continue;let p=i.find(m=>l.some(d=>K(d)===K(m.name)));if(p)return{requested:r,resolved:p,strategy:"alias"}}let u=i.map(l=>({t:l,score:ce(r,l.name)})).sort((l,p)=>p.score-l.score);if(u[0]&&u[0].score>=.5)return{requested:r,resolved:u[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=i.find(u=>K(u.name)===a);if(c)return{requested:r||null,resolved:c,strategy:"default-preferred"}}return{requested:r||null,resolved:i[0],strategy:"default-first"}}async function Ge(r){let t=`projectKeys=${encodeURIComponent(r)}&expand=projects.issuetypes`,e=await O(`/rest/api/3/issue/createmeta?${t}`),s=Array.isArray(e?.projects)?e.projects:[],n=s.find(a=>String(a?.key||"").toUpperCase()===String(r||"").toUpperCase())||s[0]||null;return(Array.isArray(n?.issuetypes)?n.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function He(r,t){if(!r)throw new Error("projectKey is required");let e="sprint is not EMPTY";t==="active"?e="sprint in openSprints()":t==="closed"?e="sprint in closedSprints()":t==="future"&&(e="sprint in futureSprints()");let s=`project = ${r} AND ${e} ORDER BY updated DESC`,i=`jql=${encodeURIComponent(s)}&maxResults=100&fields=customfield_10020`,n=await O(`/rest/api/3/search/jql?${i}`),o=new Map;for(let a of n.issues||[])for(let c of a.fields?.customfield_10020||[])c&&!o.has(c.id)&&o.set(c.id,{id:c.id,name:c.name,state:c.state,boardId:c.boardId||null,startDate:c.startDate||null,endDate:c.endDate||null,goal:c.goal||null});return[...o.values()].sort((a,c)=>{let u={active:0,future:1,closed:2},l=(u[a.state]??3)-(u[c.state]??3);return l!==0?l:String(c.startDate||"").localeCompare(String(a.startDate||""))})}function Cr(r,{sprintId:t,sprintName:e,target:s}={}){let i=Array.isArray(r)?r:[];if(!i.length)return{sprint:null,selectedBy:"none"};if(t!=null&&String(t).trim()!=="")return{sprint:i.find(a=>String(a.id)===String(t))||null,selectedBy:"id"};if(e&&String(e).trim()){let o=String(e).trim(),a=i.find(u=>String(u.name||"").toLowerCase()===o.toLowerCase());if(a)return{sprint:a,selectedBy:"name-exact"};let c=i.map(u=>({s:u,score:ce(o,u.name||"")})).sort((u,l)=>l.score-u.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let n=String(s||"current").trim().toLowerCase();return n==="active"||n==="current"||n==="latest"?{sprint:i[0],selectedBy:n}:{sprint:i[0],selectedBy:"default"}}function Lr(r,t){let e=r?.fields?.customfield_10020;return Array.isArray(e)?e.some(s=>String(s?.id)===String(t)):!1}async function Jr({issueKey:r,projectKey:t,sprintId:e,attempts:s=3,delayMs:i=450}){let n=[];for(let o=0;o<s;o++){try{let a=`project = ${t} AND key = ${r} AND sprint = ${e}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,u=await O(`/rest/api/3/search/jql?${c}`);if(Number(u?.total||0)>0)return n.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:n};let p=await O(`/rest/api/3/issue/${r}?fields=customfield_10020,status`),m=Lr(p,e);if(n.push({attempt:o+1,jql:!1,issueField:m}),m)return{ok:!0,method:"issue_field",traces:n}}catch(a){n.push({attempt:o+1,error:String(a?.message||a)})}o<s-1&&await new Promise(a=>setTimeout(a,i))}return{ok:!1,method:"none",traces:n}}async function ve({issueKey:r,projectKey:t,sprintId:e,sprintName:s,target:i}){if(!r)return{ok:!1,error:"issueKey is required"};let n=t;if(!n&&(n=(await O(`/rest/api/3/issue/${r}?fields=project`))?.fields?.project?.key||null,!n))return{ok:!1,error:`Could not resolve project for ${r}`};let o=await He(n,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${n}`};let{sprint:a,selectedBy:c}=Cr(o,{sprintId:e,sprintName:s,target:i});if(!a)return{ok:!1,error:`No matching sprint found in ${n}`,requested:{sprintId:e??null,sprintName:s??null,target:i??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await O(`/rest/api/3/issue/${r}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let u=await Jr({issueKey:r,projectKey:n,sprintId:a.id}),l=u.ok;return{ok:l,issueKey:r,projectKey:n,sprintId:a.id,sprintName:a.name,selectedBy:c,verifiedBy:u.method,verified:l,verificationTrace:u.traces,warning:l?null:`Sprint assignment attempted but verification did not find ${r} in sprint ${a.id}`}}async function O(r,t={}){let e=async()=>{let{token:s,cloudId:i}=await $r("jira");if(typeof s!="string"||!s)throw new Error(`Invalid jira token type: ${typeof s}`);if(!i)throw new Error("Invalid jira cloudId: missing");let n=`https://api.atlassian.com/ex/jira/${i}${r}`,o=await fetch(n,{method:t.method||"GET",headers:{Authorization:`Bearer ${s}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`Jira API ${o.status}: ${c.slice(0,300)}`)}let a=await o.text().catch(()=>"");if(!a||!a.trim())return{};try{return JSON.parse(a)}catch{return{raw:a}}};try{return await e()}catch(s){let i=String(s?.message||s||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("403")||i.includes("substring")))throw s;return Rr("jira"),e()}}var Ye={id:"jira",serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:A.JIRA,envKeys:["ATLASSIAN_ACCESS_TOKEN","ATLASSIAN_CLOUD_ID"],description:"Zibby Jira MCP Server (OAuth Bearer)",promptFragment:`## Jira (connected)
|
|
25
25
|
You have direct access to the user's Jira. Use these tools proactively:
|
|
26
26
|
|
|
27
27
|
### Issue tools
|
|
@@ -71,7 +71,7 @@ When user asks to move/transition ticket status:
|
|
|
71
71
|
3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
|
|
72
72
|
4. Call jira_get_issue(issueKey) to verify final status before claiming success.
|
|
73
73
|
5. If target wording differs (e.g. \u5DF2\u7ECF\u9A8C\u6536 vs \u5DF2\u9A8C\u6536), try toStatus first; only ask user to confirm when no reasonable match exists.
|
|
74
|
-
6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=us();if(!r)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:[r],env:t,description:this.description}},async handleToolCall(r,t){try{switch(r){case"jira_list_projects":{let e=await N("/rest/api/3/project"),s=(Array.isArray(e)?e:[]).map(n=>({id:n.id,key:n.key,name:n.name,style:n.style}));return JSON.stringify({count:s.length,projects:s})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let i=await N(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(i)?i:[],a=new Map;for(let l of o)for(let u of l.statuses||[])u?.id&&(a.has(u.id)||a.set(u.id,{id:u.id,name:u.name,category:u.statusCategory?.name||null}));let c=[...a.values()].sort((l,u)=>String(l.name).localeCompare(String(u.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let s=await N("/rest/api/3/status"),n=(Array.isArray(s)?s:[]).map(i=>({id:i.id,name:i.name,category:i.statusCategory?.name||null})).sort((i,o)=>String(i.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:n.length,statuses:n})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let s=await Je(e);return JSON.stringify({projectKey:e,count:s.length,issueTypes:s})}case"jira_search":{let e=t.jql||"",s=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let i=`jql=${encodeURIComponent(e)}&maxResults=${s}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await N(`/rest/api/3/search/jql?${i}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let s=await N(`/rest/api/3/issue/${e}`);return JSON.stringify({key:s.key,project:s.fields?.project?.key,summary:s.fields?.summary,description:s.fields?.description,status:s.fields?.status?.name,assignee:s.fields?.assignee?.displayName||"Unassigned",priority:s.fields?.priority?.name,type:s.fields?.issuetype?.name,labels:s.fields?.labels,created:s.fields?.created,updated:s.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:s,issueType:n,description:i,priority:o,labels:a,assigneeId:c,moveToSprint:l,moveToActiveSprint:u,sprintId:p,sprintName:y,target:m}=t;if(!e||!s)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:n||null,resolved:null,strategy:"none"},k=[];try{k=await Je(e),f=ms(n,k)}catch{}let h={project:{key:e},summary:s,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:n||"Task"}};i&&(h.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:i}]}]}),o&&(h.priority={name:o}),a?.length&&(h.labels=a),c&&(h.assignee={id:c});let g=await N("/rest/api/3/issue",{method:"POST",body:{fields:h}}),_={ok:!0,key:g.key,id:g.id,self:g.self};return f?.resolved&&(_.issueType=f.resolved.name,_.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&U(f.requested)!==U(f.resolved.name)&&(_.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),k.length>0&&(_.availableIssueTypes=k.map(d=>d.name)),(l||u)&&(_.sprintMove=await he({issueKey:g.key,projectKey:e,sprintId:p,sprintName:y,target:m})),JSON.stringify(_)}case"jira_list_sprints":{let{projectKey:e,state:s}=t,n=await De(e,s);return JSON.stringify({count:n.length,sprints:n})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:s,sprintId:n,sprintName:i,target:o}=t||{},a=await he({issueKey:e,projectKey:s,sprintId:n,sprintName:i,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:s,sprintId:n,sprintName:i,target:o}=t||{},a=await he({issueKey:e,projectKey:s,sprintId:n,sprintName:i,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:s,projectKey:n,status:i,maxResults:o}=t;if(!e&&!s)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=s?`sprint = ${s}`:`sprint = "${e}"`,l=n?`project = ${n} AND `:"",u=i?` AND status = "${i}"`:"",p=`${l}${c}${u} ORDER BY status ASC, priority DESC`,y=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,m=await N(`/rest/api/3/search/jql?${y}`),f=(m.issues||[]).map(h=>({key:h.key,project:h.fields?.project?.key,summary:h.fields?.summary,status:h.fields?.status?.name,assignee:h.fields?.assignee?.displayName||"Unassigned",priority:h.fields?.priority?.name,type:h.fields?.issuetype?.name})),k={};for(let h of f)k[h.status]=(k[h.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:k,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:s}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let i=await N(`/rest/api/3/issue/${e}/comment?maxResults=${s||50}&orderBy=-created`),o=(i.comments||[]).map(a=>{let c="";return a.body?.content&&(c=te(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:i.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:s}=t;return!e||!s?JSON.stringify({error:"issueKey and body are required"}):(await N(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:s}=t;return!e||!s?JSON.stringify({error:"issueKey and fields are required"}):(await N(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:s}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:s,toStatus:n,statusName:i,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(n||i||o||"").trim();if(!s&&!a){let p=((await N(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(y=>({id:y.id,name:y.name,to:y.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=s;if(!c){let p=(await N(`/rest/api/3/issue/${e}/transitions`)).transitions||[],y=z(a),m=p.find(f=>z(f?.name||"")===y||z(f?.to?.name||"")===y);if(!m){let f=ge(a);f.length>=2&&(m=p.find(k=>{let h=ge(k?.name||""),g=ge(k?.to?.name||""),_=h.length>=2&&(h.includes(f)||f.includes(h)),d=g.length>=2&&(g.includes(f)||f.includes(g));return _||d}))}if(!m){let f=p.map(_=>{let d=se(a,_?.name||""),b=se(a,_?.to?.name||"");return{t:_,score:Math.max(d,b)}}).sort((_,d)=>d.score-_.score),k=f[0],h=f[1];k&&k.score>=.45&&(!h||k.score-h.score>=.12)&&(m=k.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await N(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let l=await N(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:l?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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 Pe}from"@zibby/core/backend-client.js";async function I(r,t={}){let{token:e}=await Pe("github"),s=r.startsWith("https://")?r:`https://api.github.com${r}`,n={Authorization:`Bearer ${e}`,Accept:t.accept||"application/vnd.github.v3+json","User-Agent":"Zibby-App",...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(s,{method:t.method||"GET",headers:n,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`GitHub API ${i.status}: ${o.slice(0,300)}`)}return t.raw?i.text():i.json()}var Ue={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:x.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 r=xr();if(!r)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:[r],env:t,description:this.description}},async handleToolCall(r,t){try{switch(r){case"jira_list_projects":{let e=await O("/rest/api/3/project"),s=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:s.length,projects:s})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let n=await O(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],a=new Map;for(let u of o)for(let l of u.statuses||[])l?.id&&(a.has(l.id)||a.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let c=[...a.values()].sort((u,l)=>String(u.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let s=await O("/rest/api/3/status"),i=(Array.isArray(s)?s:[]).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 s=await Ge(e);return JSON.stringify({projectKey:e,count:s.length,issueTypes:s})}case"jira_search":{let e=t.jql||"",s=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${s}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await O(`/rest/api/3/search/jql?${n}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let s=await O(`/rest/api/3/issue/${e}`);return JSON.stringify({key:s.key,project:s.fields?.project?.key,summary:s.fields?.summary,description:s.fields?.description,status:s.fields?.status?.name,assignee:s.fields?.assignee?.displayName||"Unassigned",priority:s.fields?.priority?.name,type:s.fields?.issuetype?.name,labels:s.fields?.labels,created:s.fields?.created,updated:s.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:s,issueType:i,description:n,priority:o,labels:a,assigneeId:c,moveToSprint:u,moveToActiveSprint:l,sprintId:p,sprintName:m,target:d}=t;if(!e||!s)return JSON.stringify({error:"projectKey and summary are required"});let y={requested:i||null,resolved:null,strategy:"none"},_=[];try{_=await Ge(e),y=Er(i,_)}catch{}let g={project:{key:e},summary:s,issuetype:y?.resolved?.id?{id:y.resolved.id}:{name:i||"Task"}};n&&(g.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(g.priority={name:o}),a?.length&&(g.labels=a),c&&(g.assignee={id:c});let h=await O("/rest/api/3/issue",{method:"POST",body:{fields:g}}),k={ok:!0,key:h.key,id:h.id,self:h.self};return y?.resolved&&(k.issueType=y.resolved.name,k.issueTypeResolution=y.strategy,y.strategy!=="exact"&&y.requested&&K(y.requested)!==K(y.resolved.name)&&(k.issueTypeWarning=`Requested "${y.requested}" is not available in ${e}; used "${y.resolved.name}" instead.`)),_.length>0&&(k.availableIssueTypes=_.map(f=>f.name)),(u||l)&&(k.sprintMove=await ve({issueKey:h.key,projectKey:e,sprintId:p,sprintName:m,target:d})),JSON.stringify(k)}case"jira_list_sprints":{let{projectKey:e,state:s}=t,i=await He(e,s);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:s,sprintId:i,sprintName:n,target:o}=t||{},a=await ve({issueKey:e,projectKey:s,sprintId:i,sprintName:n,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:s,sprintId:i,sprintName:n,target:o}=t||{},a=await ve({issueKey:e,projectKey:s,sprintId:i,sprintName:n,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:s,projectKey:i,status:n,maxResults:o}=t;if(!e&&!s)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=s?`sprint = ${s}`:`sprint = "${e}"`,u=i?`project = ${i} AND `:"",l=n?` AND status = "${n}"`:"",p=`${u}${c}${l} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,d=await O(`/rest/api/3/search/jql?${m}`),y=(d.issues||[]).map(g=>({key:g.key,project:g.fields?.project?.key,summary:g.fields?.summary,status:g.fields?.status?.name,assignee:g.fields?.assignee?.displayName||"Unassigned",priority:g.fields?.priority?.name,type:g.fields?.issuetype?.name})),_={};for(let g of y)_[g.status]=(_[g.status]||0)+1;return JSON.stringify({count:y.length,total:d.total||y.length,statusCounts:_,issues:y})}case"jira_get_comments":{let{issueKey:e,maxResults:s}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await O(`/rest/api/3/issue/${e}/comment?maxResults=${s||50}&orderBy=-created`),o=(n.comments||[]).map(a=>{let c="";return a.body?.content&&(c=ae(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:s}=t;return!e||!s?JSON.stringify({error:"issueKey and body are required"}):(await O(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:s}=t;return!e||!s?JSON.stringify({error:"issueKey and fields are required"}):(await O(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:s}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:s,toStatus:i,statusName:n,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(i||n||o||"").trim();if(!s&&!a){let p=((await O(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(m=>({id:m.id,name:m.name,to:m.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=s;if(!c){let p=(await O(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=V(a),d=p.find(y=>V(y?.name||"")===m||V(y?.to?.name||"")===m);if(!d){let y=Se(a);y.length>=2&&(d=p.find(_=>{let g=Se(_?.name||""),h=Se(_?.to?.name||""),k=g.length>=2&&(g.includes(y)||y.includes(g)),f=h.length>=2&&(h.includes(y)||y.includes(h));return k||f}))}if(!d){let y=p.map(k=>{let f=ce(a,k?.name||""),S=ce(a,k?.to?.name||"");return{t:k,score:Math.max(f,S)}}).sort((k,f)=>f.score-k.score),_=y[0],g=y[1];_&&_.score>=.45&&(!g||_.score-g.score>=.12)&&(d=_.t)}if(!d?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(y=>({id:y.id,name:y.name,to:y.to?.name}))});c=d.id}await O(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let u=await O(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:u?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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 Ze}from"@zibby/core/backend-client.js";async function j(r,t={}){let{token:e}=await Ze("github"),s=r.startsWith("https://")?r:`https://api.github.com${r}`,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(s,{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 Ve={id:"github",serverName:"github",allowedTools:["mcp__github__*"],requiresIntegration:A.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
|
|
@@ -102,19 +102,23 @@ When user says "check out repo-name" or "clone repo-name":
|
|
|
102
102
|
3. STOP. Do not offer to inspect files or ask what to do next.
|
|
103
103
|
|
|
104
104
|
When user just wants to "look at" or "read" files (not clone):
|
|
105
|
-
- Use github_get_file to read individual files via API`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{command:"npx",args:["-y","@modelcontextprotocol/server-github@latest"],env:r}},async handleToolCall(r,t){try{switch(r){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let s=await
|
|
105
|
+
- Use github_get_file to read individual files via API`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{command:"npx",args:["-y","@modelcontextprotocol/server-github@latest"],env:r}},async handleToolCall(r,t){try{switch(r){case"github_search_issues":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let s=await j(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(s.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:s.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let s=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",n=await j(`/search/code?q=${encodeURIComponent(e)}${s}${i}&per_page=${t.limit||15}`),o=(n.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:n.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:s,number:i}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await j(`/repos/${e}/${s}/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:s,number:i}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await j(`/repos/${e}/${s}/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:s,number:i}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await j(`/repos/${e}/${s}/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:s,number:i}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and number are required"});let n=await j(`/repos/${e}/${s}/pulls/${i}/comments?per_page=50`),o=await j(`/repos/${e}/${s}/issues/${i}/comments?per_page=50`),a=[...n.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,u)=>new Date(c.createdAt)-new Date(u.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_list_commits":{let{owner:e,repo:s,branch:i,path:n,limit:o}=t;if(!e||!s)return JSON.stringify({error:"owner and repo are required"});let a=`/repos/${e}/${s}/commits?per_page=${o||20}`;i&&(a+=`&sha=${encodeURIComponent(i)}`),n&&(a+=`&path=${encodeURIComponent(n)}`);let c=await j(a);return JSON.stringify({total:c.length,commits:c.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:s,sha:i}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let n=await j(`/repos/${e}/${s}/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:s,path:i,ref:n}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${s}/contents/${encodeURIComponent(i)}`;n&&(o+=`?ref=${encodeURIComponent(n)}`);let a=await j(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:i,entries:a.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),u=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:u?c.slice(0,2e4):c,truncated:u})}case"github_get_user":try{let e=await j("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let s=e.repositories[0],i=s.owner.login,n=s.owner.type,o=n==="Organization"?`/orgs/${i}`:`/users/${i}`,a=await j(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:n,isOrg:n==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let s=(await j("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of s)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 y=function(h){let k=h.replace(/^~(?=$|\/|\\)/,d);return a(k)},{owner:e,repo:s,destination:i}=t;if(!e||!s)return JSON.stringify({error:"owner and repo are required"});let{execSync:n}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:u}=await import("fs"),{homedir:l,platform:p}=await import("os"),{token:m}=await Ze("github"),d=l(),_=i?y(i):o(d,"zibby-repos"),g=o(_,s);if(u(_,{recursive:!0}),c(g))return JSON.stringify({error:`Directory ${g} already exists. Remove it first or use a different destination.`,existingPath:g});try{let h=`https://x-access-token:${m}@github.com/${e}/${s}.git`;n(`git clone ${h} "${g}"`,{stdio:"pipe"});let k=p()==="win32",f;return k?f=n(`dir "${g}"`,{encoding:"utf-8",shell:"cmd.exe"}):f=n(`ls -la "${g}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:g,message:`Cloned ${e}/${s} to ${g}`,contents:f.split(`
|
|
106
106
|
`).slice(0,30).join(`
|
|
107
|
-
`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(
|
|
107
|
+
`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(h){return JSON.stringify({error:`Clone failed: ${h.message}`})}}case"github_search_repos":{let{query:e,limit:s}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),n=JSON.parse(i);if(n.error)return JSON.stringify(n);let o=e.toLowerCase(),a=n.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,s||20)})}case"github_list_repos":{let{owner:e,type:s,sort:i,direction:n,limit:o}=t,a=100,c=o||200,u=[];if(!e){let y=1,_=!0;for(;_&&u.length<c;){let f=`/installation/repositories?per_page=${a}&page=${y}`,x=(await j(f)).repositories||[];if(x.length===0)break;u=u.concat(x),_=x.length===a,y++}let g=u.slice(0,c).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})),h=g.filter(f=>f.private).length,k=g.filter(f=>!f.private).length;return JSON.stringify({count:g.length,repos:g,privateCount:h,publicCount:k,message:`Found ${h} private and ${k} public repos`})}let l=await j(`/orgs/${e}`).then(()=>!0).catch(()=>!1),p=1,m=!0;for(;m&&u.length<c;){let y;l?y=`/orgs/${e}/repos?per_page=${a}&page=${p}&type=${s||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`:y=`/users/${e}/repos?per_page=${a}&page=${p}&type=${s||"all"}&sort=${i||"updated"}&direction=${n||"desc"}`;let _=await j(y),g=Array.isArray(_)?_:[];if(g.length===0)break;u=u.concat(g),m=g.length===a,p++}let d=u.slice(0,c).map(y=>({name:y.name,fullName:y.full_name,private:y.private,description:y.description,language:y.language,defaultBranch:y.default_branch,updatedAt:y.updated_at,stars:y.stargazers_count,url:y.html_url}));return JSON.stringify({count:d.length,repos:d})}case"github_create_issue":{let{owner:e,repo:s,title:i,body:n}=t;if(!e||!s||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await j(`/repos/${e}/${s}/issues`,{method:"POST",body:{title:i,body:n||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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_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"]}}]};import{resolveIntegrationToken as Dr}from"@zibby/core/backend-client.js";async function B(r,t={}){let{token:e}=await Dr("slack"),s=["conversations.list","users.list","users.profile.get","conversations.history","conversations.replies"].includes(r),i=`https://slack.com/api/${r}`,n={Authorization:`Bearer ${e}`},o;if(s){let u=new URLSearchParams(t).toString();u&&(i+=`?${u}`)}else n["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let c=await(await fetch(i,{method:s?"GET":"POST",headers:n,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var M={id:"slack",serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:A.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack (connected)
|
|
108
108
|
You have access to the user's Slack workspace. Use these tools:
|
|
109
109
|
- slack_list_channels, slack_post_message, slack_reply_to_thread
|
|
110
110
|
- slack_add_reaction, slack_get_channel_history, slack_get_thread_replies
|
|
111
|
-
- slack_get_users, slack_get_user_profile`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{command:"npx",args:["-y","@modelcontextprotocol/server-slack@latest"],env:r}},async handleToolCall(r,t){try{switch(r){case"slack_list_channels":{let e=await
|
|
111
|
+
- slack_get_users, slack_get_user_profile`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{command:"npx",args:["-y","@modelcontextprotocol/server-slack@latest"],env:r}},async handleToolCall(r,t){try{switch(r){case"slack_list_channels":{let e=await B("conversations.list",{types:"public_channel",limit:100});return JSON.stringify({channels:(e.channels||[]).map(s=>({id:s.id,name:s.name,topic:s.topic?.value}))})}case"slack_post_message":{if(!t.channel||!t.text)return JSON.stringify({error:"channel and text are required"});let e=await B("chat.postMessage",{channel:t.channel,text:t.text});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 B("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 B("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 B("conversations.history",{channel:t.channel,limit:t.limit||20});return JSON.stringify({messages:(e.messages||[]).map(s=>({user:s.user,text:s.text,ts:s.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 B("conversations.replies",{channel:t.channel,ts:t.thread_ts});return JSON.stringify({messages:(e.messages||[]).map(s=>({user:s.user,text:s.text,ts:s.ts}))})}case"slack_get_users":{let e=await B("users.list",{limit:100});return JSON.stringify({users:(e.members||[]).filter(s=>!s.is_bot&&!s.deleted).map(s=>({id:s.id,name:s.real_name||s.name}))})}case"slack_get_user_profile":{if(!t.user_id)return JSON.stringify({error:"user_id is required"});let e=await B("users.profile.get",{user:t.user_id});return JSON.stringify({profile:e.profile})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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",input_schema:{type:"object",properties:{channel:{type:"string",description:"Channel ID or name"},text:{type:"string",description:"Message text"}},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"]}}]};import{existsSync as Ur}from"fs";import{fileURLToPath as Pr}from"url";import{dirname as Mr,resolve as qr}from"path";import{resolveIntegrationToken as Kr}from"@zibby/core/backend-client.js";function Br(){if(process.env.MCP_LARK_PATH)return process.env.MCP_LARK_PATH;let r=Mr(Pr(import.meta.url)),t=qr(r,"..","bin","mcp-lark.mjs");return Ur(t)?t:null}var Fr=6e3*1e3,te=null;async function zr(){let{appId:r,appSecret:t,host:e}=await Kr("lark");if(te&&te.appId===r&&te.expiresAt>Date.now())return{token:te.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:r,app_secret:t})})).json();if(i.code!==0)throw new Error(`Lark tenant_access_token failed: ${i.msg||i.code}`);return te={token:i.tenant_access_token,expiresAt:Date.now()+Fr,appId:r},{token:i.tenant_access_token,host:e}}async function le(r,t,e={}){let{token:s,host:i}=await zr(),n=`${i}${t}`,o={method:r,headers:{Authorization:`Bearer ${s}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&(o.body=JSON.stringify(e));let c=await(await fetch(n,o)).json();if(c.code!==0)throw new Error(`Lark API ${t} error: ${c.msg||c.code}`);return c.data||{}}function Qe(r){return JSON.stringify({text:r})}function Wr(r){return!r||typeof r!="string"||r.startsWith("oc_")?"chat_id":r.startsWith("ou_")?"open_id":r.startsWith("on_")?"union_id":r.startsWith("cli_")?"app_id":r.includes("@")?"email":"chat_id"}var F={id:"lark",serverName:"lark",allowedTools:["mcp__lark__*"],requiresIntegration:A.LARK,description:"Lark / Feishu messaging \u2014 send messages and reply in threads.",envKeys:[],promptFragment:`## Lark (connected)
|
|
112
112
|
You can send messages and replies on Lark. Use:
|
|
113
113
|
- lark_send_message: post a message to a chat, user, or DM
|
|
114
114
|
- lark_reply: reply to an existing message (threaded)
|
|
115
115
|
- lark_list_chats: list chats the bot is a member of
|
|
116
116
|
- lark_get_chat_history: fetch recent messages in a chat
|
|
117
|
-
When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let r=
|
|
117
|
+
When responding to an incoming event, prefer lark_reply with the source message_id so the response threads cleanly.`,resolve(){let r=Br();if(!r)return null;let t={};for(let e of["PROJECT_API_TOKEN","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r],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"]}}],async handleToolCall(r,t){try{switch(r){case"lark_send_message":{if(!t.receive_id||!t.text)return JSON.stringify({error:"receive_id and text are required"});let e=Wr(t.receive_id),s=await le("POST",`/open-apis/im/v1/messages?receive_id_type=${e}`,{receive_id:t.receive_id,msg_type:"text",content:Qe(t.text)});return JSON.stringify({ok:!0,message_id:s.message_id})}case"lark_reply":{if(!t.message_id||!t.text)return JSON.stringify({error:"message_id and text are required"});let e=await le("POST",`/open-apis/im/v1/messages/${encodeURIComponent(t.message_id)}/reply`,{msg_type:"text",content:Qe(t.text)});return JSON.stringify({ok:!0,message_id:e.message_id})}case"lark_list_chats":{let e=t.page_size||50,i=((await le("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 le("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})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}}};var Xe={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:[...M.envKeys||[],...F.envKeys||[]],promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
|
|
118
|
+
You can post chat messages via either:
|
|
119
|
+
- slack_post_message (channel, text) \u2014 Slack, when SLACK_CHANNEL is set
|
|
120
|
+
- lark_send_message (receive_id, text) \u2014 Lark, when LARK_RECEIVE_ID is set
|
|
121
|
+
Use whichever the user has configured.`,resolve(r){return process.env.SLACK_CHANNEL&&typeof M.resolve=="function"?M.resolve(r):process.env.LARK_RECEIVE_ID&&typeof F.resolve=="function"?F.resolve(r):null},async handleToolCall(r,t,e){return typeof r=="string"&&r.startsWith("slack_")?M.handleToolCall(r,t,e):typeof r=="string"&&r.startsWith("lark_")?F.handleToolCall(r,t,e):JSON.stringify({error:`chat_notify: unknown tool "${r}". Expected slack_* or lark_*.`})},get tools(){return[...M.tools||[],...F.tools||[]]}};import{createRequire as Gr}from"module";import{execFileSync as Hr}from"child_process";import{join as et}from"path";import{existsSync as Yr}from"fs";var Zr=Gr(import.meta.url);function Vr(){if(process.env.MCP_MEMORY_PATH)return process.env.MCP_MEMORY_PATH;try{return Zr.resolve("@zibby/ui-memory/mcp-server")}catch{return null}}var tt={id:"memory",serverName:"memory",allowedTools:["mcp__memory__*"],envKeys:[],description:"Zibby Memory MCP Server (test history, selectors, page model)",async middleware(){try{let{createMemoryMiddleware:r}=await import("@zibby/ui-memory");return r()}catch{return null}},promptFragment:`BEFORE executing browser actions:
|
|
118
122
|
- Review any test memory/history above. Prefer selectors proven to work.
|
|
119
123
|
- If a previous run failed, avoid the same approach.
|
|
120
124
|
- After setup/login completes, navigate directly to the target page instead of clicking through menus.
|
|
@@ -126,18 +130,18 @@ DURING execution \u2014 when a selector fails and you switch to a fallback:
|
|
|
126
130
|
AFTER completing the test, you MUST call memory_save_insight at least once:
|
|
127
131
|
- Save any useful finding: reliable selectors, timing quirks, navigation patterns, workarounds.
|
|
128
132
|
- Category: selector_tip | timing | navigation | workaround | flaky | general
|
|
129
|
-
- Be specific \u2014 future runs will read your insights.`,resolve(){let r=
|
|
133
|
+
- Be specific \u2014 future runs will read your insights.`,resolve(){let r=Vr();if(!r)throw new Error(`\u274C Memory MCP server not found
|
|
130
134
|
|
|
131
135
|
Install @zibby/ui-memory:
|
|
132
|
-
npm install @zibby/ui-memory`);let t=
|
|
136
|
+
npm install @zibby/ui-memory`);let t=et(process.cwd(),".zibby","memory");if(!Yr(et(t,".dolt")))throw new Error(`\u274C Memory database not initialized
|
|
133
137
|
|
|
134
138
|
Run:
|
|
135
|
-
zibby init --mem`);try{let e
|
|
139
|
+
zibby init --mem`);try{let e=Hr("dolt",["sql","-q","SELECT COUNT(*) AS cnt FROM test_runs","-r","json"],{cwd:t,encoding:"utf-8",timeout:5e3}),s=JSON.parse(e.trim()).rows||[];if(!s[0]||s[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
|
|
136
140
|
|
|
137
141
|
Install Dolt:
|
|
138
142
|
https://docs.dolthub.com/introduction/installation
|
|
139
143
|
|
|
140
|
-
Error: ${e.message}`,{cause:e})}return{command:"node",args:[r,"--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
|
|
144
|
+
Error: ${e.message}`,{cause:e})}return{command:"node",args:[r,"--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 Qr,readFileSync as Xr}from"fs";import{homedir as es}from"os";import{join as ts}from"path";import{spawn as rs}from"child_process";var H={jira:{description:"Jira issue search, details, comments, transitions",integrationProvider:"jira",envKeys:[],setupInstructions:`To connect Jira:
|
|
141
145
|
1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
|
|
142
146
|
2. Click "Connect Jira" and authorize via Atlassian OAuth
|
|
143
147
|
3. After OAuth completes, ask me to install Jira again`},github:{description:"GitHub issues, PRs, repository management",integrationProvider:"github",envKeys:[],setupInstructions:`To connect GitHub:
|
|
@@ -149,15 +153,15 @@ AFTER completing the test, you MUST call memory_save_insight at least once:
|
|
|
149
153
|
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:
|
|
150
154
|
1. Go to Settings \u2192 Integrations (https://studio.zibby.dev/integrations)
|
|
151
155
|
2. Click "Connect Sentry" and authorize
|
|
152
|
-
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
|
|
153
|
-
`)}function
|
|
154
|
-
`)}function
|
|
156
|
+
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 ss(){let r=["## Available Skills"];for(let[t,e]of Object.entries(H)){let s=e.integrationProvider?`integration: ${e.integrationProvider}`:"ready";r.push(`- ${t}: ${e.description} [${s}]`)}return r.push(""),r.push("Use the install_skill / uninstall_skill / list_available_skills tools to manage skills."),r.push(`Zibby third party Integration settings page: ${Ne()}`),r.push(""),r.push("## Tool-First Policy (mandatory)"),r.push("CRITICAL RULES \u2014 follow these strictly:"),r.push("1. When user asks to do something and a matching skill is available but not installed, IMMEDIATELY call install_skill. Never ask for credentials or confirmation first."),r.push(`2. If install_skill succeeds, the skill's tools are now available. Use them RIGHT AWAY in the same turn \u2014 don't just say "it's connected", actually call the tools.`),r.push("3. If install_skill reports needsIntegration, tell the user to connect via the integration URL and try again after."),r.push("4. When the relevant skill is already installed, use its tools directly \u2014 don't ask for IDs or keys. Each skill's own instructions explain the workflow."),r.push("5. If a task needs multiple skills (e.g. data from one + execution from another), install all of them, then follow each skill's workflow instructions."),r.join(`
|
|
157
|
+
`)}function ns(){if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=ts(es(),".zibby","config.json");return Qr(r)&&JSON.parse(Xr(r,"utf-8")).sessionToken||null}catch{return null}}function is(){return(process.env.ZIBBY_API_URL||process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app").replace(/\/$/,"")}function Ne(){return`${(process.env.ZIBBY_FRONTEND_URL||process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev").replace(/\/$/,"")}/integrations`}function os(r){try{let t=process.platform;return rs(t==="darwin"?"open":t==="win32"?"cmd":"xdg-open",t==="win32"?["/c","start","",r]:[r],{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function as(){let r=ns();if(!r)return{checked:!1,statuses:null,reason:"no-session-token"};try{let t=await fetch(`${is()}/integrations/status`,{method:"GET",headers:{Authorization:`Bearer ${r}`}});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 rt(r,t){if(!t||!r)return{connected:null};let e=r[t];return!e||typeof e.connected!="boolean"?{connected:null,details:e||null}:{connected:e.connected,details:e}}var st={id:"skill-installer",description:"Live skill installation for chat sessions",envKeys:[],catalog:H,promptFragment:ss,tools:[{name:"install_skill",description:"Install a skill into the current chat session so its tools become available",input_schema:{type:"object",properties:{skillId:{type:"string",description:'Skill identifier to install (e.g. "jira", "github", "browser", "memory")'}},required:["skillId"]}},{name:"uninstall_skill",description:"Remove a skill from the current chat session",input_schema:{type:"object",properties:{skillId:{type:"string",description:"Skill identifier to remove"}},required:["skillId"]}},{name:"list_available_skills",description:"List all skills that can be installed, with their env-var readiness status",input_schema:{type:"object",properties:{}}}],async handleToolCall(r,t,e){let{activeSkills:s}=e,i=await as();if(r==="list_available_skills"){let n=Object.entries(H).map(([o,a])=>{let c=s.includes(o),u=rt(i.statuses,a.integrationProvider);return{id:o,description:a.description,installed:c,integrationProvider:a.integrationProvider||void 0,integrationConnected:u.connected,setupInstructions:u.connected===!1?a.setupInstructions:void 0}});return JSON.stringify({skills:n})}if(r==="install_skill"){let{skillId:n}=t;if(!n)return JSON.stringify({ok:!1,error:"skillId is required"});if(s.includes(n)){let l=H[n],{getSkill:p}=await import("@zibby/agent-workflow"),d=(p(n)?.tools||[]).map(y=>y.name);return JSON.stringify({ok:!0,alreadyInstalled:!0,skillId:n,description:l?.description,availableTools:d,integrationUrl:l?.integrationProvider?Ne():void 0,hint:`${n} is already active. Tools available: ${d.join(", ")}. Use them directly.`})}if(!H[n])return JSON.stringify({ok:!1,error:`Unknown skill "${n}". Available: ${Object.keys(H).join(", ")}`});let o=H[n];if(o.integrationProvider){let l=rt(i.statuses,o.integrationProvider),p=Ne();if(i.checked&&l.connected===!1){let m=os(p);return JSON.stringify({ok:!1,error:`${o.integrationProvider} is not connected for this Zibby account yet`,needsIntegration:!0,integrationUrl:p,openedBrowser:m,setupInstructions:`Please connect ${o.integrationProvider} first at ${p}. After you finish OAuth, ask me to install ${n} again.`})}}s.push(n);let{getSkill:a}=await import("@zibby/agent-workflow"),u=(a(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(r==="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=s.indexOf(n);return o===-1?JSON.stringify({ok:!1,error:`${n} is not installed`}):(s.splice(o,1),JSON.stringify({ok:!0,uninstalled:n}))}return JSON.stringify({error:`Unknown tool: ${r}`})},resolve(){return null}};import{readFileSync as cs,readdirSync as ls,statSync as it,writeFileSync as us,mkdirSync as ps}from"fs";import{join as ot,resolve as ds,relative as ms}from"path";import{execSync as at}from"child_process";var nt=256*1024,fs=64*1024,ct={id:"core-tools",description:"File read/write, directory listing, shell commands, open URLs, wait for async operations",envKeys:[],tools:[{name:"read_file",description:"Read the contents of a file. Returns the text content.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"}},required:["path"]}},{name:"write_file",description:"Write content to a file. Creates parent directories if needed.",input_schema:{type:"object",properties:{path:{type:"string",description:"File path (relative to cwd or absolute)"},content:{type:"string",description:"Content to write"}},required:["path","content"]}},{name:"list_directory",description:"List files and directories in a path. Returns names with type indicators (/ for dirs).",input_schema:{type:"object",properties:{path:{type:"string",description:"Directory path (relative to cwd or absolute). Defaults to cwd."}}}},{name:"run_command",description:"Run a shell command and return its output. Use for grep, git, npm, etc.",input_schema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute"},cwd:{type:"string",description:"Working directory (optional, defaults to project root)"}},required:["command"]}},{name:"open_url",description:"Open a URL in the user's default browser. Use for OAuth flows, documentation, integration setup pages.",input_schema:{type:"object",properties:{url:{type:"string",description:"URL to open"}},required:["url"]}},{name:"wait",description:"Wait for N seconds. Use this for async operations (tests, builds, deploys) \u2014 wait, then check status again.",input_schema:{type:"object",properties:{seconds:{type:"number",description:"Seconds to wait (default: 5, max: 300)"},reason:{type:"string",description:"Why waiting (for logging/clarity)"}}}}],async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"read_file":return ys(t,s);case"write_file":return hs(t,s);case"list_directory":return gs(t,s);case"run_command":return _s(t,s);case"open_url":return ks(t);case"wait":return await bs(t,e?.options?.signal);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};function ue(r,t){return ds(t,r)}function ys(r,t){let e=ue(r.path,t),s=it(e);return s.size>nt?JSON.stringify({error:`File too large (${(s.size/1024).toFixed(0)}KB). Max: ${nt/1024}KB`}):cs(e,"utf-8")}function hs(r,t){let e=ue(r.path,t),s=ot(e,"..");return ps(s,{recursive:!0}),us(e,r.content,"utf-8"),JSON.stringify({ok:!0,path:ms(t,e)})}function gs(r,t){let e=ue(r.path||".",t);return ls(e).map(i=>{try{return it(ot(e,i)).isDirectory()?`${i}/`:i}catch{return i}}).join(`
|
|
158
|
+
`)}function _s(r,t){let e=r.cwd?ue(r.cwd,t):t;return at(r.command,{cwd:e,encoding:"utf-8",timeout:3e4,maxBuffer:fs,stdio:["pipe","pipe","pipe"]})||"(no output)"}function ks(r){let{url:t}=r;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,s=e==="darwin"?"open":e==="win32"?"start":"xdg-open";try{return at(`${s} "${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 bs(r,t){let e=Math.min(Math.max(r.seconds||5,1),300),s=r.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:s,interrupted:!0});await new Promise(o=>setTimeout(o,Math.min(i,n-Date.now())))}return JSON.stringify({ok:!0,waited:e,reason:s})}import{existsSync as ws}from"fs";import{fileURLToPath as Ss}from"url";import{dirname as vs,resolve as Ns}from"path";import{resolveIntegrationToken as lt}from"@zibby/core/backend-client.js";function Os(){if(process.env.MCP_SENTRY_PATH)return process.env.MCP_SENTRY_PATH;let r=vs(Ss(import.meta.url)),t=Ns(r,"..","bin","mcp-sentry.mjs");return ws(t)?t:null}async function ut(r,t={}){let{token:e,organizationSlug:s}=await lt("sentry"),i=`https://sentry.io/api/0/organizations/${s}${r}`,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 Is(){return ut("/projects/?per_page=50")}async function $s({query:r="is:unresolved",sort:t="date",project:e,limit:s=25}={}){let i=`/issues/?query=${encodeURIComponent(r)}&sort=${t}&per_page=${s}`;return e&&(i+=`&project=${encodeURIComponent(e)}`),ut(i)}async function Rs(r){if(!r)throw new Error("sentryGetIssue: issueId is required");let{token:t}=await lt("sentry"),e=await fetch(`https://sentry.io/api/0/issues/${r}/`,{headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let s=await e.text().catch(()=>"");throw new Error(`Sentry API ${e.status}: ${s.slice(0,300)}`)}return e.json()}var pe={id:"sentry",serverName:"sentry",allowedTools:["mcp__sentry__*"],requiresIntegration:A.SENTRY,description:"Sentry error tracking \u2014 projects, issues, events",envKeys:[],tools:[],promptFragment:`## Sentry (connected)
|
|
155
159
|
You have access to the user's Sentry. Use these tools:
|
|
156
160
|
- sentry_list_projects: List projects in the organization
|
|
157
161
|
- sentry_list_issues: List errors/issues (supports Sentry search query, project filter, sort)
|
|
158
|
-
- sentry_get_issue: Get detailed info about a specific issue (requires issueId)`,resolve(){let r=
|
|
162
|
+
- sentry_get_issue: Get detailed info about a specific issue (requires issueId)`,resolve(){let r=Os();if(!r)return null;let t={};for(let e of["PROJECT_API_TOKEN","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r],env:t,alwaysLoad:!0}},async handleToolCall(r,t={}){try{switch(r){case"sentry_list_projects":{let e=await Is();return JSON.stringify({projects:e.map(s=>({slug:s.slug,name:s.name,platform:s.platform}))})}case"sentry_list_issues":{let e=await $s({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(s=>({id:s.id,title:s.title,culprit:s.culprit,count:s.count,firstSeen:s.firstSeen,lastSeen:s.lastSeen,level:s.level,status:s.status}))})}case"sentry_get_issue":{let e=await Rs(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: ${r}`})}}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"]}}]};pe.tools=pe.toolsForAssistant;import{spawn as bt}from"child_process";import{writeFileSync as js,mkdirSync as pt,existsSync as D,readdirSync as ye,readFileSync as fe,unlinkSync as xs,createWriteStream as As,statSync as Ts}from"fs";import{resolve as Y,join as J}from"path";import{resolveMaxParallelRuns as wt}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as Es}from"@zibby/core/constants/zibby-scratch.js";var $e="sessions",Re=".zibby/output",de=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",Cs=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",St=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",E=new Map,z=[],Ls=0,Oe=0,dt=3e3;function vt(){return`run_${++Ls}_${Date.now().toString(36)}`}function mt(r){let t=Math.floor(r/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function Nt(r){return r.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function T(r,t,e){if(!Cs)return;let s=`
|
|
159
163
|
${t} [${r}] ${e}
|
|
160
|
-
`;try{process.stderr.write(s)}catch{}}function
|
|
164
|
+
`;try{process.stderr.write(s)}catch{}}function je(){z.length=0;for(let[,r]of E)if(r.status==="queued"&&(r.status="cancelled"),r.status==="running"&&r._child)try{r._child.kill("SIGTERM")}catch{}}process.on("exit",je);process.on("SIGINT",()=>{je(),process.exit(0)});process.on("SIGTERM",()=>{je(),process.exit(0)});var Ot={id:"runner",description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],promptFragment:`## Test Runner
|
|
161
165
|
You can run zibby test workflows directly from chat:
|
|
162
166
|
|
|
163
167
|
**CRITICAL: When user asks to test a ticket:**
|
|
@@ -294,35 +298,35 @@ Each run generates:
|
|
|
294
298
|
- events.json: All browser events
|
|
295
299
|
- raw_stream_output.txt: Agent log
|
|
296
300
|
|
|
297
|
-
Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"run_generate":return await
|
|
298
|
-
`)){let
|
|
301
|
+
Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"run_generate":return await Js(t,s);case"run_test":return await Ks(t,s,e);case"run_status":return Bs(t);case"run_cancel":return Fs(t);case"run_artifacts":return Gs(t,s);case"run_diagnose":return Hs(t,s);case"list_specs":return Ys(t,s);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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 Ie(){let r=0;for(let[,t]of E)t.status==="running"&&r++;return r}function ft(){for(;z.length>0;){let r=wt(z[0]?.context?.options?.config);if(Ie()>=r)break;let{args:t,cwd:e,context:s}=z.shift();It(t,e,s)}}async function Js(r,t){let{ticket:e,description:s,input:i,repo:n,agent:o,output:a}=r,c=["generate"];e&&c.push("--ticket",e),s&&c.push("--description",s),i&&c.push("--input",i),n&&c.push("--repo",n),a&&c.push("--output",a);let u=["assistant","cursor","claude","codex","gemini"],l=o||process.env.AGENT_TYPE,p=l&&u.includes(l)?l:null;p&&c.push("--agent",p);let m=e||"generate";return T(m,"\u{1F9EA}","Starting test spec generation (real agent with codebase access)..."),new Promise(d=>{St&&console.error(`[zibby:spawn] skill=run_generate parentPid=${process.pid} \u2192 child zibby ${c.map(h=>/\s/.test(h)?JSON.stringify(h):h).join(" ")} cwd=${t}`);let y=bt("zibby",c,{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"],detached:!1}),_="",g="";y.stdout.on("data",h=>{let k=h.toString();_+=k;for(let f of k.split(`
|
|
302
|
+
`)){let S=Nt(f).trim();S.startsWith("\u2705")?T(m,"\u2705",S.slice(2).trim()):S.startsWith("\u2713")&&T(m,"\u2714",S.slice(2).trim())}}),y.stderr.on("data",h=>{g+=h.toString()}),y.on("close",h=>{if(h!==0){T(m,"\u274C",`Generation failed (exit ${h})`),d(JSON.stringify({error:`zibby generate failed with exit code ${h}`,stderr:g.slice(-1e3)}));return}let k=Y(t,a||"test-specs"),f=[];try{let S=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";f=ye(k).filter(x=>x.endsWith(".txt")&&(!S||x.startsWith(S))).map(x=>J(k,x))}catch{}T(m,"\u2705",`Generated ${f.length} test spec files`),d(JSON.stringify({success:!0,ticketKey:e||null,specFiles:f.map(S=>S.replace(`${t}/`,"")),total:f.length,message:`Generated ${f.length} specs. Now call run_test for each file.`}))}),y.on("error",h=>{T(m,"\u274C",`Spawn error: ${h.message}`),d(JSON.stringify({error:h.message}))})})}var yt=1e5,ht=/^[A-Z][A-Z0-9]+-\d+$/,Ds=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Us(r,t){if(!t||!t.length)return r;let e=r;for(let s of t)s.type==="strong"?e=`**${e}**`:s.type==="em"?e=`_${e}_`:s.type==="code"?e=`\`${e}\``:s.type==="strike"?e=`~~${e}~~`:s.type==="link"&&s.attrs?.href&&(e=`[${e}](${s.attrs.href})`);return e}function me(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let s of r){if(s.type==="text"){e.push(Us(s.text||"",s.marks));continue}if(s.type==="hardBreak"){e.push(`
|
|
299
303
|
`);continue}if(s.type==="rule"){e.push(`
|
|
300
304
|
---
|
|
301
|
-
`);continue}let
|
|
302
|
-
${
|
|
305
|
+
`);continue}let i=s.content?me(s.content,t+1):"";if(s.type==="listItem")e.push(i);else if(s.type==="bulletList"){let n=(s.content||[]).map(o=>`- ${me(o.content||[],t+1).trim()}`);e.push(`
|
|
306
|
+
${n.join(`
|
|
303
307
|
`)}
|
|
304
|
-
`)}else if(s.type==="orderedList"){let
|
|
305
|
-
${
|
|
308
|
+
`)}else if(s.type==="orderedList"){let n=(s.content||[]).map((o,a)=>`${a+1}. ${me(o.content||[],t+1).trim()}`);e.push(`
|
|
309
|
+
${n.join(`
|
|
306
310
|
`)}
|
|
307
|
-
`)}else if(s.type==="heading"){let
|
|
311
|
+
`)}else if(s.type==="heading"){let n=s.attrs?.level||2;e.push(`
|
|
308
312
|
|
|
309
|
-
${"#".repeat(
|
|
313
|
+
${"#".repeat(n)} ${i.trim()}
|
|
310
314
|
|
|
311
|
-
`)}else
|
|
315
|
+
`)}else Ds.has(s.type)?e.push(`
|
|
312
316
|
|
|
313
|
-
${
|
|
314
|
-
`):e.push(
|
|
317
|
+
${i}
|
|
318
|
+
`):e.push(i)}return e.join("").replace(/\n{3,}/g,`
|
|
315
319
|
|
|
316
|
-
`)}function
|
|
320
|
+
`)}function Ps(r){return r==null||r===""?"":typeof r=="string"?r.trim():typeof r=="object"&&Array.isArray(r.content)?me(r.content).trim():""}async function Ms(r){let{getSkill:t}=await import("@zibby/agent-workflow"),e=t("jira");if(!e||typeof e.handleToolCall!="function")return null;try{let s=await e.handleToolCall("jira_get_issue",{issueKey:r}),i=JSON.parse(s);if(i?.error)return null;let n=await e.handleToolCall("jira_get_comments",{issueKey:r,maxResults:50}),o=JSON.parse(n);if(o?.error)return null;let a=Ps(i.description),c=[];a&&c.push(a);let u=Array.isArray(o.comments)?o.comments:[];if(u.length>0){let p=u.map(m=>String(m.body||"").trim()).filter(Boolean).join(`
|
|
317
321
|
|
|
318
|
-
`);p&&c.push(p)}let
|
|
322
|
+
`);p&&c.push(p)}let l=c.join(`
|
|
319
323
|
|
|
320
|
-
`).trim();return
|
|
324
|
+
`).trim();return l?(l.length>yt&&(l=`${l.slice(0,yt)}
|
|
321
325
|
|
|
322
|
-
...[truncated]`),{inlineSpec:`inline:${
|
|
323
|
-
`)
|
|
324
|
-
Spawn error: ${
|
|
325
|
-
${e||""}`.toLowerCase(),
|
|
326
|
+
...[truncated]`),{inlineSpec:`inline:${l}`,issueKey:r}):null}catch{return null}}function qs(r,t){try{let e=JSON.parse(r);return JSON.stringify({...e,...t})}catch{return r}}async function Ks(r,t,e){let s={...r},i=String(s.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let n=null;if(ht.test(i)&&!i.startsWith("inline:")){let l=await Ms(i);l&&(i=l.inlineSpec,s.spec=i,String(s.ticketKey||"").trim()||(s.ticketKey=l.issueKey),n=l.issueKey)}let o=String(s.ticketKey||"").trim();if(o){for(let[l,p]of E.entries())if(p?.ticketKey===o&&!(p?.status!=="running"&&p?.status!=="queued"))return JSON.stringify({runId:l,ticketKey:o,status:p.status,reused:!0,message:`A run for ${o} is already ${p.status}. Reusing existing run instead of starting a duplicate.`})}if(!i.startsWith("inline:")){let l=Y(t,i);if(!D(l))return ht.test(i)?JSON.stringify({error:`Invalid run_test spec: "${i}" is an issue id, not a spec.`,reason:"Jira auto-load was attempted but did not return usable text, or Jira is not configured.",doNext:["Confirm the jira skill is active and authenticated.",'Or call tracker tools yourself, then run_test with spec: "inline:" + steps.'],validExample:{spec:"inline:1. Open https://example.com \u2026 2. Verify \u2026",ticketKey:i},invalidExample:{spec:i,ticketKey:i}}):JSON.stringify({error:`Test spec not found: ${i}`,hint:'If this should be issue steps, load the issue with your tracker tools first, then run_test with spec: "inline:" + steps. Otherwise use a real file path.'})}let a=wt(e?.options?.config);if(Ie()>=a){let l=vt(),p=s.ticketKey||l,m={runId:l,spec:s.ticketKey?`${s.ticketKey}: ${s.spec}`:s.spec,ticketKey:s.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};E.set(l,m),z.push({args:{...s,_queuedRunId:l},cwd:t,context:e}),T(p,"\u23F3",`Queued (${Ie()}/${a} running, ${z.length} queued)`);let d={runId:l,spec:m.spec,ticketKey:m.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${a} concurrent).`};return n&&(d.resolvedFromJiraIssue=n,d.message+=` (spec built from Jira ${n})`),JSON.stringify(d)}let c=Date.now()-Oe;c<dt&&Oe>0&&await new Promise(l=>setTimeout(l,dt-c)),Oe=Date.now();let u=It(s,t,e);return n?qs(u,{resolvedFromJiraIssue:n,message:`Spec was loaded from Jira issue ${n} (description + comments).`}):u}function It(r,t,e){let{spec:s,ticketKey:i,agent:n,headless:o,workflow:a,_queuedRunId:c}=r,u=c||vt(),l=s,p=!1;if(s.startsWith("inline:")){p=!0;let I=Es(t);pt(I,{recursive:!0}),l=J(I,`${u}.txt`),js(l,s.slice(7).trim(),"utf-8")}let m=Y(t,".zibby","output","runs");pt(m,{recursive:!0});let d=J(m,`${u}.log`),y=As(d,{flags:"a"}),g=n&&["assistant","cursor","claude","codex","gemini"].includes(n)?n:null,h=["test",l];g&&h.push("--agent",g),o&&h.push("--headless"),a&&h.push("--workflow",a),St&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${h.map(I=>/\s/.test(I)?JSON.stringify(I):I).join(" ")} cwd=${t}`);let k=bt("zibby",h,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),f={runId:u,spec:i?`${i}: ${s}`:s,ticketKey:i||null,specPath:l,logPath:d,isInline:p,pid:k.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},S=i||u,x="";function ze(I){let N=Nt(I).trim();if(!N)return;if(N.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let R=JSON.parse(N.slice(22));R.phase==="node_begin"?f.currentNode=R.node:R.phase==="node_end"&&(R.node&&!f.completedNodes.includes(R.node)&&f.completedNodes.push(R.node),f.currentNode===R.node&&(f.currentNode=null))}catch{}return}let ee=N.match(/Session\s+(\S+)/);if(ee&&!f.sessionId&&(f.sessionId=ee[1],f.sessionPath=Y(t,Re,$e,f.sessionId)),N.startsWith("\u250C ")||N.startsWith("\u250C ")){let R=N.slice(2).trim();f.currentNode=R,de&&T(S,"\u25B6",`${R}`)}else if(N.startsWith("\u2514 ")||N.startsWith("\u2514 ")){let R=N.slice(2).trim();R.startsWith("done")?(f.currentNode&&!f.completedNodes.includes(f.currentNode)&&f.completedNodes.push(f.currentNode),de&&T(S,"\u2714",`${f.currentNode||"node"} done ${R.replace("done","").trim()}`),f.currentNode=null):R.startsWith("failed")&&(de&&T(S,"\u2718",`${f.currentNode||"node"} failed ${R.replace("failed","").trim()}`),f.currentNode=null)}else N.includes("Workflow completed")&&(f.currentNode=null,de&&T(S,"\u2714",`Workflow completed (${mt(Date.now()-f.startTime)})`))}function hr(I){let N=I.toString();f.output+=N,y.write(N),f.output.length>5e4&&(f.output=f.output.slice(-3e4)),x+=N;let ee=x.split(`
|
|
327
|
+
`);x=ee.pop();for(let R of ee)ze(R)}return k.stdout.on("data",hr),k.stderr.on("data",I=>{let N=I.toString();f.error+=N,y.write(N),f.error.length>2e4&&(f.error=f.error.slice(-1e4))}),k.on("close",I=>{f.status=I===0?"passed":"failed",f.exitCode=I,f.endTime=Date.now(),x&&ze(x),y.end();let N=mt(Date.now()-f.startTime);if(I===0?T(S,"\u2705",`Passed (${N})`):T(S,"\u274C",`Failed (${N})`),f.isInline)try{xs(f.specPath)}catch{}ft()}),k.on("error",I=>{f.status="error",f.error+=`
|
|
328
|
+
Spawn error: ${I.message}`,T(S,"\u274C",`Spawn error: ${I.message}`),y.end(),ft()}),f._child=k,E.set(u,f),JSON.stringify({runId:u,spec:f.spec,ticketKey:f.ticketKey,status:"running",pid:k.pid,logFile:d})}function gt(r){let t=Math.round(((r.endTime||Date.now())-r.startTime)/1e3),e=r.completedNodes||[],s=r.currentNode||null;if(r.status!=="running")return{elapsed:t,stage:r.status,completedNodes:e,currentNode:null};let i;return s?(i=`Actively executing node "${s}"`,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:s,completedNodes:e,progress:i}}function Bs(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[...E.entries()].map(([l,p])=>{let m=gt(p),d={runId:l,spec:p.spec,ticketKey:p.ticketKey,status:p.status,elapsed:m.elapsed,exitCode:p.exitCode,sessionId:p.sessionId||null};return p.status==="running"?(d.currentNode=m.currentNode,d.completedNodes=m.completedNodes,d.progress=m.progress):d.outputTail=p.output.slice(-500),d}),o=n.filter(l=>l.status==="running").length,a=n.filter(l=>l.status==="passed").length,c=n.filter(l=>l.status==="failed").length,u={total:n.length,running:o,passed:a,failed:c,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=E.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let s=gt(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:s.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=s.currentNode,i.completedNodes=s.completedNodes,i.progress=s.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 _t(r,t){if(t.status==="queued"){let e=z.findIndex(s=>s.args._queuedRunId===r);return e>=0&&z.splice(e,1),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:r,status:"cancelled"}}if(t.status!=="running")return{ok:!1,runId:r,error:`Run is not active (status: ${t.status})`};try{return t._child.kill("SIGTERM"),t.status="cancelled",t.endTime=Date.now(),{ok:!0,runId:r,status:"cancelled"}}catch(e){return{ok:!1,runId:r,error:`Failed to cancel: ${e.message}`}}}function Fs(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let s=[];for(let[i,n]of E.entries())(n.status==="running"||n.status==="queued")&&s.push(_t(i,n));return s.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:s.length,results:s})}let e=E.get(t);return JSON.stringify(e?_t(t,e):{error:`Run not found: ${t}`})}function zs(r,t){let e=E.get(r);if(e?.sessionPath&&D(e.sessionPath))return e.sessionPath;if(e?.sessionId){let s=Y(t,Re,$e,e.sessionId);if(D(s))return s}return null}function $t(r,t=""){let e=[];if(!D(r))return e;for(let s of ye(r,{withFileTypes:!0})){let i=t?`${t}/${s.name}`:s.name;if(s.isDirectory())e.push(...$t(J(r,s.name),i));else{let n=Ts(J(r,s.name));e.push({path:i,size:n.size})}}return e}function kt(r){if(!D(r))return null;try{return JSON.parse(fe(r,"utf-8"))}catch{return null}}function Rt(r,t=2e3){if(!r||!D(r))return"";try{return fe(r,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function Ws({run:r,logTail:t,errorTail:e}){let i=`${t||""}
|
|
329
|
+
${e||""}`.toLowerCase(),n={runId:r?.runId||null,status:r?.status||null,exitCode:r?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return r?.status==="running"||r?.status==="queued"?{...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 Gs(r,t){let{runId:e,type:s,node:i="execute_live",query:n,tail:o=3e3}=r;if(s==="search"){if(!n)return JSON.stringify({error:'query is required for type="search"'});let c=Y(t,Re,$e);if(!D(c))return JSON.stringify({matches:[],message:"No sessions found"});let u=[],l=n.toLowerCase();for(let p of ye(c,{withFileTypes:!0})){if(!p.isDirectory())continue;let m=J(c,p.name),d=[{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:y,label:_}of d){let g=J(m,y);if(D(g))try{let h=fe(g,"utf-8");if(h.toLowerCase().includes(l)){let k=h.toLowerCase().indexOf(l),f=Math.max(0,k-100),S=Math.min(h.length,k+n.length+100);u.push({sessionId:p.name,artifact:_,snippet:h.slice(f,S)})}}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(s==="log"){let c=E.get(e),u=Rt(c?.logPath,o);if(u)return JSON.stringify({runId:e,source:"run-log",totalLength:u.length,tail:u})}let a=zs(e,t);if(!a)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(s){case"list":{let c=$t(a);return JSON.stringify({sessionId:a.split("/").pop(),files:c,total:c.length})}case"result":{let c=kt(J(a,i,"result.json"));return JSON.stringify(c?{sessionId:a.split("/").pop(),node:i,result:c}:{error:`No result.json found in ${i}`})}case"events":{let c=kt(J(a,i,"events.json"));if(!c)return JSON.stringify({error:`No events.json found in ${i}`});let u=Array.isArray(c)?c:c.events||[];return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalEvents:u.length,events:u.slice(-50)})}case"log":{let c=J(a,i,"raw_stream_output.txt");if(!D(c))return JSON.stringify({error:`No log found in ${i}`});let u=fe(c,"utf-8");return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalLength:u.length,tail:u.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${s}. Use: list, result, events, log, search`})}}function Hs(r,t){let e=String(r?.runId||"all"),s=Number(r?.tail||2e3),i=e==="all"?[...E.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let n=i.map(c=>{let u=E.get(c);if(!u)return{runId:c,error:`Run not found: ${c}`};let l=Rt(u.logPath,s),p=String(u.error||"").slice(-Math.max(200,s));return{...Ws({run:u,logTail:l,errorTail:p}),ticketKey:u.ticketKey||null,spec:u.spec,logTail:l,errorTail:p}}),o=n.filter(c=>c.status==="failed"||c.status==="error"),a=n.filter(c=>c.status==="running"||c.status==="queued");return JSON.stringify({total:n.length,failed:o.length,active:a.length,diagnoses:n})}function Ys(r,t){let e=r?.directory||"test-specs",s=Y(t,e);if(!D(s))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let n=function(o,a){for(let c of ye(o,{withFileTypes:!0})){let u=a?`${a}/${c.name}`:c.name;c.isDirectory()?n(J(o,c.name),u):(c.name.endsWith(".txt")||c.name.endsWith(".md"))&&i.push(u)}},i=[];return n(s,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}import{spawn as Zs}from"child_process";import{existsSync as U,mkdirSync as Vs,readdirSync as jt,statSync as Qs,readFileSync as Xs}from"fs";import{resolve as xe,join as P,basename as en}from"path";var Ae=".zibby/repos";function he(r,t,e={}){return new Promise((s,i)=>{let n=Zs(r,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",a="";n.stdout.on("data",c=>{o+=c.toString()}),n.stderr.on("data",c=>{a+=c.toString()}),n.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):s(o.trim())}),n.on("error",c=>i(c))})}var xt={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],promptFragment:`## Git Repositories
|
|
326
330
|
You can clone and explore git repositories locally for codebase analysis:
|
|
327
331
|
- git_checkout: Clone a repo (or pull if already cloned). Supports GitHub and GitLab with auto-auth.
|
|
328
332
|
- git_list_repos: List locally cloned repos
|
|
@@ -333,7 +337,7 @@ When a test ticket lacks context, use this workflow:
|
|
|
333
337
|
2. Use git_explore to understand the project structure
|
|
334
338
|
3. Use shell commands (grep, cat) to read specific files for deeper understanding
|
|
335
339
|
4. Use GitHub/GitLab skills to read related PRs and commits
|
|
336
|
-
5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await
|
|
340
|
+
5. Build well-informed test specs and save them to files before running tests`,resolve(){return null},async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await tn(t,s);case"git_list_repos":return rn(t,s);case"git_explore":return sn(t,s);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}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 tn(r,t){let{url:e,branch:s,shallow:i=!0,name:n}=r;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=n||en(e.replace(/\.git$/,"")),a=xe(t,Ae);Vs(a,{recursive:!0});let c=P(a,o),u=e,l=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,m=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(p&&m)try{let _=new URL(m).host;e.includes(_)&&(u=e.replace(`https://${_}`,`https://oauth2:${p}@${_}`))}catch{}if(U(P(c,".git"))){let _=s?`git -C "${c}" fetch origin ${s} && git -C "${c}" checkout ${s} && git -C "${c}" pull origin ${s}`:`git -C "${c}" pull`;await he(_,t);let g=await he(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:c,branch:s||"default",head:g})}let d=["git","clone"];i&&d.push("--depth","1"),s&&d.push("--branch",s),d.push(`"${u}"`,`"${c}"`),await he(d.join(" "),t);let y=await he(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:c,branch:s||"default",shallow:i,head:y})}function rn(r,t){let e=xe(t,Ae);if(!U(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let s=[];for(let i of jt(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let n=P(e,i.name);if(!U(P(n,".git")))continue;let o=Qs(n);s.push({name:i.name,path:n,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:s,total:s.length,directory:e})}function sn(r,t){let{repo:e,depth:s=2}=r,i=xe(t,Ae,e);if(!U(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let n={repo:e,path:i},o=P(i,"package.json");if(U(o))try{let d=JSON.parse(Xs(o,"utf-8"));n.packageJson={name:d.name,version:d.version,scripts:d.scripts?Object.keys(d.scripts):[],dependencies:d.dependencies?Object.keys(d.dependencies).slice(0,30):[],devDependencies:d.devDependencies?Object.keys(d.devDependencies).slice(0,20):[]},d.dependencies?.react?n.framework="React":d.dependencies?.next?n.framework="Next.js":d.dependencies?.vue?n.framework="Vue":d.dependencies?.angular?n.framework="Angular":d.dependencies?.express?n.framework="Express":d.dependencies?.fastify&&(n.framework="Fastify")}catch{}let a=P(i,"pyproject.toml");U(a)&&(n.language="Python");let c=P(i,"go.mod");U(c)&&(n.language="Go");let u=P(i,"Cargo.toml");U(u)&&(n.language="Rust"),U(o)&&(n.language=n.language||"JavaScript/TypeScript");let l=[];function p(d,y,_){if(_>s)return;let g;try{g=jt(d,{withFileTypes:!0})}catch{return}let h=g.filter(k=>!k.name.startsWith(".")&&k.name!=="node_modules"&&k.name!=="__pycache__"&&k.name!=="dist"&&k.name!=="build"&&k.name!==".git").sort((k,f)=>k.isDirectory()!==f.isDirectory()?k.isDirectory()?-1:1:k.name.localeCompare(f.name));for(let k of h){let f=k.isDirectory();l.push(`${y}${f?"\u{1F4C1}":"\u{1F4C4}"} ${k.name}`),f&&_<s&&p(P(d,k.name),`${y} `,_+1)}}p(i,"",1),n.tree=l.slice(0,80),l.length>80&&(n.treeTruncated=!0);let m=["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=m.filter(d=>U(P(i,d))),JSON.stringify(n)}import{execFileSync as Ut}from"child_process";import{existsSync as Pt,mkdirSync as nn}from"fs";import{join as re,basename as on}from"path";import{randomBytes as an}from"crypto";import{pathToFileURL as ke}from"url";import{createRequire as Mt}from"module";var At=".zibby/memory",qt="dolt",Kt={encoding:"utf-8",stdio:["pipe","pipe","pipe"],timeout:15e3},Ce="dolt",Te=new Map,ge=new Map,cn=Mt(import.meta.url),we=()=>an(8).toString("hex"),Z=()=>new Date().toISOString(),ln=[`CREATE TABLE IF NOT EXISTS chat_memory (
|
|
337
341
|
id VARCHAR(64) PRIMARY KEY,
|
|
338
342
|
memory_key VARCHAR(160),
|
|
339
343
|
category VARCHAR(32) NOT NULL,
|
|
@@ -364,10 +368,10 @@ When a test ticket lacks context, use this workflow:
|
|
|
364
368
|
tasks_failed INT DEFAULT 0,
|
|
365
369
|
key_facts TEXT,
|
|
366
370
|
created_at VARCHAR(32) NOT NULL
|
|
367
|
-
)`],
|
|
368
|
-
`)};`;
|
|
371
|
+
)`],Tt=new Set;function C(r,t){return Ut(qt,t,{...Kt,cwd:r})}function W(r,t){try{let e=C(r,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function L(r,t){C(r,["sql","-q",t])}function Et(r){if(Tt.has(r))return!0;if(!Pt(re(r,".dolt"))){if(!un())return!1;nn(r,{recursive:!0}),C(r,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let t=`${ln.join(`;
|
|
372
|
+
`)};`;L(r,t);try{L(r,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{L(r,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return Tt.add(r),!0}function un(){try{return Ut(qt,["version"],{...Kt,timeout:5e3}),!0}catch{return!1}}function w(r){return r==null?"NULL":`'${String(r).replace(/'/g,"''")}'`}function Le(r){return String(r||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function Q(r){return r==="long"?3:r==="mid"?2:r==="short"?1:0}function Je(r,t){let e=["short","mid","long"].includes(r)?r:"mid";return new Set(["fact","decision","preference","credential","url","workaround"]).has(String(t||"").toLowerCase())&&e==="short"?"mid":e}function Bt(r){let t=new Map;for(let e of r||[]){let s=Le(e.content),i=e.memory_key?`key:${e.memory_key}`:s?`norm:${s}`:"";if(!i)continue;let n=t.get(i);if(!n){t.set(i,e);continue}let o=Q(n.tier),a=Q(e.tier);if(a>o){t.set(i,e);continue}a===o&&Number(e.relevance||0)>Number(n.relevance||0)&&t.set(i,e)}return[...t.values()]}function be(r,t){let e=String(r??"");return e.length<=t?e:t<=1?e.slice(0,t):`${e.slice(0,t-1)}\u2026`}function _e(r,t){let e={recentSessions:Array.isArray(r?.recentSessions)?r.recentSessions:[],topMemories:Array.isArray(r?.topMemories)?r.topMemories:[],taskStats:Array.isArray(r?.taskStats)?r.taskStats:[],ticketFilter:r?.ticketFilter||null,backend:t||String(r?.backend||Ce),error:r?.error||null};return e.backend==="mem0"?{...e,recentSessions:[],taskStats:[]}:e}function pn(r){let t=[];if(r.recentSessions?.length>0){t.push("Recent sessions:");for(let e of r.recentSessions.slice(0,3))e?.summary?.trim()&&t.push(`- ${be(e.summary,150)}${e.tickets?` [${e.tickets}]`:""}`)}if(r.topMemories?.length>0){t.push("Known facts:");for(let e of r.topMemories.slice(0,10)){let s=e.tier==="long"?"\u2605":"\xB7";t.push(`${s} [${e.category}] ${be(e.content,120)}`)}}return t.length===0?"":`## Memory Context
|
|
369
373
|
${t.join(`
|
|
370
|
-
`)}`}function
|
|
374
|
+
`)}`}function Ee(r){return{backend:r.backend,recentSessions:r.recentSessions.slice(0,3).map(t=>({summary:be(String(t?.summary||""),160),tickets:t?.tickets||null,created_at:t?.created_at||null})),topMemories:r.topMemories.slice(0,8).map(t=>({category:t?.category||null,tier:t?.tier||null,content:be(String(t?.content||""),140),source:t?.source||null})),taskStats:r.taskStats,error:r.error||null}}async function Ct(r,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let s=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(s==="mem0"||s==="dolt")return s;if(ge.has(r))return ge.get(r);try{let i=re(r,".zibby.config.mjs");if(Pt(i)){let n=await import(ke(i).href),o=String(n?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return ge.set(r,o),o}}catch{}return ge.set(r,Ce),Ce}function Ft(r){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${on(r||process.cwd())}`}function dn(){let r=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!r)return null;let t=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),e=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),s=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),i=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536);return{llm:{provider:"openai",config:{model:e,baseURL:r,...t?{apiKey:t}:{}}},embedder:{provider:"openai",config:{model:s,embeddingDims:i,baseURL:r,...t?{apiKey:t}:{}}},vectorStore:{provider:"memory",config:{dimension:i}}}}async function zt(r){let t=r||process.cwd();if(Te.has(t))return Te.get(t);let e;try{let a=Mt(ke(re(t,"package.json")).href).resolve("mem0ai/oss");e=await import(ke(a).href)}catch{try{let o=cn.resolve("mem0ai/oss");e=await import(ke(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 s=e?.Memory;if(!s)throw new Error("mem0ai/oss does not export Memory");let i=dn(),n=i?new s(i):new s;return Te.set(t,n),n}function Lt(r,t="mid"){return(Array.isArray(r)?r:Array.isArray(r?.results)?r.results:[]).map(s=>({id:s?.id||we(),memory_key:s?.metadata?.memoryKey||s?.metadata?.memory_key||null,category:s?.metadata?.category||"fact",content:s?.memory||s?.content||"",source:s?.metadata?.source||"mem0",ticket_key:s?.metadata?.ticketKey||s?.metadata?.ticket_key||null,tier:Je(s?.metadata?.tier||t,s?.metadata?.category||"fact"),relevance:Number(s?.score??s?.metadata?.relevance??.8),created_at:s?.created_at||s?.metadata?.created_at||Z()})).filter(s=>String(s.content||"").trim().length>0)}var Wt={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
|
|
371
375
|
You have persistent memory across sessions. Use it to avoid losing context:
|
|
372
376
|
- **memory_store**: Save important facts, decisions, or context. Anything worth remembering.
|
|
373
377
|
- **memory_recall**: Search your memory by keyword or category. Use this at the START of conversations to recall relevant context.
|
|
@@ -383,38 +387,38 @@ You have persistent memory across sessions. Use it to avoid losing context:
|
|
|
383
387
|
- When the user's request is complete: call memory_end_session
|
|
384
388
|
|
|
385
389
|
### Categories for memory_store
|
|
386
|
-
fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(r,t={}){let e=r?.options?.workspace||process.cwd(),s=
|
|
390
|
+
fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(r,t={}){let e=r?.options?.workspace||process.cwd(),s=re(e,At),i=await Ct(e,r);if(i==="dolt"&&!Et(s)){let n="Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation";return{backend:i,brief:_e({backend:i,error:n},i),promptContext:"",debugPreview:Ee(_e({backend:i,error:n},i)),error:n}}try{let n=i==="mem0"?await Dt(t,s,e):Jt(t,s),o=JSON.parse(n||"{}"),a=_e({...o,backend:i},i);return{backend:i,brief:a,promptContext:pn(a),debugPreview:Ee(a),error:a.error||null}}catch(n){let o=String(n?.message||n),a=_e({backend:i,error:o},i);return{backend:i,brief:a,promptContext:"",debugPreview:Ee(a),error:o}}},async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd(),i=re(s,At),n=await Ct(s,e);if((n==="dolt"||["memory_end_session","task_log","task_history"].includes(r))&&!Et(i))return JSON.stringify({error:"Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation"});try{switch(r){case"memory_store":return n==="mem0"?await mn(t,i,s):Gt(t,i);case"memory_recall":return n==="mem0"?await Ht(t,i,s):fn(t,i);case"memory_brief":return n==="mem0"?await Dt(t,i,s):Jt(t,i);case"memory_end_session":return yn(t,i);case"task_log":return hn(t,i);case"task_history":return gn(t,i);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(a){if(n==="mem0")throw new Error(`mem0 throw: ${a.message}`,{cause:a});return JSON.stringify({error:a.message})}},tools:[{name:"memory_store",description:"Save a fact, decision, or context to persistent memory. Survives across sessions.",input_schema:{type:"object",properties:{memoryKey:{type:"string",description:"Stable semantic identity key (e.g. user.jira.default_board)"},content:{type:"string",description:"The information to remember"},category:{type:"string",enum:["fact","decision","context","insight","preference","credential","url","error","workaround"],description:"Category of memory"},tier:{type:"string",enum:["short","mid","long"],description:"Memory tier: short (session/24h), mid (days/weeks), long (permanent)"},source:{type:"string",description:'Where this info came from (e.g. "jira", "github", "user", "test_run")'},ticketKey:{type:"string",description:"Related ticket key (optional)"}},required:["content","category"]}},{name:"memory_recall",description:"Search persistent memory by keyword, category, ticket, or tier. Returns matching facts and context.",input_schema:{type:"object",properties:{query:{type:"string",description:"Search text (matches content)"},category:{type:"string",description:"Filter by category"},ticketKey:{type:"string",description:"Filter by ticket key"},tier:{type:"string",enum:["short","mid","long"],description:"Filter by memory tier"},limit:{type:"number",description:"Max results (default: 20)"}}}},{name:"memory_brief",description:"Get a compact briefing: recent session summaries + top relevant facts. Call at the start of a conversation.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Focus briefing on a specific ticket (optional)"}}}},{name:"memory_end_session",description:"End the current session and save a summary for future recall. Call when a task is complete.",input_schema:{type:"object",properties:{summary:{type:"string",description:"What happened in this session (1-3 sentences)"},tickets:{type:"string",description:"Comma-separated ticket keys covered"},tasksRun:{type:"number",description:"Number of tasks/tests run"},tasksPassed:{type:"number",description:"Number passed"},tasksFailed:{type:"number",description:"Number failed"},keyFacts:{type:"string",description:"Key facts worth remembering from this session (semicolon-separated)"}},required:["summary"]}},{name:"task_log",description:"Record a completed task (test run, analysis, generation) to persistent history.",input_schema:{type:"object",properties:{title:{type:"string",description:"Task description"},type:{type:"string",enum:["test_run","generate","analysis","research","other"],description:"Task type"},status:{type:"string",enum:["passed","failed","cancelled","error"],description:"Outcome"},ticketKey:{type:"string",description:"Related ticket key"},specPath:{type:"string",description:"Spec file path (if test run)"},resultSummary:{type:"string",description:"Brief result description"}},required:["title","type","status"]}},{name:"task_history",description:"Query past tasks by ticket, status, or type. See what was done before.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Filter by ticket key"},type:{type:"string",description:"Filter by task type"},status:{type:"string",description:"Filter by status"},limit:{type:"number",description:"Max results (default: 20)"}}}}]};function Gt(r,t){let{content:e,category:s,source:i,ticketKey:n,tier:o,memoryKey:a}=r;if(!e||!s)return JSON.stringify({error:"content and category are required"});let c=Le(e);if(!c)return JSON.stringify({error:"content is empty after normalization"});let u=Je(o,s),l=u==="long"?1:u==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let h=W(t,`SELECT id, tier, relevance
|
|
387
391
|
FROM chat_memory
|
|
388
392
|
WHERE memory_key = ${w(p)}
|
|
389
393
|
ORDER BY created_at DESC
|
|
390
|
-
LIMIT 1`)[0];if(
|
|
394
|
+
LIMIT 1`)[0];if(h){let k=String(h.tier||"mid"),f=Number(h.relevance||0),S=Q(u)>Q(k)?u:k,x=Math.max(l,f);L(t,`UPDATE chat_memory
|
|
391
395
|
SET content = ${w(e)},
|
|
392
396
|
category = ${w(s)},
|
|
393
|
-
source = ${w(
|
|
394
|
-
ticket_key = ${w(
|
|
395
|
-
tier = ${w(
|
|
396
|
-
relevance = ${
|
|
397
|
-
created_at = ${w(
|
|
398
|
-
WHERE id = ${w(
|
|
397
|
+
source = ${w(i)},
|
|
398
|
+
ticket_key = ${w(n)},
|
|
399
|
+
tier = ${w(S)},
|
|
400
|
+
relevance = ${x},
|
|
401
|
+
created_at = ${w(Z())}
|
|
402
|
+
WHERE id = ${w(h.id)}`);try{C(t,["add","."]),C(t,["commit","-m",`memory upsert: ${s} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:h.id,category:s,tier:S,memoryKey:p,upserted:!0})}}let d=W(t,`SELECT id, content, tier, relevance
|
|
399
403
|
FROM chat_memory
|
|
400
404
|
WHERE category = ${w(s)}
|
|
401
405
|
ORDER BY created_at DESC
|
|
402
|
-
LIMIT 200`).find(
|
|
403
|
-
SET tier = ${w(
|
|
404
|
-
relevance = ${Math.max(
|
|
405
|
-
WHERE id = ${w(
|
|
406
|
-
VALUES (${w(
|
|
406
|
+
LIMIT 200`).find(g=>Le(g.content)===c);if(d){let g=String(d.tier||"mid"),h=Number(d.relevance||0),k=Q(u)>Q(g),f=l>h;if(k||f){L(t,`UPDATE chat_memory
|
|
407
|
+
SET tier = ${w(k?u:g)},
|
|
408
|
+
relevance = ${Math.max(l,h)}
|
|
409
|
+
WHERE id = ${w(d.id)}`);try{C(t,["add","."]),C(t,["commit","-m",`memory promote: ${s} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:d.id,category:s,tier:k?u:g,deduped:!0,promoted:!0})}return JSON.stringify({ok:!0,id:d.id,category:s,tier:g,deduped:!0,promoted:!1})}let y=we(),_=process.env.ZIBBY_CHAT_SESSION_ID||null;L(t,`INSERT INTO chat_memory (id, memory_key, category, content, source, ticket_key, session_id, tier, relevance, created_at)
|
|
410
|
+
VALUES (${w(y)}, ${w(p||null)}, ${w(s)}, ${w(e)}, ${w(i)}, ${w(n)}, ${w(_)}, ${w(u)}, ${l}, ${w(Z())})`);try{C(t,["add","."]),C(t,["commit","-m",`memory: ${s} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:y,category:s,tier:u,memoryKey:p||null,stored:e.slice(0,100)})}async function mn(r,t,e){let{content:s,category:i,source:n,ticketKey:o,tier:a,memoryKey:c}=r;if(!s||!i)return JSON.stringify({error:"content and category are required"});try{let u=await zt(e),l=Ft(e),p=Je(a,i);return await u.add([{role:"user",content:String(s)}],{userId:l,metadata:{memoryKey:c||null,category:i,tier:p,source:n||"zibby-chat",ticketKey:o||null,created_at:Z()}}),JSON.stringify({ok:!0,backend:"mem0",userId:l,category:i,tier:p,memoryKey:c||null,stored:String(s).slice(0,100)})}catch(u){throw new Error(`mem0 store failed: ${u.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:u})}}function fn(r,t){let{query:e,category:s,ticketKey:i,tier:n,limit:o=20}=r,a=[];e&&a.push(`content LIKE ${w(`%${e}%`)}`),s&&a.push(`category = ${w(s)}`),i&&a.push(`ticket_key = ${w(i)}`),n&&a.push(`tier = ${w(n)}`);let u=`SELECT id, memory_key, category, content, source, ticket_key, tier, relevance, created_at
|
|
407
411
|
FROM chat_memory ${a.length>0?`WHERE ${a.join(" AND ")}`:""}
|
|
408
412
|
ORDER BY relevance DESC, created_at DESC
|
|
409
|
-
LIMIT ${o}`,
|
|
410
|
-
FROM chat_sessions ORDER BY created_at DESC LIMIT 5`),
|
|
411
|
-
WHERE tier = 'long' ${
|
|
412
|
-
WHERE tier = 'mid' ${
|
|
413
|
-
GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),
|
|
414
|
-
VALUES (${w(c)}, ${w(e)}, ${w(s)}, ${
|
|
415
|
-
VALUES (${w(c)}, ${w(
|
|
413
|
+
LIMIT ${o}`,l=W(t,u);return JSON.stringify({total:l.length,memories:l})}async function Ht(r,t,e){let{query:s,category:i,ticketKey:n,tier:o,limit:a=20}=r;try{let c=await zt(e),u=Ft(e),l=[];if(s&&String(s).trim()){let p=await c.search(String(s),{userId:u,limit:a});l=Lt(p)}else{let p=await c.getAll({userId:u,limit:Math.max(a,50)});l=Lt(p)}return i&&(l=l.filter(p=>p.category===i)),n&&(l=l.filter(p=>p.ticket_key===n)),o&&(l=l.filter(p=>p.tier===o)),l=l.slice(0,a),JSON.stringify({total:l.length,memories:l,backend:"mem0"})}catch(c){throw new Error(`mem0 recall failed: ${c.message}. If mem0 is not installed, run: npm install mem0ai`,{cause:c})}}function Jt(r,t){let{ticketKey:e}=r;kn(t);let i=W(t,`SELECT session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, created_at
|
|
414
|
+
FROM chat_sessions ORDER BY created_at DESC LIMIT 5`),n=e?`AND ticket_key = ${w(e)}`:"",o=W(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
|
|
415
|
+
WHERE tier = 'long' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 10`),a=W(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
|
|
416
|
+
WHERE tier = 'mid' ${n} ORDER BY relevance DESC, created_at DESC LIMIT 8`),u=W(t,`SELECT type, status, COUNT(*) as cnt FROM chat_tasks
|
|
417
|
+
GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),l=Bt([...o,...a]);return JSON.stringify({recentSessions:i,topMemories:l,taskStats:u,ticketFilter:e||null})}async function Dt(r,t,e){let{ticketKey:s}=r,i=await Ht({limit:80},t,e),n=JSON.parse(i||"{}"),o=Array.isArray(n.memories)?n.memories:[];s&&(o=o.filter(m=>m.ticket_key===s));let a=m=>{let d=Date.parse(String(m?.created_at||""))||0;return Number(m?.relevance||0)*1e12+d},c=(m,d)=>a(d)-a(m),u=o.filter(m=>m.tier==="long").sort(c).slice(0,10),l=o.filter(m=>m.tier==="mid").sort(c).slice(0,8),p=Bt([...u,...l]);return JSON.stringify({recentSessions:[],topMemories:p,taskStats:[],ticketFilter:s||null,backend:"mem0"})}function yn(r,t){let{summary:e,tickets:s,tasksRun:i=0,tasksPassed:n=0,tasksFailed:o=0,keyFacts:a}=r;if(!e)return JSON.stringify({error:"summary is required"});let c=process.env.ZIBBY_CHAT_SESSION_ID||`session_${we()}`;if(L(t,`INSERT INTO chat_sessions (session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, key_facts, created_at)
|
|
418
|
+
VALUES (${w(c)}, ${w(e)}, ${w(s)}, ${i}, ${n}, ${o}, ${w(a)}, ${w(Z())})`),a)for(let u of a.split(";").map(l=>l.trim()).filter(Boolean))Gt({content:u,category:"fact",source:"session_summary",tier:"mid"},t);_n(t);try{C(t,["add","."]),C(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:c,summary:e.slice(0,200)})}function hn(r,t){let{title:e,type:s,status:i,ticketKey:n,specPath:o,resultSummary:a}=r;if(!e||!s||!i)return JSON.stringify({error:"title, type, and status are required"});let c=we(),u=process.env.ZIBBY_CHAT_SESSION_ID||null;L(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
|
|
419
|
+
VALUES (${w(c)}, ${w(n)}, ${w(s)}, ${w(e)}, ${w(i)}, ${w(o)}, ${w(u)}, ${w(a)}, ${w(Z())}, ${w(Z())})`);try{C(t,["add","."]),C(t,["commit","-m",`task: ${i} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:c,title:e,type:s,status:i})}function gn(r,t){let{ticketKey:e,type:s,status:i,limit:n=20}=r,o=[];e&&o.push(`ticket_key = ${w(e)}`),s&&o.push(`type = ${w(s)}`),i&&o.push(`status = ${w(i)}`);let c=`SELECT id, ticket_key, type, title, status, spec_path, result_summary, created_at, finished_at
|
|
416
420
|
FROM chat_tasks ${o.length>0?`WHERE ${o.join(" AND ")}`:""}
|
|
417
|
-
ORDER BY created_at DESC LIMIT ${
|
|
421
|
+
ORDER BY created_at DESC LIMIT ${n}`,u=W(t,c);return JSON.stringify({total:u.length,tasks:u})}function _n(r){try{L(r,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),L(r,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),L(r,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),L(r,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function kn(r){try{let t=new Date(Date.now()-864e5).toISOString();L(r,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${w(t)}`)}catch{}}import{existsSync as q,readFileSync as ne,readdirSync as De,mkdirSync as bn,writeFileSync as X,statSync as Vt}from"fs";import{join as v,resolve as Ue,relative as Qt,dirname as Xt}from"path";import{fileURLToPath as wn}from"url";import{createRequire as Sn}from"module";var vn=Sn(import.meta.url),Nn=`## Workflow Builder
|
|
418
422
|
|
|
419
423
|
You can help users build custom AI workflows using the Zibby workflow framework.
|
|
420
424
|
|
|
@@ -524,9 +528,9 @@ Call with no arguments to see all available topics.
|
|
|
524
528
|
- Workflow names must be kebab-case (e.g., ticket-triage, pr-review).
|
|
525
529
|
- State flows through: each node's validated output is stored under its name in state (e.g., state.classify_ticket).
|
|
526
530
|
- Downstream nodes reference upstream outputs in their prompt function (e.g., \\\`\\\${JSON.stringify(state.classify_ticket, null, 2)}\\\`).
|
|
527
|
-
- Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,
|
|
531
|
+
- Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,er=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function tr(r){return`${r.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function se(r){return`${r.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function On(r){let t=r?.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 In(r){let t=Ue(r,".zibby.config.mjs");if(!q(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function $n(){try{let r=Xt(vn.resolve("@zibby/core/package.json")),t=v(r,"templates","browser-test-automation"),e=ne(v(t,"nodes","preflight.mjs"),"utf-8"),s=ne(v(t,"graph.mjs"),"utf-8");return{preflight:e,graph:s}}catch{return null}}var Yt=Xt(wn(import.meta.url));function rr(){let r=Ue(Yt,"..","..","..","docsite","docs");if(q(r))return r;let t=Ue(Yt,"..","docs");return q(t)?t:null}function Zt(){let r=rr();if(!r)return[];try{let t=(e,s="")=>{let i=[];for(let n of De(e)){let o=v(e,n);try{if(Vt(o).isDirectory())i=i.concat(t(o,`${s}${n}/`));else if(n.endsWith(".md")){let a=`${s}${n.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return t(r)}catch{return[]}}function sr(r){let t=rr();if(!t)return null;let e=v(t,`${r}.md`);if(!q(e))return null;try{return ne(e,"utf-8")}catch{return null}}function Rn(r){let t=r.nodes.map(o=>{let a=o.inputFields?.length?`Input fields: ${o.inputFields.join(", ")}`:"Input: receives full state",c=o.outputFields?.length?`Output fields: ${o.outputFields.join(", ")}`:"Output: determined by task",u=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${a}. ${c}.${u?` ${u}`:""}`}).join(`
|
|
528
532
|
`),e=r.edges.map(o=>o.condition?`- ${o.from} \u2192 ${o.to} (conditional: ${o.condition})`:`- ${o.from} \u2192 ${o.to}`).join(`
|
|
529
|
-
`),s
|
|
533
|
+
`),s=$n(),i=sr("custom-workflows"),n="";return s&&(n+=`
|
|
530
534
|
## Real working examples from the Zibby framework
|
|
531
535
|
|
|
532
536
|
### Example node (preflight.mjs) \u2014 a prompt-only node with Zod schema and onComplete hook:
|
|
@@ -540,9 +544,9 @@ ${s.graph}
|
|
|
540
544
|
\`\`\`
|
|
541
545
|
|
|
542
546
|
Study these examples carefully. Your generated code must follow the same patterns exactly.
|
|
543
|
-
`),
|
|
547
|
+
`),i&&(n+=`
|
|
544
548
|
## Full framework documentation (Custom Workflows)
|
|
545
|
-
${
|
|
549
|
+
${i}
|
|
546
550
|
`),`Generate the code for a Zibby workflow called "${r.name}".
|
|
547
551
|
|
|
548
552
|
## Zibby Workflow Framework Reference
|
|
@@ -580,7 +584,7 @@ SKILLS.BROWSER, SKILLS.MEMORY, SKILLS.GITHUB, SKILLS.JIRA, SKILLS.SLACK, SKILLS.
|
|
|
580
584
|
- Export name: camelCase + "Node" (e.g., \`classifyTicketNode\` for name \`classify_ticket\`)
|
|
581
585
|
- Prompt function: template literal referencing \`state.input\` and upstream \`state.<node_name>\`
|
|
582
586
|
- Prompts must be detailed \u2014 tell the agent exactly what to analyze/produce
|
|
583
|
-
${
|
|
587
|
+
${n}
|
|
584
588
|
## Workflow to generate: "${r.name}"
|
|
585
589
|
|
|
586
590
|
### Description
|
|
@@ -603,7 +607,7 @@ Return a JSON object with this exact structure:
|
|
|
603
607
|
}
|
|
604
608
|
}
|
|
605
609
|
|
|
606
|
-
IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function
|
|
610
|
+
IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function nr(r,t){let e=await In(t),s=On(e);try{let{invokeAgent:i}=await import("@zibby/core"),n=Rn(r),o=await i(n,{state:{agentType:s,config:e,cwd:t,workspace:t}},{model:e?.agent?.[s]?.model||"auto",workspace:t,config:e,timeout:12e4}),c=(typeof o=="string"?o:o?.raw||JSON.stringify(o?.structured||o)).match(/\{[\s\S]*\}/);if(!c)throw new Error("Agent did not return valid JSON");return JSON.parse(c[0])}catch(i){return console.warn(`Agent code generation failed (${i.message}), using templates`),jn(r)}}function jn(r){let t={};for(let e of r.nodes){let s=se(e.name),i=`${e.name.split("_").map(c=>c.charAt(0).toUpperCase()+c.slice(1)).join("")}OutputSchema`,n=e.outputFields?.length?e.outputFields.map(c=>` ${c}: z.string().describe('${c}'),`).join(`
|
|
607
611
|
`):` summary: z.string().describe('Summary of the result'),
|
|
608
612
|
status: z.enum(['ok', 'warn', 'error']).describe('Overall status'),`,o=r.edges.filter(c=>c.to===e.name&&c.from!=="START").map(c=>`Previous step (${c.from}): \${JSON.stringify(state.${c.from} || {}, null, 2)}`).join(`
|
|
609
613
|
`),a=o?`${e.description}
|
|
@@ -616,40 +620,50 @@ ${o}`:`${e.description}
|
|
|
616
620
|
Input:
|
|
617
621
|
\${JSON.stringify(state.input || {}, null, 2)}`;t[e.name]={code:`import { z } from '@zibby/core';
|
|
618
622
|
|
|
619
|
-
const ${
|
|
620
|
-
${
|
|
623
|
+
const ${i} = z.object({
|
|
624
|
+
${n}
|
|
621
625
|
});
|
|
622
626
|
|
|
623
627
|
export const ${s} = {
|
|
624
628
|
name: '${e.name}',
|
|
625
629
|
prompt: (state) => \`${a}\`,
|
|
626
|
-
outputSchema: ${
|
|
630
|
+
outputSchema: ${i},
|
|
627
631
|
};
|
|
628
|
-
`}}return{nodes:t}}function
|
|
632
|
+
`}}return{nodes:t}}function xn(r,t,e,s){let i=t.toLowerCase(),n=tr(i),o=v(r,".zibby","workflows",i),a=v(o,"nodes");bn(a,{recursive:!0});let c=e.nodes.map(h=>h.name);for(let h of e.nodes){let k=s.nodes?.[h.name]?.code;k&&X(v(a,`${h.name.replace(/_/g,"-")}.mjs`),k,"utf-8")}let u=c.map(h=>{let k=se(h),f=h.replace(/_/g,"-");return`export { ${k} } from './${f}.mjs';`});X(v(a,"index.mjs"),`${u.join(`
|
|
629
633
|
`)}
|
|
630
|
-
`,"utf-8");let
|
|
631
|
-
`),
|
|
632
|
-
${
|
|
633
|
-
});`:` graph.addEdge('${
|
|
634
|
-
`),
|
|
634
|
+
`,"utf-8");let l=c[0],p=c.map(h=>se(h)).join(", "),m=c.map(h=>` graph.addNode('${h}', ${se(h)});`).join(`
|
|
635
|
+
`),d=e.edges.map(h=>h.condition?` graph.addConditionalEdges('${h.from}', (state) => {
|
|
636
|
+
${h.condition}
|
|
637
|
+
});`:` graph.addEdge('${h.from}', '${h.to}');`).join(`
|
|
638
|
+
`),y=`import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
|
635
639
|
import { ${p} } from './nodes/index.mjs';
|
|
636
640
|
|
|
637
|
-
export class ${
|
|
641
|
+
export class ${n} extends WorkflowAgent {
|
|
638
642
|
buildGraph() {
|
|
639
643
|
const graph = new WorkflowGraph();
|
|
640
644
|
|
|
641
|
-
${y}
|
|
642
|
-
|
|
643
|
-
graph.setEntryPoint('${u}');
|
|
644
645
|
${m}
|
|
645
646
|
|
|
647
|
+
graph.setEntryPoint('${l}');
|
|
648
|
+
${d}
|
|
649
|
+
|
|
646
650
|
return graph;
|
|
647
651
|
}
|
|
648
652
|
|
|
649
653
|
async onComplete(result) {
|
|
650
|
-
console.log(\`[${
|
|
654
|
+
console.log(\`[${i}] workflow complete \u2014 success: \${result.success !== false}\`);
|
|
651
655
|
}
|
|
652
656
|
}
|
|
653
|
-
`;
|
|
654
|
-
`,"utf-8");let
|
|
655
|
-
`,_=P(k)?ee(k,"utf-8"):"";return _.includes(h)||Y(k,_+g,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:h,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function pn(r,t){let{name:e,projectId:s}=r,n=(e||"").toLowerCase();if(!n)return JSON.stringify({error:"Workflow name is required."});if(!s)return JSON.stringify({error:"projectId is required."});let i=S(t,".zibby","workflows",n);if(!P(i))return JSON.stringify({error:`Workflow "${n}" not found at .zibby/workflows/${n}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${S(t,"packages/cli/bin/zibby.js")}" deploy ${n} --project ${s}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch{try{let{execSync:a}=await import("child_process"),c=a(`npx zibby deploy ${n} --project ${s}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch(a){return JSON.stringify({error:`Deploy failed: ${a.message}`})}}}function dn(r){let t=S(r,".zibby","workflows");if(!P(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let s=Ee(t).filter(n=>{try{return Ut(S(t,n)).isDirectory()}catch{return!1}}).map(n=>{let i=S(t,n,"workflow.json"),o={};try{o=JSON.parse(ee(i,"utf-8"))}catch{}let a=S(t,n,"nodes"),c=0;try{c=Ee(a).filter(l=>l.endsWith(".mjs")&&l!=="index.mjs").length}catch{}return{name:n,description:o.description||"",nodeCount:c,path:qt(r,S(t,n))}});return JSON.stringify({workflows:s})}var Ht={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(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await cn(t);case"build_workflow":return await ln(t,s);case"add_node":return await un(t,s);case"deploy_workflow":return await pn(t,s);case"list_workflows":return dn(s);case"explore_framework_docs":{let n=(t.topic||"").trim();if(!n){let o=Pt();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let i=Wt(n);if(!i){let o=Pt();return JSON.stringify({error:`Doc "${n}" not found.`,available:o})}return JSON.stringify({topic:n,content:i})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(n){return JSON.stringify({error:n.message})}},resolve(){return null}};import{createRequire as mn}from"module";import{fileURLToPath as fn}from"url";import{registerHandlers as yn}from"@zibby/core/function-skill-registry.js";import{registerSkill as gn}from"@zibby/agent-workflow";var hn=mn(import.meta.url);function _n(){try{return hn.resolve("@zibby/core/function-bridge.js")}catch{return null}}var kn=import.meta.url;function wn(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(s,n)=>n;let e=new Error().stack;for(let s=2;s<e.length;s++){let n=e[s].getFileName();if(n&&n!==kn&&!n.startsWith("node:"))return n.startsWith("file://")?fn(n):n}return null}finally{Error.prepareStackTrace=r}}function bn(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[s,n]of Object.entries(r))if(typeof n=="string")t[s]={type:n},e.push(s);else{let{required:i,...o}=n;t[s]=o,i!==!1&&e.push(s)}return{type:"object",properties:t,required:e}}function Sn(r,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let s={[r]:e.handler},n=[{name:r,description:e.description||"",input_schema:bn(e.input)}];return yn(r,s,n),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:e.description||`Function skill: ${r}`,envKeys:[],tools:n,resolve(){let i=_n();return i?{command:"node",args:[i,t,r]}:null}}}function vn(r,t){return{id:r,type:"mcp",serverName:t.serverName||r,allowedTools:t.allowedTools||[`mcp__${t.serverName||r}__*`],description:t.description||`MCP skill: ${r}`,envKeys:t.envKeys||[],tools:t.tools||[],resolve:t.resolve,...t.cursorKey&&{cursorKey:t.cursorKey},...t.sessionEnvKey&&{sessionEnvKey:t.sessionEnvKey}}}function Yt(r,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let s=wn();if(!s)throw new Error(`Could not resolve caller file for skill "${r}".`);e=Sn(r,s,t)}else if(typeof t.resolve=="function")e=vn(r,t);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return gn(e),e}var Nn=Yt;import{registerSkill as so,getSkill as ro,hasSkill as no,getAllSkills as io,listSkillIds as oo}from"@zibby/agent-workflow";T(Le);T(Me);T(Ue);T(_e);T(Ke);T(ie);T(Fe);T(ft);T(kt);T(We);T(Ve);T(Lt);T(Ht);T({..._e,id:"slack_notify"});var Qi={BROWSER:"browser",JIRA:"jira",GITHUB:"github",GIT:"git",SLACK:"slack",LARK:"lark",SENTRY:"sentry",MEMORY:"memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools",CHAT_MEMORY:"chat-memory",WORKFLOW_BUILDER:"workflow-builder"};export{x as INTEGRATIONS,is as INTEGRATION_REGISTRY,Qi as SKILLS,Le as browserSkill,Lt as chatMemorySkill,Ve as coreToolsSkill,Nn as functionSkill,io as getAllSkills,ro as getSkill,kt as gitSkill,Ue as githubSkill,no as hasSkill,Me as jiraSkill,Ke as larkSkill,oo as listSkillIds,Fe as memorySkill,so as registerSkill,ft as runnerSkill,ie as sentrySkill,Yt as skill,We as skillInstallerSkill,_e as slackSkill,ft as testRunnerSkill,Ht as workflowBuilderSkill};
|
|
657
|
+
`;X(v(o,"graph.mjs"),y,"utf-8");let _={name:i,description:e.description||`${n} workflow`,entryClass:n,triggers:{api:!0}};X(v(o,"workflow.json"),`${JSON.stringify(_,null,2)}
|
|
658
|
+
`,"utf-8");let g=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(h=>`nodes/${h.replace(/_/g,"-")}.mjs`)];return{workflowDir:Qt(r,o),files:g,className:n,slug:i}}async function An(r){let{name:t,description:e,nodes:s,edges:i}=r;if(!t||!er.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!s||s.length===0)return JSON.stringify({error:"At least one node is required."});let n={name:t.toLowerCase(),description:e||`${tr(t.toLowerCase())} workflow`,nodes:s.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 Tn(r,t){let{name:e,spec:s}=r,i=(e||s?.name||"").toLowerCase();if(!i||!er.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!s||!s.nodes||s.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let n=v(t,".zibby","workflows",i);if(q(n))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await nr(s,t),a=xn(t,i,s,o);return JSON.stringify({ok:!0,...a,message:`Workflow "${i}" created at ${a.workflowDir}/`,nextSteps:[`Test locally: zibby start ${i}`,`Deploy to cloud: zibby deploy ${i} --project <project-id>`,`Tail logs: zibby logs --workflow ${i} --project <project-id>`]})}async function En(r,t){let{workflowName:e,nodeName:s,description:i,inputFields:n,outputFields:o}=r,a=(e||"").toLowerCase(),c=(s||"").replace(/-/g,"_"),u=v(t,".zibby","workflows",a);if(!q(u))return JSON.stringify({error:`Workflow "${a}" not found. Create it first with build_workflow.`});let l={name:a,description:"",nodes:[{name:c,description:i||`Process ${c}`,inputFields:n||[],outputFields:o||[]}],edges:[]},m=(await nr(l,t)).nodes?.[c]?.code;if(!m)return JSON.stringify({error:"Failed to generate node code."});let d=v(u,"nodes"),y=`${c.replace(/_/g,"-")}.mjs`;X(v(d,y),m,"utf-8");let _=v(d,"index.mjs"),g=se(c),h=`export { ${g} } from './${c.replace(/_/g,"-")}.mjs';
|
|
659
|
+
`,k=q(_)?ne(_,"utf-8"):"";return k.includes(g)||X(_,k+h,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${y}`,exportName:g,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Cn(r,t){let{name:e,projectId:s}=r,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!s)return JSON.stringify({error:"projectId is required."});let n=v(t,".zibby","workflows",i);if(!q(n))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${v(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${s}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:a.trim()})}catch{try{let{execSync:a}=await import("child_process"),c=a(`npx zibby deploy ${i} --project ${s}`,{cwd:t,encoding:"utf-8",timeout:3e4,stdio:["pipe","pipe","pipe"]});return JSON.stringify({ok:!0,output:c.trim()})}catch(a){return JSON.stringify({error:`Deploy failed: ${a.message}`})}}}function Ln(r){let t=v(r,".zibby","workflows");if(!q(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let s=De(t).filter(i=>{try{return Vt(v(t,i)).isDirectory()}catch{return!1}}).map(i=>{let n=v(t,i,"workflow.json"),o={};try{o=JSON.parse(ne(n,"utf-8"))}catch{}let a=v(t,i,"nodes"),c=0;try{c=De(a).filter(u=>u.endsWith(".mjs")&&u!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Qt(r,v(t,i))}});return JSON.stringify({workflows:s})}var ir={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Nn,tools:[{name:"design_workflow",description:"Design a workflow spec (nodes, edges, descriptions) for the user to review before building. Call this after understanding requirements.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name in kebab-case (e.g., ticket-triage)"},description:{type:"string",description:"What the workflow does"},nodes:{type:"array",items:{type:"object",properties:{name:{type:"string",description:"Node name in snake_case (e.g., classify_ticket)"},description:{type:"string",description:"What this node does \u2014 be specific about input/output"},inputFields:{type:"array",items:{type:"string"},description:"Key fields this node reads from state"},outputFields:{type:"array",items:{type:"string"},description:"Key fields this node produces"}},required:["name","description"]},description:"Workflow nodes (processing steps)"},edges:{type:"array",items:{type:"object",properties:{from:{type:"string",description:"Source node name"},to:{type:"string",description:'Target node name (or "END")'},condition:{type:"string",description:"JS expression for conditional routing (optional)"}},required:["from","to"]},description:"Edges connecting nodes. If omitted, nodes are wired linearly."}},required:["name","description","nodes"]}},{name:"build_workflow",description:"Generate real workflow code on disk from a design spec. Uses the configured AI agent for high-quality code generation.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name (from design_workflow)"},spec:{type:"object",description:"The full spec object returned by design_workflow",properties:{name:{type:"string"},description:{type:"string"},nodes:{type:"array",items:{type:"object"}},edges:{type:"array",items:{type:"object"}}}}},required:["name","spec"]}},{name:"add_node",description:"Add a new node to an existing workflow. Generates the node file and updates the barrel export.",input_schema:{type:"object",properties:{workflowName:{type:"string",description:"Existing workflow name (kebab-case)"},nodeName:{type:"string",description:"New node name (snake_case)"},description:{type:"string",description:"What this node does"},inputFields:{type:"array",items:{type:"string"},description:"Fields read from state"},outputFields:{type:"array",items:{type:"string"},description:"Fields produced"}},required:["workflowName","nodeName","description"]}},{name:"deploy_workflow",description:"Deploy a workflow to Zibby Cloud. Returns the trigger URL.",input_schema:{type:"object",properties:{name:{type:"string",description:"Workflow name to deploy"},projectId:{type:"string",description:"Target project ID"}},required:["name","projectId"]}},{name:"list_workflows",description:"List all local workflows in .zibby/workflows/.",input_schema:{type:"object",properties:{}}},{name:"explore_framework_docs",description:"Read Zibby framework documentation on demand. Call this before building complex workflows or when you need details on advanced patterns (middleware, conditional routing, skills, deployment, CLI commands).",input_schema:{type:"object",properties:{topic:{type:"string",description:'Doc topic to read (e.g., "workflow", "custom-workflows", "cli-reference", "packages/core", "packages/skills", "integrations/jira"). Call with no topic to list all available docs.'}}}}],async handleToolCall(r,t,e){let s=e?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await An(t);case"build_workflow":return await Tn(t,s);case"add_node":return await En(t,s);case"deploy_workflow":return await Cn(t,s);case"list_workflows":return Ln(s);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=Zt();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let n=sr(i);if(!n){let o=Zt();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:n})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Jn}from"@zibby/core/backend-client.js";var Me=Object.freeze({id:"openai_billing",requiresIntegration:A.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),qe=Object.freeze({id:"anthropic_billing",requiresIntegration:A.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),Ke=Object.freeze({id:"cursor_admin",requiresIntegration:A.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function or(r){return Math.floor(r/1e3)}function Pe(r){return new Date(r).toISOString().slice(0,10)}function ar(r){return new Date(r).toISOString()}async function ie(r){let t=await Jn(r);if(!t?.token)throw new Error(`${r} token resolver returned no token`);return t.token}async function cr({startMs:r,endMs:t,groupBy:e=["project_id","line_item"]}){let s=await ie("openai_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.openai.com/v1/organization/costs?${[`start_time=${or(r)}`,`end_time=${or(t)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{Authorization:`Bearer ${s}`}});if(!p.ok){let d=await p.text().catch(()=>"");throw new Error(`OpenAI costs API ${p.status}: ${d.slice(0,200)}`)}let m=await p.json();for(let d of m.data||[]){n+=1;let y=Pe((d.start_time||0)*1e3);for(let _ of d.results||[])i.push({provider:"openai",day:y,costUsd:Number(_.amount?.value??0),projectId:_.project_id||void 0,apiKeyId:_.api_key_id||void 0,model:_.line_item||void 0})}if(!m.has_more||!m.next_page)break;a=m.next_page}return{ok:!0,items:i,rawBuckets:n}}async function Dn(){let r=await ie("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${r}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${n.slice(0,200)}`)}let s=await e.json(),i=new Map;for(let n of s.data||[])i.set(n.id,n.name);return i}async function lr({startMs:r,endMs:t,groupBy:e=["workspace_id"]}){let s=await ie("anthropic_billing"),i=[],n=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let l=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(ar(r))}`,`ending_at=${encodeURIComponent(ar(t))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(l,{headers:{"x-api-key":s,"anthropic-version":"2023-06-01"}});if(!p.ok){let d=await p.text().catch(()=>"");throw new Error(`Anthropic cost_report ${p.status}: ${d.slice(0,200)}`)}let m=await p.json();for(let d of m.data||[]){n+=1;let y=(d.starting_at||"").slice(0,10);for(let _ of d.results||[])i.push({provider:"anthropic",day:y,costUsd:Number(_.amount??_.cost??0),workspaceId:_.workspace_id||void 0,apiKeyId:_.api_key_id||void 0,model:_.model||void 0,tokensIn:_.uncached_input_tokens!=null?Number(_.uncached_input_tokens):void 0,tokensOut:_.output_tokens!=null?Number(_.output_tokens):void 0,cachedTokens:_.cached_input_tokens!=null?Number(_.cached_input_tokens):void 0})}if(!m.has_more||!m.next_page)break;a=m.next_page}return{ok:!0,items:i,rawBuckets:n}}async function Un(){let r=await ie("anthropic_billing"),e=await fetch("https://api.anthropic.com/v1/organizations/workspaces?limit=100",{headers:{"x-api-key":r,"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 s=await e.json(),i=new Map;for(let n of s.data||[])i.set(n.id,n.name);return i}async function ur({startMs:r,endMs:t}){let e=await ie("cursor_admin"),s=Pe(r),i=Pe(t),n=`https://api.cursor.com/teams/daily-usage-data?startDate=${s}&endDate=${i}`,o=await fetch(n,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${l.slice(0,200)}`)}let a=await o.json(),c=[],u=0;for(let l of a.data||[]){u+=1;let p=l.date;for(let m of l.userMetrics||[]){for(let d of m.modelUsage||[]){let y=Number(d.acceptedLines??0),_=Number(d.suggestedLines??0);c.push({provider:"cursor",day:p,costUsd:Number(d.totalCents??0)/100,userEmail:m.email,model:d.model,requestCount:Number(d.requestCount??0),acceptanceRate:_>0?y/_:void 0})}(!m.modelUsage||m.modelUsage.length===0)&&c.push({provider:"cursor",day:p,costUsd:Number(m.totalCents??0)/100,userEmail:m.email})}}return{ok:!0,items:c,rawBuckets:u}}async function Pn({startMs:r,endMs:t}){let[e,s,i]=await Promise.allSettled([cr({startMs:r,endMs:t}),lr({startMs:r,endMs:t}),ur({startMs:r,endMs:t})]),n=l=>l.status==="fulfilled"?l.value:{ok:!1,error:l.reason?.message||String(l.reason),items:[]},o=n(e),a=n(s),c=n(i),u=[{provider:"openai",totalUsd:o.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"anthropic",totalUsd:a.items.reduce((l,p)=>l+(p.costUsd||0),0)},{provider:"cursor",totalUsd:c.items.reduce((l,p)=>l+(p.costUsd||0),0)}];return{openai:o,anthropic:a,cursor:c,totals:u}}function Mn(r,t){let e=new Map;for(let s of r){let i=t(s);if(!i)continue;let n=e.get(i)||{key:i,totalUsd:0,count:0};n.totalUsd+=s.costUsd||0,n.count+=1,e.set(i,n)}return[...e.values()].sort((s,i)=>i.totalUsd-s.totalUsd)}function qn(r){if(!r.length)return{mean:0,stddev:0};let t=r.reduce((s,i)=>s+i,0)/r.length,e=r.reduce((s,i)=>s+(i-t)**2,0)/r.length;return{mean:t,stddev:Math.sqrt(e)}}import{z as b}from"zod";var oe=["ok","info","warn","critical"],Kn=b.object({primary:b.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:b.object({value:b.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:b.enum(["up","down","flat"]).optional(),severity:b.enum(oe).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:b.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),Bn=b.object({kind:b.literal("trend"),title:b.string().max(120).optional(),labels:b.array(b.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:b.array(b.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:b.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:b.enum(oe).optional()}).refine(r=>r.labels.length===r.values.length,{message:"labels.length must equal values.length"}),Fn=b.object({kind:b.literal("table"),title:b.string().max(120).optional(),headers:b.array(b.string().max(40)).min(1).max(8),rows:b.array(b.array(b.union([b.string().max(200),b.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}).refine(r=>r.rows.every(t=>t.length===r.headers.length),{message:"every row must have headers.length entries"}),zn=b.object({kind:b.literal("callouts"),title:b.string().max(120).optional(),tone:b.enum(oe).default("info").optional(),items:b.array(b.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),Wn=b.object({kind:b.literal("breakdown"),title:b.string().max(120).optional(),rows:b.array(b.object({label:b.string().min(1).max(80),value:b.string().min(1).max(80),sub:b.string().max(120).optional(),severity:b.enum(oe).optional()})).min(1).max(20)}),Gn=b.object({kind:b.literal("paragraph"),title:b.string().max(120).optional(),text:b.string().min(1).max(3e3)}),Hn=b.discriminatedUnion("kind",[Bn,Fn,zn,Wn,Gn]),Be=b.object({title:b.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:b.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:Kn,sections:b.array(Hn).max(20).default([]),footer:b.object({viewUrl:b.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:b.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),G=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),pr=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),Yn=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function dr(r,t,e=12){if(!Number.isFinite(r)||!Number.isFinite(t)||t<=0)return"";let s=Math.max(0,Math.min(1,r/t)),i=Math.round(s*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function Fe(r,t){let e=String(r);return e.length>=t?e:e+" ".repeat(t-e.length)}function mr(r,t){let e=String(r);return e.length>=t?e:" ".repeat(t-e.length)+e}function fr({headers:r,rows:t}){let e=r.map((o,a)=>{let c=Math.max(String(o).length,...t.map(u=>String(u[a]??"").length));return Math.min(c,32)}),s=o=>o.map((a,c)=>Fe(a,e[c])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[s(r),i,...t.map(o=>s(o))].join(`
|
|
660
|
+
`)+"\n```"}function Zn(r){let t=Be.parse(r),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 s=[`*${t.headline.primary}*`];if(t.headline.delta){let n=pr[t.headline.delta.direction]||"",o=t.headline.delta.severity?G[t.headline.delta.severity]:"";s.push(`${n} ${t.headline.delta.value} ${o}`.trim())}let i=s.join(" ");t.headline.summary&&(i+=`
|
|
661
|
+
`+t.headline.summary),e.push({type:"section",text:{type:"mrkdwn",text:i}});for(let n of t.sections)switch(e.push({type:"divider"}),n.title&&e.push({type:"section",text:{type:"mrkdwn",text:`*${n.title}*`}}),n.kind){case"trend":{let o=Math.max(...n.values),a=n.labels.map((c,u)=>{let l=n.values[u],p=dr(l,o),d=(n.highlight==="last"&&u===n.labels.length-1||n.highlight==="max"&&l===o||n.highlight==="min"&&l===Math.min(...n.values))&&n.severity?` ${G[n.severity]}`:"";return`${Fe(c,10)} ${mr(l.toLocaleString(),8)} ${p}${d}`});e.push({type:"section",text:{type:"mrkdwn",text:"```\n"+a.join(`
|
|
662
|
+
`)+"\n```"}});break}case"table":{e.push({type:"section",text:{type:"mrkdwn",text:fr(n)}});break}case"callouts":{let o=G[n.tone||"info"];e.push({type:"section",text:{type:"mrkdwn",text:n.items.map(a=>`${o} ${a}`).join(`
|
|
663
|
+
`)}});break}case"breakdown":{let o=n.rows.map(a=>({type:"mrkdwn",text:`*${a.label}*
|
|
664
|
+
${a.value}${a.sub?`
|
|
665
|
+
_${a.sub}_`:""}${a.severity?` ${G[a.severity]}`:""}`}));for(let a=0;a<o.length;a+=10)e.push({type:"section",fields:o.slice(a,a+10)});break}case"paragraph":{e.push({type:"section",text:{type:"mrkdwn",text:n.text}});break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let n=[];t.footer.viewUrl&&n.push({type:"button",text:{type:"plain_text",text:"View in Zibby"},url:t.footer.viewUrl,style:"primary"}),t.footer.rerunUrl&&n.push({type:"button",text:{type:"plain_text",text:"Run again"},url:t.footer.rerunUrl}),e.push({type:"divider"}),e.push({type:"actions",elements:n})}return e}function Vn(r){let t=Be.parse(r),e=[],s=[`**${t.headline.primary}**`];if(t.headline.delta){let o=pr[t.headline.delta.direction]||"",a=t.headline.delta.severity?G[t.headline.delta.severity]:"";s.push(`${o} ${t.headline.delta.value} ${a}`.trim())}let i=s.join(" ");t.headline.summary&&(i+=`
|
|
666
|
+
`+t.headline.summary),e.push({tag:"div",text:{tag:"lark_md",content:i}});for(let o of t.sections)switch(e.push({tag:"hr"}),o.title&&e.push({tag:"div",text:{tag:"lark_md",content:`**${o.title}**`}}),o.kind){case"trend":{let a=Math.max(...o.values),c=o.labels.map((u,l)=>{let p=o.values[l],m=dr(p,a),y=(o.highlight==="last"&&l===o.labels.length-1||o.highlight==="max"&&p===a||o.highlight==="min"&&p===Math.min(...o.values))&&o.severity?` ${G[o.severity]}`:"";return`${Fe(u,10)} ${mr(p.toLocaleString(),8)} ${m}${y}`});e.push({tag:"div",text:{tag:"lark_md",content:"```\n"+c.join(`
|
|
667
|
+
`)+"\n```"}});break}case"table":{e.push({tag:"div",text:{tag:"lark_md",content:fr(o)}});break}case"callouts":{let a=G[o.tone||"info"];e.push({tag:"div",text:{tag:"lark_md",content:o.items.map(c=>`${a} ${c}`).join(`
|
|
668
|
+
`)}});break}case"breakdown":{let a=o.rows.map(c=>{let u=c.severity?` ${G[c.severity]}`:"",l=c.sub?` *${c.sub}*`:"";return`**${c.label}** ${c.value}${l}${u}`});e.push({tag:"div",text:{tag:"lark_md",content:a.join(`
|
|
669
|
+
`)}});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=Yn[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 Io=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),$o=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});import{createRequire as Qn}from"module";import{fileURLToPath as Xn}from"url";import{registerHandlers as ei}from"@zibby/core/function-skill-registry.js";import{registerSkill as ti}from"@zibby/agent-workflow";var ri=Qn(import.meta.url);function si(){try{return ri.resolve("@zibby/core/function-bridge.js")}catch{return null}}var ni=import.meta.url;function ii(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(s,i)=>i;let e=new Error().stack;for(let s=2;s<e.length;s++){let i=e[s].getFileName();if(i&&i!==ni&&!i.startsWith("node:"))return i.startsWith("file://")?Xn(i):i}return null}finally{Error.prepareStackTrace=r}}function oi(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[s,i]of Object.entries(r))if(typeof i=="string")t[s]={type:i},e.push(s);else{let{required:n,...o}=i;t[s]=o,n!==!1&&e.push(s)}return{type:"object",properties:t,required:e}}function ai(r,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let s={[r]:e.handler},i=[{name:r,description:e.description||"",input_schema:oi(e.input)}];return ei(r,s,i),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:e.description||`Function skill: ${r}`,envKeys:[],tools:i,resolve(){let n=si();return n?{command:"node",args:[n,t,r]}:null}}}function ci(r,t){return{id:r,type:"mcp",serverName:t.serverName||r,allowedTools:t.allowedTools||[`mcp__${t.serverName||r}__*`],description:t.description||`MCP skill: ${r}`,envKeys:t.envKeys||[],tools:t.tools||[],resolve:t.resolve,...t.cursorKey&&{cursorKey:t.cursorKey},...t.sessionEnvKey&&{sessionEnvKey:t.sessionEnvKey}}}function yr(r,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let s=ii();if(!s)throw new Error(`Could not resolve caller file for skill "${r}".`);e=ai(r,s,t)}else if(typeof t.resolve=="function")e=ci(r,t);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return ti(e),e}var li=yr;import{registerSkill as ra,getSkill as sa,hasSkill as na,getAllSkills as ia,listSkillIds as oa}from"@zibby/agent-workflow";$(We);$(Ye);$(Ve);$(M);$(F);$(Xe);$(pe);$(tt);$(Ot);$(xt);$(st);$(ct);$(Wt);$(ir);$(Me);$(qe);$(Ke);$({...M,id:"slack_notify"});var Zo={BROWSER:"browser",JIRA:"jira",GITHUB:"github",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{A as INTEGRATIONS,Or as INTEGRATION_REGISTRY,oe as REPORT_SEVERITIES,Zo as SKILLS,qe as anthropicBillingSkill,We as browserSkill,Wt as chatMemorySkill,Xe as chatNotifySkill,ct as coreToolsSkill,Ke as cursorAdminSkill,Pn as fetchAllProviders,lr as fetchAnthropicCosts,Un as fetchAnthropicWorkspaces,ur as fetchCursorSpend,cr as fetchOpenAICosts,Dn as fetchOpenAIProjects,li as functionSkill,ia as getAllSkills,sa as getSkill,xt as gitSkill,Ve as githubSkill,Mn as groupByKey,na as hasSkill,Ye as jiraSkill,F as larkSkill,oa as listSkillIds,qn as meanStddev,tt as memorySkill,Me as openaiBillingSkill,ra as registerSkill,Be as reportObjectSchema,Zn as reportToBlockKit,Vn as reportToLarkCard,Ot as runnerSkill,pe as sentrySkill,yr as skill,st as skillInstallerSkill,M as slackSkill,Ot as testRunnerSkill,ir as workflowBuilderSkill};
|