@zibby/core 0.1.27 → 0.1.30

package/dist/constants.js

@@ -1 +1 @@
-const o={ASSISTANT:"gpt-5.4-nano-2026-03-17",CLAUDE:"claude-sonnet-4-6",CURSOR:"auto",CODEX:"o4-mini",GEMINI:"gemini-2.5-pro",OPENAI_POSTPROCESSING:"gpt-4o-mini"},n={ASSISTANT:"assistant",CLAUDE:"claude",CURSOR:"cursor",CODEX:"codex",GEMINI:"gemini"},e={DEBUG:"debug",INFO:"info",WARN:"warn",ERROR:"error",SILENT:"silent"},t={auto:"claude-sonnet-4-6","sonnet-4.6":"claude-sonnet-4-6","sonnet-4-6":"claude-sonnet-4-6","opus-4.6":"claude-opus-4-6","opus-4-6":"claude-opus-4-6","sonnet-4.5":"claude-sonnet-4-5-20250929","sonnet-4-5":"claude-sonnet-4-5-20250929","opus-4.5":"claude-opus-4-20250514","opus-4-5":"claude-opus-4-20250514","claude-sonnet-4-6":"claude-sonnet-4-6","claude-opus-4-6":"claude-opus-4-6","claude-sonnet-4-5-20250929":"claude-sonnet-4-5-20250929","claude-opus-4-20250514":"claude-opus-4-20250514"},s={auto:"o4-mini","o4-mini":"o4-mini",o3:"o3","o3-mini":"o3-mini","codex-mini":"codex-mini-latest","gpt-4o":"gpt-4o","gpt-4o-mini":"gpt-4o-mini","gpt-5.2-codex":"gpt-5.2-codex","gpt-5.2":"gpt-5.2","gpt-5.3":"gpt-5.3","gpt-5.4":"gpt-5.4"},i={auto:"gemini-2.5-pro","gemini-2.5-pro":"gemini-2.5-pro","gemini-2.5-flash":"gemini-2.5-flash"},p={CURSOR_AGENT_DEFAULT:1200*1e3,OPENAI_REQUEST:3e4};export{n as AGENT_TYPES,t as CLAUDE_MODEL_MAP,s as CODEX_MODEL_MAP,o as DEFAULT_MODELS,i as GEMINI_MODEL_MAP,e as LOG_LEVELS,p as TIMEOUTS};
+const o={ASSISTANT:"gpt-5.4-nano-2026-03-17",CLAUDE:"claude-sonnet-4-6",CURSOR:"auto",CODEX:"o4-mini",GEMINI:"gemini-2.5-pro",OPENAI_POSTPROCESSING:"gpt-4o-mini"},n={ASSISTANT:"assistant",CLAUDE:"claude",CURSOR:"cursor",CODEX:"codex",GEMINI:"gemini"},e={DEBUG:"debug",INFO:"info",WARN:"warn",ERROR:"error",SILENT:"silent"},t={auto:"claude-sonnet-4-6","sonnet-4.6":"claude-sonnet-4-6","sonnet-4-6":"claude-sonnet-4-6","opus-4.6":"claude-opus-4-6","opus-4-6":"claude-opus-4-6","sonnet-4.5":"claude-sonnet-4-5-20250929","sonnet-4-5":"claude-sonnet-4-5-20250929","opus-4.5":"claude-opus-4-20250514","opus-4-5":"claude-opus-4-20250514","claude-sonnet-4-6":"claude-sonnet-4-6","claude-opus-4-6":"claude-opus-4-6","claude-sonnet-4-5-20250929":"claude-sonnet-4-5-20250929","claude-opus-4-20250514":"claude-opus-4-20250514"},s={auto:"o4-mini","o4-mini":"o4-mini",o3:"o3","o3-mini":"o3-mini","codex-mini":"codex-mini-latest","gpt-4o":"gpt-4o","gpt-4o-mini":"gpt-4o-mini","gpt-5.2-codex":"gpt-5.2-codex","gpt-5.2":"gpt-5.2","gpt-5.3":"gpt-5.3","gpt-5.4":"gpt-5.4"},i={auto:"gemini-2.5-pro","gemini-2.5-pro":"gemini-2.5-pro","gemini-2.5-flash":"gemini-2.5-flash"},p={CURSOR_AGENT_DEFAULT:1200*1e3,OPENAI_REQUEST:18e4};export{n as AGENT_TYPES,t as CLAUDE_MODEL_MAP,s as CODEX_MODEL_MAP,o as DEFAULT_MODELS,i as GEMINI_MODEL_MAP,e as LOG_LEVELS,p as TIMEOUTS};

package/dist/framework/agents/cursor-strategy.js

