shiplightai 0.1.63 → 0.1.64

package/dist/debugger-manager.d.ts

@@ -19,7 +19,7 @@ import { Duplex } from 'stream';
  * Design notes: see specs/004-testbox-debugger/research.md §1.
  */
 
-type SessionStatus = "starting" | "running" | "ended";
+type SessionStatus = "idle" | "starting" | "running" | "ended";
 interface DebuggerSession {
     /** URL-safe stable id for the lifetime of this session. */
     sessionId: string;
@@ -124,15 +124,25 @@ declare class DebuggerManager {
     private notifyStateChange;
     /**
      * Open a new debugger session for the given yaml path. If a session for
-     * the same absolute path already exists in `starting` or `running` status,
-     * returns the existing session (idempotent — satisfies FR-003). Otherwise
-     * allocates a free port, spawns the inner playwright process, waits up to
-     * 10s for its registration, and returns the ready session.
+     * the same absolute path already exists in a live status, returns the
+     * existing session (idempotent — satisfies FR-003).
      *
-     * Throws on spawn failure or registration timeout; caller surfaces the
-     * error (FR-019's "fails to start" state).
+     * The session starts in `"idle"` status — no Playwright process is
+     * spawned. Call `startSandbox(sessionId)` to launch the inner process
+     * on demand (e.g. when the user clicks "Start" in the debugger bar).
      */
-    openSession(yamlPath: string): Promise<DebuggerSession>;
+    openSession(yamlPath: string): DebuggerSession;
+    /**
+     * Spawn the inner Playwright process for an existing idle session.
+     * Idempotent — returns immediately if the sandbox is already running or
+     * starting. Throws on spawn failure; the session is left marked "ended".
+     */
+    startSandbox(sessionId: string): Promise<void>;
+    /**
+     * Kill the sandbox (inner Playwright process) but keep the session in
+     * the map so the user can re-start. Status transitions to `"idle"`.
+     */
+    stopSandbox(sessionId: string): Promise<void>;
     /**
      * Poll for inner-process liveness via its pid. When the pid is gone, flip
      * the session to "ended" so subsequent requests return 410 and the UI can

package/dist/debugger-manager.js

@@ -1,4 +1,4 @@
-import*as D from"http";import*as N from"net";import*as S from"path";import*as j from"fs";import{randomUUID as M}from"crypto";import*as y from"fs";import*as m from"path";import{spawn as A}from"child_process";import{parse as B}from"yaml";function O(l){let t=!1;return()=>{if(!t){t=!0;try{y.unlinkSync(l)}catch{}}}}function T(l){let t=["playwright.config.ts","playwright.config.js","playwright.config.mjs"],e=m.resolve(l);for(;;){for(let i of t){let n=m.join(e,i);if(y.existsSync(n))return n}let r=m.dirname(e);if(r===e)break;e=r}return null}function L(l,t,e,r){let i={...e},n=i.launchOptions?.args??[];return i.launchOptions={...i.launchOptions??{},args:[...n,"--remote-debugging-port=0"]},`// @generated by shiplightai \u2014 temporary debug test
+import*as N from"http";import*as j from"net";import*as y from"path";import*as D from"fs";import{randomUUID as M}from"crypto";import*as w from"fs";import*as m from"path";import{spawn as A}from"child_process";import{parse as B}from"yaml";function O(d){let s=!1;return()=>{if(!s){s=!0;try{w.unlinkSync(d)}catch{}}}}function $(d){let s=["playwright.config.ts","playwright.config.js","playwright.config.mjs"],e=m.resolve(d);for(;;){for(let i of s){let t=m.join(e,i);if(w.existsSync(t))return t}let n=m.dirname(e);if(n===e)break;e=n}return null}function L(d,s,e,n){let i={...e},t=i.launchOptions?.args??[];return i.launchOptions={...i.launchOptions??{},args:[...t,"--remote-debugging-port=0"]},`// @generated by shiplightai \u2014 temporary debug test
 import { test } from 'shiplightai/fixture';
 ${`
 test.use(${JSON.stringify(i)});
@@ -10,26 +10,26 @@ test('__shiplight_debug__', async ({ page, agent }) => {
   const { startPlaywrightDebugServer } = await import('shiplightai/debugger-pw');
 
   const server = await startPlaywrightDebugServer({
-    yamlFilePath: ${JSON.stringify(l)},
-    port: ${t},
+    yamlFilePath: ${JSON.stringify(d)},
+    port: ${s},
     page,
     agent,
-    projectRoot: ${JSON.stringify(r??null)},
+    projectRoot: ${JSON.stringify(n??null)},
   });
 
-  console.error('[debugger] Playwright sandbox ready on internal port ${t}');
+  console.error('[debugger] Playwright sandbox ready on internal port ${s}');
 
   // Keep alive until the server is closed externally (Ctrl+C kills the process)
   await new Promise(() => {});
 });
-`}async function U(l){let{createServer:t}=await import("net");for(let e=l;e<l+20;e++)if(await new Promise(i=>{let n=t();n.once("error",()=>i(!1)),n.once("listening",()=>{n.close(()=>i(!0))}),n.listen(e,"127.0.0.1")}))return e;throw new Error(`No available port found in range ${l}-${l+19}`)}async function E(l){let{yamlFilePath:t,configPath:e,tempSuffix:r="",headed:i}=l,n=m.dirname(e),d=await U(16174),s;if(!y.existsSync(t))throw new Error(`Please select a test file before starting the debug session. File not found: ${t}`);try{let a=B(y.readFileSync(t,"utf-8"));a?.use&&typeof a.use=="object"&&!Array.isArray(a.use)&&(s=a.use),a?.base_url&&!s?.baseURL&&(s={...s,baseURL:a.base_url}),a?.settings?.auto_dismiss_modal!==void 0&&(s={...s,autoDismissModal:!!a.settings.auto_dismiss_modal}),a?.settings?.browser_timezone!=null&&(s={...s,timezoneId:String(a.settings.browser_timezone)}),a?.settings?.browser_language!=null&&(s={...s,locale:String(a.settings.browser_language)}),a?.settings?.extra_http_headers!=null&&typeof a.settings.extra_http_headers=="object"&&(s={...s,extraHTTPHeaders:a.settings.extra_http_headers})}catch(a){console.error("[debugger] Could not parse YAML for `use` block:",a)}let u=m.dirname(m.resolve(t)),o=r?`-${r}`:"",g=m.join(u,`.__shiplight_debug__${o}.yaml.spec.ts`),h=L(t,d,s,n);y.writeFileSync(g,h);let p=O(g),P=["playwright","test",g,...i?["--headed"]:[]],c=A("npx",P,{stdio:["ignore","pipe","pipe"],shell:!0,cwd:n,env:{...process.env,PWDEBUG:"console",SHIPLIGHT_REGISTRY_URL:""}});c.stdout?.on("data",a=>{process.stderr.write(a)}),c.stderr?.on("data",a=>{process.stderr.write(a)});let f=()=>{c.killed||c.kill("SIGTERM")};process.on("SIGTERM",f),process.on("SIGINT",f),process.on("exit",f),c.on("close",a=>{process.removeListener("SIGTERM",f),process.removeListener("SIGINT",f),process.removeListener("exit",f),p(),a!==0&&a!==null&&console.error(`[debugger] Playwright process exited with code ${a}`)}),console.error("[debugger] Waiting for Playwright sandbox to start...");let x=["127.0.0.1","::1"];async function v(a){try{let b=a.includes(":")?`[${a}]`:a,_=await fetch(`http://${b}:${d}/api/test-flow`);if(_.ok){try{await _.text()}catch{}return!0}}catch{}return!1}let w=null;for(let a=0;a<180;a++){if(c.exitCode!==null)throw p(),new Error(`Playwright process exited with code ${c.exitCode} before sandbox was ready`);for(let b of x)if(await v(b)){w=b;break}if(w){console.error(`[debugger] Playwright sandbox ready on ${w}:${d}`);break}if(a===179)throw f(),p(),new Error("Timed out waiting for Playwright sandbox to start (180s)");await new Promise(b=>setTimeout(b,1e3))}if(!w)throw f(),p(),new Error("Sandbox poll finished without a reachable host");return{port:d,host:w,pid:c.pid??0,cleanup:async()=>{f(),p()}}}var R=1e4,I=class{sessions=new Map;byYamlPath=new Map;options;spawner;headed;constructor(t={}){this.options=t,this.spawner=t.spawner??E,this.headed=t.headed??!1}log(t){this.options.onLog?this.options.onLog(t):console.error(t)}notifyStateChange(t){try{this.options.onSessionStateChange?.({...t})}catch(e){this.log(`[manager] onSessionStateChange listener threw: ${e.message}`)}}async openSession(t){let e=S.resolve(t),r=this.byYamlPath.get(e);if(r){let o=this.sessions.get(r);if(o&&o.session.status!=="ended")return{...o.session};this.byYamlPath.delete(e)}if(!j.existsSync(e))throw new Error(`YAML file not found: ${e}`);let i=T(S.dirname(e));if(!i)throw new Error(`No Playwright config found for ${e} (searched parents for playwright.config.{ts,js,mjs}).`);let n=`dbg-${M().slice(0,8)}`,d=new Date().toISOString(),s={sessionId:n,yamlPath:e,innerPort:0,innerHost:"127.0.0.1",pid:0,startedAt:d,status:"starting",exitInfo:null},u={session:s,cleanup:async()=>{},readyPromise:Promise.resolve()};this.sessions.set(n,u),this.byYamlPath.set(e,n),this.notifyStateChange(s);try{let o=R+18e4,g,h=new Promise((c,f)=>{g=setTimeout(()=>f(new Error(`Timed out after ${o/1e3}s waiting for inner playwright to register on a port.`)),o)}),p;try{p=await Promise.race([this.spawner({yamlFilePath:e,configPath:i,tempSuffix:n,headed:this.headed}),h])}finally{g&&clearTimeout(g)}s.innerPort=p.port,s.innerHost=p.host,s.pid=p.pid,s.status="running",u.cleanup=p.cleanup;let P=c=>{s.status!=="ended"&&(s.status="ended",s.exitInfo=c,this.notifyStateChange(s))};return u.livenessTimer=this.startLivenessProbe(n,P),this.notifyStateChange(s),this.log(`[manager] session ${n} running on ${s.innerHost}:${s.innerPort} (yaml=${S.basename(e)})`),{...s}}catch(o){throw this.sessions.delete(n),this.byYamlPath.get(e)===n&&this.byYamlPath.delete(e),s.status="ended",s.exitInfo=o.message,this.notifyStateChange(s),o}}startLivenessProbe(t,e){let n=0,d=setInterval(()=>{let s=this.sessions.get(t);if(!s||s.session.status==="ended"){clearInterval(d);return}let u=!1;try{process.kill(s.session.pid,0),u=!0}catch(o){o?.code!=="ESRCH"&&(u=!0)}u?n=0:(n+=1,n>=3&&(clearInterval(d),e("process-exited")))},3e3);return d.unref(),d}async closeSession(t){let e=this.sessions.get(t);if(e){this.sessions.delete(t),this.byYamlPath.get(e.session.yamlPath)===t&&this.byYamlPath.delete(e.session.yamlPath),e.livenessTimer&&(clearInterval(e.livenessTimer),e.livenessTimer=void 0),e.session.status!=="ended"&&(e.session.status="ended",e.session.exitInfo="SIGTERM",this.notifyStateChange(e.session));try{await e.cleanup()}catch(r){this.log(`[manager] closeSession ${t} cleanup error: ${r.message}`)}}}async restartInner(t){let e=this.sessions.get(t);if(!e)throw new Error(`No session ${t} to restart`);if(e.restartInProgress)throw new Error(`Restart already in progress for session ${t}`);let r=e.session.yamlPath,i=T(S.dirname(r));if(!i)throw new Error(`No Playwright config found for ${r} (searched parents for playwright.config.{ts,js,mjs}).`);e.restartInProgress=!0;try{e.livenessTimer&&(clearInterval(e.livenessTimer),e.livenessTimer=void 0);try{await e.cleanup()}catch(o){this.log(`[manager] restartInner ${t} old cleanup error: ${o.message}`)}e.session.status="starting",e.session.innerPort=0,e.session.pid=0,this.notifyStateChange(e.session);let n=R+18e4,d,s=new Promise((o,g)=>{d=setTimeout(()=>g(new Error(`Timed out after ${n/1e3}s waiting for inner playwright to respawn.`)),n)}),u;try{u=await Promise.race([this.spawner({yamlFilePath:r,configPath:i,tempSuffix:t,headed:this.headed}),s])}catch(o){throw e.session.status="ended",e.session.exitInfo=o.message,this.notifyStateChange(e.session),o}finally{d&&clearTimeout(d)}e.session.innerPort=u.port,e.session.innerHost=u.host,e.session.pid=u.pid,e.session.status="running",e.cleanup=u.cleanup,e.livenessTimer=this.startLivenessProbe(t,o=>{e.session.status!=="ended"&&(e.session.status="ended",e.session.exitInfo=o,this.notifyStateChange(e.session))}),this.notifyStateChange(e.session),this.log(`[manager] session ${t} restarted on ${e.session.innerHost}:${e.session.innerPort} (yaml=${S.basename(r)})`)}finally{e.restartInProgress=!1}}listSessions(){return Array.from(this.sessions.values()).map(t=>({...t.session}))}getSession(t){let e=this.sessions.get(t);return e?{...e.session}:void 0}httpProxyFor(t,e={}){let{liveviewUrlBuilder:r}=e;return async(i,n,d)=>{let s=this.sessions.get(t);if(!s){n.status(404).json({status:"error",message:"Session not found"});return}if(s.session.status==="ended"){n.status(410).json({status:"error",message:"Session has ended",exitInfo:s.session.exitInfo});return}let u=`${i.method} ${i.path}`;if(u==="POST /api/int-runner/create-session"){let g=await H(i),h={};if(g.length)try{h=JSON.parse(g.toString("utf-8"))}catch{n.status(400).json({status:"error",message:"Invalid JSON body"});return}h.testFilePath=s.session.yamlPath,await C(i,n,s.session.innerHost,s.session.innerPort,Buffer.from(JSON.stringify(h),"utf-8"),"application/json");return}if(u==="POST /api/int-runner/terminate-session"){try{await this.restartInner(t),n.json({status:"success",details:"Session restarted"})}catch(g){n.status(500).json({status:"error",message:g.message})}return}if(u==="POST /api/int-runner/liveview-url"){let g=r?.(i)??"";n.json({liveviewUrl:g,browserWsUrl:""});return}let o=await H(i);await C(i,n,s.session.innerHost,s.session.innerPort,o,i.headers["content-type"])}}wsUpgradeFor(t){return async(e,r,i,n)=>{let d=this.sessions.get(t);if(!d){$(r,`HTTP/1.1 404 Not Found\r
+`}async function U(d){let{createServer:s}=await import("net");for(let e=d;e<d+20;e++)if(await new Promise(i=>{let t=s();t.once("error",()=>i(!1)),t.once("listening",()=>{t.close(()=>i(!0))}),t.listen(e,"127.0.0.1")}))return e;throw new Error(`No available port found in range ${d}-${d+19}`)}async function I(d){let{yamlFilePath:s,configPath:e,tempSuffix:n="",headed:i}=d,t=m.dirname(e),o=await U(16174),r;if(!w.existsSync(s))throw new Error(`Please select a test file before starting the debug session. File not found: ${s}`);try{let l=B(w.readFileSync(s,"utf-8"));l?.use&&typeof l.use=="object"&&!Array.isArray(l.use)&&(r=l.use),l?.base_url&&!r?.baseURL&&(r={...r,baseURL:l.base_url}),l?.settings?.auto_dismiss_modal!==void 0&&(r={...r,autoDismissModal:!!l.settings.auto_dismiss_modal}),l?.settings?.browser_timezone!=null&&(r={...r,timezoneId:String(l.settings.browser_timezone)}),l?.settings?.browser_language!=null&&(r={...r,locale:String(l.settings.browser_language)}),l?.settings?.extra_http_headers!=null&&typeof l.settings.extra_http_headers=="object"&&(r={...r,extraHTTPHeaders:l.settings.extra_http_headers})}catch(l){console.error("[debugger] Could not parse YAML for `use` block:",l)}let u=m.dirname(m.resolve(s)),a=n?`-${n}`:"",g=m.join(u,`.__shiplight_debug__${a}.yaml.spec.ts`),p=L(s,o,r,t);w.writeFileSync(g,p);let h=O(g),v=["playwright","test",g,...i?["--headed"]:[]],c=A("npx",v,{stdio:["ignore","pipe","pipe"],shell:!0,cwd:t,env:{...process.env,PWDEBUG:"console",SHIPLIGHT_REGISTRY_URL:""}});c.stdout?.on("data",l=>{process.stderr.write(l)}),c.stderr?.on("data",l=>{process.stderr.write(l)});let f=()=>{c.killed||c.kill("SIGTERM")};process.on("SIGTERM",f),process.on("SIGINT",f),process.on("exit",f),c.on("close",l=>{process.removeListener("SIGTERM",f),process.removeListener("SIGINT",f),process.removeListener("exit",f),h(),l!==0&&l!==null&&console.error(`[debugger] Playwright process exited with code ${l}`)}),console.error("[debugger] Waiting for Playwright sandbox to start...");let x=["127.0.0.1","::1"];async function b(l){try{let P=l.includes(":")?`[${l}]`:l,_=await fetch(`http://${P}:${o}/api/test-flow`);if(_.ok){try{await _.text()}catch{}return!0}}catch{}return!1}let S=null;for(let l=0;l<180;l++){if(c.exitCode!==null)throw h(),new Error(`Playwright process exited with code ${c.exitCode} before sandbox was ready`);for(let P of x)if(await b(P)){S=P;break}if(S){console.error(`[debugger] Playwright sandbox ready on ${S}:${o}`);break}if(l===179)throw f(),h(),new Error("Timed out waiting for Playwright sandbox to start (180s)");await new Promise(P=>setTimeout(P,1e3))}if(!S)throw f(),h(),new Error("Sandbox poll finished without a reachable host");return{port:o,host:S,pid:c.pid??0,cleanup:async()=>{f(),h()}}}var R=1e4,E=class{sessions=new Map;byYamlPath=new Map;options;spawner;headed;constructor(s={}){this.options=s,this.spawner=s.spawner??I,this.headed=s.headed??!1}log(s){this.options.onLog?this.options.onLog(s):console.error(s)}notifyStateChange(s){try{this.options.onSessionStateChange?.({...s})}catch(e){this.log(`[manager] onSessionStateChange listener threw: ${e.message}`)}}openSession(s){let e=y.resolve(s),n=this.byYamlPath.get(e);if(n){let a=this.sessions.get(n);if(a&&a.session.status!=="ended")return{...a.session};this.byYamlPath.delete(e)}if(!D.existsSync(e))throw new Error(`YAML file not found: ${e}`);if(!$(y.dirname(e)))throw new Error(`No Playwright config found for ${e} (searched parents for playwright.config.{ts,js,mjs}).`);let t=`dbg-${M().slice(0,8)}`,o=new Date().toISOString(),r={sessionId:t,yamlPath:e,innerPort:0,innerHost:"127.0.0.1",pid:0,startedAt:o,status:"idle",exitInfo:null},u={session:r,cleanup:async()=>{},readyPromise:Promise.resolve()};return this.sessions.set(t,u),this.byYamlPath.set(e,t),this.notifyStateChange(r),this.log(`[manager] session ${t} created (idle) for ${y.basename(e)}`),{...r}}async startSandbox(s){let e=this.sessions.get(s);if(!e)throw new Error(`No session ${s} to start sandbox for`);if(e.session.status==="running"||e.session.status==="starting"){e.readyPromise&&await e.readyPromise;return}if(e.session.status==="ended")throw new Error(`Session ${s} has ended`);let n=e.session.yamlPath,i=$(y.dirname(n));if(!i)throw new Error(`No Playwright config found for ${n} (searched parents for playwright.config.{ts,js,mjs}).`);e.session.status="starting",this.notifyStateChange(e.session);let t=(async()=>{let o=R+18e4,r,u=new Promise((p,h)=>{r=setTimeout(()=>h(new Error(`Timed out after ${o/1e3}s waiting for inner playwright to register on a port.`)),o)}),a;try{a=await Promise.race([this.spawner({yamlFilePath:n,configPath:i,tempSuffix:s,headed:this.headed}),u])}finally{r&&clearTimeout(r)}e.session.innerPort=a.port,e.session.innerHost=a.host,e.session.pid=a.pid,e.session.status="running",e.cleanup=a.cleanup;let g=p=>{e.session.status!=="ended"&&(e.session.status="ended",e.session.exitInfo=p,this.notifyStateChange(e.session))};e.livenessTimer=this.startLivenessProbe(s,g),this.notifyStateChange(e.session),this.log(`[manager] session ${s} running on ${e.session.innerHost}:${e.session.innerPort} (yaml=${y.basename(n)})`)})();e.readyPromise=t;try{await t}catch(o){throw e.session.status="ended",e.session.exitInfo=o.message,this.notifyStateChange(e.session),o}}async stopSandbox(s){let e=this.sessions.get(s);if(e&&e.session.status!=="idle"&&e.session.status!=="ended"){this.log(`[manager] stopSandbox ${s}`),e.livenessTimer&&(clearInterval(e.livenessTimer),e.livenessTimer=void 0);try{await e.cleanup()}catch(n){this.log(`[manager] stopSandbox ${s} cleanup error: ${n.message}`)}e.session.innerPort=0,e.session.innerHost="127.0.0.1",e.session.pid=0,e.session.status="idle",e.session.exitInfo=null,e.cleanup=async()=>{},e.readyPromise=Promise.resolve(),this.notifyStateChange(e.session)}}startLivenessProbe(s,e){let t=0,o=setInterval(()=>{let r=this.sessions.get(s);if(!r||r.session.status==="ended"){clearInterval(o);return}let u=!1;try{process.kill(r.session.pid,0),u=!0}catch(a){a?.code!=="ESRCH"&&(u=!0)}u?t=0:(t+=1,t>=3&&(clearInterval(o),e("process-exited")))},3e3);return o.unref(),o}async closeSession(s){let e=this.sessions.get(s);if(e){this.log(`[manager] closeSession ${s} (status=${e.session.status})`),this.sessions.delete(s),this.byYamlPath.get(e.session.yamlPath)===s&&this.byYamlPath.delete(e.session.yamlPath),e.livenessTimer&&(clearInterval(e.livenessTimer),e.livenessTimer=void 0),e.session.status!=="ended"&&(e.session.status="ended",e.session.exitInfo="SIGTERM",this.notifyStateChange(e.session));try{await e.cleanup()}catch(n){this.log(`[manager] closeSession ${s} cleanup error: ${n.message}`)}}}async restartInner(s){let e=this.sessions.get(s);if(!e)throw new Error(`No session ${s} to restart`);if(e.restartInProgress)throw new Error(`Restart already in progress for session ${s}`);let n=e.session.yamlPath,i=$(y.dirname(n));if(!i)throw new Error(`No Playwright config found for ${n} (searched parents for playwright.config.{ts,js,mjs}).`);e.restartInProgress=!0;try{e.livenessTimer&&(clearInterval(e.livenessTimer),e.livenessTimer=void 0);try{await e.cleanup()}catch(a){this.log(`[manager] restartInner ${s} old cleanup error: ${a.message}`)}e.session.status="starting",e.session.innerPort=0,e.session.pid=0,this.notifyStateChange(e.session);let t=R+18e4,o,r=new Promise((a,g)=>{o=setTimeout(()=>g(new Error(`Timed out after ${t/1e3}s waiting for inner playwright to respawn.`)),t)}),u;try{u=await Promise.race([this.spawner({yamlFilePath:n,configPath:i,tempSuffix:s,headed:this.headed}),r])}catch(a){throw e.session.status="ended",e.session.exitInfo=a.message,this.notifyStateChange(e.session),a}finally{o&&clearTimeout(o)}e.session.innerPort=u.port,e.session.innerHost=u.host,e.session.pid=u.pid,e.session.status="running",e.cleanup=u.cleanup,e.livenessTimer=this.startLivenessProbe(s,a=>{e.session.status!=="ended"&&(e.session.status="ended",e.session.exitInfo=a,this.notifyStateChange(e.session))}),this.notifyStateChange(e.session),this.log(`[manager] session ${s} restarted on ${e.session.innerHost}:${e.session.innerPort} (yaml=${y.basename(n)})`)}finally{e.restartInProgress=!1}}listSessions(){return Array.from(this.sessions.values()).map(s=>({...s.session}))}getSession(s){let e=this.sessions.get(s);return e?{...e.session}:void 0}httpProxyFor(s,e={}){let{liveviewUrlBuilder:n}=e;return async(i,t,o)=>{let r=this.sessions.get(s);if(!r){t.status(404).json({status:"error",message:"Session not found"});return}if(r.session.status==="ended"){t.status(410).json({status:"error",message:"Session has ended",exitInfo:r.session.exitInfo});return}if(r.session.status==="idle"){t.status(503).json({status:"error",message:"Sandbox not started"});return}let u=`${i.method} ${i.path}`;if(u==="POST /api/int-runner/create-session"){let g=await H(i),p={};if(g.length)try{p=JSON.parse(g.toString("utf-8"))}catch{t.status(400).json({status:"error",message:"Invalid JSON body"});return}p.testFilePath=r.session.yamlPath,await C(i,t,r.session.innerHost,r.session.innerPort,Buffer.from(JSON.stringify(p),"utf-8"),"application/json");return}if(u==="POST /api/int-runner/terminate-session"){try{await this.stopSandbox(s),t.json({status:"success",details:"Sandbox stopped"})}catch(g){t.status(500).json({status:"error",message:g.message})}return}if(u==="POST /api/int-runner/liveview-url"){let g=n?.(i)??"";t.json({liveviewUrl:g,browserWsUrl:""});return}let a=await H(i);await C(i,t,r.session.innerHost,r.session.innerPort,a,i.headers["content-type"])}}wsUpgradeFor(s){return async(e,n,i,t)=>{let o=this.sessions.get(s);if(!o){T(n,`HTTP/1.1 404 Not Found\r
 \r
-`);return}if(d.session.status==="ended"){$(r,`HTTP/1.1 410 Gone\r
+`);return}if(o.session.status==="ended"){T(n,`HTTP/1.1 410 Gone\r
 \r
-`);return}try{let s=d.session.innerHost.includes(":")?`[${d.session.innerHost}]`:d.session.innerHost,u=await fetch(`http://${s}:${d.session.innerPort}/api/browser-cdp`);if(!u.ok)throw new Error(`Inner /api/browser-cdp returned ${u.status}`);let{cdpUrl:o}=await u.json(),g=new URL(o.replace(/^ws/,"http")),h=parseInt(g.port||"80",10),p=g.hostname,P=g.pathname;n&&n.startsWith("/page/")&&(P=`/devtools${n}`);let c=N.createConnection(h,p);c.on("connect",()=>{let f=`GET ${P} HTTP/1.1\r
-Host: ${p}:${h}\r
-`;for(let[x,v]of Object.entries(e.headers)){let w=x.toLowerCase();w!=="host"&&w!=="origin"&&(f+=`${x}: ${Array.isArray(v)?v.join(", "):v}\r
+`);return}try{let r=o.session.innerHost.includes(":")?`[${o.session.innerHost}]`:o.session.innerHost,u=await fetch(`http://${r}:${o.session.innerPort}/api/browser-cdp`);if(!u.ok)throw new Error(`Inner /api/browser-cdp returned ${u.status}`);let{cdpUrl:a}=await u.json(),g=new URL(a.replace(/^ws/,"http")),p=parseInt(g.port||"80",10),h=g.hostname,v=g.pathname;t&&t.startsWith("/page/")&&(v=`/devtools${t}`);let c=j.createConnection(p,h);c.on("connect",()=>{let f=`GET ${v} HTTP/1.1\r
+Host: ${h}:${p}\r
+`;for(let[x,b]of Object.entries(e.headers)){let S=x.toLowerCase();S!=="host"&&S!=="origin"&&(f+=`${x}: ${Array.isArray(b)?b.join(", "):b}\r
 `)}f+=`\r
-`,c.write(f),i.length&&c.write(i),c.pipe(r),r.pipe(c)}),c.on("error",()=>{(!("destroyed"in r)||!r.destroyed)&&r.destroy()}),r.on("error",()=>{c.destroyed||c.destroy()}),r.on("close",()=>{c.destroyed||c.destroy()})}catch(s){this.log(`[manager] WS upgrade for ${t} failed: ${s.message}`),$(r,`HTTP/1.1 502 Bad Gateway\r
+`,c.write(f),i.length&&c.write(i),c.pipe(n),n.pipe(c)}),c.on("error",()=>{(!("destroyed"in n)||!n.destroyed)&&n.destroy()}),n.on("error",()=>{c.destroyed||c.destroy()}),n.on("close",()=>{c.destroyed||c.destroy()})}catch(r){this.log(`[manager] WS upgrade for ${s} failed: ${r.message}`),T(n,`HTTP/1.1 502 Bad Gateway\r
 \r
-`)}}}async shutdown(){let t=Array.from(this.sessions.keys());await Promise.allSettled(t.map(e=>this.closeSession(e)))}};function H(l){return new Promise((t,e)=>{if(l.body&&typeof l.body=="object")try{t(Buffer.from(JSON.stringify(l.body),"utf-8"));return}catch{}if(l.readableEnded){t(Buffer.alloc(0));return}let r=[];l.on("data",i=>r.push(i)),l.on("end",()=>t(Buffer.concat(r))),l.on("error",e)})}function C(l,t,e,r,i,n){return new Promise(d=>{let s=Array.isArray(n)?n[0]:n,u=D.request({hostname:e,port:r,path:l.originalUrl,method:l.method,headers:{"content-type":s||"application/json","content-length":String(i.length)},timeout:3e5},o=>{t.writeHead(o.statusCode??502,o.headers),o.on("data",g=>t.write(g)),o.on("end",()=>{t.end(),d()}),o.on("error",()=>{t.writableEnded||t.end(),d()})});u.on("error",o=>{t.headersSent?t.writableEnded||t.end():t.status(502).json({status:"error",message:"Inner server unavailable: "+o.message}),d()}),u.end(i)})}function $(l,t){try{(!("destroyed"in l)||!l.destroyed)&&(l.write(t),l.destroy())}catch{}}export{I as DebuggerManager};
+`)}}}async shutdown(){let s=Array.from(this.sessions.keys());await Promise.allSettled(s.map(e=>this.closeSession(e)))}};function H(d){return new Promise((s,e)=>{if(d.body&&typeof d.body=="object")try{s(Buffer.from(JSON.stringify(d.body),"utf-8"));return}catch{}if(d.readableEnded){s(Buffer.alloc(0));return}let n=[];d.on("data",i=>n.push(i)),d.on("end",()=>s(Buffer.concat(n))),d.on("error",e)})}function C(d,s,e,n,i,t){return new Promise(o=>{let r=Array.isArray(t)?t[0]:t,u=N.request({hostname:e,port:n,path:d.originalUrl,method:d.method,headers:{"content-type":r||"application/json","content-length":String(i.length)},timeout:3e5},a=>{s.writeHead(a.statusCode??502,a.headers),a.on("data",g=>s.write(g)),a.on("end",()=>{s.end(),o()}),a.on("error",()=>{s.writableEnded||s.end(),o()})});u.on("error",a=>{s.headersSent?s.writableEnded||s.end():s.status(502).json({status:"error",message:"Inner server unavailable: "+a.message}),o()}),u.end(i)})}function T(d,s){try{(!("destroyed"in d)||!d.destroyed)&&(d.write(s),d.destroy())}catch{}}export{E as DebuggerManager};

package/dist/debugger-pw.d.ts

@@ -60,10 +60,18 @@ interface SandboxService {
         usePureVision?: boolean;
         includeDebugInfo?: boolean;
     }): Promise<any>;
-    takeScreenshot(sessionId: string): Promise<{
+    takeScreenshot(sessionId: string, stepId?: string): Promise<{
         screenshot: string;
         screenshotPath?: string;
     }>;
+    /** Return accumulated artifacts (screenshots) from the current session. */
+    getSessionArtifacts?(sessionId: string): {
+        outputDir?: string;
+        screenshots: Array<{
+            stepId: string;
+            path: string;
+        }>;
+    };
     startRecorder(sessionId: string, onEvent: (event: any) => void, testIdAttributeName?: string): Promise<void>;
     stopRecorder(sessionId: string): Promise<void>;
 }
@@ -90,6 +98,9 @@ declare class PlaywrightSandboxService implements SandboxService {
     private abortController;
     private recorderStopResolver?;
     private recorderEnabled;
+    private screenshotHistory;
+    private yamlFilePath?;
+    private artifactsDir?;
     constructor(page: Page, agent: WebAgent, fixturesDir?: string, projectRoot?: string);
     private cdpEndpoint;
     setCdpEndpoint(url: string): void;
@@ -133,10 +144,17 @@ declare class PlaywrightSandboxService implements SandboxService {
         usePureVision?: boolean;
         includeDebugInfo?: boolean;
     }): Promise<ActionGenerationResponse>;
-    takeScreenshot(_sessionId: string): Promise<{
+    takeScreenshot(_sessionId: string, stepId?: string): Promise<{
         screenshot: string;
         screenshotPath?: string;
     }>;
+    getSessionArtifacts(_sessionId: string): {
+        outputDir?: string;
+        screenshots: Array<{
+            stepId: string;
+            path: string;
+        }>;
+    };
     startRecorder(_sessionId: string, onEvent: (event: any) => void, testIdAttributeName?: string): Promise<void>;
     stopRecorder(_sessionId: string): Promise<void>;
     terminateSession(_sessionId: string): Promise<void>;