@zibby/skills 0.2.18 → 0.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -3,7 +3,7 @@ If you DO NOT have access to browser tools \u2192 return {"success": false, "ste
3
3
  DO NOT return success: true unless you ACTUALLY called browser tools.`,resolve({sessionPath:r,workspace:t,nodeName:e,headless:n}={}){let i=pa(),s=r&&e?la(r,e):null,o=s||r||t||"test-results",a=fa({headless:n}),c={};if(s&&(c.ZIBBY_NODE_SESSION_PATH=s),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:ha([i,"--isolated",`--save-video=${ua}`,`--viewport-size=${ma}`,`--output-dir=${o}`],a),env:c}}};import{createRequire as ga}from"module";import{resolveIntegrationToken as ba,clearTokenCache as _a}from"@zibby/core/backend-client.js";var I=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",LARK_DOCS:"lark_docs",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",VIKUNJA:"vikunja",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),ya=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"},lark_docs:{id:"lark_docs",name:"Lark Docs",connectPath:"/integrations?provider=lark_docs"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},vikunja:{id:"vikunja",name:"Vikunja",connectPath:"/integrations?provider=vikunja"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});var ka=ga(import.meta.url);function wa(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return ka.resolve("@zibby/mcp-jira/index.js")}catch{return null}}var Sa=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function va(r,t){if(!t||!t.length)return r;let e=r;for(let n of t)n.type==="strong"?e=`**${e}**`:n.type==="em"?e=`_${e}_`:n.type==="code"?e=`\`${e}\``:n.type==="strike"?e=`~~${e}~~`:n.type==="link"&&n.attrs?.href&&(e=`[${e}](${n.attrs.href})`);return e}function Tt(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let n of r){if(n.type==="text"){e.push(va(n.text||"",n.marks));continue}if(n.type==="hardBreak"){e.push(`
6
+ Override: set MCP_BROWSER_PATH to the path of mcp-browser-zibby.js.`);return{command:"node",args:ha([i,"--isolated",`--save-video=${ua}`,`--viewport-size=${ma}`,`--output-dir=${o}`],a),env:c}}};import{createRequire as ga}from"module";import{resolveIntegrationToken as ba,clearTokenCache as _a}from"@zibby/core/backend-client.js";var I=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",LARK_DOCS:"lark_docs",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",VIKUNJA:"vikunja",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),ya=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"},lark_docs:{id:"lark_docs",name:"Lark Docs",connectPath:"/integrations?provider=lark_docs"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},vikunja:{id:"vikunja",name:"Vikunja",connectPath:"/integrations?provider=vikunja"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});var wa=ga(import.meta.url);function ka(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return wa.resolve("@zibby/mcp-jira/index.js")}catch{return null}}var Sa=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function va(r,t){if(!t||!t.length)return r;let e=r;for(let n of t)n.type==="strong"?e=`**${e}**`:n.type==="em"?e=`_${e}_`:n.type==="code"?e=`\`${e}\``:n.type==="strike"?e=`~~${e}~~`:n.type==="link"&&n.attrs?.href&&(e=`[${e}](${n.attrs.href})`);return e}function Tt(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let n of r){if(n.type==="text"){e.push(va(n.text||"",n.marks));continue}if(n.type==="hardBreak"){e.push(`
7
7
  `);continue}if(n.type==="rule"){e.push(`
8
8
  ---
9
9
  `);continue}let i=n.content?Tt(n.content,t+1):"";if(n.type==="listItem")e.push(i);else if(n.type==="bulletList"){let s=(n.content||[]).map(o=>`- ${Tt(o.content||[],t+1).trim()}`);e.push(`
@@ -71,7 +71,7 @@ When user asks to move/transition ticket status:
71
71
  3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
72
72
  4. Call jira_get_issue(issueKey) to verify final status before claiming success.
73
73
  5. If target wording differs (e.g. \u5DF2\u7ECF\u9A8C\u6536 vs \u5DF2\u9A8C\u6536), try toStatus first; only ask user to confirm when no reasonable match exists.
74
- 6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=wa();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(t[e]=process.env[e]);return{command:"node",args:[r],env:t,description:this.description}},async handleToolCall(r,t){try{switch(r){case"jira_list_projects":{let e=await j("/rest/api/3/project"),n=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:n.length,projects:n})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let s=await j(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(s)?s:[],a=new Map;for(let l of o)for(let d of l.statuses||[])d?.id&&(a.has(d.id)||a.set(d.id,{id:d.id,name:d.name,category:d.statusCategory?.name||null}));let c=[...a.values()].sort((l,d)=>String(l.name).localeCompare(String(d.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let n=await j("/rest/api/3/status"),i=(Array.isArray(n)?n:[]).map(s=>({id:s.id,name:s.name,category:s.statusCategory?.name||null})).sort((s,o)=>String(s.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let n=await Nn(e);return JSON.stringify({projectKey:e,count:n.length,issueTypes:n})}case"jira_search":{let e=t.jql||"",n=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let s=`jql=${encodeURIComponent(e)}&maxResults=${n}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await j(`/rest/api/3/search/jql?${s}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await j(`/rest/api/3/issue/${e}`);return JSON.stringify({key:n.key,project:n.fields?.project?.key,summary:n.fields?.summary,description:n.fields?.description,status:n.fields?.status?.name,assignee:n.fields?.assignee?.displayName||"Unassigned",priority:n.fields?.priority?.name,type:n.fields?.issuetype?.name,labels:n.fields?.labels,created:n.fields?.created,updated:n.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:n,issueType:i,description:s,priority:o,labels:a,assigneeId:c,moveToSprint:l,moveToActiveSprint:d,sprintId:p,sprintName:u,target:m}=t;if(!e||!n)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await Nn(e),f=Ia(i,h)}catch{}let _={project:{key:e},summary:n,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};s&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}),o&&(_.priority={name:o}),a?.length&&(_.labels=a),c&&(_.assignee={id:c});let y=await j("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:y.key,id:y.id,self:y.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&be(f.requested)!==be(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),h.length>0&&(b.availableIssueTypes=h.map(g=>g.name)),(l||d)&&(b.sprintMove=await _r({issueKey:y.key,projectKey:e,sprintId:p,sprintName:u,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:n}=t,i=await On(e,n);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o}=t||{},a=await _r({issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o}=t||{},a=await _r({issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:n,projectKey:i,status:s,maxResults:o}=t;if(!e&&!n)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=n?`sprint = ${n}`:`sprint = "${e}"`,l=i?`project = ${i} AND `:"",d=s?` AND status = "${s}"`:"",p=`${l}${c}${d} ORDER BY status ASC, priority DESC`,u=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,m=await j(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),h={};for(let _ of f)h[_.status]=(h[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:n}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let s=await j(`/rest/api/3/issue/${e}/comment?maxResults=${n||50}&orderBy=-created`),o=(s.comments||[]).map(a=>{let c="";return a.body?.content&&(c=Tt(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:s.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:n}=t;return!e||!n?JSON.stringify({error:"issueKey and body are required"}):(await j(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:n}=t;return!e||!n?JSON.stringify({error:"issueKey and fields are required"}):(await j(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:n}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:n,toStatus:i,statusName:s,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(i||s||o||"").trim();if(!n&&!a){let p=((await j(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(u=>({id:u.id,name:u.name,to:u.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=n;if(!c){let p=(await j(`/rest/api/3/issue/${e}/transitions`)).transitions||[],u=Be(a),m=p.find(f=>Be(f?.name||"")===u||Be(f?.to?.name||"")===u);if(!m){let f=br(a);f.length>=2&&(m=p.find(h=>{let _=br(h?.name||""),y=br(h?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),g=y.length>=2&&(y.includes(f)||f.includes(y));return b||g}))}if(!m){let f=p.map(b=>{let g=Rt(a,b?.name||""),k=Rt(a,b?.to?.name||"");return{t:b,score:Math.max(g,k)}}).sort((b,g)=>g.score-b.score),h=f[0],_=f[1];h&&h.score>=.45&&(!_||h.score-_.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await j(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let l=await j(`/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{existsSync as Ma}from"fs";import{fileURLToPath as Fa}from"url";import{dirname as Ka,resolve as Ga}from"path";import{resolveIntegrationToken as Ln}from"@zibby/core/backend-client.js";import{spawn as Ra,execSync as Aa}from"child_process";import{existsSync as ee,mkdirSync as Ea,readdirSync as En,statSync as xa,readFileSync as ja}from"fs";import{resolve as kr,join as te,basename as La}from"path";var wr=".zibby/repos";function Rn(r,t){try{let e=new URL(r);return e.protocol==="https:"&&e.host.toLowerCase()===t.toLowerCase()}catch{return!1}}function An(r,t,e){let n=new URL(r);return n.username=encodeURIComponent(t),n.password=encodeURIComponent(e),n.toString()}function $a(r){let t=String(r??"");for(let e of[process.env.GITHUB_TOKEN,process.env.GITLAB_TOKEN])e&&(t=t.split(e).join("***"));return t.replace(/x-access-token:[^@\s]*@/g,"x-access-token:***@").replace(/oauth2:[^@\s]*@/g,"oauth2:***@").replace(/https?:\/\/[^/@\s:]+:[^@\s]+@/g,e=>e.replace(/:[^@\s]+@/,":***@"))}function tt(r,t,e,n,i="clone"){try{r(`git -C "${t}" remote set-url origin "${e}"`,{stdio:"pipe"})}catch(s){let o=String(s?.message||s);n&&(o=o.split(n).join("***")),console.error(`[${i}] WARNING: failed to strip token from .git/config: ${o}`)}}function At(r,t,e={}){return new Promise((n,i)=>{let s=Ra(r,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",a="";s.stdout.on("data",c=>{o+=c.toString()}),s.stderr.on("data",c=>{a+=c.toString()}),s.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):n(o.trim())}),s.on("error",c=>i(c))})}var _e={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],inProcessOnly:!0,promptFragment:`## Git Repositories
74
+ 6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=ka();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(t.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(t[e]=process.env[e]);return{command:"node",args:[r],env:t,description:this.description}},async handleToolCall(r,t){try{switch(r){case"jira_list_projects":{let e=await j("/rest/api/3/project"),n=(Array.isArray(e)?e:[]).map(i=>({id:i.id,key:i.key,name:i.name,style:i.style}));return JSON.stringify({count:n.length,projects:n})}case"jira_list_statuses":{let{projectKey:e}=t||{};if(e){let s=await j(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(s)?s:[],a=new Map;for(let l of o)for(let d of l.statuses||[])d?.id&&(a.has(d.id)||a.set(d.id,{id:d.id,name:d.name,category:d.statusCategory?.name||null}));let c=[...a.values()].sort((l,d)=>String(l.name).localeCompare(String(d.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let n=await j("/rest/api/3/status"),i=(Array.isArray(n)?n:[]).map(s=>({id:s.id,name:s.name,category:s.statusCategory?.name||null})).sort((s,o)=>String(s.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:i.length,statuses:i})}case"jira_list_issue_types":{let{projectKey:e}=t||{};if(!e)return JSON.stringify({error:"projectKey is required"});let n=await Nn(e);return JSON.stringify({projectKey:e,count:n.length,issueTypes:n})}case"jira_search":{let e=t.jql||"",n=t.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let s=`jql=${encodeURIComponent(e)}&maxResults=${n}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await j(`/rest/api/3/search/jql?${s}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=t.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await j(`/rest/api/3/issue/${e}`);return JSON.stringify({key:n.key,project:n.fields?.project?.key,summary:n.fields?.summary,description:n.fields?.description,status:n.fields?.status?.name,assignee:n.fields?.assignee?.displayName||"Unassigned",priority:n.fields?.priority?.name,type:n.fields?.issuetype?.name,labels:n.fields?.labels,created:n.fields?.created,updated:n.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:n,issueType:i,description:s,priority:o,labels:a,assigneeId:c,moveToSprint:l,moveToActiveSprint:d,sprintId:p,sprintName:u,target:m}=t;if(!e||!n)return JSON.stringify({error:"projectKey and summary are required"});let f={requested:i||null,resolved:null,strategy:"none"},h=[];try{h=await Nn(e),f=Ia(i,h)}catch{}let _={project:{key:e},summary:n,issuetype:f?.resolved?.id?{id:f.resolved.id}:{name:i||"Task"}};s&&(_.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:s}]}]}),o&&(_.priority={name:o}),a?.length&&(_.labels=a),c&&(_.assignee={id:c});let y=await j("/rest/api/3/issue",{method:"POST",body:{fields:_}}),b={ok:!0,key:y.key,id:y.id,self:y.self};return f?.resolved&&(b.issueType=f.resolved.name,b.issueTypeResolution=f.strategy,f.strategy!=="exact"&&f.requested&&be(f.requested)!==be(f.resolved.name)&&(b.issueTypeWarning=`Requested "${f.requested}" is not available in ${e}; used "${f.resolved.name}" instead.`)),h.length>0&&(b.availableIssueTypes=h.map(g=>g.name)),(l||d)&&(b.sprintMove=await _r({issueKey:y.key,projectKey:e,sprintId:p,sprintName:u,target:m})),JSON.stringify(b)}case"jira_list_sprints":{let{projectKey:e,state:n}=t,i=await On(e,n);return JSON.stringify({count:i.length,sprints:i})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o}=t||{},a=await _r({issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o}=t||{},a=await _r({issueKey:e,projectKey:n,sprintId:i,sprintName:s,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:n,projectKey:i,status:s,maxResults:o}=t;if(!e&&!n)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=n?`sprint = ${n}`:`sprint = "${e}"`,l=i?`project = ${i} AND `:"",d=s?` AND status = "${s}"`:"",p=`${l}${c}${d} ORDER BY status ASC, priority DESC`,u=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,m=await j(`/rest/api/3/search/jql?${u}`),f=(m.issues||[]).map(_=>({key:_.key,project:_.fields?.project?.key,summary:_.fields?.summary,status:_.fields?.status?.name,assignee:_.fields?.assignee?.displayName||"Unassigned",priority:_.fields?.priority?.name,type:_.fields?.issuetype?.name})),h={};for(let _ of f)h[_.status]=(h[_.status]||0)+1;return JSON.stringify({count:f.length,total:m.total||f.length,statusCounts:h,issues:f})}case"jira_get_comments":{let{issueKey:e,maxResults:n}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let s=await j(`/rest/api/3/issue/${e}/comment?maxResults=${n||50}&orderBy=-created`),o=(s.comments||[]).map(a=>{let c="";return a.body?.content&&(c=Tt(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:s.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:n}=t;return!e||!n?JSON.stringify({error:"issueKey and body are required"}):(await j(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:n}=t;return!e||!n?JSON.stringify({error:"issueKey and fields are required"}):(await j(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:n}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:n,toStatus:i,statusName:s,status:o}=t;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(i||s||o||"").trim();if(!n&&!a){let p=((await j(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(u=>({id:u.id,name:u.name,to:u.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=n;if(!c){let p=(await j(`/rest/api/3/issue/${e}/transitions`)).transitions||[],u=Be(a),m=p.find(f=>Be(f?.name||"")===u||Be(f?.to?.name||"")===u);if(!m){let f=br(a);f.length>=2&&(m=p.find(h=>{let _=br(h?.name||""),y=br(h?.to?.name||""),b=_.length>=2&&(_.includes(f)||f.includes(_)),g=y.length>=2&&(y.includes(f)||f.includes(y));return b||g}))}if(!m){let f=p.map(b=>{let g=Rt(a,b?.name||""),w=Rt(a,b?.to?.name||"");return{t:b,score:Math.max(g,w)}}).sort((b,g)=>g.score-b.score),h=f[0],_=f[1];h&&h.score>=.45&&(!_||h.score-_.score>=.12)&&(m=h.t)}if(!m?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(f=>({id:f.id,name:f.name,to:f.to?.name}))});c=m.id}await j(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let l=await j(`/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{existsSync as Ma}from"fs";import{fileURLToPath as Fa}from"url";import{dirname as Ka,resolve as Ga}from"path";import{resolveIntegrationToken as Ln}from"@zibby/core/backend-client.js";import{spawn as Ra,execSync as Aa}from"child_process";import{existsSync as ee,mkdirSync as Ea,readdirSync as En,statSync as xa,readFileSync as ja}from"fs";import{resolve as wr,join as te,basename as La}from"path";var kr=".zibby/repos";function Rn(r,t){try{let e=new URL(r);return e.protocol==="https:"&&e.host.toLowerCase()===t.toLowerCase()}catch{return!1}}function An(r,t,e){let n=new URL(r);return n.username=encodeURIComponent(t),n.password=encodeURIComponent(e),n.toString()}function $a(r){let t=String(r??"");for(let e of[process.env.GITHUB_TOKEN,process.env.GITLAB_TOKEN])e&&(t=t.split(e).join("***"));return t.replace(/x-access-token:[^@\s]*@/g,"x-access-token:***@").replace(/oauth2:[^@\s]*@/g,"oauth2:***@").replace(/https?:\/\/[^/@\s:]+:[^@\s]+@/g,e=>e.replace(/:[^@\s]+@/,":***@"))}function tt(r,t,e,n,i="clone"){try{r(`git -C "${t}" remote set-url origin "${e}"`,{stdio:"pipe"})}catch(s){let o=String(s?.message||s);n&&(o=o.split(n).join("***")),console.error(`[${i}] WARNING: failed to strip token from .git/config: ${o}`)}}function At(r,t,e={}){return new Promise((n,i)=>{let s=Ra(r,{cwd:t,shell:!0,env:{...process.env,GIT_TERMINAL_PROMPT:"0",...e}}),o="",a="";s.stdout.on("data",c=>{o+=c.toString()}),s.stderr.on("data",c=>{a+=c.toString()}),s.on("close",c=>{c!==0?i(new Error(`Exit ${c}: ${a.trim()||o.trim()}`)):n(o.trim())}),s.on("error",c=>i(c))})}var _e={id:"git",description:"Clone and manage git repositories for codebase analysis",envKeys:["GITHUB_TOKEN","GITLAB_TOKEN"],inProcessOnly:!0,promptFragment:`## Git Repositories
75
75
  You can clone and explore git repositories locally for codebase analysis:
76
76
  - git_checkout: Clone a repo (or pull if already cloned). Supports GitHub and GitLab with auto-auth.
77
77
  - git_list_repos: List locally cloned repos
@@ -81,7 +81,7 @@ When your task needs repository context you don't have yet:
81
81
  1. Clone the relevant repo with git_checkout
82
82
  2. Use git_explore to understand the project structure
83
83
  3. Use shell commands (grep, cat) to read specific files for deeper understanding
84
- 4. Use GitHub/GitLab skills to read related PRs and commits when history matters`,resolve(){return null},async handleToolCall(r,t,e){let n=e?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await Pa(t,n);case"git_list_repos":return Ca(t,n);case"git_explore":return Ua(t,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:$a(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 Pa(r,t){let{url:e,branch:n,shallow:i=!0,name:s}=r;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=s||La(e.replace(/\.git$/,"")),a=kr(t,wr);Ea(a,{recursive:!0});let c=te(a,o),l=e,d=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,u=process.env.GITLAB_URL;if(Rn(e,"github.com")&&d)l=An(e,"x-access-token",d);else if(p&&u)try{let h=new URL(u).host;Rn(e,h)&&(l=An(e,"oauth2",p))}catch{}if(ee(te(c,".git"))){let h=n?`git -C "${c}" fetch "${l}" ${n} && git -C "${c}" checkout ${n} && git -C "${c}" merge --ff-only FETCH_HEAD`:`git -C "${c}" pull "${l}"`;await At(h,t);let _=await At(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:c,branch:n||"default",head:_})}let m=["git","clone"];i&&m.push("--depth","1"),n&&m.push("--branch",n),m.push(`"${l}"`,`"${c}"`),await At(m.join(" "),t),tt(Aa,c,e,d||p,"git_checkout");let f=await At(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:c,branch:n||"default",shallow:i,head:f})}function Ca(r,t){let e=kr(t,wr);if(!ee(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let n=[];for(let i of En(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let s=te(e,i.name);if(!ee(te(s,".git")))continue;let o=xa(s);n.push({name:i.name,path:s,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:n,total:n.length,directory:e})}function Ua(r,t){let{repo:e,depth:n=2}=r,i=kr(t,wr,e);if(!ee(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let s={repo:e,path:i},o=te(i,"package.json");if(ee(o))try{let m=JSON.parse(ja(o,"utf-8"));s.packageJson={name:m.name,version:m.version,scripts:m.scripts?Object.keys(m.scripts):[],dependencies:m.dependencies?Object.keys(m.dependencies).slice(0,30):[],devDependencies:m.devDependencies?Object.keys(m.devDependencies).slice(0,20):[]},m.dependencies?.react?s.framework="React":m.dependencies?.next?s.framework="Next.js":m.dependencies?.vue?s.framework="Vue":m.dependencies?.angular?s.framework="Angular":m.dependencies?.express?s.framework="Express":m.dependencies?.fastify&&(s.framework="Fastify")}catch{}let a=te(i,"pyproject.toml");ee(a)&&(s.language="Python");let c=te(i,"go.mod");ee(c)&&(s.language="Go");let l=te(i,"Cargo.toml");ee(l)&&(s.language="Rust"),ee(o)&&(s.language=s.language||"JavaScript/TypeScript");let d=[];function p(m,f,h){if(h>n)return;let _;try{_=En(m,{withFileTypes:!0})}catch{return}let y=_.filter(b=>!b.name.startsWith(".")&&b.name!=="node_modules"&&b.name!=="__pycache__"&&b.name!=="dist"&&b.name!=="build"&&b.name!==".git").sort((b,g)=>b.isDirectory()!==g.isDirectory()?b.isDirectory()?-1:1:b.name.localeCompare(g.name));for(let b of y){let g=b.isDirectory();d.push(`${f}${g?"\u{1F4C1}":"\u{1F4C4}"} ${b.name}`),g&&h<n&&p(te(m,b.name),`${f} `,h+1)}}p(i,"",1),s.tree=d.slice(0,80),d.length>80&&(s.treeTruncated=!0);let u=["README.md","README.rst","src/App.tsx","src/App.jsx","src/App.js","src/routes.tsx","src/routes.js","app/routes.tsx","app/routes.js","src/index.tsx","src/index.ts","src/main.tsx","src/main.ts","pages/_app.tsx","pages/_app.js","app/layout.tsx","docker-compose.yml","Dockerfile",".env.example"];return s.keyFilesFound=u.filter(m=>ee(te(i,m))),JSON.stringify(s)}import Ba from"crypto";var xn=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,jn=/<!--\s*zbreview-summary\s*-->/i;function Ja(r){return String(r||"").replace(xn,"").replace(jn,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function Da(r,t){return Ba.createHash("sha256").update(`${String(r||"")}\0${Ja(t)}`).digest("hex").slice(0,12)}function qa(r){return`
84
+ 4. Use GitHub/GitLab skills to read related PRs and commits when history matters`,resolve(){return null},async handleToolCall(r,t,e){let n=e?.options?.workspace||process.cwd();try{switch(r){case"git_checkout":return await Pa(t,n);case"git_list_repos":return Ca(t,n);case"git_explore":return Ua(t,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:$a(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 Pa(r,t){let{url:e,branch:n,shallow:i=!0,name:s}=r;!e.includes("://")&&!e.startsWith("git@")&&(e=`https://github.com/${e}`);let o=s||La(e.replace(/\.git$/,"")),a=wr(t,kr);Ea(a,{recursive:!0});let c=te(a,o),l=e,d=process.env.GITHUB_TOKEN,p=process.env.GITLAB_TOKEN,u=process.env.GITLAB_URL;if(Rn(e,"github.com")&&d)l=An(e,"x-access-token",d);else if(p&&u)try{let h=new URL(u).host;Rn(e,h)&&(l=An(e,"oauth2",p))}catch{}if(ee(te(c,".git"))){let h=n?`git -C "${c}" fetch "${l}" ${n} && git -C "${c}" checkout ${n} && git -C "${c}" merge --ff-only FETCH_HEAD`:`git -C "${c}" pull "${l}"`;await At(h,t);let _=await At(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"updated",repo:o,path:c,branch:n||"default",head:_})}let m=["git","clone"];i&&m.push("--depth","1"),n&&m.push("--branch",n),m.push(`"${l}"`,`"${c}"`),await At(m.join(" "),t),tt(Aa,c,e,d||p,"git_checkout");let f=await At(`git -C "${c}" log -1 --format="%h %s"`,t);return JSON.stringify({action:"cloned",repo:o,path:c,branch:n||"default",shallow:i,head:f})}function Ca(r,t){let e=wr(t,kr);if(!ee(e))return JSON.stringify({repos:[],message:"No repos cloned yet"});let n=[];for(let i of En(e,{withFileTypes:!0})){if(!i.isDirectory())continue;let s=te(e,i.name);if(!ee(te(s,".git")))continue;let o=xa(s);n.push({name:i.name,path:s,lastModified:o.mtime.toISOString()})}return JSON.stringify({repos:n,total:n.length,directory:e})}function Ua(r,t){let{repo:e,depth:n=2}=r,i=wr(t,kr,e);if(!ee(i))return JSON.stringify({error:`Repo not found: ${e}. Run git_checkout first.`});let s={repo:e,path:i},o=te(i,"package.json");if(ee(o))try{let m=JSON.parse(ja(o,"utf-8"));s.packageJson={name:m.name,version:m.version,scripts:m.scripts?Object.keys(m.scripts):[],dependencies:m.dependencies?Object.keys(m.dependencies).slice(0,30):[],devDependencies:m.devDependencies?Object.keys(m.devDependencies).slice(0,20):[]},m.dependencies?.react?s.framework="React":m.dependencies?.next?s.framework="Next.js":m.dependencies?.vue?s.framework="Vue":m.dependencies?.angular?s.framework="Angular":m.dependencies?.express?s.framework="Express":m.dependencies?.fastify&&(s.framework="Fastify")}catch{}let a=te(i,"pyproject.toml");ee(a)&&(s.language="Python");let c=te(i,"go.mod");ee(c)&&(s.language="Go");let l=te(i,"Cargo.toml");ee(l)&&(s.language="Rust"),ee(o)&&(s.language=s.language||"JavaScript/TypeScript");let d=[];function p(m,f,h){if(h>n)return;let _;try{_=En(m,{withFileTypes:!0})}catch{return}let y=_.filter(b=>!b.name.startsWith(".")&&b.name!=="node_modules"&&b.name!=="__pycache__"&&b.name!=="dist"&&b.name!=="build"&&b.name!==".git").sort((b,g)=>b.isDirectory()!==g.isDirectory()?b.isDirectory()?-1:1:b.name.localeCompare(g.name));for(let b of y){let g=b.isDirectory();d.push(`${f}${g?"\u{1F4C1}":"\u{1F4C4}"} ${b.name}`),g&&h<n&&p(te(m,b.name),`${f} `,h+1)}}p(i,"",1),s.tree=d.slice(0,80),d.length>80&&(s.treeTruncated=!0);let u=["README.md","README.rst","src/App.tsx","src/App.jsx","src/App.js","src/routes.tsx","src/routes.js","app/routes.tsx","app/routes.js","src/index.tsx","src/index.ts","src/main.tsx","src/main.ts","pages/_app.tsx","pages/_app.js","app/layout.tsx","docker-compose.yml","Dockerfile",".env.example"];return s.keyFilesFound=u.filter(m=>ee(te(i,m))),JSON.stringify(s)}import Ba from"crypto";var xn=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,jn=/<!--\s*zbreview-summary\s*-->/i;function Ja(r){return String(r||"").replace(xn,"").replace(jn,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function Da(r,t){return Ba.createHash("sha256").update(`${String(r||"")}\0${Ja(t)}`).digest("hex").slice(0,12)}function qa(r){return`
85
85
 
86
86
  <!-- zbfp:${r} -->`}var Et=`
87
87
 
@@ -128,11 +128,11 @@ When user says "check out repo-name" or "clone repo-name":
128
128
  3. STOP. Do not offer to inspect files or ask what to do next.
129
129
 
130
130
  When user just wants to "look at" or "read" files (not clone):
131
- - Use github_get_file to read individual files via API`,resolve(){let r=Ha();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/github.js","githubSkill"],env:t,description:this.description,alwaysLoad:!0}},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 n=await N(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(n.items||[]).map(s=>({number:s.number,title:s.title,state:s.state,repo:s.repository_url?.split("/").slice(-2).join("/"),url:s.html_url,user:s.user?.login,isPR:!!s.pull_request,labels:(s.labels||[]).map(o=>o.name),createdAt:s.created_at}));return JSON.stringify({total:n.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let n=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",s=await N(`/search/code?q=${encodeURIComponent(e)}${n}${i}&per_page=${t.limit||15}`),o=(s.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:s.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}`);return JSON.stringify({number:s.number,title:s.title,state:s.state,merged:s.merged,body:s.body?.slice(0,5e3),user:s.user?.login,branch:s.head?.ref,headSha:s.head?.sha,base:s.base?.ref,changedFiles:s.changed_files,additions:s.additions,deletions:s.deletions,createdAt:s.created_at,mergedAt:s.merged_at,url:s.html_url,labels:(s.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=s.length>15e3;return JSON.stringify({number:i,diff:o?s.slice(0,15e3):s,truncated:o,totalLength:s.length})}case"github_list_pr_files":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:s.length,files:s.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=50`),o=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=50`),a=[...s.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,l)=>new Date(c.createdAt)-new Date(l.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_get_review_thread":{let{owner:e,repo:n,number:i,commentId:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await N(`/repos/${e}/${n}/pulls/comments/${s}`),a=o.in_reply_to_id||o.id,c=[];try{c=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=100`)}catch{c=[o]}(!Array.isArray(c)||c.length===0)&&(c=[o]);let l=c.filter(u=>u.id===a||u.in_reply_to_id===a).sort((u,m)=>new Date(u.created_at)-new Date(m.created_at)),d=l.length?l:[o],p=d.find(u=>u.id===a)||d[0];return JSON.stringify({rootCommentId:a,path:p.path,line:p.line??p.original_line??null,side:p.side||"RIGHT",diffHunk:typeof p.diff_hunk=="string"?p.diff_hunk.slice(0,3e3):null,commitId:p.commit_id||p.original_commit_id||null,notes:d.map(u=>({id:u.id,user:u.user?.login,body:(u.body||"").slice(0,4e3),createdAt:u.created_at,isRoot:u.id===a,url:u.html_url}))})}case"github_reply_review_thread":{let{owner:e,repo:n,number:i,commentId:s,body:o}=t||{};if(!e||!n||!i||!s||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await N(`/repos/${e}/${n}/pulls/${i}/comments/${s}/replies`,{method:"POST",body:{body:String(o)}});return JSON.stringify({ok:!0,id:a.id,url:a.html_url,inReplyTo:a.in_reply_to_id})}case"github_reply_issue_comment":{let{owner:e,repo:n,number:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:e,repo:n,number:i,body:s,event:o,comments:a}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(c))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let l=Array.isArray(a)?a.filter(b=>b&&b.path&&b.body&&(b.line!=null||b.position!=null)).map(b=>{let g={path:b.path,body:String(b.body)};return b.line!=null?(g.line=Number(b.line),g.side=b.side==="LEFT"?"LEFT":"RIGHT"):g.position=Number(b.position),g}):[];if(c!=="APPROVE"&&!s&&l.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let d=new Set,p=null;try{for(let b=1;b<=20;b+=1){let g=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=100&page=${b}`);if(!Array.isArray(g)||g.length===0)break;for(let k of g){let O=xt(k.body);O&&d.add(O)}if(g.length<100)break}for(let b=1;b<=20&&p==null;b+=1){let g=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=100&page=${b}`);if(!Array.isArray(g)||g.length===0)break;for(let k of g)if(jt(k.body)){p=k.id;break}if(g.length<100)break}}catch{}let u=!1,m=!1;if(s){let b=`${String(s)}${Et}`;try{p!=null?(await N(`/repos/${e}/${n}/issues/comments/${p}`,{method:"PATCH",body:{body:b}}),u=!0):await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:b}}),m=!0}catch{}}let{toPost:f,skipped:h}=Lt(l,d),_=f.map(({_fp:b,...g})=>g),y=null;if(_.length>0||c==="APPROVE"||c==="REQUEST_CHANGES"){let b={event:c};_.length>0&&(b.comments=_),_.length===0&&c==="REQUEST_CHANGES"&&(b.body="Changes requested \u2014 see the review summary comment."),y=await N(`/repos/${e}/${n}/pulls/${i}/reviews`,{method:"POST",body:b})}return JSON.stringify({ok:!0,id:y?y.id:void 0,state:y?y.state:void 0,event:c,notePosted:m,summaryUpdated:u,commentsPosted:_.length,inlineSkipped:h||void 0,url:y?y.html_url:void 0})}case"github_list_commits":{let{owner:e,repo:n,branch:i,path:s,limit:o,since:a,until:c,page:l}=t;if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let d=Math.min(Number(o)||20,100),p=`/repos/${e}/${n}/commits?per_page=${d}&page=${Number(l)||1}`;i&&(p+=`&sha=${encodeURIComponent(i)}`),s&&(p+=`&path=${encodeURIComponent(s)}`),a&&(p+=`&since=${encodeURIComponent(a)}`),c&&(p+=`&until=${encodeURIComponent(c)}`);let u=await N(p);return JSON.stringify({total:u.length,page:Number(l)||1,hasMore:u.length>=d,commits:u.map(m=>({sha:m.sha?.slice(0,8),fullSha:m.sha,message:m.commit?.message?.slice(0,300),author:m.commit?.author?.name,authorEmail:m.commit?.author?.email,date:m.commit?.author?.date,url:m.html_url}))})}case"github_get_commit":{let{owner:e,repo:n,sha:i,includePrs:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let o=await N(`/repos/${e}/${n}/commits/${i}`),a;if(s)try{let c=await N(`/repos/${e}/${n}/commits/${i}/pulls`);a=(Array.isArray(c)?c:[]).map(l=>({number:l.number,title:l.title,state:l.state,merged:!!l.merged_at,webUrl:l.html_url}))}catch{a=[]}return JSON.stringify({sha:o.sha?.slice(0,8),message:o.commit?.message,author:o.commit?.author?.name,date:o.commit?.author?.date,stats:o.stats,files:(o.files||[]).map(c=>({filename:c.filename,status:c.status,additions:c.additions,deletions:c.deletions,patch:c.patch?.slice(0,3e3)})),...a?{pullRequests:a}:{}})}case"github_get_file":{let{owner:e,repo:n,path:i,ref:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${n}/contents/${encodeURIComponent(i)}`;s&&(o+=`?ref=${encodeURIComponent(s)}`);let a=await N(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:i,entries:a.map(d=>({name:d.name,type:d.type,size:d.size,path:d.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),l=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:l?c.slice(0,2e4):c,truncated:l})}case"github_get_user":try{let e=await N("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let n=e.repositories[0],i=n.owner.login,s=n.owner.type,o=s==="Organization"?`/orgs/${i}`:`/users/${i}`,a=await N(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:s,isOrg:s==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let n=(await N("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of n)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let s=Array.from(i.values());return JSON.stringify({count:s.length,orgs:s,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(b){let g=b.replace(/^~(?=$|\/|\\)/,m);return a(g)},{owner:e,repo:n,destination:i}=t;if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let{execSync:s}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:l}=await import("fs"),{homedir:d,platform:p}=await import("os"),{token:u}=await Ln("github"),m=d(),h=i?f(i):o(m,"zibby-repos"),_=o(h,n);if(l(h,{recursive:!0}),c(_))return JSON.stringify({error:`Directory ${_} already exists. Remove it first or use a different destination.`,existingPath:_});let y=`https://x-access-token:${u}@github.com/${e}/${n}.git`;try{s(`git clone ${y} "${_}"`,{stdio:"pipe"});let b=`https://github.com/${e}/${n}.git`;tt(s,_,b,u,"github_clone");let g=p()==="win32",k;return g?k=s(`dir "${_}"`,{encoding:"utf-8",shell:"cmd.exe"}):k=s(`ls -la "${_}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:_,message:`Cloned ${e}/${n} to ${_}`,contents:k.split(`
131
+ - Use github_get_file to read individual files via API`,resolve(){let r=Ha();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/github.js","githubSkill"],env:t,description:this.description,alwaysLoad:!0}},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 n=await N(`/search/issues?q=${encodeURIComponent(e)}&per_page=${t.limit||20}`),i=(n.items||[]).map(s=>({number:s.number,title:s.title,state:s.state,repo:s.repository_url?.split("/").slice(-2).join("/"),url:s.html_url,user:s.user?.login,isPR:!!s.pull_request,labels:(s.labels||[]).map(o=>o.name),createdAt:s.created_at}));return JSON.stringify({total:n.total_count,items:i})}case"github_search_code":{let e=t.query;if(!e)return JSON.stringify({error:"query is required"});let n=t.repo?`+repo:${t.repo}`:"",i=t.language?`+language:${t.language}`:"",s=await N(`/search/code?q=${encodeURIComponent(e)}${n}${i}&per_page=${t.limit||15}`),o=(s.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:s.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}`);return JSON.stringify({number:s.number,title:s.title,state:s.state,merged:s.merged,body:s.body?.slice(0,5e3),user:s.user?.login,branch:s.head?.ref,headSha:s.head?.sha,base:s.base?.ref,changedFiles:s.changed_files,additions:s.additions,deletions:s.deletions,createdAt:s.created_at,mergedAt:s.merged_at,url:s.html_url,labels:(s.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=s.length>15e3;return JSON.stringify({number:i,diff:o?s.slice(0,15e3):s,truncated:o,totalLength:s.length})}case"github_list_pr_files":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}/files?per_page=100`);return JSON.stringify({total:s.length,files:s.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:n,number:i}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=50`),o=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=50`),a=[...s.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,l)=>new Date(c.createdAt)-new Date(l.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_get_review_thread":{let{owner:e,repo:n,number:i,commentId:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await N(`/repos/${e}/${n}/pulls/comments/${s}`),a=o.in_reply_to_id||o.id,c=[];try{c=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=100`)}catch{c=[o]}(!Array.isArray(c)||c.length===0)&&(c=[o]);let l=c.filter(u=>u.id===a||u.in_reply_to_id===a).sort((u,m)=>new Date(u.created_at)-new Date(m.created_at)),d=l.length?l:[o],p=d.find(u=>u.id===a)||d[0];return JSON.stringify({rootCommentId:a,path:p.path,line:p.line??p.original_line??null,side:p.side||"RIGHT",diffHunk:typeof p.diff_hunk=="string"?p.diff_hunk.slice(0,3e3):null,commitId:p.commit_id||p.original_commit_id||null,notes:d.map(u=>({id:u.id,user:u.user?.login,body:(u.body||"").slice(0,4e3),createdAt:u.created_at,isRoot:u.id===a,url:u.html_url}))})}case"github_reply_review_thread":{let{owner:e,repo:n,number:i,commentId:s,body:o}=t||{};if(!e||!n||!i||!s||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await N(`/repos/${e}/${n}/pulls/${i}/comments/${s}/replies`,{method:"POST",body:{body:String(o)}});return JSON.stringify({ok:!0,id:a.id,url:a.html_url,inReplyTo:a.in_reply_to_id})}case"github_reply_issue_comment":{let{owner:e,repo:n,number:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:e,repo:n,number:i,body:s,event:o,comments:a}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let c=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(c))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let l=Array.isArray(a)?a.filter(b=>b&&b.path&&b.body&&(b.line!=null||b.position!=null)).map(b=>{let g={path:b.path,body:String(b.body)};return b.line!=null?(g.line=Number(b.line),g.side=b.side==="LEFT"?"LEFT":"RIGHT"):g.position=Number(b.position),g}):[];if(c!=="APPROVE"&&!s&&l.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let d=new Set,p=null;try{for(let b=1;b<=20;b+=1){let g=await N(`/repos/${e}/${n}/pulls/${i}/comments?per_page=100&page=${b}`);if(!Array.isArray(g)||g.length===0)break;for(let w of g){let O=xt(w.body);O&&d.add(O)}if(g.length<100)break}for(let b=1;b<=20&&p==null;b+=1){let g=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=100&page=${b}`);if(!Array.isArray(g)||g.length===0)break;for(let w of g)if(jt(w.body)){p=w.id;break}if(g.length<100)break}}catch{}let u=!1,m=!1;if(s){let b=`${String(s)}${Et}`;try{p!=null?(await N(`/repos/${e}/${n}/issues/comments/${p}`,{method:"PATCH",body:{body:b}}),u=!0):await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:b}}),m=!0}catch{}}let{toPost:f,skipped:h}=Lt(l,d),_=f.map(({_fp:b,...g})=>g),y=null;if(_.length>0||c==="APPROVE"||c==="REQUEST_CHANGES"){let b={event:c};_.length>0&&(b.comments=_),_.length===0&&c==="REQUEST_CHANGES"&&(b.body="Changes requested \u2014 see the review summary comment."),y=await N(`/repos/${e}/${n}/pulls/${i}/reviews`,{method:"POST",body:b})}return JSON.stringify({ok:!0,id:y?y.id:void 0,state:y?y.state:void 0,event:c,notePosted:m,summaryUpdated:u,commentsPosted:_.length,inlineSkipped:h||void 0,url:y?y.html_url:void 0})}case"github_list_commits":{let{owner:e,repo:n,branch:i,path:s,limit:o,since:a,until:c,page:l}=t;if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let d=Math.min(Number(o)||20,100),p=`/repos/${e}/${n}/commits?per_page=${d}&page=${Number(l)||1}`;i&&(p+=`&sha=${encodeURIComponent(i)}`),s&&(p+=`&path=${encodeURIComponent(s)}`),a&&(p+=`&since=${encodeURIComponent(a)}`),c&&(p+=`&until=${encodeURIComponent(c)}`);let u=await N(p);return JSON.stringify({total:u.length,page:Number(l)||1,hasMore:u.length>=d,commits:u.map(m=>({sha:m.sha?.slice(0,8),fullSha:m.sha,message:m.commit?.message?.slice(0,300),author:m.commit?.author?.name,authorEmail:m.commit?.author?.email,date:m.commit?.author?.date,url:m.html_url}))})}case"github_get_commit":{let{owner:e,repo:n,sha:i,includePrs:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and sha are required"});let o=await N(`/repos/${e}/${n}/commits/${i}`),a;if(s)try{let c=await N(`/repos/${e}/${n}/commits/${i}/pulls`);a=(Array.isArray(c)?c:[]).map(l=>({number:l.number,title:l.title,state:l.state,merged:!!l.merged_at,webUrl:l.html_url}))}catch{a=[]}return JSON.stringify({sha:o.sha?.slice(0,8),message:o.commit?.message,author:o.commit?.author?.name,date:o.commit?.author?.date,stats:o.stats,files:(o.files||[]).map(c=>({filename:c.filename,status:c.status,additions:c.additions,deletions:c.deletions,patch:c.patch?.slice(0,3e3)})),...a?{pullRequests:a}:{}})}case"github_get_file":{let{owner:e,repo:n,path:i,ref:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${n}/contents/${encodeURIComponent(i)}`;s&&(o+=`?ref=${encodeURIComponent(s)}`);let a=await N(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:i,entries:a.map(d=>({name:d.name,type:d.type,size:d.size,path:d.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),l=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:l?c.slice(0,2e4):c,truncated:l})}case"github_get_user":try{let e=await N("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let n=e.repositories[0],i=n.owner.login,s=n.owner.type,o=s==="Organization"?`/orgs/${i}`:`/users/${i}`,a=await N(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:s,isOrg:s==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let n=(await N("/installation/repositories?per_page=100")).repositories||[],i=new Map;for(let o of n)o.owner.type==="Organization"&&(i.has(o.owner.login)||i.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let s=Array.from(i.values());return JSON.stringify({count:s.length,orgs:s,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let f=function(b){let g=b.replace(/^~(?=$|\/|\\)/,m);return a(g)},{owner:e,repo:n,destination:i}=t;if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let{execSync:s}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:l}=await import("fs"),{homedir:d,platform:p}=await import("os"),{token:u}=await Ln("github"),m=d(),h=i?f(i):o(m,"zibby-repos"),_=o(h,n);if(l(h,{recursive:!0}),c(_))return JSON.stringify({error:`Directory ${_} already exists. Remove it first or use a different destination.`,existingPath:_});let y=`https://x-access-token:${u}@github.com/${e}/${n}.git`;try{s(`git clone ${y} "${_}"`,{stdio:"pipe"});let b=`https://github.com/${e}/${n}.git`;tt(s,_,b,u,"github_clone");let g=p()==="win32",w;return g?w=s(`dir "${_}"`,{encoding:"utf-8",shell:"cmd.exe"}):w=s(`ls -la "${_}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:_,message:`Cloned ${e}/${n} to ${_}`,contents:w.split(`
132
132
  `).slice(0,30).join(`
133
- `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(b){let k=String(b.message||b).split(u).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${k}`})}}case"github_search_repos":{let{query:e,limit:n}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),s=JSON.parse(i);if(s.error)return JSON.stringify(s);let o=e.toLowerCase(),a=s.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,n||20)})}case"github_list_repos":{let{owner:e,type:n,sort:i,direction:s,limit:o,query:a}=t,c=100,l=o||200,d=[],p=g=>({name:g.name,fullName:g.full_name,private:g.private,description:g.description,language:g.language,defaultBranch:g.default_branch,updatedAt:g.updated_at,stars:g.stargazers_count,url:g.html_url,fullPath:g.full_name,webUrl:g.html_url,visibility:g.visibility||(g.private?"private":"public")}),u=g=>{if(!a)return!0;let k=String(a).toLowerCase();return g.name&&g.name.toLowerCase().includes(k)||g.fullName&&g.fullName.toLowerCase().includes(k)||g.description&&g.description.toLowerCase().includes(k)};if(!e){let g=1,k=!0;for(;k&&d.length<l;){let M=`/installation/repositories?per_page=${c}&page=${g}`,Ie=(await N(M)).repositories||[];if(Ie.length===0)break;d=d.concat(Ie),k=Ie.length===c,g++}let O=d.map(p).filter(u),q=O.slice(0,l),ye=O.length>q.length,T=q.filter(M=>M.private).length,A=q.filter(M=>!M.private).length;return JSON.stringify({count:q.length,repos:q,truncated:ye,privateCount:T,publicCount:A,message:`Found ${T} private and ${A} public repos`})}let m=await N(`/orgs/${e}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&d.length<l;){let g;m?g=`/orgs/${e}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`:g=`/users/${e}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`;let k=await N(g),O=Array.isArray(k)?k:[];if(O.length===0)break;d=d.concat(O),h=O.length===c,f++}let _=d.map(p).filter(u),y=_.slice(0,l),b=_.length>y.length;return JSON.stringify({count:y.length,repos:y,truncated:b})}case"github_create_pr":{let{owner:e,repo:n,head:i,title:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=t.base;if(!o)try{o=(await N(`/repos/${e}/${n}`)).default_branch||"main"}catch{o="main"}let a={title:String(s),head:String(i),base:String(o),body:t.body?String(t.body):"",draft:!!t.draft};try{let c=await N(`/repos/${e}/${n}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${e}/${n}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let l=String(c.message||c);if(/GitHub API 422/.test(l))return JSON.stringify({success:!1,branch:i,base:o,repo:`${e}/${n}`,provider:"github",skippedReason:l});throw c}}case"github_merge_pr":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=t.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(s))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${s})`});let o={merge_method:s};t.commitTitle&&(o.commit_title=String(t.commitTitle)),t.commitMessage&&(o.commit_message=String(t.commitMessage));try{let a=await N(`/repos/${e}/${n}/pulls/${i}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:i,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:i,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:n,title:i,body:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await N(`/repos/${e}/${n}/issues`,{method:"POST",body:{title:i,body:s||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:n,state:i,labels:s,since:o,assignee:a,sort:c,direction:l,limit:d}=t||{};if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",i||"open"),p.set("per_page",String(d||30)),p.set("sort",c||"updated"),p.set("direction",l||"desc"),s&&p.set("labels",Array.isArray(s)?s.join(","):s),o&&p.set("since",o),a&&p.set("assignee",a);let u=await N(`/repos/${e}/${n}/issues?${p.toString()}`),m=(Array.isArray(u)?u:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(h=>typeof h=="string"?h:h.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(h=>h.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/issues/${i}`);return s.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:s.number,title:s.title,body:s.body||"",state:s.state,stateReason:s.state_reason||null,labels:(s.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:s.assignee?.login||null,assignees:(s.assignees||[]).map(o=>o.login),user:s.user?.login,milestone:s.milestone?.title||null,comments:s.comments,url:s.html_url,createdAt:s.created_at,updatedAt:s.updated_at,closedAt:s.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:n,number:i,limit:s}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=${s||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:n,number:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:s}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:n,number:i,stateReason:s}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};s&&(o.state_reason=s);let a=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:s.number,state:s.state,url:s.html_url})}case"github_label_issue":{let{owner:e,repo:n,number:i,labels:s,mode:o}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(s)?s:s?[s]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let d=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:d.number,labels:(d.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await N(`/repos/${e}/${n}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let d=await N(`/repos/${e}/${n}/issues/${i}`);return JSON.stringify({ok:!0,number:d.number,labels:(d.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let l=await N(`/repos/${e}/${n}/issues/${i}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(l)?l:[]).map(d=>typeof d=="string"?d:d.name)})}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 the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). Optionally filtered by file path.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};import{existsSync as za}from"fs";import{AsyncLocalStorage as Ya}from"async_hooks";import{fileURLToPath as Wa}from"url";import{dirname as Za,resolve as Va}from"path";function Xa(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Za(Wa(import.meta.url)),t=Va(r,"..","bin","mcp-skill.mjs");return za(t)?t:null}function rt(r){return String(r??"").trim().replace(/^\/+|\/+$/g,"").toLowerCase()}var $t=null;function Qa(r){let t;try{t=JSON.parse(r)}catch{throw new Error("GITLAB_INSTANCES is set but is not valid JSON. Expected an array of { host, token, repos: [...] }.")}if(!Array.isArray(t)||t.length===0)throw new Error("GITLAB_INSTANCES must be a non-empty JSON array of { host, token, repos: [...] }.");let e=[],n=new Map;return t.forEach((i,s)=>{let o=i&&typeof i.host=="string"?i.host.trim().replace(/\/+$/,""):"",a=i&&typeof i.token=="string"?i.token.trim():"",c=i&&Array.isArray(i.repos)?i.repos:null;if(!o)throw new Error(`GITLAB_INSTANCES[${s}] is missing "host".`);if(!a)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) is missing "token".`);if(!c||c.length===0)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) declares no "repos" \u2014 an entry that routes nothing is a config error, not an empty selection.`);let l=o.replace(/\/api\/v\d+$/,""),d=new Set;for(let p of c){let u=rt(p);if(!u)continue;let m=n.get(u);if(m!==void 0&&m!==s)throw new Error(`GITLAB_INSTANCES claims "${u}" on more than one server (${e[m].webHost} and ${l}). A repo path must name exactly one server.`);n.set(u,s),d.add(u)}if(d.size===0)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) declares no usable "repos".`);e.push({webHost:l,apiBase:/\/api\/v\d+$/.test(o)?o:`${l}/api/v4`,token:a,repos:d})}),e}function Pt(){let r=process.env.GITLAB_INSTANCES;if(typeof r!="string"||!r.trim())return null;if($t&&$t.raw===r)return $t.value;let t=Qa(r);return $t={raw:r,value:t},t}var Ct=new Ya,ec="GitLab: this call was not routed to a connected server. With GITLAB_INSTANCES set, every call must name a project one of the declared servers owns.";function Ut(){let r=Ct.getStore();if(r)return r;if(Pt())throw new Error(ec);return null}function tc(){let r=Ut();if(r)return r.apiBase;let t=process.env.GITLAB_API_URL;if(t)return t.replace(/\/+$/,"");let e=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(e)?e:`${e}/api/v4`}function rc(){let r=Ut();if(r)return{"PRIVATE-TOKEN":r.token};if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let t=process.env.GITLAB_TOKEN;if(!t)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":t}}async function R(r,t={}){let e=/^https?:\/\//.test(r)?r:`${tc()}${r}`,n={Accept:"application/json","User-Agent":"Zibby-App",...rc(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:n,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${s.slice(0,300)}`)}return t.raw?i.text():i.json()}function $n(){let r=Ut();if(r)return r.webHost;let t=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(t?t.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function nc(){let r=Ut();return r?r.token:process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function L(r){let t=String(r);return/^\d+$/.test(t)?t:encodeURIComponent(t)}function Un(){let r=Pt();if(r){let n=new Set;for(let i of r)for(let s of i.repos)n.add(s);return n}let t=process.env.GITLAB_ALLOWED_REPOS;if(typeof t!="string"||!t.trim())return null;let e=new Set(t.split(",").map(rt).filter(Boolean));return e.size?e:null}function Bn(r,t){if(!r)return!0;let e=rt(t);return e!==""&&r.has(e)}function ic(r){if(!r||typeof r!="object")return null;for(let t of["projectPath","projectId","project","repo","repoPath"]){let e=r[t];if(e!=null&&String(e).trim()!=="")return String(e).trim()}return null}async function Pn(r){if(!/^\d+$/.test(r))return r;try{let t=await R(`/projects/${L(r)}`);return t&&t.path_with_namespace||null}catch{return null}}async function sc(r,t){if(!t)return{path:await Pn(r),instance:null};if(!/^\d+$/.test(r)){let n=rt(r);return{path:r,instance:t.find(i=>i.repos.has(n))||null}}let e=null;for(let n of t){let i=await Ct.run(n,()=>Pn(r));if(i&&(e===null&&(e=i),n.repos.has(rt(i))))return{path:i,instance:n}}return{path:e,instance:null}}async function Cn(r,t){switch(r){case"gitlab_clone":{let{projectPath:e,projectId:n,destination:i,branch:s}=t||{},o=e&&String(e).trim();if(!o&&n!=null&&(/^\d+$/.test(String(n))?o=(await R(`/projects/${L(n)}`))?.path_with_namespace:o=String(n).trim()),!o)return JSON.stringify({error:'projectPath (e.g. "group/repo") or a numeric projectId is required'});let a=nc();if(!a)return JSON.stringify({error:"GitLab is not connected (no token to authenticate the clone)."});let{execSync:c}=await import("child_process"),{join:l,resolve:d}=await import("path"),{existsSync:p,mkdirSync:u}=await import("fs"),m=i?d(i):d(process.cwd(),".zibby","repos"),f=o.split("/").filter(Boolean).pop(),h=l(m,f);if(u(m,{recursive:!0}),p(h))return JSON.stringify({success:!0,path:h,message:`Already cloned at ${h}`,alreadyCloned:!0});let _=$n().replace(/^https?:\/\//,""),y=$n().startsWith("http://")?"http":"https",b=`${y}://oauth2:${a}@${_}/${o}.git`,g=s?`--branch "${String(s).replace(/"/g,"")}" `:"";try{c(`git clone --depth 1 ${g}${b} "${h}"`,{stdio:"pipe",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}});let k=`${y}://${_}/${o}.git`;tt(c,h,k,a,"gitlab_clone");let O=c(`ls -la "${h}"`,{encoding:"utf-8"});return JSON.stringify({success:!0,path:h,message:`Cloned ${o} to ${h}`,contents:O.split(`
133
+ `),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(b){let w=String(b.message||b).split(u).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${w}`})}}case"github_search_repos":{let{query:e,limit:n}=t;if(!e)return JSON.stringify({error:"query is required"});let i=await this.handleToolCall("github_list_repos",{limit:200},{}),s=JSON.parse(i);if(s.error)return JSON.stringify(s);let o=e.toLowerCase(),a=s.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,n||20)})}case"github_list_repos":{let{owner:e,type:n,sort:i,direction:s,limit:o,query:a}=t,c=100,l=o||200,d=[],p=g=>({name:g.name,fullName:g.full_name,private:g.private,description:g.description,language:g.language,defaultBranch:g.default_branch,updatedAt:g.updated_at,stars:g.stargazers_count,url:g.html_url,fullPath:g.full_name,webUrl:g.html_url,visibility:g.visibility||(g.private?"private":"public")}),u=g=>{if(!a)return!0;let w=String(a).toLowerCase();return g.name&&g.name.toLowerCase().includes(w)||g.fullName&&g.fullName.toLowerCase().includes(w)||g.description&&g.description.toLowerCase().includes(w)};if(!e){let g=1,w=!0;for(;w&&d.length<l;){let M=`/installation/repositories?per_page=${c}&page=${g}`,Ie=(await N(M)).repositories||[];if(Ie.length===0)break;d=d.concat(Ie),w=Ie.length===c,g++}let O=d.map(p).filter(u),q=O.slice(0,l),ye=O.length>q.length,T=q.filter(M=>M.private).length,A=q.filter(M=>!M.private).length;return JSON.stringify({count:q.length,repos:q,truncated:ye,privateCount:T,publicCount:A,message:`Found ${T} private and ${A} public repos`})}let m=await N(`/orgs/${e}`).then(()=>!0).catch(()=>!1),f=1,h=!0;for(;h&&d.length<l;){let g;m?g=`/orgs/${e}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`:g=`/users/${e}/repos?per_page=${c}&page=${f}&type=${n||"all"}&sort=${i||"updated"}&direction=${s||"desc"}`;let w=await N(g),O=Array.isArray(w)?w:[];if(O.length===0)break;d=d.concat(O),h=O.length===c,f++}let _=d.map(p).filter(u),y=_.slice(0,l),b=_.length>y.length;return JSON.stringify({count:y.length,repos:y,truncated:b})}case"github_create_pr":{let{owner:e,repo:n,head:i,title:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=t.base;if(!o)try{o=(await N(`/repos/${e}/${n}`)).default_branch||"main"}catch{o="main"}let a={title:String(s),head:String(i),base:String(o),body:t.body?String(t.body):"",draft:!!t.draft};try{let c=await N(`/repos/${e}/${n}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:i,base:o,repo:`${e}/${n}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let l=String(c.message||c);if(/GitHub API 422/.test(l))return JSON.stringify({success:!1,branch:i,base:o,repo:`${e}/${n}`,provider:"github",skippedReason:l});throw c}}case"github_merge_pr":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=t.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(s))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${s})`});let o={merge_method:s};t.commitTitle&&(o.commit_title=String(t.commitTitle)),t.commitMessage&&(o.commit_message=String(t.commitMessage));try{let a=await N(`/repos/${e}/${n}/pulls/${i}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:i,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:i,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:n,title:i,body:s}=t;if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and title are required"});let o=await N(`/repos/${e}/${n}/issues`,{method:"POST",body:{title:i,body:s||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:n,state:i,labels:s,since:o,assignee:a,sort:c,direction:l,limit:d}=t||{};if(!e||!n)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",i||"open"),p.set("per_page",String(d||30)),p.set("sort",c||"updated"),p.set("direction",l||"desc"),s&&p.set("labels",Array.isArray(s)?s.join(","):s),o&&p.set("since",o),a&&p.set("assignee",a);let u=await N(`/repos/${e}/${n}/issues?${p.toString()}`),m=(Array.isArray(u)?u:[]).filter(f=>!f.pull_request).map(f=>({number:f.number,title:f.title,state:f.state,labels:(f.labels||[]).map(h=>typeof h=="string"?h:h.name),assignee:f.assignee?.login||null,assignees:(f.assignees||[]).map(h=>h.login),user:f.user?.login,comments:f.comments,url:f.html_url,createdAt:f.created_at,updatedAt:f.updated_at}));return JSON.stringify({count:m.length,issues:m})}case"github_get_issue":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/issues/${i}`);return s.pull_request?JSON.stringify({error:`#${i} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:s.number,title:s.title,body:s.body||"",state:s.state,stateReason:s.state_reason||null,labels:(s.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:s.assignee?.login||null,assignees:(s.assignees||[]).map(o=>o.login),user:s.user?.login,milestone:s.milestone?.title||null,comments:s.comments,url:s.html_url,createdAt:s.created_at,updatedAt:s.updated_at,closedAt:s.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:n,number:i,limit:s}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments?per_page=${s||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:n,number:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await N(`/repos/${e}/${n}/issues/${i}/comments`,{method:"POST",body:{body:s}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:n,number:i,stateReason:s}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};s&&(o.state_reason=s);let a=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:n,number:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let s=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:s.number,state:s.state,url:s.html_url})}case"github_label_issue":{let{owner:e,repo:n,number:i,labels:s,mode:o}=t||{};if(!e||!n||!i)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(s)?s:s?[s]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let d=await N(`/repos/${e}/${n}/issues/${i}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:d.number,labels:(d.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await N(`/repos/${e}/${n}/issues/${i}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let d=await N(`/repos/${e}/${n}/issues/${i}`);return JSON.stringify({ok:!0,number:d.number,labels:(d.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let l=await N(`/repos/${e}/${n}/issues/${i}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:i,labels:(Array.isArray(l)?l:[]).map(d=>typeof d=="string"?d:d.name)})}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 the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). Optionally filtered by file path.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};import{existsSync as za}from"fs";import{AsyncLocalStorage as Ya}from"async_hooks";import{fileURLToPath as Wa}from"url";import{dirname as Za,resolve as Va}from"path";function Xa(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Za(Wa(import.meta.url)),t=Va(r,"..","bin","mcp-skill.mjs");return za(t)?t:null}function rt(r){return String(r??"").trim().replace(/^\/+|\/+$/g,"").toLowerCase()}var $t=null;function Qa(r){let t;try{t=JSON.parse(r)}catch{throw new Error("GITLAB_INSTANCES is set but is not valid JSON. Expected an array of { host, token, repos: [...] }.")}if(!Array.isArray(t)||t.length===0)throw new Error("GITLAB_INSTANCES must be a non-empty JSON array of { host, token, repos: [...] }.");let e=[],n=new Map;return t.forEach((i,s)=>{let o=i&&typeof i.host=="string"?i.host.trim().replace(/\/+$/,""):"",a=i&&typeof i.token=="string"?i.token.trim():"",c=i&&Array.isArray(i.repos)?i.repos:null;if(!o)throw new Error(`GITLAB_INSTANCES[${s}] is missing "host".`);if(!a)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) is missing "token".`);if(!c||c.length===0)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) declares no "repos" \u2014 an entry that routes nothing is a config error, not an empty selection.`);let l=o.replace(/\/api\/v\d+$/,""),d=new Set;for(let p of c){let u=rt(p);if(!u)continue;let m=n.get(u);if(m!==void 0&&m!==s)throw new Error(`GITLAB_INSTANCES claims "${u}" on more than one server (${e[m].webHost} and ${l}). A repo path must name exactly one server.`);n.set(u,s),d.add(u)}if(d.size===0)throw new Error(`GITLAB_INSTANCES[${s}] (${o}) declares no usable "repos".`);e.push({webHost:l,apiBase:/\/api\/v\d+$/.test(o)?o:`${l}/api/v4`,token:a,repos:d})}),e}function Pt(){let r=process.env.GITLAB_INSTANCES;if(typeof r!="string"||!r.trim())return null;if($t&&$t.raw===r)return $t.value;let t=Qa(r);return $t={raw:r,value:t},t}var Ct=new Ya,ec="GitLab: this call was not routed to a connected server. With GITLAB_INSTANCES set, every call must name a project one of the declared servers owns.";function Ut(){let r=Ct.getStore();if(r)return r;if(Pt())throw new Error(ec);return null}function tc(){let r=Ut();if(r)return r.apiBase;let t=process.env.GITLAB_API_URL;if(t)return t.replace(/\/+$/,"");let e=(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||"https://gitlab.com").trim().replace(/\/+$/,"");return/\/api\/v\d+$/.test(e)?e:`${e}/api/v4`}function rc(){let r=Ut();if(r)return{"PRIVATE-TOKEN":r.token};if(process.env.GITLAB_OAUTH_TOKEN)return{Authorization:`Bearer ${process.env.GITLAB_OAUTH_TOKEN}`};let t=process.env.GITLAB_TOKEN;if(!t)throw new Error("GitLab is not connected: set GITLAB_TOKEN (personal/project access token, api scope) or GITLAB_OAUTH_TOKEN.");return{"PRIVATE-TOKEN":t}}async function R(r,t={}){let e=/^https?:\/\//.test(r)?r:`${tc()}${r}`,n={Accept:"application/json","User-Agent":"Zibby-App",...rc(),...t.body?{"Content-Type":"application/json"}:{}},i=await fetch(e,{method:t.method||"GET",headers:n,body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`GitLab API ${i.status}: ${s.slice(0,300)}`)}return t.raw?i.text():i.json()}function $n(){let r=Ut();if(r)return r.webHost;let t=process.env.GITLAB_API_URL;return(process.env.GITLAB_URL||process.env.GITLAB_INSTANCE_URL||(t?t.replace(/\/api\/v\d+\/?$/,""):"")||"https://gitlab.com").trim().replace(/\/+$/,"").replace(/\/api\/v\d+$/,"")}function nc(){let r=Ut();return r?r.token:process.env.GITLAB_OAUTH_TOKEN||process.env.GITLAB_TOKEN||null}function L(r){let t=String(r);return/^\d+$/.test(t)?t:encodeURIComponent(t)}function Un(){let r=Pt();if(r){let n=new Set;for(let i of r)for(let s of i.repos)n.add(s);return n}let t=process.env.GITLAB_ALLOWED_REPOS;if(typeof t!="string"||!t.trim())return null;let e=new Set(t.split(",").map(rt).filter(Boolean));return e.size?e:null}function Bn(r,t){if(!r)return!0;let e=rt(t);return e!==""&&r.has(e)}function ic(r){if(!r||typeof r!="object")return null;for(let t of["projectPath","projectId","project","repo","repoPath"]){let e=r[t];if(e!=null&&String(e).trim()!=="")return String(e).trim()}return null}async function Pn(r){if(!/^\d+$/.test(r))return r;try{let t=await R(`/projects/${L(r)}`);return t&&t.path_with_namespace||null}catch{return null}}async function sc(r,t){if(!t)return{path:await Pn(r),instance:null};if(!/^\d+$/.test(r)){let n=rt(r);return{path:r,instance:t.find(i=>i.repos.has(n))||null}}let e=null;for(let n of t){let i=await Ct.run(n,()=>Pn(r));if(i&&(e===null&&(e=i),n.repos.has(rt(i))))return{path:i,instance:n}}return{path:e,instance:null}}async function Cn(r,t){switch(r){case"gitlab_clone":{let{projectPath:e,projectId:n,destination:i,branch:s}=t||{},o=e&&String(e).trim();if(!o&&n!=null&&(/^\d+$/.test(String(n))?o=(await R(`/projects/${L(n)}`))?.path_with_namespace:o=String(n).trim()),!o)return JSON.stringify({error:'projectPath (e.g. "group/repo") or a numeric projectId is required'});let a=nc();if(!a)return JSON.stringify({error:"GitLab is not connected (no token to authenticate the clone)."});let{execSync:c}=await import("child_process"),{join:l,resolve:d}=await import("path"),{existsSync:p,mkdirSync:u}=await import("fs"),m=i?d(i):d(process.cwd(),".zibby","repos"),f=o.split("/").filter(Boolean).pop(),h=l(m,f);if(u(m,{recursive:!0}),p(h))return JSON.stringify({success:!0,path:h,message:`Already cloned at ${h}`,alreadyCloned:!0});let _=$n().replace(/^https?:\/\//,""),y=$n().startsWith("http://")?"http":"https",b=`${y}://oauth2:${a}@${_}/${o}.git`,g=s?`--branch "${String(s).replace(/"/g,"")}" `:"";try{c(`git clone --depth 1 ${g}${b} "${h}"`,{stdio:"pipe",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}});let w=`${y}://${_}/${o}.git`;tt(c,h,w,a,"gitlab_clone");let O=c(`ls -la "${h}"`,{encoding:"utf-8"});return JSON.stringify({success:!0,path:h,message:`Cloned ${o} to ${h}`,contents:O.split(`
134
134
  `).slice(0,30).join(`
135
- `)})}catch(k){let O=String(k.message||k).split(a).join("***").replace(/oauth2:[^@]*@/g,"oauth2:***@");return JSON.stringify({error:`Clone failed: ${O}`})}}case"gitlab_create_mr":{let e=t?.project??t?.projectId,n=t?.source_branch??t?.sourceBranch,{title:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let s=L(e),o=t?.target_branch??t?.targetBranch;if(!o)try{o=(await R(`/projects/${s}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(n),target_branch:String(o),title:String(i),description:t?.description?String(t.description):""};try{let c=await R(`/projects/${s}/merge_requests`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.web_url,number:c.iid,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",state:c.state})}catch(c){let l=String(c.message||c);if(/GitLab API (409|400)/.test(l))return JSON.stringify({success:!1,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",skippedReason:l});throw c}}case"gitlab_accept_mr":{let e=t?.project??t?.projectId,{iid:n}=t||{};if(!e||!n)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=L(e),s={};t.squash!=null&&(s.squash=!!t.squash),t.mergeCommitMessage&&(s.merge_commit_message=String(t.mergeCommitMessage)),t.mergeWhenPipelineSucceeds!=null&&(s.merge_when_pipeline_succeeds=!!t.mergeWhenPipelineSucceeds);try{let o=await R(`/projects/${i}/merge_requests/${n}/merge`,{method:"PUT",body:s});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??n,project:String(e),provider:"gitlab",state:o.state})}catch(o){let a=String(o.message||o);if(/GitLab API (405|406|404)/.test(a))return JSON.stringify({success:!1,iid:n,project:String(e),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/merge_requests/${n}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/merge_requests/${n}/changes`),s=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:s.length,diffRefs:i.diff_refs||null,files:s.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_commits":{let{projectId:e,since:n,until:i,refName:s,page:o,perPage:a,withStats:c}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let l=new URLSearchParams;l.set("per_page",String(Math.min(Number(a)||50,100))),l.set("page",String(Number(o)||1)),n&&l.set("since",n),i&&l.set("until",i),s&&l.set("ref_name",s),c!==!1&&l.set("with_stats","true");let d=await R(`/projects/${L(e)}/repository/commits?${l.toString()}`),p=(Array.isArray(d)?d:[]).map(u=>({id:u.id,shortId:u.short_id,title:u.title,authorName:u.author_name,authorEmail:u.author_email,authoredDate:u.authored_date,committedDate:u.committed_date,parentIds:Array.isArray(u.parent_ids)?u.parent_ids:[],stats:u.stats||null}));return JSON.stringify({page:Number(o)||1,count:p.length,hasMore:p.length>=Math.min(Number(a)||50,100),commits:p})}case"gitlab_get_commit":{let{projectId:e,sha:n,includeDiff:i,includeMrs:s}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and sha are required"});let o=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}`),a;if(s)try{let l=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}/merge_requests`);a=(Array.isArray(l)?l:[]).map(d=>({iid:d.iid,title:d.title,state:d.state,webUrl:d.web_url}))}catch{a=[]}let c;if(i!==!1){let l=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}/diff`);c=(Array.isArray(l)?l:[]).map(d=>({oldPath:d.old_path,newPath:d.new_path,newFile:!!d.new_file,deletedFile:!!d.deleted_file,renamedFile:!!d.renamed_file,diff:typeof d.diff=="string"?d.diff.slice(0,3e3):""}))}return JSON.stringify({id:o.id,shortId:o.short_id,title:o.title,message:typeof o.message=="string"?o.message.slice(0,2e3):"",authorName:o.author_name,authorEmail:o.author_email,authoredDate:o.authored_date,committedDate:o.committed_date,parentIds:Array.isArray(o.parent_ids)?o.parent_ids:[],stats:o.stats||null,webUrl:o.web_url,...c?{filesChanged:c.length,files:c}:{},...a?{mergeRequests:a}:{}})}case"gitlab_list_mrs":{let{projectId:e,state:n,targetBranch:i,sourceBranch:s,authorUsername:o,labels:a,search:c,sort:l,orderBy:d,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"opened"),u.set("per_page",String(p||20)),u.set("order_by",d||"updated_at"),u.set("sort",l||"desc"),i&&u.set("target_branch",i),s&&u.set("source_branch",s),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await R(`/projects/${L(e)}/merge_requests?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,author:h.author?.username,sourceBranch:h.source_branch,targetBranch:h.target_branch,draft:h.draft??h.work_in_progress??!1,labels:Array.isArray(h.labels)?h.labels:[],webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:n,limit:i}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(s)?s.length:0,notes:(Array.isArray(s)?s:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:n,body:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:n,path:i,oldPath:s,newLine:o,oldLine:a,body:c}=t||{};if(!e||!n||!i||!c)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&a==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let l=L(e),d=t.diffRefs||null;if(d||(d=(await R(`/projects/${l}/merge_requests/${n}`)).diff_refs||null),!d||!d.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let p={base_sha:d.base_sha,start_sha:d.start_sha,head_sha:d.head_sha,position_type:"text",new_path:i,old_path:s||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await R(`/projects/${l}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(c),position:p}});return JSON.stringify({ok:!0,discussionId:u.id})}catch(u){return JSON.stringify({ok:!1,error:`inline anchor rejected (${u.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:n,body:i,comments:s}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let o=L(e),a=Array.isArray(s)?s.filter(y=>y&&y.path&&y.body&&(y.newLine!=null||y.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=t.diffRefs||null;a.length>0&&!c&&(c=(await R(`/projects/${o}/merge_requests/${n}`)).diff_refs||null);let l=new Set,d=null;try{for(let y=1;y<=20;y+=1){let b=await R(`/projects/${o}/merge_requests/${n}/discussions?per_page=100&page=${y}`);if(!Array.isArray(b)||b.length===0)break;for(let g of b)for(let k of g.notes||[]){let O=xt(k.body);O&&l.add(O),d==null&&jt(k.body)&&(d=k.id)}if(b.length<100)break}}catch{}let p=!1,u=!1;if(i){let y=`${String(i)}${Et}`;try{d!=null?(await R(`/projects/${o}/merge_requests/${n}/notes/${d}`,{method:"PUT",body:{body:y}}),u=!0):await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:y}}),p=!0}catch{await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:y}}),p=!0}}let{toPost:m,skipped:f}=Lt(a,l),h=0,_=[];if(m.length>0&&c)for(let y of m){let b={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:y.path,old_path:y.oldPath||y.path};y.newLine!=null&&(b.new_line=Number(y.newLine)),y.oldLine!=null&&(b.old_line=Number(y.oldLine));try{await R(`/projects/${o}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(y.body),position:b}}),h+=1}catch(g){_.push(`${y.path}:${y.newLine??y.oldLine} \u2014 ${g.message}`)}}else m.length>0&&!c&&_.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:p,summaryUpdated:u,inlinePosted:h,inlineSkipped:f||void 0,inlineErrors:_.length?_:void 0})}case"gitlab_get_discussion":{let{projectId:e,iid:n,discussionId:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(s.notes)?s.notes:[],a=o.find(l=>l.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:s.id,individualNote:!!s.individual_note,path:c&&(c.new_path||c.old_path)||null,newLine:c?c.new_line??null:null,oldLine:c?c.old_line??null:null,diffRefs:c?{base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha}:null,notes:o.map(l=>({id:l.id,author:l.author?.username,body:(l.body||"").slice(0,4e3),system:!!l.system,createdAt:l.created_at}))})}case"gitlab_reply_discussion":{let{projectId:e,iid:n,discussionId:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await R(`/projects/${L(e)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:e,limit:n}=t||{},i=Math.min(Number(n)>0?Number(n):50,200),s=new URLSearchParams;s.set("membership","true"),s.set("simple","true"),s.set("order_by","last_activity_at"),s.set("sort","desc"),s.set("per_page",String(Math.min(i+1,100))),e&&s.set("search",String(e));let o=async()=>{let u=await R(`/projects?${s.toString()}`);return Array.isArray(u)?u:[]},a=Pt(),c=Un(),l=[];for(let u of a||[null]){let m=u?await Ct.run(u,o):await o();for(let f of m)Bn(u?u.repos:c,f&&f.path_with_namespace)&&l.push({p:f,host:u?u.webHost:null})}let d=l.length>i,p=l.slice(0,i).map(({p:u,host:m})=>({fullPath:u.path_with_namespace,name:u.name,webUrl:u.web_url,defaultBranch:u.default_branch||null,visibility:u.visibility||null,...m?{host:m}:{}}));return JSON.stringify({count:p.length,truncated:d,projects:p})}case"gitlab_list_issues":{let{projectId:e,state:n,labels:i,assigneeUsername:s,authorUsername:o,updatedAfter:a,search:c,sort:l,orderBy:d,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"opened"),u.set("per_page",String(p||30)),u.set("order_by",d||"updated_at"),u.set("sort",l||"desc"),i&&u.set("labels",Array.isArray(i)?i.join(","):i),s&&u.set("assignee_username",s),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await R(`/projects/${L(e)}/issues?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,labels:Array.isArray(h.labels)?h.labels:[],author:h.author?.username,assignees:(h.assignees||[]).map(_=>_.username),userNotesCount:h.user_notes_count,webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/issues/${n}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(s=>s.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:n,body:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${L(e)}/issues/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}var De={id:"gitlab",callsBackend:!0,serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:I.GITLAB,envKeys:["GITLAB_TOKEN","GITLAB_OAUTH_TOKEN","GITLAB_URL","GITLAB_INSTANCE_URL","GITLAB_API_URL","GITLAB_ALLOWED_REPOS","GITLAB_INSTANCES","PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"GitLab \u2014 merge requests, diffs, MR reviews/discussions, issues",promptFragment:`## GitLab
135
+ `)})}catch(w){let O=String(w.message||w).split(a).join("***").replace(/oauth2:[^@]*@/g,"oauth2:***@");return JSON.stringify({error:`Clone failed: ${O}`})}}case"gitlab_create_mr":{let e=t?.project??t?.projectId,n=t?.source_branch??t?.sourceBranch,{title:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:'project (id or "group/repo" path), source_branch, and title are required'});let s=L(e),o=t?.target_branch??t?.targetBranch;if(!o)try{o=(await R(`/projects/${s}`)).default_branch||"main"}catch{o="main"}let a={source_branch:String(n),target_branch:String(o),title:String(i),description:t?.description?String(t.description):""};try{let c=await R(`/projects/${s}/merge_requests`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.web_url,number:c.iid,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",state:c.state})}catch(c){let l=String(c.message||c);if(/GitLab API (409|400)/.test(l))return JSON.stringify({success:!1,branch:a.source_branch,targetBranch:a.target_branch,project:String(e),provider:"gitlab",skippedReason:l});throw c}}case"gitlab_accept_mr":{let e=t?.project??t?.projectId,{iid:n}=t||{};if(!e||!n)return JSON.stringify({error:'project (id or "group/repo" path) and iid are required'});let i=L(e),s={};t.squash!=null&&(s.squash=!!t.squash),t.mergeCommitMessage&&(s.merge_commit_message=String(t.mergeCommitMessage)),t.mergeWhenPipelineSucceeds!=null&&(s.merge_when_pipeline_succeeds=!!t.mergeWhenPipelineSucceeds);try{let o=await R(`/projects/${i}/merge_requests/${n}/merge`,{method:"PUT",body:s});return JSON.stringify({success:!0,merged:!0,sha:o.merge_commit_sha??o.sha??null,iid:o.iid??n,project:String(e),provider:"gitlab",state:o.state})}catch(o){let a=String(o.message||o);if(/GitLab API (405|406|404)/.test(a))return JSON.stringify({success:!1,iid:n,project:String(e),provider:"gitlab",skippedReason:a});throw o}}case"gitlab_get_mr":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/merge_requests/${n}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,author:i.author?.username,sourceBranch:i.source_branch,targetBranch:i.target_branch,draft:i.draft??i.work_in_progress??!1,mergeStatus:i.merge_status,changesCount:i.changes_count,labels:Array.isArray(i.labels)?i.labels:[],webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,mergedAt:i.merged_at,diffRefs:i.diff_refs||null})}case"gitlab_get_mr_changes":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/merge_requests/${n}/changes`),s=Array.isArray(i.changes)?i.changes:[];return JSON.stringify({iid:i.iid,total:s.length,diffRefs:i.diff_refs||null,files:s.map(o=>({oldPath:o.old_path,newPath:o.new_path,newFile:!!o.new_file,deletedFile:!!o.deleted_file,renamedFile:!!o.renamed_file,diff:typeof o.diff=="string"?o.diff.slice(0,3e3):""}))})}case"gitlab_list_commits":{let{projectId:e,since:n,until:i,refName:s,page:o,perPage:a,withStats:c}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let l=new URLSearchParams;l.set("per_page",String(Math.min(Number(a)||50,100))),l.set("page",String(Number(o)||1)),n&&l.set("since",n),i&&l.set("until",i),s&&l.set("ref_name",s),c!==!1&&l.set("with_stats","true");let d=await R(`/projects/${L(e)}/repository/commits?${l.toString()}`),p=(Array.isArray(d)?d:[]).map(u=>({id:u.id,shortId:u.short_id,title:u.title,authorName:u.author_name,authorEmail:u.author_email,authoredDate:u.authored_date,committedDate:u.committed_date,parentIds:Array.isArray(u.parent_ids)?u.parent_ids:[],stats:u.stats||null}));return JSON.stringify({page:Number(o)||1,count:p.length,hasMore:p.length>=Math.min(Number(a)||50,100),commits:p})}case"gitlab_get_commit":{let{projectId:e,sha:n,includeDiff:i,includeMrs:s}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and sha are required"});let o=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}`),a;if(s)try{let l=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}/merge_requests`);a=(Array.isArray(l)?l:[]).map(d=>({iid:d.iid,title:d.title,state:d.state,webUrl:d.web_url}))}catch{a=[]}let c;if(i!==!1){let l=await R(`/projects/${L(e)}/repository/commits/${encodeURIComponent(n)}/diff`);c=(Array.isArray(l)?l:[]).map(d=>({oldPath:d.old_path,newPath:d.new_path,newFile:!!d.new_file,deletedFile:!!d.deleted_file,renamedFile:!!d.renamed_file,diff:typeof d.diff=="string"?d.diff.slice(0,3e3):""}))}return JSON.stringify({id:o.id,shortId:o.short_id,title:o.title,message:typeof o.message=="string"?o.message.slice(0,2e3):"",authorName:o.author_name,authorEmail:o.author_email,authoredDate:o.authored_date,committedDate:o.committed_date,parentIds:Array.isArray(o.parent_ids)?o.parent_ids:[],stats:o.stats||null,webUrl:o.web_url,...c?{filesChanged:c.length,files:c}:{},...a?{mergeRequests:a}:{}})}case"gitlab_list_mrs":{let{projectId:e,state:n,targetBranch:i,sourceBranch:s,authorUsername:o,labels:a,search:c,sort:l,orderBy:d,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"opened"),u.set("per_page",String(p||20)),u.set("order_by",d||"updated_at"),u.set("sort",l||"desc"),i&&u.set("target_branch",i),s&&u.set("source_branch",s),o&&u.set("author_username",o),a&&u.set("labels",Array.isArray(a)?a.join(","):a),c&&u.set("search",c);let m=await R(`/projects/${L(e)}/merge_requests?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,author:h.author?.username,sourceBranch:h.source_branch,targetBranch:h.target_branch,draft:h.draft??h.work_in_progress??!1,labels:Array.isArray(h.labels)?h.labels:[],webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,mergeRequests:f})}case"gitlab_list_mr_notes":{let{projectId:e,iid:n,limit:i}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/notes?per_page=${i||50}&sort=asc&order_by=created_at`);return JSON.stringify({total:Array.isArray(s)?s.length:0,notes:(Array.isArray(s)?s:[]).map(o=>({id:o.id,author:o.author?.username,body:(o.body||"").slice(0,1e3),system:!!o.system,createdAt:o.created_at}))})}case"gitlab_post_mr_note":{let{projectId:e,iid:n,body:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}case"gitlab_post_mr_discussion":{let{projectId:e,iid:n,path:i,oldPath:s,newLine:o,oldLine:a,body:c}=t||{};if(!e||!n||!i||!c)return JSON.stringify({error:"projectId, iid, path, and body are required"});if(o==null&&a==null)return JSON.stringify({error:"newLine (added/changed line) or oldLine (removed/context line) is required to anchor an inline comment"});let l=L(e),d=t.diffRefs||null;if(d||(d=(await R(`/projects/${l}/merge_requests/${n}`)).diff_refs||null),!d||!d.head_sha)return JSON.stringify({error:"could not resolve diff_refs for this MR \u2014 cannot anchor an inline comment. Use gitlab_post_mr_note instead."});let p={base_sha:d.base_sha,start_sha:d.start_sha,head_sha:d.head_sha,position_type:"text",new_path:i,old_path:s||i};o!=null&&(p.new_line=Number(o)),a!=null&&(p.old_line=Number(a));try{let u=await R(`/projects/${l}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(c),position:p}});return JSON.stringify({ok:!0,discussionId:u.id})}catch(u){return JSON.stringify({ok:!1,error:`inline anchor rejected (${u.message}). The line must be part of the MR diff. Fall back to gitlab_post_mr_note with the file/line in the text.`})}}case"gitlab_create_mr_review":{let{projectId:e,iid:n,body:i,comments:s}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let o=L(e),a=Array.isArray(s)?s.filter(y=>y&&y.path&&y.body&&(y.newLine!=null||y.oldLine!=null)):[];if(!i&&a.length===0)return JSON.stringify({error:"a review needs a body and/or inline comments"});let c=t.diffRefs||null;a.length>0&&!c&&(c=(await R(`/projects/${o}/merge_requests/${n}`)).diff_refs||null);let l=new Set,d=null;try{for(let y=1;y<=20;y+=1){let b=await R(`/projects/${o}/merge_requests/${n}/discussions?per_page=100&page=${y}`);if(!Array.isArray(b)||b.length===0)break;for(let g of b)for(let w of g.notes||[]){let O=xt(w.body);O&&l.add(O),d==null&&jt(w.body)&&(d=w.id)}if(b.length<100)break}}catch{}let p=!1,u=!1;if(i){let y=`${String(i)}${Et}`;try{d!=null?(await R(`/projects/${o}/merge_requests/${n}/notes/${d}`,{method:"PUT",body:{body:y}}),u=!0):await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:y}}),p=!0}catch{await R(`/projects/${o}/merge_requests/${n}/notes`,{method:"POST",body:{body:y}}),p=!0}}let{toPost:m,skipped:f}=Lt(a,l),h=0,_=[];if(m.length>0&&c)for(let y of m){let b={base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha,position_type:"text",new_path:y.path,old_path:y.oldPath||y.path};y.newLine!=null&&(b.new_line=Number(y.newLine)),y.oldLine!=null&&(b.old_line=Number(y.oldLine));try{await R(`/projects/${o}/merge_requests/${n}/discussions`,{method:"POST",body:{body:String(y.body),position:b}}),h+=1}catch(g){_.push(`${y.path}:${y.newLine??y.oldLine} \u2014 ${g.message}`)}}else m.length>0&&!c&&_.push("no diff_refs available \u2014 inline comments skipped (pass diffRefs from gitlab_get_mr)");return JSON.stringify({ok:!0,notePosted:p,summaryUpdated:u,inlinePosted:h,inlineSkipped:f||void 0,inlineErrors:_.length?_:void 0})}case"gitlab_get_discussion":{let{projectId:e,iid:n,discussionId:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and discussionId are required"});let s=await R(`/projects/${L(e)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}`),o=Array.isArray(s.notes)?s.notes:[],a=o.find(l=>l.position)||null,c=a?a.position:null;return JSON.stringify({discussionId:s.id,individualNote:!!s.individual_note,path:c&&(c.new_path||c.old_path)||null,newLine:c?c.new_line??null:null,oldLine:c?c.old_line??null:null,diffRefs:c?{base_sha:c.base_sha,start_sha:c.start_sha,head_sha:c.head_sha}:null,notes:o.map(l=>({id:l.id,author:l.author?.username,body:(l.body||"").slice(0,4e3),system:!!l.system,createdAt:l.created_at}))})}case"gitlab_reply_discussion":{let{projectId:e,iid:n,discussionId:i,body:s}=t||{};if(!e||!n||!i||!s)return JSON.stringify({error:"projectId, iid, discussionId, and body are required"});let o=await R(`/projects/${L(e)}/merge_requests/${n}/discussions/${encodeURIComponent(i)}/notes`,{method:"POST",body:{body:String(s)}});return JSON.stringify({ok:!0,id:o.id,createdAt:o.created_at})}case"gitlab_list_projects":{let{query:e,limit:n}=t||{},i=Math.min(Number(n)>0?Number(n):50,200),s=new URLSearchParams;s.set("membership","true"),s.set("simple","true"),s.set("order_by","last_activity_at"),s.set("sort","desc"),s.set("per_page",String(Math.min(i+1,100))),e&&s.set("search",String(e));let o=async()=>{let u=await R(`/projects?${s.toString()}`);return Array.isArray(u)?u:[]},a=Pt(),c=Un(),l=[];for(let u of a||[null]){let m=u?await Ct.run(u,o):await o();for(let f of m)Bn(u?u.repos:c,f&&f.path_with_namespace)&&l.push({p:f,host:u?u.webHost:null})}let d=l.length>i,p=l.slice(0,i).map(({p:u,host:m})=>({fullPath:u.path_with_namespace,name:u.name,webUrl:u.web_url,defaultBranch:u.default_branch||null,visibility:u.visibility||null,...m?{host:m}:{}}));return JSON.stringify({count:p.length,truncated:d,projects:p})}case"gitlab_list_issues":{let{projectId:e,state:n,labels:i,assigneeUsername:s,authorUsername:o,updatedAfter:a,search:c,sort:l,orderBy:d,limit:p}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});let u=new URLSearchParams;u.set("state",n||"opened"),u.set("per_page",String(p||30)),u.set("order_by",d||"updated_at"),u.set("sort",l||"desc"),i&&u.set("labels",Array.isArray(i)?i.join(","):i),s&&u.set("assignee_username",s),o&&u.set("author_username",o),a&&u.set("updated_after",a),c&&u.set("search",c);let m=await R(`/projects/${L(e)}/issues?${u.toString()}`),f=(Array.isArray(m)?m:[]).map(h=>({iid:h.iid,title:h.title,state:h.state,labels:Array.isArray(h.labels)?h.labels:[],author:h.author?.username,assignees:(h.assignees||[]).map(_=>_.username),userNotesCount:h.user_notes_count,webUrl:h.web_url,createdAt:h.created_at,updatedAt:h.updated_at}));return JSON.stringify({count:f.length,issues:f})}case"gitlab_get_issue":{let{projectId:e,iid:n}=t||{};if(!e||!n)return JSON.stringify({error:"projectId and iid are required"});let i=await R(`/projects/${L(e)}/issues/${n}`);return JSON.stringify({iid:i.iid,projectId:i.project_id,title:i.title,description:(i.description||"").slice(0,5e3),state:i.state,labels:Array.isArray(i.labels)?i.labels:[],author:i.author?.username,assignees:(i.assignees||[]).map(s=>s.username),milestone:i.milestone?.title||null,webUrl:i.web_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"gitlab_add_issue_comment":{let{projectId:e,iid:n,body:i}=t||{};if(!e||!n||!i)return JSON.stringify({error:"projectId, iid, and body are required"});let s=await R(`/projects/${L(e)}/issues/${n}/notes`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:s.id,createdAt:s.created_at})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}var De={id:"gitlab",callsBackend:!0,serverName:"gitlab",allowedTools:["mcp__gitlab__*"],requiresIntegration:I.GITLAB,envKeys:["GITLAB_TOKEN","GITLAB_OAUTH_TOKEN","GITLAB_URL","GITLAB_INSTANCE_URL","GITLAB_API_URL","GITLAB_ALLOWED_REPOS","GITLAB_INSTANCES","PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"GitLab \u2014 merge requests, diffs, MR reviews/discussions, issues",promptFragment:`## GitLab
136
136
  You have access to the user's GitLab projects via the REST API (cloud gitlab.com OR self-hosted). A "merge request" (MR) is GitLab's pull request. An MR is addressed by a PROJECT (numeric id OR full path like "group/repo") and an \`iid\` (the per-project MR number shown in the URL). For projects, prefer the full path form ("group/subgroup/repo") \u2014 it's what users have. Available tools:
137
137
 
138
138
  ### Discovery
@@ -189,7 +189,7 @@ You have access to the user's Figma files via the Figma REST API. Every tool tha
189
189
 
190
190
  ### Notes
191
191
  - The file key is NOT the file name \u2014 it's the opaque id segment in the URL (or just paste the URL).
192
- - Node ids look like "1:23" and come from figma_get_file / figma_get_nodes / figma_parse_url output.`,resolve(){let r=pc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/figma.js","figmaSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"figma_get_me":{let e=await Z("/v1/me");return JSON.stringify({id:e.id,handle:e.handle,email:e.email,imgUrl:e.img_url})}case"figma_get_file":{let e=de((t||{}).fileKey),{depth:n}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let i=`/v1/files/${encodeURIComponent(e)}`;if(n!=null){let a=Number(n);!Number.isNaN(a)&&a>0&&(i+=`?depth=${a}`)}let s=await Z(i),o=(s.document?.children||[]).map(a=>({id:a.id,name:a.name,type:a.type,childCount:Array.isArray(a.children)?a.children.length:0,children:(a.children||[]).slice(0,50).map(c=>({id:c.id,name:c.name,type:c.type}))}));return JSON.stringify({name:s.name,lastModified:s.lastModified,version:s.version,editorType:s.editorType,role:s.role,pages:o})}case"figma_get_nodes":{let e=de((t||{}).fileKey),{ids:n,depth:i}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let s=Bt(n);if(!s)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let o=new URLSearchParams;if(o.set("ids",s),i!=null){let l=Number(i);!Number.isNaN(l)&&l>0&&o.set("depth",String(l))}let a=await Z(`/v1/files/${encodeURIComponent(e)}/nodes?${o.toString()}`),c={};for(let[l,d]of Object.entries(a.nodes||{}))c[l]=d?.document?{id:d.document.id,name:d.document.name,type:d.document.type,document:d.document}:d;return JSON.stringify({name:a.name,nodes:c})}case"figma_get_node_specs":{let e=de((t||{}).file),{ids:n,depth:i}=t||{};if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let s=Bt(n);if(!s)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let o=Number(i);Number.isNaN(o)&&(o=2),o=Math.min(6,Math.max(0,Math.trunc(o)));let a=new URLSearchParams;a.set("ids",s),a.set("depth",String(o));let c=await Z(`/v1/files/${encodeURIComponent(e)}/nodes?${a.toString()}`),l={};for(let[d,p]of Object.entries(c.nodes||{}))l[d]=p&&p.document?Dn(p.document,o):null;return JSON.stringify(l)}case"figma_render_png":{let e=de((t||{}).fileKey??(t||{}).file),{ids:n,scale:i,format:s,svg_include_id:o,version:a}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let c=Bt(n);if(!c)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let l=["png","jpg","svg","pdf"].includes(String(s||"").toLowerCase())?String(s).toLowerCase():"png",d=new URLSearchParams;d.set("ids",c),d.set("format",l);let p;(l==="png"||l==="jpg")&&(p=Number(i),(Number.isNaN(p)||p<=0)&&(p=1),p=Math.min(4,Math.max(.01,p)),d.set("scale",String(p))),l==="svg"&&o!=null&&d.set("svg_include_id",String(!!o)),a&&d.set("version",String(a));let u=await Z(`/v1/images/${encodeURIComponent(e)}?${d.toString()}`);return u.err?JSON.stringify({error:`Figma render error: ${u.err}`}):JSON.stringify({format:l,...p!=null?{scale:p}:{},images:u.images||{}})}case"figma_get_image_fills":{let e=de((t||{}).file);if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let n=await Z(`/v1/files/${encodeURIComponent(e)}/images`);return JSON.stringify({images:n.meta?.images??n.images??{}})}case"figma_get_file_versions":{let e=de((t||{}).file);if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let i=((await Z(`/v1/files/${encodeURIComponent(e)}/versions`)).versions||[]).map(s=>({id:s.id,label:s.label,description:s.description,createdAt:s.created_at,user:s.user?.handle}));return JSON.stringify({count:i.length,versions:i})}case"figma_get_comments":{let e=de((t||{}).fileKey);if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let i=((await Z(`/v1/files/${encodeURIComponent(e)}/comments`)).comments||[]).map(s=>({id:s.id,message:s.message,user:s.user?.handle,createdAt:s.created_at,resolvedAt:s.resolved_at||null,parentId:s.parent_id||null}));return JSON.stringify({count:i.length,comments:i})}case"figma_post_comment":{let e=de((t||{}).file),{message:n,comment_id:i,node_id:s,x:o,y:a}=t||{};if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});if(!n)return JSON.stringify({error:"message is required"});let c={message:n};i&&(c.comment_id=i),s?c.client_meta={node_id:Bt(s),node_offset:{x:o??0,y:a??0}}:(o!=null||a!=null)&&(c.client_meta={x:o??0,y:a??0});let l=await Z(`/v1/files/${encodeURIComponent(e)}/comments`,{method:"POST",body:c});return JSON.stringify({id:l.id,message:l.message,fileKey:e,createdAt:l.created_at,parentId:l.parent_id||null})}case"figma_get_team_projects":{let{team_id:e}=t||{};if(!e)return JSON.stringify({error:"team_id is required"});let n=await Z(`/v1/teams/${encodeURIComponent(e)}/projects`);return JSON.stringify({name:n.name,projects:n.projects||[]})}case"figma_get_project_files":{let{project_id:e,branch_data:n}=t||{};if(!e)return JSON.stringify({error:"project_id is required"});let i=new URLSearchParams;n&&i.set("branch_data","true");let s=i.toString(),o=await Z(`/v1/projects/${encodeURIComponent(e)}/files${s?`?${s}`:""}`);return JSON.stringify({name:o.name,files:o.files||[]})}case"figma_parse_url":{let{url:e}=t||{};return JSON.stringify({file_key:de(e),node_id:uc(e)??null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"figma_get_me",description:"Get the authenticated Figma user profile (handle, email, id)",input_schema:{type:"object",properties:{}}},{name:"figma_get_file",description:"Get a Figma file's document tree. Accepts a file key OR a figma.com URL (figma.com/file|design/<key>/... \u2014 NOT the file name). Returns a summarized map of pages and their top-level frames/nodes. Use figma_get_nodes or figma_get_node_specs to drill into a specific node.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:'A file key OR a figma.com URL (e.g. "aBcD1234" or figma.com/design/aBcD1234/My-File)'},depth:{type:"number",description:"Optional: limit how deep the node tree is traversed (1-2 is usually enough to list pages/frames). Omit for the full tree."}},required:["fileKey"]}},{name:"figma_get_nodes",description:"Get specific nodes from a Figma file by their node ids. Use after figma_get_file to inspect a particular frame/component without re-fetching the whole file.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to fetch. Accepts URL form ["1-23"] or API form ["1:23"]. A comma-separated string is also accepted.'},depth:{type:"number",description:"Optional: limit traversal depth within each node."}},required:["fileKey","ids"]}},{name:"figma_get_node_specs",description:"Dev-Mode-style inspection computed from the REST tree: for the given nodes and their children returns size, position, colors (hex), fonts/text-style, spacing/auto-layout, corner radius, strokes and effects \u2014 a compact spec for reproducing a design in code. Prefer this over figma_get_nodes when your job is to build UI from a Figma file.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to inspect (URL form "1-23" or API form "1:23"). A comma-separated string is also accepted.'},depth:{type:"number",description:"How many levels of children to walk (0-6, default 2)."}},required:["file","ids"]}},{name:"figma_render_png",description:"Render one or more Figma nodes to an image and return the URLs (a map of nodeId \u2192 URL). Despite the name it renders PNG/JPG/SVG/PDF (default png). Use to show or download a visual of a frame/component.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to render (URL form "1-23" or API form "1:23"). A comma-separated string is also accepted.'},format:{type:"string",enum:["png","jpg","svg","pdf"],description:"Output format (default png)."},scale:{type:"number",description:"Render scale, 0.01\u20134 (raster formats only; default 1). 2 for retina/hi-dpi."},svg_include_id:{type:"boolean",description:"For SVG: include element ids as attributes."},version:{type:"string",description:"Render a specific file version id (from figma_get_file_versions)."}},required:["fileKey","ids"]}},{name:"figma_get_image_fills",description:"Get a map of imageRef \u2192 download URL for every image fill used in a Figma file.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"}},required:["file"]}},{name:"figma_get_file_versions",description:"List a Figma file's saved version history (version id, label, created_at, user). A version id can be passed to figma_render_png to render a past version.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"}},required:["file"]}},{name:"figma_get_comments",description:"Read the comments on a Figma file",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"}},required:["fileKey"]}},{name:"figma_post_comment",description:"Post a comment on a Figma file (WRITE \u2014 needs a PAT with comment-write scope). Optionally reply to a comment (comment_id), pin it to a node (node_id, with optional x/y offset), or pin to a canvas point (x/y).",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"},message:{type:"string",description:"The comment text."},comment_id:{type:"string",description:"Optional: reply to this parent comment id."},node_id:{type:"string",description:'Optional: pin the comment to this node ("1-23" or "1:23").'},x:{type:"number",description:"Optional: x position (node offset if node_id given, else canvas point)."},y:{type:"number",description:"Optional: y position (node offset if node_id given, else canvas point)."}},required:["file","message"]}},{name:"figma_get_team_projects",description:"List the projects in a Figma team. Get team_id from a Figma team URL (\u2026/files/team/<TEAM_ID>/\u2026).",input_schema:{type:"object",properties:{team_id:{type:"string",description:"The Figma team id."}},required:["team_id"]}},{name:"figma_get_project_files",description:"List the files in a Figma project (from figma_get_team_projects). Returns file key, name, thumbnail, last_modified.",input_schema:{type:"object",properties:{project_id:{type:"string",description:"The Figma project id."},branch_data:{type:"boolean",description:"Optional: include branch metadata for each file."}},required:["project_id"]}},{name:"figma_parse_url",description:"Local helper (no API call): extract the file key and node id (colon form) from a figma.com file/design URL. Returns { file_key, node_id }.",input_schema:{type:"object",properties:{url:{type:"string",description:"A full figma.com file/design URL."}},required:["url"]}}]};import{existsSync as mc}from"fs";import{fileURLToPath as fc}from"url";import{dirname as hc,resolve as yc}from"path";import{resolveIntegrationToken as gc}from"@zibby/core/backend-client.js";function bc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=hc(fc(import.meta.url)),t=yc(r,"..","bin","mcp-skill.mjs");return mc(t)?t:null}async function ne(r,t={}){let{token:e}=await gc("hubspot");if(!e)throw new Error("HubSpot not connected \u2014 Connect HubSpot in Integrations.");let n=r.startsWith("https://")?r:`https://api.hubapi.com${r}`,i={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!s.ok){let a=await s.text().catch(()=>""),c=s.status===401||s.status===403?" \u2014 token invalid/expired or missing the required Private App scope for this object":"";throw new Error(`HubSpot API ${s.status}${c}: ${a.slice(0,300)}`)}let o=await s.text().catch(()=>"");if(!o)return{};try{return JSON.parse(o)}catch{return{raw:o}}}function ke(r){return typeof r!="string"?null:r.trim()||null}function Mn(r,t={}){let e=new URLSearchParams;if(r!=null){let i=Array.isArray(r)?r.join(","):String(r);i&&e.set("properties",i)}for(let[i,s]of Object.entries(t))s!=null&&s!==""&&e.set(i,String(s));let n=e.toString();return n?`?${n}`:""}var qe="The CRM object type \u2014 one of the common values `contacts`, `companies`, `deals`, `tickets`, `notes`, `tasks`, `feedback_submissions` (customer feedback: NPS/CSAT/CES), or any custom object name/id.",Fn={id:"hubspot",callsBackend:!0,serverName:"hubspot",allowedTools:["mcp__hubspot__*"],requiresIntegration:I.HUBSPOT,envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"HubSpot CRM \u2014 search/read/create/update contacts, companies, deals, tickets, notes and feedback submissions via the HubSpot REST API.",promptFragment:"## HubSpot CRM\nYou have access to the user's HubSpot CRM via the HubSpot REST API (OAuth \u2014 the user connects HubSpot in Integrations; the token is resolved and auto-refreshed for you). The connected app grants the CRM scopes for the objects you touch.\n\nHubSpot's object model is **uniform** \u2014 nearly every tool takes an `objectType` (`contacts`, `companies`, `deals`, `tickets`, `notes`, `tasks`, `feedback_submissions`, or a custom object). Records are `{ id, properties }`; you set/read named properties.\n\n**Before you create/update/search, call `hubspot_list_properties` to learn the valid property names for that object type** (they're not guessable). `feedback_submissions` is where NPS/CSAT/CES customer-feedback survey responses live.\n\n### Identity\n- hubspot_whoami: Confirm the token works \u2014 returns the portal (hub) id, account type, time zone, UI domain.\n\n### Schema\n- hubspot_list_properties: List the defined properties (name, label, type, fieldType) for an objectType. Do this first so you use real property names.\n\n### Read\n- hubspot_search: Search an objectType by full-text `query` OR structured `filters` (array of {propertyName, operator, value}). Returns { total, results:[{id, properties}] }.\n- hubspot_get_object: Fetch one record by id (optionally selecting specific properties).\n- hubspot_list_objects: Page through all records of an objectType (limit + after cursor).\n\n### Write\n- hubspot_create_object: Create a record from a `properties` object.\n- hubspot_update_object: Patch a record's `properties` by id.\n- hubspot_create_note: Convenience \u2014 log a note (hs_note_body) and optionally associate it to a contact/company/deal/ticket.\n- hubspot_associate: Associate two records (fromType/fromId \u2194 toType/toId) with the default association type.",resolve(){let r=bc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/hubspot.js","hubspotSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{let e=t||{};switch(r){case"hubspot_whoami":{let n=await ne("/account-info/v3/details");return JSON.stringify({portalId:n.portalId,accountType:n.accountType,timeZone:n.timeZone,uiDomain:n.uiDomain,companyCurrency:n.companyCurrency})}case"hubspot_list_properties":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required (e.g. contacts, companies, deals, tickets, feedback_submissions)"});let s=((await ne(`/crm/v3/properties/${encodeURIComponent(n)}`)).results||[]).map(o=>({name:o.name,label:o.label,type:o.type,fieldType:o.fieldType}));return JSON.stringify({objectType:n,count:s.length,properties:s})}case"hubspot_search":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});let s={limit:Number.isFinite(Number(e.limit))&&Number(e.limit)>0?Math.trunc(Number(e.limit)):20};e.query&&(s.query=String(e.query)),Array.isArray(e.filters)&&e.filters.length&&(s.filterGroups=[{filters:e.filters}]),e.properties!=null&&(s.properties=Array.isArray(e.properties)?e.properties:String(e.properties).split(",").map(a=>a.trim()).filter(Boolean));let o=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/search`,{method:"POST",body:s});return JSON.stringify({total:o.total??(o.results?o.results.length:0),results:(o.results||[]).map(a=>({id:a.id,properties:a.properties}))})}case"hubspot_get_object":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.id)return JSON.stringify({error:"id is required"});let i=Mn(e.properties,{associations:e.associations}),s=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.id)}${i}`);return JSON.stringify({id:s.id,properties:s.properties,...s.associations?{associations:s.associations}:{}})}case"hubspot_list_objects":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});let i=Number.isFinite(Number(e.limit))&&Number(e.limit)>0?Math.trunc(Number(e.limit)):20,s=Mn(e.properties,{limit:i,after:e.after}),o=await ne(`/crm/v3/objects/${encodeURIComponent(n)}${s}`);return JSON.stringify({results:(o.results||[]).map(a=>({id:a.id,properties:a.properties})),paging:o.paging||null})}case"hubspot_create_object":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.properties||typeof e.properties!="object"||Array.isArray(e.properties))return JSON.stringify({error:"properties is required (an object of { propertyName: value } \u2014 call hubspot_list_properties first for valid names)"});let i=await ne(`/crm/v3/objects/${encodeURIComponent(n)}`,{method:"POST",body:{properties:e.properties}});return JSON.stringify({id:i.id,properties:i.properties})}case"hubspot_update_object":{let n=ke(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.id)return JSON.stringify({error:"id is required"});if(!e.properties||typeof e.properties!="object"||Array.isArray(e.properties))return JSON.stringify({error:"properties is required (an object of { propertyName: value })"});let i=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.id)}`,{method:"PATCH",body:{properties:e.properties}});return JSON.stringify({id:i.id,properties:i.properties})}case"hubspot_create_note":{if(!e.body||typeof e.body!="string")return JSON.stringify({error:"body is required (the note text)"});let n=typeof e.timestamp=="string"&&e.timestamp?e.timestamp:null;if(!n)try{n=new Date().toISOString()}catch{n=null}if(!n)return JSON.stringify({error:"timestamp is required (pass an ISO 8601 string, e.g. 2026-01-01T00:00:00.000Z)"});let i=await ne("/crm/v3/objects/notes",{method:"POST",body:{properties:{hs_note_body:e.body,hs_timestamp:n}}}),s=i.id,o=[["contacts",e.contactId],["companies",e.companyId],["deals",e.dealId],["tickets",e.ticketId]].filter(([,c])=>c!=null&&c!==""),a=[];for(let[c,l]of o)try{await ne(`/crm/v4/objects/notes/${encodeURIComponent(s)}/associations/default/${c}/${encodeURIComponent(l)}`,{method:"PUT"}),a.push({toType:c,toId:String(l)})}catch(d){a.push({toType:c,toId:String(l),error:d.message})}return JSON.stringify({id:s,properties:i.properties,associatedTo:a})}case"hubspot_associate":{let n=ke(e.fromType),i=ke(e.toType);return!n||!e.fromId||!i||!e.toId?JSON.stringify({error:"fromType, fromId, toType and toId are all required"}):(await ne(`/crm/v4/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.fromId)}/associations/default/${encodeURIComponent(i)}/${encodeURIComponent(e.toId)}`,{method:"PUT"}),JSON.stringify({ok:!0}))}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"hubspot_whoami",description:"Confirm the HubSpot token works: returns the portal (hub) id, account type, time zone and UI domain.",input_schema:{type:"object",properties:{}}},{name:"hubspot_list_properties",description:"List the defined properties (name, label, type, fieldType) for a CRM object type. Call this FIRST so you use valid property names when creating/updating/searching.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe}},required:["objectType"]}},{name:"hubspot_search",description:"Search a CRM object type. Pass a full-text `query` OR structured `filters` (array of {propertyName, operator, value}, e.g. operator EQ/CONTAINS_TOKEN/GT/\u2026). Returns { total, results:[{id, properties}] }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},query:{type:"string",description:"Optional full-text search string."},filters:{type:"array",description:"Optional structured filters (ANDed). Each: { propertyName, operator, value }. Operators: EQ, NEQ, LT, LTE, GT, GTE, CONTAINS_TOKEN, HAS_PROPERTY, IN, \u2026",items:{type:"object",properties:{propertyName:{type:"string"},operator:{type:"string"},value:{type:"string"}}}},properties:{type:"array",items:{type:"string"},description:"Optional: property names to return on each result."},limit:{type:"number",description:"Max results (default 20)."}},required:["objectType"]}},{name:"hubspot_get_object",description:"Fetch one CRM record by id. Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},id:{type:"string",description:"The record id."},properties:{type:"array",items:{type:"string"},description:"Optional: specific property names to return."},associations:{type:"string",description:'Optional: comma-separated object types to also return associations for (e.g. "companies,deals").'}},required:["objectType","id"]}},{name:"hubspot_list_objects",description:"Page through records of a CRM object type. Returns { results, paging } \u2014 pass paging.next.after back as `after` for the next page.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},properties:{type:"array",items:{type:"string"},description:"Optional: property names to return on each record."},limit:{type:"number",description:"Page size (default 20)."},after:{type:"string",description:"Optional paging cursor from a previous response (paging.next.after)."}},required:["objectType"]}},{name:"hubspot_create_object",description:"Create a CRM record. Pass `properties` as an object of { propertyName: value } (call hubspot_list_properties first for valid names). Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},properties:{type:"object",description:"Object of { propertyName: value } to set on the new record."}},required:["objectType","properties"]}},{name:"hubspot_update_object",description:"Update (PATCH) a CRM record by id. Pass `properties` as an object of { propertyName: value }. Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},id:{type:"string",description:"The record id to update."},properties:{type:"object",description:"Object of { propertyName: value } to change."}},required:["objectType","id","properties"]}},{name:"hubspot_create_note",description:"Log a note (hs_note_body) and optionally associate it to a contact/company/deal/ticket. Returns { id, associatedTo }.",input_schema:{type:"object",properties:{body:{type:"string",description:"The note text (stored as hs_note_body)."},contactId:{type:"string",description:"Optional: associate the note to this contact id."},companyId:{type:"string",description:"Optional: associate the note to this company id."},dealId:{type:"string",description:"Optional: associate the note to this deal id."},ticketId:{type:"string",description:"Optional: associate the note to this ticket id."},timestamp:{type:"string",description:"Optional ISO 8601 timestamp for the note (defaults to now)."}},required:["body"]}},{name:"hubspot_associate",description:"Associate two CRM records with the default association type (e.g. a contact to a company). Returns { ok:true }.",input_schema:{type:"object",properties:{fromType:{type:"string",description:"Source object type (e.g. contacts)."},fromId:{type:"string",description:"Source record id."},toType:{type:"string",description:"Target object type (e.g. companies)."},toId:{type:"string",description:"Target record id."}},required:["fromType","fromId","toType","toId"]}}]};import{existsSync as _c}from"fs";import{fileURLToPath as kc}from"url";import{dirname as wc,resolve as Sc}from"path";function vc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=wc(kc(import.meta.url)),t=Sc(r,"..","bin","mcp-skill.mjs");return _c(t)?t:null}var Ic=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function Nc(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let r=process.env.LINEAR_API_KEY;if(!r)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return r}async function V(r,t={}){let e=await fetch(Ic,{method:"POST",headers:{Authorization:Nc(),"Content-Type":"application/json"},body:JSON.stringify({query:r,variables:t})});if(!e.ok){let i=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${i.slice(0,300)}`)}let n=await e.json().catch(()=>null);if(!n)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(n.errors)&&n.errors.length){let i=n.errors.map(s=>s?.message||String(s)).join("; ");throw new Error(`Linear GraphQL error: ${i.slice(0,300)}`)}return n.data}function it(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Oc(r,t){let e=it(r),n=it(t);if(!e||!n)return 0;if(e===n)return 1;if(e.length===1||n.length===1)return e===n?1:0;let i=d=>{let p=new Map;for(let u=0;u<d.length-1;u++){let m=d.slice(u,u+2);p.set(m,(p.get(m)||0)+1)}return p},s=i(e),o=i(n),a=0,c=0,l=0;for(let d of s.values())c+=d;for(let d of o.values())l+=d;for(let[d,p]of s.entries())a+=Math.min(p,o.get(d)||0);return 2*a/Math.max(1,c+l)}function Tc(r,t){let e=Array.isArray(r)?r:[];if(!e.length)return{state:null,strategy:"no-states"};let n=it(t);if(!n)return{state:null,strategy:"no-target"};let i=e.find(a=>it(a.name)===n);if(i)return{state:i,strategy:"exact"};let s={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[a,c]of Object.entries(s)){if(!c.some(d=>it(d)===n))continue;let l=e.find(d=>d.type===a);if(l)return{state:l,strategy:"type-alias"}}let o=e.map(a=>({s:a,score:Oc(t,a.name)})).sort((a,c)=>c.score-a.score);return o[0]&&o[0].score>=.5?{state:o[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var Rc=`
192
+ - Node ids look like "1:23" and come from figma_get_file / figma_get_nodes / figma_parse_url output.`,resolve(){let r=pc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/figma.js","figmaSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"figma_get_me":{let e=await Z("/v1/me");return JSON.stringify({id:e.id,handle:e.handle,email:e.email,imgUrl:e.img_url})}case"figma_get_file":{let e=de((t||{}).fileKey),{depth:n}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let i=`/v1/files/${encodeURIComponent(e)}`;if(n!=null){let a=Number(n);!Number.isNaN(a)&&a>0&&(i+=`?depth=${a}`)}let s=await Z(i),o=(s.document?.children||[]).map(a=>({id:a.id,name:a.name,type:a.type,childCount:Array.isArray(a.children)?a.children.length:0,children:(a.children||[]).slice(0,50).map(c=>({id:c.id,name:c.name,type:c.type}))}));return JSON.stringify({name:s.name,lastModified:s.lastModified,version:s.version,editorType:s.editorType,role:s.role,pages:o})}case"figma_get_nodes":{let e=de((t||{}).fileKey),{ids:n,depth:i}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let s=Bt(n);if(!s)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let o=new URLSearchParams;if(o.set("ids",s),i!=null){let l=Number(i);!Number.isNaN(l)&&l>0&&o.set("depth",String(l))}let a=await Z(`/v1/files/${encodeURIComponent(e)}/nodes?${o.toString()}`),c={};for(let[l,d]of Object.entries(a.nodes||{}))c[l]=d?.document?{id:d.document.id,name:d.document.name,type:d.document.type,document:d.document}:d;return JSON.stringify({name:a.name,nodes:c})}case"figma_get_node_specs":{let e=de((t||{}).file),{ids:n,depth:i}=t||{};if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let s=Bt(n);if(!s)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let o=Number(i);Number.isNaN(o)&&(o=2),o=Math.min(6,Math.max(0,Math.trunc(o)));let a=new URLSearchParams;a.set("ids",s),a.set("depth",String(o));let c=await Z(`/v1/files/${encodeURIComponent(e)}/nodes?${a.toString()}`),l={};for(let[d,p]of Object.entries(c.nodes||{}))l[d]=p&&p.document?Dn(p.document,o):null;return JSON.stringify(l)}case"figma_render_png":{let e=de((t||{}).fileKey??(t||{}).file),{ids:n,scale:i,format:s,svg_include_id:o,version:a}=t||{};if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let c=Bt(n);if(!c)return JSON.stringify({error:"ids is required (comma-separated or array of node ids; `1-23` or `1:23`)"});let l=["png","jpg","svg","pdf"].includes(String(s||"").toLowerCase())?String(s).toLowerCase():"png",d=new URLSearchParams;d.set("ids",c),d.set("format",l);let p;(l==="png"||l==="jpg")&&(p=Number(i),(Number.isNaN(p)||p<=0)&&(p=1),p=Math.min(4,Math.max(.01,p)),d.set("scale",String(p))),l==="svg"&&o!=null&&d.set("svg_include_id",String(!!o)),a&&d.set("version",String(a));let u=await Z(`/v1/images/${encodeURIComponent(e)}?${d.toString()}`);return u.err?JSON.stringify({error:`Figma render error: ${u.err}`}):JSON.stringify({format:l,...p!=null?{scale:p}:{},images:u.images||{}})}case"figma_get_image_fills":{let e=de((t||{}).file);if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let n=await Z(`/v1/files/${encodeURIComponent(e)}/images`);return JSON.stringify({images:n.meta?.images??n.images??{}})}case"figma_get_file_versions":{let e=de((t||{}).file);if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});let i=((await Z(`/v1/files/${encodeURIComponent(e)}/versions`)).versions||[]).map(s=>({id:s.id,label:s.label,description:s.description,createdAt:s.created_at,user:s.user?.handle}));return JSON.stringify({count:i.length,versions:i})}case"figma_get_comments":{let e=de((t||{}).fileKey);if(!e)return JSON.stringify({error:"fileKey is required (a file key or a figma.com URL)"});let i=((await Z(`/v1/files/${encodeURIComponent(e)}/comments`)).comments||[]).map(s=>({id:s.id,message:s.message,user:s.user?.handle,createdAt:s.created_at,resolvedAt:s.resolved_at||null,parentId:s.parent_id||null}));return JSON.stringify({count:i.length,comments:i})}case"figma_post_comment":{let e=de((t||{}).file),{message:n,comment_id:i,node_id:s,x:o,y:a}=t||{};if(!e)return JSON.stringify({error:"file is required (a file key or a figma.com URL)"});if(!n)return JSON.stringify({error:"message is required"});let c={message:n};i&&(c.comment_id=i),s?c.client_meta={node_id:Bt(s),node_offset:{x:o??0,y:a??0}}:(o!=null||a!=null)&&(c.client_meta={x:o??0,y:a??0});let l=await Z(`/v1/files/${encodeURIComponent(e)}/comments`,{method:"POST",body:c});return JSON.stringify({id:l.id,message:l.message,fileKey:e,createdAt:l.created_at,parentId:l.parent_id||null})}case"figma_get_team_projects":{let{team_id:e}=t||{};if(!e)return JSON.stringify({error:"team_id is required"});let n=await Z(`/v1/teams/${encodeURIComponent(e)}/projects`);return JSON.stringify({name:n.name,projects:n.projects||[]})}case"figma_get_project_files":{let{project_id:e,branch_data:n}=t||{};if(!e)return JSON.stringify({error:"project_id is required"});let i=new URLSearchParams;n&&i.set("branch_data","true");let s=i.toString(),o=await Z(`/v1/projects/${encodeURIComponent(e)}/files${s?`?${s}`:""}`);return JSON.stringify({name:o.name,files:o.files||[]})}case"figma_parse_url":{let{url:e}=t||{};return JSON.stringify({file_key:de(e),node_id:uc(e)??null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"figma_get_me",description:"Get the authenticated Figma user profile (handle, email, id)",input_schema:{type:"object",properties:{}}},{name:"figma_get_file",description:"Get a Figma file's document tree. Accepts a file key OR a figma.com URL (figma.com/file|design/<key>/... \u2014 NOT the file name). Returns a summarized map of pages and their top-level frames/nodes. Use figma_get_nodes or figma_get_node_specs to drill into a specific node.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:'A file key OR a figma.com URL (e.g. "aBcD1234" or figma.com/design/aBcD1234/My-File)'},depth:{type:"number",description:"Optional: limit how deep the node tree is traversed (1-2 is usually enough to list pages/frames). Omit for the full tree."}},required:["fileKey"]}},{name:"figma_get_nodes",description:"Get specific nodes from a Figma file by their node ids. Use after figma_get_file to inspect a particular frame/component without re-fetching the whole file.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to fetch. Accepts URL form ["1-23"] or API form ["1:23"]. A comma-separated string is also accepted.'},depth:{type:"number",description:"Optional: limit traversal depth within each node."}},required:["fileKey","ids"]}},{name:"figma_get_node_specs",description:"Dev-Mode-style inspection computed from the REST tree: for the given nodes and their children returns size, position, colors (hex), fonts/text-style, spacing/auto-layout, corner radius, strokes and effects \u2014 a compact spec for reproducing a design in code. Prefer this over figma_get_nodes when your job is to build UI from a Figma file.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to inspect (URL form "1-23" or API form "1:23"). A comma-separated string is also accepted.'},depth:{type:"number",description:"How many levels of children to walk (0-6, default 2)."}},required:["file","ids"]}},{name:"figma_render_png",description:"Render one or more Figma nodes to an image and return the URLs (a map of nodeId \u2192 URL). Despite the name it renders PNG/JPG/SVG/PDF (default png). Use to show or download a visual of a frame/component.",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"},ids:{type:"array",items:{type:"string"},description:'Node ids to render (URL form "1-23" or API form "1:23"). A comma-separated string is also accepted.'},format:{type:"string",enum:["png","jpg","svg","pdf"],description:"Output format (default png)."},scale:{type:"number",description:"Render scale, 0.01\u20134 (raster formats only; default 1). 2 for retina/hi-dpi."},svg_include_id:{type:"boolean",description:"For SVG: include element ids as attributes."},version:{type:"string",description:"Render a specific file version id (from figma_get_file_versions)."}},required:["fileKey","ids"]}},{name:"figma_get_image_fills",description:"Get a map of imageRef \u2192 download URL for every image fill used in a Figma file.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"}},required:["file"]}},{name:"figma_get_file_versions",description:"List a Figma file's saved version history (version id, label, created_at, user). A version id can be passed to figma_render_png to render a past version.",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"}},required:["file"]}},{name:"figma_get_comments",description:"Read the comments on a Figma file",input_schema:{type:"object",properties:{fileKey:{type:"string",description:"A file key OR a figma.com URL"}},required:["fileKey"]}},{name:"figma_post_comment",description:"Post a comment on a Figma file (WRITE \u2014 needs a PAT with comment-write scope). Optionally reply to a comment (comment_id), pin it to a node (node_id, with optional x/y offset), or pin to a canvas point (x/y).",input_schema:{type:"object",properties:{file:{type:"string",description:"A file key OR a figma.com URL"},message:{type:"string",description:"The comment text."},comment_id:{type:"string",description:"Optional: reply to this parent comment id."},node_id:{type:"string",description:'Optional: pin the comment to this node ("1-23" or "1:23").'},x:{type:"number",description:"Optional: x position (node offset if node_id given, else canvas point)."},y:{type:"number",description:"Optional: y position (node offset if node_id given, else canvas point)."}},required:["file","message"]}},{name:"figma_get_team_projects",description:"List the projects in a Figma team. Get team_id from a Figma team URL (\u2026/files/team/<TEAM_ID>/\u2026).",input_schema:{type:"object",properties:{team_id:{type:"string",description:"The Figma team id."}},required:["team_id"]}},{name:"figma_get_project_files",description:"List the files in a Figma project (from figma_get_team_projects). Returns file key, name, thumbnail, last_modified.",input_schema:{type:"object",properties:{project_id:{type:"string",description:"The Figma project id."},branch_data:{type:"boolean",description:"Optional: include branch metadata for each file."}},required:["project_id"]}},{name:"figma_parse_url",description:"Local helper (no API call): extract the file key and node id (colon form) from a figma.com file/design URL. Returns { file_key, node_id }.",input_schema:{type:"object",properties:{url:{type:"string",description:"A full figma.com file/design URL."}},required:["url"]}}]};import{existsSync as mc}from"fs";import{fileURLToPath as fc}from"url";import{dirname as hc,resolve as yc}from"path";import{resolveIntegrationToken as gc}from"@zibby/core/backend-client.js";function bc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=hc(fc(import.meta.url)),t=yc(r,"..","bin","mcp-skill.mjs");return mc(t)?t:null}async function ne(r,t={}){let{token:e}=await gc("hubspot");if(!e)throw new Error("HubSpot not connected \u2014 Connect HubSpot in Integrations.");let n=r.startsWith("https://")?r:`https://api.hubapi.com${r}`,i={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},s=await fetch(n,{method:t.method||"GET",headers:i,body:t.body?JSON.stringify(t.body):void 0});if(!s.ok){let a=await s.text().catch(()=>""),c=s.status===401||s.status===403?" \u2014 token invalid/expired or missing the required Private App scope for this object":"";throw new Error(`HubSpot API ${s.status}${c}: ${a.slice(0,300)}`)}let o=await s.text().catch(()=>"");if(!o)return{};try{return JSON.parse(o)}catch{return{raw:o}}}function we(r){return typeof r!="string"?null:r.trim()||null}function Mn(r,t={}){let e=new URLSearchParams;if(r!=null){let i=Array.isArray(r)?r.join(","):String(r);i&&e.set("properties",i)}for(let[i,s]of Object.entries(t))s!=null&&s!==""&&e.set(i,String(s));let n=e.toString();return n?`?${n}`:""}var qe="The CRM object type \u2014 one of the common values `contacts`, `companies`, `deals`, `tickets`, `notes`, `tasks`, `feedback_submissions` (customer feedback: NPS/CSAT/CES), or any custom object name/id.",Fn={id:"hubspot",callsBackend:!0,serverName:"hubspot",allowedTools:["mcp__hubspot__*"],requiresIntegration:I.HUBSPOT,envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"HubSpot CRM \u2014 search/read/create/update contacts, companies, deals, tickets, notes and feedback submissions via the HubSpot REST API.",promptFragment:"## HubSpot CRM\nYou have access to the user's HubSpot CRM via the HubSpot REST API (OAuth \u2014 the user connects HubSpot in Integrations; the token is resolved and auto-refreshed for you). The connected app grants the CRM scopes for the objects you touch.\n\nHubSpot's object model is **uniform** \u2014 nearly every tool takes an `objectType` (`contacts`, `companies`, `deals`, `tickets`, `notes`, `tasks`, `feedback_submissions`, or a custom object). Records are `{ id, properties }`; you set/read named properties.\n\n**Before you create/update/search, call `hubspot_list_properties` to learn the valid property names for that object type** (they're not guessable). `feedback_submissions` is where NPS/CSAT/CES customer-feedback survey responses live.\n\n### Identity\n- hubspot_whoami: Confirm the token works \u2014 returns the portal (hub) id, account type, time zone, UI domain.\n\n### Schema\n- hubspot_list_properties: List the defined properties (name, label, type, fieldType) for an objectType. Do this first so you use real property names.\n\n### Read\n- hubspot_search: Search an objectType by full-text `query` OR structured `filters` (array of {propertyName, operator, value}). Returns { total, results:[{id, properties}] }.\n- hubspot_get_object: Fetch one record by id (optionally selecting specific properties).\n- hubspot_list_objects: Page through all records of an objectType (limit + after cursor).\n\n### Write\n- hubspot_create_object: Create a record from a `properties` object.\n- hubspot_update_object: Patch a record's `properties` by id.\n- hubspot_create_note: Convenience \u2014 log a note (hs_note_body) and optionally associate it to a contact/company/deal/ticket.\n- hubspot_associate: Associate two records (fromType/fromId \u2194 toType/toId) with the default association type.",resolve(){let r=bc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/hubspot.js","hubspotSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{let e=t||{};switch(r){case"hubspot_whoami":{let n=await ne("/account-info/v3/details");return JSON.stringify({portalId:n.portalId,accountType:n.accountType,timeZone:n.timeZone,uiDomain:n.uiDomain,companyCurrency:n.companyCurrency})}case"hubspot_list_properties":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required (e.g. contacts, companies, deals, tickets, feedback_submissions)"});let s=((await ne(`/crm/v3/properties/${encodeURIComponent(n)}`)).results||[]).map(o=>({name:o.name,label:o.label,type:o.type,fieldType:o.fieldType}));return JSON.stringify({objectType:n,count:s.length,properties:s})}case"hubspot_search":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});let s={limit:Number.isFinite(Number(e.limit))&&Number(e.limit)>0?Math.trunc(Number(e.limit)):20};e.query&&(s.query=String(e.query)),Array.isArray(e.filters)&&e.filters.length&&(s.filterGroups=[{filters:e.filters}]),e.properties!=null&&(s.properties=Array.isArray(e.properties)?e.properties:String(e.properties).split(",").map(a=>a.trim()).filter(Boolean));let o=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/search`,{method:"POST",body:s});return JSON.stringify({total:o.total??(o.results?o.results.length:0),results:(o.results||[]).map(a=>({id:a.id,properties:a.properties}))})}case"hubspot_get_object":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.id)return JSON.stringify({error:"id is required"});let i=Mn(e.properties,{associations:e.associations}),s=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.id)}${i}`);return JSON.stringify({id:s.id,properties:s.properties,...s.associations?{associations:s.associations}:{}})}case"hubspot_list_objects":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});let i=Number.isFinite(Number(e.limit))&&Number(e.limit)>0?Math.trunc(Number(e.limit)):20,s=Mn(e.properties,{limit:i,after:e.after}),o=await ne(`/crm/v3/objects/${encodeURIComponent(n)}${s}`);return JSON.stringify({results:(o.results||[]).map(a=>({id:a.id,properties:a.properties})),paging:o.paging||null})}case"hubspot_create_object":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.properties||typeof e.properties!="object"||Array.isArray(e.properties))return JSON.stringify({error:"properties is required (an object of { propertyName: value } \u2014 call hubspot_list_properties first for valid names)"});let i=await ne(`/crm/v3/objects/${encodeURIComponent(n)}`,{method:"POST",body:{properties:e.properties}});return JSON.stringify({id:i.id,properties:i.properties})}case"hubspot_update_object":{let n=we(e.objectType);if(!n)return JSON.stringify({error:"objectType is required"});if(!e.id)return JSON.stringify({error:"id is required"});if(!e.properties||typeof e.properties!="object"||Array.isArray(e.properties))return JSON.stringify({error:"properties is required (an object of { propertyName: value })"});let i=await ne(`/crm/v3/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.id)}`,{method:"PATCH",body:{properties:e.properties}});return JSON.stringify({id:i.id,properties:i.properties})}case"hubspot_create_note":{if(!e.body||typeof e.body!="string")return JSON.stringify({error:"body is required (the note text)"});let n=typeof e.timestamp=="string"&&e.timestamp?e.timestamp:null;if(!n)try{n=new Date().toISOString()}catch{n=null}if(!n)return JSON.stringify({error:"timestamp is required (pass an ISO 8601 string, e.g. 2026-01-01T00:00:00.000Z)"});let i=await ne("/crm/v3/objects/notes",{method:"POST",body:{properties:{hs_note_body:e.body,hs_timestamp:n}}}),s=i.id,o=[["contacts",e.contactId],["companies",e.companyId],["deals",e.dealId],["tickets",e.ticketId]].filter(([,c])=>c!=null&&c!==""),a=[];for(let[c,l]of o)try{await ne(`/crm/v4/objects/notes/${encodeURIComponent(s)}/associations/default/${c}/${encodeURIComponent(l)}`,{method:"PUT"}),a.push({toType:c,toId:String(l)})}catch(d){a.push({toType:c,toId:String(l),error:d.message})}return JSON.stringify({id:s,properties:i.properties,associatedTo:a})}case"hubspot_associate":{let n=we(e.fromType),i=we(e.toType);return!n||!e.fromId||!i||!e.toId?JSON.stringify({error:"fromType, fromId, toType and toId are all required"}):(await ne(`/crm/v4/objects/${encodeURIComponent(n)}/${encodeURIComponent(e.fromId)}/associations/default/${encodeURIComponent(i)}/${encodeURIComponent(e.toId)}`,{method:"PUT"}),JSON.stringify({ok:!0}))}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"hubspot_whoami",description:"Confirm the HubSpot token works: returns the portal (hub) id, account type, time zone and UI domain.",input_schema:{type:"object",properties:{}}},{name:"hubspot_list_properties",description:"List the defined properties (name, label, type, fieldType) for a CRM object type. Call this FIRST so you use valid property names when creating/updating/searching.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe}},required:["objectType"]}},{name:"hubspot_search",description:"Search a CRM object type. Pass a full-text `query` OR structured `filters` (array of {propertyName, operator, value}, e.g. operator EQ/CONTAINS_TOKEN/GT/\u2026). Returns { total, results:[{id, properties}] }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},query:{type:"string",description:"Optional full-text search string."},filters:{type:"array",description:"Optional structured filters (ANDed). Each: { propertyName, operator, value }. Operators: EQ, NEQ, LT, LTE, GT, GTE, CONTAINS_TOKEN, HAS_PROPERTY, IN, \u2026",items:{type:"object",properties:{propertyName:{type:"string"},operator:{type:"string"},value:{type:"string"}}}},properties:{type:"array",items:{type:"string"},description:"Optional: property names to return on each result."},limit:{type:"number",description:"Max results (default 20)."}},required:["objectType"]}},{name:"hubspot_get_object",description:"Fetch one CRM record by id. Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},id:{type:"string",description:"The record id."},properties:{type:"array",items:{type:"string"},description:"Optional: specific property names to return."},associations:{type:"string",description:'Optional: comma-separated object types to also return associations for (e.g. "companies,deals").'}},required:["objectType","id"]}},{name:"hubspot_list_objects",description:"Page through records of a CRM object type. Returns { results, paging } \u2014 pass paging.next.after back as `after` for the next page.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},properties:{type:"array",items:{type:"string"},description:"Optional: property names to return on each record."},limit:{type:"number",description:"Page size (default 20)."},after:{type:"string",description:"Optional paging cursor from a previous response (paging.next.after)."}},required:["objectType"]}},{name:"hubspot_create_object",description:"Create a CRM record. Pass `properties` as an object of { propertyName: value } (call hubspot_list_properties first for valid names). Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},properties:{type:"object",description:"Object of { propertyName: value } to set on the new record."}},required:["objectType","properties"]}},{name:"hubspot_update_object",description:"Update (PATCH) a CRM record by id. Pass `properties` as an object of { propertyName: value }. Returns { id, properties }.",input_schema:{type:"object",properties:{objectType:{type:"string",description:qe},id:{type:"string",description:"The record id to update."},properties:{type:"object",description:"Object of { propertyName: value } to change."}},required:["objectType","id","properties"]}},{name:"hubspot_create_note",description:"Log a note (hs_note_body) and optionally associate it to a contact/company/deal/ticket. Returns { id, associatedTo }.",input_schema:{type:"object",properties:{body:{type:"string",description:"The note text (stored as hs_note_body)."},contactId:{type:"string",description:"Optional: associate the note to this contact id."},companyId:{type:"string",description:"Optional: associate the note to this company id."},dealId:{type:"string",description:"Optional: associate the note to this deal id."},ticketId:{type:"string",description:"Optional: associate the note to this ticket id."},timestamp:{type:"string",description:"Optional ISO 8601 timestamp for the note (defaults to now)."}},required:["body"]}},{name:"hubspot_associate",description:"Associate two CRM records with the default association type (e.g. a contact to a company). Returns { ok:true }.",input_schema:{type:"object",properties:{fromType:{type:"string",description:"Source object type (e.g. contacts)."},fromId:{type:"string",description:"Source record id."},toType:{type:"string",description:"Target object type (e.g. companies)."},toId:{type:"string",description:"Target record id."}},required:["fromType","fromId","toType","toId"]}}]};import{existsSync as _c}from"fs";import{fileURLToPath as wc}from"url";import{dirname as kc,resolve as Sc}from"path";function vc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=kc(wc(import.meta.url)),t=Sc(r,"..","bin","mcp-skill.mjs");return _c(t)?t:null}var Ic=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function Nc(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let r=process.env.LINEAR_API_KEY;if(!r)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return r}async function V(r,t={}){let e=await fetch(Ic,{method:"POST",headers:{Authorization:Nc(),"Content-Type":"application/json"},body:JSON.stringify({query:r,variables:t})});if(!e.ok){let i=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${i.slice(0,300)}`)}let n=await e.json().catch(()=>null);if(!n)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(n.errors)&&n.errors.length){let i=n.errors.map(s=>s?.message||String(s)).join("; ");throw new Error(`Linear GraphQL error: ${i.slice(0,300)}`)}return n.data}function it(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_::"'`]/g,"")}function Oc(r,t){let e=it(r),n=it(t);if(!e||!n)return 0;if(e===n)return 1;if(e.length===1||n.length===1)return e===n?1:0;let i=d=>{let p=new Map;for(let u=0;u<d.length-1;u++){let m=d.slice(u,u+2);p.set(m,(p.get(m)||0)+1)}return p},s=i(e),o=i(n),a=0,c=0,l=0;for(let d of s.values())c+=d;for(let d of o.values())l+=d;for(let[d,p]of s.entries())a+=Math.min(p,o.get(d)||0);return 2*a/Math.max(1,c+l)}function Tc(r,t){let e=Array.isArray(r)?r:[];if(!e.length)return{state:null,strategy:"no-states"};let n=it(t);if(!n)return{state:null,strategy:"no-target"};let i=e.find(a=>it(a.name)===n);if(i)return{state:i,strategy:"exact"};let s={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[a,c]of Object.entries(s)){if(!c.some(d=>it(d)===n))continue;let l=e.find(d=>d.type===a);if(l)return{state:l,strategy:"type-alias"}}let o=e.map(a=>({s:a,score:Oc(t,a.name)})).sort((a,c)=>c.score-a.score);return o[0]&&o[0].score>=.5?{state:o[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var Rc=`
193
193
  id
194
194
  identifier
195
195
  number
@@ -334,7 +334,7 @@ You have direct access to the user's Plane workspace via the official Plane MCP
334
334
  - List/get projects and work items, then create/update/delete or search work items as needed.
335
335
  - For status changes, read the project's available states first, then set the work item's state.
336
336
  - Cycles and modules group work items \u2014 list them to scope queries before drilling into items.
337
- - Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:r,description:this.description}}};import{existsSync as Pc}from"fs";import{fileURLToPath as Cc}from"url";import{dirname as Uc,resolve as Bc}from"path";import{resolveIntegrationToken as Jc}from"@zibby/core/backend-client.js";function Dc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Uc(Cc(import.meta.url)),t=Bc(r,"..","bin","mcp-skill.mjs");return Pc(t)?t:null}async function Xn(){let r=await Jc(I.OPEN_DESIGN),t=r?.token,e=r?.baseUrl;if(!t||typeof t!="string")throw new Error("OpenDesign is not connected: missing token. Connect it in Integrations.");if(!e||typeof e!="string")throw new Error("OpenDesign is not connected: missing baseUrl. Connect it in Integrations.");let n=e.replace(/\/+$/,"");return{token:t,baseUrl:n}}async function we(r,t={}){let{token:e,baseUrl:n}=await Xn(),i=`${n}/api${r}`;if(t.query&&typeof t.query=="object"){let a=new URLSearchParams;for(let[l,d]of Object.entries(t.query))d!=null&&d!==""&&a.set(l,String(d));let c=a.toString();c&&(i+=(i.includes("?")?"&":"?")+c)}let s={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},o=await fetch(i,{method:t.method||"GET",headers:s,body:t.body?JSON.stringify(t.body):void 0});return Qn(o,"OpenDesign")}async function Qn(r,t){if(!r.ok){let n=await r.text().catch(()=>""),i=n.slice(0,300);try{let s=JSON.parse(n),o=s?.code||s?.error?.code,a=s?.message||s?.error?.message||s?.error;(o||a)&&(i=[o?`[${o}]`:null,a].filter(Boolean).join(" ")||i)}catch{}throw new Error(`${t} API ${r.status}: ${i}`)}let e=await r.text().catch(()=>"");if(!e)return{};try{return JSON.parse(e)}catch{return{raw:e}}}var ei={id:"open-design",callsBackend:!0,serverName:"opendesign",allowedTools:["mcp__opendesign__*"],envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"OpenDesign \u2014 list projects/designs, run the design agent, and export decks to PDF/HTML",promptFragment:`## OpenDesign (optional)
337
+ - Always operate within the connected workspace; the workspace slug and base URL are pre-configured (Plane Cloud, self-hosted, or Zibby-hosted all work transparently).`,resolve(){let r={};for(let t of this.envKeys)process.env[t]&&(r[t]=process.env[t]);return{type:"stdio",command:"uvx",args:["plane-mcp-server","stdio"],env:r,description:this.description}}};import{existsSync as Pc}from"fs";import{fileURLToPath as Cc}from"url";import{dirname as Uc,resolve as Bc}from"path";import{resolveIntegrationToken as Jc}from"@zibby/core/backend-client.js";function Dc(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Uc(Cc(import.meta.url)),t=Bc(r,"..","bin","mcp-skill.mjs");return Pc(t)?t:null}async function Xn(){let r=await Jc(I.OPEN_DESIGN),t=r?.token,e=r?.baseUrl;if(!t||typeof t!="string")throw new Error("OpenDesign is not connected: missing token. Connect it in Integrations.");if(!e||typeof e!="string")throw new Error("OpenDesign is not connected: missing baseUrl. Connect it in Integrations.");let n=e.replace(/\/+$/,"");return{token:t,baseUrl:n}}async function ke(r,t={}){let{token:e,baseUrl:n}=await Xn(),i=`${n}/api${r}`;if(t.query&&typeof t.query=="object"){let a=new URLSearchParams;for(let[l,d]of Object.entries(t.query))d!=null&&d!==""&&a.set(l,String(d));let c=a.toString();c&&(i+=(i.includes("?")?"&":"?")+c)}let s={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},o=await fetch(i,{method:t.method||"GET",headers:s,body:t.body?JSON.stringify(t.body):void 0});return Qn(o,"OpenDesign")}async function Qn(r,t){if(!r.ok){let n=await r.text().catch(()=>""),i=n.slice(0,300);try{let s=JSON.parse(n),o=s?.code||s?.error?.code,a=s?.message||s?.error?.message||s?.error;(o||a)&&(i=[o?`[${o}]`:null,a].filter(Boolean).join(" ")||i)}catch{}throw new Error(`${t} API ${r.status}: ${i}`)}let e=await r.text().catch(()=>"");if(!e)return{};try{return JSON.parse(e)}catch{return{raw:e}}}var ei={id:"open-design",callsBackend:!0,serverName:"opendesign",allowedTools:["mcp__opendesign__*"],envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV"],description:"OpenDesign \u2014 list projects/designs, run the design agent, and export decks to PDF/HTML",promptFragment:`## OpenDesign (optional)
338
338
  You may have access to the user's OpenDesign workspace (the Zibby-managed design/deck app) via its REST API. These tools are OPTIONAL \u2014 if OpenDesign is not connected they will return a "not connected" error; reach for them only when the task involves OpenDesign projects, designs, or exports. Tools (mcp__opendesign__*):
339
339
 
340
340
  ### Connectivity
@@ -356,7 +356,7 @@ You may have access to the user's OpenDesign workspace (the Zibby-managed design
356
356
 
357
357
  ### Notes
358
358
  - A design artifact lookup ALWAYS needs its projectId (it scopes the query).
359
- - After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=Dc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"opendesign_health":{let{baseUrl:e}=await Xn(),n=await fetch(`${e}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await Qn(n,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let e=await we("/projects");return JSON.stringify(e)}case"opendesign_get_project":{let e=t?.id||t?.projectId;if(!e)return JSON.stringify({error:"id is required"});let n=await we(`/projects/${encodeURIComponent(e)}`);return JSON.stringify(n)}case"opendesign_list_designs":{let e=t?.projectId;if(!e)return JSON.stringify({error:"projectId is required"});let n=await we("/live-artifacts",{query:{projectId:e}});return JSON.stringify(n)}case"opendesign_get_design":{let e=t?.id,n=t?.projectId;if(!e)return JSON.stringify({error:"id is required"});if(!n)return JSON.stringify({error:"projectId is required"});let i=await we(`/live-artifacts/${encodeURIComponent(e)}`,{query:{projectId:n}});return JSON.stringify(i)}case"opendesign_export_pdf":{let e=t?.projectId||t?.id,{fileName:n,title:i,deck:s}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"fileName is required"});let o={fileName:n};i!==void 0&&(o.title=i),s!==void 0&&(o.deck=s);let a=await we(`/projects/${encodeURIComponent(e)}/export/pdf`,{method:"POST",body:o});return JSON.stringify(a)}case"opendesign_export_html":{let e=t?.projectId||t?.id,n=t?.path;if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"path is required (the export sub-path)"});let s=String(n).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),o=await we(`/projects/${encodeURIComponent(e)}/export/${s}`,{query:{inline:1}});return JSON.stringify(o)}case"opendesign_cli_run":{let{agentId:e,message:n,projectId:i,conversationId:s,model:o}=t||{};if(!e)return JSON.stringify({error:"agentId is required"});if(!n)return JSON.stringify({error:"message is required"});let a={agentId:e,message:n};i!==void 0&&(a.projectId=i),s!==void 0&&(a.conversationId=s),o!==void 0&&(a.model=o);let c=await we("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let e=t?.id||t?.runId;if(!e)return JSON.stringify({error:"id (runId) is required"});let n=await we(`/runs/${encodeURIComponent(e)}`);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"opendesign_health",description:"Probe the OpenDesign instance (GET /api/health, no auth). Use to confirm connectivity before other calls.",input_schema:{type:"object",properties:{}}},{name:"opendesign_list_projects",description:"List the projects in the OpenDesign workspace.",input_schema:{type:"object",properties:{}}},{name:"opendesign_get_project",description:"Get a single OpenDesign project by id.",input_schema:{type:"object",properties:{id:{type:"string",description:"The project id."}},required:["id"]}},{name:"opendesign_list_designs",description:"List the live design artifacts in an OpenDesign project. Requires the projectId, which scopes the query.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id whose designs to list."}},required:["projectId"]}},{name:"opendesign_get_design",description:"Get a single live design artifact by id. Requires both the design id and its projectId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The live-artifact (design) id."},projectId:{type:"string",description:"The project id the design belongs to (scopes the lookup)."}},required:["id","projectId"]}},{name:"opendesign_export_pdf",description:"Export an OpenDesign project deck to PDF. Returns the export result (e.g. a download URL/path).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},fileName:{type:"string",description:"The output PDF file name."},title:{type:"string",description:"Optional deck title for the PDF."},deck:{description:"Optional deck payload/override to render instead of the project's current deck."}},required:["projectId","fileName"]}},{name:"opendesign_export_html",description:"Fetch an OpenDesign project's HTML export by sub-path (requested inline). Requires projectId and the export path.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},path:{type:"string",description:'The export sub-path under /projects/:id/export/ (e.g. "index.html" or a slide path).'}},required:["projectId","path"]}},{name:"opendesign_cli_run",description:"Start an OpenDesign agent run. Returns a runId; poll opendesign_cli_status with it until the run finishes.",input_schema:{type:"object",properties:{agentId:{type:"string",description:"The OpenDesign agent id to run."},message:{type:"string",description:"The instruction/message to send to the agent."},projectId:{type:"string",description:"Optional project id to scope the run to."},conversationId:{type:"string",description:"Optional conversation id to continue an existing thread."},model:{type:"string",description:"Optional model id override for the run."}},required:["agentId","message"]}},{name:"opendesign_cli_status",description:"Poll the status of an OpenDesign agent run by its runId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The runId returned by opendesign_cli_run."}},required:["id"]}}]};import{existsSync as qc}from"fs";import{fileURLToPath as Mc}from"url";import{dirname as Fc,resolve as Kc}from"path";import{resolveIntegrationToken as Gc}from"@zibby/core/backend-client.js";function Hc(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let r=Fc(Mc(import.meta.url)),t=Kc(r,"..","bin","mcp-slack.mjs");return qc(t)?t:null}async function z(r,t={}){let{token:e}=await Gc("slack"),n=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(r),i=`https://slack.com/api/${r}`,s={Authorization:`Bearer ${e}`},o;if(n){let l=new URLSearchParams(t).toString();l&&(i+=`?${l}`)}else s["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let c=await(await fetch(i,{method:n?"GET":"POST",headers:s,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var P={id:"slack",callsBackend:!0,serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:I.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack
359
+ - After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=Dc();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"opendesign_health":{let{baseUrl:e}=await Xn(),n=await fetch(`${e}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await Qn(n,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let e=await ke("/projects");return JSON.stringify(e)}case"opendesign_get_project":{let e=t?.id||t?.projectId;if(!e)return JSON.stringify({error:"id is required"});let n=await ke(`/projects/${encodeURIComponent(e)}`);return JSON.stringify(n)}case"opendesign_list_designs":{let e=t?.projectId;if(!e)return JSON.stringify({error:"projectId is required"});let n=await ke("/live-artifacts",{query:{projectId:e}});return JSON.stringify(n)}case"opendesign_get_design":{let e=t?.id,n=t?.projectId;if(!e)return JSON.stringify({error:"id is required"});if(!n)return JSON.stringify({error:"projectId is required"});let i=await ke(`/live-artifacts/${encodeURIComponent(e)}`,{query:{projectId:n}});return JSON.stringify(i)}case"opendesign_export_pdf":{let e=t?.projectId||t?.id,{fileName:n,title:i,deck:s}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"fileName is required"});let o={fileName:n};i!==void 0&&(o.title=i),s!==void 0&&(o.deck=s);let a=await ke(`/projects/${encodeURIComponent(e)}/export/pdf`,{method:"POST",body:o});return JSON.stringify(a)}case"opendesign_export_html":{let e=t?.projectId||t?.id,n=t?.path;if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"path is required (the export sub-path)"});let s=String(n).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),o=await ke(`/projects/${encodeURIComponent(e)}/export/${s}`,{query:{inline:1}});return JSON.stringify(o)}case"opendesign_cli_run":{let{agentId:e,message:n,projectId:i,conversationId:s,model:o}=t||{};if(!e)return JSON.stringify({error:"agentId is required"});if(!n)return JSON.stringify({error:"message is required"});let a={agentId:e,message:n};i!==void 0&&(a.projectId=i),s!==void 0&&(a.conversationId=s),o!==void 0&&(a.model=o);let c=await ke("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let e=t?.id||t?.runId;if(!e)return JSON.stringify({error:"id (runId) is required"});let n=await ke(`/runs/${encodeURIComponent(e)}`);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"opendesign_health",description:"Probe the OpenDesign instance (GET /api/health, no auth). Use to confirm connectivity before other calls.",input_schema:{type:"object",properties:{}}},{name:"opendesign_list_projects",description:"List the projects in the OpenDesign workspace.",input_schema:{type:"object",properties:{}}},{name:"opendesign_get_project",description:"Get a single OpenDesign project by id.",input_schema:{type:"object",properties:{id:{type:"string",description:"The project id."}},required:["id"]}},{name:"opendesign_list_designs",description:"List the live design artifacts in an OpenDesign project. Requires the projectId, which scopes the query.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id whose designs to list."}},required:["projectId"]}},{name:"opendesign_get_design",description:"Get a single live design artifact by id. Requires both the design id and its projectId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The live-artifact (design) id."},projectId:{type:"string",description:"The project id the design belongs to (scopes the lookup)."}},required:["id","projectId"]}},{name:"opendesign_export_pdf",description:"Export an OpenDesign project deck to PDF. Returns the export result (e.g. a download URL/path).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},fileName:{type:"string",description:"The output PDF file name."},title:{type:"string",description:"Optional deck title for the PDF."},deck:{description:"Optional deck payload/override to render instead of the project's current deck."}},required:["projectId","fileName"]}},{name:"opendesign_export_html",description:"Fetch an OpenDesign project's HTML export by sub-path (requested inline). Requires projectId and the export path.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},path:{type:"string",description:'The export sub-path under /projects/:id/export/ (e.g. "index.html" or a slide path).'}},required:["projectId","path"]}},{name:"opendesign_cli_run",description:"Start an OpenDesign agent run. Returns a runId; poll opendesign_cli_status with it until the run finishes.",input_schema:{type:"object",properties:{agentId:{type:"string",description:"The OpenDesign agent id to run."},message:{type:"string",description:"The instruction/message to send to the agent."},projectId:{type:"string",description:"Optional project id to scope the run to."},conversationId:{type:"string",description:"Optional conversation id to continue an existing thread."},model:{type:"string",description:"Optional model id override for the run."}},required:["agentId","message"]}},{name:"opendesign_cli_status",description:"Poll the status of an OpenDesign agent run by its runId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The runId returned by opendesign_cli_run."}},required:["id"]}}]};import{existsSync as qc}from"fs";import{fileURLToPath as Mc}from"url";import{dirname as Fc,resolve as Kc}from"path";import{resolveIntegrationToken as Gc}from"@zibby/core/backend-client.js";function Hc(){if(process.env.MCP_SLACK_PATH)return process.env.MCP_SLACK_PATH;let r=Fc(Mc(import.meta.url)),t=Kc(r,"..","bin","mcp-slack.mjs");return qc(t)?t:null}async function z(r,t={}){let{token:e}=await Gc("slack"),n=["conversations.list","users.list","users.profile.get","users.lookupByEmail","usergroups.list","usergroups.users.list","conversations.history","conversations.replies"].includes(r),i=`https://slack.com/api/${r}`,s={Authorization:`Bearer ${e}`},o;if(n){let l=new URLSearchParams(t).toString();l&&(i+=`?${l}`)}else s["Content-Type"]="application/json; charset=utf-8",o=JSON.stringify(t);let c=await(await fetch(i,{method:n?"GET":"POST",headers:s,body:o})).json();if(!c.ok)throw new Error(`Slack API error: ${c.error}`);return c}var P={id:"slack",callsBackend:!0,serverName:"slack",allowedTools:["mcp__slack__*"],requiresIntegration:I.SLACK,envKeys:["SLACK_BOT_TOKEN","SLACK_TEAM_ID"],description:"Slack MCP Server",promptFragment:`## Slack
360
360
  You have access to the user's Slack workspace. Use these tools:
361
361
  - slack_list_channels, slack_post_message, slack_reply_to_thread
362
362
  - slack_add_reaction, slack_get_channel_history, slack_get_thread_replies
@@ -373,7 +373,7 @@ When responding to an incoming event, prefer lark_reply with the source message_
373
373
  `),a=o>t/2?o+1:t;n.push(i.slice(0,a)),i=i.slice(a)}return i&&n.push(i),n}async function ri(){let r=(process.env.DISCORD_BOT_TOKEN||"").trim();if(r)return{token:r,guildId:(process.env.DISCORD_GUILD_ID||"").trim()};let t=await ol(I.DISCORD),e=(t&&t.token?String(t.token):"").trim();if(!e)throw new Error("Discord is not connected: connect Discord in the Zibby dashboard or set DISCORD_BOT_TOKEN.");return{token:e,guildId:(t.guildId||"").trim()}}async function vr(r,t,{token:e,body:n}={}){let i=e.startsWith("Bot ")?e:`Bot ${e}`,s=await fetch(`${cl}${t}`,{method:r,headers:{Authorization:i,...n!==void 0?{"Content-Type":"application/json"}:{}},...n!==void 0?{body:JSON.stringify(n)}:{}}),o=await s.json().catch(()=>null);if(!s.ok){let a=o&&(o.message||o.error)?o.message||o.error:`HTTP ${s.status}`;throw new Error(`Discord API error (${s.status}): ${a}`)}return o}async function pl({token:r,guildId:t},e){let n=String(e||"").trim()||t||(process.env.DISCORD_GUILD_ID||"").trim();if(n)return n;let i=await vr("GET","/users/@me/guilds",{token:r}),s=Array.isArray(i)?i:[];if(s.length===1)return s[0].id;if(s.length===0)throw new Error("The bot is not in any Discord server \u2014 invite it to a server first.");let o=s.slice(0,10).map(a=>`${a.name} (${a.id})`).join(", ");throw new Error(`The bot is in ${s.length} servers \u2014 pass guildId explicitly. Servers: ${o}`)}var ni={id:"discord",callsBackend:!0,serverName:"discord",allowedTools:["mcp__discord__*"],requiresIntegration:I.DISCORD,envKeys:["DISCORD_BOT_TOKEN","DISCORD_GUILD_ID"],description:"Discord bot tools (send messages, list channels)",promptFragment:`## Discord
374
374
  You can post to the user's Discord server as their bot. Tools:
375
375
  - discord_send_message(channelId, text) \u2014 post a message to a channel (long text is auto-chunked to Discord's 2000-char limit)
376
- - discord_list_channels(guildId?) \u2014 list the server's text channels (id + name) to find where to post; guildId is optional when the bot is in one server`,resolve(){let r={};for(let e of this.envKeys)process.env[e]&&(r[e]=process.env[e]);for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_SELF_HOST","DISCORD_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(r[e]=process.env[e]);let t=al();return t?{type:"stdio",command:"node",args:[t,"../dist/discord.js","discordSkill"],env:r,description:this.description,alwaysLoad:!0}:{command:null,args:[],env:r,description:this.description}},async handleToolCall(r,t={}){try{switch(r){case"discord_send_message":{let e=String(t.channelId||"").trim(),n=String(t.text||"");if(!e||!n.trim())return JSON.stringify({ok:!1,error:"channelId and text are required"});let i=await ri(),s=dl(n),o=[];for(let a of s){let c=await vr("POST",`/channels/${encodeURIComponent(e)}/messages`,{token:i.token,body:{content:a}});o.push(c&&c.id?c.id:"")}return JSON.stringify({ok:!0,channelId:e,messageIds:o,chunks:s.length})}case"discord_list_channels":{let e=await ri(),n=await pl(e,t.guildId),i=await vr("GET",`/guilds/${encodeURIComponent(n)}/channels`,{token:e.token}),s=(Array.isArray(i)?i:[]).filter(o=>o&&(o.type===0||o.type===5)).map(o=>({id:o.id,name:o.name,type:o.type===5?"announcement":"text",...o.topic?{topic:o.topic}:{}}));return JSON.stringify({ok:!0,guildId:n,channels:s})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"discord_send_message",description:"Post a message to a Discord channel as the connected bot. Text over 2000 chars is automatically split into sequential messages.",input_schema:{type:"object",properties:{channelId:{type:"string",description:"Discord channel id (snowflake). Use discord_list_channels to find it."},text:{type:"string",description:"Message text (Discord markdown supported)"}},required:["channelId","text"]}},{name:"discord_list_channels",description:"List the text channels of the connected Discord server (id + name). Pass guildId only when the bot is in multiple servers.",input_schema:{type:"object",properties:{guildId:{type:"string",description:"Discord server (guild) id \u2014 optional when the bot is in exactly one server or one was captured at connect time"}}}}]};import{existsSync as li,statSync as ul,readFileSync as ml}from"fs";import{fileURLToPath as fl}from"url";import{basename as hl,dirname as yl,resolve as gl}from"path";import{resolveIntegrationToken as bl,clearTokenCache as _l}from"@zibby/core/backend-client.js";function kl(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=yl(fl(import.meta.url)),t=gl(r,"..","bin","mcp-skill.mjs");return li(t)?t:null}var wl="2022-06-28",Sl="https://api.notion.com/v1",qt=2e4,ii=25,vl=25,Mt=100,si=500,Il=20*1024*1024;function pe(r){if(!r||typeof r!="string")return null;let e=r.trim().split(/[?#]/)[0],n=e.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);if(n)return n[0].toLowerCase();let i=e.match(/[0-9a-fA-F]{32}/g);if(i&&i.length){let s=i[i.length-1].toLowerCase();return`${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20)}`}return null}async function ie(r,t={}){let e=async()=>{let{token:n}=await bl("notion");if(typeof n!="string"||!n)throw new Error(`Invalid notion token type: ${typeof n}`);let i=await fetch(`${Sl}${r}`,{method:t.method||"GET",headers:{Authorization:`Bearer ${n}`,"Notion-Version":wl,Accept:"application/json",...t.body&&!t.formData?{"Content-Type":"application/json"}:{},...t.headers},body:t.formData?t.formData:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Notion API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await e()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return _l("notion"),e()}}function Fe(r){if(!Array.isArray(r))return"";let t="";for(let e of r){let n=e?.plain_text??e?.text?.content??"";if(!n)continue;let i=e.annotations||{};i.code&&(n=`\`${n}\``),i.bold&&(n=`**${n}**`),i.italic&&(n=`_${n}_`),i.strikethrough&&(n=`~~${n}~~`);let s=e?.href||e?.text?.link?.url;s&&(n=`[${n}](${s})`),t+=n}return t}function Nl(r,t,e){let n=r?.type,i=r?.[n]||{},s=" ".repeat(Math.max(0,t)),o=(l="rich_text")=>Fe(i[l]),a;switch(n){case"paragraph":a=o();break;case"heading_1":a=`# ${o()}`;break;case"heading_2":a=`## ${o()}`;break;case"heading_3":a=`### ${o()}`;break;case"bulleted_list_item":a=`${s}- ${o()}`;break;case"numbered_list_item":a=`${s}1. ${o()}`;break;case"to_do":a=`${s}- [${i.checked?"x":" "}] ${o()}`;break;case"toggle":a=`${s}- ${o()}`;break;case"quote":a=`> ${o()}`;break;case"callout":{a=`> ${i.icon?.emoji?`${i.icon.emoji} `:""}${o()}`;break}case"code":{a=`\`\`\`${i.language||""}
376
+ - discord_list_channels(guildId?) \u2014 list the server's text channels (id + name) to find where to post; guildId is optional when the bot is in one server`,resolve(){let r={};for(let e of this.envKeys)process.env[e]&&(r[e]=process.env[e]);for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_SELF_HOST","DISCORD_API_URL","EXECUTION_ID","PROJECT_ID","STAGE"])process.env[e]&&(r[e]=process.env[e]);let t=al();return t?{type:"stdio",command:"node",args:[t,"../dist/discord.js","discordSkill"],env:r,description:this.description,alwaysLoad:!0}:{command:null,args:[],env:r,description:this.description}},async handleToolCall(r,t={}){try{switch(r){case"discord_send_message":{let e=String(t.channelId||"").trim(),n=String(t.text||"");if(!e||!n.trim())return JSON.stringify({ok:!1,error:"channelId and text are required"});let i=await ri(),s=dl(n),o=[];for(let a of s){let c=await vr("POST",`/channels/${encodeURIComponent(e)}/messages`,{token:i.token,body:{content:a}});o.push(c&&c.id?c.id:"")}return JSON.stringify({ok:!0,channelId:e,messageIds:o,chunks:s.length})}case"discord_list_channels":{let e=await ri(),n=await pl(e,t.guildId),i=await vr("GET",`/guilds/${encodeURIComponent(n)}/channels`,{token:e.token}),s=(Array.isArray(i)?i:[]).filter(o=>o&&(o.type===0||o.type===5)).map(o=>({id:o.id,name:o.name,type:o.type===5?"announcement":"text",...o.topic?{topic:o.topic}:{}}));return JSON.stringify({ok:!0,guildId:n,channels:s})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"discord_send_message",description:"Post a message to a Discord channel as the connected bot. Text over 2000 chars is automatically split into sequential messages.",input_schema:{type:"object",properties:{channelId:{type:"string",description:"Discord channel id (snowflake). Use discord_list_channels to find it."},text:{type:"string",description:"Message text (Discord markdown supported)"}},required:["channelId","text"]}},{name:"discord_list_channels",description:"List the text channels of the connected Discord server (id + name). Pass guildId only when the bot is in multiple servers.",input_schema:{type:"object",properties:{guildId:{type:"string",description:"Discord server (guild) id \u2014 optional when the bot is in exactly one server or one was captured at connect time"}}}}]};import{existsSync as li,statSync as ul,readFileSync as ml}from"fs";import{fileURLToPath as fl}from"url";import{basename as hl,dirname as yl,resolve as gl}from"path";import{resolveIntegrationToken as bl,clearTokenCache as _l}from"@zibby/core/backend-client.js";function wl(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=yl(fl(import.meta.url)),t=gl(r,"..","bin","mcp-skill.mjs");return li(t)?t:null}var kl="2022-06-28",Sl="https://api.notion.com/v1",qt=2e4,ii=25,vl=25,Mt=100,si=500,Il=20*1024*1024;function pe(r){if(!r||typeof r!="string")return null;let e=r.trim().split(/[?#]/)[0],n=e.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);if(n)return n[0].toLowerCase();let i=e.match(/[0-9a-fA-F]{32}/g);if(i&&i.length){let s=i[i.length-1].toLowerCase();return`${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20)}`}return null}async function ie(r,t={}){let e=async()=>{let{token:n}=await bl("notion");if(typeof n!="string"||!n)throw new Error(`Invalid notion token type: ${typeof n}`);let i=await fetch(`${Sl}${r}`,{method:t.method||"GET",headers:{Authorization:`Bearer ${n}`,"Notion-Version":kl,Accept:"application/json",...t.body&&!t.formData?{"Content-Type":"application/json"}:{},...t.headers},body:t.formData?t.formData:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Notion API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await e()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return _l("notion"),e()}}function Fe(r){if(!Array.isArray(r))return"";let t="";for(let e of r){let n=e?.plain_text??e?.text?.content??"";if(!n)continue;let i=e.annotations||{};i.code&&(n=`\`${n}\``),i.bold&&(n=`**${n}**`),i.italic&&(n=`_${n}_`),i.strikethrough&&(n=`~~${n}~~`);let s=e?.href||e?.text?.link?.url;s&&(n=`[${n}](${s})`),t+=n}return t}function Nl(r,t,e){let n=r?.type,i=r?.[n]||{},s=" ".repeat(Math.max(0,t)),o=(l="rich_text")=>Fe(i[l]),a;switch(n){case"paragraph":a=o();break;case"heading_1":a=`# ${o()}`;break;case"heading_2":a=`## ${o()}`;break;case"heading_3":a=`### ${o()}`;break;case"bulleted_list_item":a=`${s}- ${o()}`;break;case"numbered_list_item":a=`${s}1. ${o()}`;break;case"to_do":a=`${s}- [${i.checked?"x":" "}] ${o()}`;break;case"toggle":a=`${s}- ${o()}`;break;case"quote":a=`> ${o()}`;break;case"callout":{a=`> ${i.icon?.emoji?`${i.icon.emoji} `:""}${o()}`;break}case"code":{a=`\`\`\`${i.language||""}
377
377
  ${o()}
378
378
  \`\`\``;break}case"divider":a="---";break;case"child_page":a=`[child page: ${i.title||""}]`;break;case"child_database":a=`[child database: ${i.title||""}]`;break;case"bookmark":case"embed":case"link_preview":a=i.url?`<${i.url}>`:"";break;case"equation":a=i.expression?`$${i.expression}$`:"";break;case"table":case"column_list":case"column":a="";break;case"table_row":{let l=(i.cells||[]).map(d=>Fe(d).trim());a=`${s}| ${l.join(" | ")} |`;break}default:a=o();break}let c=[];return a&&a.trim()&&c.push(a),e&&e.trim()&&c.push(e),c.join(`
379
379
  `)}async function di(r,t,e){let n=[],i,s=0;do{if(e.used>=qt)break;let o=new URLSearchParams({page_size:"100"});i&&o.set("start_cursor",i);let a=await ie(`/blocks/${r}/children?${o.toString()}`),c=Array.isArray(a.results)?a.results:[];for(let l of c){let d="";l.has_children&&(d=await di(l.id,t+1,e));let p=Nl(l,t,d);if(p&&(n.push(p),e.used+=p.length+1),e.used>=qt)break}i=a.has_more?a.next_cursor:void 0,s+=1}while(i&&s<vl);return n.join(`
@@ -388,7 +388,7 @@ You can read Notion content as context AND write to Notion (create pages, append
388
388
  - notion_insert_image: append an image block to a page. Pass { pageId, imagePath } for a LOCAL png/jpg file (\u226420MB, uploaded via Notion's File Upload API) or { pageId, imageUrl } for an external, publicly reachable image URL. Optional caption. Returns { ok, pageId, url }.
389
389
  - notion_list_comments: pass a page/block id OR URL; returns the open comment discussions on it ({ id, discussionId, text, author }). Use to read the comment thread you are replying to.
390
390
  - notion_add_comment: post a comment. To REPLY in an existing discussion pass { discussionId, text }; to start a NEW top-level comment on a page pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment \u2014 reply in the SAME discussionId.
391
- Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" / "cannot deliver to Notion" and continue.`,resolve(){let r=kl();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/notion.js","notionSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"notion_get_page":{let e=t?.pageId||t?.page||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await ie(`/pages/${n}`),s=oi(i),o=i?.url||`https://www.notion.so/${n.replace(/-/g,"")}`,c=await di(n,0,{used:0}),l=!1;return c.length>qt&&(c=c.slice(0,qt),l=!0),JSON.stringify({ok:!0,id:n,title:s,url:o,text:c,...l?{truncated:!0}:{}})}case"notion_query_database":{let e=t?.databaseId||t?.database||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let s={page_size:Math.max(1,Math.min(Number(t?.maxResults)||ii,ii))};t?.filter&&typeof t.filter=="object"&&(s.filter=t.filter);let o=await ie(`/databases/${n}/query`,{method:"POST",body:s}),c=(Array.isArray(o.results)?o.results:[]).map(l=>{let d={};for(let[p,u]of Object.entries(l.properties||{})){let m=Tl(u);m&&(d[p]=m)}return{id:l.id,title:oi(l),url:l.url||`https://www.notion.so/${String(l.id||"").replace(/-/g,"")}`,props:d}});return JSON.stringify({ok:!0,id:n,count:c.length,hasMore:!!o.has_more,rows:c})}case"notion_create_page":{let e=typeof t?.title=="string"&&t.title.trim()?t.title.trim():null;if(!e)return JSON.stringify({ok:!1,error:"title is required"});let n=t?.databaseId?pe(t.databaseId):null,i=t?.parentPageId?pe(t.parentPageId):pe(t?.parent||t?.pageId);if(!n&&!i)return JSON.stringify({ok:!1,error:"A valid parentPageId or databaseId is required"});let s=n?{database_id:n}:{page_id:i},o={title:{title:at(e)}},a=ai(t)||[],c=a.slice(0,Mt),l=await ie("/pages",{method:"POST",body:{parent:s,properties:o,...c.length?{children:c}:{}}}),d=l?.id;if(!d)return JSON.stringify({ok:!1,error:"Notion page create returned no id"});let p=a.slice(Mt);return p.length&&await ci(d,p),JSON.stringify({ok:!0,pageId:d,url:l?.url||Ir(d)})}case"notion_append_blocks":{let e=pe(t?.pageId||t?.blockId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=ai(t);return!n||!n.length?JSON.stringify({ok:!1,error:"markdown or blocks content is required"}):(await ci(e,n),JSON.stringify({ok:!0,pageId:e,url:Ir(e)}))}case"notion_insert_image":{let e=pe(t?.pageId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=typeof t?.caption=="string"&&t.caption.trim()?at(t.caption.trim()):null,i,s;if(typeof t?.imagePath=="string"&&t.imagePath.trim())s=await El(t.imagePath),i={type:"file_upload",file_upload:{id:s}};else if(typeof t?.imageUrl=="string"&&t.imageUrl.trim())i={type:"external",external:{url:t.imageUrl.trim()}};else return JSON.stringify({ok:!1,error:"imagePath (local png/jpg) or imageUrl is required"});return n&&(i.caption=n),await ie(`/blocks/${e}/children`,{method:"PATCH",body:{children:[{object:"block",type:"image",image:i}]}}),JSON.stringify({ok:!0,pageId:e,url:Ir(e),...s?{fileUploadId:s}:{}})}case"notion_list_comments":{let e=t?.blockId||t?.pageId||t?.block||t?.page||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page/block id or URL is required"});let i=new URLSearchParams({block_id:n,page_size:"100"}),s=await ie(`/comments?${i.toString()}`),a=(Array.isArray(s.results)?s.results:[]).map(Ol);return JSON.stringify({ok:!0,id:n,count:a.length,comments:a})}case"notion_add_comment":{let e=typeof t?.text=="string"?t.text:typeof t?.body=="string"?t.body:"";if(!e||!e.trim())return JSON.stringify({ok:!1,error:"text is required"});let n=t?.discussionId||t?.discussion_id||null,i;if(n)i={discussion_id:String(n),rich_text:at(e)};else{let o=t?.pageId||t?.page||t?.url||t?.id,a=pe(o);if(!a)return JSON.stringify({ok:!1,error:"Either discussionId (to reply) or a valid pageId (to start a comment) is required"});i={parent:{page_id:a},rich_text:at(e)}}let s=await ie("/comments",{method:"POST",body:i});return JSON.stringify({ok:!0,id:s?.id||"",discussionId:s?.discussion_id||n||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"notion_get_page",description:"Fetch a Notion page and its content flattened to markdown, for use as read-only context. Accepts a raw page id OR a full Notion URL. Returns { ok, id, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."}},required:["pageId"]}},{name:"notion_query_database",description:"Query a Notion database and return a bounded list of rows (id, title, url, key props). Accepts a database id OR full Notion URL. Optional Notion filter object. Returns at most 25 rows.",input_schema:{type:"object",properties:{databaseId:{type:"string",description:"Notion database id (dashed UUID or 32-char) OR a full Notion database URL."},filter:{type:"object",description:"Optional Notion filter object (Notion query filter syntax).",additionalProperties:!0},maxResults:{type:"number",description:"Max rows to return (default 25, max 25)."}},required:["databaseId"]}},{name:"notion_create_page",description:"Create a new Notion page under a parent page (parentPageId) OR in a database (databaseId) \u2014 exactly one parent is required. Body from markdown (#/##/### headings, - bullets, 1. ordered lists; inline marks kept as literal text) or raw Notion block objects. Long bodies are chunked automatically (Notion caps 100 blocks/request). Returns { ok, pageId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{parentPageId:{type:"string",description:"Parent PAGE id/URL to create the page under (used when databaseId is absent)."},databaseId:{type:"string",description:"Parent DATABASE id/URL to create the page in (title goes into the title property)."},title:{type:"string",description:"Page title."},markdown:{type:"string",description:"Page body as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["title"]}},{name:"notion_append_blocks",description:"Append markdown (or raw Notion blocks) to the END of an existing Notion page. Accepts a page id or full Notion URL. Chunks automatically at Notion's 100-blocks-per-request cap. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["pageId"]}},{name:"notion_insert_image",description:"Append an image block to a Notion page. Pass imagePath for a LOCAL .png/.jpg file (max 20MB \u2014 uploaded via Notion's File Upload API, stored by Notion) or imageUrl for an external publicly-reachable image URL. Optional caption. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 20MB). Preferred for locally rendered charts."},imageUrl:{type:"string",description:"External image URL (must be publicly reachable; used when imagePath is absent)."},caption:{type:"string",description:"Optional image caption."}},required:["pageId"]}},{name:"notion_list_comments",description:"List the open comment discussions on a Notion page/block. Accepts a page/block id OR a full Notion URL. Returns { ok, comments:[{ id, discussionId, text, author }] }. Use to read the comment thread you are replying to.",input_schema:{type:"object",properties:{blockId:{type:"string",description:"Notion page or block id (dashed UUID or 32-char) OR a full Notion URL."}},required:["blockId"]}},{name:"notion_add_comment",description:"Post a comment on Notion. To REPLY within an existing discussion, pass { discussionId, text }. To start a NEW top-level comment on a page, pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment (reply in the same discussionId).",input_schema:{type:"object",properties:{discussionId:{type:"string",description:"The discussion_id to reply into (from notion_list_comments). Preferred for replies."},pageId:{type:"string",description:"Page id/URL to start a NEW top-level comment on (used when discussionId is absent)."},text:{type:"string",description:"The comment body (plain text)."}},required:["text"]}}]};import{existsSync as xl,readFileSync as jl}from"fs";import{fileURLToPath as Ll}from"url";import{dirname as $l,resolve as Pl}from"path";import{resolveIntegrationToken as Nr,clearTokenCache as Cl}from"@zibby/core/backend-client.js";function Ul(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=$l(Ll(import.meta.url)),t=Pl(r,"..","bin","mcp-skill.mjs");return xl(t)?t:null}function Bl(){let r=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!r)return null;let t=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:r,memberId:t}}function Jl(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function Dl(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var ql="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function Or(){let r=Bl();if(r)return r;if(Jl()||Dl())throw new Error(ql);return null}var Ml="202506",Fl="https://api.linkedin.com";function ui(r){if(r==null)return null;let t=String(r).trim();if(!t)return null;let e=t.match(/urn:li:organization:(\d+)/i);return e?e[1]:/^\d+$/.test(t)?t:null}function mi(r){if(!r)return"";if(r.localizedName)return String(r.localizedName);let t=r.name&&r.name.localized;if(t&&typeof t=="object"){let e=Object.values(t)[0];if(e)return String(e)}return""}function Ft(r,t){return r?typeof r.get=="function"?r.get(t):r[t]||r[t.toLowerCase()]||null:null}async function Oe(r,t={},e="linkedin_business"){let n=async()=>{let i;if(e==="linkedin_personal"){let l=Or();l&&(i=l.token)}if(i||({token:i}=await Nr(e)),typeof i!="string"||!i)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let s=r.startsWith("https://")?r:`${Fl}${r}`,o=await fetch(s,{method:t.method||"GET",headers:{Authorization:`Bearer ${i}`,"LinkedIn-Version":Ml,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`LinkedIn API ${o.status}: ${l.slice(0,300)}`)}let a=await o.text().catch(()=>""),c={};if(a&&a.trim())try{c=JSON.parse(a)}catch{c={raw:a}}return{status:o.status,headers:o.headers,body:c}};try{return await n()}catch(i){let s=String(i?.message||i||"").toLowerCase();if(!(s.includes("token")||s.includes("401")||s.includes("unauthorized")))throw i;return Cl(e),n()}}async function Kl(r){let t;if(r==="linkedin_personal"){let e=Or();e&&(t=e.token)}if(t||({token:t}=await Nr(r)),typeof t!="string"||!t)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");return t}function Gl(r){switch(String(r||"").toLowerCase().match(/\.([a-z0-9]+)$/)?.[1]){case"jpg":case"jpeg":return"image/jpeg";case"gif":return"image/gif";case"webp":return"image/webp";default:return"image/png"}}async function fi(r,t,e,n){if(typeof e!="string"||!e.trim())throw new Error("imagePath (a local image file path) is required to upload an image");let{body:i}=await Oe("/rest/images?action=initializeUpload",{method:"POST",body:{initializeUploadRequest:{owner:t}}},r),s=i?.value?.uploadUrl,o=i?.value?.image;if(!s||!o)throw new Error(`LinkedIn image initializeUpload returned no uploadUrl/image (got: ${JSON.stringify(i).slice(0,200)})`);let a=jl(e),c=await Kl(r),l=await fetch(s,{method:"PUT",headers:{Authorization:`Bearer ${c}`,"Content-Type":n||Gl(e)},body:a});if(!l.ok){let d=await l.text().catch(()=>"");throw new Error(`LinkedIn image upload ${l.status}: ${d.slice(0,300)}`)}return o}var hi={id:"linkedin",callsBackend:!0,serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn
391
+ Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" / "cannot deliver to Notion" and continue.`,resolve(){let r=wl();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/notion.js","notionSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"notion_get_page":{let e=t?.pageId||t?.page||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await ie(`/pages/${n}`),s=oi(i),o=i?.url||`https://www.notion.so/${n.replace(/-/g,"")}`,c=await di(n,0,{used:0}),l=!1;return c.length>qt&&(c=c.slice(0,qt),l=!0),JSON.stringify({ok:!0,id:n,title:s,url:o,text:c,...l?{truncated:!0}:{}})}case"notion_query_database":{let e=t?.databaseId||t?.database||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let s={page_size:Math.max(1,Math.min(Number(t?.maxResults)||ii,ii))};t?.filter&&typeof t.filter=="object"&&(s.filter=t.filter);let o=await ie(`/databases/${n}/query`,{method:"POST",body:s}),c=(Array.isArray(o.results)?o.results:[]).map(l=>{let d={};for(let[p,u]of Object.entries(l.properties||{})){let m=Tl(u);m&&(d[p]=m)}return{id:l.id,title:oi(l),url:l.url||`https://www.notion.so/${String(l.id||"").replace(/-/g,"")}`,props:d}});return JSON.stringify({ok:!0,id:n,count:c.length,hasMore:!!o.has_more,rows:c})}case"notion_create_page":{let e=typeof t?.title=="string"&&t.title.trim()?t.title.trim():null;if(!e)return JSON.stringify({ok:!1,error:"title is required"});let n=t?.databaseId?pe(t.databaseId):null,i=t?.parentPageId?pe(t.parentPageId):pe(t?.parent||t?.pageId);if(!n&&!i)return JSON.stringify({ok:!1,error:"A valid parentPageId or databaseId is required"});let s=n?{database_id:n}:{page_id:i},o={title:{title:at(e)}},a=ai(t)||[],c=a.slice(0,Mt),l=await ie("/pages",{method:"POST",body:{parent:s,properties:o,...c.length?{children:c}:{}}}),d=l?.id;if(!d)return JSON.stringify({ok:!1,error:"Notion page create returned no id"});let p=a.slice(Mt);return p.length&&await ci(d,p),JSON.stringify({ok:!0,pageId:d,url:l?.url||Ir(d)})}case"notion_append_blocks":{let e=pe(t?.pageId||t?.blockId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=ai(t);return!n||!n.length?JSON.stringify({ok:!1,error:"markdown or blocks content is required"}):(await ci(e,n),JSON.stringify({ok:!0,pageId:e,url:Ir(e)}))}case"notion_insert_image":{let e=pe(t?.pageId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=typeof t?.caption=="string"&&t.caption.trim()?at(t.caption.trim()):null,i,s;if(typeof t?.imagePath=="string"&&t.imagePath.trim())s=await El(t.imagePath),i={type:"file_upload",file_upload:{id:s}};else if(typeof t?.imageUrl=="string"&&t.imageUrl.trim())i={type:"external",external:{url:t.imageUrl.trim()}};else return JSON.stringify({ok:!1,error:"imagePath (local png/jpg) or imageUrl is required"});return n&&(i.caption=n),await ie(`/blocks/${e}/children`,{method:"PATCH",body:{children:[{object:"block",type:"image",image:i}]}}),JSON.stringify({ok:!0,pageId:e,url:Ir(e),...s?{fileUploadId:s}:{}})}case"notion_list_comments":{let e=t?.blockId||t?.pageId||t?.block||t?.page||t?.url||t?.id,n=pe(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Notion page/block id or URL is required"});let i=new URLSearchParams({block_id:n,page_size:"100"}),s=await ie(`/comments?${i.toString()}`),a=(Array.isArray(s.results)?s.results:[]).map(Ol);return JSON.stringify({ok:!0,id:n,count:a.length,comments:a})}case"notion_add_comment":{let e=typeof t?.text=="string"?t.text:typeof t?.body=="string"?t.body:"";if(!e||!e.trim())return JSON.stringify({ok:!1,error:"text is required"});let n=t?.discussionId||t?.discussion_id||null,i;if(n)i={discussion_id:String(n),rich_text:at(e)};else{let o=t?.pageId||t?.page||t?.url||t?.id,a=pe(o);if(!a)return JSON.stringify({ok:!1,error:"Either discussionId (to reply) or a valid pageId (to start a comment) is required"});i={parent:{page_id:a},rich_text:at(e)}}let s=await ie("/comments",{method:"POST",body:i});return JSON.stringify({ok:!0,id:s?.id||"",discussionId:s?.discussion_id||n||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"notion_get_page",description:"Fetch a Notion page and its content flattened to markdown, for use as read-only context. Accepts a raw page id OR a full Notion URL. Returns { ok, id, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."}},required:["pageId"]}},{name:"notion_query_database",description:"Query a Notion database and return a bounded list of rows (id, title, url, key props). Accepts a database id OR full Notion URL. Optional Notion filter object. Returns at most 25 rows.",input_schema:{type:"object",properties:{databaseId:{type:"string",description:"Notion database id (dashed UUID or 32-char) OR a full Notion database URL."},filter:{type:"object",description:"Optional Notion filter object (Notion query filter syntax).",additionalProperties:!0},maxResults:{type:"number",description:"Max rows to return (default 25, max 25)."}},required:["databaseId"]}},{name:"notion_create_page",description:"Create a new Notion page under a parent page (parentPageId) OR in a database (databaseId) \u2014 exactly one parent is required. Body from markdown (#/##/### headings, - bullets, 1. ordered lists; inline marks kept as literal text) or raw Notion block objects. Long bodies are chunked automatically (Notion caps 100 blocks/request). Returns { ok, pageId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{parentPageId:{type:"string",description:"Parent PAGE id/URL to create the page under (used when databaseId is absent)."},databaseId:{type:"string",description:"Parent DATABASE id/URL to create the page in (title goes into the title property)."},title:{type:"string",description:"Page title."},markdown:{type:"string",description:"Page body as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["title"]}},{name:"notion_append_blocks",description:"Append markdown (or raw Notion blocks) to the END of an existing Notion page. Accepts a page id or full Notion URL. Chunks automatically at Notion's 100-blocks-per-request cap. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},blocks:{type:"array",description:"Raw Notion block objects (advanced; used instead of markdown, max 500).",items:{type:"object",additionalProperties:!0}}},required:["pageId"]}},{name:"notion_insert_image",description:"Append an image block to a Notion page. Pass imagePath for a LOCAL .png/.jpg file (max 20MB \u2014 uploaded via Notion's File Upload API, stored by Notion) or imageUrl for an external publicly-reachable image URL. Optional caption. Returns { ok, pageId, url }.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 20MB). Preferred for locally rendered charts."},imageUrl:{type:"string",description:"External image URL (must be publicly reachable; used when imagePath is absent)."},caption:{type:"string",description:"Optional image caption."}},required:["pageId"]}},{name:"notion_list_comments",description:"List the open comment discussions on a Notion page/block. Accepts a page/block id OR a full Notion URL. Returns { ok, comments:[{ id, discussionId, text, author }] }. Use to read the comment thread you are replying to.",input_schema:{type:"object",properties:{blockId:{type:"string",description:"Notion page or block id (dashed UUID or 32-char) OR a full Notion URL."}},required:["blockId"]}},{name:"notion_add_comment",description:"Post a comment on Notion. To REPLY within an existing discussion, pass { discussionId, text }. To start a NEW top-level comment on a page, pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment (reply in the same discussionId).",input_schema:{type:"object",properties:{discussionId:{type:"string",description:"The discussion_id to reply into (from notion_list_comments). Preferred for replies."},pageId:{type:"string",description:"Page id/URL to start a NEW top-level comment on (used when discussionId is absent)."},text:{type:"string",description:"The comment body (plain text)."}},required:["text"]}}]};import{existsSync as xl,readFileSync as jl}from"fs";import{fileURLToPath as Ll}from"url";import{dirname as $l,resolve as Pl}from"path";import{resolveIntegrationToken as Nr,clearTokenCache as Cl}from"@zibby/core/backend-client.js";function Ul(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=$l(Ll(import.meta.url)),t=Pl(r,"..","bin","mcp-skill.mjs");return xl(t)?t:null}function Bl(){let r=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!r)return null;let t=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:r,memberId:t}}function Jl(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function Dl(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var ql="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function Or(){let r=Bl();if(r)return r;if(Jl()||Dl())throw new Error(ql);return null}var Ml="202506",Fl="https://api.linkedin.com";function ui(r){if(r==null)return null;let t=String(r).trim();if(!t)return null;let e=t.match(/urn:li:organization:(\d+)/i);return e?e[1]:/^\d+$/.test(t)?t:null}function mi(r){if(!r)return"";if(r.localizedName)return String(r.localizedName);let t=r.name&&r.name.localized;if(t&&typeof t=="object"){let e=Object.values(t)[0];if(e)return String(e)}return""}function Ft(r,t){return r?typeof r.get=="function"?r.get(t):r[t]||r[t.toLowerCase()]||null:null}async function Oe(r,t={},e="linkedin_business"){let n=async()=>{let i;if(e==="linkedin_personal"){let l=Or();l&&(i=l.token)}if(i||({token:i}=await Nr(e)),typeof i!="string"||!i)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let s=r.startsWith("https://")?r:`${Fl}${r}`,o=await fetch(s,{method:t.method||"GET",headers:{Authorization:`Bearer ${i}`,"LinkedIn-Version":Ml,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!o.ok){let l=await o.text().catch(()=>"");throw new Error(`LinkedIn API ${o.status}: ${l.slice(0,300)}`)}let a=await o.text().catch(()=>""),c={};if(a&&a.trim())try{c=JSON.parse(a)}catch{c={raw:a}}return{status:o.status,headers:o.headers,body:c}};try{return await n()}catch(i){let s=String(i?.message||i||"").toLowerCase();if(!(s.includes("token")||s.includes("401")||s.includes("unauthorized")))throw i;return Cl(e),n()}}async function Kl(r){let t;if(r==="linkedin_personal"){let e=Or();e&&(t=e.token)}if(t||({token:t}=await Nr(r)),typeof t!="string"||!t)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");return t}function Gl(r){switch(String(r||"").toLowerCase().match(/\.([a-z0-9]+)$/)?.[1]){case"jpg":case"jpeg":return"image/jpeg";case"gif":return"image/gif";case"webp":return"image/webp";default:return"image/png"}}async function fi(r,t,e,n){if(typeof e!="string"||!e.trim())throw new Error("imagePath (a local image file path) is required to upload an image");let{body:i}=await Oe("/rest/images?action=initializeUpload",{method:"POST",body:{initializeUploadRequest:{owner:t}}},r),s=i?.value?.uploadUrl,o=i?.value?.image;if(!s||!o)throw new Error(`LinkedIn image initializeUpload returned no uploadUrl/image (got: ${JSON.stringify(i).slice(0,200)})`);let a=jl(e),c=await Kl(r),l=await fetch(s,{method:"PUT",headers:{Authorization:`Bearer ${c}`,"Content-Type":n||Gl(e)},body:a});if(!l.ok){let d=await l.text().catch(()=>"");throw new Error(`LinkedIn image upload ${l.status}: ${d.slice(0,300)}`)}return o}var hi={id:"linkedin",callsBackend:!0,serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn
392
392
  You can post to LinkedIn two ways \u2014 an ORG company Page (business) and your own member PROFILE (personal). Each path needs its own LinkedIn integration connected.
393
393
 
394
394
  Business (company Page) \u2014 DRAFT only:
@@ -406,7 +406,7 @@ Notes:
406
406
  - PUBLISHING IS OUTWARD-FACING AND IRREVERSIBLE. linkedin_publish_post posts live to a real audience the instant you call it \u2014 there is no undo and no draft state for member profiles. Only call it after the human has EXPLICITLY approved publishing THIS specific text in THIS conversation. If you wrote or edited the text, show it and get an explicit "yes, publish" first; if you are unsure, HOLD/draft rather than publish. The org draft tool (linkedin_create_draft_post) is the safe default when a human still needs to review.
407
407
  - If the relevant LinkedIn integration is not connected these tools return { ok:false, error }; treat that as "LinkedIn unavailable" and continue.`,resolve(){let r=Ul();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_INJECTED_LINKEDIN_TOKEN","ZIBBY_INJECTED_LINKEDIN_MEMBER_ID","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/linkedin.js","linkedinSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"linkedin_list_organizations":{let{body:e}=await Oe("/rest/organizationAcls?q=roleAssignee&role=ADMINISTRATOR&state=APPROVED",{},"linkedin_business"),n=Array.isArray(e.elements)?e.elements:[],i=[];for(let s of n){let o=s.organizationalTarget||s["organizationalTarget~"]||s.organization,a=ui(o);if(!a)continue;let c="",l="";try{let d=(await Oe(`/rest/organizations/${a}`,{},"linkedin_business")).body;c=mi(d),l=d.vanityName||""}catch{}i.push({id:a,urn:`urn:li:organization:${a}`,name:c,vanityName:l})}return JSON.stringify({ok:!0,count:i.length,organizations:i})}case"linkedin_create_draft_post":{let e=t?.organizationUrn||t?.organizationId||t?.organization||t?.orgId,n=ui(e);if(!n)return JSON.stringify({ok:!1,error:"A valid organizationId or organizationUrn (urn:li:organization:{id}) is required"});let i=t?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post commentary) is required"});let s=t?.visibility?String(t.visibility).toUpperCase():"PUBLIC",o=`urn:li:organization:${n}`,a=typeof t?.imagePath=="string"?t.imagePath.trim():"",c=typeof t?.imageAltText=="string"?t.imageAltText:"";if(t?.dry_run===!0)try{let u="";try{let m=(await Oe(`/rest/organizations/${n}`,{},"linkedin_business")).body;u=mi(m)}catch{}return JSON.stringify({dryRun:!0,target:"organization",wouldPostAs:{name:u,id:n,urn:o},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let l={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"DRAFT",isReshareDisabledByAuthor:!1};if(a){let u=await fi("linkedin_business",o,a);l.content={media:{id:u,altText:c||""}}}let d=await Oe("/rest/posts",{method:"POST",body:l},"linkedin_business"),p=Ft(d.headers,"x-restli-id")||Ft(d.headers,"x-linkedin-id")||d.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"DRAFT",visibility:s,status:d.status})}case"linkedin_publish_post":{let e=Or(),n=e?e.memberId:(await Nr("linkedin_personal")).memberId;if(!n)return JSON.stringify({ok:!1,error:"LinkedIn (personal) not connected or member id unavailable \u2014 reconnect LinkedIn Personal"});let i=t?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post body) is required"});let s=t?.visibility?String(t.visibility).toUpperCase():"PUBLIC",o=`urn:li:person:${n}`,a=typeof t?.imagePath=="string"?t.imagePath.trim():"",c=typeof t?.imageAltText=="string"?t.imageAltText:"";if(t?.dry_run===!0)try{let u=(await Oe("/v2/userinfo",{},"linkedin_personal")).body,m=u?.name||[u?.given_name,u?.family_name].filter(Boolean).join(" ")||"",f=u?.sub?String(u.sub):n;return JSON.stringify({dryRun:!0,target:"member",wouldPostAs:{name:m,id:f,urn:`urn:li:person:${f}`},visibility:s,textPreview:i,...a?{imageWouldAttach:!0,imagePath:a}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(u){return JSON.stringify({dryRun:!0,ok:!1,error:u.message})}let l={author:o,commentary:i,visibility:s,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"PUBLISHED",isReshareDisabledByAuthor:!1};if(a){let u=await fi("linkedin_personal",o,a);l.content={media:{id:u,altText:c||""}}}let d=await Oe("/rest/posts",{method:"POST",body:l},"linkedin_personal"),p=Ft(d.headers,"x-restli-id")||Ft(d.headers,"x-linkedin-id")||d.body?.id||null;return JSON.stringify({ok:!0,postUrn:p,author:o,lifecycleState:"PUBLISHED",visibility:s,status:d.status})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"linkedin_list_organizations",description:"List the LinkedIn Organizations (company Pages) the authenticated member ADMINISTERS. Returns [{ id, urn, name, vanityName }]. Call this first to choose the author org for a draft post.",input_schema:{type:"object",properties:{}}},{name:"linkedin_create_draft_post",description:"Create a DRAFT post on a LinkedIn Organization (company Page). The post is created in DRAFT state (never published automatically) so a human can review and publish it in LinkedIn. Returns the created post URN. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{organizationId:{type:"string",description:'The numeric organization id (e.g. "12345"). Alternative to organizationUrn.'},organizationUrn:{type:"string",description:'The organization URN, e.g. "urn:li:organization:12345". Alternative to organizationId.'},text:{type:"string",description:"The post commentary (the body text of the post)."},visibility:{type:"string",enum:["PUBLIC"],description:"Post visibility. Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}},{name:"linkedin_publish_post",description:"PUBLISH a post to the authenticated member's OWN LinkedIn profile feed (personal). UNLIKE linkedin_create_draft_post (which only drafts on a company Page), this PUBLISHES the post IMMEDIATELY \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns the created post URN. Requires the LinkedIn Personal integration connected. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{text:{type:"string",description:"The post body (the commentary text of the post)."},visibility:{type:"string",enum:["PUBLIC","CONNECTIONS"],description:"Post visibility: PUBLIC (anyone) or CONNECTIONS (your connections only). Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}}]};import{existsSync as _i,statSync as Hl,readFileSync as zl}from"fs";import{fileURLToPath as Yl}from"url";import{basename as Wl,dirname as Zl,resolve as Vl}from"path";import{resolveIntegrationToken as Xl,clearTokenCache as Ql}from"@zibby/core/backend-client.js";function ed(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Zl(Yl(import.meta.url)),t=Vl(r,"..","bin","mcp-skill.mjs");return _i(t)?t:null}var Te="https://docs.googleapis.com/v1",yi="https://www.googleapis.com/drive/v3",td="https://www.googleapis.com/upload/drive/v3",rd=5*1024*1024;function nd(){let r=String(process.env.ZIBBY_INJECTED_GOOGLE_TOKEN||"").trim();if(!r)return null;let t=String(process.env.ZIBBY_INJECTED_GOOGLE_EMAIL||"").trim();return{token:r,email:t}}function id(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}function sd(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}var od="You haven't connected your own Google account \u2014 connect it at https://studio.zibby.dev/integrations (Google Docs). For privacy, I can't use anyone else's Google (including the project owner's) on your behalf.",Rr=2e4,ad=25;function Tr(r){if(!r||typeof r!="string")return null;let t=r.trim(),e=t.match(/\/document\/(?:u\/\d+\/)?d\/([a-zA-Z0-9_-]+)/);return e?e[1]:/^[a-zA-Z0-9_-]{20,}$/.test(t)?t:null}async function cd(){let r,t=nd();if(t)r=t.token;else{if(sd()||id())throw new Error(od);({token:r}=await Xl("google"))}if(typeof r!="string"||!r)throw new Error(`Invalid google token type: ${typeof r}`);return r}async function se(r,t={}){let e=async()=>{let n=await cd(),i=await fetch(r,{method:t.method||"GET",headers:{Authorization:`Bearer ${n}`,Accept:"application/json",...t.rawBody&&t.contentType?{"Content-Type":t.contentType}:t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.rawBody?t.rawBody:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`Google API ${i.status}: ${o.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await e()}catch(n){let i=String(n?.message||n||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw n;return Ql("google"),e()}}function ld(r){let t=[],e="",n=0;for(;n<r.length;){let i=/^\[([^\]]+)\]\(([^)\s]+)\)/.exec(r.slice(n));if(i){t.push({start:e.length,end:e.length+i[1].length,link:i[2]}),e+=i[1],n+=i[0].length;continue}let s=/^\*\*([^*]+)\*\*/.exec(r.slice(n));if(s){t.push({start:e.length,end:e.length+s[1].length,bold:!0}),e+=s[1],n+=s[0].length;continue}let o=/^`([^`]+)`/.exec(r.slice(n));if(o){t.push({start:e.length,end:e.length+o[1].length,code:!0}),e+=o[1],n+=o[0].length;continue}e+=r[n],n+=1}return{text:e,styles:t}}function gi(r,t){let e=String(r??"").replace(/\r\n/g,`
408
408
  `);if(!e.trim())return{requests:[],endIndex:t};let n=e.split(`
409
- `),i="",s=[],o=[];for(let d of n){let p=d,u=null,m=null,f=/^(#{1,3})\s+(.*)$/.exec(p),h=/^\s*[-*]\s+(.*)$/.exec(p),_=/^\s*\d+[.)]\s+(.*)$/.exec(p);f?(u=`HEADING_${f[1].length}`,p=f[2]):h?(m="BULLET_DISC_CIRCLE_SQUARE",p=h[1]):_&&(m="NUMBERED_DECIMAL_ALPHA_ROMAN",p=_[1]);let{text:y,styles:b}=ld(p),g=t+i.length;for(let k of b)o.push({...k,start:g+k.start,end:g+k.end});i+=`${y}
409
+ `),i="",s=[],o=[];for(let d of n){let p=d,u=null,m=null,f=/^(#{1,3})\s+(.*)$/.exec(p),h=/^\s*[-*]\s+(.*)$/.exec(p),_=/^\s*\d+[.)]\s+(.*)$/.exec(p);f?(u=`HEADING_${f[1].length}`,p=f[2]):h?(m="BULLET_DISC_CIRCLE_SQUARE",p=h[1]):_&&(m="NUMBERED_DECIMAL_ALPHA_ROMAN",p=_[1]);let{text:y,styles:b}=ld(p),g=t+i.length;for(let w of b)o.push({...w,start:g+w.start,end:g+w.end});i+=`${y}
410
410
  `,s.push({start:g,end:t+i.length,named:u,bullet:m})}if(!i)return{requests:[],endIndex:t};let a=[{insertText:{location:{index:t},text:i}}];for(let d of s)d.named&&a.push({updateParagraphStyle:{range:{startIndex:d.start,endIndex:d.end},paragraphStyle:{namedStyleType:d.named},fields:"namedStyleType"}});let c=null,l=()=>{c&&(a.push({createParagraphBullets:{range:{startIndex:c.start,endIndex:c.end},bulletPreset:c.preset}}),c=null)};for(let d of s)d.bullet?c&&c.preset===d.bullet?c.end=d.end:(l(),c={start:d.start,end:d.end,preset:d.bullet}):l();l();for(let d of o)d.end<=d.start||(d.bold?a.push({updateTextStyle:{range:{startIndex:d.start,endIndex:d.end},textStyle:{bold:!0},fields:"bold"}}):d.link?a.push({updateTextStyle:{range:{startIndex:d.start,endIndex:d.end},textStyle:{link:{url:d.link}},fields:"link"}}):d.code&&a.push({updateTextStyle:{range:{startIndex:d.start,endIndex:d.end},textStyle:{weightedFontFamily:{fontFamily:"Courier New"}},fields:"weightedFontFamily"}}));return{requests:a,endIndex:t+i.length}}function dd(r){let t="",e=n=>{for(let i of Array.isArray(n)?n:[]){if(t.length>=Rr)return;if(i.paragraph)for(let s of i.paragraph.elements||[])t+=s?.textRun?.content||"";else if(i.table)for(let s of i.table.tableRows||[])for(let o of s.tableCells||[])e(o.content);else i.tableOfContents&&e(i.tableOfContents.content)}};return e(r?.content),t.slice(0,Rr)}var ct=r=>`https://docs.google.com/document/d/${r}/edit`;function pd(r){let t=typeof r=="string"?r.trim():"";if(!t)throw new Error("imagePath is required");if(!_i(t)||!Hl(t).isFile())throw new Error(`imagePath not found (or not a file): ${t}`);if(!/\.(png|jpe?g)$/i.test(t))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let e=zl(t);if(e.length>rd)throw new Error(`image is ${(e.length/(1024*1024)).toFixed(1)}MB \u2014 max 5MB (Drive multipart upload cap)`);return{bytes:e,fileName:Wl(t),mimeType:/\.png$/i.test(t)?"image/png":"image/jpeg"}}function ud(r,t,e){let n=`zibby-gdocs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`;return{rawBody:Buffer.concat([Buffer.from(`--${n}\r
411
411
  Content-Type: application/json; charset=UTF-8\r
412
412
  \r
@@ -416,7 +416,7 @@ Content-Type: ${e}\r
416
416
  \r
417
417
  `,"utf8"),t,Buffer.from(`\r
418
418
  --${n}--\r
419
- `,"utf8")]),contentType:`multipart/related; boundary=${n}`}}var bi=r=>{let t=typeof r?.markdown=="string"?r.markdown:null,e=typeof r?.text=="string"?r.text:null;return t??e},ki={id:"google-docs",callsBackend:!0,serverName:"gdocs",allowedTools:["mcp__gdocs__*"],requiresIntegration:I.GOOGLE,description:"Google Docs \u2014 create, append to, insert images into, and read Google Docs (drive.file scoped)",promptFragment:`## Google Docs
419
+ `,"utf8")]),contentType:`multipart/related; boundary=${n}`}}var bi=r=>{let t=typeof r?.markdown=="string"?r.markdown:null,e=typeof r?.text=="string"?r.text:null;return t??e},wi={id:"google-docs",callsBackend:!0,serverName:"gdocs",allowedTools:["mcp__gdocs__*"],requiresIntegration:I.GOOGLE,description:"Google Docs \u2014 create, append to, insert images into, and read Google Docs (drive.file scoped)",promptFragment:`## Google Docs
420
420
  You can create and edit Google Docs for the user. IMPORTANT visibility caveat: the integration uses Google's per-file drive.file scope, so you can only see docs this app CREATED (or the user explicitly picked) \u2014 not the user's whole Drive.
421
421
  Docs access is PER-USER: each teammate connects their OWN Google account (Integrations \u2192 Google Docs). In shared-chat contexts the runtime routes these tools to the SENDER's own Google; a teammate who hasn't connected their own Google gets { ok:false } with connect instructions \u2014 for privacy the project owner's Google is NEVER used on someone else's behalf. Relay those instructions rather than retrying.
422
422
  - gdocs_create_doc: create a new Google Doc from a title + markdown (headings/bold/bullets/links supported) or plain text; returns { documentId, url }. Share the url with the user.
@@ -425,9 +425,9 @@ Docs access is PER-USER: each teammate connects their OWN Google account (Integr
425
425
  - gdocs_get: read a doc back as plain text (works for app-created/user-picked docs only; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker \u2014 drive.file has no access to un-picked files).
426
426
  - gdocs_list_created: list the Google Docs visible to this app (drive.file \u2192 only docs it created or the user picked).
427
427
  These tools return { ok:false, error } on failure \u2014 treat an unavailable Google connection as "cannot deliver to Docs" and report it rather than blocking the task.`,resolve(){let r=ed();if(!r)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_INJECTED_GOOGLE_TOKEN","ZIBBY_INJECTED_GOOGLE_EMAIL","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/googleDocs.js","googleDocsSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"gdocs_create_doc":{let e=typeof t?.title=="string"&&t.title.trim()?t.title.trim():null;if(!e)return JSON.stringify({ok:!1,error:"title is required"});let i=(await se(`${Te}/documents`,{method:"POST",body:{title:e}}))?.documentId;if(!i)return JSON.stringify({ok:!1,error:"Google Docs create returned no documentId"});let s=bi(t);if(s&&s.trim()){let{requests:o}=gi(s,1);o.length&&await se(`${Te}/documents/${i}:batchUpdate`,{method:"POST",body:{requests:o}})}return JSON.stringify({ok:!0,documentId:i,title:e,url:ct(i)})}case"gdocs_append":{let e=Tr(t?.documentId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=bi(t);if(!n||!n.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=(await se(`${Te}/documents/${e}`))?.body,o=Array.isArray(s?.content)?s.content:[],a=o.length&&o[o.length-1].endIndex||2,c=Math.max(1,a-1),l=[],d=c;c>1&&(l.push({insertText:{location:{index:c},text:`
428
- `}}),d=c+1);let p=gi(n,d);return l.push(...p.requests),await se(`${Te}/documents/${e}:batchUpdate`,{method:"POST",body:{requests:l}}),JSON.stringify({ok:!0,documentId:e,url:ct(e)})}case"gdocs_insert_image":{let e=Tr(t?.documentId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});if(!t?.imagePath||typeof t.imagePath!="string"||!t.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let{bytes:n,fileName:i,mimeType:s}=pd(t.imagePath),{rawBody:o,contentType:a}=ud({name:i,mimeType:s},n,s),l=(await se(`${td}/files?uploadType=multipart&fields=id`,{method:"POST",rawBody:o,contentType:a}))?.id;if(!l)return JSON.stringify({ok:!1,error:"Drive upload returned no file id"});await se(`${yi}/files/${l}/permissions`,{method:"POST",body:{role:"reader",type:"anyone"}});let d=await se(`${Te}/documents/${e}`),p=Array.isArray(d?.body?.content)?d.body.content:[],u=p.length&&p[p.length-1].endIndex||2,f={location:{index:Math.max(1,u-1)},uri:`https://drive.google.com/uc?export=download&id=${l}`},h=Number(t?.width),_=Number(t?.height);return(Number.isFinite(h)&&h>0||Number.isFinite(_)&&_>0)&&(f.objectSize={...Number.isFinite(h)&&h>0?{width:{magnitude:h,unit:"PT"}}:{},...Number.isFinite(_)&&_>0?{height:{magnitude:_,unit:"PT"}}:{}}),await se(`${Te}/documents/${e}:batchUpdate`,{method:"POST",body:{requests:[{insertInlineImage:f}]}}),JSON.stringify({ok:!0,documentId:e,fileId:l,url:ct(e)})}case"gdocs_get":{let e=Tr(t?.documentId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=await se(`${Te}/documents/${e}`),i=dd(n?.body);return JSON.stringify({ok:!0,documentId:e,title:n?.title||"",url:ct(e),text:i,...i.length>=Rr?{truncated:!0}:{}})}case"gdocs_list_created":{let e=new URLSearchParams({q:"'me' in owners and mimeType='application/vnd.google-apps.document' and trashed=false",fields:"files(id,name,modifiedTime,webViewLink)",pageSize:String(ad),orderBy:"modifiedTime desc"}),n=await se(`${yi}/files?${e.toString()}`),i=(Array.isArray(n?.files)?n.files:[]).map(s=>({documentId:s.id,title:s.name,modifiedTime:s.modifiedTime,url:s.webViewLink||ct(s.id)}));return JSON.stringify({ok:!0,count:i.length,files:i})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"gdocs_create_doc",description:"Create a new Google Doc with a title and optional content (markdown: #/##/### headings, - bullets, 1. numbered lists, **bold**, [links](url), `code`; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."}},required:["title"]}},{name:"gdocs_append",description:"Append markdown/text content to the END of an existing Google Doc. Only works on docs this app created or the user explicitly picked (drive.file scope). Accepts a documentId or a full docs.google.com URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"gdocs_insert_image",description:"Append a LOCAL image file (png/jpg, max 5MB) to the END of an existing Google Doc. The image is uploaded to the user's Drive, made link-readable (role reader / type anyone \u2014 required: the Docs API only renders publicly fetchable image URIs, <2KB URI length, image <50MB and <25 megapixels), then inserted inline. Optional width/height in points (PT). Returns { ok, documentId, fileId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 5MB)."},width:{type:"number",description:"Optional display width in points (PT)."},height:{type:"number",description:"Optional display height in points (PT)."}},required:["documentId","imagePath"]}},{name:"gdocs_get",description:"Read a Google Doc back as plain text (truncated to ~20k chars). The drive.file scope grants access ONLY to docs this app created or the user explicitly picked; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker (drive.file cannot see un-picked files). Returns { ok, documentId, title, url, text }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."}},required:["documentId"]}},{name:"gdocs_list_created",description:"List the Google Docs visible to this integration, newest first (max 25). NOTE: under the drive.file scope this lists ONLY docs the app created or the user explicitly picked \u2014 it is NOT a full Drive search. Returns { ok, count, files:[{ documentId, title, modifiedTime, url }] }.",input_schema:{type:"object",properties:{}}}]};import{existsSync as Ni,statSync as md,readFileSync as fd}from"fs";import{fileURLToPath as hd}from"url";import{basename as yd,dirname as gd,resolve as bd}from"path";import{resolveIntegrationToken as wi}from"@zibby/core/backend-client.js";function _d(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=gd(hd(import.meta.url)),t=bd(r,"..","bin","mcp-skill.mjs");return Ni(t)?t:null}var Si=2e4,vi=50,kd=50,wd=20,Sd=10*1024*1024,vd=6e3*1e3,lt=null,Id="https://open.larksuite.com",Oi=Object.freeze([Object.freeze({appId:"LARK_DOCS_APP_ID",appSecret:"LARK_DOCS_APP_SECRET",host:"LARK_DOCS_HOST"}),Object.freeze({appId:"LARK_APP_ID",appSecret:"LARK_APP_SECRET",host:"LARK_HOST"})]),Nd=Object.freeze(Oi.flatMap(r=>[r.appId,r.appSecret,r.host]));function jr(r){let t=String(r||"").trim().replace(/\/+$/,"");return t?/^https?:\/\//i.test(t)?t:`https://${t}`:Id}function Od(r){let t=String(process.env[r.appId]||"").trim(),e=String(process.env[r.appSecret]||"").trim();return!t||!e?null:{appId:t,appSecret:e,host:jr(process.env[r.host])}}async function Td(){for(let r of Oi){let t=Od(r);if(t)return t}try{let r=await wi(I.LARK_DOCS);return{appId:r?.appId,appSecret:r?.appSecret,host:jr(r?.host)}}catch(r){if(!/unknown provider/i.test(String(r?.message||"")))throw r;let t=await wi(I.LARK);return{appId:t?.appId,appSecret:t?.appSecret,host:jr(t?.host)}}}async function Ti(){let{appId:r,appSecret:t,host:e}=await Td();if(lt&&lt.appId===r&&lt.expiresAt>Date.now())return{token:lt.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 lt={token:i.tenant_access_token,expiresAt:Date.now()+vd,appId:r},{token:i.tenant_access_token,host:e}}async function Y(r,t,e){let{token:n,host:i}=await Ti(),s={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&e!==void 0&&(s.body=JSON.stringify(e));let a=await(await fetch(`${i}${t}`,s)).json();if(a.code!==0)throw new Error(`Lark Docx API ${t} error: ${a.msg||a.code}`);return{data:a.data||{},host:i}}function dt(r,t){return String(r||"").includes("feishu")?`https://feishu.cn/docx/${t}`:`https://www.larksuite.com/docx/${t}`}function Rd(r,t){return String(r||"").includes("feishu")?`https://feishu.cn/wiki/${t}`:`https://www.larksuite.com/wiki/${t}`}function Re(r){if(!r||typeof r!="string")return null;let t=r.trim();if(!t)return null;let e=t.match(/\/(docx|wiki)\/([A-Za-z0-9]+)/);return e?{type:e[1],token:e[2]}:/^[A-Za-z0-9]{10,}$/.test(t)?{type:"docx",token:t}:null}async function Ke(r){let t=typeof r=="string"?Re(r):r;if(!t)throw new Error("A valid Lark doc id or URL is required");if(t.type==="docx")return t.token;let{data:e}=await Y("GET",`/open-apis/wiki/v2/spaces/get_node?token=${encodeURIComponent(t.token)}`),n=e?.node||{};if(n.obj_type!=="docx"||!n.obj_token)throw new Error(`Wiki node is not a docx document (obj_type=${n.obj_type||"unknown"})`);return n.obj_token}function Ar(r){let t=String(r??"").replace(/\r\n/g,`
428
+ `}}),d=c+1);let p=gi(n,d);return l.push(...p.requests),await se(`${Te}/documents/${e}:batchUpdate`,{method:"POST",body:{requests:l}}),JSON.stringify({ok:!0,documentId:e,url:ct(e)})}case"gdocs_insert_image":{let e=Tr(t?.documentId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});if(!t?.imagePath||typeof t.imagePath!="string"||!t.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let{bytes:n,fileName:i,mimeType:s}=pd(t.imagePath),{rawBody:o,contentType:a}=ud({name:i,mimeType:s},n,s),l=(await se(`${td}/files?uploadType=multipart&fields=id`,{method:"POST",rawBody:o,contentType:a}))?.id;if(!l)return JSON.stringify({ok:!1,error:"Drive upload returned no file id"});await se(`${yi}/files/${l}/permissions`,{method:"POST",body:{role:"reader",type:"anyone"}});let d=await se(`${Te}/documents/${e}`),p=Array.isArray(d?.body?.content)?d.body.content:[],u=p.length&&p[p.length-1].endIndex||2,f={location:{index:Math.max(1,u-1)},uri:`https://drive.google.com/uc?export=download&id=${l}`},h=Number(t?.width),_=Number(t?.height);return(Number.isFinite(h)&&h>0||Number.isFinite(_)&&_>0)&&(f.objectSize={...Number.isFinite(h)&&h>0?{width:{magnitude:h,unit:"PT"}}:{},...Number.isFinite(_)&&_>0?{height:{magnitude:_,unit:"PT"}}:{}}),await se(`${Te}/documents/${e}:batchUpdate`,{method:"POST",body:{requests:[{insertInlineImage:f}]}}),JSON.stringify({ok:!0,documentId:e,fileId:l,url:ct(e)})}case"gdocs_get":{let e=Tr(t?.documentId||t?.url||t?.id);if(!e)return JSON.stringify({ok:!1,error:"A valid Google Docs documentId or URL is required"});let n=await se(`${Te}/documents/${e}`),i=dd(n?.body);return JSON.stringify({ok:!0,documentId:e,title:n?.title||"",url:ct(e),text:i,...i.length>=Rr?{truncated:!0}:{}})}case"gdocs_list_created":{let e=new URLSearchParams({q:"'me' in owners and mimeType='application/vnd.google-apps.document' and trashed=false",fields:"files(id,name,modifiedTime,webViewLink)",pageSize:String(ad),orderBy:"modifiedTime desc"}),n=await se(`${yi}/files?${e.toString()}`),i=(Array.isArray(n?.files)?n.files:[]).map(s=>({documentId:s.id,title:s.name,modifiedTime:s.modifiedTime,url:s.webViewLink||ct(s.id)}));return JSON.stringify({ok:!0,count:i.length,files:i})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"gdocs_create_doc",description:"Create a new Google Doc with a title and optional content (markdown: #/##/### headings, - bullets, 1. numbered lists, **bold**, [links](url), `code`; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."}},required:["title"]}},{name:"gdocs_append",description:"Append markdown/text content to the END of an existing Google Doc. Only works on docs this app created or the user explicitly picked (drive.file scope). Accepts a documentId or a full docs.google.com URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"gdocs_insert_image",description:"Append a LOCAL image file (png/jpg, max 5MB) to the END of an existing Google Doc. The image is uploaded to the user's Drive, made link-readable (role reader / type anyone \u2014 required: the Docs API only renders publicly fetchable image URIs, <2KB URI length, image <50MB and <25 megapixels), then inserted inline. Optional width/height in points (PT). Returns { ok, documentId, fileId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 5MB)."},width:{type:"number",description:"Optional display width in points (PT)."},height:{type:"number",description:"Optional display height in points (PT)."}},required:["documentId","imagePath"]}},{name:"gdocs_get",description:"Read a Google Doc back as plain text (truncated to ~20k chars). The drive.file scope grants access ONLY to docs this app created or the user explicitly picked; to read an arbitrary pre-existing doc the user must PICK it once first via the Google Picker (drive.file cannot see un-picked files). Returns { ok, documentId, title, url, text }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Google Docs documentId OR a full https://docs.google.com/document/d/... URL."}},required:["documentId"]}},{name:"gdocs_list_created",description:"List the Google Docs visible to this integration, newest first (max 25). NOTE: under the drive.file scope this lists ONLY docs the app created or the user explicitly picked \u2014 it is NOT a full Drive search. Returns { ok, count, files:[{ documentId, title, modifiedTime, url }] }.",input_schema:{type:"object",properties:{}}}]};import{existsSync as Ni,statSync as md,readFileSync as fd}from"fs";import{fileURLToPath as hd}from"url";import{basename as yd,dirname as gd,resolve as bd}from"path";import{resolveIntegrationToken as ki}from"@zibby/core/backend-client.js";function _d(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=gd(hd(import.meta.url)),t=bd(r,"..","bin","mcp-skill.mjs");return Ni(t)?t:null}var Si=2e4,vi=50,wd=50,kd=20,Sd=10*1024*1024,vd=6e3*1e3,lt=null,Id="https://open.larksuite.com",Oi=Object.freeze([Object.freeze({appId:"LARK_DOCS_APP_ID",appSecret:"LARK_DOCS_APP_SECRET",host:"LARK_DOCS_HOST"}),Object.freeze({appId:"LARK_APP_ID",appSecret:"LARK_APP_SECRET",host:"LARK_HOST"})]),Nd=Object.freeze(Oi.flatMap(r=>[r.appId,r.appSecret,r.host]));function jr(r){let t=String(r||"").trim().replace(/\/+$/,"");return t?/^https?:\/\//i.test(t)?t:`https://${t}`:Id}function Od(r){let t=String(process.env[r.appId]||"").trim(),e=String(process.env[r.appSecret]||"").trim();return!t||!e?null:{appId:t,appSecret:e,host:jr(process.env[r.host])}}async function Td(){for(let r of Oi){let t=Od(r);if(t)return t}try{let r=await ki(I.LARK_DOCS);return{appId:r?.appId,appSecret:r?.appSecret,host:jr(r?.host)}}catch(r){if(!/unknown provider/i.test(String(r?.message||"")))throw r;let t=await ki(I.LARK);return{appId:t?.appId,appSecret:t?.appSecret,host:jr(t?.host)}}}async function Ti(){let{appId:r,appSecret:t,host:e}=await Td();if(lt&&lt.appId===r&&lt.expiresAt>Date.now())return{token:lt.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 lt={token:i.tenant_access_token,expiresAt:Date.now()+vd,appId:r},{token:i.tenant_access_token,host:e}}async function Y(r,t,e){let{token:n,host:i}=await Ti(),s={method:r,headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json; charset=utf-8"}};r!=="GET"&&e!==void 0&&(s.body=JSON.stringify(e));let a=await(await fetch(`${i}${t}`,s)).json();if(a.code!==0)throw new Error(`Lark Docx API ${t} error: ${a.msg||a.code}`);return{data:a.data||{},host:i}}function dt(r,t){return String(r||"").includes("feishu")?`https://feishu.cn/docx/${t}`:`https://www.larksuite.com/docx/${t}`}function Rd(r,t){return String(r||"").includes("feishu")?`https://feishu.cn/wiki/${t}`:`https://www.larksuite.com/wiki/${t}`}function Re(r){if(!r||typeof r!="string")return null;let t=r.trim();if(!t)return null;let e=t.match(/\/(docx|wiki)\/([A-Za-z0-9]+)/);return e?{type:e[1],token:e[2]}:/^[A-Za-z0-9]{10,}$/.test(t)?{type:"docx",token:t}:null}async function Ke(r){let t=typeof r=="string"?Re(r):r;if(!t)throw new Error("A valid Lark doc id or URL is required");if(t.type==="docx")return t.token;let{data:e}=await Y("GET",`/open-apis/wiki/v2/spaces/get_node?token=${encodeURIComponent(t.token)}`),n=e?.node||{};if(n.obj_type!=="docx"||!n.obj_token)throw new Error(`Wiki node is not a docx document (obj_type=${n.obj_type||"unknown"})`);return n.obj_token}function Ar(r){let t=String(r??"").replace(/\r\n/g,`
429
429
  `),e=[];for(let n of t.split(`
430
- `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,l,d;if(s){let p=s[1].length;c=`heading${p}`,l=2+p,d=s[2]}else o?(c="bullet",l=12,d=o[1]):a?(c="ordered",l=13,d=a[1]):(c="text",l=2,d=i);e.push({block_type:l,[c]:{elements:[{text_run:{content:d}}],style:{}}})}return e}function pt(r){let t=typeof r?.markdown=="string"?r.markdown:null,e=typeof r?.text=="string"?r.text:null;return t??e}async function Er(r,t){let e;for(let n=0;n<t.length;n+=vi){let i=t.slice(n,n+vi);e=(await Y("POST",`/open-apis/docx/v1/documents/${r}/blocks/${r}/children?document_revision_id=-1`,{children:i})).host}return e}function Ad(r){let t=typeof r=="string"?r.trim():"";if(!t)throw new Error("imagePath is required");if(!Ni(t)||!md(t).isFile())throw new Error(`imagePath not found (or not a file): ${t}`);if(!/\.(png|jpe?g)$/i.test(t))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let e=fd(t);if(e.length>Sd)throw new Error(`image is ${(e.length/(1024*1024)).toFixed(1)}MB \u2014 max 10MB`);return e}async function Ed({fileName:r,parentNode:t,bytes:e}){let{token:n,host:i}=await Ti(),s=new FormData;s.set("file_name",r),s.set("parent_type","docx_image"),s.set("parent_node",t),s.set("size",String(e.length)),s.set("file",new Blob([e]),r);let a=await(await fetch(`${i}/open-apis/drive/v1/medias/upload_all`,{method:"POST",headers:{Authorization:`Bearer ${n}`},body:s})).json();if(a.code!==0)throw new Error(`Lark media upload_all error: ${a.msg||a.code}`);let c=a.data?.file_token;if(!c)throw new Error("Lark media upload_all returned no file_token");return c}var xd="docx",jd=50;function Ii(r){return[{type:"text_run",text_run:{text:String(r??"")}}]}function Ld(r){return Array.isArray(r)?r.map(t=>t?.text_run?.text??t?.docs_link?.url??(t?.person?`@${t.person.user_id||""}`:"")).join(""):""}function $d(r){let t=Array.isArray(r?.reply_list?.replies)?r.reply_list.replies:[];return{commentId:r?.comment_id||"",resolved:!!r?.is_solved,replies:t.map(e=>({replyId:e?.reply_id||"",author:e?.user_id||"",text:Ld(e?.content?.elements),createTime:e?.create_time||""}))}}function xr(r){return typeof r?.fileType=="string"&&r.fileType.trim()?r.fileType.trim():xd}var Ri={id:"lark-docs",callsBackend:!0,serverName:"larkdocs",allowedTools:["mcp__larkdocs__*"],requiresIntegration:[I.LARK_DOCS,I.LARK],description:"Lark / Feishu Docs \u2014 read, create, append, and insert images into Lark documents (docx).",envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV",...Nd],promptFragment:'## Lark Docs\nYou can read, create, and append Lark/Feishu documents (docx), and read/post/reply to their comments. This runs on the connected Lark Docs app (the chat app is used when no separate docs app is connected). Each `larkdoc_*` / `larkwiki_*` tool documents its own params and return shape in its tool description \u2014 they are not restated here.\nThese tools return { ok:false, error } on failure \u2014 treat an unavailable Lark connection as "cannot read/deliver to Lark Docs" and continue rather than blocking the task.',resolve(){let r=_d();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/larkDocs.js","larkDocsSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"larkdoc_get":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ke(n),s="";try{s=(await Y("GET",`/open-apis/docx/v1/documents/${i}`)).data?.document?.title||""}catch{}let{data:o,host:a}=await Y("GET",`/open-apis/docx/v1/documents/${i}/raw_content?lang=0`),c=String(o?.content||""),l=!1;return c.length>Si&&(c=c.slice(0,Si),l=!0),JSON.stringify({ok:!0,documentId:i,title:s,url:dt(a,i),text:c,...l?{truncated:!0}:{}})}case"larkdoc_create":{let e=typeof t?.title=="string"&&t.title.trim()?t.title.trim():null;if(!e)return JSON.stringify({ok:!1,error:"title is required"});let n=typeof t?.wikiSpaceId=="string"&&t.wikiSpaceId.trim()?t.wikiSpaceId.trim():null;if(n){let c=typeof t?.parentNodeToken=="string"&&t.parentNodeToken.trim()?t.parentNodeToken.trim():null,{data:l,host:d}=await Y("POST",`/open-apis/wiki/v2/spaces/${encodeURIComponent(n)}/nodes`,{obj_type:"docx",node_type:"origin",title:e,...c?{parent_node_token:c}:{}}),p=l?.node||{},u=p.obj_token;if(!u)return JSON.stringify({ok:!1,error:"Lark wiki node create returned no obj_token"});let m=pt(t);if(m&&m.trim()){let f=Ar(m);f.length&&await Er(u,f)}return JSON.stringify({ok:!0,documentId:u,title:e,wikiSpaceId:n,wikiNodeToken:p.node_token||"",url:p.node_token?Rd(d,p.node_token):dt(d,u)})}let{data:i,host:s}=await Y("POST","/open-apis/docx/v1/documents",{title:e,...t?.folderToken?{folder_token:String(t.folderToken)}:{}}),o=i?.document?.document_id;if(!o)return JSON.stringify({ok:!1,error:"Lark Docs create returned no document_id"});let a=pt(t);if(a&&a.trim()){let c=Ar(a);c.length&&await Er(o,c)}return JSON.stringify({ok:!0,documentId:o,title:e,url:dt(s,o)})}case"larkdoc_append":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=pt(t);if(!i||!i.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=await Ke(n),o=Ar(i);if(!o.length)return JSON.stringify({ok:!1,error:"no non-empty content to append"});let a=await Er(s,o);return JSON.stringify({ok:!0,documentId:s,url:dt(a,s)})}case"larkdoc_insert_image":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});if(!t?.imagePath||typeof t.imagePath!="string"||!t.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let i=await Ke(n),s=t.imagePath.trim(),o=Ad(s),a=yd(s),l=(await Y("POST",`/open-apis/docx/v1/documents/${i}/blocks/${i}/children?document_revision_id=-1`,{children:[{block_type:27,image:{}}]})).data?.children?.[0]?.block_id;if(!l)return JSON.stringify({ok:!1,error:"Lark image block create returned no block_id"});let d=await Ed({fileName:a,parentNode:l,bytes:o}),p={token:d},u=Number(t?.width),m=Number(t?.height);Number.isFinite(u)&&u>0&&(p.width=Math.round(u)),Number.isFinite(m)&&m>0&&(p.height=Math.round(m));let{host:f}=await Y("PATCH",`/open-apis/docx/v1/documents/${i}/blocks/${l}?document_revision_id=-1`,{replace_image:p});return JSON.stringify({ok:!0,documentId:i,blockId:l,fileToken:d,url:dt(f,i)})}case"larkwiki_list_spaces":{let e=[],n=null;for(let i=0;i<wd;i++){let s=new URLSearchParams({page_size:String(kd)});n&&s.set("page_token",n);let{data:o}=await Y("GET",`/open-apis/wiki/v2/spaces?${s.toString()}`),a=Array.isArray(o?.items)?o.items:[];for(let c of a)e.push({spaceId:String(c?.space_id||""),name:String(c?.name||"")});if(!o?.has_more||!o?.page_token)break;n=o.page_token}return JSON.stringify({ok:!0,count:e.length,spaces:e})}case"larkdoc_list_comments":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ke(n),s=xr(t),o=new URLSearchParams({file_type:s,page_size:String(jd)}),{data:a}=await Y("GET",`/open-apis/drive/v1/files/${i}/comments?${o.toString()}`),l=(Array.isArray(a?.items)?a.items:[]).map($d);return JSON.stringify({ok:!0,documentId:i,count:l.length,comments:l})}case"larkdoc_add_comment":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=pt({text:t?.text??t?.body});if(!i||!i.trim())return JSON.stringify({ok:!1,error:"text is required"});let s=await Ke(n),o=xr(t),{data:a}=await Y("POST",`/open-apis/drive/v1/files/${s}/comments?file_type=${encodeURIComponent(o)}`,{reply_list:{replies:[{content:{elements:Ii(i)}}]}});return JSON.stringify({ok:!0,documentId:s,commentId:a?.comment_id||""})}case"larkdoc_reply_comment":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=t?.commentId||t?.comment_id;if(!i)return JSON.stringify({ok:!1,error:"commentId is required"});let s=pt({text:t?.text??t?.body});if(!s||!s.trim())return JSON.stringify({ok:!1,error:"text is required"});let o=await Ke(n),a=xr(t),{data:c}=await Y("POST",`/open-apis/drive/v1/files/${o}/comments/${encodeURIComponent(i)}/replies?file_type=${encodeURIComponent(a)}`,{content:{elements:Ii(s)}});return JSON.stringify({ok:!0,documentId:o,commentId:String(i),replyId:c?.reply_id||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"larkdoc_get",description:"Read a Lark/Feishu document (docx) as plain text, for use as reference context. Accepts a raw doc id OR a full Lark doc URL (a /docx/ or /wiki/ link \u2014 wiki links are resolved to their backing docx). Returns { ok, documentId, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL (/docx/\u2026 or /wiki/\u2026)."}},required:["documentId"]}},{name:"larkdoc_create",description:"Create a new Lark/Feishu document (docx) with a title and optional content (markdown: #/##/### headings, - bullets, 1. ordered; or plain text). Pass wikiSpaceId (from larkwiki_list_spaces) to create the doc INSIDE a wiki space instead of as a standalone doc \u2014 optionally nested under parentNodeToken. Returns { ok, documentId, url } (plus wikiNodeToken when created in a wiki) \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."},folderToken:{type:"string",description:"Optional Lark drive folder token to create the doc in. Absent = the app root. Ignored when wikiSpaceId is set."},wikiSpaceId:{type:"string",description:"Optional wiki space id (from larkwiki_list_spaces) \u2014 create the doc as a node inside this wiki space."},parentNodeToken:{type:"string",description:"Optional wiki node token to nest the new doc under (only with wikiSpaceId). Absent = the space root."}},required:["title"]}},{name:"larkwiki_list_spaces",description:"List the Lark/Feishu wiki spaces visible to the connected app. Returns { ok, count, spaces:[{ spaceId, name }] }. Use to discover the wikiSpaceId for larkdoc_create.",input_schema:{type:"object",properties:{}}},{name:"larkdoc_append",description:"Append markdown/text content to the END of an existing Lark/Feishu document (docx). Accepts a documentId or a full Lark doc URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"larkdoc_insert_image",description:"Append a LOCAL image file (png/jpg, max 10MB) to the END of an existing Lark/Feishu document (docx). Accepts a documentId or full doc URL plus a local file path. Optional width/height in pixels. Returns { ok, documentId, blockId, fileToken, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 10MB)."},width:{type:"number",description:"Optional display width in pixels."},height:{type:"number",description:"Optional display height in pixels."}},required:["documentId","imagePath"]}},{name:"larkdoc_list_comments",description:"List the comment threads on a Lark/Feishu document. Accepts a documentId or full doc URL. Returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'. Only change for non-docx files (doc/sheet/bitable/file/slides)."}},required:["documentId"]}},{name:"larkdoc_add_comment",description:"Post a NEW top-level comment on a Lark/Feishu document. Accepts a documentId or full doc URL plus text. Returns { ok, documentId, commentId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},text:{type:"string",description:"The comment body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","text"]}},{name:"larkdoc_reply_comment",description:"Reply INSIDE an existing comment thread on a Lark/Feishu document. Pass { documentId, commentId, text }. Use to answer a user who @mentioned Zibby in a doc comment (reply in the same commentId). Returns { ok, documentId, commentId, replyId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},commentId:{type:"string",description:"The comment_id of the thread to reply into (from larkdoc_list_comments or the webhook event)."},text:{type:"string",description:"The reply body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","commentId","text"]}}]};var Ai={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:[...P.envKeys||[],...F.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return P.serverName;if(process.env.LARK_RECEIVE_ID)return F.serverName;if(process.env.SLACK_BOT_TOKEN)return P.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?P.allowedTools||[]:process.env.LARK_RECEIVE_ID?F.allowedTools||[]:process.env.SLACK_BOT_TOKEN?P.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
430
+ `)){let i=n.replace(/\s+$/,"");if(!i.trim())continue;let s=/^(#{1,3})\s+(.*)$/.exec(i),o=/^\s*[-*]\s+(.*)$/.exec(i),a=/^\s*\d+[.)]\s+(.*)$/.exec(i),c,l,d;if(s){let p=s[1].length;c=`heading${p}`,l=2+p,d=s[2]}else o?(c="bullet",l=12,d=o[1]):a?(c="ordered",l=13,d=a[1]):(c="text",l=2,d=i);e.push({block_type:l,[c]:{elements:[{text_run:{content:d}}],style:{}}})}return e}function pt(r){let t=typeof r?.markdown=="string"?r.markdown:null,e=typeof r?.text=="string"?r.text:null;return t??e}async function Er(r,t){let e;for(let n=0;n<t.length;n+=vi){let i=t.slice(n,n+vi);e=(await Y("POST",`/open-apis/docx/v1/documents/${r}/blocks/${r}/children?document_revision_id=-1`,{children:i})).host}return e}function Ad(r){let t=typeof r=="string"?r.trim():"";if(!t)throw new Error("imagePath is required");if(!Ni(t)||!md(t).isFile())throw new Error(`imagePath not found (or not a file): ${t}`);if(!/\.(png|jpe?g)$/i.test(t))throw new Error("imagePath must be a .png or .jpg/.jpeg file");let e=fd(t);if(e.length>Sd)throw new Error(`image is ${(e.length/(1024*1024)).toFixed(1)}MB \u2014 max 10MB`);return e}async function Ed({fileName:r,parentNode:t,bytes:e}){let{token:n,host:i}=await Ti(),s=new FormData;s.set("file_name",r),s.set("parent_type","docx_image"),s.set("parent_node",t),s.set("size",String(e.length)),s.set("file",new Blob([e]),r);let a=await(await fetch(`${i}/open-apis/drive/v1/medias/upload_all`,{method:"POST",headers:{Authorization:`Bearer ${n}`},body:s})).json();if(a.code!==0)throw new Error(`Lark media upload_all error: ${a.msg||a.code}`);let c=a.data?.file_token;if(!c)throw new Error("Lark media upload_all returned no file_token");return c}var xd="docx",jd=50;function Ii(r){return[{type:"text_run",text_run:{text:String(r??"")}}]}function Ld(r){return Array.isArray(r)?r.map(t=>t?.text_run?.text??t?.docs_link?.url??(t?.person?`@${t.person.user_id||""}`:"")).join(""):""}function $d(r){let t=Array.isArray(r?.reply_list?.replies)?r.reply_list.replies:[];return{commentId:r?.comment_id||"",resolved:!!r?.is_solved,replies:t.map(e=>({replyId:e?.reply_id||"",author:e?.user_id||"",text:Ld(e?.content?.elements),createTime:e?.create_time||""}))}}function xr(r){return typeof r?.fileType=="string"&&r.fileType.trim()?r.fileType.trim():xd}var Ri={id:"lark-docs",callsBackend:!0,serverName:"larkdocs",allowedTools:["mcp__larkdocs__*"],requiresIntegration:[I.LARK_DOCS,I.LARK],description:"Lark / Feishu Docs \u2014 read, create, append, and insert images into Lark documents (docx).",envKeys:["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV",...Nd],promptFragment:'## Lark Docs\nYou can read, create, and append Lark/Feishu documents (docx), and read/post/reply to their comments. This runs on the connected Lark Docs app (the chat app is used when no separate docs app is connected). Each `larkdoc_*` / `larkwiki_*` tool documents its own params and return shape in its tool description \u2014 they are not restated here.\nThese tools return { ok:false, error } on failure \u2014 treat an unavailable Lark connection as "cannot read/deliver to Lark Docs" and continue rather than blocking the task.',resolve(){let r=_d();if(!r)return null;let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/larkDocs.js","larkDocsSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"larkdoc_get":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ke(n),s="";try{s=(await Y("GET",`/open-apis/docx/v1/documents/${i}`)).data?.document?.title||""}catch{}let{data:o,host:a}=await Y("GET",`/open-apis/docx/v1/documents/${i}/raw_content?lang=0`),c=String(o?.content||""),l=!1;return c.length>Si&&(c=c.slice(0,Si),l=!0),JSON.stringify({ok:!0,documentId:i,title:s,url:dt(a,i),text:c,...l?{truncated:!0}:{}})}case"larkdoc_create":{let e=typeof t?.title=="string"&&t.title.trim()?t.title.trim():null;if(!e)return JSON.stringify({ok:!1,error:"title is required"});let n=typeof t?.wikiSpaceId=="string"&&t.wikiSpaceId.trim()?t.wikiSpaceId.trim():null;if(n){let c=typeof t?.parentNodeToken=="string"&&t.parentNodeToken.trim()?t.parentNodeToken.trim():null,{data:l,host:d}=await Y("POST",`/open-apis/wiki/v2/spaces/${encodeURIComponent(n)}/nodes`,{obj_type:"docx",node_type:"origin",title:e,...c?{parent_node_token:c}:{}}),p=l?.node||{},u=p.obj_token;if(!u)return JSON.stringify({ok:!1,error:"Lark wiki node create returned no obj_token"});let m=pt(t);if(m&&m.trim()){let f=Ar(m);f.length&&await Er(u,f)}return JSON.stringify({ok:!0,documentId:u,title:e,wikiSpaceId:n,wikiNodeToken:p.node_token||"",url:p.node_token?Rd(d,p.node_token):dt(d,u)})}let{data:i,host:s}=await Y("POST","/open-apis/docx/v1/documents",{title:e,...t?.folderToken?{folder_token:String(t.folderToken)}:{}}),o=i?.document?.document_id;if(!o)return JSON.stringify({ok:!1,error:"Lark Docs create returned no document_id"});let a=pt(t);if(a&&a.trim()){let c=Ar(a);c.length&&await Er(o,c)}return JSON.stringify({ok:!0,documentId:o,title:e,url:dt(s,o)})}case"larkdoc_append":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=pt(t);if(!i||!i.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let s=await Ke(n),o=Ar(i);if(!o.length)return JSON.stringify({ok:!1,error:"no non-empty content to append"});let a=await Er(s,o);return JSON.stringify({ok:!0,documentId:s,url:dt(a,s)})}case"larkdoc_insert_image":{let e=t?.documentId||t?.url||t?.id,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});if(!t?.imagePath||typeof t.imagePath!="string"||!t.imagePath.trim())return JSON.stringify({ok:!1,error:"imagePath is required"});let i=await Ke(n),s=t.imagePath.trim(),o=Ad(s),a=yd(s),l=(await Y("POST",`/open-apis/docx/v1/documents/${i}/blocks/${i}/children?document_revision_id=-1`,{children:[{block_type:27,image:{}}]})).data?.children?.[0]?.block_id;if(!l)return JSON.stringify({ok:!1,error:"Lark image block create returned no block_id"});let d=await Ed({fileName:a,parentNode:l,bytes:o}),p={token:d},u=Number(t?.width),m=Number(t?.height);Number.isFinite(u)&&u>0&&(p.width=Math.round(u)),Number.isFinite(m)&&m>0&&(p.height=Math.round(m));let{host:f}=await Y("PATCH",`/open-apis/docx/v1/documents/${i}/blocks/${l}?document_revision_id=-1`,{replace_image:p});return JSON.stringify({ok:!0,documentId:i,blockId:l,fileToken:d,url:dt(f,i)})}case"larkwiki_list_spaces":{let e=[],n=null;for(let i=0;i<kd;i++){let s=new URLSearchParams({page_size:String(wd)});n&&s.set("page_token",n);let{data:o}=await Y("GET",`/open-apis/wiki/v2/spaces?${s.toString()}`),a=Array.isArray(o?.items)?o.items:[];for(let c of a)e.push({spaceId:String(c?.space_id||""),name:String(c?.name||"")});if(!o?.has_more||!o?.page_token)break;n=o.page_token}return JSON.stringify({ok:!0,count:e.length,spaces:e})}case"larkdoc_list_comments":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=await Ke(n),s=xr(t),o=new URLSearchParams({file_type:s,page_size:String(jd)}),{data:a}=await Y("GET",`/open-apis/drive/v1/files/${i}/comments?${o.toString()}`),l=(Array.isArray(a?.items)?a.items:[]).map($d);return JSON.stringify({ok:!0,documentId:i,count:l.length,comments:l})}case"larkdoc_add_comment":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=pt({text:t?.text??t?.body});if(!i||!i.trim())return JSON.stringify({ok:!1,error:"text is required"});let s=await Ke(n),o=xr(t),{data:a}=await Y("POST",`/open-apis/drive/v1/files/${s}/comments?file_type=${encodeURIComponent(o)}`,{reply_list:{replies:[{content:{elements:Ii(i)}}]}});return JSON.stringify({ok:!0,documentId:s,commentId:a?.comment_id||""})}case"larkdoc_reply_comment":{let e=t?.documentId||t?.url||t?.id||t?.fileToken,n=Re(e);if(!n)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let i=t?.commentId||t?.comment_id;if(!i)return JSON.stringify({ok:!1,error:"commentId is required"});let s=pt({text:t?.text??t?.body});if(!s||!s.trim())return JSON.stringify({ok:!1,error:"text is required"});let o=await Ke(n),a=xr(t),{data:c}=await Y("POST",`/open-apis/drive/v1/files/${o}/comments/${encodeURIComponent(i)}/replies?file_type=${encodeURIComponent(a)}`,{content:{elements:Ii(s)}});return JSON.stringify({ok:!0,documentId:o,commentId:String(i),replyId:c?.reply_id||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({ok:!1,error:e.message})}},tools:[{name:"larkdoc_get",description:"Read a Lark/Feishu document (docx) as plain text, for use as reference context. Accepts a raw doc id OR a full Lark doc URL (a /docx/ or /wiki/ link \u2014 wiki links are resolved to their backing docx). Returns { ok, documentId, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL (/docx/\u2026 or /wiki/\u2026)."}},required:["documentId"]}},{name:"larkdoc_create",description:"Create a new Lark/Feishu document (docx) with a title and optional content (markdown: #/##/### headings, - bullets, 1. ordered; or plain text). Pass wikiSpaceId (from larkwiki_list_spaces) to create the doc INSIDE a wiki space instead of as a standalone doc \u2014 optionally nested under parentNodeToken. Returns { ok, documentId, url } (plus wikiNodeToken when created in a wiki) \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."},folderToken:{type:"string",description:"Optional Lark drive folder token to create the doc in. Absent = the app root. Ignored when wikiSpaceId is set."},wikiSpaceId:{type:"string",description:"Optional wiki space id (from larkwiki_list_spaces) \u2014 create the doc as a node inside this wiki space."},parentNodeToken:{type:"string",description:"Optional wiki node token to nest the new doc under (only with wikiSpaceId). Absent = the space root."}},required:["title"]}},{name:"larkwiki_list_spaces",description:"List the Lark/Feishu wiki spaces visible to the connected app. Returns { ok, count, spaces:[{ spaceId, name }] }. Use to discover the wikiSpaceId for larkdoc_create.",input_schema:{type:"object",properties:{}}},{name:"larkdoc_append",description:"Append markdown/text content to the END of an existing Lark/Feishu document (docx). Accepts a documentId or a full Lark doc URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"larkdoc_insert_image",description:"Append a LOCAL image file (png/jpg, max 10MB) to the END of an existing Lark/Feishu document (docx). Accepts a documentId or full doc URL plus a local file path. Optional width/height in pixels. Returns { ok, documentId, blockId, fileToken, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},imagePath:{type:"string",description:"Local filesystem path to a .png or .jpg/.jpeg image (max 10MB)."},width:{type:"number",description:"Optional display width in pixels."},height:{type:"number",description:"Optional display height in pixels."}},required:["documentId","imagePath"]}},{name:"larkdoc_list_comments",description:"List the comment threads on a Lark/Feishu document. Accepts a documentId or full doc URL. Returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'. Only change for non-docx files (doc/sheet/bitable/file/slides)."}},required:["documentId"]}},{name:"larkdoc_add_comment",description:"Post a NEW top-level comment on a Lark/Feishu document. Accepts a documentId or full doc URL plus text. Returns { ok, documentId, commentId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},text:{type:"string",description:"The comment body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","text"]}},{name:"larkdoc_reply_comment",description:"Reply INSIDE an existing comment thread on a Lark/Feishu document. Pass { documentId, commentId, text }. Use to answer a user who @mentioned Zibby in a doc comment (reply in the same commentId). Returns { ok, documentId, commentId, replyId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},commentId:{type:"string",description:"The comment_id of the thread to reply into (from larkdoc_list_comments or the webhook event)."},text:{type:"string",description:"The reply body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","commentId","text"]}}]};var Ai={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:[...P.envKeys||[],...F.envKeys||[]],get serverName(){if(process.env.SLACK_CHANNEL)return P.serverName;if(process.env.LARK_RECEIVE_ID)return F.serverName;if(process.env.SLACK_BOT_TOKEN)return P.serverName},get allowedTools(){return process.env.SLACK_CHANNEL?P.allowedTools||[]:process.env.LARK_RECEIVE_ID?F.allowedTools||[]:process.env.SLACK_BOT_TOKEN?P.allowedTools||[]:[]},promptFragment:`## Chat notifications (Slack OR Lark \u2014 at least one connected)
431
431
  You can post chat messages via:
432
432
  - slack_post_message (channel, text[, blocks]) \u2014 Slack. The \`channel\` is REQUIRED on every call.
433
433
  - lark_send_message (receive_id, text) \u2014 Lark.
@@ -466,7 +466,7 @@ You have access to the user's Sentry. Use these tools:
466
466
  - sentry_list_issues: List errors/issues (supports Sentry search query, project filter, sort)
467
467
  - sentry_get_issue: Get detailed info about a specific issue (requires issueId)
468
468
  - sentry_update_issue: Change an issue's status (resolved / resolvedInNextRelease / ignored / unresolved / muted), assignment, or bookmark (requires issueId; needs write scope)
469
- - sentry_add_comment: Post a comment/note on an issue (requires issueId + text; needs write scope)`,resolve(){let r=mp();if(!r)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE","ZIBBY_SELF_HOST","SENTRY_URL","SENTRY_ORG","SENTRY_AUTH_TOKEN"])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 fp();return JSON.stringify({projects:e.map(n=>({slug:n.slug,name:n.name,platform:n.platform}))})}case"sentry_list_issues":{let e=await hp({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(n=>({id:n.id,title:n.title,culprit:n.culprit,count:n.count,firstSeen:n.firstSeen,lastSeen:n.lastSeen,level:n.level,status:n.status}))})}case"sentry_get_issue":{let e=await yp(t.issueId);return JSON.stringify({id:e.id,title:e.title,culprit:e.culprit,metadata:e.metadata,count:e.count,userCount:e.userCount,firstSeen:e.firstSeen,lastSeen:e.lastSeen,level:e.level,status:e.status,project:{slug:e.project?.slug,name:e.project?.name}})}case"sentry_update_issue":{let e=await gp(t.issueId,{status:t.status,statusDetails:t.statusDetails,assignedTo:t.assignedTo,isBookmarked:t.isBookmarked,hasSeen:t.hasSeen});return JSON.stringify({ok:!0,id:e.id??t.issueId,status:e.status,assignedTo:e.assignedTo,isBookmarked:e.isBookmarked})}case"sentry_add_comment":{let e=await bp(t.issueId,t.text);return JSON.stringify({ok:!0,id:e.id,issueId:t.issueId})}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"]}},{name:"sentry_update_issue",description:"Update a Sentry issue's status, assignment, or bookmark (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},status:{type:"string",description:"resolved | resolvedInNextRelease | unresolved | ignored | muted"},statusDetails:{type:"object",description:'Optional status details, e.g. { "inRelease": "latest" }'},assignedTo:{type:"string",description:'Assignee actor id, e.g. "user:123" or "team:456" (optional)'},isBookmarked:{type:"boolean",description:"Bookmark/unbookmark the issue (optional)"},hasSeen:{type:"boolean",description:"Mark the issue seen/unseen (optional)"}},required:["issueId"]}},{name:"sentry_add_comment",description:"Post a comment/note on a Sentry issue (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},text:{type:"string",description:"Comment body (markdown)"}},required:["issueId","text"]}}]};Gt.tools=Gt.toolsForAssistant;import{spawn as Zi}from"child_process";import{writeFileSync as _p,mkdirSync as qi,existsSync as oe,readdirSync as Wt,readFileSync as Yt,unlinkSync as kp,createWriteStream as wp,statSync as Sp}from"fs";import{resolve as Ee,join as X}from"path";import{resolveMaxParallelRuns as Vi}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as vp}from"@zibby/core/constants/zibby-scratch.js";var Ur="sessions",Br=".zibby/output",Ht=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",Ip=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",Xi=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",K=new Map,Se=[],Np=0,Pr=0,Mi=3e3;function Qi(){return`run_${++Np}_${Date.now().toString(36)}`}function Fi(r){let t=Math.floor(r/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function es(r){return r.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function J(r,t,e){if(!Ip)return;let n=`
469
+ - sentry_add_comment: Post a comment/note on an issue (requires issueId + text; needs write scope)`,resolve(){let r=mp();if(!r)return null;let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_USER_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","PROGRESS_API_URL","EXECUTION_ID","PROJECT_ID","STAGE","ZIBBY_SELF_HOST","SENTRY_URL","SENTRY_ORG","SENTRY_AUTH_TOKEN"])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 fp();return JSON.stringify({projects:e.map(n=>({slug:n.slug,name:n.name,platform:n.platform}))})}case"sentry_list_issues":{let e=await hp({query:t.query,sort:t.sort,project:t.project,limit:t.limit});return JSON.stringify({issues:e.map(n=>({id:n.id,title:n.title,culprit:n.culprit,count:n.count,firstSeen:n.firstSeen,lastSeen:n.lastSeen,level:n.level,status:n.status}))})}case"sentry_get_issue":{let e=await yp(t.issueId);return JSON.stringify({id:e.id,title:e.title,culprit:e.culprit,metadata:e.metadata,count:e.count,userCount:e.userCount,firstSeen:e.firstSeen,lastSeen:e.lastSeen,level:e.level,status:e.status,project:{slug:e.project?.slug,name:e.project?.name}})}case"sentry_update_issue":{let e=await gp(t.issueId,{status:t.status,statusDetails:t.statusDetails,assignedTo:t.assignedTo,isBookmarked:t.isBookmarked,hasSeen:t.hasSeen});return JSON.stringify({ok:!0,id:e.id??t.issueId,status:e.status,assignedTo:e.assignedTo,isBookmarked:e.isBookmarked})}case"sentry_add_comment":{let e=await bp(t.issueId,t.text);return JSON.stringify({ok:!0,id:e.id,issueId:t.issueId})}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"]}},{name:"sentry_update_issue",description:"Update a Sentry issue's status, assignment, or bookmark (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},status:{type:"string",description:"resolved | resolvedInNextRelease | unresolved | ignored | muted"},statusDetails:{type:"object",description:'Optional status details, e.g. { "inRelease": "latest" }'},assignedTo:{type:"string",description:'Assignee actor id, e.g. "user:123" or "team:456" (optional)'},isBookmarked:{type:"boolean",description:"Bookmark/unbookmark the issue (optional)"},hasSeen:{type:"boolean",description:"Mark the issue seen/unseen (optional)"}},required:["issueId"]}},{name:"sentry_add_comment",description:"Post a comment/note on a Sentry issue (needs event:write scope)",input_schema:{type:"object",properties:{issueId:{type:"string",description:"Sentry issue ID"},text:{type:"string",description:"Comment body (markdown)"}},required:["issueId","text"]}}]};Gt.tools=Gt.toolsForAssistant;import{spawn as Zi}from"child_process";import{writeFileSync as _p,mkdirSync as qi,existsSync as oe,readdirSync as Wt,readFileSync as Yt,unlinkSync as wp,createWriteStream as kp,statSync as Sp}from"fs";import{resolve as Ee,join as X}from"path";import{resolveMaxParallelRuns as Vi}from"@zibby/core/utils/parallel-config.js";import{zibbyScratchSpecsDir as vp}from"@zibby/core/constants/zibby-scratch.js";var Ur="sessions",Br=".zibby/output",Ht=process.env.ZIBBY_RUNNER_NODE_PROGRESS==="1",Ip=process.env.ZIBBY_RUNNER_STATUS_STREAM==="1",Xi=process.env.ZIBBY_RUNNER_SPAWN_LOGS==="1",K=new Map,Se=[],Np=0,Pr=0,Mi=3e3;function Qi(){return`run_${++Np}_${Date.now().toString(36)}`}function Fi(r){let t=Math.floor(r/1e3);return t<60?`${t}s`:`${Math.floor(t/60)}m ${t%60}s`}function es(r){return r.replace(/\x1b\[[0-9;]*[a-zA-Z]/g,"")}function J(r,t,e){if(!Ip)return;let n=`
470
470
  ${t} [${r}] ${e}
471
471
  `;try{process.stderr.write(n)}catch{}}function Jr(){Se.length=0;for(let[,r]of K)if(r.status==="queued"&&(r.status="cancelled"),r.status==="running"&&r._child)try{r._child.kill("SIGTERM")}catch{}}process.on("exit",Jr);process.on("SIGINT",()=>{Jr(),process.exit(0)});process.on("SIGTERM",()=>{Jr(),process.exit(0)});var ts={id:"runner",description:"Run zibby test workflows from chat (parallel supported)",envKeys:[],promptFragment:`## Test Runner
472
472
  You can run zibby test workflows directly from chat:
@@ -606,7 +606,7 @@ Each run generates:
606
606
  - raw_stream_output.txt: Agent log
607
607
 
608
608
  Use run_artifacts({ runId, type }) and run_diagnose({ runId }) to inspect and explain failures.`,resolve(){return null},async handleToolCall(r,t,e){let n=e?.options?.workspace||process.cwd();try{switch(r){case"run_generate":return await Op(t,n);case"run_test":return await jp(t,n,e);case"run_status":return Lp(t);case"run_cancel":return $p(t);case"run_artifacts":return Up(t,n);case"run_diagnose":return Bp(t,n);case"list_specs":return Jp(t,n);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 Cr(){let r=0;for(let[,t]of K)t.status==="running"&&r++;return r}function Ki(){for(;Se.length>0;){let r=Vi(Se[0]?.context?.options?.config);if(Cr()>=r)break;let{args:t,cwd:e,context:n}=Se.shift();rs(t,e,n)}}async function Op(r,t){let{ticket:e,description:n,input:i,repo:s,agent:o,output:a}=r,c=["generate"];e&&c.push("--ticket",e),n&&c.push("--description",n),i&&c.push("--input",i),s&&c.push("--repo",s),a&&c.push("--output",a);let l=["assistant","cursor","claude","codex","gemini"],d=o||process.env.AGENT_TYPE,p=d&&l.includes(d)?d:null;p&&c.push("--agent",p);let u=e||"generate";return J(u,"\u{1F9EA}","Starting test spec generation (real agent with codebase access)..."),new Promise(m=>{Xi&&console.error(`[zibby:spawn] skill=run_generate parentPid=${process.pid} \u2192 child zibby ${c.map(y=>/\s/.test(y)?JSON.stringify(y):y).join(" ")} cwd=${t}`);let f=Zi("zibby",c,{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"],detached:!1}),h="",_="";f.stdout.on("data",y=>{let b=y.toString();h+=b;for(let g of b.split(`
609
- `)){let k=es(g).trim();k.startsWith("\u2705")?J(u,"\u2705",k.slice(2).trim()):k.startsWith("\u2713")&&J(u,"\u2714",k.slice(2).trim())}}),f.stderr.on("data",y=>{_+=y.toString()}),f.on("close",y=>{if(y!==0){J(u,"\u274C",`Generation failed (exit ${y})`),m(JSON.stringify({error:`zibby generate failed with exit code ${y}`,stderr:_.slice(-1e3)}));return}let b=Ee(t,a||"test-specs"),g=[];try{let k=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";g=Wt(b).filter(O=>O.endsWith(".txt")&&(!k||O.startsWith(k))).map(O=>X(b,O))}catch{}J(u,"\u2705",`Generated ${g.length} test spec files`),m(JSON.stringify({success:!0,ticketKey:e||null,specFiles:g.map(k=>k.replace(`${t}/`,"")),total:g.length,message:`Generated ${g.length} specs. Now call run_test for each file.`}))}),f.on("error",y=>{J(u,"\u274C",`Spawn error: ${y.message}`),m(JSON.stringify({error:y.message}))})})}var Gi=1e5,Hi=/^[A-Z][A-Z0-9]+-\d+$/,Tp=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Rp(r,t){if(!t||!t.length)return r;let e=r;for(let n of t)n.type==="strong"?e=`**${e}**`:n.type==="em"?e=`_${e}_`:n.type==="code"?e=`\`${e}\``:n.type==="strike"?e=`~~${e}~~`:n.type==="link"&&n.attrs?.href&&(e=`[${e}](${n.attrs.href})`);return e}function zt(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let n of r){if(n.type==="text"){e.push(Rp(n.text||"",n.marks));continue}if(n.type==="hardBreak"){e.push(`
609
+ `)){let w=es(g).trim();w.startsWith("\u2705")?J(u,"\u2705",w.slice(2).trim()):w.startsWith("\u2713")&&J(u,"\u2714",w.slice(2).trim())}}),f.stderr.on("data",y=>{_+=y.toString()}),f.on("close",y=>{if(y!==0){J(u,"\u274C",`Generation failed (exit ${y})`),m(JSON.stringify({error:`zibby generate failed with exit code ${y}`,stderr:_.slice(-1e3)}));return}let b=Ee(t,a||"test-specs"),g=[];try{let w=e?e.toLowerCase().replace(/[^a-z0-9]+/g,"-"):"";g=Wt(b).filter(O=>O.endsWith(".txt")&&(!w||O.startsWith(w))).map(O=>X(b,O))}catch{}J(u,"\u2705",`Generated ${g.length} test spec files`),m(JSON.stringify({success:!0,ticketKey:e||null,specFiles:g.map(w=>w.replace(`${t}/`,"")),total:g.length,message:`Generated ${g.length} specs. Now call run_test for each file.`}))}),f.on("error",y=>{J(u,"\u274C",`Spawn error: ${y.message}`),m(JSON.stringify({error:y.message}))})})}var Gi=1e5,Hi=/^[A-Z][A-Z0-9]+-\d+$/,Tp=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function Rp(r,t){if(!t||!t.length)return r;let e=r;for(let n of t)n.type==="strong"?e=`**${e}**`:n.type==="em"?e=`_${e}_`:n.type==="code"?e=`\`${e}\``:n.type==="strike"?e=`~~${e}~~`:n.type==="link"&&n.attrs?.href&&(e=`[${e}](${n.attrs.href})`);return e}function zt(r,t=0){if(!Array.isArray(r))return"";let e=[];for(let n of r){if(n.type==="text"){e.push(Rp(n.text||"",n.marks));continue}if(n.type==="hardBreak"){e.push(`
610
610
  `);continue}if(n.type==="rule"){e.push(`
611
611
  ---
612
612
  `);continue}let i=n.content?zt(n.content,t+1):"";if(n.type==="listItem")e.push(i);else if(n.type==="bulletList"){let s=(n.content||[]).map(o=>`- ${zt(o.content||[],t+1).trim()}`);e.push(`
@@ -630,10 +630,10 @@ ${i}
630
630
 
631
631
  `).trim();return d?(d.length>Gi&&(d=`${d.slice(0,Gi)}
632
632
 
633
- ...[truncated]`),{inlineSpec:`inline:${d}`,issueKey:r}):null}catch{return null}}function xp(r,t){try{let e=JSON.parse(r);return JSON.stringify({...e,...t})}catch{return r}}async function jp(r,t,e){let n={...r},i=String(n.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let s=null;if(Hi.test(i)&&!i.startsWith("inline:")){let d=await Ep(i);d&&(i=d.inlineSpec,n.spec=i,String(n.ticketKey||"").trim()||(n.ticketKey=d.issueKey),s=d.issueKey)}let o=String(n.ticketKey||"").trim();if(o){for(let[d,p]of K.entries())if(p?.ticketKey===o&&!(p?.status!=="running"&&p?.status!=="queued"))return JSON.stringify({runId:d,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 d=Ee(t,i);if(!oe(d))return Hi.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=Vi(e?.options?.config);if(Cr()>=a){let d=Qi(),p=n.ticketKey||d,u={runId:d,spec:n.ticketKey?`${n.ticketKey}: ${n.spec}`:n.spec,ticketKey:n.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};K.set(d,u),Se.push({args:{...n,_queuedRunId:d},cwd:t,context:e}),J(p,"\u23F3",`Queued (${Cr()}/${a} running, ${Se.length} queued)`);let m={runId:d,spec:u.spec,ticketKey:u.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${a} concurrent).`};return s&&(m.resolvedFromJiraIssue=s,m.message+=` (spec built from Jira ${s})`),JSON.stringify(m)}let c=Date.now()-Pr;c<Mi&&Pr>0&&await new Promise(d=>setTimeout(d,Mi-c)),Pr=Date.now();let l=rs(n,t,e);return s?xp(l,{resolvedFromJiraIssue:s,message:`Spec was loaded from Jira issue ${s} (description + comments).`}):l}function rs(r,t,e){let{spec:n,ticketKey:i,agent:s,headless:o,workflow:a,_queuedRunId:c}=r,l=c||Qi(),d=n,p=!1;if(n.startsWith("inline:")){p=!0;let T=vp(t);qi(T,{recursive:!0}),d=X(T,`${l}.txt`),_p(d,n.slice(7).trim(),"utf-8")}let u=Ee(t,".zibby","output","runs");qi(u,{recursive:!0});let m=X(u,`${l}.log`),f=wp(m,{flags:"a"}),_=s&&["assistant","cursor","claude","codex","gemini"].includes(s)?s:null,y=["test",d];_&&y.push("--agent",_),o&&y.push("--headless"),a&&y.push("--workflow",a),Xi&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${y.map(T=>/\s/.test(T)?JSON.stringify(T):T).join(" ")} cwd=${t}`);let b=Zi("zibby",y,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),g={runId:l,spec:i?`${i}: ${n}`:n,ticketKey:i||null,specPath:d,logPath:m,isInline:p,pid:b.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},k=i||l,O="";function q(T){let A=es(T).trim();if(!A)return;if(A.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let x=JSON.parse(A.slice(22));x.phase==="node_begin"?g.currentNode=x.node:x.phase==="node_end"&&(x.node&&!g.completedNodes.includes(x.node)&&g.completedNodes.push(x.node),g.currentNode===x.node&&(g.currentNode=null))}catch{}return}let M=A.match(/Session\s+(\S+)/);if(M&&!g.sessionId&&(g.sessionId=M[1],g.sessionPath=Ee(t,Br,Ur,g.sessionId)),A.startsWith("\u250C ")||A.startsWith("\u250C ")){let x=A.slice(2).trim();g.currentNode=x,Ht&&J(k,"\u25B6",`${x}`)}else if(A.startsWith("\u2514 ")||A.startsWith("\u2514 ")){let x=A.slice(2).trim();x.startsWith("done")?(g.currentNode&&!g.completedNodes.includes(g.currentNode)&&g.completedNodes.push(g.currentNode),Ht&&J(k,"\u2714",`${g.currentNode||"node"} done ${x.replace("done","").trim()}`),g.currentNode=null):x.startsWith("failed")&&(Ht&&J(k,"\u2718",`${g.currentNode||"node"} failed ${x.replace("failed","").trim()}`),g.currentNode=null)}else A.includes("Workflow completed")&&(g.currentNode=null,Ht&&J(k,"\u2714",`Workflow completed (${Fi(Date.now()-g.startTime)})`))}function ye(T){let A=T.toString();g.output+=A,f.write(A),g.output.length>5e4&&(g.output=g.output.slice(-3e4)),O+=A;let M=O.split(`
634
- `);O=M.pop();for(let x of M)q(x)}return b.stdout.on("data",ye),b.stderr.on("data",T=>{let A=T.toString();g.error+=A,f.write(A),g.error.length>2e4&&(g.error=g.error.slice(-1e4))}),b.on("close",T=>{g.status=T===0?"passed":"failed",g.exitCode=T,g.endTime=Date.now(),O&&q(O),f.end();let A=Fi(Date.now()-g.startTime);if(T===0?J(k,"\u2705",`Passed (${A})`):J(k,"\u274C",`Failed (${A})`),g.isInline)try{kp(g.specPath)}catch{}Ki()}),b.on("error",T=>{g.status="error",g.error+=`
635
- Spawn error: ${T.message}`,J(k,"\u274C",`Spawn error: ${T.message}`),f.end(),Ki()}),g._child=b,K.set(l,g),JSON.stringify({runId:l,spec:g.spec,ticketKey:g.ticketKey,status:"running",pid:b.pid,logFile:m})}function zi(r){let t=Math.round(((r.endTime||Date.now())-r.startTime)/1e3),e=r.completedNodes||[],n=r.currentNode||null;if(r.status!=="running")return{elapsed:t,stage:r.status,completedNodes:e,currentNode:null};let i;return n?(i=`Actively executing node "${n}"`,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:n,completedNodes:e,progress:i}}function Lp(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let s=[...K.entries()].map(([d,p])=>{let u=zi(p),m={runId:d,spec:p.spec,ticketKey:p.ticketKey,status:p.status,elapsed:u.elapsed,exitCode:p.exitCode,sessionId:p.sessionId||null};return p.status==="running"?(m.currentNode=u.currentNode,m.completedNodes=u.completedNodes,m.progress=u.progress):m.outputTail=p.output.slice(-500),m}),o=s.filter(d=>d.status==="running").length,a=s.filter(d=>d.status==="passed").length,c=s.filter(d=>d.status==="failed").length,l={total:s.length,running:o,passed:a,failed:c,runs:s};return o>0&&(l._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(l)}let e=K.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let n=zi(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:n.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=n.currentNode,i.completedNodes=n.completedNodes,i.progress=n.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 Yi(r,t){if(t.status==="queued"){let e=Se.findIndex(n=>n.args._queuedRunId===r);return e>=0&&Se.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 $p(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[];for(let[i,s]of K.entries())(s.status==="running"||s.status==="queued")&&n.push(Yi(i,s));return n.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:n.length,results:n})}let e=K.get(t);return JSON.stringify(e?Yi(t,e):{error:`Run not found: ${t}`})}function Pp(r,t){let e=K.get(r);if(e?.sessionPath&&oe(e.sessionPath))return e.sessionPath;if(e?.sessionId){let n=Ee(t,Br,Ur,e.sessionId);if(oe(n))return n}return null}function ns(r,t=""){let e=[];if(!oe(r))return e;for(let n of Wt(r,{withFileTypes:!0})){let i=t?`${t}/${n.name}`:n.name;if(n.isDirectory())e.push(...ns(X(r,n.name),i));else{let s=Sp(X(r,n.name));e.push({path:i,size:s.size})}}return e}function Wi(r){if(!oe(r))return null;try{return JSON.parse(Yt(r,"utf-8"))}catch{return null}}function is(r,t=2e3){if(!r||!oe(r))return"";try{return Yt(r,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function Cp({run:r,logTail:t,errorTail:e}){let i=`${t||""}
636
- ${e||""}`.toLowerCase(),s={runId:r?.runId||null,status:r?.status||null,exitCode:r?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return r?.status==="running"||r?.status==="queued"?{...s,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...s,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...s,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...s,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...s,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...s,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:s}function Up(r,t){let{runId:e,type:n,node:i="execute_live",query:s,tail:o=3e3}=r;if(n==="search"){if(!s)return JSON.stringify({error:'query is required for type="search"'});let c=Ee(t,Br,Ur);if(!oe(c))return JSON.stringify({matches:[],message:"No sessions found"});let l=[],d=s.toLowerCase();for(let p of Wt(c,{withFileTypes:!0})){if(!p.isDirectory())continue;let u=X(c,p.name),m=[{file:"execute_live/result.json",label:"result"},{file:"execute_live/events.json",label:"events"},{file:"execute_live/raw_stream_output.txt",label:"log"},{file:"generate_script/raw_stream_output.txt",label:"script_log"},{file:"title.txt",label:"title"}];for(let{file:f,label:h}of m){let _=X(u,f);if(oe(_))try{let y=Yt(_,"utf-8");if(y.toLowerCase().includes(d)){let b=y.toLowerCase().indexOf(d),g=Math.max(0,b-100),k=Math.min(y.length,b+s.length+100);l.push({sessionId:p.name,artifact:h,snippet:y.slice(g,k)})}}catch{}}if(l.length>=20)break}return JSON.stringify({query:s,matches:l,total:l.length})}if(!e)return JSON.stringify({error:"runId is required for this type"});if(n==="log"){let c=K.get(e),l=is(c?.logPath,o);if(l)return JSON.stringify({runId:e,source:"run-log",totalLength:l.length,tail:l})}let a=Pp(e,t);if(!a)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(n){case"list":{let c=ns(a);return JSON.stringify({sessionId:a.split("/").pop(),files:c,total:c.length})}case"result":{let c=Wi(X(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=Wi(X(a,i,"events.json"));if(!c)return JSON.stringify({error:`No events.json found in ${i}`});let l=Array.isArray(c)?c:c.events||[];return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalEvents:l.length,events:l.slice(-50)})}case"log":{let c=X(a,i,"raw_stream_output.txt");if(!oe(c))return JSON.stringify({error:`No log found in ${i}`});let l=Yt(c,"utf-8");return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalLength:l.length,tail:l.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${n}. Use: list, result, events, log, search`})}}function Bp(r,t){let e=String(r?.runId||"all"),n=Number(r?.tail||2e3),i=e==="all"?[...K.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let s=i.map(c=>{let l=K.get(c);if(!l)return{runId:c,error:`Run not found: ${c}`};let d=is(l.logPath,n),p=String(l.error||"").slice(-Math.max(200,n));return{...Cp({run:l,logTail:d,errorTail:p}),ticketKey:l.ticketKey||null,spec:l.spec,logTail:d,errorTail:p}}),o=s.filter(c=>c.status==="failed"||c.status==="error"),a=s.filter(c=>c.status==="running"||c.status==="queued");return JSON.stringify({total:s.length,failed:o.length,active:a.length,diagnoses:s})}function Jp(r,t){let e=r?.directory||"test-specs",n=Ee(t,e);if(!oe(n))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let s=function(o,a){for(let c of Wt(o,{withFileTypes:!0})){let l=a?`${a}/${c.name}`:c.name;c.isDirectory()?s(X(o,c.name),l):(c.name.endsWith(".txt")||c.name.endsWith(".md"))&&i.push(l)}},i=[];return s(n,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}function ss(r){let t=(r||"").match(/github\.com[/:]([^/]+)\/([^/]+?)(?:\.git)?$/);return t?{provider:"github",owner:t[1],repo:t[2]}:(t=(r||"").match(/gitlab\.com[/:](.+?)\/([^/]+?)(?:\.git)?$/),t?{provider:"gitlab",owner:t[1],repo:t[2]}:null)}var os={..._e,id:"git-write",envKeys:[..._e.envKeys||[],...Je.envKeys||[],...De.envKeys||[]].filter((r,t,e)=>e.indexOf(r)===t),promptFragment:`${_e.promptFragment}
633
+ ...[truncated]`),{inlineSpec:`inline:${d}`,issueKey:r}):null}catch{return null}}function xp(r,t){try{let e=JSON.parse(r);return JSON.stringify({...e,...t})}catch{return r}}async function jp(r,t,e){let n={...r},i=String(n.spec??"").trim();if(!i)return JSON.stringify({error:"spec is required"});let s=null;if(Hi.test(i)&&!i.startsWith("inline:")){let d=await Ep(i);d&&(i=d.inlineSpec,n.spec=i,String(n.ticketKey||"").trim()||(n.ticketKey=d.issueKey),s=d.issueKey)}let o=String(n.ticketKey||"").trim();if(o){for(let[d,p]of K.entries())if(p?.ticketKey===o&&!(p?.status!=="running"&&p?.status!=="queued"))return JSON.stringify({runId:d,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 d=Ee(t,i);if(!oe(d))return Hi.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=Vi(e?.options?.config);if(Cr()>=a){let d=Qi(),p=n.ticketKey||d,u={runId:d,spec:n.ticketKey?`${n.ticketKey}: ${n.spec}`:n.spec,ticketKey:n.ticketKey||null,status:"queued",startTime:Date.now(),exitCode:null,output:"",error:""};K.set(d,u),Se.push({args:{...n,_queuedRunId:d},cwd:t,context:e}),J(p,"\u23F3",`Queued (${Cr()}/${a} running, ${Se.length} queued)`);let m={runId:d,spec:u.spec,ticketKey:u.ticketKey,status:"queued",message:`Queued \u2014 will start when a slot opens (max ${a} concurrent).`};return s&&(m.resolvedFromJiraIssue=s,m.message+=` (spec built from Jira ${s})`),JSON.stringify(m)}let c=Date.now()-Pr;c<Mi&&Pr>0&&await new Promise(d=>setTimeout(d,Mi-c)),Pr=Date.now();let l=rs(n,t,e);return s?xp(l,{resolvedFromJiraIssue:s,message:`Spec was loaded from Jira issue ${s} (description + comments).`}):l}function rs(r,t,e){let{spec:n,ticketKey:i,agent:s,headless:o,workflow:a,_queuedRunId:c}=r,l=c||Qi(),d=n,p=!1;if(n.startsWith("inline:")){p=!0;let T=vp(t);qi(T,{recursive:!0}),d=X(T,`${l}.txt`),_p(d,n.slice(7).trim(),"utf-8")}let u=Ee(t,".zibby","output","runs");qi(u,{recursive:!0});let m=X(u,`${l}.log`),f=kp(m,{flags:"a"}),_=s&&["assistant","cursor","claude","codex","gemini"].includes(s)?s:null,y=["test",d];_&&y.push("--agent",_),o&&y.push("--headless"),a&&y.push("--workflow",a),Xi&&console.error(`[zibby:spawn] skill=run_test parentPid=${process.pid} \u2192 child zibby ${y.map(T=>/\s/.test(T)?JSON.stringify(T):T).join(" ")} cwd=${t}`);let b=Zi("zibby",y,{cwd:t,env:{...process.env,ZIBBY_WORKFLOW_GRAPH_LOG_MARKERS:"1"},stdio:["ignore","pipe","pipe"],detached:!1}),g={runId:l,spec:i?`${i}: ${n}`:n,ticketKey:i||null,specPath:d,logPath:m,isInline:p,pid:b.pid,status:"running",output:"",error:"",startTime:Date.now(),exitCode:null,currentNode:null,completedNodes:[]},w=i||l,O="";function q(T){let A=es(T).trim();if(!A)return;if(A.startsWith("__WORKFLOW_GRAPH_LOG__")){try{let x=JSON.parse(A.slice(22));x.phase==="node_begin"?g.currentNode=x.node:x.phase==="node_end"&&(x.node&&!g.completedNodes.includes(x.node)&&g.completedNodes.push(x.node),g.currentNode===x.node&&(g.currentNode=null))}catch{}return}let M=A.match(/Session\s+(\S+)/);if(M&&!g.sessionId&&(g.sessionId=M[1],g.sessionPath=Ee(t,Br,Ur,g.sessionId)),A.startsWith("\u250C ")||A.startsWith("\u250C ")){let x=A.slice(2).trim();g.currentNode=x,Ht&&J(w,"\u25B6",`${x}`)}else if(A.startsWith("\u2514 ")||A.startsWith("\u2514 ")){let x=A.slice(2).trim();x.startsWith("done")?(g.currentNode&&!g.completedNodes.includes(g.currentNode)&&g.completedNodes.push(g.currentNode),Ht&&J(w,"\u2714",`${g.currentNode||"node"} done ${x.replace("done","").trim()}`),g.currentNode=null):x.startsWith("failed")&&(Ht&&J(w,"\u2718",`${g.currentNode||"node"} failed ${x.replace("failed","").trim()}`),g.currentNode=null)}else A.includes("Workflow completed")&&(g.currentNode=null,Ht&&J(w,"\u2714",`Workflow completed (${Fi(Date.now()-g.startTime)})`))}function ye(T){let A=T.toString();g.output+=A,f.write(A),g.output.length>5e4&&(g.output=g.output.slice(-3e4)),O+=A;let M=O.split(`
634
+ `);O=M.pop();for(let x of M)q(x)}return b.stdout.on("data",ye),b.stderr.on("data",T=>{let A=T.toString();g.error+=A,f.write(A),g.error.length>2e4&&(g.error=g.error.slice(-1e4))}),b.on("close",T=>{g.status=T===0?"passed":"failed",g.exitCode=T,g.endTime=Date.now(),O&&q(O),f.end();let A=Fi(Date.now()-g.startTime);if(T===0?J(w,"\u2705",`Passed (${A})`):J(w,"\u274C",`Failed (${A})`),g.isInline)try{wp(g.specPath)}catch{}Ki()}),b.on("error",T=>{g.status="error",g.error+=`
635
+ Spawn error: ${T.message}`,J(w,"\u274C",`Spawn error: ${T.message}`),f.end(),Ki()}),g._child=b,K.set(l,g),JSON.stringify({runId:l,spec:g.spec,ticketKey:g.ticketKey,status:"running",pid:b.pid,logFile:m})}function zi(r){let t=Math.round(((r.endTime||Date.now())-r.startTime)/1e3),e=r.completedNodes||[],n=r.currentNode||null;if(r.status!=="running")return{elapsed:t,stage:r.status,completedNodes:e,currentNode:null};let i;return n?(i=`Actively executing node "${n}"`,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:n,completedNodes:e,progress:i}}function Lp(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let s=[...K.entries()].map(([d,p])=>{let u=zi(p),m={runId:d,spec:p.spec,ticketKey:p.ticketKey,status:p.status,elapsed:u.elapsed,exitCode:p.exitCode,sessionId:p.sessionId||null};return p.status==="running"?(m.currentNode=u.currentNode,m.completedNodes=u.completedNodes,m.progress=u.progress):m.outputTail=p.output.slice(-500),m}),o=s.filter(d=>d.status==="running").length,a=s.filter(d=>d.status==="passed").length,c=s.filter(d=>d.status==="failed").length,l={total:s.length,running:o,passed:a,failed:c,runs:s};return o>0&&(l._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(l)}let e=K.get(t);if(!e)return JSON.stringify({error:`Run not found: ${t}`});let n=zi(e),i={runId:t,spec:e.spec,ticketKey:e.ticketKey,status:e.status,elapsed:n.elapsed,exitCode:e.exitCode,sessionId:e.sessionId||null};return e.status==="running"?(i.currentNode=n.currentNode,i.completedNodes=n.completedNodes,i.progress=n.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 Yi(r,t){if(t.status==="queued"){let e=Se.findIndex(n=>n.args._queuedRunId===r);return e>=0&&Se.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 $p(r){let{runId:t}=r;if(!t)return JSON.stringify({error:"runId is required"});if(t==="all"){let n=[];for(let[i,s]of K.entries())(s.status==="running"||s.status==="queued")&&n.push(Yi(i,s));return n.length===0?JSON.stringify({ok:!0,message:"No active runs to cancel"}):JSON.stringify({ok:!0,cancelled:n.length,results:n})}let e=K.get(t);return JSON.stringify(e?Yi(t,e):{error:`Run not found: ${t}`})}function Pp(r,t){let e=K.get(r);if(e?.sessionPath&&oe(e.sessionPath))return e.sessionPath;if(e?.sessionId){let n=Ee(t,Br,Ur,e.sessionId);if(oe(n))return n}return null}function ns(r,t=""){let e=[];if(!oe(r))return e;for(let n of Wt(r,{withFileTypes:!0})){let i=t?`${t}/${n.name}`:n.name;if(n.isDirectory())e.push(...ns(X(r,n.name),i));else{let s=Sp(X(r,n.name));e.push({path:i,size:s.size})}}return e}function Wi(r){if(!oe(r))return null;try{return JSON.parse(Yt(r,"utf-8"))}catch{return null}}function is(r,t=2e3){if(!r||!oe(r))return"";try{return Yt(r,"utf-8").slice(-Math.max(200,Number(t)||2e3))}catch{return""}}function Cp({run:r,logTail:t,errorTail:e}){let i=`${t||""}
636
+ ${e||""}`.toLowerCase(),s={runId:r?.runId||null,status:r?.status||null,exitCode:r?.exitCode??null,likelyCause:"Unknown failure",confidence:"low",nextStep:'Call run_artifacts({ runId, type: "log" }) with larger tail and inspect full logs.'};return r?.status==="running"||r?.status==="queued"?{...s,likelyCause:"Run is still active; no terminal failure to diagnose yet.",confidence:"high",nextStep:'Call run_status({ runId: "all" }) to check progress.'}:i.includes("test spec not found")?{...s,likelyCause:"Invalid spec input: run_test received a non-existent spec path.",confidence:"high",nextStep:"Use spec as inline:... or a real file path from list_specs. For ticket keys, fetch steps first via Jira then build inline spec."}:i.includes("unknown command")&&i.includes("'run'")?{...s,likelyCause:"CLI command mismatch (`zibby run` unsupported in current CLI).",confidence:"high",nextStep:"Use `zibby test ...` spawn path (runner should already do this)."}:i.includes("missing openai_api_key")||i.includes("didn't provide an api key")||i.includes("401")?{...s,likelyCause:"Provider authentication/config issue (API key/proxy auth missing or rejected).",confidence:"medium",nextStep:"Verify proxy/token env and auth mode, then retry once configuration is valid."}:i.includes("spawn error")||i.includes("enoent")?{...s,likelyCause:"Failed to spawn CLI process (binary/path/environment issue).",confidence:"medium",nextStep:"Confirm `zibby` is installed and available in PATH for the chat process."}:i.includes("security command failed")||i.includes("security process exited with code: 45")||i.includes("password not found for account")?{...s,likelyCause:"Cursor agent keychain/auth failed during preflight (often transient, more common under parallel starts).",confidence:"high",nextStep:'Retry failed ticket sequentially (not parallel), or run with a different agent via run_test({ ..., agent: "codex" }).'}:s}function Up(r,t){let{runId:e,type:n,node:i="execute_live",query:s,tail:o=3e3}=r;if(n==="search"){if(!s)return JSON.stringify({error:'query is required for type="search"'});let c=Ee(t,Br,Ur);if(!oe(c))return JSON.stringify({matches:[],message:"No sessions found"});let l=[],d=s.toLowerCase();for(let p of Wt(c,{withFileTypes:!0})){if(!p.isDirectory())continue;let u=X(c,p.name),m=[{file:"execute_live/result.json",label:"result"},{file:"execute_live/events.json",label:"events"},{file:"execute_live/raw_stream_output.txt",label:"log"},{file:"generate_script/raw_stream_output.txt",label:"script_log"},{file:"title.txt",label:"title"}];for(let{file:f,label:h}of m){let _=X(u,f);if(oe(_))try{let y=Yt(_,"utf-8");if(y.toLowerCase().includes(d)){let b=y.toLowerCase().indexOf(d),g=Math.max(0,b-100),w=Math.min(y.length,b+s.length+100);l.push({sessionId:p.name,artifact:h,snippet:y.slice(g,w)})}}catch{}}if(l.length>=20)break}return JSON.stringify({query:s,matches:l,total:l.length})}if(!e)return JSON.stringify({error:"runId is required for this type"});if(n==="log"){let c=K.get(e),l=is(c?.logPath,o);if(l)return JSON.stringify({runId:e,source:"run-log",totalLength:l.length,tail:l})}let a=Pp(e,t);if(!a)return JSON.stringify({error:`No session found for run ${e}. The run may still be starting.`});switch(n){case"list":{let c=ns(a);return JSON.stringify({sessionId:a.split("/").pop(),files:c,total:c.length})}case"result":{let c=Wi(X(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=Wi(X(a,i,"events.json"));if(!c)return JSON.stringify({error:`No events.json found in ${i}`});let l=Array.isArray(c)?c:c.events||[];return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalEvents:l.length,events:l.slice(-50)})}case"log":{let c=X(a,i,"raw_stream_output.txt");if(!oe(c))return JSON.stringify({error:`No log found in ${i}`});let l=Yt(c,"utf-8");return JSON.stringify({sessionId:a.split("/").pop(),node:i,totalLength:l.length,tail:l.slice(-o)})}default:return JSON.stringify({error:`Unknown artifact type: ${n}. Use: list, result, events, log, search`})}}function Bp(r,t){let e=String(r?.runId||"all"),n=Number(r?.tail||2e3),i=e==="all"?[...K.keys()]:[e];if(i.length===0)return JSON.stringify({error:"No runs available to diagnose. Call run_test first."});let s=i.map(c=>{let l=K.get(c);if(!l)return{runId:c,error:`Run not found: ${c}`};let d=is(l.logPath,n),p=String(l.error||"").slice(-Math.max(200,n));return{...Cp({run:l,logTail:d,errorTail:p}),ticketKey:l.ticketKey||null,spec:l.spec,logTail:d,errorTail:p}}),o=s.filter(c=>c.status==="failed"||c.status==="error"),a=s.filter(c=>c.status==="running"||c.status==="queued");return JSON.stringify({total:s.length,failed:o.length,active:a.length,diagnoses:s})}function Jp(r,t){let e=r?.directory||"test-specs",n=Ee(t,e);if(!oe(n))return JSON.stringify({specs:[],directory:e,message:`Directory not found: ${e}`});try{let s=function(o,a){for(let c of Wt(o,{withFileTypes:!0})){let l=a?`${a}/${c.name}`:c.name;c.isDirectory()?s(X(o,c.name),l):(c.name.endsWith(".txt")||c.name.endsWith(".md"))&&i.push(l)}},i=[];return s(n,""),JSON.stringify({specs:i.map(o=>`${e}/${o}`),total:i.length,directory:e})}catch(i){return JSON.stringify({error:i.message})}}function ss(r){let t=(r||"").match(/github\.com[/:]([^/]+)\/([^/]+?)(?:\.git)?$/);return t?{provider:"github",owner:t[1],repo:t[2]}:(t=(r||"").match(/gitlab\.com[/:](.+?)\/([^/]+?)(?:\.git)?$/),t?{provider:"gitlab",owner:t[1],repo:t[2]}:null)}var os={..._e,id:"git-write",envKeys:[..._e.envKeys||[],...Je.envKeys||[],...De.envKeys||[]].filter((r,t,e)=>e.indexOf(r)===t),promptFragment:`${_e.promptFragment}
637
637
 
638
638
  ## Opening a pull request / merge request (git_open_pr)
639
639
  After you have pushed a branch, OPEN the PR/MR with the provider-agnostic tool:
@@ -679,7 +679,7 @@ To MERGE an open PR/MR, use the provider-agnostic tool:
679
679
  )`],as=new Set;function G(r,t){return ps(fs,t,{...hs,cwd:r})}function ve(r,t){try{let e=G(r,["sql","-q",t,"-r","json"]);return JSON.parse(e.trim()).rows||[]}catch{return[]}}function H(r,t){G(r,["sql","-q",t])}function Xt(r){if(as.has(r))return!0;if(!Gr(ue(r,".dolt"))){if(!Kp())return!1;us(r,{recursive:!0}),G(r,["init","--name","Zibby Chat Memory","--email","chat@zibby.app"])}let t=`${Fp.join(`;
680
680
  `)};`;H(r,t);try{H(r,"ALTER TABLE chat_memory ADD COLUMN tier VARCHAR(16) DEFAULT 'mid'")}catch{}try{H(r,"ALTER TABLE chat_memory ADD COLUMN memory_key VARCHAR(160)")}catch{}return as.add(r),!0}function Kp(){try{return ps(fs,["version"],{...hs,timeout:5e3}),!0}catch{return!1}}function S(r){return r==null?"NULL":`'${String(r).replace(/'/g,"''")}'`}function Kr(r){return String(r||"").toLowerCase().replace(/[“”]/g,'"').replace(/[‘’]/g,"'").replace(/[\s_-]+/g," ").replace(/[^\w\s"']/g,"").replace(/\s+/g," ").trim()}function Ge(r){return r==="long"?3:r==="mid"?2:r==="short"?1:0}function Hr(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 ys(r){let t=new Map;for(let e of r||[]){let n=Kr(e.content),i=e.memory_key?`key:${e.memory_key}`:n?`norm:${n}`:"";if(!i)continue;let s=t.get(i);if(!s){t.set(i,e);continue}let o=Ge(s.tier),a=Ge(e.tier);if(a>o){t.set(i,e);continue}a===o&&Number(e.relevance||0)>Number(s.relevance||0)&&t.set(i,e)}return[...t.values()]}function er(r,t){let e=String(r??"");return e.length<=t?e:t<=1?e.slice(0,t):`${e.slice(0,t-1)}\u2026`}function ft(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||Fr),error:r?.error||null};return e.backend==="mem0"?{...e,recentSessions:[],taskStats:[]}:e}function cs(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(`- ${er(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 n=e.tier==="long"?"\u2605":"\xB7";t.push(`${n} [${e.category}] ${er(e.content,120)}`)}}return t.length===0?"":`## Memory Context
681
681
  ${t.join(`
682
- `)}`}function Qt(r){return{backend:r.backend,recentSessions:r.recentSessions.slice(0,3).map(t=>({summary:er(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:er(String(t?.content||""),140),source:t?.source||null})),taskStats:r.taskStats,error:r.error||null}}async function Gp(r,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let n=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(n==="mem0"||n==="dolt")return n;if(Zt.has(r))return Zt.get(r);try{let i=ue(r,".zibby.config.mjs");if(Gr(i)){let s=await import(ht(i).href),o=String(s?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Zt.set(r,o),o}}catch{}return Zt.set(r,Fr),Fr}function gs(r){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${Dp(r||process.cwd())}`}var Hp="mem0";function bs(r){let t=ue(r,Mr,Hp);return{dir:t,vectorDbPath:ue(t,"vectors.db"),historyDbPath:ue(t,"history.db")}}function zp(r){let t=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),n=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),i=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),s=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:a}=bs(r||process.cwd());return{llm:{provider:"openai",config:{model:n,baseURL:t,...e?{apiKey:e}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:s,baseURL:t,...e?{apiKey:e}:{}}},vectorStore:{provider:"memory",config:{dimension:s,dbPath:o}},historyDbPath:a}}async function _s(r){let t=r||process.cwd();if(Dr.has(t))return Dr.get(t);let e;try{let a=ms(ht(ue(t,"package.json")).href).resolve("mem0ai/oss");e=await import(ht(a).href)}catch{try{let o=Mp.resolve("mem0ai/oss");e=await import(ht(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 n=e?.Memory;if(!n)throw new Error("mem0ai/oss does not export Memory");let i=zp(t);if(i)try{us(bs(t).dir,{recursive:!0})}catch{}let s=i?new n(i):new n;return Dr.set(t,s),s}function ls(r,t="mid"){return(Array.isArray(r)?r:Array.isArray(r?.results)?r.results:[]).map(n=>({id:n?.id||tr(),memory_key:n?.metadata?.memoryKey||n?.metadata?.memory_key||null,category:n?.metadata?.category||"fact",content:n?.memory||n?.content||"",source:n?.metadata?.source||"mem0",ticket_key:n?.metadata?.ticketKey||n?.metadata?.ticket_key||null,tier:Hr(n?.metadata?.tier||t,n?.metadata?.category||"fact"),relevance:Number(n?.score??n?.metadata?.relevance??.8),created_at:n?.created_at||n?.metadata?.created_at||xe()})).filter(n=>String(n.content||"").trim().length>0)}var He={id:"dolt",store:(r,t)=>ws(r,t),recall:(r,t)=>Qp(r,t),brief:(r,t)=>eu(r,t),endSession:(r,t)=>vs(r,t),logTask:(r,t)=>Is(r,t),taskHistory:(r,t)=>Ns(r,t)},Yp={id:"mem0",store:(r,t,e)=>Xp(r,t,e),recall:(r,t,e)=>Ss(r,t,e),brief:(r,t,e)=>tu(r,t,e),endSession:(r,t)=>vs(r,t),logTask:(r,t)=>Is(r,t),taskHistory:(r,t)=>Ns(r,t)},Wp={dolt:He,mem0:Yp};async function ds(r,t){let e=await Gp(r,t);return Wp[e]||He}var ks={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
682
+ `)}`}function Qt(r){return{backend:r.backend,recentSessions:r.recentSessions.slice(0,3).map(t=>({summary:er(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:er(String(t?.content||""),140),source:t?.source||null})),taskStats:r.taskStats,error:r.error||null}}async function Gp(r,t){let e=String(process.env.ZIBBY_MEMORY_BACKEND||"").trim().toLowerCase();if(e==="mem0"||e==="dolt")return e;let n=String(t?.options?.memoryBackend||t?.options?.config?.memory?.backend||"").trim().toLowerCase();if(n==="mem0"||n==="dolt")return n;if(Zt.has(r))return Zt.get(r);try{let i=ue(r,".zibby.config.mjs");if(Gr(i)){let s=await import(ht(i).href),o=String(s?.default?.memory?.backend||"").trim().toLowerCase();if(o==="mem0"||o==="dolt")return Zt.set(r,o),o}}catch{}return Zt.set(r,Fr),Fr}function gs(r){let t=String(process.env.ZIBBY_MEMORY_USER_ID||"").trim();return t||`workspace:${Dp(r||process.cwd())}`}var Hp="mem0";function bs(r){let t=ue(r,Mr,Hp);return{dir:t,vectorDbPath:ue(t,"vectors.db"),historyDbPath:ue(t,"history.db")}}function zp(r){let t=String(process.env.ZIBBY_MEM0_OPENAI_BASE_URL||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_MEM0_API_KEY||process.env.ZIBBY_USER_TOKEN||process.env.OPENAI_API_KEY||"").trim(),n=String(process.env.ZIBBY_MEM0_LLM_MODEL||"gpt-4.1-mini").trim(),i=String(process.env.ZIBBY_MEM0_EMBEDDER_MODEL||"text-embedding-3-small").trim(),s=Number(process.env.ZIBBY_MEM0_EMBEDDING_DIMS||1536),{vectorDbPath:o,historyDbPath:a}=bs(r||process.cwd());return{llm:{provider:"openai",config:{model:n,baseURL:t,...e?{apiKey:e}:{}}},embedder:{provider:"openai",config:{model:i,embeddingDims:s,baseURL:t,...e?{apiKey:e}:{}}},vectorStore:{provider:"memory",config:{dimension:s,dbPath:o}},historyDbPath:a}}async function _s(r){let t=r||process.cwd();if(Dr.has(t))return Dr.get(t);let e;try{let a=ms(ht(ue(t,"package.json")).href).resolve("mem0ai/oss");e=await import(ht(a).href)}catch{try{let o=Mp.resolve("mem0ai/oss");e=await import(ht(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 n=e?.Memory;if(!n)throw new Error("mem0ai/oss does not export Memory");let i=zp(t);if(i)try{us(bs(t).dir,{recursive:!0})}catch{}let s=i?new n(i):new n;return Dr.set(t,s),s}function ls(r,t="mid"){return(Array.isArray(r)?r:Array.isArray(r?.results)?r.results:[]).map(n=>({id:n?.id||tr(),memory_key:n?.metadata?.memoryKey||n?.metadata?.memory_key||null,category:n?.metadata?.category||"fact",content:n?.memory||n?.content||"",source:n?.metadata?.source||"mem0",ticket_key:n?.metadata?.ticketKey||n?.metadata?.ticket_key||null,tier:Hr(n?.metadata?.tier||t,n?.metadata?.category||"fact"),relevance:Number(n?.score??n?.metadata?.relevance??.8),created_at:n?.created_at||n?.metadata?.created_at||xe()})).filter(n=>String(n.content||"").trim().length>0)}var He={id:"dolt",store:(r,t)=>ks(r,t),recall:(r,t)=>Qp(r,t),brief:(r,t)=>eu(r,t),endSession:(r,t)=>vs(r,t),logTask:(r,t)=>Is(r,t),taskHistory:(r,t)=>Ns(r,t)},Yp={id:"mem0",store:(r,t,e)=>Xp(r,t,e),recall:(r,t,e)=>Ss(r,t,e),brief:(r,t,e)=>tu(r,t,e),endSession:(r,t)=>vs(r,t),logTask:(r,t)=>Is(r,t),taskHistory:(r,t)=>Ns(r,t)},Wp={dolt:He,mem0:Yp};async function ds(r,t){let e=await Gp(r,t);return Wp[e]||He}var ws={id:"chat-memory",description:"Persistent chat memory and task history (Dolt-backed)",envKeys:[],promptFragment:`## Chat Memory (persistent)
683
683
  You have persistent memory across sessions. Use it to avoid losing context:
684
684
  - **memory_store**: Save important facts, decisions, or context. Anything worth remembering.
685
685
  - **memory_recall**: Search your memory by keyword or category. Use this at the START of conversations to recall relevant context.
@@ -697,19 +697,19 @@ You have persistent memory across sessions. Use it to avoid losing context:
697
697
  ### Categories for memory_store
698
698
  fact, decision, context, insight, credential, url, error, workaround`,resolve(){return null},async buildPromptContext(r,t={}){let e=r?.options?.workspace||process.cwd(),n=ue(e,Mr),i=await ds(e,r),s=i.id;if(s==="dolt"&&!Xt(n)){let o="Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation";return{backend:s,brief:ft({backend:s,error:o},s),promptContext:"",debugPreview:Qt(ft({backend:s,error:o},s)),error:o}}try{let o=await i.brief(t,n,e),a=JSON.parse(o||"{}"),c=ft({...a,backend:s},s);return{backend:s,brief:c,promptContext:cs(c),debugPreview:Qt(c),error:c.error||null}}catch(o){if(s==="mem0"&&i!==He&&Xt(n)){if(!Vt){Vt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${o?.message||o}); degrading to dolt for this run
699
699
  `)}catch{}}try{let l=await He.brief(t,n,e),d=JSON.parse(l||"{}"),p=ft({...d,backend:"dolt"},"dolt");return{backend:"dolt",brief:p,promptContext:cs(p),debugPreview:Qt(p),error:p.error||null,degradedFrom:"mem0"}}catch{}}let a=String(o?.message||o),c=ft({backend:s,error:a},s);return{backend:s,brief:c,promptContext:"",debugPreview:Qt(c),error:a}}},async handleToolCall(r,t,e){let n=e?.options?.workspace||process.cwd(),i=ue(n,Mr),s=await ds(n,e),o=s.id;if((o==="dolt"||["memory_end_session","task_log","task_history"].includes(r))&&!Xt(i))return JSON.stringify({error:"Dolt not available. Install: brew install dolt (macOS) or see https://docs.dolthub.com/introduction/installation"});let c=l=>{switch(r){case"memory_store":return l.store(t,i,n);case"memory_recall":return l.recall(t,i,n);case"memory_brief":return l.brief(t,i,n);case"memory_end_session":return l.endSession(t,i,n);case"task_log":return l.logTask(t,i,n);case"task_history":return l.taskHistory(t,i,n);default:return JSON.stringify({error:`Unknown tool: ${r}`})}};try{return await c(s)}catch(l){if(o==="mem0"&&s!==He){if(Xt(i)){if(!Vt){Vt=!0;try{process.stderr.write(`[chat-memory] mem0 backend unavailable (${l.message}); degrading to dolt for this run
700
- `)}catch{}}try{return await c(He)}catch(d){return JSON.stringify({error:d.message,backend:"dolt",degradedFrom:"mem0"})}}return JSON.stringify({error:`mem0 unavailable (${l.message}); dolt fallback also unavailable`,backend:"mem0"})}return JSON.stringify({error:l.message})}},tools:[{name:"memory_store",description:"Save a fact, decision, or context to persistent memory. Survives across sessions.",input_schema:{type:"object",properties:{memoryKey:{type:"string",description:"Stable semantic identity key (e.g. user.jira.default_board)"},content:{type:"string",description:"The information to remember"},category:{type:"string",enum:["fact","decision","context","insight","preference","credential","url","error","workaround"],description:"Category of memory"},tier:{type:"string",enum:["short","mid","long"],description:"Memory tier: short (session/24h), mid (days/weeks), long (permanent)"},source:{type:"string",description:'Where this info came from (e.g. "jira", "github", "user", "test_run")'},ticketKey:{type:"string",description:"Related ticket key (optional)"},infer:{type:"boolean",description:"true = LLM distills/dedupes facts (costs tokens); false = store raw, embed-only, free",default:!1}},required:["content","category"]}},{name:"memory_recall",description:"Search persistent memory by keyword, category, ticket, or tier. Returns matching facts and context.",input_schema:{type:"object",properties:{query:{type:"string",description:"Search text (matches content)"},category:{type:"string",description:"Filter by category"},ticketKey:{type:"string",description:"Filter by ticket key"},tier:{type:"string",enum:["short","mid","long"],description:"Filter by memory tier"},limit:{type:"number",description:"Max results (default: 20)"}}}},{name:"memory_brief",description:"Get a compact briefing: recent session summaries + top relevant facts. Call at the start of a conversation.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Focus briefing on a specific ticket (optional)"}}}},{name:"memory_end_session",description:"End the current session and save a summary for future recall. Call when a task is complete.",input_schema:{type:"object",properties:{summary:{type:"string",description:"What happened in this session (1-3 sentences)"},tickets:{type:"string",description:"Comma-separated ticket keys covered"},tasksRun:{type:"number",description:"Number of tasks/tests run"},tasksPassed:{type:"number",description:"Number passed"},tasksFailed:{type:"number",description:"Number failed"},keyFacts:{type:"string",description:"Key facts worth remembering from this session (semicolon-separated)"}},required:["summary"]}},{name:"task_log",description:"Record a completed task (test run, analysis, generation) to persistent history.",input_schema:{type:"object",properties:{title:{type:"string",description:"Task description"},type:{type:"string",enum:["test_run","generate","analysis","research","other"],description:"Task type"},status:{type:"string",enum:["passed","failed","cancelled","error"],description:"Outcome"},ticketKey:{type:"string",description:"Related ticket key"},specPath:{type:"string",description:"Spec file path (if test run)"},resultSummary:{type:"string",description:"Brief result description"}},required:["title","type","status"]}},{name:"task_history",description:"Query past tasks by ticket, status, or type. See what was done before.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Filter by ticket key"},type:{type:"string",description:"Filter by task type"},status:{type:"string",description:"Filter by status"},limit:{type:"number",description:"Max results (default: 20)"}}}}]};function ws(r,t){let{content:e,category:n,source:i,ticketKey:s,tier:o,memoryKey:a}=r;if(!e||!n)return JSON.stringify({error:"content and category are required"});let c=Kr(e);if(!c)return JSON.stringify({error:"content is empty after normalization"});let l=Hr(o,n),d=l==="long"?1:l==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let y=ve(t,`SELECT id, tier, relevance
700
+ `)}catch{}}try{return await c(He)}catch(d){return JSON.stringify({error:d.message,backend:"dolt",degradedFrom:"mem0"})}}return JSON.stringify({error:`mem0 unavailable (${l.message}); dolt fallback also unavailable`,backend:"mem0"})}return JSON.stringify({error:l.message})}},tools:[{name:"memory_store",description:"Save a fact, decision, or context to persistent memory. Survives across sessions.",input_schema:{type:"object",properties:{memoryKey:{type:"string",description:"Stable semantic identity key (e.g. user.jira.default_board)"},content:{type:"string",description:"The information to remember"},category:{type:"string",enum:["fact","decision","context","insight","preference","credential","url","error","workaround"],description:"Category of memory"},tier:{type:"string",enum:["short","mid","long"],description:"Memory tier: short (session/24h), mid (days/weeks), long (permanent)"},source:{type:"string",description:'Where this info came from (e.g. "jira", "github", "user", "test_run")'},ticketKey:{type:"string",description:"Related ticket key (optional)"},infer:{type:"boolean",description:"true = LLM distills/dedupes facts (costs tokens); false = store raw, embed-only, free",default:!1}},required:["content","category"]}},{name:"memory_recall",description:"Search persistent memory by keyword, category, ticket, or tier. Returns matching facts and context.",input_schema:{type:"object",properties:{query:{type:"string",description:"Search text (matches content)"},category:{type:"string",description:"Filter by category"},ticketKey:{type:"string",description:"Filter by ticket key"},tier:{type:"string",enum:["short","mid","long"],description:"Filter by memory tier"},limit:{type:"number",description:"Max results (default: 20)"}}}},{name:"memory_brief",description:"Get a compact briefing: recent session summaries + top relevant facts. Call at the start of a conversation.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Focus briefing on a specific ticket (optional)"}}}},{name:"memory_end_session",description:"End the current session and save a summary for future recall. Call when a task is complete.",input_schema:{type:"object",properties:{summary:{type:"string",description:"What happened in this session (1-3 sentences)"},tickets:{type:"string",description:"Comma-separated ticket keys covered"},tasksRun:{type:"number",description:"Number of tasks/tests run"},tasksPassed:{type:"number",description:"Number passed"},tasksFailed:{type:"number",description:"Number failed"},keyFacts:{type:"string",description:"Key facts worth remembering from this session (semicolon-separated)"}},required:["summary"]}},{name:"task_log",description:"Record a completed task (test run, analysis, generation) to persistent history.",input_schema:{type:"object",properties:{title:{type:"string",description:"Task description"},type:{type:"string",enum:["test_run","generate","analysis","research","other"],description:"Task type"},status:{type:"string",enum:["passed","failed","cancelled","error"],description:"Outcome"},ticketKey:{type:"string",description:"Related ticket key"},specPath:{type:"string",description:"Spec file path (if test run)"},resultSummary:{type:"string",description:"Brief result description"}},required:["title","type","status"]}},{name:"task_history",description:"Query past tasks by ticket, status, or type. See what was done before.",input_schema:{type:"object",properties:{ticketKey:{type:"string",description:"Filter by ticket key"},type:{type:"string",description:"Filter by task type"},status:{type:"string",description:"Filter by status"},limit:{type:"number",description:"Max results (default: 20)"}}}}]};function ks(r,t){let{content:e,category:n,source:i,ticketKey:s,tier:o,memoryKey:a}=r;if(!e||!n)return JSON.stringify({error:"content and category are required"});let c=Kr(e);if(!c)return JSON.stringify({error:"content is empty after normalization"});let l=Hr(o,n),d=l==="long"?1:l==="mid"?.8:.5,p=String(a||"").trim().slice(0,160);if(p){let y=ve(t,`SELECT id, tier, relevance
701
701
  FROM chat_memory
702
702
  WHERE memory_key = ${S(p)}
703
703
  ORDER BY created_at DESC
704
- LIMIT 1`)[0];if(y){let b=String(y.tier||"mid"),g=Number(y.relevance||0),k=Ge(l)>Ge(b)?l:b,O=Math.max(d,g);H(t,`UPDATE chat_memory
704
+ LIMIT 1`)[0];if(y){let b=String(y.tier||"mid"),g=Number(y.relevance||0),w=Ge(l)>Ge(b)?l:b,O=Math.max(d,g);H(t,`UPDATE chat_memory
705
705
  SET content = ${S(e)},
706
706
  category = ${S(n)},
707
707
  source = ${S(i)},
708
708
  ticket_key = ${S(s)},
709
- tier = ${S(k)},
709
+ tier = ${S(w)},
710
710
  relevance = ${O},
711
711
  created_at = ${S(xe())}
712
- WHERE id = ${S(y.id)}`);try{G(t,["add","."]),G(t,["commit","-m",`memory upsert: ${n} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:y.id,category:n,tier:k,memoryKey:p,upserted:!0})}}let m=ve(t,`SELECT id, content, tier, relevance
712
+ WHERE id = ${S(y.id)}`);try{G(t,["add","."]),G(t,["commit","-m",`memory upsert: ${n} \u2014 ${String(e).slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:y.id,category:n,tier:w,memoryKey:p,upserted:!0})}}let m=ve(t,`SELECT id, content, tier, relevance
713
713
  FROM chat_memory
714
714
  WHERE category = ${S(n)}
715
715
  ORDER BY created_at DESC
@@ -725,7 +725,7 @@ fact, decision, context, insight, credential, url, error, workaround`,resolve(){
725
725
  WHERE tier = 'long' ${s} ORDER BY relevance DESC, created_at DESC LIMIT 10`),a=ve(t,`SELECT memory_key, category, content, source, tier, relevance, created_at FROM chat_memory
726
726
  WHERE tier = 'mid' ${s} ORDER BY relevance DESC, created_at DESC LIMIT 8`),l=ve(t,`SELECT type, status, COUNT(*) as cnt FROM chat_tasks
727
727
  GROUP BY type, status ORDER BY cnt DESC LIMIT 10`),d=ys([...o,...a]);return JSON.stringify({recentSessions:i,topMemories:d,taskStats:l,ticketFilter:e||null})}async function tu(r,t,e){let{ticketKey:n}=r,i=await Ss({limit:80},t,e),s=JSON.parse(i||"{}"),o=Array.isArray(s.memories)?s.memories:[];n&&(o=o.filter(u=>u.ticket_key===n));let a=u=>{let m=Date.parse(String(u?.created_at||""))||0;return Number(u?.relevance||0)*1e12+m},c=(u,m)=>a(m)-a(u),l=o.filter(u=>u.tier==="long").sort(c).slice(0,10),d=o.filter(u=>u.tier==="mid").sort(c).slice(0,8),p=ys([...l,...d]);return JSON.stringify({recentSessions:[],topMemories:p,taskStats:[],ticketFilter:n||null,backend:"mem0"})}function vs(r,t){let{summary:e,tickets:n,tasksRun:i=0,tasksPassed:s=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_${tr()}`;if(H(t,`INSERT INTO chat_sessions (session_id, summary, tickets, tasks_run, tasks_passed, tasks_failed, key_facts, created_at)
728
- VALUES (${S(c)}, ${S(e)}, ${S(n)}, ${i}, ${s}, ${o}, ${S(a)}, ${S(xe())})`),a)for(let l of a.split(";").map(d=>d.trim()).filter(Boolean))ws({content:l,category:"fact",source:"session_summary",tier:"mid"},t);ru(t);try{G(t,["add","."]),G(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:c,summary:e.slice(0,200)})}function Is(r,t){let{title:e,type:n,status:i,ticketKey:s,specPath:o,resultSummary:a}=r;if(!e||!n||!i)return JSON.stringify({error:"title, type, and status are required"});let c=tr(),l=process.env.ZIBBY_CHAT_SESSION_ID||null;H(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
728
+ VALUES (${S(c)}, ${S(e)}, ${S(n)}, ${i}, ${s}, ${o}, ${S(a)}, ${S(xe())})`),a)for(let l of a.split(";").map(d=>d.trim()).filter(Boolean))ks({content:l,category:"fact",source:"session_summary",tier:"mid"},t);ru(t);try{G(t,["add","."]),G(t,["commit","-m",`session end: ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,sessionId:c,summary:e.slice(0,200)})}function Is(r,t){let{title:e,type:n,status:i,ticketKey:s,specPath:o,resultSummary:a}=r;if(!e||!n||!i)return JSON.stringify({error:"title, type, and status are required"});let c=tr(),l=process.env.ZIBBY_CHAT_SESSION_ID||null;H(t,`INSERT INTO chat_tasks (id, ticket_key, type, title, status, spec_path, session_id, result_summary, created_at, finished_at)
729
729
  VALUES (${S(c)}, ${S(s)}, ${S(n)}, ${S(e)}, ${S(i)}, ${S(o)}, ${S(l)}, ${S(a)}, ${S(xe())}, ${S(xe())})`);try{G(t,["add","."]),G(t,["commit","-m",`task: ${i} \u2014 ${e.slice(0,60)}`])}catch{}return JSON.stringify({ok:!0,id:c,title:e,type:n,status:i})}function Ns(r,t){let{ticketKey:e,type:n,status:i,limit:s=20}=r,o=[];e&&o.push(`ticket_key = ${S(e)}`),n&&o.push(`type = ${S(n)}`),i&&o.push(`status = ${S(i)}`);let c=`SELECT id, ticket_key, type, title, status, spec_path, result_summary, created_at, finished_at
730
730
  FROM chat_tasks ${o.length>0?`WHERE ${o.join(" AND ")}`:""}
731
731
  ORDER BY created_at DESC LIMIT ${s}`,l=ve(t,c);return JSON.stringify({total:l.length,tasks:l})}function ru(r){try{H(r,"UPDATE chat_memory SET relevance = relevance * 0.98 WHERE tier = 'long' AND relevance > 0.5"),H(r,"UPDATE chat_memory SET relevance = relevance * 0.90 WHERE tier = 'mid' AND relevance > 0.1"),H(r,"UPDATE chat_memory SET relevance = relevance * 0.70 WHERE tier = 'short' AND relevance > 0.05"),H(r,"DELETE FROM chat_memory WHERE relevance < 0.05")}catch{}}function nu(r){try{let t=new Date(Date.now()-864e5).toISOString();H(r,`DELETE FROM chat_memory WHERE tier = 'short' AND created_at < ${S(t)}`)}catch{}}import{existsSync as Os,readFileSync as iu}from"node:fs";import{homedir as su}from"node:os";import{join as ou,dirname as au,resolve as cu}from"node:path";import{fileURLToPath as lu}from"node:url";function du(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=au(lu(import.meta.url)),t=cu(r,"..","bin","mcp-skill.mjs");return Os(t)?t:null}function pu(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=ou(su(),".zibby","config.json");return Os(r)&&JSON.parse(iu(r,"utf-8")).sessionToken||null}catch{return null}}function uu(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function mu(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function zr(r){return`${mu()}:${r}`}async function Yr(r,t){let e=pu();if(!e)throw new Error("No backend credential (PROJECT_API_TOKEN). KV memory is only available inside a Zibby run.");let n=`${uu()}/credits/review-memory`,i=await fetch(n,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({op:r,...t})});if(!i.ok){let s=await i.text().catch(()=>"");throw new Error(`KV memory ${r} failed (${i.status}): ${s.slice(0,300)}`)}return i.json()}var Ts={id:"kv-memory",callsBackend:!0,serverName:"kv_memory",allowedTools:["mcp__kv_memory__*"],description:"KV memory \u2014 a private, per-agent persistent key\u2192value store across stateless runs (auto-namespaced)",promptFragment:`## KV Memory (private, per-agent, persistent key-value store)
@@ -743,7 +743,7 @@ Tools:
743
743
  Use to record durable facts \u2014 e.g. dedup markers, prior decisions, summaries.
744
744
 
745
745
  Your namespace is added for you automatically; pass plain keys like
746
- "seen#owner/repo#42" or "lastRun".`,resolve(){let r=du();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/kvMemory.js","kvMemorySkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"kv_recall":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});let n=await Yr("recall",{scope:zr(e)});return JSON.stringify(n)}case"kv_recall_prefix":{let e=typeof t?.keyPrefix=="string"?t.keyPrefix.trim():"";if(!e)return JSON.stringify({error:"keyPrefix is required"});let n=await Yr("recall-prefix",{scopePrefix:zr(e)});return JSON.stringify(n)}case"kv_store":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});if(typeof t?.content!="string"||t.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let n={scope:zr(e),content:t.content};t.metadata!=null&&(n.metadata=t.metadata);let i=await Yr("store",n);return JSON.stringify(i)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"kv_recall",description:'Recall the value you stored under a plain key (exact match). Your per-agent namespace is added automatically \u2014 pass a plain key like "seen#owner/repo#42".',input_schema:{type:"object",properties:{key:{type:"string",description:'Plain storage key (no namespace prefix needed) \u2014 e.g. "seen#owner/repo#42" or "lastRun".'}},required:["key"]}},{name:"kv_recall_prefix",description:'List your entries whose plain key STARTS WITH a prefix (e.g. "seen#"). Your per-agent namespace is added automatically. Capped at 25.',input_schema:{type:"object",properties:{keyPrefix:{type:"string",description:'Plain key prefix to match (no namespace prefix needed) \u2014 e.g. "seen#".'}},required:["keyPrefix"]}},{name:"kv_store",description:"Store (overwrite) a value under a plain key so a later run of yours can recall it. Your per-agent namespace is added automatically.",input_schema:{type:"object",properties:{key:{type:"string",description:"Plain storage key (no namespace prefix needed). Same key you recall by."},content:{type:"string",description:"The value to persist. Free-form markdown/text."},metadata:{type:"object",description:"Optional structured metadata."}},required:["key","content"]}}]};import{existsSync as As,readFileSync as fu}from"node:fs";import{homedir as hu}from"node:os";import{join as yu,dirname as gu,resolve as bu}from"node:path";import{fileURLToPath as _u}from"node:url";function ku(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=gu(_u(import.meta.url)),t=bu(r,"..","bin","mcp-skill.mjs");return As(t)?t:null}function Es(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=yu(hu(),".zibby","config.json");return As(r)&&JSON.parse(fu(r,"utf-8")).sessionToken||null}catch{return null}}function xs(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function Rs(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function wu(){let r={};for(let[t,e]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(t);if(!n)continue;let i=typeof e=="string"?e.trim():"";i&&(r[n[1]]=i)}return r}var js={};function je(r){let t={...wu(),...js},e=Object.keys(t),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(t,n)?{storeId:t[n],name:n}:{error:`unknown store '${n}'; available: ${e.join(", ")}`}:e.length===1?{storeId:t[e[0]],name:e[0]}:e.length===0?{error:"no stores bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${e.join(", ")})`}}async function Su(r){let t=Es();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Stores are only available inside a Zibby run.");let e=await fetch(`${xs()}/datasets/stores/ensure`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`ensure_store failed (${e.status}): ${n.slice(0,300)}`)}return e.json()}async function me(r,t,e){let n=Es();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Dataset store is only available inside a Zibby run.");let i=`${xs()}/datasets/stores/${encodeURIComponent(r)}/${t}`,s=await fetch(i,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Store ${t} failed (${s.status}): ${o.slice(0,300)}`)}return s.json()}var vu=Math.floor(3.5*1024*1024);async function Iu(r,t,e,n){let i=await me(r,"put-url",{path:t,contentType:n});if(!i?.url)throw new Error("put-url did not return an upload URL");let s=await fetch(i.url,{method:i.method||"PUT",headers:i.headers||{"Content-Type":n},body:e});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`direct upload failed (${s.status}): ${o.slice(0,200)}`)}return{ok:!0,path:i.path||t,size:e.length,contentType:i.contentType||n,via:"presign"}}async function Nu(r,t){let e=await me(r,"get-url",{path:t});if(!e?.url)throw new Error("get-url did not return a download URL");let n=await fetch(e.url,{method:e.method||"GET"});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`direct download failed (${n.status}): ${s.slice(0,200)}`)}let i=await n.arrayBuffer();return{buf:Buffer.from(i),contentType:n.headers.get("content-type")||"application/octet-stream"}}var Ls={id:"dataset-store",callsBackend:!0,serverName:"dataset_store",allowedTools:["mcp__dataset_store__*"],description:"Dataset store \u2014 a durable, queryable store for structured JSON records; append rows now, run SQL-style aggregations/reports later",promptFragment:`## Dataset Store (durable, queryable structured-record store)
746
+ "seen#owner/repo#42" or "lastRun".`,resolve(){let r=du();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/kvMemory.js","kvMemorySkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"kv_recall":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});let n=await Yr("recall",{scope:zr(e)});return JSON.stringify(n)}case"kv_recall_prefix":{let e=typeof t?.keyPrefix=="string"?t.keyPrefix.trim():"";if(!e)return JSON.stringify({error:"keyPrefix is required"});let n=await Yr("recall-prefix",{scopePrefix:zr(e)});return JSON.stringify(n)}case"kv_store":{let e=typeof t?.key=="string"?t.key.trim():"";if(!e)return JSON.stringify({error:"key is required"});if(typeof t?.content!="string"||t.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let n={scope:zr(e),content:t.content};t.metadata!=null&&(n.metadata=t.metadata);let i=await Yr("store",n);return JSON.stringify(i)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"kv_recall",description:'Recall the value you stored under a plain key (exact match). Your per-agent namespace is added automatically \u2014 pass a plain key like "seen#owner/repo#42".',input_schema:{type:"object",properties:{key:{type:"string",description:'Plain storage key (no namespace prefix needed) \u2014 e.g. "seen#owner/repo#42" or "lastRun".'}},required:["key"]}},{name:"kv_recall_prefix",description:'List your entries whose plain key STARTS WITH a prefix (e.g. "seen#"). Your per-agent namespace is added automatically. Capped at 25.',input_schema:{type:"object",properties:{keyPrefix:{type:"string",description:'Plain key prefix to match (no namespace prefix needed) \u2014 e.g. "seen#".'}},required:["keyPrefix"]}},{name:"kv_store",description:"Store (overwrite) a value under a plain key so a later run of yours can recall it. Your per-agent namespace is added automatically.",input_schema:{type:"object",properties:{key:{type:"string",description:"Plain storage key (no namespace prefix needed). Same key you recall by."},content:{type:"string",description:"The value to persist. Free-form markdown/text."},metadata:{type:"object",description:"Optional structured metadata."}},required:["key","content"]}}]};import{existsSync as As,readFileSync as fu}from"node:fs";import{homedir as hu}from"node:os";import{join as yu,dirname as gu,resolve as bu}from"node:path";import{fileURLToPath as _u}from"node:url";function wu(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=gu(_u(import.meta.url)),t=bu(r,"..","bin","mcp-skill.mjs");return As(t)?t:null}function Es(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=yu(hu(),".zibby","config.json");return As(r)&&JSON.parse(fu(r,"utf-8")).sessionToken||null}catch{return null}}function xs(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function Rs(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function ku(){let r={};for(let[t,e]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(t);if(!n)continue;let i=typeof e=="string"?e.trim():"";i&&(r[n[1]]=i)}return r}var js={};function je(r){let t={...ku(),...js},e=Object.keys(t),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(t,n)?{storeId:t[n],name:n}:{error:`unknown store '${n}'; available: ${e.join(", ")}`}:e.length===1?{storeId:t[e[0]],name:e[0]}:e.length===0?{error:"no stores bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${e.join(", ")})`}}async function Su(r){let t=Es();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Stores are only available inside a Zibby run.");let e=await fetch(`${xs()}/datasets/stores/ensure`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`ensure_store failed (${e.status}): ${n.slice(0,300)}`)}return e.json()}async function me(r,t,e){let n=Es();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Dataset store is only available inside a Zibby run.");let i=`${xs()}/datasets/stores/${encodeURIComponent(r)}/${t}`,s=await fetch(i,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`Store ${t} failed (${s.status}): ${o.slice(0,300)}`)}return s.json()}var vu=Math.floor(3.5*1024*1024);async function Iu(r,t,e,n){let i=await me(r,"put-url",{path:t,contentType:n});if(!i?.url)throw new Error("put-url did not return an upload URL");let s=await fetch(i.url,{method:i.method||"PUT",headers:i.headers||{"Content-Type":n},body:e});if(!s.ok){let o=await s.text().catch(()=>"");throw new Error(`direct upload failed (${s.status}): ${o.slice(0,200)}`)}return{ok:!0,path:i.path||t,size:e.length,contentType:i.contentType||n,via:"presign"}}async function Nu(r,t){let e=await me(r,"get-url",{path:t});if(!e?.url)throw new Error("get-url did not return a download URL");let n=await fetch(e.url,{method:e.method||"GET"});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`direct download failed (${n.status}): ${s.slice(0,200)}`)}let i=await n.arrayBuffer();return{buf:Buffer.from(i),contentType:n.headers.get("content-type")||"application/octet-stream"}}var Ls={id:"dataset-store",callsBackend:!0,serverName:"dataset_store",allowedTools:["mcp__dataset_store__*"],description:"Dataset store \u2014 a durable, queryable store for structured JSON records; append rows now, run SQL-style aggregations/reports later",promptFragment:`## Dataset Store (durable, queryable structured-record store)
747
747
  You have one or more durable stores for STRUCTURED records that survive across
748
748
  your stateless runs. Unlike key-value memory (for picking up where you left
749
749
  off), this is for accumulating DATA you want to QUERY and AGGREGATE later \u2014 e.g.
@@ -790,7 +790,7 @@ Tools:
790
790
  - file_list: (file stores) List stored files (optionally by path prefix).
791
791
  - file_delete: (file stores) Delete ONE file by path.
792
792
  Pick the tool that matches the store's TYPE; using a dataset tool on a sqlite
793
- store (or a file tool on either, etc.) is rejected.`,resolve(){let r=ku();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);for(let e of Object.keys(process.env))/^ZIBBY_STORE__.+$/.test(e)&&process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/datasetStore.js","datasetStoreSkill"],env:t,description:this.description,alwaysLoad:!1}},async handleToolCall(r,t){try{switch(r){case"dataset_append":{if(t?.record==null||typeof t.record!="object"||Array.isArray(t.record))return JSON.stringify({error:"record is required (a JSON object)"});let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n=typeof t?.agent=="string"&&t.agent.trim()?t.agent.trim():Rs(),i={record:t.record,agent:n};typeof t?.description=="string"&&t.description.trim()&&(i.description=t.description.trim());let s=await me(e.storeId,"append",i);return JSON.stringify({...s,store:e.name,storeId:e.storeId})}case"dataset_query":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n={};for(let s of["select","where","groupBy","orderBy","limit","since","until","agent"])t?.[s]!=null&&(n[s]=t[s]);let i=await me(e.storeId,"query",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}case"ensure_store":{let e=typeof t?.name=="string"?t.name.trim():"";if(!e)return JSON.stringify({error:"name is required"});let n=typeof t?.type=="string"&&t.type.trim()?t.type.trim().toLowerCase():"sqlite",i=typeof t?.description=="string"?t.description.trim():"",s=await Su({name:e,type:n,description:i,namespace:Rs()});return s?.storeId&&(js[e]=s.storeId),JSON.stringify({...s,store:e})}case"file_put":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:'path is required (a relative file path like "reports/2026-07.json")'});let n=typeof t?.content=="string",i=typeof t?.contentBase64=="string"&&t.contentBase64.length>0;if(!n&&!i)return JSON.stringify({error:"content (text) or contentBase64 (base64 bytes) is required"});let s=t.path.trim(),o=typeof t?.contentType=="string"&&t.contentType.trim()?t.contentType.trim():"",a=n?Buffer.from(t.content,"utf8"):Buffer.from(String(t.contentBase64).replace(/\s+/g,""),"base64");if(a.length>vu){let d=o||(n?"text/plain; charset=utf-8":"application/octet-stream"),p=await Iu(e.storeId,s,a,d);return JSON.stringify({...p,store:e.name,storeId:e.storeId})}let c={path:s};n?c.content=t.content:c.contentBase64=t.contentBase64,o&&(c.contentType=o);let l=await me(e.storeId,"put",c);return JSON.stringify({...l,store:e.name,storeId:e.storeId})}case"file_get":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:"path is required"});let n=t.path.trim(),i;try{i=await me(e.storeId,"get",{path:n})}catch(c){if(!/failed \(413\)/.test(c?.message||""))throw c;let l=await Nu(e.storeId,n);i={path:n,size:l.buf.length,contentType:l.contentType,lastModified:null,contentBase64:l.buf.toString("base64")}}let s={ok:!0,store:e.name,storeId:e.storeId,path:i.path,size:i.size,contentType:i.contentType,lastModified:i.lastModified},o=Buffer.from(i.contentBase64||"","base64"),a=o.toString("utf8");return Buffer.compare(Buffer.from(a,"utf8"),o)===0&&!a.includes("\0")?(s.content=a,s.encoding="utf8"):(s.contentBase64=i.contentBase64,s.encoding="base64"),JSON.stringify(s)}case"file_list":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n={};typeof t?.prefix=="string"&&t.prefix.trim()&&(n.prefix=t.prefix.trim()),t?.limit!=null&&(n.limit=t.limit),typeof t?.cursor=="string"&&t.cursor&&(n.cursor=t.cursor);let i=await me(e.storeId,"list",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}case"file_delete":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:"path is required"});let n=await me(e.storeId,"delete",{path:t.path.trim()});return JSON.stringify({...n,store:e.name,storeId:e.storeId})}case"sqlite_exec":case"sqlite_query":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.sql!="string"||!t.sql.trim())return JSON.stringify({error:"sql is required (a non-empty SQL string)"});let n={sql:t.sql};r==="sqlite_query"&&(n.readOnly=!0),Array.isArray(t?.params)&&(n.params=t.params);let i=await me(e.storeId,"sql",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"dataset_append",description:"Append ONE structured JSON record to a bound store, durably. Records persist across your stateless runs and are auto-tagged with your agent type so you can filter to your own writes later. Use to accumulate data you will query/aggregate (e.g. per-run metrics, processed items). Append ONE record per call.",input_schema:{type:"object",properties:{store:{type:"string",description:'The logical store NAME to write to (e.g. "scorecards"), taken from the AVAILABLE STORES list \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this and it defaults to that store; you can ONLY write to a bound store name.'},record:{type:"object",description:'An arbitrary JSON object \u2014 one row of data. Its keys become queryable fields (e.g. {"repo":"owner/x","stars":1200}). One record per call.'},description:{type:"string",description:"Optional, informational note about this write. The store already exists from deploy, so this is not required and does not create anything."},agent:{type:"string",description:"Optional writing-agent tag. Defaults to your own agent type \u2014 leave unset to auto-tag."}},required:["record"]}},{name:"dataset_query",description:"Run a SQL-style query over a bound store to build reports: select/aggregate (count|sum|avg|min|max), filter, group, order, limit, and bound by month. Returns { columns, rows }. Use this to compute summaries/aggregations from records you appended earlier.",input_schema:{type:"object",properties:{store:{type:"string",description:'The logical store NAME to query (e.g. "scorecards"), taken from the AVAILABLE STORES list \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this and it defaults to that store.'},select:{type:"array",description:"Columns to return. Each item is { field?, agg?, as? }. agg \u2208 count|sum|avg|min|max; omit field for count(*). Omit `select` entirely to return raw rows."},where:{type:"array",description:"Filters, ANDed. Each item is { field, op, value }; op \u2208 eq|ne|gt|gte|lt|lte|like. `field` is a JSON key of the stored record."},groupBy:{type:"array",description:"Field names to group by (array of strings) for aggregation."},orderBy:{type:"array",description:"Sort spec. Each item is { field|as, dir }; dir \u2208 asc|desc."},limit:{type:"number",description:"Maximum number of rows to return."},since:{type:"string",description:"Inclusive lower bound month, 'yyyy-MM' (e.g. '2026-01')."},until:{type:"string",description:"Inclusive upper bound month, 'yyyy-MM' (e.g. '2026-06')."},agent:{type:"string",description:"Filter to records written by one agent namespace. Omit to query across all writers."}},required:[]}},{name:"ensure_store",description:'Create (or reuse) a store ON DEMAND for THIS agent \u2014 use when you need a store that was NOT declared/bound at deploy. Idempotent by name and private to this agent: calling again with the same name returns the SAME store (safe to call at the start of every run). Returns { storeId }. For type "sqlite" you then define schema with sqlite_exec (CREATE TABLE IF NOT EXISTS) and read/write via sqlite_exec/sqlite_query using this name.',input_schema:{type:"object",properties:{name:{type:"string",description:'A short logical name for the store (e.g. "linkedin_posts"). Letters, digits, _ and - only.'},type:{type:"string",enum:["sqlite","dataset","file"],description:'Store type. "sqlite" (default) = a mutable relational DB whose schema YOU define with SQL. "dataset" = append-only JSON records for later aggregation/analytics. "file" = arbitrary file/blob storage by relative path (file_put/file_get/file_list/file_delete).'},description:{type:"string",description:"What this store is for (shown in the Storage UI)."}},required:["name"]}},{name:"sqlite_exec",description:"For SQLITE-type stores: run SQL that CHANGES data \u2014 CREATE TABLE (use IF NOT EXISTS), INSERT, UPDATE, DELETE (one or more statements in one call). The store is a real, mutable SQLite database that persists across your stateless runs. Returns { rowsModified, wrote }. Use this to build schema on the fly and to update rows / track changing state (e.g. a queue with a status column).",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a sqlite-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},sql:{type:"string",description:'The SQL to run. May contain multiple statements separated by ";". Prefer CREATE TABLE IF NOT EXISTS for idempotent schema.'},params:{type:"array",description:'Optional positional bind params for a SINGLE parameterized statement (safe binding of values), e.g. sql "UPDATE t SET s=? WHERE id=?" with params ["done", 1].'}},required:["sql"]}},{name:"sqlite_query",description:"For SQLITE-type stores: run a read-only SELECT (optionally with `params` for safe binding) against the store's SQLite database. Returns { columns, rows }. Never changes data. Use to read back rows/state you stored earlier.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a sqlite-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},sql:{type:"string",description:"A single SELECT statement. Use ? placeholders + `params` for any values."},params:{type:"array",description:'Optional positional bind params for the SELECT, e.g. ["linkedin_personal"].'}},required:["sql"]}},{name:"file_put",description:"For FILE-type stores: write (or overwrite) ONE file at a relative path \u2014 raw JSON dumps, CSVs, images, snapshots, any blob you want to keep across your stateless runs. Text goes in `content`; binary goes base64-encoded in `contentBase64` (pass exactly one). SIZE: there is no practical limit \u2014 anything over ~3.5 MiB is streamed straight to object storage via a presigned URL automatically, so do NOT gzip, base64-wrap, chunk or split a file just to make it fit. Non-ASCII paths (e.g. \u4E2A\u4EBA\u62A5\u544A.html) are fine \u2014 do not transliterate. Overwriting the same path UPDATES the file. Returns { ok, path, size }.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},path:{type:"string",description:'Relative file path, e.g. "dumps/run-42.json" or "img/chart.png". Letters, digits, ".", "_", "-" and "/" only; no "..", no leading "/".'},content:{type:"string",description:"Text content (UTF-8). Use for JSON/CSV/text files."},contentBase64:{type:"string",description:"Base64-encoded binary content (images etc.). Alternative to `content`."},contentType:{type:"string",description:'Optional MIME type (e.g. "application/json", "image/png"). Defaults sensibly.'}},required:["path"]}},{name:"file_get",description:'For FILE-type stores: read ONE stored file back by its relative path. Text files come back as `content` (encoding "utf8"); binary files come back as `contentBase64` (encoding "base64"). Returns { path, size, contentType, lastModified, content|contentBase64, encoding }.',input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},path:{type:"string",description:"The relative file path to fetch (as listed by file_list / used in file_put)."}},required:["path"]}},{name:"file_list",description:'For FILE-type stores: list the stored files \u2014 each entry has { path, size, lastModified }. Optionally filter by a path `prefix` (e.g. "dumps/"). Paginated via `cursor` when there are more results.',input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},prefix:{type:"string",description:'Optional path prefix filter, e.g. "dumps/" or "reports/2026".'},limit:{type:"number",description:"Max entries to return (default/max 1000)."},cursor:{type:"string",description:"Pagination cursor from a previous file_list response (nextCursor)."}},required:[]}},{name:"file_delete",description:"For FILE-type stores: delete ONE stored file by its relative path. Returns { ok, path, deleted }. Errors if the path does not exist.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},path:{type:"string",description:"The relative file path to delete."}},required:["path"]}}]};import{SKILL_META as dm}from"@zibby/skill-ids";import{existsSync as Zs,readFileSync as pm}from"node:fs";import{homedir as um}from"node:os";import{join as mm,dirname as fm,resolve as hm}from"node:path";import{fileURLToPath as ym}from"node:url";import{existsSync as Ou}from"node:fs";import{dirname as Tu,resolve as Ru}from"node:path";import{fileURLToPath as Au}from"node:url";var Q={ZERO_WIDTH:"zero-width-bar",ROW_COUNT:"data-row-count",ROW_MISSING:"data-row-missing",BAR_COUNT:"data-bar-count",BAR_PROPORTION:"bar-proportion",VALUE_MISMATCH:"data-value-mismatch",PLACEHOLDER_TEXT:"placeholder-text",OVERFLOW:"overflow-clipped"},Eu=5,xu=20,ju=.04,Lu=3,$u=.5;function ae(r,t){if(t==null||t<0)return null;let e=1;for(let n=0;n<t&&n<r.length;n+=1)r.charCodeAt(n)===10&&(e+=1);return e}function ce(r,t,e){let n=t[e.code]||0;n>=Eu||r.length>=xu||(t[e.code]=n+1,r.push(e))}var Pu={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",ndash:"\u2013",mdash:"\u2014",hellip:"\u2026"};function Cs(r){return String(r).replace(/&(#x?[0-9a-f]+|[a-z]+);/gi,(t,e)=>{if(e[0]==="#"){let i=e[1]==="x"||e[1]==="X"?parseInt(e.slice(2),16):parseInt(e.slice(1),10);return Number.isFinite(i)?String.fromCodePoint(i):t}let n=Pu[String(e).toLowerCase()];return n??t})}function ze(r){return Cs(String(r??"")).replace(/\s+/g," ").trim().toLowerCase()}function $s(r){return Math.round(r*10)/10}var Cu=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),Zr=new Set(["script","style","textarea"]),Uu=new Set(["span","a","em","strong","b","i","u","s","small","code","label","abbr","cite","q","sub","sup","mark","time","var","kbd","samp","font","tt"]),Bu=/^<\s*(\/?)\s*([a-zA-Z][a-zA-Z0-9:_.-]*)((?:"[^"]*"|'[^']*'|[^>"'])*?)(\/?)>/;function Ju(r){let t={},e=/([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'=<>`]+))|([a-zA-Z_:][-a-zA-Z0-9_:.]*)/g,n;for(;(n=e.exec(r))!==null;)n[1]?t[n[1].toLowerCase()]=n[3]!=null?n[3]:n[4]!=null?n[4]:n[5]==null?"":n[5]:n[6]&&(t[n[6].toLowerCase()]="");return t}function Du(r){let t={tag:"#root",attrs:{},children:[],parent:null,start:0},e=t,n=[t],i=0,s=(o,a)=>{if(a<=o)return;let c=r.slice(o,a);c.trim()&&e.children.push({tag:"#text",attrs:{},children:[],parent:e,start:o,value:c})};for(;i<r.length;){let o=r.indexOf("<",i);if(o<0){s(i,r.length);break}if(s(i,o),r.startsWith("<!--",o)){let p=r.indexOf("-->",o);i=p<0?r.length:p+3;continue}if(r.startsWith("<!",o)||r.startsWith("<?",o)){let p=r.indexOf(">",o);i=p<0?r.length:p+1;continue}let a=Bu.exec(r.slice(o));if(!a){i=o+1;continue}let c=a[0],l=a[2].toLowerCase();if(a[1]){for(let p=n.length-1;p>0;p-=1)if(n[p].tag===l){n.length=p,e=n[p-1];break}i=o+c.length;continue}let d={tag:l,attrs:Ju(a[3]||""),children:[],parent:e,start:o};if(e.children.push(d),i=o+c.length,!(a[4]||Cu.has(l))){if(Zr.has(l)){let p=r.slice(i),u=new RegExp(`</\\s*${l}\\s*>`,"i").exec(p);d.raw=u?p.slice(0,u.index):p,i+=u?u.index+u[0].length:p.length;continue}n.push(d),e=d}}return t}function Le(r,t){for(let e of r.children)e.tag!=="#text"&&(t(e),Le(e,t))}function nr(r){let t=[],e=n=>{for(let i of n.children)i.tag==="#text"?t.push(i.value||""):(t.push(" "),e(i),t.push(" "))};return e(r),ze(t.join(""))}function qu(r){let t=[],e=n=>{for(let i of n.children)i.tag==="#text"?t.push({value:i.value||"",start:i.start,parent:n}):i.tag!=="pre"&&i.tag!=="code"&&e(i)};return e(r),t}function yt(r){let t={};for(let e of String(r||"").split(";")){let n=e.indexOf(":");n<0||(t[e.slice(0,n).trim().toLowerCase()]=e.slice(n+1).trim().replace(/\s*!important$/i,""))}return t}function Mu(r){let t=[];return Le(r,e=>{if(e.tag!=="style"||!e.raw)return;let n=e.raw.replace(/@[a-z-]+[^{]*\{/gi," "),i=/([^{}]+)\{([^{}]*)\}/g,s;for(;(s=i.exec(n))!==null;){let o=yt(s[2]);for(let a of s[1].split(",")){let c=a.trim();if(!c||/[\s>+~:[\]*]/.test(c))continue;let l=[],d=null,p=null,u=!0,m=/([.#]?)([A-Za-z_][-\w]*)/g,f;for(;(f=m.exec(c))!==null;)if(f[1]===".")l.push(f[2].toLowerCase());else if(f[1]==="#")d=f[2];else if(f.index===0)p=f[2].toLowerCase();else{u=!1;break}u&&(p||d||l.length)&&t.push({classes:l,id:d,tag:p,decls:o})}}}),t}function Us(r){return String(r.attrs.class||"").split(/\s+/).filter(Boolean).map(t=>t.toLowerCase())}function Fu(r,t,e){if(r.tag&&r.tag!==t.tag||r.id&&r.id!==t.attrs.id)return!1;for(let n of r.classes)if(e.indexOf(n)<0)return!1;return!0}function fe(r,t,e){let n=yt(r.attrs.style)[t];if(n!=null&&n!=="")return n.toLowerCase();let i=Us(r),s=null;for(let o of e){if(!Fu(o,r,i))continue;let a=o.decls[t];a!=null&&a!==""&&(s=a.toLowerCase())}return s}function Ps(r,t){let e=fe(r,"display",t);return e||(Uu.has(r.tag)?"inline":"block")}function Wr(r){if(!r)return null;let t=/^(-?\d+(?:\.\d+)?)px$/.exec(String(r).trim());return t?Number(t[1]):null}function Bs(r){if(!r)return null;let t=/^(-?\d+(?:\.\d+)?)%$/.exec(String(r).trim());return t?Number(t[1]):null}function rr(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function Ku(r){if(!r.length||!rr(r[0]))return r.map(n=>n==null?"":String(n));let t=null,e=0;for(let n of Object.keys(r[0])){let i=r.map(o=>rr(o)&&o[n]!=null?String(o[n]):"");if(i.some(o=>o.length<2))continue;let s=new Set(i.map(ze)).size;if(s>e&&(e=s,t=i),s===r.length)break}return t||r.map((n,i)=>String(rr(n)?Object.values(n)[0]==null?i:Object.values(n)[0]:n))}function Gu(r){let t=[],e=[],n=new Set,i=(o,a)=>{if(!(a.length<2)){if(a.every(rr)){t.push({path:o,records:a,identities:Ku(a)});let c=Object.keys(a[0]),l=c.filter(p=>a.every(u=>typeof u[p]=="number"&&Number.isFinite(u[p]))),d=c.filter(p=>a.every(u=>typeof u[p]=="string"));l.length===1&&d.length>=1&&e.push({path:o,labels:a.map(p=>String(p[d[0]])),values:a.map(p=>Number(p[l[0]]))});return}a.every(c=>typeof c=="number"&&Number.isFinite(c))&&e.push({path:o,labels:a.map((c,l)=>`#${l}`),values:a.slice()})}},s=(o,a,c)=>{if(!(c>6||o==null||typeof o!="object"||n.has(o))){if(n.add(o),Array.isArray(o)){i(a,o);for(let l=0;l<o.length&&l<200;l+=1)s(o[l],`${a}[${l}]`,c+1);return}for(let l of Object.keys(o))s(o[l],a?`${a}.${l}`:l,c+1)}};return s(r,"",0),{collections:t,series:e}}function Hu(r){let t=String(r||"").match(/[MmLlHhVvZz]|-?\d*\.?\d+(?:e-?\d+)?/gi);if(!t)return null;let e=0,n=0,i="",s=1/0,o=-1/0,a=1/0,c=-1/0,l=()=>{!Number.isFinite(e)||!Number.isFinite(n)||(e<s&&(s=e),e>o&&(o=e),n<a&&(a=n),n>c&&(c=n))},d=0,p=0;for(;d<t.length&&p++<2e4;){let u=t[d];if(/[A-Za-z]/.test(u)&&(i=u,d+=1,i==="Z"||i==="z"))continue;if(d>=t.length)break;let m=()=>{let f=Number(t[d]);return d+=1,f};switch(i){case"M":e=m(),n=m(),l(),i="L";break;case"m":e+=m(),n+=m(),l(),i="l";break;case"L":e=m(),n=m(),l();break;case"l":e+=m(),n+=m(),l();break;case"H":e=m(),l();break;case"h":e+=m(),l();break;case"V":n=m(),l();break;case"v":n+=m(),l();break;default:d+=1;break}}return!Number.isFinite(s)||!Number.isFinite(a)?null:{w:o-s,h:c-a}}var zu=/(^|[-_])(bar|gauge|meter|fill|progress|track)([-_]|$)/i;function Yu(r){let t=r.parent;for(let e=0;t&&e<3;e+=1,t=t.parent){let n=nr(t);if(n)return n}return""}function Js(r,t){if(Us(r).some(i=>zu.test(i)))return!0;let e=yt(r.attrs.style);return!!(e.background||e["background-color"]||fe(r,"background",t)||fe(r,"background-color",t))&&nr(r)===""}function Wu(r){let t=new Map;for(let n of r)for(let i=n.node.parent;i;i=i.parent)t.set(i,(t.get(i)||0)+1);let e=new Map;for(let n of r){let i=null;for(let s=n.node.parent;s;s=s.parent)if((t.get(s)||0)>=2){i=s;break}i&&(e.has(i)||e.set(i,[]),e.get(i).push(n))}return[...e.values()].filter(n=>n.length>=2)}function Zu(r,t){let e=new Map,n=[];Le(r,s=>{if(s.tag==="path"||s.tag==="rect"){let d=s.attrs.ecmeta_series_index;if(d==null)return;let p=null;if(s.tag==="rect"){let f=Number(s.attrs.width),h=Number(s.attrs.height);Number.isFinite(f)&&Number.isFinite(h)&&(p={w:f,h})}else p=Hu(s.attrs.d||"");if(!p)return;let u=s.attrs.ecmeta_data_index,m=String(d);e.has(m)||e.set(m,[]),e.get(m).push({bar:{node:s,extent:NaN,unit:"user",dataIndex:u==null||u===""?null:Number(u),context:"",start:s.start},box:p});return}if(Zr.has(s.tag)||s.tag==="svg")return;let o=yt(s.attrs.style),a=o.width==null?o["inline-size"]:o.width;if(a==null||a==="")return;let c=Bs(a),l=Wr(a);c==null&&l==null||Js(s,t)&&n.push({node:s,extent:c??l,unit:c==null?"px":"%",dataIndex:null,context:Yu(s),start:s.start})});let i=[];for(let s of e.values()){if(s.length<2)continue;let o=l=>Math.max(...l)-Math.min(...l),a=o(s.map(l=>l.box.h))>=o(s.map(l=>l.box.w));for(let l of s)l.bar.extent=a?l.box.h:l.box.w;let c=s.map(l=>l.bar).sort((l,d)=>l.dataIndex!=null&&d.dataIndex!=null?l.dataIndex-d.dataIndex:l.start-d.start);i.push(c)}for(let s of Wu(n)){let o=s.filter(l=>l.unit==="%"),a=s.filter(l=>l.unit==="px"),c=o.length>=a.length?o:a;c.length>=2&&i.push(c)}return i}function Vu(r){let t=[];return Le(r,e=>{if(e.tag!=="table")return;let n=[];Le(e,i=>{if(i.tag!=="tr")return;let s=i.children.filter(o=>o.tag==="td"||o.tag==="th");s.length&&s.every(o=>o.tag==="th")||n.push(i)}),t.push({node:e,rows:n,rowTexts:n.map(nr),start:e.start})}),t}function Xu(r,t,e,n,i,s,o){let a=nr(t);for(let c of n){let l=c.records.length;if(l<3)continue;let d=[],p=0;for(let y of c.identities){let b=ze(y);!b||b.length<2||(p+=1,a.includes(b)||d.push(String(y)))}if(p<3)continue;let u=p-d.length,m=p?u/p:1,f=null,h=0;for(let y of e){if(!y.rows.length)continue;let b=0,g=new Set;for(let k of y.rowTexts){let O=!1;c.identities.forEach((q,ye)=>{let T=ze(q);T.length>=2&&k.indexOf(T)>=0&&(O=!0,g.add(ye))}),O&&(b+=1)}b<Math.max(2,Math.ceil(y.rows.length*.5))||g.size<Math.ceil(b*.8)||b>h&&(h=b,f=y)}let _=f!=null;o.push({path:c.path||"(root)",records:l,identitiesSearched:p,presentInPage:u,renderedFraction:Number(m.toFixed(3)),boundTableRows:_?f.rows.length:null}),!(m<$u)&&(d.length&&ce(i,s,{code:Q.ROW_MISSING,line:_?ae(r,f.start):1,message:`The data at \`${c.path||"(root)"}\` has ${l} records but ${d.length} of them appear NOWHERE on the page: ${d.slice(0,6).map(y=>JSON.stringify(String(y).slice(0,40))).join(", ")}${d.length>6?`, +${d.length-6} more`:""}.`,hint:"Render every record you were given, or say in the page that it is a partial view and how many were left out. A silently truncated table reads as the complete answer."}),d.length===0&&_&&f.rows.length!==l&&ce(i,s,{code:Q.ROW_COUNT,line:ae(r,f.start),message:`The table renders ${f.rows.length} body row(s) but the data at \`${c.path||"(root)"}\` has ${l} records \u2014 ${Math.abs(l-f.rows.length)} ${l>f.rows.length?"missing":"extra"}.`,hint:'Emit exactly one <tr> per record. If you meant to show only some of them, state the cut ("top 10 of 23") in the page itself.'}))}}function Qu(r,t){let e=new Array(r.length).fill(-1);if(r.every(s=>s.dataIndex!=null)){let s=0;if(r.forEach((o,a)=>{let c=o.dataIndex;c>=0&&c<t.values.length&&(e[a]=c,s+=1)}),s===r.length)return e}e.fill(-1);let n=new Set,i=0;if(r.forEach((s,o)=>{for(let a=0;a<t.labels.length;a+=1){if(n.has(a))continue;let c=ze(t.labels[a]);if(c.length>=2&&s.context.indexOf(c)>=0){e[o]=a,n.add(a),i+=1;break}}}),i===r.length)return e;if(r.length!==t.values.length)return null;for(let s=0;s<r.length;s+=1)e[s]=s;return e}function em(r,t){let e=null,n=0;for(let s of t){let o=s.labels.filter(a=>{let c=ze(a);return c.length>=2&&r.some(l=>l.context.indexOf(c)>=0)}).length;o>n&&(n=o,e=s)}if(n>=2)return e;let i=t.filter(s=>s.values.length===r.length);return i.length===1?i[0]:null}function tm(r,t,e,n,i,s){s.barGroups=t.map(o=>o.length),s.boundBars=0;for(let o of t){let a=em(o,e);if(!a)continue;if(a.values.length!==o.length){ce(n,i,{code:Q.BAR_COUNT,line:ae(r,o[0].start),message:`The chart draws ${o.length} bar(s) but the series at \`${a.path||"(root)"}\` has ${a.values.length} value(s).`,hint:"Draw one bar per value. A dropped bar silently removes a whole category from the reader's view of the data."});continue}let c=Qu(o,a);if(!c||c.some(u=>u<0))continue;s.boundBars+=o.length;let l=[];for(let u=0;u<o.length;u+=1)o[u].extent>0&&a.values[c[u]]>0&&l.push(u);if(l.length>=Lu){let u=l.map(y=>o[y].extent/a.values[c[y]]).sort((y,b)=>y-b),m=Math.floor(u.length/2),f=u.length%2?u[m]:(u[m-1]+u[m])/2,h=Math.max(...a.values.map(y=>Math.abs(y))),_=f*h;if(f>0&&_>0)for(let y of l){let b=a.values[c[y]],g=f*b,k=Math.abs(o[y].extent-g)/_;if(k<=ju)continue;let O=o[y].unit==="%"?"%":"";ce(n,i,{code:Q.BAR_PROPORTION,line:ae(r,o[y].start),message:`The bar for ${JSON.stringify(a.labels[c[y]])} (value ${b}) is drawn at ${$s(o[y].extent)}${O}, but every other bar in this chart puts it at ${$s(g)}${O} \u2014 off by ${Math.round(k*100)}% of the full-scale bar. The chart misrepresents the data.`,hint:"Every bar in one chart must use the SAME value\u2192length scale. Compute each length from its datum with one formula (value / max * 100), never by writing the numbers out by hand."})}}let d=a.values.reduce((u,m)=>u+m,0),p=Math.max(...a.values.map(u=>Math.abs(u)));for(let u=0;u<o.length;u+=1){let m=a.values[c[u]],f=o[u].context;if(!f)continue;let h=(f.match(/-?\d[\d,]*(?:\.\d+)?/g)||[]).map(_=>Number(_.replace(/,/g,""))).filter(_=>Number.isFinite(_));h.length&&(h.some(_=>Math.abs(_-m)<1e-9)||d>0&&h.some(_=>Math.abs(_-m/d*100)<.6)||p>0&&h.some(_=>Math.abs(_-m/p*100)<.6)||ce(n,i,{code:Q.VALUE_MISMATCH,line:ae(r,o[u].start),message:`The row for ${JSON.stringify(a.labels[c[u]])} prints ${h.slice(0,3).join(", ")} but its datum is ${m}.`,hint:"Print the figure your tools returned, unchanged, and use that same figure everywhere it appears on the page."}))}}}var rm=/^(flex|inline-flex|grid|inline-grid)$/;function nm(r,t,e,n,i,s){let o=0;Le(t,a=>{if(Zr.has(a.tag))return;let c=yt(a.attrs.style).width;if(!c)return;let l=Bs(c);if(l==null||l<=0||!Js(a,e))return;o+=1;let d=Ps(a,e);if(d==="none"){ce(n,i,{code:Q.ZERO_WIDTH,line:ae(r,a.start),message:`<${a.tag}> is given style="width:${c}" but its effective display is \`none\` \u2014 it is not rendered at all.`,hint:"Remove the display:none rule that matches this element, or remove the element. A width on a display:none box is dead code."});return}if(d!=="inline")return;let p=a.parent;if(p&&p.tag!=="#root"&&rm.test(Ps(p,e)))return;let u=fe(a,"position",e);if(u==="absolute"||u==="fixed")return;let m=fe(a,"float",e);m==="left"||m==="right"||ce(n,i,{code:Q.ZERO_WIDTH,line:ae(r,a.start),message:`<${a.tag}${a.attrs.class?` class="${a.attrs.class}"`:""}> is given style="width:${c}" but its effective display is \`inline\` \u2014 CSS IGNORES width on a non-replaced inline box, so this bar renders with no length at all. The source looks right; the page will not.`,hint:"Give the bar display:block or display:inline-block (or make its container display:flex). A <span> is inline by DEFAULT \u2014 that alone is enough to swallow the width."})}),s.percentWidthBars=o}function im(r,t,e,n,i){Le(t,s=>{let o=Wr(fe(s,"width",e));if(!(o==null||o<=0))for(let a=s.parent;a&&a.tag!=="#root";a=a.parent){let c=Wr(fe(a,"width",e));if(c==null||c<=0)continue;if(o<=c)return;let l=fe(a,"overflow",e)||fe(a,"overflow-x",e);if(l!=="hidden"&&l!=="clip")return;ce(n,i,{code:Q.OVERFLOW,line:ae(r,s.start),message:`<${s.tag}> is ${o}px wide inside a ${c}px ancestor with overflow:${l} \u2014 ${Math.round(o-c)}px of it is clipped and can never be seen.`,hint:"Size the child from its container (a percentage, or max-width:100%), or widen the container. Content the reader cannot see is content you did not publish."});return}})}var sm=[{re:/\[object (?:Object|Array|Promise|Map|Set|Null|Undefined)\]/g,what:"an object stringified instead of a field being picked off it"},{re:/\$\{[^}\n]{0,80}\}/g,what:"an un-substituted JavaScript template placeholder"},{re:/\{\{[^}\n]{0,80}\}\}/g,what:"an un-substituted moustache placeholder"},{re:/(?:^|[^\w.])(NaN)(?![\w])/g,what:"NaN \u2014 an arithmetic result that was never a number"},{re:/(?:^|[^\w.])(-?Infinity)(?![\w])/g,what:"Infinity \u2014 a division by zero reached the page"}],om=/^(undefined|null)$/i,am=new Set(["td","th","li","span","div","strong","em","b"]);function cm(r,t,e,n,i){let s=0;for(let o of qu(t)){let a=o.value;s+=a.length;for(let l of sm){l.re.lastIndex=0;let d;for(;(d=l.re.exec(a))!==null;){let p=d[1]==null?d[0]:d[1];ce(e,n,{code:Q.PLACEHOLDER_TEXT,line:ae(r,o.start+d.index+d[0].indexOf(p)),message:`The page prints ${JSON.stringify(p.slice(0,60))} as VISIBLE TEXT \u2014 ${l.what}. A reader sees this literally.`,hint:"Format the value before it reaches the page: pick the field you meant off the object, and guard the arithmetic so a missing input renders as an em dash rather than NaN."}),d.index===l.re.lastIndex&&(l.re.lastIndex+=1)}}let c=Cs(a).trim();om.test(c)&&am.has(o.parent.tag)&&ce(e,n,{code:Q.PLACEHOLDER_TEXT,line:ae(r,o.start),message:`A <${o.parent.tag}> contains only the literal text "${c}" \u2014 the value it was meant to hold was ${c}.`,hint:'Render an em dash (\u2014) or "n/a" for a missing value; never let the JavaScript literal reach the reader.'})}i.textCharsScanned=s}function ir({html:r,data:t}){let e=typeof r=="string"?r:"",n=[],i={};if(!e.trim())return{ok:!1,defects:[{code:"empty-content",line:1,message:"No html was passed to the check.",hint:"Pass the exact page source you are about to publish."}],checked:{tables:0,bodyRows:0,bars:0,barGroups:[],boundBars:0,seriesInData:0,collections:[]}};let s=Du(e),o=Mu(s),a=Vu(s),c=Zu(s,o),l=Gu(t),d={tables:a.length,bodyRows:a.reduce((p,u)=>p+u.rows.length,0),bars:c.reduce((p,u)=>p+u.length,0),barGroups:[],boundBars:0,seriesInData:l.series.length,collections:[]};return Xu(e,s,a,l.collections,n,i,d.collections),tm(e,c,l.series,n,i,d),nm(e,s,o,n,i,d),im(e,s,o,n,i),cm(e,s,n,i,d),n.sort((p,u)=>(p.line||0)-(u.line||0)),{ok:n.length===0,defects:n,checked:d}}function lm(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Tu(Au(import.meta.url)),t=Ru(r,"..","bin","mcp-skill.mjs");return Ou(t)?t:null}var Ds={id:"report-check",serverName:"report_check",allowedTools:["mcp__report_check__*"],envKeys:[],description:"Report check \u2014 verify a rendered report page against the DATA it was built from (row counts, bar proportionality, collapsed bars, placeholder residue) before publishing it.",promptFragment:`## Report Check (run this BEFORE you publish a data page)
793
+ store (or a file tool on either, etc.) is rejected.`,resolve(){let r=wu();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);for(let e of Object.keys(process.env))/^ZIBBY_STORE__.+$/.test(e)&&process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/datasetStore.js","datasetStoreSkill"],env:t,description:this.description,alwaysLoad:!1}},async handleToolCall(r,t){try{switch(r){case"dataset_append":{if(t?.record==null||typeof t.record!="object"||Array.isArray(t.record))return JSON.stringify({error:"record is required (a JSON object)"});let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n=typeof t?.agent=="string"&&t.agent.trim()?t.agent.trim():Rs(),i={record:t.record,agent:n};typeof t?.description=="string"&&t.description.trim()&&(i.description=t.description.trim());let s=await me(e.storeId,"append",i);return JSON.stringify({...s,store:e.name,storeId:e.storeId})}case"dataset_query":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n={};for(let s of["select","where","groupBy","orderBy","limit","since","until","agent"])t?.[s]!=null&&(n[s]=t[s]);let i=await me(e.storeId,"query",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}case"ensure_store":{let e=typeof t?.name=="string"?t.name.trim():"";if(!e)return JSON.stringify({error:"name is required"});let n=typeof t?.type=="string"&&t.type.trim()?t.type.trim().toLowerCase():"sqlite",i=typeof t?.description=="string"?t.description.trim():"",s=await Su({name:e,type:n,description:i,namespace:Rs()});return s?.storeId&&(js[e]=s.storeId),JSON.stringify({...s,store:e})}case"file_put":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:'path is required (a relative file path like "reports/2026-07.json")'});let n=typeof t?.content=="string",i=typeof t?.contentBase64=="string"&&t.contentBase64.length>0;if(!n&&!i)return JSON.stringify({error:"content (text) or contentBase64 (base64 bytes) is required"});let s=t.path.trim(),o=typeof t?.contentType=="string"&&t.contentType.trim()?t.contentType.trim():"",a=n?Buffer.from(t.content,"utf8"):Buffer.from(String(t.contentBase64).replace(/\s+/g,""),"base64");if(a.length>vu){let d=o||(n?"text/plain; charset=utf-8":"application/octet-stream"),p=await Iu(e.storeId,s,a,d);return JSON.stringify({...p,store:e.name,storeId:e.storeId})}let c={path:s};n?c.content=t.content:c.contentBase64=t.contentBase64,o&&(c.contentType=o);let l=await me(e.storeId,"put",c);return JSON.stringify({...l,store:e.name,storeId:e.storeId})}case"file_get":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:"path is required"});let n=t.path.trim(),i;try{i=await me(e.storeId,"get",{path:n})}catch(c){if(!/failed \(413\)/.test(c?.message||""))throw c;let l=await Nu(e.storeId,n);i={path:n,size:l.buf.length,contentType:l.contentType,lastModified:null,contentBase64:l.buf.toString("base64")}}let s={ok:!0,store:e.name,storeId:e.storeId,path:i.path,size:i.size,contentType:i.contentType,lastModified:i.lastModified},o=Buffer.from(i.contentBase64||"","base64"),a=o.toString("utf8");return Buffer.compare(Buffer.from(a,"utf8"),o)===0&&!a.includes("\0")?(s.content=a,s.encoding="utf8"):(s.contentBase64=i.contentBase64,s.encoding="base64"),JSON.stringify(s)}case"file_list":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});let n={};typeof t?.prefix=="string"&&t.prefix.trim()&&(n.prefix=t.prefix.trim()),t?.limit!=null&&(n.limit=t.limit),typeof t?.cursor=="string"&&t.cursor&&(n.cursor=t.cursor);let i=await me(e.storeId,"list",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}case"file_delete":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.path!="string"||!t.path.trim())return JSON.stringify({error:"path is required"});let n=await me(e.storeId,"delete",{path:t.path.trim()});return JSON.stringify({...n,store:e.name,storeId:e.storeId})}case"sqlite_exec":case"sqlite_query":{let e=je(t?.store);if(e.error)return JSON.stringify({error:e.error});if(typeof t?.sql!="string"||!t.sql.trim())return JSON.stringify({error:"sql is required (a non-empty SQL string)"});let n={sql:t.sql};r==="sqlite_query"&&(n.readOnly=!0),Array.isArray(t?.params)&&(n.params=t.params);let i=await me(e.storeId,"sql",n);return JSON.stringify({...i,store:e.name,storeId:e.storeId})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"dataset_append",description:"Append ONE structured JSON record to a bound store, durably. Records persist across your stateless runs and are auto-tagged with your agent type so you can filter to your own writes later. Use to accumulate data you will query/aggregate (e.g. per-run metrics, processed items). Append ONE record per call.",input_schema:{type:"object",properties:{store:{type:"string",description:'The logical store NAME to write to (e.g. "scorecards"), taken from the AVAILABLE STORES list \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this and it defaults to that store; you can ONLY write to a bound store name.'},record:{type:"object",description:'An arbitrary JSON object \u2014 one row of data. Its keys become queryable fields (e.g. {"repo":"owner/x","stars":1200}). One record per call.'},description:{type:"string",description:"Optional, informational note about this write. The store already exists from deploy, so this is not required and does not create anything."},agent:{type:"string",description:"Optional writing-agent tag. Defaults to your own agent type \u2014 leave unset to auto-tag."}},required:["record"]}},{name:"dataset_query",description:"Run a SQL-style query over a bound store to build reports: select/aggregate (count|sum|avg|min|max), filter, group, order, limit, and bound by month. Returns { columns, rows }. Use this to compute summaries/aggregations from records you appended earlier.",input_schema:{type:"object",properties:{store:{type:"string",description:'The logical store NAME to query (e.g. "scorecards"), taken from the AVAILABLE STORES list \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this and it defaults to that store.'},select:{type:"array",description:"Columns to return. Each item is { field?, agg?, as? }. agg \u2208 count|sum|avg|min|max; omit field for count(*). Omit `select` entirely to return raw rows."},where:{type:"array",description:"Filters, ANDed. Each item is { field, op, value }; op \u2208 eq|ne|gt|gte|lt|lte|like. `field` is a JSON key of the stored record."},groupBy:{type:"array",description:"Field names to group by (array of strings) for aggregation."},orderBy:{type:"array",description:"Sort spec. Each item is { field|as, dir }; dir \u2208 asc|desc."},limit:{type:"number",description:"Maximum number of rows to return."},since:{type:"string",description:"Inclusive lower bound month, 'yyyy-MM' (e.g. '2026-01')."},until:{type:"string",description:"Inclusive upper bound month, 'yyyy-MM' (e.g. '2026-06')."},agent:{type:"string",description:"Filter to records written by one agent namespace. Omit to query across all writers."}},required:[]}},{name:"ensure_store",description:'Create (or reuse) a store ON DEMAND for THIS agent \u2014 use when you need a store that was NOT declared/bound at deploy. Idempotent by name and private to this agent: calling again with the same name returns the SAME store (safe to call at the start of every run). Returns { storeId }. For type "sqlite" you then define schema with sqlite_exec (CREATE TABLE IF NOT EXISTS) and read/write via sqlite_exec/sqlite_query using this name.',input_schema:{type:"object",properties:{name:{type:"string",description:'A short logical name for the store (e.g. "linkedin_posts"). Letters, digits, _ and - only.'},type:{type:"string",enum:["sqlite","dataset","file"],description:'Store type. "sqlite" (default) = a mutable relational DB whose schema YOU define with SQL. "dataset" = append-only JSON records for later aggregation/analytics. "file" = arbitrary file/blob storage by relative path (file_put/file_get/file_list/file_delete).'},description:{type:"string",description:"What this store is for (shown in the Storage UI)."}},required:["name"]}},{name:"sqlite_exec",description:"For SQLITE-type stores: run SQL that CHANGES data \u2014 CREATE TABLE (use IF NOT EXISTS), INSERT, UPDATE, DELETE (one or more statements in one call). The store is a real, mutable SQLite database that persists across your stateless runs. Returns { rowsModified, wrote }. Use this to build schema on the fly and to update rows / track changing state (e.g. a queue with a status column).",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a sqlite-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},sql:{type:"string",description:'The SQL to run. May contain multiple statements separated by ";". Prefer CREATE TABLE IF NOT EXISTS for idempotent schema.'},params:{type:"array",description:'Optional positional bind params for a SINGLE parameterized statement (safe binding of values), e.g. sql "UPDATE t SET s=? WHERE id=?" with params ["done", 1].'}},required:["sql"]}},{name:"sqlite_query",description:"For SQLITE-type stores: run a read-only SELECT (optionally with `params` for safe binding) against the store's SQLite database. Returns { columns, rows }. Never changes data. Use to read back rows/state you stored earlier.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a sqlite-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},sql:{type:"string",description:"A single SELECT statement. Use ? placeholders + `params` for any values."},params:{type:"array",description:'Optional positional bind params for the SELECT, e.g. ["linkedin_personal"].'}},required:["sql"]}},{name:"file_put",description:"For FILE-type stores: write (or overwrite) ONE file at a relative path \u2014 raw JSON dumps, CSVs, images, snapshots, any blob you want to keep across your stateless runs. Text goes in `content`; binary goes base64-encoded in `contentBase64` (pass exactly one). SIZE: there is no practical limit \u2014 anything over ~3.5 MiB is streamed straight to object storage via a presigned URL automatically, so do NOT gzip, base64-wrap, chunk or split a file just to make it fit. Non-ASCII paths (e.g. \u4E2A\u4EBA\u62A5\u544A.html) are fine \u2014 do not transliterate. Overwriting the same path UPDATES the file. Returns { ok, path, size }.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES) \u2014 pick by description. NOT an id. If exactly one store is bound you may omit this."},path:{type:"string",description:'Relative file path, e.g. "dumps/run-42.json" or "img/chart.png". Letters, digits, ".", "_", "-" and "/" only; no "..", no leading "/".'},content:{type:"string",description:"Text content (UTF-8). Use for JSON/CSV/text files."},contentBase64:{type:"string",description:"Base64-encoded binary content (images etc.). Alternative to `content`."},contentType:{type:"string",description:'Optional MIME type (e.g. "application/json", "image/png"). Defaults sensibly.'}},required:["path"]}},{name:"file_get",description:'For FILE-type stores: read ONE stored file back by its relative path. Text files come back as `content` (encoding "utf8"); binary files come back as `contentBase64` (encoding "base64"). Returns { path, size, contentType, lastModified, content|contentBase64, encoding }.',input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},path:{type:"string",description:"The relative file path to fetch (as listed by file_list / used in file_put)."}},required:["path"]}},{name:"file_list",description:'For FILE-type stores: list the stored files \u2014 each entry has { path, size, lastModified }. Optionally filter by a path `prefix` (e.g. "dumps/"). Paginated via `cursor` when there are more results.',input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},prefix:{type:"string",description:'Optional path prefix filter, e.g. "dumps/" or "reports/2026".'},limit:{type:"number",description:"Max entries to return (default/max 1000)."},cursor:{type:"string",description:"Pagination cursor from a previous file_list response (nextCursor)."}},required:[]}},{name:"file_delete",description:"For FILE-type stores: delete ONE stored file by its relative path. Returns { ok, path, deleted }. Errors if the path does not exist.",input_schema:{type:"object",properties:{store:{type:"string",description:"The logical store NAME (a file-type store from AVAILABLE STORES). If exactly one store is bound you may omit this."},path:{type:"string",description:"The relative file path to delete."}},required:["path"]}}]};import{SKILL_META as dm}from"@zibby/skill-ids";import{existsSync as Zs,readFileSync as pm}from"node:fs";import{homedir as um}from"node:os";import{join as mm,dirname as fm,resolve as hm}from"node:path";import{fileURLToPath as ym}from"node:url";import{existsSync as Ou}from"node:fs";import{dirname as Tu,resolve as Ru}from"node:path";import{fileURLToPath as Au}from"node:url";var Q={ZERO_WIDTH:"zero-width-bar",ROW_COUNT:"data-row-count",ROW_MISSING:"data-row-missing",BAR_COUNT:"data-bar-count",BAR_PROPORTION:"bar-proportion",VALUE_MISMATCH:"data-value-mismatch",PLACEHOLDER_TEXT:"placeholder-text",OVERFLOW:"overflow-clipped"},Eu=5,xu=20,ju=.04,Lu=3,$u=.5;function ae(r,t){if(t==null||t<0)return null;let e=1;for(let n=0;n<t&&n<r.length;n+=1)r.charCodeAt(n)===10&&(e+=1);return e}function ce(r,t,e){let n=t[e.code]||0;n>=Eu||r.length>=xu||(t[e.code]=n+1,r.push(e))}var Pu={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",ndash:"\u2013",mdash:"\u2014",hellip:"\u2026"};function Cs(r){return String(r).replace(/&(#x?[0-9a-f]+|[a-z]+);/gi,(t,e)=>{if(e[0]==="#"){let i=e[1]==="x"||e[1]==="X"?parseInt(e.slice(2),16):parseInt(e.slice(1),10);return Number.isFinite(i)?String.fromCodePoint(i):t}let n=Pu[String(e).toLowerCase()];return n??t})}function ze(r){return Cs(String(r??"")).replace(/\s+/g," ").trim().toLowerCase()}function $s(r){return Math.round(r*10)/10}var Cu=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),Zr=new Set(["script","style","textarea"]),Uu=new Set(["span","a","em","strong","b","i","u","s","small","code","label","abbr","cite","q","sub","sup","mark","time","var","kbd","samp","font","tt"]),Bu=/^<\s*(\/?)\s*([a-zA-Z][a-zA-Z0-9:_.-]*)((?:"[^"]*"|'[^']*'|[^>"'])*?)(\/?)>/;function Ju(r){let t={},e=/([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'=<>`]+))|([a-zA-Z_:][-a-zA-Z0-9_:.]*)/g,n;for(;(n=e.exec(r))!==null;)n[1]?t[n[1].toLowerCase()]=n[3]!=null?n[3]:n[4]!=null?n[4]:n[5]==null?"":n[5]:n[6]&&(t[n[6].toLowerCase()]="");return t}function Du(r){let t={tag:"#root",attrs:{},children:[],parent:null,start:0},e=t,n=[t],i=0,s=(o,a)=>{if(a<=o)return;let c=r.slice(o,a);c.trim()&&e.children.push({tag:"#text",attrs:{},children:[],parent:e,start:o,value:c})};for(;i<r.length;){let o=r.indexOf("<",i);if(o<0){s(i,r.length);break}if(s(i,o),r.startsWith("<!--",o)){let p=r.indexOf("-->",o);i=p<0?r.length:p+3;continue}if(r.startsWith("<!",o)||r.startsWith("<?",o)){let p=r.indexOf(">",o);i=p<0?r.length:p+1;continue}let a=Bu.exec(r.slice(o));if(!a){i=o+1;continue}let c=a[0],l=a[2].toLowerCase();if(a[1]){for(let p=n.length-1;p>0;p-=1)if(n[p].tag===l){n.length=p,e=n[p-1];break}i=o+c.length;continue}let d={tag:l,attrs:Ju(a[3]||""),children:[],parent:e,start:o};if(e.children.push(d),i=o+c.length,!(a[4]||Cu.has(l))){if(Zr.has(l)){let p=r.slice(i),u=new RegExp(`</\\s*${l}\\s*>`,"i").exec(p);d.raw=u?p.slice(0,u.index):p,i+=u?u.index+u[0].length:p.length;continue}n.push(d),e=d}}return t}function Le(r,t){for(let e of r.children)e.tag!=="#text"&&(t(e),Le(e,t))}function nr(r){let t=[],e=n=>{for(let i of n.children)i.tag==="#text"?t.push(i.value||""):(t.push(" "),e(i),t.push(" "))};return e(r),ze(t.join(""))}function qu(r){let t=[],e=n=>{for(let i of n.children)i.tag==="#text"?t.push({value:i.value||"",start:i.start,parent:n}):i.tag!=="pre"&&i.tag!=="code"&&e(i)};return e(r),t}function yt(r){let t={};for(let e of String(r||"").split(";")){let n=e.indexOf(":");n<0||(t[e.slice(0,n).trim().toLowerCase()]=e.slice(n+1).trim().replace(/\s*!important$/i,""))}return t}function Mu(r){let t=[];return Le(r,e=>{if(e.tag!=="style"||!e.raw)return;let n=e.raw.replace(/@[a-z-]+[^{]*\{/gi," "),i=/([^{}]+)\{([^{}]*)\}/g,s;for(;(s=i.exec(n))!==null;){let o=yt(s[2]);for(let a of s[1].split(",")){let c=a.trim();if(!c||/[\s>+~:[\]*]/.test(c))continue;let l=[],d=null,p=null,u=!0,m=/([.#]?)([A-Za-z_][-\w]*)/g,f;for(;(f=m.exec(c))!==null;)if(f[1]===".")l.push(f[2].toLowerCase());else if(f[1]==="#")d=f[2];else if(f.index===0)p=f[2].toLowerCase();else{u=!1;break}u&&(p||d||l.length)&&t.push({classes:l,id:d,tag:p,decls:o})}}}),t}function Us(r){return String(r.attrs.class||"").split(/\s+/).filter(Boolean).map(t=>t.toLowerCase())}function Fu(r,t,e){if(r.tag&&r.tag!==t.tag||r.id&&r.id!==t.attrs.id)return!1;for(let n of r.classes)if(e.indexOf(n)<0)return!1;return!0}function fe(r,t,e){let n=yt(r.attrs.style)[t];if(n!=null&&n!=="")return n.toLowerCase();let i=Us(r),s=null;for(let o of e){if(!Fu(o,r,i))continue;let a=o.decls[t];a!=null&&a!==""&&(s=a.toLowerCase())}return s}function Ps(r,t){let e=fe(r,"display",t);return e||(Uu.has(r.tag)?"inline":"block")}function Wr(r){if(!r)return null;let t=/^(-?\d+(?:\.\d+)?)px$/.exec(String(r).trim());return t?Number(t[1]):null}function Bs(r){if(!r)return null;let t=/^(-?\d+(?:\.\d+)?)%$/.exec(String(r).trim());return t?Number(t[1]):null}function rr(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function Ku(r){if(!r.length||!rr(r[0]))return r.map(n=>n==null?"":String(n));let t=null,e=0;for(let n of Object.keys(r[0])){let i=r.map(o=>rr(o)&&o[n]!=null?String(o[n]):"");if(i.some(o=>o.length<2))continue;let s=new Set(i.map(ze)).size;if(s>e&&(e=s,t=i),s===r.length)break}return t||r.map((n,i)=>String(rr(n)?Object.values(n)[0]==null?i:Object.values(n)[0]:n))}function Gu(r){let t=[],e=[],n=new Set,i=(o,a)=>{if(!(a.length<2)){if(a.every(rr)){t.push({path:o,records:a,identities:Ku(a)});let c=Object.keys(a[0]),l=c.filter(p=>a.every(u=>typeof u[p]=="number"&&Number.isFinite(u[p]))),d=c.filter(p=>a.every(u=>typeof u[p]=="string"));l.length===1&&d.length>=1&&e.push({path:o,labels:a.map(p=>String(p[d[0]])),values:a.map(p=>Number(p[l[0]]))});return}a.every(c=>typeof c=="number"&&Number.isFinite(c))&&e.push({path:o,labels:a.map((c,l)=>`#${l}`),values:a.slice()})}},s=(o,a,c)=>{if(!(c>6||o==null||typeof o!="object"||n.has(o))){if(n.add(o),Array.isArray(o)){i(a,o);for(let l=0;l<o.length&&l<200;l+=1)s(o[l],`${a}[${l}]`,c+1);return}for(let l of Object.keys(o))s(o[l],a?`${a}.${l}`:l,c+1)}};return s(r,"",0),{collections:t,series:e}}function Hu(r){let t=String(r||"").match(/[MmLlHhVvZz]|-?\d*\.?\d+(?:e-?\d+)?/gi);if(!t)return null;let e=0,n=0,i="",s=1/0,o=-1/0,a=1/0,c=-1/0,l=()=>{!Number.isFinite(e)||!Number.isFinite(n)||(e<s&&(s=e),e>o&&(o=e),n<a&&(a=n),n>c&&(c=n))},d=0,p=0;for(;d<t.length&&p++<2e4;){let u=t[d];if(/[A-Za-z]/.test(u)&&(i=u,d+=1,i==="Z"||i==="z"))continue;if(d>=t.length)break;let m=()=>{let f=Number(t[d]);return d+=1,f};switch(i){case"M":e=m(),n=m(),l(),i="L";break;case"m":e+=m(),n+=m(),l(),i="l";break;case"L":e=m(),n=m(),l();break;case"l":e+=m(),n+=m(),l();break;case"H":e=m(),l();break;case"h":e+=m(),l();break;case"V":n=m(),l();break;case"v":n+=m(),l();break;default:d+=1;break}}return!Number.isFinite(s)||!Number.isFinite(a)?null:{w:o-s,h:c-a}}var zu=/(^|[-_])(bar|gauge|meter|fill|progress|track)([-_]|$)/i;function Yu(r){let t=r.parent;for(let e=0;t&&e<3;e+=1,t=t.parent){let n=nr(t);if(n)return n}return""}function Js(r,t){if(Us(r).some(i=>zu.test(i)))return!0;let e=yt(r.attrs.style);return!!(e.background||e["background-color"]||fe(r,"background",t)||fe(r,"background-color",t))&&nr(r)===""}function Wu(r){let t=new Map;for(let n of r)for(let i=n.node.parent;i;i=i.parent)t.set(i,(t.get(i)||0)+1);let e=new Map;for(let n of r){let i=null;for(let s=n.node.parent;s;s=s.parent)if((t.get(s)||0)>=2){i=s;break}i&&(e.has(i)||e.set(i,[]),e.get(i).push(n))}return[...e.values()].filter(n=>n.length>=2)}function Zu(r,t){let e=new Map,n=[];Le(r,s=>{if(s.tag==="path"||s.tag==="rect"){let d=s.attrs.ecmeta_series_index;if(d==null)return;let p=null;if(s.tag==="rect"){let f=Number(s.attrs.width),h=Number(s.attrs.height);Number.isFinite(f)&&Number.isFinite(h)&&(p={w:f,h})}else p=Hu(s.attrs.d||"");if(!p)return;let u=s.attrs.ecmeta_data_index,m=String(d);e.has(m)||e.set(m,[]),e.get(m).push({bar:{node:s,extent:NaN,unit:"user",dataIndex:u==null||u===""?null:Number(u),context:"",start:s.start},box:p});return}if(Zr.has(s.tag)||s.tag==="svg")return;let o=yt(s.attrs.style),a=o.width==null?o["inline-size"]:o.width;if(a==null||a==="")return;let c=Bs(a),l=Wr(a);c==null&&l==null||Js(s,t)&&n.push({node:s,extent:c??l,unit:c==null?"px":"%",dataIndex:null,context:Yu(s),start:s.start})});let i=[];for(let s of e.values()){if(s.length<2)continue;let o=l=>Math.max(...l)-Math.min(...l),a=o(s.map(l=>l.box.h))>=o(s.map(l=>l.box.w));for(let l of s)l.bar.extent=a?l.box.h:l.box.w;let c=s.map(l=>l.bar).sort((l,d)=>l.dataIndex!=null&&d.dataIndex!=null?l.dataIndex-d.dataIndex:l.start-d.start);i.push(c)}for(let s of Wu(n)){let o=s.filter(l=>l.unit==="%"),a=s.filter(l=>l.unit==="px"),c=o.length>=a.length?o:a;c.length>=2&&i.push(c)}return i}function Vu(r){let t=[];return Le(r,e=>{if(e.tag!=="table")return;let n=[];Le(e,i=>{if(i.tag!=="tr")return;let s=i.children.filter(o=>o.tag==="td"||o.tag==="th");s.length&&s.every(o=>o.tag==="th")||n.push(i)}),t.push({node:e,rows:n,rowTexts:n.map(nr),start:e.start})}),t}function Xu(r,t,e,n,i,s,o){let a=nr(t);for(let c of n){let l=c.records.length;if(l<3)continue;let d=[],p=0;for(let y of c.identities){let b=ze(y);!b||b.length<2||(p+=1,a.includes(b)||d.push(String(y)))}if(p<3)continue;let u=p-d.length,m=p?u/p:1,f=null,h=0;for(let y of e){if(!y.rows.length)continue;let b=0,g=new Set;for(let w of y.rowTexts){let O=!1;c.identities.forEach((q,ye)=>{let T=ze(q);T.length>=2&&w.indexOf(T)>=0&&(O=!0,g.add(ye))}),O&&(b+=1)}b<Math.max(2,Math.ceil(y.rows.length*.5))||g.size<Math.ceil(b*.8)||b>h&&(h=b,f=y)}let _=f!=null;o.push({path:c.path||"(root)",records:l,identitiesSearched:p,presentInPage:u,renderedFraction:Number(m.toFixed(3)),boundTableRows:_?f.rows.length:null}),!(m<$u)&&(d.length&&ce(i,s,{code:Q.ROW_MISSING,line:_?ae(r,f.start):1,message:`The data at \`${c.path||"(root)"}\` has ${l} records but ${d.length} of them appear NOWHERE on the page: ${d.slice(0,6).map(y=>JSON.stringify(String(y).slice(0,40))).join(", ")}${d.length>6?`, +${d.length-6} more`:""}.`,hint:"Render every record you were given, or say in the page that it is a partial view and how many were left out. A silently truncated table reads as the complete answer."}),d.length===0&&_&&f.rows.length!==l&&ce(i,s,{code:Q.ROW_COUNT,line:ae(r,f.start),message:`The table renders ${f.rows.length} body row(s) but the data at \`${c.path||"(root)"}\` has ${l} records \u2014 ${Math.abs(l-f.rows.length)} ${l>f.rows.length?"missing":"extra"}.`,hint:'Emit exactly one <tr> per record. If you meant to show only some of them, state the cut ("top 10 of 23") in the page itself.'}))}}function Qu(r,t){let e=new Array(r.length).fill(-1);if(r.every(s=>s.dataIndex!=null)){let s=0;if(r.forEach((o,a)=>{let c=o.dataIndex;c>=0&&c<t.values.length&&(e[a]=c,s+=1)}),s===r.length)return e}e.fill(-1);let n=new Set,i=0;if(r.forEach((s,o)=>{for(let a=0;a<t.labels.length;a+=1){if(n.has(a))continue;let c=ze(t.labels[a]);if(c.length>=2&&s.context.indexOf(c)>=0){e[o]=a,n.add(a),i+=1;break}}}),i===r.length)return e;if(r.length!==t.values.length)return null;for(let s=0;s<r.length;s+=1)e[s]=s;return e}function em(r,t){let e=null,n=0;for(let s of t){let o=s.labels.filter(a=>{let c=ze(a);return c.length>=2&&r.some(l=>l.context.indexOf(c)>=0)}).length;o>n&&(n=o,e=s)}if(n>=2)return e;let i=t.filter(s=>s.values.length===r.length);return i.length===1?i[0]:null}function tm(r,t,e,n,i,s){s.barGroups=t.map(o=>o.length),s.boundBars=0;for(let o of t){let a=em(o,e);if(!a)continue;if(a.values.length!==o.length){ce(n,i,{code:Q.BAR_COUNT,line:ae(r,o[0].start),message:`The chart draws ${o.length} bar(s) but the series at \`${a.path||"(root)"}\` has ${a.values.length} value(s).`,hint:"Draw one bar per value. A dropped bar silently removes a whole category from the reader's view of the data."});continue}let c=Qu(o,a);if(!c||c.some(u=>u<0))continue;s.boundBars+=o.length;let l=[];for(let u=0;u<o.length;u+=1)o[u].extent>0&&a.values[c[u]]>0&&l.push(u);if(l.length>=Lu){let u=l.map(y=>o[y].extent/a.values[c[y]]).sort((y,b)=>y-b),m=Math.floor(u.length/2),f=u.length%2?u[m]:(u[m-1]+u[m])/2,h=Math.max(...a.values.map(y=>Math.abs(y))),_=f*h;if(f>0&&_>0)for(let y of l){let b=a.values[c[y]],g=f*b,w=Math.abs(o[y].extent-g)/_;if(w<=ju)continue;let O=o[y].unit==="%"?"%":"";ce(n,i,{code:Q.BAR_PROPORTION,line:ae(r,o[y].start),message:`The bar for ${JSON.stringify(a.labels[c[y]])} (value ${b}) is drawn at ${$s(o[y].extent)}${O}, but every other bar in this chart puts it at ${$s(g)}${O} \u2014 off by ${Math.round(w*100)}% of the full-scale bar. The chart misrepresents the data.`,hint:"Every bar in one chart must use the SAME value\u2192length scale. Compute each length from its datum with one formula (value / max * 100), never by writing the numbers out by hand."})}}let d=a.values.reduce((u,m)=>u+m,0),p=Math.max(...a.values.map(u=>Math.abs(u)));for(let u=0;u<o.length;u+=1){let m=a.values[c[u]],f=o[u].context;if(!f)continue;let h=(f.match(/-?\d[\d,]*(?:\.\d+)?/g)||[]).map(_=>Number(_.replace(/,/g,""))).filter(_=>Number.isFinite(_));h.length&&(h.some(_=>Math.abs(_-m)<1e-9)||d>0&&h.some(_=>Math.abs(_-m/d*100)<.6)||p>0&&h.some(_=>Math.abs(_-m/p*100)<.6)||ce(n,i,{code:Q.VALUE_MISMATCH,line:ae(r,o[u].start),message:`The row for ${JSON.stringify(a.labels[c[u]])} prints ${h.slice(0,3).join(", ")} but its datum is ${m}.`,hint:"Print the figure your tools returned, unchanged, and use that same figure everywhere it appears on the page."}))}}}var rm=/^(flex|inline-flex|grid|inline-grid)$/;function nm(r,t,e,n,i,s){let o=0;Le(t,a=>{if(Zr.has(a.tag))return;let c=yt(a.attrs.style).width;if(!c)return;let l=Bs(c);if(l==null||l<=0||!Js(a,e))return;o+=1;let d=Ps(a,e);if(d==="none"){ce(n,i,{code:Q.ZERO_WIDTH,line:ae(r,a.start),message:`<${a.tag}> is given style="width:${c}" but its effective display is \`none\` \u2014 it is not rendered at all.`,hint:"Remove the display:none rule that matches this element, or remove the element. A width on a display:none box is dead code."});return}if(d!=="inline")return;let p=a.parent;if(p&&p.tag!=="#root"&&rm.test(Ps(p,e)))return;let u=fe(a,"position",e);if(u==="absolute"||u==="fixed")return;let m=fe(a,"float",e);m==="left"||m==="right"||ce(n,i,{code:Q.ZERO_WIDTH,line:ae(r,a.start),message:`<${a.tag}${a.attrs.class?` class="${a.attrs.class}"`:""}> is given style="width:${c}" but its effective display is \`inline\` \u2014 CSS IGNORES width on a non-replaced inline box, so this bar renders with no length at all. The source looks right; the page will not.`,hint:"Give the bar display:block or display:inline-block (or make its container display:flex). A <span> is inline by DEFAULT \u2014 that alone is enough to swallow the width."})}),s.percentWidthBars=o}function im(r,t,e,n,i){Le(t,s=>{let o=Wr(fe(s,"width",e));if(!(o==null||o<=0))for(let a=s.parent;a&&a.tag!=="#root";a=a.parent){let c=Wr(fe(a,"width",e));if(c==null||c<=0)continue;if(o<=c)return;let l=fe(a,"overflow",e)||fe(a,"overflow-x",e);if(l!=="hidden"&&l!=="clip")return;ce(n,i,{code:Q.OVERFLOW,line:ae(r,s.start),message:`<${s.tag}> is ${o}px wide inside a ${c}px ancestor with overflow:${l} \u2014 ${Math.round(o-c)}px of it is clipped and can never be seen.`,hint:"Size the child from its container (a percentage, or max-width:100%), or widen the container. Content the reader cannot see is content you did not publish."});return}})}var sm=[{re:/\[object (?:Object|Array|Promise|Map|Set|Null|Undefined)\]/g,what:"an object stringified instead of a field being picked off it"},{re:/\$\{[^}\n]{0,80}\}/g,what:"an un-substituted JavaScript template placeholder"},{re:/\{\{[^}\n]{0,80}\}\}/g,what:"an un-substituted moustache placeholder"},{re:/(?:^|[^\w.])(NaN)(?![\w])/g,what:"NaN \u2014 an arithmetic result that was never a number"},{re:/(?:^|[^\w.])(-?Infinity)(?![\w])/g,what:"Infinity \u2014 a division by zero reached the page"}],om=/^(undefined|null)$/i,am=new Set(["td","th","li","span","div","strong","em","b"]);function cm(r,t,e,n,i){let s=0;for(let o of qu(t)){let a=o.value;s+=a.length;for(let l of sm){l.re.lastIndex=0;let d;for(;(d=l.re.exec(a))!==null;){let p=d[1]==null?d[0]:d[1];ce(e,n,{code:Q.PLACEHOLDER_TEXT,line:ae(r,o.start+d.index+d[0].indexOf(p)),message:`The page prints ${JSON.stringify(p.slice(0,60))} as VISIBLE TEXT \u2014 ${l.what}. A reader sees this literally.`,hint:"Format the value before it reaches the page: pick the field you meant off the object, and guard the arithmetic so a missing input renders as an em dash rather than NaN."}),d.index===l.re.lastIndex&&(l.re.lastIndex+=1)}}let c=Cs(a).trim();om.test(c)&&am.has(o.parent.tag)&&ce(e,n,{code:Q.PLACEHOLDER_TEXT,line:ae(r,o.start),message:`A <${o.parent.tag}> contains only the literal text "${c}" \u2014 the value it was meant to hold was ${c}.`,hint:'Render an em dash (\u2014) or "n/a" for a missing value; never let the JavaScript literal reach the reader.'})}i.textCharsScanned=s}function ir({html:r,data:t}){let e=typeof r=="string"?r:"",n=[],i={};if(!e.trim())return{ok:!1,defects:[{code:"empty-content",line:1,message:"No html was passed to the check.",hint:"Pass the exact page source you are about to publish."}],checked:{tables:0,bodyRows:0,bars:0,barGroups:[],boundBars:0,seriesInData:0,collections:[]}};let s=Du(e),o=Mu(s),a=Vu(s),c=Zu(s,o),l=Gu(t),d={tables:a.length,bodyRows:a.reduce((p,u)=>p+u.rows.length,0),bars:c.reduce((p,u)=>p+u.length,0),barGroups:[],boundBars:0,seriesInData:l.series.length,collections:[]};return Xu(e,s,a,l.collections,n,i,d.collections),tm(e,c,l.series,n,i,d),nm(e,s,o,n,i,d),im(e,s,o,n,i),cm(e,s,n,i,d),n.sort((p,u)=>(p.line||0)-(u.line||0)),{ok:n.length===0,defects:n,checked:d}}function lm(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Tu(Au(import.meta.url)),t=Ru(r,"..","bin","mcp-skill.mjs");return Ou(t)?t:null}var Ds={id:"report-check",serverName:"report_check",allowedTools:["mcp__report_check__*"],envKeys:[],description:"Report check \u2014 verify a rendered report page against the DATA it was built from (row counts, bar proportionality, collapsed bars, placeholder residue) before publishing it.",promptFragment:`## Report Check (run this BEFORE you publish a data page)
794
794
  When you are about to publish a page that RENDERS DATA \u2014 a table of records, a
795
795
  bar chart, a set of meters \u2014 call \`report_check\` first with the exact \`html\`
796
796
  you are about to publish and the \`data\` you built it from (the raw tool
@@ -806,9 +806,9 @@ from the data by itself.
806
806
 
807
807
  Then READ the \`checked\` block in the result: it says how many tables, rows and
808
808
  bars were actually found. If it reports 0 bars for a page full of bars, the check
809
- never saw your chart and a clean verdict means nothing.`,resolve(){let r=lm();return r?{type:"stdio",command:"node",args:[r,"../dist/reportCheck.js","reportCheckSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,t){if(r!=="report_check")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=typeof t?.html=="string"?t.html:"";if(!e.trim())return JSON.stringify({error:"html is required \u2014 pass the exact page source you are about to publish."});let n=t?.data;if(typeof n=="string")try{n=JSON.parse(n)}catch{return JSON.stringify({error:"data was a string but not valid JSON \u2014 pass the data as a JSON object."})}return n==null?JSON.stringify({error:"data is required \u2014 pass the tool results the page was built from, unchanged."}):JSON.stringify(ir({html:e,data:n}))}catch(e){return JSON.stringify({error:`report_check failed: ${e.message}`})}},tools:[{name:"report_check",description:'Pre-flight a data page BEFORE publishing it: compares the rendered HTML against the DATA it was built from and reports every place they disagree. Catches what the publish validator structurally cannot \u2014 a table that renders fewer rows than the data has records, a bar drawn at a length that is not proportional to its value, a number printed beside a bar that is not that bar\'s datum, a bar whose width is silently nullified by the CSS cascade, and placeholder residue ([object Object], NaN, an un-substituted ${\u2026}) left in visible text. Pass the data UNCHANGED, exactly as your tools returned it (wrap a bare array as {"rows": [...]}) \u2014 the check discovers the collections and series inside it and derives what must be true on its own. Do NOT write your own expectations. Returns { ok, defects:[{code,line,message,hint}], checked }. Always read `checked`: it reports how many tables, rows and bars were found, so a clean `ok:true` with `bars: 0` on a chart page tells you the check never saw your chart.',input_schema:{type:"object",properties:{html:{type:"string",description:"The exact HTML you are about to publish (the same string you would pass to artifact_publish)."},data:{type:"object",description:'The data the page was built from, as JSON \u2014 the raw tool results. Any shape: arrays of records and label/value series are found automatically. Wrap a bare top-level array as {"rows": [...]}.'}},required:["html","data"]}}]};function gm(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=fm(ym(import.meta.url)),t=hm(r,"..","bin","mcp-skill.mjs");return Zs(t)?t:null}function bt(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=mm(um(),".zibby","config.json");return Zs(r)&&JSON.parse(pm(r,"utf-8")).sessionToken||null}catch{return null}}function _t(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function bm(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function Vs(r){return`${bm()}:artifact:${r}`}var Ye="headings, paragraphs, **bold**, *italic*, `inline code`, fenced code blocks, bullet + numbered lists, blockquotes, horizontal rules, links, and GitHub-style pipe tables (including |---:| alignment)",or="raw HTML (tags are escaped and print as literal text), images, nested lists, footnotes and strikethrough",gt=2,We=0;function Xr(r,t){return JSON.stringify({published:!1,stop:!0,attemptsUsed:gt,defects:t||[],error:r,instruction:`STOP. You have used both publish attempts and the page is still rejected. Do NOT call artifact_publish or artifact_update again in this turn. Tell the user plainly that you could not produce a clean page, say in one line what was wrong, and give them the content directly in the chat instead. A broken link is worse than an honest "I couldn't".`})}function _m(r,t,e){return JSON.stringify({published:!1,stop:!1,attemptsRemaining:gt-We,defects:e||[],error:t,instruction:"The page was NOT published and no URL exists. Fix EXACTLY the defects listed above and call once more \u2014 you get ONE more attempt, then this tool will stop you."+(r==="html"?` You are on the \`html\` path, where you author the entire document and every mistake ships. Unless this page genuinely needs a custom visual layout, the fastest and most reliable fix is to re-send the SAME content as \`markdown\` \u2014 Zibby then generates the document skeleton, CSS and tables for you and these defects become impossible. Markdown supports ${Ye}.`:` Markdown supports ${Ye}; it does NOT support ${or}.`)})}var qs="The page WAS published and the url is valid. This only means the data\u2194render pre-flight could not reach a verdict \u2014 nothing is known to be wrong. Open the page yourself if the figures matter.";function km(r){let t=new Set,e=(r||[]).map((i,s)=>{let o=i.line?` line ${i.line}:`:"",a="";return i.hint&&!t.has(i.code)&&(t.add(i.code),a=` \u2014 ${i.hint}`),`${s+1}. [${i.code}]${o} ${i.message}${a}`}),n=e.length;return`Artifact NOT published and NOTHING was sent \u2014 the page was checked against the \`data\` you passed and disagrees with it in ${n} place${n===1?"":"s"}:
809
+ never saw your chart and a clean verdict means nothing.`,resolve(){let r=lm();return r?{type:"stdio",command:"node",args:[r,"../dist/reportCheck.js","reportCheckSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,t){if(r!=="report_check")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=typeof t?.html=="string"?t.html:"";if(!e.trim())return JSON.stringify({error:"html is required \u2014 pass the exact page source you are about to publish."});let n=t?.data;if(typeof n=="string")try{n=JSON.parse(n)}catch{return JSON.stringify({error:"data was a string but not valid JSON \u2014 pass the data as a JSON object."})}return n==null?JSON.stringify({error:"data is required \u2014 pass the tool results the page was built from, unchanged."}):JSON.stringify(ir({html:e,data:n}))}catch(e){return JSON.stringify({error:`report_check failed: ${e.message}`})}},tools:[{name:"report_check",description:'Pre-flight a data page BEFORE publishing it: compares the rendered HTML against the DATA it was built from and reports every place they disagree. Catches what the publish validator structurally cannot \u2014 a table that renders fewer rows than the data has records, a bar drawn at a length that is not proportional to its value, a number printed beside a bar that is not that bar\'s datum, a bar whose width is silently nullified by the CSS cascade, and placeholder residue ([object Object], NaN, an un-substituted ${\u2026}) left in visible text. Pass the data UNCHANGED, exactly as your tools returned it (wrap a bare array as {"rows": [...]}) \u2014 the check discovers the collections and series inside it and derives what must be true on its own. Do NOT write your own expectations. Returns { ok, defects:[{code,line,message,hint}], checked }. Always read `checked`: it reports how many tables, rows and bars were found, so a clean `ok:true` with `bars: 0` on a chart page tells you the check never saw your chart.',input_schema:{type:"object",properties:{html:{type:"string",description:"The exact HTML you are about to publish (the same string you would pass to artifact_publish)."},data:{type:"object",description:'The data the page was built from, as JSON \u2014 the raw tool results. Any shape: arrays of records and label/value series are found automatically. Wrap a bare top-level array as {"rows": [...]}.'}},required:["html","data"]}}]};function gm(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=fm(ym(import.meta.url)),t=hm(r,"..","bin","mcp-skill.mjs");return Zs(t)?t:null}function bt(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=mm(um(),".zibby","config.json");return Zs(r)&&JSON.parse(pm(r,"utf-8")).sessionToken||null}catch{return null}}function _t(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function bm(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function Vs(r){return`${bm()}:artifact:${r}`}var Ye="headings, paragraphs, **bold**, *italic*, `inline code`, fenced code blocks, bullet + numbered lists, blockquotes, horizontal rules, links, and GitHub-style pipe tables (including |---:| alignment)",or="raw HTML (tags are escaped and print as literal text), images, nested lists, footnotes and strikethrough",gt=2,We=0;function Xr(r,t){return JSON.stringify({published:!1,stop:!0,attemptsUsed:gt,defects:t||[],error:r,instruction:`STOP. You have used both publish attempts and the page is still rejected. Do NOT call artifact_publish or artifact_update again in this turn. Tell the user plainly that you could not produce a clean page, say in one line what was wrong, and give them the content directly in the chat instead. A broken link is worse than an honest "I couldn't".`})}function _m(r,t,e){return JSON.stringify({published:!1,stop:!1,attemptsRemaining:gt-We,defects:e||[],error:t,instruction:"The page was NOT published and no URL exists. Fix EXACTLY the defects listed above and call once more \u2014 you get ONE more attempt, then this tool will stop you."+(r==="html"?` You are on the \`html\` path, where you author the entire document and every mistake ships. Unless this page genuinely needs a custom visual layout, the fastest and most reliable fix is to re-send the SAME content as \`markdown\` \u2014 Zibby then generates the document skeleton, CSS and tables for you and these defects become impossible. Markdown supports ${Ye}.`:` Markdown supports ${Ye}; it does NOT support ${or}.`)})}var qs="The page WAS published and the url is valid. This only means the data\u2194render pre-flight could not reach a verdict \u2014 nothing is known to be wrong. Open the page yourself if the figures matter.";function wm(r){let t=new Set,e=(r||[]).map((i,s)=>{let o=i.line?` line ${i.line}:`:"",a="";return i.hint&&!t.has(i.code)&&(t.add(i.code),a=` \u2014 ${i.hint}`),`${s+1}. [${i.code}]${o} ${i.message}${a}`}),n=e.length;return`Artifact NOT published and NOTHING was sent \u2014 the page was checked against the \`data\` you passed and disagrees with it in ${n} place${n===1?"":"s"}:
810
810
  ${e.join(`
811
- `)}`}function wm(r,t){let e;try{e=ir({html:r,data:t})}catch(s){return{unverified:{status:"unverified",reason:`the data\u2194render pre-flight threw and was skipped: ${String(s?.message||s).slice(0,200)}`,note:qs}}}if(!e?.ok)return{rejected:{message:km(e?.defects),defects:e?.defects||[]}};let n=e.checked||{};return(Number(n.tables)||0)+(Number(n.bars)||0)===0?{unverified:{status:"unverified",reason:"the pre-flight found no tables and no bars in this page, so it had nothing to compare against your data \u2014 a clean result here proves nothing",checked:n,note:qs}}:null}function Ms(r,t,e){return We+=1,{__rejected:!0,payload:We>=gt?Xr(t,e):_m(r,t,e)}}async function Sm(r){let t=bt();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let e=await fetch(`${_t()}/credits/artifacts`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!e.ok){let n=await e.text().catch(()=>""),i=null;try{i=JSON.parse(n)}catch{}let s=new Error(e.status===422&&i?.error?i.error:`artifact write failed (${e.status}): ${n.slice(0,300)}`);throw s.status=e.status,Array.isArray(i?.defects)&&(s.defects=i.defects),s}return e.json()}async function Fs(r,t,e){let n=e?wm(e.html,e.data):null;if(n?.rejected)return Ms(t,n.rejected.message,n.rejected.defects);try{let i=await Sm(r);return We=0,n?.unverified&&(i.__preflightNote=n.unverified),i}catch(i){if(i?.status!==422)throw i;return Ms(t,i.message,i.defects)}}async function Xs(r){let t=bt();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let e=await fetch(`${_t()}/credits/artifacts/${encodeURIComponent(r)}`,{method:"GET",headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`artifact get failed (${e.status}): ${n.slice(0,300)}`)}return e.json()}async function Ks(r,t,e={}){let n=bt();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let i=await fetch(`${_t()}/credits/artifacts/${encodeURIComponent(r)}/${t}`,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!i.ok){let s=await i.text().catch(()=>""),o=null;try{o=JSON.parse(s)}catch{}throw new Error(o?.error||`artifact ${t} failed (${i.status}): ${s.slice(0,300)}`)}return i.json()}var Vr=60;function Gs(r,t){let e=Math.max(0,t-Math.floor(Vr/2)),i=r.slice(e,e+Vr).replace(/\n/g,"\\n").replace(/\r/g,"\\r").replace(/\t/g,"\\t");return(e>0?"\u2026":"")+i+(e+Vr<r.length?"\u2026":"")}function vm(r,t){if(r===t)return null;let e=Math.min(r.length,t.length),n=0;for(;n<e&&r[n]===t[n];)n+=1;return{kind:n===e?t.length<r.length?"truncated":"longer":"diverged",sentChars:r.length,storedChars:t.length,delta:t.length-r.length,firstDiffAt:n,sentExcerpt:Gs(r,n),storedExcerpt:Gs(t,n)}}var sr="Read-back compares the STORED SOURCE with what was sent (transport/storage integrity only). It does NOT check that the page renders correctly.";async function Hs(r,t){let e;try{e=await Xs(r)}catch(s){return{status:"unverified",scope:sr,reason:`read-back request failed: ${String(s?.message||s).slice(0,200)}`,note:"The page WAS published and the url is valid \u2014 this only means the extra integrity check could not run. No action needed."}}let n=e?.content;if(typeof n!="string")return{status:"unverified",scope:sr,reason:"read-back returned no content field",note:"The page WAS published and the url is valid \u2014 this only means the extra integrity check could not run. No action needed."};if(n===""&&t!=="")return{status:"unverified",scope:sr,reason:"read-back returned empty content, which the backend also returns when its object-store read errors \u2014 indistinguishable, so this is inconclusive rather than a mismatch",note:"The page WAS published and the url is valid. If the page looks blank when opened, re-send the same content with artifact_update."};let i=vm(t,n);return i?{status:"mismatch",scope:sr,...i,note:`The stored page source is NOT what was sent (${i.kind}: sent ${i.sentChars} chars, stored ${i.storedChars}, first difference at character ${i.firstDiffAt}). The url exists and the page is live, so do NOT re-publish a new one. You may call artifact_update ONCE with the identical content to rewrite the blob; if it differs again, stop and tell the user the published page may be incomplete rather than retrying.`}:null}async function zs(r,t){let e=bt();if(!e)return;let n=await fetch(`${_t()}/credits/review-memory`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({op:"store",scope:Vs(r),content:JSON.stringify(t)})});if(!n.ok){let i=await n.text().catch(()=>"");throw new Error(`artifact index write failed (${n.status}): ${i.slice(0,200)}`)}}async function Im(r){let t=bt();if(!t)return null;let e=await fetch(`${_t()}/credits/review-memory`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify({op:"recall",scope:Vs(r)})});if(!e.ok)return null;let n=await e.json().catch(()=>null);if(!n?.found||!n?.memory?.content)return null;try{return JSON.parse(n.memory.content)}catch{return null}}function Ys(r){let t=typeof r?.html=="string"&&r.html.length>0,e=typeof r?.markdown=="string"&&r.markdown.length>0;return t&&e?{error:"Pass EITHER markdown OR html, not both \u2014 they are different rendering paths. Use markdown unless the page needs a custom visual layout."}:e?{format:"markdown",content:r.markdown}:t?{format:"html",content:r.html}:null}function Ws(r,t){let e=r?.data;if(e==null)return null;if(!t||t.format!=="html")return{error:"`data` is only meaningful together with `html`. The pre-flight reads a rendered HTML document (tables, bars, CSS), so on the markdown path it would check nothing while reporting a clean page \u2014 that is worse than not checking. Re-send WITHOUT `data`. Do NOT switch to `html` just to get the check: on the markdown path Zibby generates the document, so the collapsed-bar and broken-geometry defects it looks for cannot happen there in the first place."};let n=e;if(typeof n=="string")try{n=JSON.parse(n)}catch{return{error:'`data` was a string but not valid JSON \u2014 pass the tool results as a JSON object (wrap a bare array as {"rows": [...]}).'}}return{preflight:{html:t.content,data:n}}}var Qs={id:"artifact",callsBackend:!0,meta:dm.artifact,serverName:"artifact",allowedTools:["mcp__artifact__*"],description:"Artifacts \u2014 publish a self-contained, shareable HTML/Markdown page to Zibby and get back a URL; the index of what you published is your memory.",promptFragment:`## Artifacts (publish a shareable page, remember what you made)
811
+ `)}`}function km(r,t){let e;try{e=ir({html:r,data:t})}catch(s){return{unverified:{status:"unverified",reason:`the data\u2194render pre-flight threw and was skipped: ${String(s?.message||s).slice(0,200)}`,note:qs}}}if(!e?.ok)return{rejected:{message:wm(e?.defects),defects:e?.defects||[]}};let n=e.checked||{};return(Number(n.tables)||0)+(Number(n.bars)||0)===0?{unverified:{status:"unverified",reason:"the pre-flight found no tables and no bars in this page, so it had nothing to compare against your data \u2014 a clean result here proves nothing",checked:n,note:qs}}:null}function Ms(r,t,e){return We+=1,{__rejected:!0,payload:We>=gt?Xr(t,e):_m(r,t,e)}}async function Sm(r){let t=bt();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let e=await fetch(`${_t()}/credits/artifacts`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!e.ok){let n=await e.text().catch(()=>""),i=null;try{i=JSON.parse(n)}catch{}let s=new Error(e.status===422&&i?.error?i.error:`artifact write failed (${e.status}): ${n.slice(0,300)}`);throw s.status=e.status,Array.isArray(i?.defects)&&(s.defects=i.defects),s}return e.json()}async function Fs(r,t,e){let n=e?km(e.html,e.data):null;if(n?.rejected)return Ms(t,n.rejected.message,n.rejected.defects);try{let i=await Sm(r);return We=0,n?.unverified&&(i.__preflightNote=n.unverified),i}catch(i){if(i?.status!==422)throw i;return Ms(t,i.message,i.defects)}}async function Xs(r){let t=bt();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let e=await fetch(`${_t()}/credits/artifacts/${encodeURIComponent(r)}`,{method:"GET",headers:{Authorization:`Bearer ${t}`}});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`artifact get failed (${e.status}): ${n.slice(0,300)}`)}return e.json()}async function Ks(r,t,e={}){let n=bt();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). Artifacts are only available inside a Zibby run.");let i=await fetch(`${_t()}/credits/artifacts/${encodeURIComponent(r)}/${t}`,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!i.ok){let s=await i.text().catch(()=>""),o=null;try{o=JSON.parse(s)}catch{}throw new Error(o?.error||`artifact ${t} failed (${i.status}): ${s.slice(0,300)}`)}return i.json()}var Vr=60;function Gs(r,t){let e=Math.max(0,t-Math.floor(Vr/2)),i=r.slice(e,e+Vr).replace(/\n/g,"\\n").replace(/\r/g,"\\r").replace(/\t/g,"\\t");return(e>0?"\u2026":"")+i+(e+Vr<r.length?"\u2026":"")}function vm(r,t){if(r===t)return null;let e=Math.min(r.length,t.length),n=0;for(;n<e&&r[n]===t[n];)n+=1;return{kind:n===e?t.length<r.length?"truncated":"longer":"diverged",sentChars:r.length,storedChars:t.length,delta:t.length-r.length,firstDiffAt:n,sentExcerpt:Gs(r,n),storedExcerpt:Gs(t,n)}}var sr="Read-back compares the STORED SOURCE with what was sent (transport/storage integrity only). It does NOT check that the page renders correctly.";async function Hs(r,t){let e;try{e=await Xs(r)}catch(s){return{status:"unverified",scope:sr,reason:`read-back request failed: ${String(s?.message||s).slice(0,200)}`,note:"The page WAS published and the url is valid \u2014 this only means the extra integrity check could not run. No action needed."}}let n=e?.content;if(typeof n!="string")return{status:"unverified",scope:sr,reason:"read-back returned no content field",note:"The page WAS published and the url is valid \u2014 this only means the extra integrity check could not run. No action needed."};if(n===""&&t!=="")return{status:"unverified",scope:sr,reason:"read-back returned empty content, which the backend also returns when its object-store read errors \u2014 indistinguishable, so this is inconclusive rather than a mismatch",note:"The page WAS published and the url is valid. If the page looks blank when opened, re-send the same content with artifact_update."};let i=vm(t,n);return i?{status:"mismatch",scope:sr,...i,note:`The stored page source is NOT what was sent (${i.kind}: sent ${i.sentChars} chars, stored ${i.storedChars}, first difference at character ${i.firstDiffAt}). The url exists and the page is live, so do NOT re-publish a new one. You may call artifact_update ONCE with the identical content to rewrite the blob; if it differs again, stop and tell the user the published page may be incomplete rather than retrying.`}:null}async function zs(r,t){let e=bt();if(!e)return;let n=await fetch(`${_t()}/credits/review-memory`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({op:"store",scope:Vs(r),content:JSON.stringify(t)})});if(!n.ok){let i=await n.text().catch(()=>"");throw new Error(`artifact index write failed (${n.status}): ${i.slice(0,200)}`)}}async function Im(r){let t=bt();if(!t)return null;let e=await fetch(`${_t()}/credits/review-memory`,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify({op:"recall",scope:Vs(r)})});if(!e.ok)return null;let n=await e.json().catch(()=>null);if(!n?.found||!n?.memory?.content)return null;try{return JSON.parse(n.memory.content)}catch{return null}}function Ys(r){let t=typeof r?.html=="string"&&r.html.length>0,e=typeof r?.markdown=="string"&&r.markdown.length>0,n=typeof r?.text=="string"&&r.text.length>0;return n&&(t||e)?{error:"Pass exactly ONE of markdown, html or text \u2014 text is raw source stored as-is (code/logs/JSON/CSV); markdown and html are rendered documents."}:t&&e?{error:"Pass EITHER markdown OR html, not both \u2014 they are different rendering paths. Use markdown unless the page needs a custom visual layout."}:e?{format:"markdown",content:r.markdown}:t?{format:"html",content:r.html}:n?{format:"text",content:r.text}:null}function Ws(r,t){let e=r?.data;if(e==null)return null;if(!t||t.format!=="html")return{error:"`data` is only meaningful together with `html`. The pre-flight reads a rendered HTML document (tables, bars, CSS), so on the markdown path it would check nothing while reporting a clean page \u2014 that is worse than not checking. Re-send WITHOUT `data`. Do NOT switch to `html` just to get the check: on the markdown path Zibby generates the document, so the collapsed-bar and broken-geometry defects it looks for cannot happen there in the first place."};let n=e;if(typeof n=="string")try{n=JSON.parse(n)}catch{return{error:'`data` was a string but not valid JSON \u2014 pass the tool results as a JSON object (wrap a bare array as {"rows": [...]}).'}}return{preflight:{html:t.content,data:n}}}var Qs={id:"artifact",callsBackend:!0,meta:dm.artifact,serverName:"artifact",allowedTools:["mcp__artifact__*"],description:"Artifacts \u2014 publish a self-contained, shareable HTML/Markdown page to Zibby and get back a URL; the index of what you published is your memory.",promptFragment:`## Artifacts (publish a shareable page, remember what you made)
812
812
  You can PUBLISH a standalone page \u2014 a status report, a plan, a comparison table,
813
813
  a dashboard-y summary, a diagram, a "here's what I found" write-up \u2014 and get back
814
814
  a shareable URL.
@@ -874,9 +874,13 @@ Tools:
874
874
  page renders a dataset (see above). Optional \`kind\` (e.g. "report", "plan",
875
875
  "dashboard"), \`favicon\` (an emoji), and \`summary\` (one line for your own
876
876
  index). Returns { id, url }. Share the url; keep the id if you'll update it
877
- later.
877
+ later. To publish RAW SOURCE instead of a page \u2014 code, a script, logs, JSON
878
+ data, CSV \u2014 pass \`text\` + \`contentType\` (text/plain | application/json |
879
+ text/csv): it is stored verbatim and shown in a read-only code viewer. For
880
+ code, make the \`title\` the filename (e.g. "deploy.sh") and set kind "code".
878
881
  - artifact_update: Revise an EXISTING page by \`id\` (same url, new version). Pass
879
- the fields to change (\`title\`, \`markdown\`|\`html\`).
882
+ the fields to change (\`title\`, \`markdown\`|\`html\`|\`text\` \u2014 text only onto a
883
+ text artifact, same type).
880
884
  - artifact_get: Fetch one artifact by \`id\` \u2192 { metadata, content } so you can
881
885
  reuse / edit / re-publish it.
882
886
  - artifact_share: Make a page readable WITHOUT a Zibby login \u2192 { url, password }.
@@ -907,7 +911,7 @@ sharing it silently.
907
911
  To recall WHAT YOU HAVE ALREADY PUBLISHED, use your kv-memory tool
908
912
  kv_recall_prefix with keyPrefix "artifact:" \u2014 each entry is the index record
909
913
  { id, title, url, kind, createdAt, summary } for a page you made. (Publishing
910
- records this automatically; you don't store it yourself.)`,resolve(){let r=gm();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/artifact.js","artifactSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"artifact_publish":{if(We>=gt)return Xr("Publish budget already spent this turn.",[]);let e=typeof t?.title=="string"?t.title.trim():"";if(!e)return JSON.stringify({error:"title is required"});let n=Ys(t);if(!n)return JSON.stringify({error:"provide exactly one of markdown (preferred) or html (non-empty string)"});if(n.error)return JSON.stringify({error:n.error});let i=Ws(t,n);if(i?.error)return JSON.stringify({error:i.error});let s={title:e,[n.format]:n.content};typeof t?.kind=="string"&&t.kind.trim()&&(s.kind=t.kind.trim()),typeof t?.favicon=="string"&&t.favicon.trim()&&(s.favicon=t.favicon.trim()),t?.share===!0&&(s.share=!0);let o=await Fs(s,n.format,i?.preflight);if(o?.__rejected)return o.payload;let a=o?.id,c=o?.url;if(!a||!c)return JSON.stringify({error:"artifact write returned no id/url",response:o});let l={id:a,url:c};o.shared&&(l.shared=!0,l.shareUrl=o.shareUrl,l.password=o.password,l.instruction="Send BOTH the shareUrl and the password in your reply. Copy the password EXACTLY \u2014 it is case-sensitive, shown once, and cannot be looked up again (artifact_share issues a new one, which kills this one)."),o.__preflightNote&&(l.preflight=o.__preflightNote);let d=await Hs(a,n.content);d&&(l.readBack=d);let p={id:a,title:e,url:c,kind:s.kind||null,createdAt:o.createdAt||new Date().toISOString(),summary:typeof t?.summary=="string"&&t.summary.trim()?t.summary.trim():e};try{await zs(a,p)}catch(u){l.indexWarning=u.message}return JSON.stringify(l)}case"artifact_update":{if(We>=gt)return Xr("Publish budget already spent this turn.",[]);let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=Ys(t);if(n?.error)return JSON.stringify({error:n.error});let i=typeof t?.title=="string"?t.title.trim():"";if(!n&&!i)return JSON.stringify({error:"nothing to update \u2014 pass a new title and/or markdown|html"});let s=Ws(t,n);if(s?.error)return JSON.stringify({error:s.error});let o={id:e};i&&(o.title=i),n&&(o[n.format]=n.content),typeof t?.kind=="string"&&t.kind.trim()&&(o.kind=t.kind.trim()),typeof t?.favicon=="string"&&t.favicon.trim()&&(o.favicon=t.favicon.trim());let a=await Fs(o,n?.format,s?.preflight);if(a?.__rejected)return a.payload;let c=a?.url;if(!c)return JSON.stringify({error:"artifact update returned no url",response:a});let l={id:e,url:c};if(a.__preflightNote&&(l.preflight=a.__preflightNote),n){let u=await Hs(e,n.content);u&&(l.readBack=u)}let d=await Im(e)||{},p={...d,id:e,url:c,title:i||d.title||"Untitled",kind:o.kind||d.kind||null,createdAt:d.createdAt||a.createdAt||new Date().toISOString(),updatedAt:a.updatedAt||new Date().toISOString()};typeof t?.summary=="string"&&t.summary.trim()?p.summary=t.summary.trim():p.summary||(p.summary=p.title);try{await zs(e,p)}catch(u){l.indexWarning=u.message}return JSON.stringify(l)}case"artifact_get":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Xs(e);return JSON.stringify(n)}case"artifact_share":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Ks(e,"protect");return JSON.stringify({id:n.id,url:n.url,password:n.password,shared:!0,instruction:"Send BOTH the url and the password to the person who asked. Copy the password EXACTLY \u2014 it is case-sensitive and cannot be recovered later (call artifact_share again to issue a new one)."})}case"artifact_unshare":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Ks(e,"unprotect");return JSON.stringify({id:n.id,shared:!1,wasShared:n.wasShared})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"artifact_publish",description:`Publish a NEW self-contained, shareable page (report/plan/table/dashboard/diagram/write-up) and get back a shareable URL. USE \`markdown\` \u2014 it is the default path and Zibby generates the entire document for you (doctype, head, CSS, dark mode, table styling); you supply only the content, so the page cannot come out malformed. Markdown supports ${Ye}; it does NOT support ${or}. Use \`html\` ONLY when the page needs a visual layout Markdown cannot express (a bar chart, a gauge, a custom grid, an SVG diagram) \u2014 on that path you author the whole document and every mistake ships verbatim. Never pass both. Every figure on the page must come from a tool result or this conversation \u2014 do not do arithmetic in prose and print the result, and use the same number everywhere it appears. The content MUST come from the current conversation or data you fetched this turn; if you are not sure what the page should be about, ASK instead of calling this tool, and never publish a demo/sample/placeholder or an account-overview page as a stand-in. On the html path keep all CSS/JS/images INLINE (inline <style>/<script>, data: URIs) and send real tags (never &lt;escaped&gt; markup) \u2014 the page is sandboxed on view with no network at all, so every external URL is dead. PASS \`data\` WHENEVER THE HTML PAGE RENDERS A DATASET \u2014 a table of records, a bar chart, a row of meters. Give it the raw tool results the page was built from, unchanged; the page is then checked AGAINST that data before anything is sent, catching a table short of rows, a bar drawn at the wrong length, and leftover \${\u2026} or [object Object]. It costs you nothing when the page is right. Skip it for prose pages, and never pass it with \`markdown\` (that is an error, not a no-op). The content is VALIDATED before any URL exists: if it is broken \u2014 by that data check or by the server \u2014 you get the exact defects and line numbers back, you get ONE retry, and then the tool stops you. Both kinds of rejection share the SAME two attempts. Returns { id, url }. PASS \`share: true\` WHEN THE READERS HAVE NO ZIBBY ACCOUNT \u2014 you get back { shareUrl, password } in this same call, instead of publishing a link they cannot open and then having to call artifact_share. The password is GENERATED; you never invent one. Without \`share\` the page is member-only, which is the default and is correct for anything internal.`,input_schema:{type:"object",properties:{title:{type:"string",description:"The page title (also the browser tab title)."},markdown:{type:"string",description:`PREFERRED. The page content as Markdown \u2014 Zibby renders it into a styled, self-contained document, so you never author a skeleton. Supports ${Ye}. Does NOT support ${or}. Provide this OR html, never both.`},html:{type:"string",description:"The EXCEPTION path \u2014 only for a layout Markdown cannot express (bar chart, gauge, custom grid, SVG diagram). A self-contained HTML document or fragment, served VERBATIM: you own the doctype, head, CSS and every tag. All assets must be inline (<style>/<script>, data: URIs). Provide this OR markdown, never both."},data:{type:"object",description:'Optional, and worth passing WHENEVER the html page renders a dataset (a table of records, a bar chart, meters): the raw tool results the page was built from, as JSON, UNCHANGED \u2014 do not summarise it and do not write your own expectations, the check derives what must be true by itself (wrap a bare array as {"rows": [...]}). The page is then verified against it BEFORE publishing: row counts, bar lengths vs their values, bars whose width the CSS throws away, and placeholder residue. If they disagree nothing is sent and you get the defects back, using one of your two attempts. Only valid with `html` \u2014 passing it with `markdown` is an error.'},kind:{type:"string",description:'Optional label for what this is, e.g. "report", "plan", "dashboard", "diagram". Stored in your index.'},favicon:{type:"string",description:'Optional emoji used as the browser-tab icon, e.g. "\u{1F4CA}".'},summary:{type:"string",description:"Optional one-line summary for your own index (defaults to the title). Helps you recall later what this page was."},share:{type:"boolean",description:"Set true to publish the page WITH a password link in one step \u2014 the response then also carries { shareUrl, password }, which you send together. Use it whenever the people who asked are in a chat channel and have no Zibby account. Omit it (the default) for anything internal: the page is then readable only by logged-in members of this project, and no password exists."}},required:["title"]}},{name:"artifact_update",description:"Revise an EXISTING artifact by id \u2014 the shareable URL stays the same, the content is replaced (new version). Pass the fields to change (title and/or markdown|html). Prefer `markdown` for the same reason artifact_publish does: Zibby generates the document, so it cannot come out malformed. An update is validated exactly like a publish \u2014 including the optional `data` check when you send new `html` that renders a dataset \u2014 and if the new content is broken it is REFUSED, the page keeps its last good version, and the rejection shares the same two attempts as publish. Returns { id, url }.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to update (from a prior artifact_publish, or your kv-memory "artifact:" index).'},title:{type:"string",description:"New title (optional)."},markdown:{type:"string",description:`PREFERRED. New Markdown content (optional) \u2014 Zibby renders the document skeleton. Supports ${Ye}. Provide this OR html.`},html:{type:"string",description:"New HTML content (optional), served verbatim \u2014 only for layouts Markdown cannot express. Provide this OR markdown."},data:{type:"object",description:"Optional \u2014 same as on artifact_publish: when the new `html` renders a dataset, pass the raw tool results it was built from and the page is checked against them before anything is sent. Only valid alongside new `html`."},kind:{type:"string",description:"Optional updated kind label."},favicon:{type:"string",description:"Optional updated emoji favicon."},summary:{type:"string",description:"Optional updated one-line index summary."}},required:["id"]}},{name:"artifact_get",description:'Fetch ONE artifact you published, by id \u2192 { metadata, content }. Use to reuse / edit / re-publish a page. To LIST what you have published, use your kv-memory tool kv_recall_prefix with keyPrefix "artifact:".',input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id."}},required:["id"]}},{name:"artifact_share",description:"Make an artifact viewable WITHOUT a Zibby login, by password. Returns { url, password } \u2014 a link anyone can open plus the password that opens it. USE THIS when the people who need to read the page do not have Zibby accounts \u2014 the usual case is a Lark or Slack channel where you were asked for something and the channel members are not Zibby users. The normal artifact url only opens for logged-in members of this project, so for those recipients it is a dead link; this is what makes it readable. You MUST then send BOTH the url and the password in your reply, and copy the password EXACTLY (it is case-sensitive). It is shown ONCE and cannot be looked up afterwards \u2014 if it is lost, call this again to issue a new one, which also stops the old one working. Works on any artifact you published, old or new. Calling it again on an already-shared artifact replaces the password. Use artifact_unshare to revoke.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to share (from artifact_publish, or your kv-memory "artifact:" index).'}},required:["id"]}},{name:"artifact_unshare",description:`REMOVE an artifact's password \u2014 this is the tool for "take the password off", "remove the password", "stop sharing" and "revoke the link", which are all the same act. The page goes back to the DEFAULT it was published with: viewable only by logged-in members of this project, with no password anywhere. Immediate and total: anyone who already entered the password loses access too, not just new visitors. Safe to call on an artifact that was never shared. Note what this does NOT do: there is no way to leave a page open to anyone with the link and no password. Removing the password closes the anonymous door; it does not prop it open. Say that plainly if you are asked for a passwordless public link.`,input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id to stop sharing."}},required:["id"]}}]};import{createRequire as Nm}from"node:module";import{randomBytes as Om}from"node:crypto";import{existsSync as io,mkdirSync as Tm,writeFileSync as eo}from"node:fs";import{dirname as so,join as Ze,resolve as oo}from"node:path";import{fileURLToPath as ao}from"node:url";var co=Nm(import.meta.url),Qr=null;function Rm(){return Qr||(Qr=co("echarts")),Qr}var en=null;function Am(){return en||(en=co("@resvg/resvg-js")),en}var Em=800,xm=600,jm=4096,Lm=16,to=60,lo="Noto Sans",ro=256*1024;function $m(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=so(ao(import.meta.url)),t=oo(r,"..","bin","mcp-skill.mjs");return io(t)?t:null}function Pm(){let r=so(ao(import.meta.url)),t=oo(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(e=>Ze(t,e)).filter(e=>io(e))}function Cm(){let r=process.env.ZIBBY_NODE_SESSION_PATH,t=process.env.ZIBBY_SESSION_PATH,e=r||(t?Ze(t,"chart-render"):Ze(process.cwd(),".zibby","output","charts"));return Tm(e,{recursive:!0}),e}function $e(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function no(r,t){let e=Number(r);return Number.isFinite(e)?Math.max(Lm,Math.min(jm,Math.round(e))):t}function tn(r){return typeof r!="string"||r.length<=to?r:`${r.slice(0,to-1)}\u2026`}function ar(r){if(Array.isArray(r))for(let t=0;t<r.length;t++){let e=r[t];typeof e=="string"?r[t]=tn(e):$e(e)&&typeof e.name=="string"&&(e.name=tn(e.name))}}function Um(r){for(let n of["xAxis","yAxis"]){let i=Array.isArray(r[n])?r[n]:r[n]?[r[n]]:[];for(let s of i)$e(s)&&ar(s.data)}let t=Array.isArray(r.radar)?r.radar:r.radar?[r.radar]:[];for(let n of t)$e(n)&&ar(n.indicator);$e(r.legend)&&ar(r.legend.data);let e=Array.isArray(r.series)?r.series:r.series?[r.series]:[];for(let n of e)$e(n)&&(typeof n.name=="string"&&(n.name=tn(n.name)),ar(n.data))}function Bm(r){let t=JSON.parse(JSON.stringify(r));return t.animation=!1,t.backgroundColor==null&&(t.backgroundColor="#fff"),$e(t.textStyle)||(t.textStyle={}),t.textStyle.fontFamily==null&&(t.textStyle.fontFamily=lo),Um(t),t}function Jm(r){return typeof r!="string"?null:r.trim().replace(/\.(svg|png)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Dm(r,t,e){let i=Rm().init(null,null,{renderer:"svg",ssr:!0,width:t,height:e});try{return i.setOption(r),i.renderToSVGString()}finally{i.dispose()}}function qm(r){return r.replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi,"")}function Mm(r,t){return r.replace(/id="zr\d+-/g,`id="${t}-`).replace(/url\(#zr\d+-/g,`url(#${t}-`).replace(/class="zr\d+-/g,`class="${t}-`)}function Fm(r){let t=[];for(let e of r.matchAll(/(?:xlink:)?href\s*=\s*"([^"]*)"/gi)){let n=e[1].trim();n&&!n.startsWith("#")&&!/^data:/i.test(n)&&t.push(n)}for(let e of r.matchAll(/url\(\s*['"]?([^'")]*)['"]?\s*\)/gi)){let n=e[1].trim();n&&!n.startsWith("#")&&!/^data:/i.test(n)&&t.push(n)}return/@import/i.test(r)&&t.push("@import"),/<script\b/i.test(r)&&t.push("<script>"),/<foreignObject\b/i.test(r)&&t.push("<foreignObject>"),t}function Km(r){let t=Mm(qm(r),`chart-${Om(4).toString("hex")}`),e=Fm(t);if(e.length){let n=[...new Set(e)].slice(0,3).join(", ");throw new Error(`the rendered chart references external resources (${n}), which a self-contained HTML page blocks. Remove image:// symbols / external image fills from the spec (use plain colors or a data: URI), or use output:'svg' to write a file instead.`)}return t}function Gm(r){let{Resvg:t}=Am();return new t(r,{font:{fontFiles:Pm(),loadSystemFonts:!0,defaultFontFamily:lo}}).render().asPng()}var po={id:"chart-render",serverName:"chart_render",allowedTools:["mcp__chart_render__*"],description:"Chart render \u2014 local server-side chart rendering (Apache ECharts SVG SSR + resvg PNG); data never leaves the box",promptFragment:`## Chart Render (local, no external service)
914
+ records this automatically; you don't store it yourself.)`,resolve(){let r=gm();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/artifact.js","artifactSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"artifact_publish":{if(We>=gt)return Xr("Publish budget already spent this turn.",[]);let e=typeof t?.title=="string"?t.title.trim():"";if(!e)return JSON.stringify({error:"title is required"});let n=Ys(t);if(!n)return JSON.stringify({error:"provide exactly one of markdown (preferred) or html or text (non-empty string)"});if(n.error)return JSON.stringify({error:n.error});let i=Ws(t,n);if(i?.error)return JSON.stringify({error:i.error});if(n.format==="text"&&!(typeof t?.contentType=="string"?t.contentType.trim():""))return JSON.stringify({error:"contentType is required with text \u2014 text/plain for code/logs, application/json for JSON data, text/csv for CSV"});let s={title:e,[n.format]:n.content};n.format==="text"&&(s.contentType=t.contentType.trim()),typeof t?.kind=="string"&&t.kind.trim()&&(s.kind=t.kind.trim()),typeof t?.favicon=="string"&&t.favicon.trim()&&(s.favicon=t.favicon.trim()),t?.share===!0&&(s.share=!0);let o=await Fs(s,n.format,i?.preflight);if(o?.__rejected)return o.payload;let a=o?.id,c=o?.url;if(!a||!c)return JSON.stringify({error:"artifact write returned no id/url",response:o});let l={id:a,url:c};typeof o.rn=="string"&&o.rn&&(l.rn=o.rn),o.shared&&(l.shared=!0,l.shareUrl=o.shareUrl,l.password=o.password,l.instruction="Send BOTH the shareUrl and the password in your reply. Copy the password EXACTLY \u2014 it is case-sensitive, shown once, and cannot be looked up again (artifact_share issues a new one, which kills this one)."),o.__preflightNote&&(l.preflight=o.__preflightNote);let d=await Hs(a,n.content);d&&(l.readBack=d);let p={id:a,title:e,url:c,kind:s.kind||null,createdAt:o.createdAt||new Date().toISOString(),summary:typeof t?.summary=="string"&&t.summary.trim()?t.summary.trim():e};n.format==="text"?(p.contentType=typeof o.contentType=="string"?o.contentType:s.contentType,p.bytes=typeof o.bytes=="number"?o.bytes:Buffer.byteLength(n.content,"utf8")):p.format=n.format;try{await zs(a,p)}catch(u){l.indexWarning=u.message}return JSON.stringify(l)}case"artifact_update":{if(We>=gt)return Xr("Publish budget already spent this turn.",[]);let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=Ys(t);if(n?.error)return JSON.stringify({error:n.error});let i=typeof t?.title=="string"?t.title.trim():"";if(!n&&!i)return JSON.stringify({error:"nothing to update \u2014 pass a new title and/or markdown|html"});let s=Ws(t,n);if(s?.error)return JSON.stringify({error:s.error});let o={id:e};i&&(o.title=i),n&&(o[n.format]=n.content),typeof t?.kind=="string"&&t.kind.trim()&&(o.kind=t.kind.trim()),typeof t?.favicon=="string"&&t.favicon.trim()&&(o.favicon=t.favicon.trim());let a=await Fs(o,n?.format,s?.preflight);if(a?.__rejected)return a.payload;let c=a?.url;if(!c)return JSON.stringify({error:"artifact update returned no url",response:a});let l={id:e,url:c};if(typeof a.rn=="string"&&a.rn&&(l.rn=a.rn),a.__preflightNote&&(l.preflight=a.__preflightNote),n){let u=await Hs(e,n.content);u&&(l.readBack=u)}let d=await Im(e)||{},p={...d,id:e,url:c,title:i||d.title||"Untitled",kind:o.kind||d.kind||null,createdAt:d.createdAt||a.createdAt||new Date().toISOString(),updatedAt:a.updatedAt||new Date().toISOString()};n&&(n.format==="text"?(p.contentType=typeof a.contentType=="string"?a.contentType:d.contentType||null,p.bytes=typeof a.bytes=="number"?a.bytes:Buffer.byteLength(n.content,"utf8")):p.format=n.format),typeof t?.summary=="string"&&t.summary.trim()?p.summary=t.summary.trim():p.summary||(p.summary=p.title);try{await zs(e,p)}catch(u){l.indexWarning=u.message}return JSON.stringify(l)}case"artifact_get":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Xs(e);return JSON.stringify(n)}case"artifact_share":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Ks(e,"protect");return JSON.stringify({id:n.id,url:n.url,password:n.password,shared:!0,instruction:"Send BOTH the url and the password to the person who asked. Copy the password EXACTLY \u2014 it is case-sensitive and cannot be recovered later (call artifact_share again to issue a new one)."})}case"artifact_unshare":{let e=typeof t?.id=="string"?t.id.trim():"";if(!e)return JSON.stringify({error:"id is required"});let n=await Ks(e,"unprotect");return JSON.stringify({id:n.id,shared:!1,wasShared:n.wasShared})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"artifact_publish",description:`Publish a NEW self-contained, shareable page (report/plan/table/dashboard/diagram/write-up) and get back a shareable URL. USE \`markdown\` \u2014 it is the default path and Zibby generates the entire document for you (doctype, head, CSS, dark mode, table styling); you supply only the content, so the page cannot come out malformed. Markdown supports ${Ye}; it does NOT support ${or}. Use \`html\` ONLY when the page needs a visual layout Markdown cannot express (a bar chart, a gauge, a custom grid, an SVG diagram) \u2014 on that path you author the whole document and every mistake ships verbatim. Never pass both. Use \`text\` (+ required \`contentType\`) to publish RAW SOURCE as-is \u2014 code, a script, logs, JSON data, CSV. It is stored verbatim, never rendered as a page, and shown in a read-only code viewer with a download link. contentType: text/plain for code/logs/scripts, application/json for JSON data, text/csv for CSV. For code, put the FILENAME in \`title\` (e.g. "deploy.sh") \u2014 viewers derive the language label from the extension \u2014 and set kind: "code". Exactly one of markdown|html|text per call. Every figure on the page must come from a tool result or this conversation \u2014 do not do arithmetic in prose and print the result, and use the same number everywhere it appears. The content MUST come from the current conversation or data you fetched this turn; if you are not sure what the page should be about, ASK instead of calling this tool, and never publish a demo/sample/placeholder or an account-overview page as a stand-in. On the html path keep all CSS/JS/images INLINE (inline <style>/<script>, data: URIs) and send real tags (never &lt;escaped&gt; markup) \u2014 the page is sandboxed on view with no network at all, so every external URL is dead. PASS \`data\` WHENEVER THE HTML PAGE RENDERS A DATASET \u2014 a table of records, a bar chart, a row of meters. Give it the raw tool results the page was built from, unchanged; the page is then checked AGAINST that data before anything is sent, catching a table short of rows, a bar drawn at the wrong length, and leftover \${\u2026} or [object Object]. It costs you nothing when the page is right. Skip it for prose pages, and never pass it with \`markdown\` (that is an error, not a no-op). The content is VALIDATED before any URL exists: if it is broken \u2014 by that data check or by the server \u2014 you get the exact defects and line numbers back, you get ONE retry, and then the tool stops you. Both kinds of rejection share the SAME two attempts. Returns { id, url }. PASS \`share: true\` WHEN THE READERS HAVE NO ZIBBY ACCOUNT \u2014 you get back { shareUrl, password } in this same call, instead of publishing a link they cannot open and then having to call artifact_share. The password is GENERATED; you never invent one. Without \`share\` the page is member-only, which is the default and is correct for anything internal.`,input_schema:{type:"object",properties:{title:{type:"string",description:"The page title (also the browser tab title)."},markdown:{type:"string",description:`PREFERRED. The page content as Markdown \u2014 Zibby renders it into a styled, self-contained document, so you never author a skeleton. Supports ${Ye}. Does NOT support ${or}. Provide this OR html, never both.`},html:{type:"string",description:"The EXCEPTION path \u2014 only for a layout Markdown cannot express (bar chart, gauge, custom grid, SVG diagram). A self-contained HTML document or fragment, served VERBATIM: you own the doctype, head, CSS and every tag. All assets must be inline (<style>/<script>, data: URIs). Provide this OR markdown, never both."},text:{type:"string",description:'RAW SOURCE published as-is \u2014 code, a script, logs, JSON data, CSV. Stored verbatim (never rendered as an HTML page) and shown in a read-only code viewer with a download link. Requires `contentType`. For code, make `title` the filename (e.g. "deploy.sh" \u2014 the viewer derives the language from the extension) and set kind: "code". Provide this OR markdown OR html.'},contentType:{type:"string",description:"REQUIRED with `text`, meaningless otherwise. One of: text/plain (code, scripts, logs), application/json (JSON data), text/csv (CSV). Nothing else is accepted \u2014 HTML and Markdown are published through their own fields, never as text."},data:{type:"object",description:'Optional, and worth passing WHENEVER the html page renders a dataset (a table of records, a bar chart, meters): the raw tool results the page was built from, as JSON, UNCHANGED \u2014 do not summarise it and do not write your own expectations, the check derives what must be true by itself (wrap a bare array as {"rows": [...]}). The page is then verified against it BEFORE publishing: row counts, bar lengths vs their values, bars whose width the CSS throws away, and placeholder residue. If they disagree nothing is sent and you get the defects back, using one of your two attempts. Only valid with `html` \u2014 passing it with `markdown` is an error.'},kind:{type:"string",description:'Optional label for what this is, e.g. "report", "plan", "dashboard", "diagram". Stored in your index.'},favicon:{type:"string",description:'Optional emoji used as the browser-tab icon, e.g. "\u{1F4CA}".'},summary:{type:"string",description:"Optional one-line summary for your own index (defaults to the title). Helps you recall later what this page was."},share:{type:"boolean",description:"Set true to publish the page WITH a password link in one step \u2014 the response then also carries { shareUrl, password }, which you send together. Use it whenever the people who asked are in a chat channel and have no Zibby account. Omit it (the default) for anything internal: the page is then readable only by logged-in members of this project, and no password exists."}},required:["title"]}},{name:"artifact_update",description:"Revise an EXISTING artifact by id \u2014 the shareable URL stays the same, the content is replaced (new version). Pass the fields to change (title and/or markdown|html|text). `text` only replaces an artifact that was PUBLISHED as text, and it keeps its original contentType \u2014 the server refuses a type change and any doc\u2194text conversion. Prefer `markdown` for the same reason artifact_publish does: Zibby generates the document, so it cannot come out malformed. An update is validated exactly like a publish \u2014 including the optional `data` check when you send new `html` that renders a dataset \u2014 and if the new content is broken it is REFUSED, the page keeps its last good version, and the rejection shares the same two attempts as publish. Returns { id, url }.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to update (from a prior artifact_publish, or your kv-memory "artifact:" index).'},title:{type:"string",description:"New title (optional)."},markdown:{type:"string",description:`PREFERRED. New Markdown content (optional) \u2014 Zibby renders the document skeleton. Supports ${Ye}. Provide this OR html.`},html:{type:"string",description:"New HTML content (optional), served verbatim \u2014 only for layouts Markdown cannot express. Provide this OR markdown."},text:{type:"string",description:"New raw text content (optional) \u2014 only for an artifact that was PUBLISHED as text. It keeps its original contentType; the server refuses a type change or a doc\u2194text conversion. Provide at most one of markdown|html|text."},data:{type:"object",description:"Optional \u2014 same as on artifact_publish: when the new `html` renders a dataset, pass the raw tool results it was built from and the page is checked against them before anything is sent. Only valid alongside new `html`."},kind:{type:"string",description:"Optional updated kind label."},favicon:{type:"string",description:"Optional updated emoji favicon."},summary:{type:"string",description:"Optional updated one-line index summary."}},required:["id"]}},{name:"artifact_get",description:'Fetch ONE artifact you published, by id \u2192 { metadata, content }. Use to reuse / edit / re-publish a page. To LIST what you have published, use your kv-memory tool kv_recall_prefix with keyPrefix "artifact:".',input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id."}},required:["id"]}},{name:"artifact_share",description:"Make an artifact viewable WITHOUT a Zibby login, by password. Returns { url, password } \u2014 a link anyone can open plus the password that opens it. USE THIS when the people who need to read the page do not have Zibby accounts \u2014 the usual case is a Lark or Slack channel where you were asked for something and the channel members are not Zibby users. The normal artifact url only opens for logged-in members of this project, so for those recipients it is a dead link; this is what makes it readable. You MUST then send BOTH the url and the password in your reply, and copy the password EXACTLY (it is case-sensitive). It is shown ONCE and cannot be looked up afterwards \u2014 if it is lost, call this again to issue a new one, which also stops the old one working. Works on any artifact you published, old or new. Calling it again on an already-shared artifact replaces the password. Use artifact_unshare to revoke.",input_schema:{type:"object",properties:{id:{type:"string",description:'The id of the artifact to share (from artifact_publish, or your kv-memory "artifact:" index).'}},required:["id"]}},{name:"artifact_unshare",description:`REMOVE an artifact's password \u2014 this is the tool for "take the password off", "remove the password", "stop sharing" and "revoke the link", which are all the same act. The page goes back to the DEFAULT it was published with: viewable only by logged-in members of this project, with no password anywhere. Immediate and total: anyone who already entered the password loses access too, not just new visitors. Safe to call on an artifact that was never shared. Note what this does NOT do: there is no way to leave a page open to anyone with the link and no password. Removing the password closes the anonymous door; it does not prop it open. Say that plainly if you are asked for a passwordless public link.`,input_schema:{type:"object",properties:{id:{type:"string",description:"The artifact id to stop sharing."}},required:["id"]}}]};import{createRequire as Nm}from"node:module";import{randomBytes as Om}from"node:crypto";import{existsSync as io,mkdirSync as Tm,writeFileSync as eo}from"node:fs";import{dirname as so,join as Ze,resolve as oo}from"node:path";import{fileURLToPath as ao}from"node:url";var co=Nm(import.meta.url),Qr=null;function Rm(){return Qr||(Qr=co("echarts")),Qr}var en=null;function Am(){return en||(en=co("@resvg/resvg-js")),en}var Em=800,xm=600,jm=4096,Lm=16,to=60,lo="Noto Sans",ro=256*1024;function $m(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=so(ao(import.meta.url)),t=oo(r,"..","bin","mcp-skill.mjs");return io(t)?t:null}function Pm(){let r=so(ao(import.meta.url)),t=oo(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(e=>Ze(t,e)).filter(e=>io(e))}function Cm(){let r=process.env.ZIBBY_NODE_SESSION_PATH,t=process.env.ZIBBY_SESSION_PATH,e=r||(t?Ze(t,"chart-render"):Ze(process.cwd(),".zibby","output","charts"));return Tm(e,{recursive:!0}),e}function $e(r){return r!=null&&typeof r=="object"&&!Array.isArray(r)}function no(r,t){let e=Number(r);return Number.isFinite(e)?Math.max(Lm,Math.min(jm,Math.round(e))):t}function tn(r){return typeof r!="string"||r.length<=to?r:`${r.slice(0,to-1)}\u2026`}function ar(r){if(Array.isArray(r))for(let t=0;t<r.length;t++){let e=r[t];typeof e=="string"?r[t]=tn(e):$e(e)&&typeof e.name=="string"&&(e.name=tn(e.name))}}function Um(r){for(let n of["xAxis","yAxis"]){let i=Array.isArray(r[n])?r[n]:r[n]?[r[n]]:[];for(let s of i)$e(s)&&ar(s.data)}let t=Array.isArray(r.radar)?r.radar:r.radar?[r.radar]:[];for(let n of t)$e(n)&&ar(n.indicator);$e(r.legend)&&ar(r.legend.data);let e=Array.isArray(r.series)?r.series:r.series?[r.series]:[];for(let n of e)$e(n)&&(typeof n.name=="string"&&(n.name=tn(n.name)),ar(n.data))}function Bm(r){let t=JSON.parse(JSON.stringify(r));return t.animation=!1,t.backgroundColor==null&&(t.backgroundColor="#fff"),$e(t.textStyle)||(t.textStyle={}),t.textStyle.fontFamily==null&&(t.textStyle.fontFamily=lo),Um(t),t}function Jm(r){return typeof r!="string"?null:r.trim().replace(/\.(svg|png)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Dm(r,t,e){let i=Rm().init(null,null,{renderer:"svg",ssr:!0,width:t,height:e});try{return i.setOption(r),i.renderToSVGString()}finally{i.dispose()}}function qm(r){return r.replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi,"")}function Mm(r,t){return r.replace(/id="zr\d+-/g,`id="${t}-`).replace(/url\(#zr\d+-/g,`url(#${t}-`).replace(/class="zr\d+-/g,`class="${t}-`)}function Fm(r){let t=[];for(let e of r.matchAll(/(?:xlink:)?href\s*=\s*"([^"]*)"/gi)){let n=e[1].trim();n&&!n.startsWith("#")&&!/^data:/i.test(n)&&t.push(n)}for(let e of r.matchAll(/url\(\s*['"]?([^'")]*)['"]?\s*\)/gi)){let n=e[1].trim();n&&!n.startsWith("#")&&!/^data:/i.test(n)&&t.push(n)}return/@import/i.test(r)&&t.push("@import"),/<script\b/i.test(r)&&t.push("<script>"),/<foreignObject\b/i.test(r)&&t.push("<foreignObject>"),t}function Km(r){let t=Mm(qm(r),`chart-${Om(4).toString("hex")}`),e=Fm(t);if(e.length){let n=[...new Set(e)].slice(0,3).join(", ");throw new Error(`the rendered chart references external resources (${n}), which a self-contained HTML page blocks. Remove image:// symbols / external image fills from the spec (use plain colors or a data: URI), or use output:'svg' to write a file instead.`)}return t}function Gm(r){let{Resvg:t}=Am();return new t(r,{font:{fontFiles:Pm(),loadSystemFonts:!0,defaultFontFamily:lo}}).render().asPng()}var po={id:"chart-render",serverName:"chart_render",allowedTools:["mcp__chart_render__*"],description:"Chart render \u2014 local server-side chart rendering (Apache ECharts SVG SSR + resvg PNG); data never leaves the box",promptFragment:`## Chart Render (local, no external service)
911
915
  You can render charts LOCALLY with the chart_render tool \u2014 pass a standard
912
916
  Apache ECharts option object as \`spec\` (any chart type: bar, line, pie,
913
917
  radar, scatter, heatmap, \u2026). No browser, no external chart service \u2014 the data
@@ -950,8 +954,8 @@ notify. Post brief milestones so they know it's alive:
950
954
  commits, continuing\u2026"). Pass the chat target from your \`notify\` input when
951
955
  you have it (provider + chatId); otherwise it resolves from the runtime.
952
956
  Fire-and-forget \u2014 if it can't post, just keep working; never treat a failed
953
- progress ping as an error.`,resolve(){let r=uf();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","SLACK_BOT_TOKEN","SLACK_TEAM_ID","ZIBBY_PROGRESS_PROVIDER","ZIBBY_PROGRESS_CHAT_ID","ZIBBY_PROGRESS_MENTION","SLACK_CHANNEL","LARK_RECEIVE_ID"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/chatProgress.js","chatProgressSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){if(r!=="report_progress")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=String(t?.message||"").trim().slice(0,2e3);if(!e)return JSON.stringify({ok:!1,skipped:"empty message"});let{provider:n,chatId:i,mention:s}=mf(t);if(!n||!i)return JSON.stringify({ok:!1,skipped:"no chat target"});let o=s&&n==="slack"?`<@${s}> ${e}`:e,a;n==="lark"?a=await F.handleToolCall("lark_send_message",{receive_id:i,text:e}):a=await P.handleToolCall("slack_post_message",{channel:i,text:o});let c=null;try{c=JSON.parse(a)}catch{}return c&&c.error?JSON.stringify({ok:!1,skipped:`post failed: ${c.error}`}):JSON.stringify({ok:!0,provider:n,posted:!0})}catch(e){return JSON.stringify({ok:!1,skipped:`error: ${e.message}`})}},tools:[{name:"report_progress",description:"Post a ONE-LINE progress status to the chat that triggered this run (so the human sees the long job is alive). Fire-and-forget \u2014 never fails the run. Target resolves from your notify input (provider + chatId) or the runtime; you usually just pass the message.",input_schema:{type:"object",properties:{message:{type:"string",description:'A short human status line, e.g. "Scored 60/188 commits, continuing\u2026".'},provider:{type:"string",enum:["lark","slack"],description:"Optional \u2014 the chat provider (from your notify input). Defaults from the runtime."},chatId:{type:"string",description:"Optional \u2014 the target chat/channel id (from your notify input). Defaults from the runtime."}},required:["message"]}}]};import{createRequire as ff}from"node:module";import{existsSync as go,mkdirSync as hf,writeFileSync as fo}from"node:fs";import{dirname as bo,join as Xe,resolve as _o}from"node:path";import{fileURLToPath as ko}from"node:url";var yf=ff(import.meta.url),rn=null;function gf(){return rn||(rn=yf("@resvg/resvg-js")),rn}var wo=1200,bf=627,_f=4096,kf=320,wf="#3b82f6",Pe="Noto Sans",Sf=3;function vf(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=bo(ko(import.meta.url)),t=_o(r,"..","bin","mcp-skill.mjs");return go(t)?t:null}function If(){let r=bo(ko(import.meta.url)),t=_o(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(e=>Xe(t,e)).filter(e=>go(e))}function Nf(){let r=process.env.ZIBBY_NODE_SESSION_PATH,t=process.env.ZIBBY_SESSION_PATH,e=r||(t?Xe(t,"social-card"):Xe(process.cwd(),".zibby","output","social-cards"));return hf(e,{recursive:!0}),e}function ho(r,t){let e=Number(r);return Number.isFinite(e)?Math.max(kf,Math.min(_f,Math.round(e))):t}function Ve(r){return String(r??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function Of(r){return typeof r!="string"?null:r.trim().replace(/\.(png|svg)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Tf(r,t){if(typeof r!="string")return t;let e=r.trim();return/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(e)?e:t}function So(r,t,e){return String(r).length*t*e}function nn(r,t,e,n){let i=String(r).trim().split(/\s+/).filter(Boolean),s=[],o="";for(let a of i){let c=o?`${o} ${a}`:a;o&&So(c,e,n)>t?(s.push(o),o=a):o=c}return o&&s.push(o),s.length?s:[""]}function Rf(r){return r==="light"?{bg:"#ffffff",fg:"#0b0f14",muted:"#5b6673",pillText:"#0b0f14",checkFg:"#ffffff",divider:"#e2e6ea"}:{bg:"#0b0f14",fg:"#e9edf1",muted:"#8b98a5",pillText:"#e9edf1",checkFg:"#0b0f14",divider:"#22303c"}}function yo(r,t,e,n,i){let s=(Array.isArray(r)?r:[]).map(_=>String(_??"").trim()).filter(Boolean).slice(0,Sf);if(s.length<2)return null;let o=24,a=54,c=26,l=90,d=17,p=s.map(_=>Math.max(96,So(_,o,.58)+c*2)),u=p.reduce((_,y)=>_+y,0)+l*(s.length-1),m=t-u/2,f=e+a/2,h=[];for(let _=0;_<s.length;_++){let y=p[_];if(h.push(`<rect x="${m.toFixed(1)}" y="${e}" width="${y.toFixed(1)}" height="${a}" rx="${a/2}" fill="${i}" fill-opacity="0.12" stroke="${i}" stroke-opacity="0.55" stroke-width="1.5"/>`,`<text x="${(m+y/2).toFixed(1)}" y="${(f+o*.35).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${o}" font-weight="700" fill="${n.pillText}">${Ve(s[_])}</text>`),m+=y,_<s.length-1){let b=m,g=m+l,k=(b+g)/2;h.push(`<line x1="${b.toFixed(1)}" y1="${f}" x2="${g.toFixed(1)}" y2="${f}" stroke="${i}" stroke-opacity="0.55" stroke-width="2"/>`,`<circle cx="${k.toFixed(1)}" cy="${f}" r="${d}" fill="${i}"/>`,`<path d="M ${(k-8).toFixed(1)} ${f.toFixed(1)} l 5 5 l 9 -11" fill="none" stroke="${n.checkFg}" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>`),m=g}}return{svg:h.join(`
954
- `),height:a}}function Af(r){let{width:t,height:e,theme:n,accent:i}=r,s=Rf(n),o=t/2,a=Math.round(t*.07),c=t-a*2,l=String(r.headline).trim(),d=r.eyebrow?String(r.eyebrow).trim().toUpperCase():"",p=r.subhead?String(r.subhead).trim():"",u=r.stat?String(r.stat).trim():"",m=r.footer?String(r.footer).trim():"",f=t/wo,h=Math.round(22*f),_=Math.round(29*f),y=p?nn(p,c,_,.52):[],b=Math.round(_*1.28),g=4,k=Math.round(26*f),O=Math.round(20*f),q=Math.round(24*f),ye=Math.round(30*f),T=!!(u||m),A=a,M=T?Math.round(110*f):a,x=e-A-M,Ie=yo(r.diagram,o,0,s,i),kn=(C,ge)=>{let et=g+k;return d&&(et+=h+O),et+=ge.length*Math.round(C*1.16),y.length&&(et+=q+y.length*b),Ie&&(et+=ye+Ie.height),et},yr=[76,66,58,50,44,38].map(C=>Math.round(C*f)),sa=4,Ue=yr[yr.length-1],gr=nn(l,c,Ue,.6);for(let C of yr){let ge=nn(l,c,C,.6);if(ge.length<=sa&&kn(C,ge)<=x){Ue=C,gr=ge;break}}let oa=Math.round(Ue*1.16),aa=kn(Ue,gr),W=A+Math.max(0,(x-aa)/2),le=[];le.push(`<rect x="0" y="0" width="${t}" height="${e}" fill="${s.bg}"/>`);let wn=Math.round(60*f);le.push(`<rect x="${(o-wn/2).toFixed(1)}" y="${W}" width="${wn}" height="${g}" rx="2" fill="${i}"/>`),W+=g+k,d&&(le.push(`<text x="${o}" y="${(W+h*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${h}" font-weight="700" letter-spacing="3" fill="${i}">${Ve(d)}</text>`),W+=h+O);for(let C of gr)le.push(`<text x="${o}" y="${(W+Ue*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${Ue}" font-weight="700" fill="${s.fg}">${Ve(C)}</text>`),W+=oa;if(y.length){W+=q;for(let C of y)le.push(`<text x="${o}" y="${(W+_*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${_}" font-weight="400" fill="${s.muted}">${Ve(C)}</text>`),W+=b}if(Ie){W+=ye;let C=yo(r.diagram,o,W,s,i);C&&le.push(C.svg)}if(T){let C=Math.round(24*f),ge=e-Math.round(46*f);m&&le.push(`<text x="${a}" y="${ge}" text-anchor="start" font-family="${Pe}" font-size="${C}" font-weight="400" fill="${s.muted}">${Ve(m)}</text>`),u&&le.push(`<text x="${t-a}" y="${ge}" text-anchor="end" font-family="${Pe}" font-size="${C}" font-weight="700" fill="${i}">${Ve(u)}</text>`)}return`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${e}" viewBox="0 0 ${t} ${e}">
957
+ progress ping as an error.`,resolve(){let r=uf();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","SLACK_BOT_TOKEN","SLACK_TEAM_ID","ZIBBY_PROGRESS_PROVIDER","ZIBBY_PROGRESS_CHAT_ID","ZIBBY_PROGRESS_MENTION","SLACK_CHANNEL","LARK_RECEIVE_ID"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/chatProgress.js","chatProgressSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){if(r!=="report_progress")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=String(t?.message||"").trim().slice(0,2e3);if(!e)return JSON.stringify({ok:!1,skipped:"empty message"});let{provider:n,chatId:i,mention:s}=mf(t);if(!n||!i)return JSON.stringify({ok:!1,skipped:"no chat target"});let o=s&&n==="slack"?`<@${s}> ${e}`:e,a;n==="lark"?a=await F.handleToolCall("lark_send_message",{receive_id:i,text:e}):a=await P.handleToolCall("slack_post_message",{channel:i,text:o});let c=null;try{c=JSON.parse(a)}catch{}return c&&c.error?JSON.stringify({ok:!1,skipped:`post failed: ${c.error}`}):JSON.stringify({ok:!0,provider:n,posted:!0})}catch(e){return JSON.stringify({ok:!1,skipped:`error: ${e.message}`})}},tools:[{name:"report_progress",description:"Post a ONE-LINE progress status to the chat that triggered this run (so the human sees the long job is alive). Fire-and-forget \u2014 never fails the run. Target resolves from your notify input (provider + chatId) or the runtime; you usually just pass the message.",input_schema:{type:"object",properties:{message:{type:"string",description:'A short human status line, e.g. "Scored 60/188 commits, continuing\u2026".'},provider:{type:"string",enum:["lark","slack"],description:"Optional \u2014 the chat provider (from your notify input). Defaults from the runtime."},chatId:{type:"string",description:"Optional \u2014 the target chat/channel id (from your notify input). Defaults from the runtime."}},required:["message"]}}]};import{createRequire as ff}from"node:module";import{existsSync as go,mkdirSync as hf,writeFileSync as fo}from"node:fs";import{dirname as bo,join as Xe,resolve as _o}from"node:path";import{fileURLToPath as wo}from"node:url";var yf=ff(import.meta.url),rn=null;function gf(){return rn||(rn=yf("@resvg/resvg-js")),rn}var ko=1200,bf=627,_f=4096,wf=320,kf="#3b82f6",Pe="Noto Sans",Sf=3;function vf(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=bo(wo(import.meta.url)),t=_o(r,"..","bin","mcp-skill.mjs");return go(t)?t:null}function If(){let r=bo(wo(import.meta.url)),t=_o(r,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(e=>Xe(t,e)).filter(e=>go(e))}function Nf(){let r=process.env.ZIBBY_NODE_SESSION_PATH,t=process.env.ZIBBY_SESSION_PATH,e=r||(t?Xe(t,"social-card"):Xe(process.cwd(),".zibby","output","social-cards"));return hf(e,{recursive:!0}),e}function ho(r,t){let e=Number(r);return Number.isFinite(e)?Math.max(wf,Math.min(_f,Math.round(e))):t}function Ve(r){return String(r??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function Of(r){return typeof r!="string"?null:r.trim().replace(/\.(png|svg)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function Tf(r,t){if(typeof r!="string")return t;let e=r.trim();return/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(e)?e:t}function So(r,t,e){return String(r).length*t*e}function nn(r,t,e,n){let i=String(r).trim().split(/\s+/).filter(Boolean),s=[],o="";for(let a of i){let c=o?`${o} ${a}`:a;o&&So(c,e,n)>t?(s.push(o),o=a):o=c}return o&&s.push(o),s.length?s:[""]}function Rf(r){return r==="light"?{bg:"#ffffff",fg:"#0b0f14",muted:"#5b6673",pillText:"#0b0f14",checkFg:"#ffffff",divider:"#e2e6ea"}:{bg:"#0b0f14",fg:"#e9edf1",muted:"#8b98a5",pillText:"#e9edf1",checkFg:"#0b0f14",divider:"#22303c"}}function yo(r,t,e,n,i){let s=(Array.isArray(r)?r:[]).map(_=>String(_??"").trim()).filter(Boolean).slice(0,Sf);if(s.length<2)return null;let o=24,a=54,c=26,l=90,d=17,p=s.map(_=>Math.max(96,So(_,o,.58)+c*2)),u=p.reduce((_,y)=>_+y,0)+l*(s.length-1),m=t-u/2,f=e+a/2,h=[];for(let _=0;_<s.length;_++){let y=p[_];if(h.push(`<rect x="${m.toFixed(1)}" y="${e}" width="${y.toFixed(1)}" height="${a}" rx="${a/2}" fill="${i}" fill-opacity="0.12" stroke="${i}" stroke-opacity="0.55" stroke-width="1.5"/>`,`<text x="${(m+y/2).toFixed(1)}" y="${(f+o*.35).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${o}" font-weight="700" fill="${n.pillText}">${Ve(s[_])}</text>`),m+=y,_<s.length-1){let b=m,g=m+l,w=(b+g)/2;h.push(`<line x1="${b.toFixed(1)}" y1="${f}" x2="${g.toFixed(1)}" y2="${f}" stroke="${i}" stroke-opacity="0.55" stroke-width="2"/>`,`<circle cx="${w.toFixed(1)}" cy="${f}" r="${d}" fill="${i}"/>`,`<path d="M ${(w-8).toFixed(1)} ${f.toFixed(1)} l 5 5 l 9 -11" fill="none" stroke="${n.checkFg}" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>`),m=g}}return{svg:h.join(`
958
+ `),height:a}}function Af(r){let{width:t,height:e,theme:n,accent:i}=r,s=Rf(n),o=t/2,a=Math.round(t*.07),c=t-a*2,l=String(r.headline).trim(),d=r.eyebrow?String(r.eyebrow).trim().toUpperCase():"",p=r.subhead?String(r.subhead).trim():"",u=r.stat?String(r.stat).trim():"",m=r.footer?String(r.footer).trim():"",f=t/ko,h=Math.round(22*f),_=Math.round(29*f),y=p?nn(p,c,_,.52):[],b=Math.round(_*1.28),g=4,w=Math.round(26*f),O=Math.round(20*f),q=Math.round(24*f),ye=Math.round(30*f),T=!!(u||m),A=a,M=T?Math.round(110*f):a,x=e-A-M,Ie=yo(r.diagram,o,0,s,i),wn=(C,ge)=>{let et=g+w;return d&&(et+=h+O),et+=ge.length*Math.round(C*1.16),y.length&&(et+=q+y.length*b),Ie&&(et+=ye+Ie.height),et},yr=[76,66,58,50,44,38].map(C=>Math.round(C*f)),sa=4,Ue=yr[yr.length-1],gr=nn(l,c,Ue,.6);for(let C of yr){let ge=nn(l,c,C,.6);if(ge.length<=sa&&wn(C,ge)<=x){Ue=C,gr=ge;break}}let oa=Math.round(Ue*1.16),aa=wn(Ue,gr),W=A+Math.max(0,(x-aa)/2),le=[];le.push(`<rect x="0" y="0" width="${t}" height="${e}" fill="${s.bg}"/>`);let kn=Math.round(60*f);le.push(`<rect x="${(o-kn/2).toFixed(1)}" y="${W}" width="${kn}" height="${g}" rx="2" fill="${i}"/>`),W+=g+w,d&&(le.push(`<text x="${o}" y="${(W+h*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${h}" font-weight="700" letter-spacing="3" fill="${i}">${Ve(d)}</text>`),W+=h+O);for(let C of gr)le.push(`<text x="${o}" y="${(W+Ue*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${Ue}" font-weight="700" fill="${s.fg}">${Ve(C)}</text>`),W+=oa;if(y.length){W+=q;for(let C of y)le.push(`<text x="${o}" y="${(W+_*.82).toFixed(1)}" text-anchor="middle" font-family="${Pe}" font-size="${_}" font-weight="400" fill="${s.muted}">${Ve(C)}</text>`),W+=b}if(Ie){W+=ye;let C=yo(r.diagram,o,W,s,i);C&&le.push(C.svg)}if(T){let C=Math.round(24*f),ge=e-Math.round(46*f);m&&le.push(`<text x="${a}" y="${ge}" text-anchor="start" font-family="${Pe}" font-size="${C}" font-weight="400" fill="${s.muted}">${Ve(m)}</text>`),u&&le.push(`<text x="${t-a}" y="${ge}" text-anchor="end" font-family="${Pe}" font-size="${C}" font-weight="700" fill="${i}">${Ve(u)}</text>`)}return`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${e}" viewBox="0 0 ${t} ${e}">
955
959
  ${le.join(`
956
960
  `)}
957
961
  </svg>`}function Ef(r){let{Resvg:t}=gf();return new t(r,{font:{fontFiles:If(),loadSystemFonts:!0,defaultFontFamily:Pe}}).render().asPng()}var vo={id:"social-card",serverName:"social_card",allowedTools:["mcp__social_card__*"],description:'Social card \u2014 render a branded LinkedIn "concept card" PNG locally (bold headline + eyebrow + optional stat/footer/diagram); nothing leaves the box',promptFragment:`## Social Card (branded concept card, local)
@@ -968,7 +972,7 @@ fields that capture the ONE key idea of your post:
968
972
  It renders server-side to a PNG in the run's output folder and returns
969
973
  { ok:true, files:[{ path, format:'png', bytes }] }. Pass the returned \`path\` as
970
974
  \`imagePath\` when you draft/publish a LinkedIn post to ATTACH the card as the
971
- post image. No browser, no external service \u2014 the data never leaves the machine.`,resolve({sessionPath:r,nodeName:t}={}){let e=vf();if(!e)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&t?Xe(r,t):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[e,"../dist/socialCard.js","socialCardSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){if(r!=="social_card_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=t?.headline;if(typeof e!="string"||!e.trim())return JSON.stringify({error:"headline (the big bold line) is required and must be a non-empty string."});let n=ho(t?.width,wo),i=ho(t?.height,bf),s=t?.theme==="light"?"light":"dark",o=Tf(t?.accent,wf),a;try{a=Af({width:n,height:i,theme:s,accent:o,headline:e,eyebrow:t?.eyebrow,subhead:t?.subhead,stat:t?.stat,footer:t?.footer,diagram:t?.diagram})}catch(m){return JSON.stringify({error:`Card layout failed: ${m.message}`})}let c;try{c=Ef(a)}catch(m){return JSON.stringify({error:`PNG rasterization failed: ${m.message}`})}let l=Nf(),d=Of(t?.filename)||`social-card-${Date.now()}`,p=Xe(l,`${d}.png`);fo(p,c);let u=[{path:p,format:"png",bytes:c.length}];if(t?.output==="both"||t?.output==="svg"){let m=Xe(l,`${d}.svg`);fo(m,a,"utf-8"),u.push({path:m,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}return JSON.stringify({ok:!0,width:n,height:i,theme:s,files:u})}catch(e){return JSON.stringify({error:`social_card_render failed: ${e.message}`})}},tools:[{name:"social_card_render",description:'Render a BRANDED "concept card" PNG LOCALLY (no external service) from structured fields \u2014 the clean LinkedIn concept-card style: bold headline + small uppercase eyebrow + optional supporting subhead, stat, footer, and an A\u2014\u2713\u2014B diagram. Returns { ok:true, files:[{ path, format:"png", bytes }] }. Pass the returned `path` as `imagePath` to a LinkedIn post tool to attach it as the post image. Example: { "headline":"No more copy-paste between AI tools", "eyebrow":"MY WORKFLOW", "stat":"11.8k stars", "footer":"Apache 2.0", "diagram":["Claude Code","Codex"] }.',input_schema:{type:"object",properties:{headline:{type:"string",description:"REQUIRED. The big, bold line \u2014 the single key idea/takeaway. Word-wrapped + auto-sized."},eyebrow:{type:"string",description:'Small uppercase kicker above the headline (e.g. "MY WORKFLOW", "OPEN SOURCE"). Rendered uppercased in the accent color.'},subhead:{type:"string",description:"One supporting line under the headline (muted)."},stat:{type:"string",description:'Optional stat, shown bottom-right in the accent color (e.g. "11.8k stars", "3x faster").'},footer:{type:"string",description:'Optional footer, shown bottom-left (muted) (e.g. "Apache 2.0", a repo name).'},diagram:{type:"array",items:{type:"string"},description:'Optional 2-3 short labels rendered as a chain of pills joined by a checkmark (A \u2014\u2713\u2014 B), e.g. ["Claude Code","Codex"].'},theme:{type:"string",enum:["dark","light"],description:"Card theme (default 'dark' \u2014 near-black bg, off-white text)."},accent:{type:"string",description:'Accent hex color (e.g. "#f97316"). Defaults to a tasteful blue (#3b82f6).'},width:{type:"number",description:"Image width in px (default 1200 \u2014 LinkedIn 1.91:1 link image)."},height:{type:"number",description:"Image height in px (default 627)."},filename:{type:"string",description:"Optional file basename (no extension); defaults to social-card-<timestamp>."},output:{type:"string",enum:["png","both"],description:"Which file(s) to write (default 'png'; 'both' also writes the .svg)."}},required:["headline"]}}]};import{spawnSync as xf}from"node:child_process";import{existsSync as D,readdirSync as Oo,statSync as To,writeFileSync as on,mkdirSync as an}from"node:fs";import{dirname as sn,extname as pr,join as U,relative as jf,resolve as dr}from"node:path";import{tmpdir as cn}from"node:os";import{fileURLToPath as Lf}from"node:url";import{SKILL_META as $f}from"@zibby/skill-ids";import{binPath as Pf}from"@zibby/bin-oxlint";import{binPath as Cf}from"@zibby/bin-semgrep";function Uf(){if(process.env.OXLINT_BIN)return process.env.OXLINT_BIN;try{let r=Pf();if(r&&D(r))return r}catch{}return"oxlint"}function Bf(){if(process.env.SEMGREP_CORE_BIN)return process.env.SEMGREP_CORE_BIN;try{let r=Cf();if(r&&D(r))return r}catch{}return"semgrep-core"}function Jf(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=sn(Lf(import.meta.url)),t=dr(r,"..","bin","mcp-skill.mjs");return D(t)?t:null}var Ro=new Set(["node_modules",".git","dist","build","out","vendor","target",".venv","venv","__pycache__",".next",".turbo","coverage",".zibby"]),Df=400,qf={plugins:["react","typescript","unicorn","oxc"],categories:{correctness:"error",suspicious:"warn"},rules:{"react/react-in-jsx-scope":"off","react/jsx-max-depth":"off","react/no-array-index-key":"off","react/jsx-key":"error","react/no-unknown-property":"error","no-unused-vars":"warn",eqeqeq:"warn"}},Mf=[".oxlintrc.json",".oxlintrc","oxlint.json"],cr=null;function Ff(){if(cr&&D(cr))return cr;try{let r=U(cn(),"zibby-code-scan");an(r,{recursive:!0});let t=U(r,"oxlintrc.curated.json");return on(t,JSON.stringify(qf),"utf-8"),cr=t,t}catch{return null}}var Ao={".java":"java",".py":"python",".go":"go",".rb":"ruby",".php":"php"},Io=Object.keys(Ao),Eo={rules:[{id:"zibby-java-command-injection",languages:["java"],severity:"ERROR",message:"Command execution (Runtime.exec / ProcessBuilder) \u2014 command injection risk if the argument is attacker-influenced. Validate/allow-list the input or avoid a shell.",patterns:[{"pattern-either":[{pattern:"Runtime.getRuntime().exec(...)"},{pattern:"new ProcessBuilder(...)"}]}]},{id:"zibby-python-subprocess-shell",languages:["python"],severity:"ERROR",message:"subprocess call with shell=True \u2014 command injection risk. Pass an argv list and shell=False.",pattern:"subprocess.$F(..., shell=True, ...)"},{id:"zibby-python-yaml-load",languages:["python"],severity:"WARNING",message:"yaml.load without a safe loader can instantiate arbitrary Python objects. Use yaml.safe_load.",pattern:"yaml.load(...)"},{id:"zibby-go-command-injection",languages:["go"],severity:"WARNING",message:"os/exec with a non-constant command \u2014 verify the value is not attacker-controlled (command injection).",pattern:"exec.Command($CMD, ...)"},{id:"zibby-ruby-command-injection",languages:["ruby"],severity:"ERROR",message:"Shell/eval execution (system / eval) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...)"},{pattern:"eval(...)"}]}]},{id:"zibby-php-command-injection",languages:["php"],severity:"ERROR",message:"Shell/eval execution (system / exec / shell_exec) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...);"},{pattern:"exec(...);"},{pattern:"shell_exec(...);"}]}]}]},Kf=[".semgrep.yml",".semgrep.yaml","semgrep.yml","semgrep.yaml"],lr=null;function Gf(){if(lr&&D(lr))return lr;try{let r=U(cn(),"zibby-code-scan");an(r,{recursive:!0});let t=U(r,"semgrep.curated.rules.json");return on(t,JSON.stringify(Eo),"utf-8"),lr=t,t}catch{return null}}function Hf(r){return Kf.map(e=>U(r,e)).find(e=>D(e))||Gf()}function zf(r){let t=[];for(let e of Array.isArray(r)?r:[]){if(typeof e!="string"||!e)continue;let n=Ao[pr(e).toLowerCase()];if(!n)continue;let i=e.replace(/\\/g,"/");t.push(["CodeTarget",{path:{fpath:i,ppath:`/${i.replace(/^\/+/,"")}`},analyzer:n,products:["sast"]}])}return["Targets",t]}var Yf=0;function Wf(r){let t=zf(r),e=t[1].length,n=U(cn(),"zibby-code-scan");an(n,{recursive:!0});let i=U(n,`semgrep.targets.${process.pid}.${Yf++}.json`);return on(i,JSON.stringify(t),"utf-8"),{path:i,count:e}}function No(r){let t=typeof r=="string"?r.toUpperCase():"";return t==="ERROR"?"error":t==="INFO"||t==="INVENTORY"||t==="EXPERIMENT"?"info":"warning"}var Zf=Object.fromEntries(Eo.rules.map(r=>[r.id,r.severity]));function Vf(r,t){if(t)return No(t);let e=Zf[r];return e?No(e):"warning"}function Xf(r){let t=String(r||""),e=t.indexOf("{");if(e<0)return[];let n;try{n=JSON.parse(t.slice(e))}catch{return[]}return(n&&Array.isArray(n.results)?n.results:[]).map(s=>{if(!s||typeof s!="object")return null;let o=s.start&&typeof s.start=="object"?s.start:{},a=s.extra&&typeof s.extra=="object"?s.extra:{};return{file:s.path||"",line:Number.isFinite(o.line)?o.line:"",severity:Vf(s.check_id,a.severity),rule:s.check_id||"",message:(a.message||"").trim()}}).filter(s=>s&&(s.file||s.message))}function Qf(r,t,e=4e3){let n=new Set(t.map(o=>o.toLowerCase())),i=[r],s=0;for(;i.length;){let o=i.pop(),a;try{a=Oo(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(++s>e)return!1;if(c.isDirectory())!Ro.has(c.name)&&!c.name.startsWith(".")&&i.push(U(o,c.name));else if(c.isFile()&&n.has(pr(c.name).toLowerCase()))return!0}}return!1}function eh(r){let t=String(r||"").trim();if(!t)return[];let e;try{e=JSON.parse(t)}catch{return[]}return(Array.isArray(e)?e:e&&Array.isArray(e.diagnostics)?e.diagnostics:[]).map(i=>{if(!i||typeof i!="object")return null;let s=Array.isArray(i.labels)&&i.labels.length?i.labels[0]:null,o=s&&s.span?s.span:null;return{file:i.filename||o&&o.filename||"",line:o&&Number.isFinite(o.line)?o.line:"",severity:i.severity||"warning",rule:i.code||"",message:i.message||""}}).filter(i=>i&&(i.file||i.message))}function th(r){let t=String(r||"").trim();if(!t)return[];let e;try{e=JSON.parse(t)}catch{return[]}return Array.isArray(e)?e.map(n=>n&&typeof n=="object"?{file:n.filename||"",line:n.location&&Number.isFinite(n.location.row)?n.location.row:"",severity:"warning",rule:n.code||"",message:n.message||""}:null).filter(n=>n&&(n.file||n.message)):[]}function rh(r){let t=String(r||"").trim();if(!t)return[];let e=[];for(let n of t.split(`
975
+ post image. No browser, no external service \u2014 the data never leaves the machine.`,resolve({sessionPath:r,nodeName:t}={}){let e=vf();if(!e)return{command:null,args:[],env:{},description:this.description};let n={},i=r&&t?Xe(r,t):null;i&&(n.ZIBBY_NODE_SESSION_PATH=i),r&&(n.ZIBBY_SESSION_PATH=r);for(let s of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!n[s]&&process.env[s]&&(n[s]=process.env[s]);return{type:"stdio",command:"node",args:[e,"../dist/socialCard.js","socialCardSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){if(r!=="social_card_render")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=t?.headline;if(typeof e!="string"||!e.trim())return JSON.stringify({error:"headline (the big bold line) is required and must be a non-empty string."});let n=ho(t?.width,ko),i=ho(t?.height,bf),s=t?.theme==="light"?"light":"dark",o=Tf(t?.accent,kf),a;try{a=Af({width:n,height:i,theme:s,accent:o,headline:e,eyebrow:t?.eyebrow,subhead:t?.subhead,stat:t?.stat,footer:t?.footer,diagram:t?.diagram})}catch(m){return JSON.stringify({error:`Card layout failed: ${m.message}`})}let c;try{c=Ef(a)}catch(m){return JSON.stringify({error:`PNG rasterization failed: ${m.message}`})}let l=Nf(),d=Of(t?.filename)||`social-card-${Date.now()}`,p=Xe(l,`${d}.png`);fo(p,c);let u=[{path:p,format:"png",bytes:c.length}];if(t?.output==="both"||t?.output==="svg"){let m=Xe(l,`${d}.svg`);fo(m,a,"utf-8"),u.push({path:m,format:"svg",bytes:Buffer.byteLength(a,"utf-8")})}return JSON.stringify({ok:!0,width:n,height:i,theme:s,files:u})}catch(e){return JSON.stringify({error:`social_card_render failed: ${e.message}`})}},tools:[{name:"social_card_render",description:'Render a BRANDED "concept card" PNG LOCALLY (no external service) from structured fields \u2014 the clean LinkedIn concept-card style: bold headline + small uppercase eyebrow + optional supporting subhead, stat, footer, and an A\u2014\u2713\u2014B diagram. Returns { ok:true, files:[{ path, format:"png", bytes }] }. Pass the returned `path` as `imagePath` to a LinkedIn post tool to attach it as the post image. Example: { "headline":"No more copy-paste between AI tools", "eyebrow":"MY WORKFLOW", "stat":"11.8k stars", "footer":"Apache 2.0", "diagram":["Claude Code","Codex"] }.',input_schema:{type:"object",properties:{headline:{type:"string",description:"REQUIRED. The big, bold line \u2014 the single key idea/takeaway. Word-wrapped + auto-sized."},eyebrow:{type:"string",description:'Small uppercase kicker above the headline (e.g. "MY WORKFLOW", "OPEN SOURCE"). Rendered uppercased in the accent color.'},subhead:{type:"string",description:"One supporting line under the headline (muted)."},stat:{type:"string",description:'Optional stat, shown bottom-right in the accent color (e.g. "11.8k stars", "3x faster").'},footer:{type:"string",description:'Optional footer, shown bottom-left (muted) (e.g. "Apache 2.0", a repo name).'},diagram:{type:"array",items:{type:"string"},description:'Optional 2-3 short labels rendered as a chain of pills joined by a checkmark (A \u2014\u2713\u2014 B), e.g. ["Claude Code","Codex"].'},theme:{type:"string",enum:["dark","light"],description:"Card theme (default 'dark' \u2014 near-black bg, off-white text)."},accent:{type:"string",description:'Accent hex color (e.g. "#f97316"). Defaults to a tasteful blue (#3b82f6).'},width:{type:"number",description:"Image width in px (default 1200 \u2014 LinkedIn 1.91:1 link image)."},height:{type:"number",description:"Image height in px (default 627)."},filename:{type:"string",description:"Optional file basename (no extension); defaults to social-card-<timestamp>."},output:{type:"string",enum:["png","both"],description:"Which file(s) to write (default 'png'; 'both' also writes the .svg)."}},required:["headline"]}}]};import{spawnSync as xf}from"node:child_process";import{existsSync as D,readdirSync as Oo,statSync as To,writeFileSync as on,mkdirSync as an}from"node:fs";import{dirname as sn,extname as pr,join as U,relative as jf,resolve as dr}from"node:path";import{tmpdir as cn}from"node:os";import{fileURLToPath as Lf}from"node:url";import{SKILL_META as $f}from"@zibby/skill-ids";import{binPath as Pf}from"@zibby/bin-oxlint";import{binPath as Cf}from"@zibby/bin-semgrep";function Uf(){if(process.env.OXLINT_BIN)return process.env.OXLINT_BIN;try{let r=Pf();if(r&&D(r))return r}catch{}return"oxlint"}function Bf(){if(process.env.SEMGREP_CORE_BIN)return process.env.SEMGREP_CORE_BIN;try{let r=Cf();if(r&&D(r))return r}catch{}return"semgrep-core"}function Jf(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=sn(Lf(import.meta.url)),t=dr(r,"..","bin","mcp-skill.mjs");return D(t)?t:null}var Ro=new Set(["node_modules",".git","dist","build","out","vendor","target",".venv","venv","__pycache__",".next",".turbo","coverage",".zibby"]),Df=400,qf={plugins:["react","typescript","unicorn","oxc"],categories:{correctness:"error",suspicious:"warn"},rules:{"react/react-in-jsx-scope":"off","react/jsx-max-depth":"off","react/no-array-index-key":"off","react/jsx-key":"error","react/no-unknown-property":"error","no-unused-vars":"warn",eqeqeq:"warn"}},Mf=[".oxlintrc.json",".oxlintrc","oxlint.json"],cr=null;function Ff(){if(cr&&D(cr))return cr;try{let r=U(cn(),"zibby-code-scan");an(r,{recursive:!0});let t=U(r,"oxlintrc.curated.json");return on(t,JSON.stringify(qf),"utf-8"),cr=t,t}catch{return null}}var Ao={".java":"java",".py":"python",".go":"go",".rb":"ruby",".php":"php"},Io=Object.keys(Ao),Eo={rules:[{id:"zibby-java-command-injection",languages:["java"],severity:"ERROR",message:"Command execution (Runtime.exec / ProcessBuilder) \u2014 command injection risk if the argument is attacker-influenced. Validate/allow-list the input or avoid a shell.",patterns:[{"pattern-either":[{pattern:"Runtime.getRuntime().exec(...)"},{pattern:"new ProcessBuilder(...)"}]}]},{id:"zibby-python-subprocess-shell",languages:["python"],severity:"ERROR",message:"subprocess call with shell=True \u2014 command injection risk. Pass an argv list and shell=False.",pattern:"subprocess.$F(..., shell=True, ...)"},{id:"zibby-python-yaml-load",languages:["python"],severity:"WARNING",message:"yaml.load without a safe loader can instantiate arbitrary Python objects. Use yaml.safe_load.",pattern:"yaml.load(...)"},{id:"zibby-go-command-injection",languages:["go"],severity:"WARNING",message:"os/exec with a non-constant command \u2014 verify the value is not attacker-controlled (command injection).",pattern:"exec.Command($CMD, ...)"},{id:"zibby-ruby-command-injection",languages:["ruby"],severity:"ERROR",message:"Shell/eval execution (system / eval) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...)"},{pattern:"eval(...)"}]}]},{id:"zibby-php-command-injection",languages:["php"],severity:"ERROR",message:"Shell/eval execution (system / exec / shell_exec) \u2014 command injection risk if the argument is attacker-influenced.",patterns:[{"pattern-either":[{pattern:"system(...);"},{pattern:"exec(...);"},{pattern:"shell_exec(...);"}]}]}]},Kf=[".semgrep.yml",".semgrep.yaml","semgrep.yml","semgrep.yaml"],lr=null;function Gf(){if(lr&&D(lr))return lr;try{let r=U(cn(),"zibby-code-scan");an(r,{recursive:!0});let t=U(r,"semgrep.curated.rules.json");return on(t,JSON.stringify(Eo),"utf-8"),lr=t,t}catch{return null}}function Hf(r){return Kf.map(e=>U(r,e)).find(e=>D(e))||Gf()}function zf(r){let t=[];for(let e of Array.isArray(r)?r:[]){if(typeof e!="string"||!e)continue;let n=Ao[pr(e).toLowerCase()];if(!n)continue;let i=e.replace(/\\/g,"/");t.push(["CodeTarget",{path:{fpath:i,ppath:`/${i.replace(/^\/+/,"")}`},analyzer:n,products:["sast"]}])}return["Targets",t]}var Yf=0;function Wf(r){let t=zf(r),e=t[1].length,n=U(cn(),"zibby-code-scan");an(n,{recursive:!0});let i=U(n,`semgrep.targets.${process.pid}.${Yf++}.json`);return on(i,JSON.stringify(t),"utf-8"),{path:i,count:e}}function No(r){let t=typeof r=="string"?r.toUpperCase():"";return t==="ERROR"?"error":t==="INFO"||t==="INVENTORY"||t==="EXPERIMENT"?"info":"warning"}var Zf=Object.fromEntries(Eo.rules.map(r=>[r.id,r.severity]));function Vf(r,t){if(t)return No(t);let e=Zf[r];return e?No(e):"warning"}function Xf(r){let t=String(r||""),e=t.indexOf("{");if(e<0)return[];let n;try{n=JSON.parse(t.slice(e))}catch{return[]}return(n&&Array.isArray(n.results)?n.results:[]).map(s=>{if(!s||typeof s!="object")return null;let o=s.start&&typeof s.start=="object"?s.start:{},a=s.extra&&typeof s.extra=="object"?s.extra:{};return{file:s.path||"",line:Number.isFinite(o.line)?o.line:"",severity:Vf(s.check_id,a.severity),rule:s.check_id||"",message:(a.message||"").trim()}}).filter(s=>s&&(s.file||s.message))}function Qf(r,t,e=4e3){let n=new Set(t.map(o=>o.toLowerCase())),i=[r],s=0;for(;i.length;){let o=i.pop(),a;try{a=Oo(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(++s>e)return!1;if(c.isDirectory())!Ro.has(c.name)&&!c.name.startsWith(".")&&i.push(U(o,c.name));else if(c.isFile()&&n.has(pr(c.name).toLowerCase()))return!0}}return!1}function eh(r){let t=String(r||"").trim();if(!t)return[];let e;try{e=JSON.parse(t)}catch{return[]}return(Array.isArray(e)?e:e&&Array.isArray(e.diagnostics)?e.diagnostics:[]).map(i=>{if(!i||typeof i!="object")return null;let s=Array.isArray(i.labels)&&i.labels.length?i.labels[0]:null,o=s&&s.span?s.span:null;return{file:i.filename||o&&o.filename||"",line:o&&Number.isFinite(o.line)?o.line:"",severity:i.severity||"warning",rule:i.code||"",message:i.message||""}}).filter(i=>i&&(i.file||i.message))}function th(r){let t=String(r||"").trim();if(!t)return[];let e;try{e=JSON.parse(t)}catch{return[]}return Array.isArray(e)?e.map(n=>n&&typeof n=="object"?{file:n.filename||"",line:n.location&&Number.isFinite(n.location.row)?n.location.row:"",severity:"warning",rule:n.code||"",message:n.message||""}:null).filter(n=>n&&(n.file||n.message)):[]}function rh(r){let t=String(r||"").trim();if(!t)return[];let e=[];for(let n of t.split(`
972
976
  `)){let i=n.trim();if(!i)continue;let s;try{s=JSON.parse(i)}catch{continue}if(!s||typeof s!="object")continue;let o=s.location||{};e.push({file:o.file||"",line:Number.isFinite(o.line)?o.line:"",severity:s.severity||"warning",rule:s.code||"",message:s.message||""})}return e.filter(n=>n.file||n.message)}var nh=[{id:"oxlint",detect:r=>D(U(r,"package.json")),langs:[".ts",".tsx",".js",".jsx",".mjs",".cjs"],bin:()=>Uf(),args:(r,t={})=>{let e=t.baseDir||".",i=Mf.some(o=>D(U(e,o)))?null:Ff();return["--format","json",...i?["--config",i]:[],...r]},parse:eh},{id:"semgrep",detect:r=>Qf(r,Io),langs:Io,bin:()=>Bf(),args:(r,t={})=>{let e=t.baseDir||".",n=Hf(e),{path:i}=Wf(r);return[...n?["-rules",n]:[],"-targets",i,"-json"]},parse:Xf},{id:"ruff",detect:r=>D(U(r,"pyproject.toml"))||D(U(r,"requirements.txt"))||D(U(r,"setup.py")),langs:[".py"],bin:()=>process.env.RUFF_BIN||"ruff",args:r=>["check","--output-format","json",...r],parse:th},{id:"staticcheck",detect:r=>D(U(r,"go.mod")),langs:[".go"],bin:()=>process.env.STATICCHECK_BIN||"staticcheck",args:r=>["-f","json",...r],parse:rh}];function ih(r,t,e){let n=[],i=new Set(t.map(o=>o.toLowerCase())),s=[r];for(;s.length&&n.length<e;){let o=s.pop(),a;try{a=Oo(o,{withFileTypes:!0})}catch{continue}for(let c of a){if(n.length>=e)break;c.isDirectory()?!Ro.has(c.name)&&!c.name.startsWith(".")&&s.push(U(o,c.name)):c.isFile()&&i.has(pr(c.name).toLowerCase())&&n.push(U(o,c.name))}}return n}function sh(r,t,e){let n=e.map(a=>jf(t,a)).filter(Boolean);if(!n.length)return{scanner:r.id,skipped:"no matching files"};let i=r.bin(),s=xf(i,r.args(n,{baseDir:t}),{cwd:t,encoding:"utf-8",timeout:180*1e3,maxBuffer:32*1024*1024});if(s.error){let a=s.error.code==="ENOENT"?`binary not installed (${i})`:String(s.error.message||s.error);return{scanner:r.id,skipped:a}}let o=[];try{let a=r.parse(s.stdout,s.stderr,s.status);o=Array.isArray(a)?a.filter(Boolean):[]}catch{o=[]}return{scanner:r.id,filesScanned:n.length,findings:o}}var xo={id:"code-scan",serverName:"code_scan",meta:$f["code-scan"],allowedTools:["mcp__code_scan__*"],description:"Code scan \u2014 run the RIGHT deterministic linter/analyzer for a checked-out repo (auto-detects the stack: JS/TS\u2192oxlint; Java/Python/Go/Ruby/PHP\u2192semgrep) and return structured findings. Fully local; the code never leaves the box.",promptFragment:`## Code Scan (deterministic linter, auto-detects the stack)
973
977
  After you've cloned the repo, call \`scan_code\` to get DETERMINISTIC linter
974
978
  findings for WHATEVER stack this repo is \u2014 it auto-detects (JS/TS\u2192oxlint;
@@ -976,7 +980,7 @@ Java/Python/Go/Ruby/PHP\u2192semgrep) and runs the matching tool. Pass \`files\`
976
980
  a review) or \`dir\` (a directory to scan). Findings are GROUND-TRUTH CANDIDATES:
977
981
  triage them for THIS change, verify each in context (false positives exist \u2014
978
982
  trace before asserting), fold noise, and turn the real ones into inline
979
- suggestions. Don't hand-lint what the tool already covers, and don't re-run it.`,resolve(){let r=Jf();return r?{type:"stdio",command:"node",args:[r,"../dist/code-scan.js","codeScanSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,t){if(r!=="scan_code")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=Array.isArray(t?.files)?t.files.filter(a=>typeof a=="string"&&a.trim()):null,n;if(t?.dir&&typeof t.dir=="string"?n=dr(t.dir):e&&e.length?n=oh(e.map(a=>dr(a))):n=process.cwd(),!D(n)||!To(n).isDirectory())return JSON.stringify({error:`dir does not exist or is not a directory: ${n}`});let i=e?e.map(a=>dr(n,a)):null,s=[],o=0;for(let a of nh){let c=!1;try{c=!!a.detect(n)}catch{c=!1}if(!c)continue;let l=new Set(a.langs.map(u=>u.toLowerCase())),d=i?i.filter(u=>l.has(pr(u).toLowerCase())):ih(n,a.langs,Df),p=sh(a,n,d);Array.isArray(p.findings)&&(o+=p.findings.length),s.push(p)}return s.length?JSON.stringify({ok:!0,baseDir:n,totalFindings:o,scanners:s}):JSON.stringify({ok:!0,baseDir:n,scanners:[],totalFindings:0,note:"No known stack detected (no package.json / pyproject / go.mod \u2026). Review by hand."})}catch(e){return JSON.stringify({error:`scan_code failed: ${e.message}`})}},tools:[{name:"scan_code",description:"Run the right deterministic linter for a checked-out repo and return structured findings. Auto-detects the stack (JS/TS \u2192 oxlint; Java/Python/Go/Ruby/PHP \u2192 semgrep OSS) and runs each matching tool, scoped to files in its languages. Pass `files` (e.g. the changed files of the PR \u2014 recommended for a review) OR `dir` (a directory to scan). Returns { scanners: [ { scanner, findings: [ { file, line, severity, rule, message } ] } ] }. Findings are CANDIDATES \u2014 verify each in context before asserting. Best-effort: a stack whose linter is not installed is skipped with a note.",input_schema:{type:"object",properties:{dir:{type:"string",description:"Absolute path to the checked-out repo (or subdirectory) to scan. Defaults to the current working directory."},files:{type:"array",items:{type:"string"},description:"Explicit list of files to scan (paths relative to `dir`, or absolute). Best for a code review \u2014 pass the PR's changed files. When omitted, the whole `dir` is walked (bounded)."}}}}]};function oh(r){if(!r.length)return process.cwd();if(r.length===1)return sn(r[0]);let t=r.map(s=>s.split("/")),e=t[0],n=[];for(let s=0;s<e.length;s++){let o=e[s];if(t.every(a=>a[s]===o))n.push(o);else break}let i=n.join("/");return i&&D(i)&&To(i).isDirectory()?i:sn(r[0])}import{dirname as ah,resolve as ch}from"path";import{fileURLToPath as lh}from"url";import{existsSync as dh}from"fs";function ph(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=ah(lh(import.meta.url)),t=ch(r,"..","bin","mcp-skill.mjs");return dh(t)?t:null}function uh(){return process.env.PROJECT_API_TOKEN||process.env.ZIBBY_USER_TOKEN||null}function mh(){return((process.env.PROGRESS_API_URL||"").replace(/\/executions\/?$/,"")||process.env.ZIBBY_ACCOUNT_API_URL||process.env.ZIBBY_PROD_ACCOUNT_API_URL||(process.env.ZIBBY_ENV==="local"?"http://localhost:3001":"https://api-prod.zibby.app")).replace(/\/+$/,"")}var fh={name:"trigger_agent",description:"Trigger another Zibby workflow/agent run in THIS project (fire-and-forget). Call it once per run you want to start \u2014 the agent decides which and how many. Omit workflowType to re-run THIS same agent (self-dispatch, e.g. with a different trigger input). Returns the started run's executionId; does NOT wait for it to finish.",input_schema:{type:"object",properties:{workflowType:{type:"string",description:"Which workflow to trigger (its type/slug in this project). Omit to trigger THIS same agent (self-dispatch)."},input:{type:"object",description:"The trigger payload passed to the target workflow (validated against its state schema)."}},required:[]}},jo={id:"trigger-agent",callsBackend:!0,serverName:"trigger",allowedTools:["mcp__trigger__*"],envKeys:[],description:"Trigger another Zibby workflow/agent run in this project (agent-driven, fire-and-forget; cloud + self-hosted).",promptFragment:"## Trigger another agent (agent-driven)\nYou can start another Zibby agent run yourself with the `trigger_agent`\ntool \u2014 and YOU decide when and how many times to call it. Each call starts ONE\nindependent run (fire-and-forget) and returns its executionId; it does NOT wait for\nthat run to finish.\n- To re-run THIS same agent (self-dispatch) \u2014 e.g. to hand an item to another of\n this agent's scenarios \u2014 OMIT `workflowType` and pass the `input` for that run.\n- To trigger a DIFFERENT agent in the project, pass its `workflowType` + `input`.\nCall it once per run you want to start (loop over your items and call it for each).\nIt never throws \u2014 a failure comes back as { ok:false, error }; log it and move on.",resolve(){let r=ph();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","PROJECT_ID","WORKFLOW_TYPE","PROGRESS_API_URL","ZIBBY_ACCOUNT_API_URL","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_USER_TOKEN"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/triggerAgent.js","triggerAgentSkill"],env:t,description:this.description,alwaysLoad:!1}},async handleToolCall(r,t={}){if(r!=="trigger_agent")return JSON.stringify({ok:!1,error:`unknown tool: ${r}`});try{let e=process.env.PROJECT_ID,n=uh(),i=typeof t.workflowType=="string"&&t.workflowType.trim()?t.workflowType.trim():(process.env.WORKFLOW_TYPE||"").trim();if(!e)return JSON.stringify({ok:!1,error:"PROJECT_ID not set \u2014 cannot resolve the target project."});if(!n)return JSON.stringify({ok:!1,error:"PROJECT_API_TOKEN not set \u2014 cannot authenticate the trigger."});if(!i)return JSON.stringify({ok:!1,error:"No workflowType given and WORKFLOW_TYPE is unset \u2014 nothing to trigger."});let s=`${mh()}/projects/${encodeURIComponent(e)}/workflows/${encodeURIComponent(i)}/trigger`,o=new AbortController,a=setTimeout(()=>o.abort(),2e4),c;try{c=await fetch(s,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${n}`},body:JSON.stringify({input:t.input&&typeof t.input=="object"?t.input:{}}),signal:o.signal})}finally{clearTimeout(a)}let l=await c.text().catch(()=>""),d;try{d=l?JSON.parse(l):{}}catch{d={raw:l}}if(!c.ok)return JSON.stringify({ok:!1,error:`trigger failed (HTTP ${c.status})`,detail:d&&(d.error||d.message)||l.slice(0,300)});let p=d.executionId||d.execution?.id||d.id||null;return JSON.stringify({ok:!0,workflowType:i,executionId:p,note:"run started (fire-and-forget)"})}catch(e){return JSON.stringify({ok:!1,error:`trigger_agent failed: ${e?.message||String(e)}`})}},tools:[fh]};import{spawnSync as hh}from"node:child_process";import{existsSync as ln,mkdirSync as Lo,readdirSync as yh,writeFileSync as gh}from"node:fs";import{createHash as bh}from"node:crypto";import{join as ur}from"node:path";import{SKILL_META as _h}from"@zibby/skill-ids";function $o(){return process.env.CBM_BIN||"/usr/local/bin/codebase-memory-mcp"}function Po(){if(process.env.CBM_CACHE_DIR)return process.env.CBM_CACHE_DIR;let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE;return r?ur(r,".zibby","cbm-cache"):"/tmp/zibby-cbm-cache"}function kh(){let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE||"/workspace",t=ur(r,".zibby","repos");try{if(ln(t)){let e=yh(t,{withFileTypes:!0}).filter(n=>n.isDirectory()).map(n=>ur(t,n.name));if(e.length===1)return e[0];if(e.length>1)return t}}catch{}return null}function wh(r){return bh("sha256").update(r).digest("hex").slice(0,16)}var Co={id:"codebase-memory",serverName:"codebase_memory",meta:_h["codebase-memory"],allowedTools:["mcp__codebase_memory__*"],description:"Codebase memory \u2014 code-graph + semantic index over the checked-out repo (architecture, graph search, dependency trace, change detection)",promptFragment:`## Codebase Memory (code-graph + semantic index over THIS repo)
983
+ suggestions. Don't hand-lint what the tool already covers, and don't re-run it.`,resolve(){let r=Jf();return r?{type:"stdio",command:"node",args:[r,"../dist/code-scan.js","codeScanSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(r,t){if(r!=="scan_code")return JSON.stringify({error:`Unknown tool: ${r}`});try{let e=Array.isArray(t?.files)?t.files.filter(a=>typeof a=="string"&&a.trim()):null,n;if(t?.dir&&typeof t.dir=="string"?n=dr(t.dir):e&&e.length?n=oh(e.map(a=>dr(a))):n=process.cwd(),!D(n)||!To(n).isDirectory())return JSON.stringify({error:`dir does not exist or is not a directory: ${n}`});let i=e?e.map(a=>dr(n,a)):null,s=[],o=0;for(let a of nh){let c=!1;try{c=!!a.detect(n)}catch{c=!1}if(!c)continue;let l=new Set(a.langs.map(u=>u.toLowerCase())),d=i?i.filter(u=>l.has(pr(u).toLowerCase())):ih(n,a.langs,Df),p=sh(a,n,d);Array.isArray(p.findings)&&(o+=p.findings.length),s.push(p)}return s.length?JSON.stringify({ok:!0,baseDir:n,totalFindings:o,scanners:s}):JSON.stringify({ok:!0,baseDir:n,scanners:[],totalFindings:0,note:"No known stack detected (no package.json / pyproject / go.mod \u2026). Review by hand."})}catch(e){return JSON.stringify({error:`scan_code failed: ${e.message}`})}},tools:[{name:"scan_code",description:"Run the right deterministic linter for a checked-out repo and return structured findings. Auto-detects the stack (JS/TS \u2192 oxlint; Java/Python/Go/Ruby/PHP \u2192 semgrep OSS) and runs each matching tool, scoped to files in its languages. Pass `files` (e.g. the changed files of the PR \u2014 recommended for a review) OR `dir` (a directory to scan). Returns { scanners: [ { scanner, findings: [ { file, line, severity, rule, message } ] } ] }. Findings are CANDIDATES \u2014 verify each in context before asserting. Best-effort: a stack whose linter is not installed is skipped with a note.",input_schema:{type:"object",properties:{dir:{type:"string",description:"Absolute path to the checked-out repo (or subdirectory) to scan. Defaults to the current working directory."},files:{type:"array",items:{type:"string"},description:"Explicit list of files to scan (paths relative to `dir`, or absolute). Best for a code review \u2014 pass the PR's changed files. When omitted, the whole `dir` is walked (bounded)."}}}}]};function oh(r){if(!r.length)return process.cwd();if(r.length===1)return sn(r[0]);let t=r.map(s=>s.split("/")),e=t[0],n=[];for(let s=0;s<e.length;s++){let o=e[s];if(t.every(a=>a[s]===o))n.push(o);else break}let i=n.join("/");return i&&D(i)&&To(i).isDirectory()?i:sn(r[0])}import{dirname as ah,resolve as ch}from"path";import{fileURLToPath as lh}from"url";import{existsSync as dh}from"fs";function ph(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=ah(lh(import.meta.url)),t=ch(r,"..","bin","mcp-skill.mjs");return dh(t)?t:null}function uh(){return process.env.PROJECT_API_TOKEN||process.env.ZIBBY_USER_TOKEN||null}function mh(){return((process.env.PROGRESS_API_URL||"").replace(/\/executions\/?$/,"")||process.env.ZIBBY_ACCOUNT_API_URL||process.env.ZIBBY_PROD_ACCOUNT_API_URL||(process.env.ZIBBY_ENV==="local"?"http://localhost:3001":"https://api-prod.zibby.app")).replace(/\/+$/,"")}var fh={name:"trigger_agent",description:"Trigger another Zibby workflow/agent run in THIS project (fire-and-forget). Call it once per run you want to start \u2014 the agent decides which and how many. Omit workflowType to re-run THIS same agent (self-dispatch, e.g. with a different trigger input). Returns the started run's executionId; does NOT wait for it to finish.",input_schema:{type:"object",properties:{workflowType:{type:"string",description:"Which workflow to trigger (its type/slug in this project). Omit to trigger THIS same agent (self-dispatch)."},input:{type:"object",description:"The trigger payload passed to the target workflow (validated against its state schema)."}},required:[]}},jo={id:"trigger-agent",callsBackend:!0,serverName:"trigger",allowedTools:["mcp__trigger__*"],envKeys:[],description:"Trigger another Zibby workflow/agent run in this project (agent-driven, fire-and-forget; cloud + self-hosted).",promptFragment:"## Trigger another agent (agent-driven)\nYou can start another Zibby agent run yourself with the `trigger_agent`\ntool \u2014 and YOU decide when and how many times to call it. Each call starts ONE\nindependent run (fire-and-forget) and returns its executionId; it does NOT wait for\nthat run to finish.\n- To re-run THIS same agent (self-dispatch) \u2014 e.g. to hand an item to another of\n this agent's scenarios \u2014 OMIT `workflowType` and pass the `input` for that run.\n- To trigger a DIFFERENT agent in the project, pass its `workflowType` + `input`.\nCall it once per run you want to start (loop over your items and call it for each).\nIt never throws \u2014 a failure comes back as { ok:false, error }; log it and move on.",resolve(){let r=ph();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","PROJECT_ID","WORKFLOW_TYPE","PROGRESS_API_URL","ZIBBY_ACCOUNT_API_URL","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_USER_TOKEN"])process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/triggerAgent.js","triggerAgentSkill"],env:t,description:this.description,alwaysLoad:!1}},async handleToolCall(r,t={}){if(r!=="trigger_agent")return JSON.stringify({ok:!1,error:`unknown tool: ${r}`});try{let e=process.env.PROJECT_ID,n=uh(),i=typeof t.workflowType=="string"&&t.workflowType.trim()?t.workflowType.trim():(process.env.WORKFLOW_TYPE||"").trim();if(!e)return JSON.stringify({ok:!1,error:"PROJECT_ID not set \u2014 cannot resolve the target project."});if(!n)return JSON.stringify({ok:!1,error:"PROJECT_API_TOKEN not set \u2014 cannot authenticate the trigger."});if(!i)return JSON.stringify({ok:!1,error:"No workflowType given and WORKFLOW_TYPE is unset \u2014 nothing to trigger."});let s=`${mh()}/projects/${encodeURIComponent(e)}/workflows/${encodeURIComponent(i)}/trigger`,o=new AbortController,a=setTimeout(()=>o.abort(),2e4),c;try{c=await fetch(s,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${n}`},body:JSON.stringify({input:t.input&&typeof t.input=="object"?t.input:{}}),signal:o.signal})}finally{clearTimeout(a)}let l=await c.text().catch(()=>""),d;try{d=l?JSON.parse(l):{}}catch{d={raw:l}}if(!c.ok)return JSON.stringify({ok:!1,error:`trigger failed (HTTP ${c.status})`,detail:d&&(d.error||d.message)||l.slice(0,300)});let p=d.executionId||d.execution?.id||d.id||null;return JSON.stringify({ok:!0,workflowType:i,executionId:p,note:"run started (fire-and-forget)"})}catch(e){return JSON.stringify({ok:!1,error:`trigger_agent failed: ${e?.message||String(e)}`})}},tools:[fh]};import{spawnSync as hh}from"node:child_process";import{existsSync as ln,mkdirSync as Lo,readdirSync as yh,writeFileSync as gh}from"node:fs";import{createHash as bh}from"node:crypto";import{join as ur}from"node:path";import{SKILL_META as _h}from"@zibby/skill-ids";function $o(){return process.env.CBM_BIN||"/usr/local/bin/codebase-memory-mcp"}function Po(){if(process.env.CBM_CACHE_DIR)return process.env.CBM_CACHE_DIR;let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE;return r?ur(r,".zibby","cbm-cache"):"/tmp/zibby-cbm-cache"}function wh(){let r=process.env.WORKSPACE||process.env.ZIBBY_WORKSPACE||"/workspace",t=ur(r,".zibby","repos");try{if(ln(t)){let e=yh(t,{withFileTypes:!0}).filter(n=>n.isDirectory()).map(n=>ur(t,n.name));if(e.length===1)return e[0];if(e.length>1)return t}}catch{}return null}function kh(r){return bh("sha256").update(r).digest("hex").slice(0,16)}var Co={id:"codebase-memory",serverName:"codebase_memory",meta:_h["codebase-memory"],allowedTools:["mcp__codebase_memory__*"],description:"Codebase memory \u2014 code-graph + semantic index over the checked-out repo (architecture, graph search, dependency trace, change detection)",promptFragment:`## Codebase Memory (code-graph + semantic index over THIS repo)
980
984
  The checked-out repository is indexed into a queryable code graph + semantic
981
985
  index. Reach for these instead of blindly grepping when you need structure,
982
986
  relationships, or "where does X live / what depends on Y":
@@ -988,7 +992,7 @@ relationships, or "where does X live / what depends on Y":
988
992
  - get_code_snippet / search_code: pull the exact code for a node / text match.
989
993
  - index_status / list_projects: confirm the index is present before querying.
990
994
  The repo is indexed for you at the start of the run; if a query comes back
991
- empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let r=Po();try{Lo(r,{recursive:!0})}catch{}let t={CBM_CACHE_DIR:r};return process.env.WORKSPACE&&(t.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:$o(),args:[],env:t,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let r=kh();if(!r)return{};let t=Po();try{Lo(t,{recursive:!0})}catch{}let e=ur(t,`.cbm-indexed-${wh(r)}`);if(ln(e))return{};let n=$o();if(!ln(n)&&!process.env.CBM_BIN)return{};let i=hh(n,["cli","index_repository",JSON.stringify({repo_path:r})],{env:{...process.env,CBM_CACHE_DIR:t},encoding:"utf-8",timeout:300*1e3,maxBuffer:32*1024*1024});try{gh(e,`${new Date().toISOString()} status=${i.status}
995
+ empty, call index_status, and only re-index (index_repository) if needed.`,resolve(){let r=Po();try{Lo(r,{recursive:!0})}catch{}let t={CBM_CACHE_DIR:r};return process.env.WORKSPACE&&(t.WORKSPACE=process.env.WORKSPACE),{type:"stdio",command:$o(),args:[],env:t,description:this.description,alwaysLoad:!0}},invokeAgentOptions(){try{let r=wh();if(!r)return{};let t=Po();try{Lo(t,{recursive:!0})}catch{}let e=ur(t,`.cbm-indexed-${kh(r)}`);if(ln(e))return{};let n=$o();if(!ln(n)&&!process.env.CBM_BIN)return{};let i=hh(n,["cli","index_repository",JSON.stringify({repo_path:r})],{env:{...process.env,CBM_CACHE_DIR:t},encoding:"utf-8",timeout:300*1e3,maxBuffer:32*1024*1024});try{gh(e,`${new Date().toISOString()} status=${i.status}
992
996
  `)}catch{}}catch{}return{}}};import{existsSync as Uo,readFileSync as Sh}from"node:fs";import{homedir as vh}from"node:os";import{join as Ih,dirname as Nh,resolve as Oh}from"node:path";import{fileURLToPath as Th}from"node:url";import{SKILL_META as Rh}from"@zibby/skill-ids";var Ah=3e4,dn=1;function Eh(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=Nh(Th(import.meta.url)),t=Oh(r,"..","bin","mcp-skill.mjs");return Uo(t)?t:null}function xh(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let r=Ih(vh(),".zibby","config.json");return Uo(r)&&JSON.parse(Sh(r,"utf-8")).sessionToken||null}catch{return null}}function jh(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function Lh(){let r={};for(let[t,e]of Object.entries(process.env)){let n=/^ZIBBY_STORE__(.+)$/.exec(t);if(!n)continue;let i=typeof e=="string"?e.trim():"";i&&(r[n[1]]=i)}return r}function pn(r){let t=Lh(),e=Object.keys(t),n=typeof r=="string"?r.trim():"";return n?Object.prototype.hasOwnProperty.call(t,n)?{storeId:t[n],name:n}:{error:`unknown store '${n}'; available: ${e.join(", ")}`}:e.length===1?{storeId:t[e[0]],name:e[0]}:e.length===0?{error:"no knowledge-base store is bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${e.join(", ")})`}}async function un(r,t,e){let n=xh();if(!n)throw new Error("No backend credential (PROJECT_API_TOKEN). The knowledge base is only available inside a Zibby run.");let i=`${jh()}/datasets/stores/${encodeURIComponent(r)}/${t}`,s={Authorization:`Bearer ${n}`,"Content-Type":"application/json"},o=JSON.stringify(e),a;for(let c=0;c<=dn;c++){let l=new AbortController,d=setTimeout(()=>l.abort(),Ah);try{let p=await fetch(i,{method:"POST",headers:s,body:o,signal:l.signal}),u=await p.text().catch(()=>"");if(p.status>=500&&c<dn){a=new Error(`store ${p.status}`);continue}if(!p.ok)throw new Error(`gbrain ${t} failed (${p.status}): ${u.slice(0,300)}`);try{return JSON.parse(u)}catch{throw new Error(`store returned non-JSON: ${u.slice(0,200)}`)}}catch(p){if(a=p,!((p?.name==="AbortError"||p?.code==="ECONNREFUSED"||/fetch failed|network/i.test(String(p?.message)))&&c<dn))break}finally{clearTimeout(d)}}throw a||new Error(`gbrain ${t} request failed`)}var Bo={id:"gbrain",callsBackend:!0,serverName:"gbrain",allowedTools:["mcp__gbrain__*"],meta:Rh.gbrain,description:"Knowledge base (GBrain) \u2014 ingest source documents into, semantically query, and prune a per-tenant Postgres/pgvector brain (a `postgres`-type store, brokered by the control-plane)",promptFragment:`## Knowledge Base (GBrain \u2014 per-tenant document brain)
993
997
  You have a per-tenant KNOWLEDGE BASE (a Postgres + pgvector "brain"), bound as a
994
998
  \`postgres\`-type store in the "AVAILABLE STORES" block below. Ingested documents
@@ -1000,7 +1004,7 @@ Tools:
1000
1004
  Pass deleted:true to remove a source that no longer exists upstream.
1001
1005
  - gbrain_query({ query, topK, store? }): semantic search; returns the topK most
1002
1006
  relevant document chunks with their sourceId and relevance score.
1003
- - gbrain_delete({ sourceIds, store? }): remove documents by their stable sourceId(s).`,resolve(){let r=Eh();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);for(let e of Object.keys(process.env))/^ZIBBY_STORE__.+$/.test(e)&&process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/gbrain.js","gbrainSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"gbrain_ingest":{let e=Array.isArray(t?.docs)?t.docs:null;if(!e)return JSON.stringify({error:"docs is required (array of { sourceId, markdown, deleted? })"});if(e.length===0)return JSON.stringify({ok:!0,upserted:0,deleted:0,chunks:0,note:"empty docs \u2014 nothing to ingest"});if(e.find(a=>!a||typeof a.sourceId!="string"||!a.sourceId.trim())!==void 0)return JSON.stringify({error:"every doc requires a non-empty string sourceId"});let i=e.find(a=>a.deleted!==!0&&(typeof a.markdown!="string"||!a.markdown.length));if(i!==void 0)return JSON.stringify({error:`doc "${i.sourceId}" has no markdown (required unless deleted:true)`});let s=pn(t?.store);if(s.error)return JSON.stringify({error:s.error});let o=await un(s.storeId,"ingest",{docs:e});return JSON.stringify({...o,store:s.name,storeId:s.storeId})}case"gbrain_query":{let e=typeof t?.query=="string"?t.query.trim():"";if(!e)return JSON.stringify({error:"query is required"});let n=pn(t?.store);if(n.error)return JSON.stringify({error:n.error});let i={query:e};Number.isInteger(t?.topK)&&t.topK>0&&(i.topK=Math.min(t.topK,50));let s=await un(n.storeId,"query",i);return JSON.stringify({...s,store:n.name,storeId:n.storeId})}case"gbrain_delete":{let e=Array.isArray(t?.sourceIds)?t.sourceIds.filter(s=>typeof s=="string"&&s.trim()):null;if(!e||e.length===0)return JSON.stringify({error:"sourceIds is required (non-empty array of strings)"});let n=pn(t?.store);if(n.error)return JSON.stringify({error:n.error});let i=await un(n.storeId,"delete",{sourceIds:e});return JSON.stringify({...i,store:n.name,storeId:n.storeId})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:String(e?.message||e)})}},tools:[{name:"gbrain_ingest",description:'Upsert documents into the knowledge base. Each doc is { sourceId, markdown, deleted? }; sourceId is a STABLE id (e.g. "owner/repo#docs/x.md" or a Lark doc token) so re-ingesting the same source UPDATES in place instead of duplicating. Set deleted:true to remove a source.',input_schema:{type:"object",properties:{docs:{type:"array",description:"Documents to upsert.",items:{type:"object",properties:{sourceId:{type:"string",description:"Stable source id \u2014 the upsert/delete key."},markdown:{type:"string",description:"The normalized markdown content of the document."},deleted:{type:"boolean",description:"When true, remove this sourceId from the brain (markdown ignored)."}},required:["sourceId"]}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["docs"]}},{name:"gbrain_query",description:"Semantic-search the knowledge base and return the most relevant document chunks (each with its sourceId and relevance score).",input_schema:{type:"object",properties:{query:{type:"string",description:"Natural-language query."},topK:{type:"integer",description:"How many chunks to return (default 8, max 50)."},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["query"]}},{name:"gbrain_delete",description:"Remove documents from the knowledge base by their stable sourceId(s).",input_schema:{type:"object",properties:{sourceIds:{type:"array",description:"Stable source ids to delete.",items:{type:"string"}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["sourceIds"]}}]};import{existsSync as he,readFileSync as wt,readdirSync as mn,mkdirSync as $h,writeFileSync as Qe,statSync as qo}from"fs";import{join as E,resolve as fn,relative as Mo,dirname as Fo}from"path";import{fileURLToPath as Ph}from"url";import{createRequire as Ch}from"module";var Uh=Ch(import.meta.url),Bh=`## Workflow Builder
1007
+ - gbrain_delete({ sourceIds, store? }): remove documents by their stable sourceId(s).`,resolve(){let r=Eh();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(t[e]=process.env[e]);for(let e of Object.keys(process.env))/^ZIBBY_STORE__.+$/.test(e)&&process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/gbrain.js","gbrainSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"gbrain_ingest":{let e=Array.isArray(t?.docs)?t.docs:null;if(!e)return JSON.stringify({error:"docs is required (array of { sourceId, markdown, deleted? })"});if(e.length===0)return JSON.stringify({ok:!0,upserted:0,deleted:0,chunks:0,note:"empty docs \u2014 nothing to ingest"});if(e.find(a=>!a||typeof a.sourceId!="string"||!a.sourceId.trim())!==void 0)return JSON.stringify({error:"every doc requires a non-empty string sourceId"});let i=e.find(a=>a.deleted!==!0&&(typeof a.markdown!="string"||!a.markdown.length));if(i!==void 0)return JSON.stringify({error:`doc "${i.sourceId}" has no markdown (required unless deleted:true)`});let s=pn(t?.store);if(s.error)return JSON.stringify({error:s.error});let o=await un(s.storeId,"ingest",{docs:e});return JSON.stringify({...o,store:s.name,storeId:s.storeId})}case"gbrain_query":{let e=typeof t?.query=="string"?t.query.trim():"";if(!e)return JSON.stringify({error:"query is required"});let n=pn(t?.store);if(n.error)return JSON.stringify({error:n.error});let i={query:e};Number.isInteger(t?.topK)&&t.topK>0&&(i.topK=Math.min(t.topK,50));let s=await un(n.storeId,"query",i);return JSON.stringify({...s,store:n.name,storeId:n.storeId})}case"gbrain_delete":{let e=Array.isArray(t?.sourceIds)?t.sourceIds.filter(s=>typeof s=="string"&&s.trim()):null;if(!e||e.length===0)return JSON.stringify({error:"sourceIds is required (non-empty array of strings)"});let n=pn(t?.store);if(n.error)return JSON.stringify({error:n.error});let i=await un(n.storeId,"delete",{sourceIds:e});return JSON.stringify({...i,store:n.name,storeId:n.storeId})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:String(e?.message||e)})}},tools:[{name:"gbrain_ingest",description:'Upsert documents into the knowledge base. Each doc is { sourceId, markdown, deleted? }; sourceId is a STABLE id (e.g. "owner/repo#docs/x.md" or a Lark doc token) so re-ingesting the same source UPDATES in place instead of duplicating. Set deleted:true to remove a source.',input_schema:{type:"object",properties:{docs:{type:"array",description:"Documents to upsert.",items:{type:"object",properties:{sourceId:{type:"string",description:"Stable source id \u2014 the upsert/delete key."},markdown:{type:"string",description:"The normalized markdown content of the document."},deleted:{type:"boolean",description:"When true, remove this sourceId from the brain (markdown ignored)."}},required:["sourceId"]}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["docs"]}},{name:"gbrain_query",description:"Semantic-search the knowledge base and return the most relevant document chunks (each with its sourceId and relevance score).",input_schema:{type:"object",properties:{query:{type:"string",description:"Natural-language query."},topK:{type:"integer",description:"How many chunks to return (default 8, max 50)."},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["query"]}},{name:"gbrain_delete",description:"Remove documents from the knowledge base by their stable sourceId(s).",input_schema:{type:"object",properties:{sourceIds:{type:"array",description:"Stable source ids to delete.",items:{type:"string"}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["sourceIds"]}}]};import{existsSync as he,readFileSync as kt,readdirSync as mn,mkdirSync as $h,writeFileSync as Qe,statSync as qo}from"fs";import{join as E,resolve as fn,relative as Mo,dirname as Fo}from"path";import{fileURLToPath as Ph}from"url";import{createRequire as Ch}from"module";var Uh=Ch(import.meta.url),Bh=`## Workflow Builder
1004
1008
 
1005
1009
  You can help users build custom AI workflows using the Zibby workflow framework.
1006
1010
 
@@ -1110,7 +1114,7 @@ Call with no arguments to see all available topics.
1110
1114
  - Workflow names must be kebab-case (e.g., ticket-triage, pr-review).
1111
1115
  - State flows through: each node's validated output is stored under its name in state (e.g., state.classify_ticket).
1112
1116
  - Downstream nodes reference upstream outputs in their prompt function (e.g., \\\`\\\${JSON.stringify(state.classify_ticket, null, 2)}\\\`).
1113
- - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Ko=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function Go(r){return`${r.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function kt(r){return`${r.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function Jh(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 Dh(r){let t=fn(r,".zibby.config.mjs");if(!he(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function qh(){try{let r=Fo(Uh.resolve("@zibby/core/package.json")),t=E(r,"templates","browser-test-automation"),e=wt(E(t,"nodes","preflight.mjs"),"utf-8"),n=wt(E(t,"graph.mjs"),"utf-8");return{preflight:e,graph:n}}catch{return null}}var Jo=Fo(Ph(import.meta.url));function Ho(){let r=fn(Jo,"..","..","..","docsite","docs");if(he(r))return r;let t=fn(Jo,"..","docs");return he(t)?t:null}function Do(){let r=Ho();if(!r)return[];try{let t=(e,n="")=>{let i=[];for(let s of mn(e)){let o=E(e,s);try{if(qo(o).isDirectory())i=i.concat(t(o,`${n}${s}/`));else if(s.endsWith(".md")){let a=`${n}${s.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return t(r)}catch{return[]}}function zo(r){let t=Ho();if(!t)return null;let e=E(t,`${r}.md`);if(!he(e))return null;try{return wt(e,"utf-8")}catch{return null}}function Mh(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",l=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${a}. ${c}.${l?` ${l}`:""}`}).join(`
1117
+ - Nodes can declare skills to get MCP tool access \u2014 the framework handles server lifecycle automatically.`,Ko=/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/;function Go(r){return`${r.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}Workflow`}function wt(r){return`${r.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}Node`}function Jh(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 Dh(r){let t=fn(r,".zibby.config.mjs");if(!he(t))return{};try{return(await import(t)).default||{}}catch{return{}}}function qh(){try{let r=Fo(Uh.resolve("@zibby/core/package.json")),t=E(r,"templates","browser-test-automation"),e=kt(E(t,"nodes","preflight.mjs"),"utf-8"),n=kt(E(t,"graph.mjs"),"utf-8");return{preflight:e,graph:n}}catch{return null}}var Jo=Fo(Ph(import.meta.url));function Ho(){let r=fn(Jo,"..","..","..","docsite","docs");if(he(r))return r;let t=fn(Jo,"..","docs");return he(t)?t:null}function Do(){let r=Ho();if(!r)return[];try{let t=(e,n="")=>{let i=[];for(let s of mn(e)){let o=E(e,s);try{if(qo(o).isDirectory())i=i.concat(t(o,`${n}${s}/`));else if(s.endsWith(".md")){let a=`${n}${s.replace(/\.md$/,"")}`;i.push(a)}}catch{}}return i};return t(r)}catch{return[]}}function zo(r){let t=Ho();if(!t)return null;let e=E(t,`${r}.md`);if(!he(e))return null;try{return kt(e,"utf-8")}catch{return null}}function Mh(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",l=o.skills?.length?`Skills: ${o.skills.join(", ")}`:"";return`- ${o.name}: ${o.description}. ${a}. ${c}.${l?` ${l}`:""}`}).join(`
1114
1118
  `),e=r.edges.map(o=>o.condition?`- ${o.from} \u2192 ${o.to} (conditional: ${o.condition})`:`- ${o.from} \u2192 ${o.to}`).join(`
1115
1119
  `),n=qh(),i=zo("custom-workflows"),s="";return n&&(s+=`
1116
1120
  ## Real working examples from the Zibby framework
@@ -1189,7 +1193,7 @@ Return a JSON object with this exact structure:
1189
1193
  }
1190
1194
  }
1191
1195
 
1192
- IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function Yo(r,t){let e=await Dh(t),n=Jh(e);try{let{invokeAgent:i}=await import("@zibby/core"),s=Mh(r),o=await i(s,{state:{agentType:n,config:e,cwd:t,workspace:t}},{model:e?.agent?.[n]?.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`),Fh(r)}}function Fh(r){let t={};for(let e of r.nodes){let n=kt(e.name),i=`${e.name.split("_").map(c=>c.charAt(0).toUpperCase()+c.slice(1)).join("")}OutputSchema`,s=e.outputFields?.length?e.outputFields.map(c=>` ${c}: z.string().describe('${c}'),`).join(`
1196
+ IMPORTANT: Return ONLY valid JSON. No markdown fences, no explanation outside the JSON.`}async function Yo(r,t){let e=await Dh(t),n=Jh(e);try{let{invokeAgent:i}=await import("@zibby/core"),s=Mh(r),o=await i(s,{state:{agentType:n,config:e,cwd:t,workspace:t}},{model:e?.agent?.[n]?.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`),Fh(r)}}function Fh(r){let t={};for(let e of r.nodes){let n=wt(e.name),i=`${e.name.split("_").map(c=>c.charAt(0).toUpperCase()+c.slice(1)).join("")}OutputSchema`,s=e.outputFields?.length?e.outputFields.map(c=>` ${c}: z.string().describe('${c}'),`).join(`
1193
1197
  `):` summary: z.string().describe('Summary of the result'),
1194
1198
  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(`
1195
1199
  `),a=o?`${e.description}
@@ -1211,9 +1215,9 @@ export const ${n} = {
1211
1215
  prompt: (state) => \`${a}\`,
1212
1216
  outputSchema: ${i},
1213
1217
  };
1214
- `}}return{nodes:t}}function Kh(r,t,e,n){let i=t.toLowerCase(),s=Go(i),o=E(r,".zibby","workflows",i),a=E(o,"nodes");$h(a,{recursive:!0});let c=e.nodes.map(y=>y.name);for(let y of e.nodes){let b=n.nodes?.[y.name]?.code;b&&Qe(E(a,`${y.name.replace(/_/g,"-")}.mjs`),b,"utf-8")}let l=c.map(y=>{let b=kt(y),g=y.replace(/_/g,"-");return`export { ${b} } from './${g}.mjs';`});Qe(E(a,"index.mjs"),`${l.join(`
1218
+ `}}return{nodes:t}}function Kh(r,t,e,n){let i=t.toLowerCase(),s=Go(i),o=E(r,".zibby","workflows",i),a=E(o,"nodes");$h(a,{recursive:!0});let c=e.nodes.map(y=>y.name);for(let y of e.nodes){let b=n.nodes?.[y.name]?.code;b&&Qe(E(a,`${y.name.replace(/_/g,"-")}.mjs`),b,"utf-8")}let l=c.map(y=>{let b=wt(y),g=y.replace(/_/g,"-");return`export { ${b} } from './${g}.mjs';`});Qe(E(a,"index.mjs"),`${l.join(`
1215
1219
  `)}
1216
- `,"utf-8");let d=c[0],p=c.map(y=>kt(y)).join(", "),u=c.map(y=>` graph.addNode('${y}', ${kt(y)});`).join(`
1220
+ `,"utf-8");let d=c[0],p=c.map(y=>wt(y)).join(", "),u=c.map(y=>` graph.addNode('${y}', ${wt(y)});`).join(`
1217
1221
  `),m=e.edges.map(y=>y.condition?` graph.addConditionalEdges('${y.from}', (state) => {
1218
1222
  ${y.condition}
1219
1223
  });`:` graph.addEdge('${y.from}', '${y.to}');`).join(`
@@ -1237,8 +1241,8 @@ ${m}
1237
1241
  }
1238
1242
  }
1239
1243
  `;Qe(E(o,"graph.mjs"),f,"utf-8");let h={name:i,description:e.description||`${s} workflow`,entryClass:s,triggers:{api:!0}};Qe(E(o,"workflow.json"),`${JSON.stringify(h,null,2)}
1240
- `,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(y=>`nodes/${y.replace(/_/g,"-")}.mjs`)];return{workflowDir:Mo(r,o),files:_,className:s,slug:i}}async function Gh(r){let{name:t,description:e,nodes:n,edges:i}=r;if(!t||!Ko.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!n||n.length===0)return JSON.stringify({error:"At least one node is required."});let s={name:t.toLowerCase(),description:e||`${Go(t.toLowerCase())} workflow`,nodes:n.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(s.edges.length===0&&s.nodes.length>0){for(let o=0;o<s.nodes.length-1;o++)s.edges.push({from:s.nodes[o].name,to:s.nodes[o+1].name});s.edges.push({from:s.nodes[s.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:s,message:`Workflow "${s.name}" designed with ${s.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:s.nodes.map(o=>o.name),flow:s.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Hh(r,t){let{name:e,spec:n}=r,i=(e||n?.name||"").toLowerCase();if(!i||!Ko.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!n||!n.nodes||n.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let s=E(t,".zibby","workflows",i);if(he(s))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await Yo(n,t),a=Kh(t,i,n,o);return JSON.stringify({ok:!0,...a,message:`Workflow "${i}" created at ${a.workflowDir}/`,nextSteps:[`Test locally: zibby start ${i}`,`Deploy to cloud: zibby deploy ${i} --project <project-id>`,`Tail logs: zibby logs --workflow ${i} --project <project-id>`]})}async function zh(r,t){let{workflowName:e,nodeName:n,description:i,inputFields:s,outputFields:o}=r,a=(e||"").toLowerCase(),c=(n||"").replace(/-/g,"_"),l=E(t,".zibby","workflows",a);if(!he(l))return JSON.stringify({error:`Workflow "${a}" not found. Create it first with build_workflow.`});let d={name:a,description:"",nodes:[{name:c,description:i||`Process ${c}`,inputFields:s||[],outputFields:o||[]}],edges:[]},u=(await Yo(d,t)).nodes?.[c]?.code;if(!u)return JSON.stringify({error:"Failed to generate node code."});let m=E(l,"nodes"),f=`${c.replace(/_/g,"-")}.mjs`;Qe(E(m,f),u,"utf-8");let h=E(m,"index.mjs"),_=kt(c),y=`export { ${_} } from './${c.replace(/_/g,"-")}.mjs';
1241
- `,b=he(h)?wt(h,"utf-8"):"";return b.includes(_)||Qe(h,b+y,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Yh(r,t){let{name:e,projectId:n}=r,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!n)return JSON.stringify({error:"projectId is required."});let s=E(t,".zibby","workflows",i);if(!he(s))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${E(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${n}`,{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 ${n}`,{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 Wh(r){let t=E(r,".zibby","workflows");if(!he(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let n=mn(t).filter(i=>{try{return qo(E(t,i)).isDirectory()}catch{return!1}}).map(i=>{let s=E(t,i,"workflow.json"),o={};try{o=JSON.parse(wt(s,"utf-8"))}catch{}let a=E(t,i,"nodes"),c=0;try{c=mn(a).filter(l=>l.endsWith(".mjs")&&l!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Mo(r,E(t,i))}});return JSON.stringify({workflows:n})}var Wo={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Bh,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 n=e?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await Gh(t);case"build_workflow":return await Hh(t,n);case"add_node":return await zh(t,n);case"deploy_workflow":return await Yh(t,n);case"list_workflows":return Wh(n);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=Do();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let s=zo(i);if(!s){let o=Do();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:s})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Zh}from"@zibby/core/backend-client.js";var yn=Object.freeze({id:"openai_billing",callsBackend:!0,requiresIntegration:I.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),gn=Object.freeze({id:"anthropic_billing",callsBackend:!0,requiresIntegration:I.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),bn=Object.freeze({id:"cursor_admin",callsBackend:!0,requiresIntegration:I.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Zo(r){return Math.floor(r/1e3)}function hn(r){return new Date(r).toISOString().slice(0,10)}function Vo(r){return new Date(r).toISOString()}async function St(r){let t=await Zh(r);if(!t?.token)throw new Error(`${r} token resolver returned no token`);return t.token}async function Xo({startMs:r,endMs:t,groupBy:e=["project_id","line_item"]}){let n=await St("openai_billing"),i=[],s=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let d=`https://api.openai.com/v1/organization/costs?${[`start_time=${Zo(r)}`,`end_time=${Zo(t)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(d,{headers:{Authorization:`Bearer ${n}`}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`OpenAI costs API ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){s+=1;let f=hn((m.start_time||0)*1e3);for(let h of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(h.amount?.value??0),projectId:h.project_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.line_item||void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:s}}async function Vh(){let r=await St("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${r}`}});if(!e.ok){let s=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${s.slice(0,200)}`)}let n=await e.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function Qo({startMs:r,endMs:t,groupBy:e=["workspace_id"]}){let n=await St("anthropic_billing"),i=[],s=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let d=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(Vo(r))}`,`ending_at=${encodeURIComponent(Vo(t))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(d,{headers:{"x-api-key":n,"anthropic-version":"2023-06-01"}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`Anthropic cost_report ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){s+=1;let f=(m.starting_at||"").slice(0,10);for(let h of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(h.amount??h.cost??0),workspaceId:h.workspace_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.model||void 0,tokensIn:h.uncached_input_tokens!=null?Number(h.uncached_input_tokens):void 0,tokensOut:h.output_tokens!=null?Number(h.output_tokens):void 0,cachedTokens:h.cached_input_tokens!=null?Number(h.cached_input_tokens):void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:s}}async function Xh(){let r=await St("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 s=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${s.slice(0,200)}`)}let n=await e.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function ea({startMs:r,endMs:t}){let e=await St("cursor_admin"),n=hn(r),i=hn(t),s=`https://api.cursor.com/teams/daily-usage-data?startDate=${n}&endDate=${i}`,o=await fetch(s,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let d=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${d.slice(0,200)}`)}let a=await o.json(),c=[],l=0;for(let d of a.data||[]){l+=1;let p=d.date;for(let u of d.userMetrics||[]){for(let m of u.modelUsage||[]){let f=Number(m.acceptedLines??0),h=Number(m.suggestedLines??0);c.push({provider:"cursor",day:p,costUsd:Number(m.totalCents??0)/100,userEmail:u.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:h>0?f/h:void 0})}(!u.modelUsage||u.modelUsage.length===0)&&c.push({provider:"cursor",day:p,costUsd:Number(u.totalCents??0)/100,userEmail:u.email})}}return{ok:!0,items:c,rawBuckets:l}}async function Qh({startMs:r,endMs:t}){let[e,n,i]=await Promise.allSettled([Xo({startMs:r,endMs:t}),Qo({startMs:r,endMs:t}),ea({startMs:r,endMs:t})]),s=d=>d.status==="fulfilled"?d.value:{ok:!1,error:d.reason?.message||String(d.reason),items:[]},o=s(e),a=s(n),c=s(i),l=[{provider:"openai",totalUsd:o.items.reduce((d,p)=>d+(p.costUsd||0),0)},{provider:"anthropic",totalUsd:a.items.reduce((d,p)=>d+(p.costUsd||0),0)},{provider:"cursor",totalUsd:c.items.reduce((d,p)=>d+(p.costUsd||0),0)}];return{openai:o,anthropic:a,cursor:c,totals:l}}function ey(r,t){let e=new Map;for(let n of r){let i=t(n);if(!i)continue;let s=e.get(i)||{key:i,totalUsd:0,count:0};s.totalUsd+=n.costUsd||0,s.count+=1,e.set(i,s)}return[...e.values()].sort((n,i)=>i.totalUsd-n.totalUsd)}function ty(r){if(!r.length)return{mean:0,stddev:0};let t=r.reduce((n,i)=>n+i,0)/r.length,e=r.reduce((n,i)=>n+(i-t)**2,0)/r.length;return{mean:t,stddev:Math.sqrt(e)}}import{SKILL_IDS as Rw}from"@zibby/skill-ids";import{z as w}from"zod";var vt=["ok","info","warn","critical"],ry=w.object({primary:w.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:w.object({value:w.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:w.enum(["up","down","flat"]).optional(),severity:w.enum(vt).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:w.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),ny=w.object({kind:w.literal("trend"),title:w.string().max(120).optional(),labels:w.array(w.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:w.array(w.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:w.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:w.enum(vt).optional()}),iy=w.object({kind:w.literal("table"),title:w.string().max(120).optional(),headers:w.array(w.string().max(40)).min(1).max(8),rows:w.array(w.array(w.union([w.string().max(200),w.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),sy=w.object({kind:w.literal("callouts"),title:w.string().max(120).optional(),tone:w.enum(vt).default("info").optional(),items:w.array(w.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),oy=w.object({kind:w.literal("breakdown"),title:w.string().max(120).optional(),rows:w.array(w.object({label:w.string().min(1).max(80),value:w.string().min(1).max(80),sub:w.string().max(120).optional(),severity:w.enum(vt).optional()})).min(1).max(20)}),ay=w.object({kind:w.literal("paragraph"),title:w.string().max(120).optional(),text:w.string().min(1).max(3e3)}),cy=w.discriminatedUnion("kind",[ny,iy,sy,oy,ay]),It=w.object({title:w.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:w.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:ry,sections:w.array(cy).max(20).default([]).superRefine((r,t)=>{r.forEach((e,n)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:w.ZodIssueCode.custom,path:[n,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:w.ZodIssueCode.custom,path:[n,"rows"],message:"every row must have headers.length entries"})})}),footer:w.object({viewUrl:w.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:w.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),B=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),mr=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),ly=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function fr(r,t,e=12){if(!Number.isFinite(r)||!Number.isFinite(t)||t<=0)return"";let n=Math.max(0,Math.min(1,r/t)),i=Math.round(n*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function Nt(r,t){let e=String(r);return e.length>=t?e:e+" ".repeat(t-e.length)}function hr(r,t){let e=String(r);return e.length>=t?e:" ".repeat(t-e.length)+e}function na({headers:r,rows:t}){let e=r.map((o,a)=>{let c=Math.max(String(o).length,...t.map(l=>String(l[a]??"").length));return Math.min(c,32)}),n=o=>o.map((a,c)=>Nt(a,e[c])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[n(r),i,...t.map(o=>n(o))].join(`
1244
+ `,"utf-8");let _=["graph.mjs","workflow.json","nodes/index.mjs",...c.map(y=>`nodes/${y.replace(/_/g,"-")}.mjs`)];return{workflowDir:Mo(r,o),files:_,className:s,slug:i}}async function Gh(r){let{name:t,description:e,nodes:n,edges:i}=r;if(!t||!Ko.test(t.toLowerCase()))return JSON.stringify({error:`Invalid workflow name "${t}". Must be kebab-case, 2-64 chars, lowercase letters/numbers/hyphens.`});if(!n||n.length===0)return JSON.stringify({error:"At least one node is required."});let s={name:t.toLowerCase(),description:e||`${Go(t.toLowerCase())} workflow`,nodes:n.map(o=>({name:o.name.replace(/-/g,"_"),description:o.description||`Process ${o.name}`,inputFields:o.inputFields||[],outputFields:o.outputFields||[]})),edges:i||[]};if(s.edges.length===0&&s.nodes.length>0){for(let o=0;o<s.nodes.length-1;o++)s.edges.push({from:s.nodes[o].name,to:s.nodes[o+1].name});s.edges.push({from:s.nodes[s.nodes.length-1].name,to:"END"})}return JSON.stringify({ok:!0,spec:s,message:`Workflow "${s.name}" designed with ${s.nodes.length} node(s). Call build_workflow to generate the code.`,preview:{nodes:s.nodes.map(o=>o.name),flow:s.edges.map(o=>o.condition?`${o.from} \u2192(if ${o.condition})\u2192 ${o.to}`:`${o.from} \u2192 ${o.to}`)}})}async function Hh(r,t){let{name:e,spec:n}=r,i=(e||n?.name||"").toLowerCase();if(!i||!Ko.test(i))return JSON.stringify({error:`Invalid workflow name "${i}".`});if(!n||!n.nodes||n.nodes.length===0)return JSON.stringify({error:"spec with nodes is required. Call design_workflow first."});let s=E(t,".zibby","workflows",i);if(he(s))return JSON.stringify({error:`Workflow "${i}" already exists at .zibby/workflows/${i}/. Delete it first or choose a different name.`});let o=await Yo(n,t),a=Kh(t,i,n,o);return JSON.stringify({ok:!0,...a,message:`Workflow "${i}" created at ${a.workflowDir}/`,nextSteps:[`Test locally: zibby start ${i}`,`Deploy to cloud: zibby deploy ${i} --project <project-id>`,`Tail logs: zibby logs --workflow ${i} --project <project-id>`]})}async function zh(r,t){let{workflowName:e,nodeName:n,description:i,inputFields:s,outputFields:o}=r,a=(e||"").toLowerCase(),c=(n||"").replace(/-/g,"_"),l=E(t,".zibby","workflows",a);if(!he(l))return JSON.stringify({error:`Workflow "${a}" not found. Create it first with build_workflow.`});let d={name:a,description:"",nodes:[{name:c,description:i||`Process ${c}`,inputFields:s||[],outputFields:o||[]}],edges:[]},u=(await Yo(d,t)).nodes?.[c]?.code;if(!u)return JSON.stringify({error:"Failed to generate node code."});let m=E(l,"nodes"),f=`${c.replace(/_/g,"-")}.mjs`;Qe(E(m,f),u,"utf-8");let h=E(m,"index.mjs"),_=wt(c),y=`export { ${_} } from './${c.replace(/_/g,"-")}.mjs';
1245
+ `,b=he(h)?kt(h,"utf-8"):"";return b.includes(_)||Qe(h,b+y,"utf-8"),JSON.stringify({ok:!0,file:`nodes/${f}`,exportName:_,message:`Node "${c}" added. Update graph.mjs to wire it into the graph.`})}async function Yh(r,t){let{name:e,projectId:n}=r,i=(e||"").toLowerCase();if(!i)return JSON.stringify({error:"Workflow name is required."});if(!n)return JSON.stringify({error:"projectId is required."});let s=E(t,".zibby","workflows",i);if(!he(s))return JSON.stringify({error:`Workflow "${i}" not found at .zibby/workflows/${i}/`});try{let{execSync:o}=await import("child_process"),a=o(`node "${E(t,"packages/cli/bin/zibby.js")}" deploy ${i} --project ${n}`,{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 ${n}`,{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 Wh(r){let t=E(r,".zibby","workflows");if(!he(t))return JSON.stringify({workflows:[],message:"No workflows found. Use build_workflow to create one."});let n=mn(t).filter(i=>{try{return qo(E(t,i)).isDirectory()}catch{return!1}}).map(i=>{let s=E(t,i,"workflow.json"),o={};try{o=JSON.parse(kt(s,"utf-8"))}catch{}let a=E(t,i,"nodes"),c=0;try{c=mn(a).filter(l=>l.endsWith(".mjs")&&l!=="index.mjs").length}catch{}return{name:i,description:o.description||"",nodeCount:c,path:Mo(r,E(t,i))}});return JSON.stringify({workflows:n})}var Wo={id:"workflow-builder",description:"Build, scaffold, and deploy custom AI workflows via conversation",envKeys:[],promptFragment:Bh,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 n=e?.options?.workspace||process.cwd();try{switch(r){case"design_workflow":return await Gh(t);case"build_workflow":return await Hh(t,n);case"add_node":return await zh(t,n);case"deploy_workflow":return await Yh(t,n);case"list_workflows":return Wh(n);case"explore_framework_docs":{let i=(t.topic||"").trim();if(!i){let o=Do();return JSON.stringify({available:o,hint:"Call again with a topic to read its content."})}let s=zo(i);if(!s){let o=Do();return JSON.stringify({error:`Doc "${i}" not found.`,available:o})}return JSON.stringify({topic:i,content:s})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(i){return JSON.stringify({error:i.message})}},resolve(){return null}};import{resolveIntegrationToken as Zh}from"@zibby/core/backend-client.js";var yn=Object.freeze({id:"openai_billing",callsBackend:!0,requiresIntegration:I.OPENAI_BILLING,description:"OpenAI organization billing/usage admin API (paste sk-admin-... key)"}),gn=Object.freeze({id:"anthropic_billing",callsBackend:!0,requiresIntegration:I.ANTHROPIC_BILLING,description:"Anthropic organization cost/usage admin API (paste sk-ant-admin-... key)"}),bn=Object.freeze({id:"cursor_admin",callsBackend:!0,requiresIntegration:I.CURSOR_ADMIN,description:"Cursor Team/Enterprise admin API (paste admin key)"});function Zo(r){return Math.floor(r/1e3)}function hn(r){return new Date(r).toISOString().slice(0,10)}function Vo(r){return new Date(r).toISOString()}async function St(r){let t=await Zh(r);if(!t?.token)throw new Error(`${r} token resolver returned no token`);return t.token}async function Xo({startMs:r,endMs:t,groupBy:e=["project_id","line_item"]}){let n=await St("openai_billing"),i=[],s=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let d=`https://api.openai.com/v1/organization/costs?${[`start_time=${Zo(r)}`,`end_time=${Zo(t)}`,"bucket_width=1d","limit=180",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(d,{headers:{Authorization:`Bearer ${n}`}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`OpenAI costs API ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){s+=1;let f=hn((m.start_time||0)*1e3);for(let h of m.results||[])i.push({provider:"openai",day:f,costUsd:Number(h.amount?.value??0),projectId:h.project_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.line_item||void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:s}}async function Vh(){let r=await St("openai_billing"),e=await fetch("https://api.openai.com/v1/organization/projects?limit=100",{headers:{Authorization:`Bearer ${r}`}});if(!e.ok){let s=await e.text().catch(()=>"");throw new Error(`OpenAI projects API ${e.status}: ${s.slice(0,200)}`)}let n=await e.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function Qo({startMs:r,endMs:t,groupBy:e=["workspace_id"]}){let n=await St("anthropic_billing"),i=[],s=0,o=e.map(c=>`group_by[]=${encodeURIComponent(c)}`).join("&"),a=null;for(let c=0;c<50;c++){let d=`https://api.anthropic.com/v1/organizations/cost_report?${[`starting_at=${encodeURIComponent(Vo(r))}`,`ending_at=${encodeURIComponent(Vo(t))}`,"bucket=1d","limit=100",o,a?`page=${encodeURIComponent(a)}`:""].filter(Boolean).join("&")}`,p=await fetch(d,{headers:{"x-api-key":n,"anthropic-version":"2023-06-01"}});if(!p.ok){let m=await p.text().catch(()=>"");throw new Error(`Anthropic cost_report ${p.status}: ${m.slice(0,200)}`)}let u=await p.json();for(let m of u.data||[]){s+=1;let f=(m.starting_at||"").slice(0,10);for(let h of m.results||[])i.push({provider:"anthropic",day:f,costUsd:Number(h.amount??h.cost??0),workspaceId:h.workspace_id||void 0,apiKeyId:h.api_key_id||void 0,model:h.model||void 0,tokensIn:h.uncached_input_tokens!=null?Number(h.uncached_input_tokens):void 0,tokensOut:h.output_tokens!=null?Number(h.output_tokens):void 0,cachedTokens:h.cached_input_tokens!=null?Number(h.cached_input_tokens):void 0})}if(!u.has_more||!u.next_page)break;a=u.next_page}return{ok:!0,items:i,rawBuckets:s}}async function Xh(){let r=await St("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 s=await e.text().catch(()=>"");throw new Error(`Anthropic workspaces ${e.status}: ${s.slice(0,200)}`)}let n=await e.json(),i=new Map;for(let s of n.data||[])i.set(s.id,s.name);return i}async function ea({startMs:r,endMs:t}){let e=await St("cursor_admin"),n=hn(r),i=hn(t),s=`https://api.cursor.com/teams/daily-usage-data?startDate=${n}&endDate=${i}`,o=await fetch(s,{headers:{Authorization:`Bearer ${e}`}});if(!o.ok){let d=await o.text().catch(()=>"");throw new Error(`Cursor daily-usage ${o.status}: ${d.slice(0,200)}`)}let a=await o.json(),c=[],l=0;for(let d of a.data||[]){l+=1;let p=d.date;for(let u of d.userMetrics||[]){for(let m of u.modelUsage||[]){let f=Number(m.acceptedLines??0),h=Number(m.suggestedLines??0);c.push({provider:"cursor",day:p,costUsd:Number(m.totalCents??0)/100,userEmail:u.email,model:m.model,requestCount:Number(m.requestCount??0),acceptanceRate:h>0?f/h:void 0})}(!u.modelUsage||u.modelUsage.length===0)&&c.push({provider:"cursor",day:p,costUsd:Number(u.totalCents??0)/100,userEmail:u.email})}}return{ok:!0,items:c,rawBuckets:l}}async function Qh({startMs:r,endMs:t}){let[e,n,i]=await Promise.allSettled([Xo({startMs:r,endMs:t}),Qo({startMs:r,endMs:t}),ea({startMs:r,endMs:t})]),s=d=>d.status==="fulfilled"?d.value:{ok:!1,error:d.reason?.message||String(d.reason),items:[]},o=s(e),a=s(n),c=s(i),l=[{provider:"openai",totalUsd:o.items.reduce((d,p)=>d+(p.costUsd||0),0)},{provider:"anthropic",totalUsd:a.items.reduce((d,p)=>d+(p.costUsd||0),0)},{provider:"cursor",totalUsd:c.items.reduce((d,p)=>d+(p.costUsd||0),0)}];return{openai:o,anthropic:a,cursor:c,totals:l}}function ey(r,t){let e=new Map;for(let n of r){let i=t(n);if(!i)continue;let s=e.get(i)||{key:i,totalUsd:0,count:0};s.totalUsd+=n.costUsd||0,s.count+=1,e.set(i,s)}return[...e.values()].sort((n,i)=>i.totalUsd-n.totalUsd)}function ty(r){if(!r.length)return{mean:0,stddev:0};let t=r.reduce((n,i)=>n+i,0)/r.length,e=r.reduce((n,i)=>n+(i-t)**2,0)/r.length;return{mean:t,stddev:Math.sqrt(e)}}import{SKILL_IDS as Rk}from"@zibby/skill-ids";import{z as k}from"zod";var vt=["ok","info","warn","critical"],ry=k.object({primary:k.string().min(1).max(200).describe('Headline number or phrase (e.g. "$8,240"). Rendered in large/bold.'),delta:k.object({value:k.string().max(40).describe('Delta vs baseline (e.g. "+12% wow"). Free-form string.'),direction:k.enum(["up","down","flat"]).optional(),severity:k.enum(vt).optional().describe("Color severity for the delta (warn/critical highlights regressions).")}).optional().describe("Optional comparison vs baseline. Renders inline next to primary."),summary:k.string().max(800).optional().describe('One-sentence narrative ("why this number"). Plain prose.')}),ny=k.object({kind:k.literal("trend"),title:k.string().max(120).optional(),labels:k.array(k.string().max(60)).min(2).max(20).describe('Bucket labels (e.g. ["Week-3", "Week-2", "Week-1", "This wk"]).'),values:k.array(k.number()).min(2).max(20).describe("Numeric values, one per label. Must match labels.length."),highlight:k.enum(["last","max","min","none"]).default("last").optional().describe("Which bucket to visually highlight in the rendered card."),severity:k.enum(vt).optional()}),iy=k.object({kind:k.literal("table"),title:k.string().max(120).optional(),headers:k.array(k.string().max(40)).min(1).max(8),rows:k.array(k.array(k.union([k.string().max(200),k.number()])).min(1).max(8)).max(40).describe("2D matrix. Each inner array must have headers.length entries.")}),sy=k.object({kind:k.literal("callouts"),title:k.string().max(120).optional(),tone:k.enum(vt).default("info").optional(),items:k.array(k.string().min(1).max(600)).min(1).max(10).describe("Each item renders as a bullet with a severity emoji.")}),oy=k.object({kind:k.literal("breakdown"),title:k.string().max(120).optional(),rows:k.array(k.object({label:k.string().min(1).max(80),value:k.string().min(1).max(80),sub:k.string().max(120).optional(),severity:k.enum(vt).optional()})).min(1).max(20)}),ay=k.object({kind:k.literal("paragraph"),title:k.string().max(120).optional(),text:k.string().min(1).max(3e3)}),cy=k.discriminatedUnion("kind",[ny,iy,sy,oy,ay]),It=k.object({title:k.string().min(1).max(200).describe('Card title (e.g. "Weekly AI Spend Report").'),subtitle:k.string().max(200).optional().describe('Date range or smaller header (e.g. "May 13 \u2014 May 20").'),headline:ry,sections:k.array(cy).max(20).default([]).superRefine((r,t)=>{r.forEach((e,n)=>{e.kind==="trend"&&e.labels.length!==e.values.length&&t.addIssue({code:k.ZodIssueCode.custom,path:[n,"values"],message:"labels.length must equal values.length"}),e.kind==="table"&&!e.rows.every(i=>i.length===e.headers.length)&&t.addIssue({code:k.ZodIssueCode.custom,path:[n,"rows"],message:"every row must have headers.length entries"})})}),footer:k.object({viewUrl:k.string().url().optional().describe('Optional "View in Zibby" button URL.'),rerunUrl:k.string().url().optional().describe('Optional "Run again" button URL.')}).optional()}),B=Object.freeze({ok:"\u{1F7E2}",info:"\u{1F535}",warn:"\u{1F7E0}",critical:"\u{1F534}"}),mr=Object.freeze({up:"\u2191",down:"\u2193",flat:"\u2192"}),ly=Object.freeze({ok:"green",info:"blue",warn:"orange",critical:"red"});function fr(r,t,e=12){if(!Number.isFinite(r)||!Number.isFinite(t)||t<=0)return"";let n=Math.max(0,Math.min(1,r/t)),i=Math.round(n*e);return"\u2593".repeat(i)+"\u2591".repeat(e-i)}function Nt(r,t){let e=String(r);return e.length>=t?e:e+" ".repeat(t-e.length)}function hr(r,t){let e=String(r);return e.length>=t?e:" ".repeat(t-e.length)+e}function na({headers:r,rows:t}){let e=r.map((o,a)=>{let c=Math.max(String(o).length,...t.map(l=>String(l[a]??"").length));return Math.min(c,32)}),n=o=>o.map((a,c)=>Nt(a,e[c])).join(" "),i=e.map(o=>"\u2500".repeat(o)).join(" ");return"```\n"+[n(r),i,...t.map(o=>n(o))].join(`
1242
1246
  `)+"\n```"}function dy(r){let t=It.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 n=[`*${t.headline.primary}*`];if(t.headline.delta){let s=mr[t.headline.delta.direction]||"",o=t.headline.delta.severity?B[t.headline.delta.severity]:"";n.push(`${s} ${t.headline.delta.value} ${o}`.trim())}let i=n.join(" ");t.headline.summary&&(i+=`
1243
1247
  `+t.headline.summary),e.push({type:"section",text:{type:"mrkdwn",text:i}});for(let s of t.sections)switch(e.push({type:"divider"}),s.title&&e.push({type:"section",text:{type:"mrkdwn",text:`*${s.title}*`}}),s.kind){case"trend":{let o=Math.max(...s.values),a=s.labels.map((c,l)=>{let d=s.values[l],p=fr(d,o),m=(s.highlight==="last"&&l===s.labels.length-1||s.highlight==="max"&&d===o||s.highlight==="min"&&d===Math.min(...s.values))&&s.severity?` ${B[s.severity]}`:"";return`${Nt(c,10)} ${hr(d.toLocaleString(),8)} ${p}${m}`});e.push({type:"section",text:{type:"mrkdwn",text:"```\n"+a.join(`
1244
1248
  `)+"\n```"}});break}case"table":{e.push({type:"section",text:{type:"mrkdwn",text:na(s)}});break}case"callouts":{let o=B[s.tone||"info"];e.push({type:"section",text:{type:"mrkdwn",text:s.items.map(a=>`${o} ${a}`).join(`
@@ -1250,4 +1254,4 @@ _${a.sub}_`:""}${a.severity?` ${B[a.severity]}`:""}`}));for(let a=0;a<o.length;a
1250
1254
  `)}});break}case"breakdown":{let a=o.rows.map(c=>{let l=c.severity?` ${B[c.severity]}`:"",d=c.sub?` *${c.sub}*`:"";return`**${c.label}** ${c.value}${d}${l}`});e.push({tag:"div",text:{tag:"lark_md",content:a.join(`
1251
1255
  `)}});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 s="blue";return t.headline.delta?.severity&&(s=ly[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:s},elements:e}}var uy=Object.freeze({ok:"green_background",info:"blue_background",warn:"orange_background",critical:"red_background"}),ta=Object.freeze({ok:"\u{1F7E2}",info:"\u2139\uFE0F",warn:"\u26A0\uFE0F",critical:"\u{1F6A8}"});function Ce(r,t={}){let e={type:"text",text:{content:String(r).slice(0,2e3)}};return t.annotations&&(e.annotations=t.annotations),[e]}function _n(r,t){let e={object:"block",type:"paragraph",paragraph:{rich_text:Ce(r)}};return t&&(e.paragraph.color=t),e}function my(r){return{object:"block",type:"code",code:{rich_text:Ce(r),language:"plain text"}}}function fy(r){let t=It.parse(r),e=[];e.push({object:"block",type:"heading_1",heading_1:{rich_text:Ce(t.title.slice(0,200))}}),t.subtitle&&e.push(_n(t.subtitle,"gray_background"));let n=[{type:"text",text:{content:t.headline.primary.slice(0,200)},annotations:{bold:!0}}];if(t.headline.delta){let s=mr[t.headline.delta.direction]||"",o=t.headline.delta.severity?B[t.headline.delta.severity]:"",a=` ${s} ${t.headline.delta.value} ${o}`.trimEnd();n.push({type:"text",text:{content:a}})}e.push({object:"block",type:"paragraph",paragraph:{rich_text:n}}),t.headline.summary&&e.push(_n(t.headline.summary));for(let s of t.sections)switch(e.push({object:"block",type:"divider",divider:{}}),s.title&&e.push({object:"block",type:"heading_2",heading_2:{rich_text:Ce(s.title)}}),s.kind){case"trend":{let o=Math.max(...s.values),a=Math.min(...s.values),c=s.labels.map((l,d)=>{let p=s.values[d],u=fr(p,o),f=(s.highlight==="last"&&d===s.labels.length-1||s.highlight==="max"&&p===o||s.highlight==="min"&&p===a)&&s.severity?` ${B[s.severity]}`:"";return`${Nt(l,10)} ${hr(p.toLocaleString(),8)} ${u}${f}`});e.push(my(c.join(`
1252
1256
  `)));break}case"table":{let o={object:"block",type:"table_row",table_row:{cells:s.headers.map(c=>Ce(c))}},a=s.rows.map(c=>({object:"block",type:"table_row",table_row:{cells:c.map(l=>Ce(String(l)))}}));e.push({object:"block",type:"table",table:{table_width:s.headers.length,has_column_header:!0,has_row_header:!1,children:[o,...a]}});break}case"callouts":{let o=s.tone||"info",a=ta[o],c=uy[o];for(let l of s.items)e.push({object:"block",type:"callout",callout:{rich_text:Ce(l),icon:{type:"emoji",emoji:a},color:c}});break}case"breakdown":{for(let o of s.rows){let a=[{type:"text",text:{content:`${o.label}: `},annotations:{bold:!0}},{type:"text",text:{content:String(o.value)}}];o.sub&&a.push({type:"text",text:{content:` (${o.sub})`},annotations:{italic:!0}}),o.severity&&a.push({type:"text",text:{content:` ${B[o.severity]}`}}),e.push({object:"block",type:"bulleted_list_item",bulleted_list_item:{rich_text:a}})}break}case"paragraph":{e.push(_n(s.text));break}}t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)&&(e.push({object:"block",type:"divider",divider:{}}),t.footer.viewUrl&&e.push({object:"block",type:"embed",embed:{url:t.footer.viewUrl}}),t.footer.rerunUrl&&e.push({object:"block",type:"embed",embed:{url:t.footer.rerunUrl}}));let i=t.headline.delta?.severity?ta[t.headline.delta.severity]:void 0;return{blocks:e,title:t.title.slice(0,200),icon:i}}function ra(r){return String(r??"").replace(/\|/g,"\\|")}function hy(r){let t=It.parse(r),e=[];e.push(`# ${t.title}`),t.subtitle&&e.push("",t.subtitle);let n=[`**${t.headline.primary}**`];if(t.headline.delta){let i=mr[t.headline.delta.direction]||"",s=t.headline.delta.severity?B[t.headline.delta.severity]:"";n.push(`${i} ${t.headline.delta.value} ${s}`.trim())}e.push("",n.join(" ")),t.headline.summary&&e.push("",t.headline.summary);for(let i of t.sections)switch(e.push("","---",""),i.title&&e.push(`## ${i.title}`,""),i.kind){case"trend":{let s=Math.max(...i.values),o=Math.min(...i.values),a=i.labels.map((c,l)=>{let d=i.values[l],p=fr(d,s),m=(i.highlight==="last"&&l===i.labels.length-1||i.highlight==="max"&&d===s||i.highlight==="min"&&d===o)&&i.severity?` ${B[i.severity]}`:"";return`${Nt(c,10)} ${hr(d.toLocaleString(),8)} ${p}${m}`});e.push("```",...a,"```");break}case"table":{e.push(`| ${i.headers.map(ra).join(" | ")} |`),e.push(`| ${i.headers.map(()=>"---").join(" | ")} |`);for(let s of i.rows)e.push(`| ${s.map(ra).join(" | ")} |`);break}case"callouts":{let s=B[i.tone||"info"];for(let o of i.items)e.push(`- ${s} ${o}`);break}case"breakdown":{for(let s of i.rows){let o=s.sub?` _${s.sub}_`:"",a=s.severity?` ${B[s.severity]}`:"";e.push(`- **${s.label}**: ${s.value}${o}${a}`)}break}case"paragraph":{e.push(i.text);break}}if(t.footer&&(t.footer.viewUrl||t.footer.rerunUrl)){let i=[];t.footer.viewUrl&&i.push(`[View in Zibby](${t.footer.viewUrl})`),t.footer.rerunUrl&&i.push(`[Run again](${t.footer.rerunUrl})`),e.push("","---","",i.join(" \xB7 "))}return e.join(`
1253
- `)}import{createRequire as yy}from"module";import{fileURLToPath as gy}from"url";import{registerHandlers as by}from"@zibby/core/function-skill-registry.js";import{registerSkill as _y}from"@zibby/agent-workflow";var ky=yy(import.meta.url);function wy(){try{return ky.resolve("@zibby/core/function-bridge.js")}catch{return null}}var Sy=import.meta.url;function vy(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(n,i)=>i;let e=new Error().stack;for(let n=2;n<e.length;n++){let i=e[n].getFileName();if(i&&i!==Sy&&!i.startsWith("node:"))return i.startsWith("file://")?gy(i):i}return null}finally{Error.prepareStackTrace=r}}function Iy(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[n,i]of Object.entries(r))if(typeof i=="string")t[n]={type:i},e.push(n);else{let{required:s,...o}=i;t[n]=o,s!==!1&&e.push(n)}return{type:"object",properties:t,required:e}}function Ny(r,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n={[r]:e.handler},i=[{name:r,description:e.description||"",input_schema:Iy(e.input)}];return by(r,n,i),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:e.description||`Function skill: ${r}`,envKeys:[],tools:i,resolve(){let s=wy();return s?{command:"node",args:[s,t,r]}:null}}}function Oy(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 ia(r,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n=vy();if(!n)throw new Error(`Could not resolve caller file for skill "${r}".`);e=Ny(r,n,t)}else if(typeof t.resolve=="function")e=Oy(r,t);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return _y(e),e}var Ty=ia;import{registerSkill as $w,getSkill as Pw,hasSkill as Cw,getAllSkills as Uw,listSkillIds as Bw}from"@zibby/agent-workflow";var v=r=>Ry(vn(r));v(In);v(Tn);v(Je);v(De);v(qn);v(Fn);v(Gn);v(Zn);v(Vn);v(ei);v(P);v(F);v(ni);v(pi);v(hi);v(ki);v(Ri);v(Ai);v(Gt);v(xi);v(ts);v(_e);v(os);v(Li);v(Bi);v(ks);v(Ts);v(Ls);v(Qs);v(po);v(Ds);v(uo);v(mo);v(vo);v(xo);v(jo);v(Co);v(Bo);v(Wo);v(yn);v(gn);v(bn);v({...P,id:"slack_notify"});export{I as INTEGRATIONS,ya as INTEGRATION_REGISTRY,Q as REPORT_CODES,vt as REPORT_SEVERITIES,Rw as SKILLS,gn as anthropicBillingSkill,Qs as artifactSkill,In as browserSkill,po as chartRenderSkill,ks as chatMemorySkill,Ai as chatNotifySkill,mo as chatProgressSkill,ir as checkRenderedReport,xo as codeScanSkill,uo as codeStatsSkill,Co as codebaseMemorySkill,Bi as coreToolsSkill,bn as cursorAdminSkill,Ls as datasetStoreSkill,ni as discordSkill,Qh as fetchAllProviders,Qo as fetchAnthropicCosts,Xh as fetchAnthropicWorkspaces,ea as fetchCursorSpend,Xo as fetchOpenAICosts,Vh as fetchOpenAIProjects,qn as figmaSkill,Ty as functionSkill,Bo as gbrainSkill,Uw as getAllSkills,Pw as getSkill,_e as gitSkill,os as gitWriteSkill,Je as githubSkill,De as gitlabSkill,ki as googleDocsSkill,ey as groupByKey,Cw as hasSkill,Fn as hubspotSkill,Tn as jiraSkill,Ts as kvMemorySkill,Ri as larkDocsSkill,F as larkSkill,Gn as linearSkill,hi as linkedinSkill,Bw as listSkillIds,ty as meanStddev,xi as memorySkill,pi as notionSkill,yn as openaiBillingSkill,ei as opendesignSkill,Vn as planeSkill,$w as registerSkill,Ds as reportCheckSkill,It as reportObjectSchema,dy as reportToBlockKit,py as reportToLarkCard,hy as reportToMarkdown,fy as reportToNotionBlocks,ts as runnerSkill,Gt as sentrySkill,ia as skill,Li as skillInstallerSkill,P as slackSkill,vo as socialCardSkill,ts as testRunnerSkill,Zn as vikunjaSkill,Wo as workflowBuilderSkill};
1257
+ `)}import{createRequire as yy}from"module";import{fileURLToPath as gy}from"url";import{registerHandlers as by}from"@zibby/core/function-skill-registry.js";import{registerSkill as _y}from"@zibby/agent-workflow";var wy=yy(import.meta.url);function ky(){try{return wy.resolve("@zibby/core/function-bridge.js")}catch{return null}}var Sy=import.meta.url;function vy(){let r=Error.prepareStackTrace;try{Error.prepareStackTrace=(n,i)=>i;let e=new Error().stack;for(let n=2;n<e.length;n++){let i=e[n].getFileName();if(i&&i!==Sy&&!i.startsWith("node:"))return i.startsWith("file://")?gy(i):i}return null}finally{Error.prepareStackTrace=r}}function Iy(r){if(!r||typeof r!="object")return{type:"object",properties:{},required:[]};let t={},e=[];for(let[n,i]of Object.entries(r))if(typeof i=="string")t[n]={type:i},e.push(n);else{let{required:s,...o}=i;t[n]=o,s!==!1&&e.push(n)}return{type:"object",properties:t,required:e}}function Ny(r,t,e){if(typeof e.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n={[r]:e.handler},i=[{name:r,description:e.description||"",input_schema:Iy(e.input)}];return by(r,n,i),{id:r,type:"function",serverName:r,allowedTools:[`mcp__${r}__*`],description:e.description||`Function skill: ${r}`,envKeys:[],tools:i,resolve(){let s=ky();return s?{command:"node",args:[s,t,r]}:null}}}function Oy(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 ia(r,t){let e;if("handler"in t){if(typeof t.handler!="function")throw new Error(`Skill "${r}" must have a handler function`);let n=vy();if(!n)throw new Error(`Could not resolve caller file for skill "${r}".`);e=Ny(r,n,t)}else if(typeof t.resolve=="function")e=Oy(r,t);else throw new Error(`Skill "${r}" must have either a handler (function skill) or resolve (MCP skill).`);return _y(e),e}var Ty=ia;import{registerSkill as $k,getSkill as Pk,hasSkill as Ck,getAllSkills as Uk,listSkillIds as Bk}from"@zibby/agent-workflow";var v=r=>Ry(vn(r));v(In);v(Tn);v(Je);v(De);v(qn);v(Fn);v(Gn);v(Zn);v(Vn);v(ei);v(P);v(F);v(ni);v(pi);v(hi);v(wi);v(Ri);v(Ai);v(Gt);v(xi);v(ts);v(_e);v(os);v(Li);v(Bi);v(ws);v(Ts);v(Ls);v(Qs);v(po);v(Ds);v(uo);v(mo);v(vo);v(xo);v(jo);v(Co);v(Bo);v(Wo);v(yn);v(gn);v(bn);v({...P,id:"slack_notify"});export{I as INTEGRATIONS,ya as INTEGRATION_REGISTRY,Q as REPORT_CODES,vt as REPORT_SEVERITIES,Rk as SKILLS,gn as anthropicBillingSkill,Qs as artifactSkill,In as browserSkill,po as chartRenderSkill,ws as chatMemorySkill,Ai as chatNotifySkill,mo as chatProgressSkill,ir as checkRenderedReport,xo as codeScanSkill,uo as codeStatsSkill,Co as codebaseMemorySkill,Bi as coreToolsSkill,bn as cursorAdminSkill,Ls as datasetStoreSkill,ni as discordSkill,Qh as fetchAllProviders,Qo as fetchAnthropicCosts,Xh as fetchAnthropicWorkspaces,ea as fetchCursorSpend,Xo as fetchOpenAICosts,Vh as fetchOpenAIProjects,qn as figmaSkill,Ty as functionSkill,Bo as gbrainSkill,Uk as getAllSkills,Pk as getSkill,_e as gitSkill,os as gitWriteSkill,Je as githubSkill,De as gitlabSkill,wi as googleDocsSkill,ey as groupByKey,Ck as hasSkill,Fn as hubspotSkill,Tn as jiraSkill,Ts as kvMemorySkill,Ri as larkDocsSkill,F as larkSkill,Gn as linearSkill,hi as linkedinSkill,Bk as listSkillIds,ty as meanStddev,xi as memorySkill,pi as notionSkill,yn as openaiBillingSkill,ei as opendesignSkill,Vn as planeSkill,$k as registerSkill,Ds as reportCheckSkill,It as reportObjectSchema,dy as reportToBlockKit,py as reportToLarkCard,hy as reportToMarkdown,fy as reportToNotionBlocks,ts as runnerSkill,Gt as sentrySkill,ia as skill,Li as skillInstallerSkill,P as slackSkill,vo as socialCardSkill,ts as testRunnerSkill,Zn as vikunjaSkill,Wo as workflowBuilderSkill};