@@ -1,4 +1,4 @@
-import{AgentStrategy as Y}from"./base.js";import{spawn as q,execSync as N}from"child_process";import{writeFileSync as j,readFileSync as J,mkdirSync as z,existsSync as H,accessSync as B,constants as W,unlinkSync as V}from"fs";import{join as C,resolve as X}from"path";import{homedir as D}from"os";import{logger as t}from"../../utils/logger.js";import{DEFAULT_MODELS as Q,TIMEOUTS as ee}from"../../constants.js";import{DEFAULT_OUTPUT_BASE as te,SESSION_INFO_FILE as re,STUDIO_STOP_REQUEST_FILE as oe}from"../constants.js";import{getAllSkills as ne,getSkill as Z}from"../skill-registry.js";import{StreamingParser as se}from"../../utils/streaming-parser.js";import{StructuredOutputFormatter as ie}from"./utils/structured-output-formatter.js";import{formatWithOpenAIProxy as le}from"./utils/openai-proxy-formatter.js";import{timeline as G}from"../../utils/timeline.js";import{shouldUseIsolatedCursorMcpHome as ae,createIsolatedCursorAgentHome as ue,removeIsolatedCursorAgentHome as ce}from"../../utils/cursor-mcp-isolated-home.js";class Ee extends Y{constructor(){super("cursor","Cursor (CLI)",100)}canHandle(s){const l=[C(D(),".local","bin","cursor-agent"),C(D(),".cursor","bin","cursor-agent"),"/usr/local/bin/cursor-agent","/usr/local/bin/agent","/Applications/Cursor.app/Contents/Resources/app/bin/cursor","agent","cursor-agent"];for(const r of l)try{if(r.startsWith("/")){B(r,W.X_OK);const f=N(`"${r}" --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});if(f&&f.length>0)return t.debug(`[Cursor] Found agent at: ${r} (version: ${f.trim().slice(0,50)})`),!0}else{const f=N(`which ${r}`,{encoding:"utf-8",timeout:2e3,stdio:"pipe"}).trim();if(!f)continue;const a=N(`${r} --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});if(a&&a.length>0)return t.debug(`[Cursor] Found '${r}' in PATH at ${f} (version: ${a.trim().slice(0,50)})`),!0}}catch{continue}return t.warn("[Cursor] \u274C Cursor Agent CLI not found or not working. Run: agent --version"),!1}async invoke(s,l={}){const{workspace:r=process.cwd(),print:f=!1,schema:a=null,skills:b=null,sessionPath:u=null,nodeName:g=null,timeout:m=ee.CURSOR_AGENT_DEFAULT,config:h={}}=l,$=h?.agent?.strictMode||!1,v=l.model??h?.agent?.cursor?.model??Q.CURSOR;t.debug(`[Cursor] Invoking (model: ${v}, timeout: ${m/1e3}s, skills: ${JSON.stringify(b)})`);const E=(this._setupMcpConfig(u,r,h,b,g)||{}).isolatedMcpHome??null,S=[C(D(),".local","bin","cursor-agent"),C(D(),".cursor","bin","cursor-agent"),"/usr/local/bin/cursor-agent","/usr/local/bin/agent","/Applications/Cursor.app/Contents/Resources/app/bin/cursor","agent","cursor-agent"];let n=null;for(const c of S)try{if(c.startsWith("/"))B(c,W.X_OK),N(`"${c}" --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});else{if(!N(`which ${c}`,{encoding:"utf-8",timeout:2e3}).trim())throw new Error("not in PATH");N(`${c} --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"})}n=c,t.debug(`[Agent] Using binary: ${c}`);break}catch(w){t.debug(`[Agent] Binary '${c}' check failed: ${w.message}`);continue}if(!n)throw new Error(`Cursor Agent CLI not found or not working.
+import{AgentStrategy as Y}from"./base.js";import{spawn as q,execSync as N}from"child_process";import{writeFileSync as j,readFileSync as J,mkdirSync as z,existsSync as H,accessSync as B,constants as W,unlinkSync as V}from"fs";import{join as C,resolve as X}from"path";import{homedir as D}from"os";import{logger as t}from"../../utils/logger.js";import{DEFAULT_MODELS as Q,TIMEOUTS as ee}from"../../constants.js";import{DEFAULT_OUTPUT_BASE as te,SESSION_INFO_FILE as re,STUDIO_STOP_REQUEST_FILE as oe}from"../constants.js";import{getAllSkills as ne,getSkill as Z}from"../skill-registry.js";import{StreamingParser as se}from"../../utils/streaming-parser.js";import{StructuredOutputFormatter as ie}from"./utils/structured-output-formatter.js";import{formatWithOpenAIProxy as le}from"./utils/openai-proxy-formatter.js";import{timeline as G}from"../../utils/timeline.js";import{shouldUseIsolatedCursorMcpHome as ae,createIsolatedCursorAgentHome as ue,removeIsolatedCursorAgentHome as ce}from"../../utils/cursor-mcp-isolated-home.js";class Ee extends Y{constructor(){super("cursor","Cursor (CLI)",100)}canHandle(i){const l=[C(D(),".local","bin","cursor-agent"),C(D(),".cursor","bin","cursor-agent"),"/usr/local/bin/cursor-agent","/usr/local/bin/agent","/Applications/Cursor.app/Contents/Resources/app/bin/cursor","agent","cursor-agent"];for(const r of l)try{if(r.startsWith("/")){B(r,W.X_OK);const f=N(`"${r}" --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});if(f&&f.length>0)return t.debug(`[Cursor] Found agent at: ${r} (version: ${f.trim().slice(0,50)})`),!0}else{const f=N(`which ${r}`,{encoding:"utf-8",timeout:2e3,stdio:"pipe"}).trim();if(!f)continue;const a=N(`${r} --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});if(a&&a.length>0)return t.debug(`[Cursor] Found '${r}' in PATH at ${f} (version: ${a.trim().slice(0,50)})`),!0}}catch{continue}return t.warn("[Cursor] \u274C Cursor Agent CLI not found or not working. Run: agent --version"),!1}async invoke(i,l={}){const{workspace:r=process.cwd(),print:f=!1,schema:a=null,skills:b=null,sessionPath:u=null,nodeName:g=null,timeout:m=ee.CURSOR_AGENT_DEFAULT,config:h={}}=l,$=h?.agent?.strictMode||!1,v=l.model??h?.agent?.cursor?.model??Q.CURSOR;t.debug(`[Cursor] Invoking (model: ${v}, timeout: ${m/1e3}s, skills: ${JSON.stringify(b)})`);const E=(this._setupMcpConfig(u,r,h,b,g)||{}).isolatedMcpHome??null,S=[C(D(),".local","bin","cursor-agent"),C(D(),".cursor","bin","cursor-agent"),"/usr/local/bin/cursor-agent","/usr/local/bin/agent","/Applications/Cursor.app/Contents/Resources/app/bin/cursor","agent","cursor-agent"];let n=null;for(const c of S)try{if(c.startsWith("/"))B(c,W.X_OK),N(`"${c}" --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"});else{if(!N(`which ${c}`,{encoding:"utf-8",timeout:2e3}).trim())throw new Error("not in PATH");N(`${c} --version 2>&1`,{encoding:"utf-8",timeout:3e3,stdio:"pipe"})}n=c,t.debug(`[Agent] Using binary: ${c}`);break}catch(y){t.debug(`[Agent] Binary '${c}' check failed: ${y.message}`);continue}if(!n)throw new Error(`Cursor Agent CLI not found or not working.
 
 Checked paths:
 ${S.map(c=>`  - ${c}`).join(`
@@ -10,23 +10,23 @@ Install cursor-agent:
 Then add to PATH:
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
 
-Test with: agent --version`);let y=null;if(a){const c=`zibby-result-${Date.now()}.json`;y=C(r,".zibby","tmp",c);const w=C(r,".zibby","tmp");H(w)||z(w,{recursive:!0});const T=ie.generateFileOutputInstructions(a,y);s=`${s}
+Test with: agent --version`);let w=null;if(a){const c=`zibby-result-${Date.now()}.json`;w=C(r,".zibby","tmp",c);const y=C(r,".zibby","tmp");H(y)||z(y,{recursive:!0});const T=ie.generateFileOutputInstructions(a,w);i=`${i}
 
 ${T}`}const P=process.env.CURSOR_API_KEY,x=P?` | key: ***${P.slice(-4)}`:" | key: not set";console.log(`
 \u25C6 Model: ${v||"auto"}${x}
 `);const M=(await import("chalk")).default;console.log(`
-${M.bold("Prompt sent to LLM:")}`),console.log(M.dim("\u2500".repeat(60))),console.log(M.dim(s)),console.log(M.dim("\u2500".repeat(60)));const L=["--print","--force","--approve-mcps","--output-format","stream-json","--stream-partial-output","--model",v||"auto"];if(process.env.CURSOR_API_KEY&&L.push("--api-key",process.env.CURSOR_API_KEY),L.push(s),t.debug(`[Agent] Prompt: ${s.length} chars, model: ${v||"auto"}`),t.debug(`[Agent] Workspace: ${r}`),process.env.LOG_LEVEL==="debug"||process.env.ZIBBY_LOG_CURSOR_CLI==="1")try{console.log(`\u{1F527} Cursor CLI --model ${v||"auto"} (from .zibby.config.js agent.cursor.model)
-`)}catch{}let _,o=null;try{const c=u||(process.env.ZIBBY_SESSION_PATH?String(process.env.ZIBBY_SESSION_PATH).trim():null);_=await this._spawnWithStreaming(n,L,r,m,null,c,E)}catch(c){o=c}const A=_?.stdout||"";if(a){const c=typeof a.parse=="function";let w=null;const T=!!(y&&H(y));if(y&&t.info(`[Agent] Result file: ${T?"present":"missing"} at ${y}`),T)try{const e=J(y,"utf-8").trim();w=JSON.parse(e),t.info(`[Agent] Parsed JSON from result file OK (${e.length} chars) \u2192 object ready for validation`),o&&t.debug("[Agent] Agent exited non-zero but result file was written \u2014 recovering")}catch(e){t.warn(`\u26A0\uFE0F  [Agent] Result file exists on disk but is not valid JSON: ${e.message}`)}else if(o)t.warn(`[Agent] Result file missing at ${y} (agent process error \u2014 may still recover if strictMode repairs)`);else throw t.error(`\u274C [Agent] Result file was never created at ${y}`),new Error(`Agent did not write required result file at ${y}`);if(w&&c)try{const e=a.parse(w);return t.info("\u2705 [Agent] Zod validation passed for structured result file"),$&&t.debug("[Agent] strictMode enabled but not needed \u2014 agent wrote valid file"),{raw:A,structured:e}}catch(e){t.warn(`\u26A0\uFE0F  [Agent] JSON parsed but Zod rejected it (wrong types/shape): ${e.message?.slice(0,400)}`)}else{if(w)return t.info("\u2705 [Agent] File-based output extracted (no Zod parse fn) \u2014 accepting as structured"),$&&t.debug("[Agent] strictMode enabled but not needed \u2014 agent wrote valid file"),{raw:A,structured:w};T&&t.error("\u274C [Agent] Result file exists but produced no in-memory JSON (parse failed earlier)")}if($&&!o){const e=_.parsedText,d=w?JSON.stringify(w):e;t.info(`[Agent] strictMode: calling OpenAI proxy to fix structured output (${d.length} chars in)`);const i=await le(d,a);if(c){const p=a.parse(i.structured);return t.info("\u2705 [Agent] Proxy output passed Zod validation"),{raw:A,structured:p}}return{raw:A,...i}}if(o)throw o;const k=T?w==null?"file existed but JSON.parse failed \u2014 see WARN log above":c?"JSON was valid but Zod validation failed \u2014 see WARN log above":"no structured object after read (unexpected)":"file never appeared (agent may not have run Write tool to the path above)";throw t.error(`\u274C [Agent] No validated structured output: ${k}`),t.error("\u{1F4A1} Tip: Set strictMode=true in .zibby.config.js for OpenAI proxy fallback"),new Error(`Agent did not produce a valid result file at ${y}. Enable strictMode for proxy fallback.`)}if(o)throw o;return this._extractFinalResult(A)||_?.parsedText||A}_extractFinalResult(s){if(!s)return null;const l=s.split(`
-`);let r=null;for(const f of l){const a=f.trim();if(a)try{const b=JSON.parse(a);if(b.type==="assistant"&&b.message?.content){const u=b.message.content;if(Array.isArray(u)){const g=u.filter(m=>m.type==="text"&&m.text).map(m=>m.text).join("");g&&(r=g)}else typeof u=="string"&&u&&(r=u)}}catch{}}return r?.trim()||null}_setupMcpConfig(s,l,r,f=null,a=null){const b=r?.headless,u=C(D(),".cursor"),g=C(u,"mcp.json");let m={};if(H(g))try{m=JSON.parse(J(g,"utf-8"))}catch{}const h=m.mcpServers||{},$=r?.paths?.output||te,v=C(l||process.cwd(),$,re),I=Array.isArray(f)?f.map(n=>Z(n)).filter(Boolean):[...ne()].map(([,n])=>n),E=new Set;for(const n of I)typeof n.resolve=="function"&&(E.has(n.serverName)||(E.add(n.serverName),this._ensureSkillConfigured(h,n,s,v,a,b)));if(s){const n=Z("browser");n&&typeof n.resolve=="function"&&!E.has(n.serverName)&&this._ensureSkillConfigured(h,n,s,v,"execute_live",b)}if(Object.keys(h).length===0)return t.debug("[MCP] No MCP servers configured - agent will run without tool access"),{isolatedMcpHome:null};const S=`${JSON.stringify({mcpServers:h},null,2)}
-`;if(ae(s)){const n=ue(l||process.cwd()),y=C(n,".cursor","mcp.json");return j(y,S,"utf8"),t.debug(`[MCP] Isolated cursor-agent HOME (session-scoped mcp.json): ${n} | servers: ${Object.keys(h).join(", ")}`),{isolatedMcpHome:n}}return H(u)||z(u,{recursive:!0}),j(g,S,"utf8"),t.debug(`[MCP] Global ~/.cursor/mcp.json | servers: ${Object.keys(h).join(", ")}`),{isolatedMcpHome:null}}_ensureSkillConfigured(s,l,r,f,a=null,b){const u=l.cursorKey||l.serverName,g=s[u]?u:s[l.serverName]?l.serverName:null;if(g&&r){const h=typeof l.resolve=="function"?l.resolve({sessionPath:r,nodeName:a,headless:b}):null;h?.args?s[g].args=h.args:s[g].args=(s[g].args||[]).map(I=>I.startsWith("--output-dir=")?`--output-dir=${r}`:I);const $=h?.env||{},v=l.sessionEnvKey?{[l.sessionEnvKey]:f}:{};s[g].env={...s[g].env||{},...$,...v},t.debug(`[MCP] Updated ${g} session \u2192 ${r}`);return}if(g)return;const m=l.resolve({sessionPath:r,nodeName:a,headless:b});m&&(s[u]={...m,...l.sessionEnvKey&&{env:{...m.env||{},[l.sessionEnvKey]:f}}},t.debug(`[MCP] Configured ${u}`))}_spawnWithStreaming(s,l,r,f,a=null,b=null,u=null){return new Promise((g,m)=>{const h=Date.now();let $="",v="",I=Date.now(),E=0,S=!1,n=null,y=!1,P=!1,x=null;if(b)try{x=C(X(String(b)),oe)}catch{x=null}let M=!1;const L=()=>{M||(M=!0,ce(u))},_={...process.env};u&&(_.HOME=u,process.platform==="win32"&&(_.USERPROFILE=u),t.debug(`[Agent] cursor-agent HOME=${u} (isolated MCP config)`));const o=q(s,l,{cwd:r,shell:!1,stdio:["pipe","pipe","pipe"],env:_});t.debug(`[Agent] PID: ${o.pid}`),o.stdin.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stdin error: ${e.message}`)}),o.stdout.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stdout error: ${e.message}`)}),o.stderr.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stderr error: ${e.message}`)}),a?(o.stdin.write(a,e=>{e&&e.code!=="EPIPE"&&t.warn(`[Agent] Failed to write to stdin: ${e.message}`),o.stdin.end()}),t.debug(`[Agent] Prompt also piped to stdin (${a.length} chars)`)):o.stdin.end();let A=null;x&&(A=setInterval(()=>{if(!(S||P))try{if(H(x)){S=!0,n="studio-stop";try{V(x)}catch{}t.warn("\u{1F6D1} Studio stop requested \u2014 terminating Cursor agent (and MCP browser session)"),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},2e3)}}catch{}},600));const F=new Set,c=new Date(h).toISOString().replace(/\.\d+Z$/,""),w=setInterval(()=>{const e=Math.round((Date.now()-h)/1e3),d=Math.round((Date.now()-I)/1e3),i=[];try{const R=Math.ceil(e/60)+1,O=N(`find "${r}" -type f -mmin -${R} -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/target/*' 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(O)for(const U of O.split(`
-`)){const K=U.replace(`${r}/`,"");F.has(K)||(F.add(K),i.push(K))}}catch{}let p="";i.length>0&&(p=` | \u{1F4C1} new: ${i.map(O=>O.split("/").pop()).join(", ")}`),F.size>0&&(p+=` | \u{1F4E6} total: ${F.size} files`),t.debug(`\u{1F493} [Agent] Running for ${e}s | ${E} lines output${p}`),E===0&&e>=30&&F.size===0&&(e<35&&t.warn(`\u26A0\uFE0F  [Agent] No output after ${e}s \u2014 agent may be stuck. Check your CURSOR_API_KEY.`),e>=60&&(S=!0,n=n||"stall",t.error(`\u274C [Agent] No response after ${e}s \u2014 killing. Verify CURSOR_API_KEY is valid and agent CLI works: agent --version`),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},3e3)))},3e4),T=setTimeout(()=>{S=!0,n=n||"timeout";const e=Math.round((Date.now()-h)/1e3);t.error(`\u23F1\uFE0F  [Agent] Timeout after ${e}s \u2014 killing process (PID: ${o.pid})`),$.trim()&&t.warn(`\u{1F4E4} [Agent] Partial output (${$.length} chars) before timeout:
-${$.slice(-2e3)}`),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},5e3)},f),k=new se;k.onToolCall=(e,d)=>{let i=e,p=d;if(e==="mcpToolCall"&&d?.name)i=d.name.replace(/^mcp_+[^_]+_+/,""),i.includes("-")&&i.split("-")[0]===i.split("-")[1]&&(i=i.split("-")[0]),p=d.args??d.input??d;else{if(e==="readToolCall"||e==="editToolCall"||e==="writeToolCall")return;(e.startsWith("mcp__")||e.includes("ToolCall"))&&(i=e.replace(/^mcp_+[^_]+_+/,"").replace(/ToolCall$/,""))}if(i.includes("memory")?G.stepMemory(`Tool: ${i}`):G.stepTool(`Tool: ${i}`),p!=null&&typeof p=="object"&&Object.keys(p).length>0&&!P){const O=JSON.stringify(p),U=O.length>100?`${O.substring(0,100)}...`:O;console.log(`  Input: ${U}`)}},o.stdout.on("data",e=>{const d=e.toString();$+=d,I=Date.now(),y||(y=!0);const i=k.processChunk(d);i&&!P&&process.stdout.write(i);const p=d.split(`
-`).filter(R=>R.trim());E+=p.length}),o.stderr.on("data",e=>{const d=e.toString();v+=d,I=Date.now(),y||(y=!0);const i=d.split(`
-`).filter(p=>p.trim());for(const p of i)t.warn(`\u26A0\uFE0F  [Agent stderr] ${p}`)}),o.on("close",(e,d)=>{P=!0,L(),clearTimeout(T),clearInterval(w),A&&clearInterval(A),k.flush();const i=Math.round((Date.now()-h)/1e3);if(t.debug(`[Agent] Exited: code=${e}, signal=${d}, elapsed=${i}s, output=${$.length} chars`),S){if(n==="studio-stop"){m(new Error("Stopped from Zibby Studio"));return}m(new Error(`Cursor Agent timed out after ${i}s (limit: ${f/1e3}s). ${E} lines produced. Last output ${Math.round((Date.now()-I)/1e3)}s ago. ${$.trim()?`
+${M.bold("Prompt sent to LLM:")}`),console.log(M.dim("\u2500".repeat(60))),console.log(M.dim(i)),console.log(M.dim("\u2500".repeat(60)));const L=["--print","--force","--approve-mcps","--output-format","stream-json","--stream-partial-output","--model",v||"auto"];if(process.env.CURSOR_API_KEY&&L.push("--api-key",process.env.CURSOR_API_KEY),L.push(i),t.debug(`[Agent] Prompt: ${i.length} chars, model: ${v||"auto"}`),t.debug(`[Agent] Workspace: ${r}`),process.env.LOG_LEVEL==="debug"||process.env.ZIBBY_LOG_CURSOR_CLI==="1")try{console.log(`\u{1F527} Cursor CLI --model ${v||"auto"} (from .zibby.config.js agent.cursor.model)
+`)}catch{}let _,o=null;try{const c=u||(process.env.ZIBBY_SESSION_PATH?String(process.env.ZIBBY_SESSION_PATH).trim():null);_=await this._spawnWithStreaming(n,L,r,m,null,c,E)}catch(c){o=c}const A=_?.stdout||"";if(a){const c=typeof a.parse=="function";let y=null;const T=!!(w&&H(w));if(w&&t.info(`[Agent] Result file: ${T?"present":"missing"} at ${w}`),T)try{const e=J(w,"utf-8").trim();y=JSON.parse(e),t.info(`[Agent] Parsed JSON from result file OK (${e.length} chars) \u2192 object ready for validation`),o&&t.debug("[Agent] Agent exited non-zero but result file was written \u2014 recovering")}catch(e){t.warn(`\u26A0\uFE0F  [Agent] Result file exists on disk but is not valid JSON: ${e.message}`)}else if(o)t.warn(`[Agent] Result file missing at ${w} (agent process error \u2014 may still recover if strictMode repairs)`);else throw t.error(`\u274C [Agent] Result file was never created at ${w}`),new Error(`Agent did not write required result file at ${w}`);if(y&&c)try{const e=a.parse(y);return t.info("\u2705 [Agent] Zod validation passed for structured result file"),$&&t.debug("[Agent] strictMode enabled but not needed \u2014 agent wrote valid file"),{raw:A,structured:e}}catch(e){t.warn(`\u26A0\uFE0F  [Agent] JSON parsed but Zod rejected it (wrong types/shape): ${e.message?.slice(0,400)}`)}else{if(y)return t.info("\u2705 [Agent] File-based output extracted (no Zod parse fn) \u2014 accepting as structured"),$&&t.debug("[Agent] strictMode enabled but not needed \u2014 agent wrote valid file"),{raw:A,structured:y};T&&t.error("\u274C [Agent] Result file exists but produced no in-memory JSON (parse failed earlier)")}if($&&!o){const e=_.parsedText,d=y?JSON.stringify(y):e;t.info(`[Agent] strictMode: calling OpenAI proxy to fix structured output (${d.length} chars in)`);try{const s=await le(d,a);if(c){const p=a.parse(s.structured);return t.info("\u2705 [Agent] Proxy output passed Zod validation"),{raw:A,structured:p}}return{raw:A,...s}}catch(s){if(t.warn(`\u26A0\uFE0F  [Agent] strictMode proxy failed: ${s.message}`),y)return t.warn("[Agent] Using agent's original result file as fallback"),{raw:A,structured:y}}}if(o)throw o;const k=T?y==null?"file existed but JSON.parse failed \u2014 see WARN log above":c?"JSON was valid but Zod validation failed \u2014 see WARN log above":"no structured object after read (unexpected)":"file never appeared (agent may not have run Write tool to the path above)";throw t.error(`\u274C [Agent] No validated structured output: ${k}`),t.error("\u{1F4A1} Tip: Set strictMode=true in .zibby.config.js for OpenAI proxy fallback"),new Error(`Agent did not produce a valid result file at ${w}. Enable strictMode for proxy fallback.`)}if(o)throw o;return this._extractFinalResult(A)||_?.parsedText||A}_extractFinalResult(i){if(!i)return null;const l=i.split(`
+`);let r=null;for(const f of l){const a=f.trim();if(a)try{const b=JSON.parse(a);if(b.type==="assistant"&&b.message?.content){const u=b.message.content;if(Array.isArray(u)){const g=u.filter(m=>m.type==="text"&&m.text).map(m=>m.text).join("");g&&(r=g)}else typeof u=="string"&&u&&(r=u)}}catch{}}return r?.trim()||null}_setupMcpConfig(i,l,r,f=null,a=null){const b=r?.headless,u=C(D(),".cursor"),g=C(u,"mcp.json");let m={};if(H(g))try{m=JSON.parse(J(g,"utf-8"))}catch{}const h=m.mcpServers||{},$=r?.paths?.output||te,v=C(l||process.cwd(),$,re),I=Array.isArray(f)?f.map(n=>Z(n)).filter(Boolean):[...ne()].map(([,n])=>n),E=new Set;for(const n of I)typeof n.resolve=="function"&&(E.has(n.serverName)||(E.add(n.serverName),this._ensureSkillConfigured(h,n,i,v,a,b)));if(i){const n=Z("browser");n&&typeof n.resolve=="function"&&!E.has(n.serverName)&&this._ensureSkillConfigured(h,n,i,v,"execute_live",b)}if(Object.keys(h).length===0)return t.debug("[MCP] No MCP servers configured - agent will run without tool access"),{isolatedMcpHome:null};const S=`${JSON.stringify({mcpServers:h},null,2)}
+`;if(ae(i)){const n=ue(l||process.cwd()),w=C(n,".cursor","mcp.json");return j(w,S,"utf8"),t.debug(`[MCP] Isolated cursor-agent HOME (session-scoped mcp.json): ${n} | servers: ${Object.keys(h).join(", ")}`),{isolatedMcpHome:n}}return H(u)||z(u,{recursive:!0}),j(g,S,"utf8"),t.debug(`[MCP] Global ~/.cursor/mcp.json | servers: ${Object.keys(h).join(", ")}`),{isolatedMcpHome:null}}_ensureSkillConfigured(i,l,r,f,a=null,b){const u=l.cursorKey||l.serverName,g=i[u]?u:i[l.serverName]?l.serverName:null;if(g&&r){const h=typeof l.resolve=="function"?l.resolve({sessionPath:r,nodeName:a,headless:b}):null;h?.args?i[g].args=h.args:i[g].args=(i[g].args||[]).map(I=>I.startsWith("--output-dir=")?`--output-dir=${r}`:I);const $=h?.env||{},v=l.sessionEnvKey?{[l.sessionEnvKey]:f}:{};i[g].env={...i[g].env||{},...$,...v},t.debug(`[MCP] Updated ${g} session \u2192 ${r}`);return}if(g)return;const m=l.resolve({sessionPath:r,nodeName:a,headless:b});m&&(i[u]={...m,...l.sessionEnvKey&&{env:{...m.env||{},[l.sessionEnvKey]:f}}},t.debug(`[MCP] Configured ${u}`))}_spawnWithStreaming(i,l,r,f,a=null,b=null,u=null){return new Promise((g,m)=>{const h=Date.now();let $="",v="",I=Date.now(),E=0,S=!1,n=null,w=!1,P=!1,x=null;if(b)try{x=C(X(String(b)),oe)}catch{x=null}let M=!1;const L=()=>{M||(M=!0,ce(u))},_={...process.env};u&&(_.HOME=u,process.platform==="win32"&&(_.USERPROFILE=u),t.debug(`[Agent] cursor-agent HOME=${u} (isolated MCP config)`));const o=q(i,l,{cwd:r,shell:!1,stdio:["pipe","pipe","pipe"],env:_});t.debug(`[Agent] PID: ${o.pid}`),o.stdin.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stdin error: ${e.message}`)}),o.stdout.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stdout error: ${e.message}`)}),o.stderr.on("error",e=>{e.code!=="EPIPE"&&t.warn(`[Agent] stderr error: ${e.message}`)}),a?(o.stdin.write(a,e=>{e&&e.code!=="EPIPE"&&t.warn(`[Agent] Failed to write to stdin: ${e.message}`),o.stdin.end()}),t.debug(`[Agent] Prompt also piped to stdin (${a.length} chars)`)):o.stdin.end();let A=null;x&&(A=setInterval(()=>{if(!(S||P))try{if(H(x)){S=!0,n="studio-stop";try{V(x)}catch{}t.warn("\u{1F6D1} Studio stop requested \u2014 terminating Cursor agent (and MCP browser session)"),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},2e3)}}catch{}},600));const F=new Set,c=new Date(h).toISOString().replace(/\.\d+Z$/,""),y=setInterval(()=>{const e=Math.round((Date.now()-h)/1e3),d=Math.round((Date.now()-I)/1e3),s=[];try{const R=Math.ceil(e/60)+1,O=N(`find "${r}" -type f -mmin -${R} -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/target/*' 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(O)for(const U of O.split(`
+`)){const K=U.replace(`${r}/`,"");F.has(K)||(F.add(K),s.push(K))}}catch{}let p="";s.length>0&&(p=` | \u{1F4C1} new: ${s.map(O=>O.split("/").pop()).join(", ")}`),F.size>0&&(p+=` | \u{1F4E6} total: ${F.size} files`),t.debug(`\u{1F493} [Agent] Running for ${e}s | ${E} lines output${p}`),E===0&&e>=30&&F.size===0&&(e<35&&t.warn(`\u26A0\uFE0F  [Agent] No output after ${e}s \u2014 agent may be stuck. Check your CURSOR_API_KEY.`),e>=60&&(S=!0,n=n||"stall",t.error(`\u274C [Agent] No response after ${e}s \u2014 killing. Verify CURSOR_API_KEY is valid and agent CLI works: agent --version`),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},3e3)))},3e4),T=setTimeout(()=>{S=!0,n=n||"timeout";const e=Math.round((Date.now()-h)/1e3);t.error(`\u23F1\uFE0F  [Agent] Timeout after ${e}s \u2014 killing process (PID: ${o.pid})`),$.trim()&&t.warn(`\u{1F4E4} [Agent] Partial output (${$.length} chars) before timeout:
+${$.slice(-2e3)}`),o.kill("SIGTERM"),setTimeout(()=>{o.killed||o.kill("SIGKILL")},5e3)},f),k=new se;k.onToolCall=(e,d)=>{let s=e,p=d;if(e==="mcpToolCall"&&d?.name)s=d.name.replace(/^mcp_+[^_]+_+/,""),s.includes("-")&&s.split("-")[0]===s.split("-")[1]&&(s=s.split("-")[0]),p=d.args??d.input??d;else{if(e==="readToolCall"||e==="editToolCall"||e==="writeToolCall")return;(e.startsWith("mcp__")||e.includes("ToolCall"))&&(s=e.replace(/^mcp_+[^_]+_+/,"").replace(/ToolCall$/,""))}if(s.includes("memory")?G.stepMemory(`Tool: ${s}`):G.stepTool(`Tool: ${s}`),p!=null&&typeof p=="object"&&Object.keys(p).length>0&&!P){const O=JSON.stringify(p),U=O.length>100?`${O.substring(0,100)}...`:O;console.log(`  Input: ${U}`)}},o.stdout.on("data",e=>{const d=e.toString();$+=d,I=Date.now(),w||(w=!0);const s=k.processChunk(d);s&&!P&&process.stdout.write(s);const p=d.split(`
+`).filter(R=>R.trim());E+=p.length}),o.stderr.on("data",e=>{const d=e.toString();v+=d,I=Date.now(),w||(w=!0);const s=d.split(`
+`).filter(p=>p.trim());for(const p of s)t.warn(`\u26A0\uFE0F  [Agent stderr] ${p}`)}),o.on("close",(e,d)=>{P=!0,L(),clearTimeout(T),clearInterval(y),A&&clearInterval(A),k.flush();const s=Math.round((Date.now()-h)/1e3);if(t.debug(`[Agent] Exited: code=${e}, signal=${d}, elapsed=${s}s, output=${$.length} chars`),S){if(n==="studio-stop"){m(new Error("Stopped from Zibby Studio"));return}m(new Error(`Cursor Agent timed out after ${s}s (limit: ${f/1e3}s). ${E} lines produced. Last output ${Math.round((Date.now()-I)/1e3)}s ago. ${$.trim()?`
 Partial output (last 500 chars):
 ${$.slice(-500)}`:"No output captured."}`));return}if(e!==0){m(new Error(`Cursor Agent failed: exit code ${e}, signal ${d}. ${v.trim()?`
 Stderr: ${v.slice(-1e3)}`:""}${$.trim()?`
-Stdout (last 500 chars): ${$.slice(-500)}`:""}`));return}const p=k.getResult(),R=p?JSON.stringify(p,null,2):k.getRawText()||$||"";g({stdout:$||v||"",parsedText:R})}),o.on("error",e=>{L(),clearTimeout(T),clearInterval(w),A&&clearInterval(A),m(new Error(`Cursor Agent spawn error: ${e.message}
-Binary: ${s}
+Stdout (last 500 chars): ${$.slice(-500)}`:""}`));return}const p=k.getResult(),R=p?JSON.stringify(p,null,2):k.getRawText()||$||"";g({stdout:$||v||"",parsedText:R})}),o.on("error",e=>{L(),clearTimeout(T),clearInterval(y),A&&clearInterval(A),m(new Error(`Cursor Agent spawn error: ${e.message}
+Binary: ${i}
 This usually means the binary is not in PATH. Try:
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`))})})}}export{Ee as CursorAgentStrategy};

package/dist/framework/constants.js

@@ -1 +1 @@
-const o=".zibby/output",t="sessions",s=".session-info.json",_=".zibby-studio-stop",I="result.json",E="raw_stream_output.txt",e="events.json",r={BROWSER:"browser",JIRA:"jira",GITHUB:"github",SLACK:"slack",MEMORY:"memory",CHAT_MEMORY:"chat-memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools"},S=["CI_JOB_ID","GITHUB_RUN_ID","CIRCLE_WORKFLOW_ID","BUILD_ID"];export{S as CI_ENV_VARS,o as DEFAULT_OUTPUT_BASE,e as EVENTS_FILE,E as RAW_OUTPUT_FILE,I as RESULT_FILE,t as SESSIONS_DIR,s as SESSION_INFO_FILE,r as SKILLS,_ as STUDIO_STOP_REQUEST_FILE};
+const o=".zibby/output",t="sessions",s=".session-info.json",_=".zibby-studio-stop",I="result.json",r="raw_stream_output.txt",E="events.json",e={BROWSER:"browser",JIRA:"jira",GITHUB:"github",SLACK:"slack",MEMORY:"memory",CHAT_MEMORY:"chat-memory",RUNNER:"runner",SKILL_INSTALLER:"skill-installer",CORE_TOOLS:"core-tools",WORKFLOW_BUILDER:"workflow-builder"},S=["CI_JOB_ID","GITHUB_RUN_ID","CIRCLE_WORKFLOW_ID","BUILD_ID"];export{S as CI_ENV_VARS,o as DEFAULT_OUTPUT_BASE,E as EVENTS_FILE,r as RAW_OUTPUT_FILE,I as RESULT_FILE,t as SESSIONS_DIR,s as SESSION_INFO_FILE,e as SKILLS,_ as STUDIO_STOP_REQUEST_FILE};

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/core",
-  "version": "0.1.27",
+  "version": "0.1.30",
   "description": "Core test automation engine with multi-agent and multi-MCP support",
   "type": "module",
   "main": "src/index.js",
@@ -69,6 +69,7 @@
   },
   "files": [
     "src/",
+    "scripts/",
     "templates/",
     "!templates/**/__tests__/",
     "!templates/**/*.test.js",
@@ -85,13 +86,14 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@openai/codex-sdk": "^0.120.0",
     "@playwright/mcp": "^0.0.70",
-    "@zibby/mcp-browser": "^0.1.6",
+    "@zibby/mcp-browser": "^0.1.8",
     "acorn": "^8.15.0",
     "acorn-walk": "^8.3.5",
     "axios": "^1.15.0",
     "chalk": "^5.3.0",
     "dotenv": "^17.4.1",
     "handlebars": "^4.7.9",
+    "hono": "^4.12.14",
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/core",
-  "version": "0.1.27",
+  "version": "0.1.30",
   "description": "Core test automation engine with multi-agent and multi-MCP support",
   "type": "module",
   "main": "dist/index.js",
@@ -69,6 +69,7 @@
   },
   "files": [
     "dist/",
+    "scripts/",
     "templates/",
     "!templates/**/__tests__/",
     "!templates/**/*.test.js",
@@ -85,13 +86,14 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@openai/codex-sdk": "^0.120.0",
     "@playwright/mcp": "^0.0.70",
-    "@zibby/mcp-browser": "^0.1.6",
+    "@zibby/mcp-browser": "^0.1.8",
     "acorn": "^8.15.0",
     "acorn-walk": "^8.3.5",
     "axios": "^1.15.0",
     "chalk": "^5.3.0",
     "dotenv": "^17.4.1",
     "handlebars": "^4.7.9",
+    "hono": "^4.12.14",
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2"
   },

package/scripts/export-default-workflows.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/**
+ * Export default workflows as JSON for the backend API
+ * Run: node packages/core/scripts/export-default-workflows.js
+ */
+
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { WorkflowGraph } from '../src/framework/graph.js';
+import { buildAnalysisGraph } from '../templates/graphs/analysisGraph.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const outputDir = join(__dirname, '../../../backend/src/data');
+
+// Ensure output directory exists
+if (!existsSync(outputDir)) {
+  mkdirSync(outputDir, { recursive: true });
+}
+
+// Build and serialize analysis workflow
+console.log('Building analysis workflow...');
+const analysisGraph = new WorkflowGraph();
+buildAnalysisGraph(analysisGraph);
+const serializedAnalysis = analysisGraph.serialize();
+
+// Add workflow metadata
+const analysisWorkflow = {
+  id: 'default_analysis',
+  name: 'Analysis Workflow',
+  description: 'Analyzes tickets and generates code implementation',
+  ...serializedAnalysis,
+  createdAt: new Date().toISOString(),
+  isDefault: true
+};
+
+// Write to JSON file
+const outputPath = join(outputDir, 'default-workflows.json');
+const workflows = {
+  analysis: analysisWorkflow
+};
+
+writeFileSync(outputPath, JSON.stringify(workflows, null, 2));
+console.log(`✅ Exported default workflows to ${outputPath}`);
+
+// Also export as individual files for clarity
+writeFileSync(
+  join(outputDir, 'default-analysis-workflow.json'),
+  JSON.stringify(analysisWorkflow, null, 2)
+);
+console.log('✅ Exported individual workflow files');

package/scripts/patch-cursor-mcp.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+/**
+ * Patch cursor-agent CLI to auto-approve MCP tool calls for CI/CD use.
+ *
+ * This script modifies the cursor-agent source code to bypass the manual
+ * approval prompt for MCP tool executions, making it suitable for automated
+ * CI/CD pipelines.
+ *
+ * Usage:
+ *   node patch-cursor-mcp.js
+ */
+
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+function findLatestCursorAgent() {
+  const versionsDir = join(homedir(), '.local/share/cursor-agent/versions');
+  
+  if (!existsSync(versionsDir)) {
+    console.error(`❌ Cursor agent versions directory not found: ${versionsDir}`);
+    console.error('   Make sure cursor-agent is installed: curl https://cursor.com/install -fsS | bash');
+    process.exit(1);
+  }
+  
+  const versions = readdirSync(versionsDir)
+    .map(name => join(versionsDir, name))
+    .filter(path => statSync(path).isDirectory());
+  
+  if (versions.length === 0) {
+    console.error(`❌ No cursor-agent versions found in ${versionsDir}`);
+    process.exit(1);
+  }
+  
+  // Get the latest version by creation time
+  const latestVersion = versions
+    .map(path => ({ path, ctime: statSync(path).ctimeMs }))
+    .sort((a, b) => b.ctime - a.ctime)[0].path;
+  
+  return join(latestVersion, 'index.js');
+}
+
+function backupFile(filePath) {
+  const backupPath = `${filePath  }.backup`;
+  
+  if (existsSync(backupPath)) {
+    console.log(`ℹ️  Backup already exists: ${backupPath}`);
+    return backupPath;
+  }
+  
+  const content = readFileSync(filePath, 'utf8');
+  writeFileSync(backupPath, content, 'utf8');
+  
+  console.log(`✅ Backup created: ${backupPath}`);
+  return backupPath;
+}
+
+function patchMcpApproval(filePath) {
+  const content = readFileSync(filePath, 'utf8');
+  
+  // Check if already patched
+  if (content.includes('AUTO-APPROVE MCP TOOLS FOR CI/CD')) {
+    console.log('✅ File is already patched!');
+    return false;
+  }
+  
+  // Pattern to match the requestApproval call for MCP
+  const pattern = /(\s+const result = await this\.pendingDecisionProvider\.requestApproval\(\{\s+type: OperationType\.Mcp,\s+details: \{\s+name: approvalDetails\.name,\s+toolName: approvalDetails\.toolName,\s+providerIdentifier: approvalDetails\.providerIdentifier,\s+args: approvalDetails\.args,\s+\},\s+toolCallId: args\.toolCallId,\s+\}\);)/;
+  
+  const replacement = `                        // AUTO-APPROVE MCP TOOLS FOR CI/CD
+                        const result = { approved: true };
+                        /*
+                        const result = await this.pendingDecisionProvider.requestApproval({
+                            type: OperationType.Mcp,
+                            details: {
+                                name: approvalDetails.name,
+                                toolName: approvalDetails.toolName,
+                                providerIdentifier: approvalDetails.providerIdentifier,
+                                args: approvalDetails.args,
+                            },
+                            toolCallId: args.toolCallId,
+                        });
+                        */`;
+  
+  const newContent = content.replace(pattern, replacement);
+  
+  if (newContent === content) {
+    console.log('ℹ️  Pattern not found - cursor-agent code structure has changed.');
+    console.log('   This is OKAY! Newer versions might not need this patch.');
+    console.log('   If auto-approval doesn\'t work, cursor-agent team may have fixed it!');
+    return false;
+  }
+  
+  writeFileSync(filePath, newContent, 'utf8');
+  return true;
+}
+
+function addApprovalKeyLogging(filePath) {
+  const content = readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+  
+  // Check if already added
+  if (lines.some(line => line.includes('🔑 APPROVAL KEY'))) {
+    console.log('✅ Approval key logging already enabled!');
+    return false;
+  }
+  
+  // Find the line with generateApprovalKey and add logging after it
+  let targetLineNum = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes('const approvalKey = generateApprovalKey(serverName, server, this.cwd);')) {
+      targetLineNum = i;
+      break;
+    }
+  }
+  
+  if (targetLineNum === -1) {
+    console.log('⚠️  Could not find approval key generation line');
+    return false;
+  }
+  
+  // Insert the console.log after the generateApprovalKey line
+  const indent = '            ';
+  const logLine = `${indent}console.log("🔑 APPROVAL KEY:", serverName, "=>", approvalKey);`;
+  lines.splice(targetLineNum + 1, 0, logLine);
+  
+  writeFileSync(filePath, lines.join('\n'), 'utf8');
+  return true;
+}
+
+function main() {
+  console.log('🔧 Patching cursor-agent for CI/CD MCP usage...\n');
+  console.log('ℹ️  Note: This patch is temporary and may not be needed in future versions.\n');
+  
+  // Find cursor-agent
+  const indexFile = findLatestCursorAgent();
+  console.log(`📍 Found cursor-agent: ${indexFile}\n`);
+  
+  // Backup
+  backupFile(indexFile);
+  console.log();
+  
+  // Apply patches
+  const patchedApproval = patchMcpApproval(indexFile);
+  if (patchedApproval) {
+    console.log('✅ Patched MCP tool auto-approval');
+  }
+  console.log();
+  
+  const patchedLogging = addApprovalKeyLogging(indexFile);
+  if (patchedLogging) {
+    console.log('✅ Added approval key logging');
+  }
+  console.log();
+  
+  if (patchedApproval || patchedLogging) {
+    console.log('🎉 cursor-agent is now ready for CI/CD!');
+    console.log('\nNext steps:');
+    console.log('1. Run: cursor-agent mcp list');
+    console.log('2. Copy the approval key shown');
+    console.log('3. Add it to ~/.cursor/projects/YOUR_PROJECT/mcp-approvals.json');
+    console.log('\n⚠️  If cursor-agent updates break this patch, MCP may work without it.');
+  } else {
+    console.log('ℹ️  No changes needed - already configured or cursor-agent version doesn\'t need patching!');
+  }
+}
+
+main();
+

package/scripts/setup-ci.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Complete CI/CD Setup (from scratch)"
+echo "======================================="
+echo ""
+
+# Get the absolute path to the project
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "📍 Project root: $PROJECT_ROOT"
+echo ""
+
+# Check OS
+OS="$(uname -s)"
+echo "🖥️  Detected OS: $OS"
+echo ""
+
+# Step 1: Check/Install Node.js
+echo "Step 1: Checking Node.js..."
+if command -v node &> /dev/null; then
+  NODE_VERSION=$(node --version)
+  echo "✓ Node.js installed: $NODE_VERSION"
+else
+  echo "✗ Node.js not found!"
+  echo "  Install: https://nodejs.org/ or use nvm"
+  exit 1
+fi
+echo ""
+
+# Step 2: Check/Install Python 3
+echo "Step 2: Checking Python 3..."
+if command -v python3 &> /dev/null; then
+  PYTHON_VERSION=$(python3 --version)
+  echo "✓ Python 3 installed: $PYTHON_VERSION"
+else
+  echo "✗ Python 3 not found!"
+  exit 1
+fi
+echo ""
+
+# Step 3: Install npm dependencies
+echo "Step 3: Installing npm dependencies..."
+cd "$PROJECT_ROOT"
+if [ -f "package.json" ]; then
+  npm install --silent > /dev/null 2>&1
+  echo "✓ npm dependencies installed"
+else
+  echo "✗ package.json not found"
+  exit 1
+fi
+echo ""
+
+# Step 4: Check/Install cursor-agent
+echo "Step 4: Checking cursor-agent..."
+if command -v cursor-agent &> /dev/null; then
+  CURSOR_VERSION=$(cursor-agent --version 2>&1 | head -1 || echo "unknown")
+  echo "✓ cursor-agent installed: $CURSOR_VERSION"
+else
+  echo "⚠️  cursor-agent not found - installing..."
+  
+  if [ "$OS" = "Darwin" ] || [ "$OS" = "Linux" ]; then
+    # Install cursor-agent
+    curl -fsSL https://cursor.com/install | bash
+    
+    # Add to PATH for current session
+    export PATH="$HOME/.local/bin:$PATH"
+    
+    if command -v cursor-agent &> /dev/null; then
+      echo "✓ cursor-agent installed successfully"
+    else
+      echo "✗ cursor-agent installation failed"
+      echo "  Manual install: curl https://cursor.com/install -fsS | bash"
+      exit 1
+    fi
+  else
+    echo "✗ Unsupported OS for automatic cursor-agent installation"
+    echo "  Install manually: https://cursor.com/cli"
+    exit 1
+  fi
+fi
+echo ""
+
+# Step 5: Check CURSOR_API_KEY (REQUIRED for CI/CD)
+echo "Step 5: Checking CURSOR_API_KEY..."
+if [ -z "$CURSOR_API_KEY" ]; then
+  echo "⚠️  CURSOR_API_KEY not set"
+  echo "  ⚠️  REQUIRED for CI/CD - cursor-agent will fail without it!"
+  echo "  Set it as an environment variable in your CI/CD config"
+  echo "  Get your key from: https://cursor.com/settings"
+  echo ""
+  echo "  Example (GitLab CI):"
+  echo "    variables:"
+  echo "      CURSOR_API_KEY: \$CURSOR_API_KEY"
+  echo ""
+else
+  echo "✓ CURSOR_API_KEY is set"
+fi
+echo ""
+
+# Step 6: Run the official Playwright MCP setup
+echo "Step 6: Setting up official Playwright MCP..."
+echo ""
+bash "$SCRIPT_DIR/setup-official-playwright-mcp.sh"
+
+echo ""
+echo "======================================="
+echo "✅ Complete CI/CD setup finished!"
+echo "======================================="
+echo ""
+echo "Ready to use in CI/CD:"
+echo "  cursor-agent -p 'Navigate to google.com' --mcp-server playwright-official"
+echo ""
+

package/scripts/setup-official-playwright-mcp.sh

@@ -0,0 +1,173 @@
+#!/bin/bash
+
+set -e
+
+# Get script directory for relative imports
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Step 1: Check cursor-agent (check actual locations, not just PATH)
+CURSOR_AGENT_PATH=""
+if command -v cursor-agent &> /dev/null; then
+    CURSOR_AGENT_PATH=$(command -v cursor-agent)
+elif [ -x "$HOME/.local/bin/cursor-agent" ]; then
+    CURSOR_AGENT_PATH="$HOME/.local/bin/cursor-agent"
+elif [ -x "$HOME/.cursor/bin/cursor-agent" ]; then
+    CURSOR_AGENT_PATH="$HOME/.cursor/bin/cursor-agent"
+fi
+
+if [ -z "$CURSOR_AGENT_PATH" ]; then
+    echo "⚠️  cursor-agent not found. Installing..."
+    curl https://cursor.com/install -fsS | bash
+    # Check again after install
+    if [ -x "$HOME/.local/bin/cursor-agent" ]; then
+        CURSOR_AGENT_PATH="$HOME/.local/bin/cursor-agent"
+    elif [ -x "$HOME/.cursor/bin/cursor-agent" ]; then
+        CURSOR_AGENT_PATH="$HOME/.cursor/bin/cursor-agent"
+    fi
+fi
+
+# Always ensure these directories are in PATH for this script
+export PATH="$HOME/.cursor/bin:$HOME/.local/bin:$PATH"
+
+# Step 2: Find Node.js absolute paths (Cursor GUI doesn't have shell PATH)
+NODE_PATH=$(which node 2>/dev/null || echo "")
+NPX_PATH=$(which npx 2>/dev/null || echo "")
+NODE_BIN_DIR=$(dirname "$NODE_PATH" 2>/dev/null || echo "")
+
+if [ -z "$NODE_PATH" ]; then
+    echo "❌ node not found. Please install Node.js"
+    exit 1
+fi
+
+echo "   Using Node: $NODE_PATH"
+
+# Step 3: Find Zibby MCP Browser (stable IDs + event recording)
+echo "Setting up Zibby MCP Browser..."
+
+# Resolve @zibby/mcp-browser from node_modules (works in workspace, global, and npx installs)
+ZIBBY_MCP_PKG=$("$NODE_PATH" -e "try{console.log(require.resolve('@zibby/mcp-browser/package.json',{paths:['$SCRIPT_DIR/..']}))}catch{}" 2>/dev/null)
+if [ -n "$ZIBBY_MCP_PKG" ]; then
+  ZIBBY_MCP_BIN="$(dirname "$ZIBBY_MCP_PKG")/bin/mcp-browser-zibby.js"
+fi
+
+# Fallback: try workspace path (dev only)
+if [ -z "$ZIBBY_MCP_BIN" ] || [ ! -f "$ZIBBY_MCP_BIN" ]; then
+  ZIBBY_MCP_DIR="$SCRIPT_DIR/../../mcps/browser"
+  if [ -f "$ZIBBY_MCP_DIR/bin/mcp-browser-zibby.js" ]; then
+    ZIBBY_MCP_BIN="$ZIBBY_MCP_DIR/bin/mcp-browser-zibby.js"
+  fi
+fi
+
+# Final fallback: official @playwright/mcp (no stable IDs or event recording)
+if [ -z "$ZIBBY_MCP_BIN" ] || [ ! -f "$ZIBBY_MCP_BIN" ]; then
+  PLAYWRIGHT_MCP_PKG=$("$NODE_PATH" -e "try{console.log(require.resolve('@playwright/mcp/package.json',{paths:['$SCRIPT_DIR/..']}))}catch{}" 2>/dev/null)
+  if [ -n "$PLAYWRIGHT_MCP_PKG" ]; then
+    ZIBBY_MCP_BIN="$(dirname "$PLAYWRIGHT_MCP_PKG")/cli.js"
+    echo "   ⚠️  Using @playwright/mcp (official) — stable IDs and event recording unavailable"
+  fi
+fi
+
+if [ -z "$ZIBBY_MCP_BIN" ] || [ ! -f "$ZIBBY_MCP_BIN" ]; then
+  echo "❌ No Playwright MCP found. Run: npm install @zibby/mcp-browser"
+  exit 1
+fi
+
+echo "   ✅ Zibby MCP Browser ready"
+
+# Install ffmpeg for video recording
+echo "🎬 Installing ffmpeg for video recording..."
+if command -v playwright &> /dev/null 2>&1; then
+  playwright install ffmpeg > /dev/null 2>&1 && echo "   ✅ ffmpeg installed" || echo "   ⚠️  Could not install ffmpeg"
+else
+  "$NPX_PATH" --yes playwright install ffmpeg > /dev/null 2>&1 && echo "   ✅ ffmpeg installed" || echo "   ⚠️  Could not install ffmpeg (will disable video)"
+fi
+
+# Step 4: Configure MCP
+echo "Configuring Zibby MCP Browser..."
+mkdir -p ~/.cursor
+
+# Default viewport size (can be overridden via env)
+VIEWPORT_WIDTH="${ZIBBY_VIEWPORT_WIDTH:-1280}"
+VIEWPORT_HEIGHT="${ZIBBY_VIEWPORT_HEIGHT:-720}"
+VIEWPORT_SIZE="${VIEWPORT_WIDTH}x${VIEWPORT_HEIGHT}"
+
+# Build MCP args array
+# --save-video is stripped by the Zibby wrapper before forwarding to @playwright/mcp,
+# but the wrapper reads the resolution from it to auto-start video recording.
+MCP_ARGS="\"--save-video=${VIEWPORT_SIZE}\", \"--viewport-size=${VIEWPORT_SIZE}\", \"--output-dir=test-results\""
+
+# Check if headless mode requested (default is headed)
+if [ "$ZIBBY_HEADLESS" = "1" ]; then
+  MCP_ARGS="$MCP_ARGS, \"--headless\""
+  echo "   Mode: Headless (hidden browser)"
+else
+  echo "   Mode: Headed (visible browser)"
+fi
+
+# Check if video recording requested (default is on)
+if [ "$ZIBBY_VIDEO" != "off" ]; then
+  echo "   Video: Enabled (${VIEWPORT_SIZE})"
+else
+  MCP_ARGS="\"--viewport-size=${VIEWPORT_SIZE}\", \"--output-dir=test-results\""
+  if [ "$ZIBBY_HEADLESS" = "1" ]; then
+    MCP_ARGS="$MCP_ARGS, \"--headless\""
+  fi
+  echo "   Video: Disabled"
+fi
+
+# Cloud sync is handled by the CLI/Studio directly (old mcp-server package removed).
+cat > ~/.cursor/mcp.json <<EOF
+{
+  "mcpServers": {
+    "playwright-official": {
+      "command": "$NODE_PATH",
+      "args": ["$ZIBBY_MCP_BIN", $MCP_ARGS],
+      "env": {
+        "PATH": "$NODE_BIN_DIR:/usr/bin:/bin:/usr/sbin:/sbin"
+      },
+      "description": "Zibby MCP Browser - Forked Playwright MCP with stable ID support"
+    }
+  }
+}
+EOF
+echo "   + Zibby MCP Browser (stable IDs + event recording)"
+
+# Step 5: Patch cursor-agent
+echo "Patching cursor-agent..."
+node "$SCRIPT_DIR/patch-cursor-mcp.js" > /dev/null 2>&1 || echo "   (patch may not be needed for your version)"
+
+# Step 6: Get approval key
+echo "🔑 Getting approval key..."
+APPROVAL_OUTPUT=$(cursor-agent mcp list 2>&1)
+
+APPROVAL_KEY_LINE=$(echo "$APPROVAL_OUTPUT" | grep "🔑 APPROVAL KEY.*playwright-official" | head -1)
+echo "$APPROVAL_KEY_LINE"
+
+APPROVAL_KEY=$(echo "$APPROVAL_KEY_LINE" | sed -E 's/.*=> ([^ ]+).*/\1/' | head -1)
+
+if [ -z "$APPROVAL_KEY" ]; then
+    APPROVAL_KEY=$(echo "$APPROVAL_OUTPUT" | grep -oE 'playwright-official-[a-f0-9]+' | head -1)
+fi
+
+if [ -z "$APPROVAL_KEY" ]; then
+    echo "⚠️ Could not auto-extract approval key"
+    echo "   This is OK for development - approval key only needed for CI/CD"
+    echo "   For CI/CD: Run 'cursor-agent mcp list' and save the key"
+else
+    # Step 7: Setup workspace approvals (only if we got the key)
+    echo "Configuring approvals..."
+    WORKSPACE_PATH="$PWD"
+    WORKSPACE_ENCODED=$(echo "$WORKSPACE_PATH" | sed 's|^/||' | sed 's|/|-|g')
+    APPROVAL_DIR="$HOME/.cursor/projects/$WORKSPACE_ENCODED"
+    APPROVAL_FILE="$APPROVAL_DIR/mcp-approvals.json"
+
+    mkdir -p "$APPROVAL_DIR"
+    cat > "$APPROVAL_FILE" <<EOF
+["$APPROVAL_KEY"]
+EOF
+    echo "Auto-approval configured for this workspace"
+fi
+
+echo ""
+echo "Zibby MCP Browser ready!"
+echo ""

package/scripts/test-with-video.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+
+# Run Playwright tests with video recording
+# Usage: ./scripts/test-with-video.sh [test-file] [headed]
+# 
+# Examples:
+#   ./scripts/test-with-video.sh tests/auth/login.spec.js
+#   ./scripts/test-with-video.sh tests/auth/login.spec.js headed
+
+TEST_FILE="${1:-tests/}"
+HEADED_FLAG=""
+
+if [ "$2" = "headed" ]; then
+  HEADED_FLAG="--headed"
+fi
+
+echo "🎥 Running Playwright tests with video recording..."
+echo "   Test: $TEST_FILE"
+echo "   Mode: $([ -n "$HEADED_FLAG" ] && echo "Headed (visible)" || echo "Headless")"
+echo ""
+
+# Run tests (video is configured in playwright.config.js)
+npx playwright test "$TEST_FILE" --project=chromium $HEADED_FLAG
+
+echo ""
+echo "✅ Tests complete!"
+echo ""
+echo "📂 Videos saved in: test-results/"
+echo ""
+
+# List videos if any were created
+if ls test-results/*/video.webm 2>/dev/null 1>&2; then
+  echo "🎬 Videos created:"
+  ls -lh test-results/*/video.webm
+  echo ""
+  echo "To view videos:"
+  echo "  1. Open Finder: open test-results/"
+  echo "  2. Or play directly:"
+  for video in test-results/*/video.webm; do
+    echo "     open \"$video\""
+  done
+else
+  echo "ℹ️  No videos found"
+  echo ""
+  echo "Video is configured in playwright.config.js:"
+  echo "  - video: 'on' (always record)"
+  echo "  - video: 'retain-on-failure' (only failed tests)"
+fi
+