@thomas.f/prnext 0.1.16-alpha → 0.1.17-alpha

package/runtime/dev-tools-server.mjs

@@ -0,0 +1,256 @@
+import {createServer} from 'node:http';
+import {randomBytes,timingSafeEqual,randomUUID} from 'node:crypto';
+import {open,lstat,realpath,rename,rm,readFile,mkdir} from 'node:fs/promises';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const object={type:'object',additionalProperties:false,properties:{}};
+const pathProperty={type:'string',maxLength:1024,description:'Local pathname, without a host.'};
+const sourceProperties={file:{type:'string',maxLength:2048},source:{type:'string',maxLength:2048},url:{type:'string',maxLength:4096},stack:{type:'string',maxLength:16000},line:{type:'integer',minimum:1},column:{type:'integer',minimum:1},error:{type:'object'},editor:{type:'string',enum:['vscode','cursor']}};
+/** Shared by the local stdio adapter and the optional existing Host MCP relay. */
+export const devToolDefinitions=[
+  {name:'dev_snapshot',description:'Current local development generation, errors, browser confirmations, logs, routes and measured build timings.',inputSchema:object},
+  {name:'dev_connection',description:'Actual local AI connection activity and stdio setup for this project.',inputSchema:object},
+  {name:'dev_logs',description:'Bounded, redacted development server/browser logs and request timings.',inputSchema:{...object,properties:{source:{type:'string',enum:['server','browser','all']},level:{type:'string'},limit:{type:'integer',minimum:1,maximum:500}}}},
+  {name:'dev_routes',description:'Discovered routes and which routes are currently compiled.',inputSchema:object},
+  {name:'dev_route_ensure',description:'Compile a local development pathname on demand. Does not navigate a browser.',inputSchema:{...object,properties:{path:pathProperty},required:['path']}},
+  {name:'dev_cache_invalidate',description:'Expire native data/page cache entries associated with one local route. Preserves unrelated entries, the running development generation, persistent transform caches and project files.',inputSchema:{...object,properties:{path:pathProperty},required:['path']}},
+  {name:'dev_verify',description:'Wait for a NEW ready generation after sinceSequence AND a browser confirmation of that exact generation. Missing browser evidence is inconclusive, never success.',inputSchema:{...object,properties:{path:pathProperty,sinceSequence:{type:'integer',minimum:0},clientId:{type:'string',maxLength:100},timeoutMs:{type:'integer',minimum:100,maximum:30000}}}},
+  {name:'dev_ai_context',description:'Queue selected element or error context for the connected local assistant. Does not claim the assistant has acted.',inputSchema:{...object,properties:{kind:{type:'string',maxLength:32},context:{type:'object'},prompt:{type:'string',maxLength:4000}}}},
+  {name:'dev_source',description:'Resolve a project source location and a small code frame. Secret and external files are excluded.',inputSchema:{...object,properties:sourceProperties}},
+  {name:'dev_open_editor',description:'Validate a project source location and return an editor deep link. Never runs a shell.',inputSchema:{...object,properties:sourceProperties}},
+];
+
+export function redactDevText(value,limit=16000){
+  return String(value??'').replace(/\u001b\[[0-?]*[ -/]*[@-~]/g,'')
+    .replace(/\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9_]+\b/g,'[redacted key]')
+    .replace(/\b(?:Bearer|Basic)\s+[A-Za-z0-9+/_=.-]{8,}/gi,'[redacted authorization]')
+    .replace(/((?:password|passwd|secret|token|api[_-]?key|authorization|cookie)\s*[=:]\s*)(?:"[^"\n]*"|'[^'\n]*'|[^\s,;]+)/gi,'$1[redacted]')
+    .replace(/(https?:\/\/)[^/@\s:]+:[^/@\s]+@/g,'$1[redacted]@')
+    .slice(0,limit);
+}
+export function devPath(value='/'){
+  if(typeof value!=='string'||value.length>1024||!value.startsWith('/')||value.startsWith('//')||/[\u0000-\u001f\\]/.test(value))throw Error('A local pathname is required');
+  return new URL(value,'http://local').pathname;
+}
+function requestPath(value){
+  if(typeof value!=='string'||value.length>2048||/[\u0000-\u001f\\]/.test(value))return '[unavailable]';
+  if(value.startsWith('/')&&!value.startsWith('//'))return devPath(value);
+  try{const url=new URL(value);if(!['http:','https:'].includes(url.protocol))return '[unavailable]';return url.origin+url.pathname;}catch{return '[unavailable]';}
+}
+const boundedArray=(value,max)=>Array.isArray(value)?value.slice(-max):[];
+const text=(value,max=256)=>redactDevText(value,max);
+const number=value=>Number.isFinite(value)?value:undefined;
+const plain=value=>value&&typeof value==='object'&&!Array.isArray(value);
+function limitedContext(value,capability){
+  let serialized;try{serialized=JSON.stringify(value??{});}catch{throw Error('Context must be JSON');}
+  if(Buffer.byteLength(serialized)>400*1024)throw Error('Context is too large');
+  const clean=(item,depth=0)=>{
+    if(depth>10)return '[depth limit]';
+    if(typeof item==='string'){const result=redactDevText(item,16000);return capability?result.replaceAll(capability,'[redacted capability]'):result;}
+    if(Array.isArray(item))return item.slice(0,100).map(entry=>clean(entry,depth+1));
+    if(item&&typeof item==='object'){
+      if(item.mimeType==='image/png'&&typeof item.data==='string'){
+        if(item.data.length>350000||!/^[A-Za-z0-9+/]+={0,2}$/.test(item.data)||!Buffer.from(item.data,'base64').subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])))throw Error('Screenshot must be a PNG no larger than 256 KiB');
+        return {mimeType:'image/png',data:item.data,width:number(item.width),height:number(item.height)};
+      }
+      return Object.fromEntries(Object.entries(item).slice(0,100).map(([key,entry])=>[key,/password|secret|token|authorization|cookie|api.?key/i.test(key)?'[redacted]':clean(entry,depth+1)]));
+    }
+    return item;
+  };
+  return clean(JSON.parse(serialized));
+}
+function validArguments(name,args){
+  const definition=devToolDefinitions.find(item=>item.name===name);if(!definition)throw Error('Unknown development tool');
+  if(!plain(args))throw Error('Arguments must be an object');
+  for(const key of Object.keys(args))if(!Object.hasOwn(definition.inputSchema.properties,key))throw Error('Unknown argument: '+key);
+  for(const key of definition.inputSchema.required||[])if(!Object.hasOwn(args,key))throw Error('Missing argument: '+key);
+  for(const [key,value] of Object.entries(args)){
+    const schema=definition.inputSchema.properties[key];
+    if(schema.type==='string'&&(typeof value!=='string'||value.length>(schema.maxLength||4096)))throw Error('Invalid '+key);
+    if(schema.type==='integer'&&(!Number.isSafeInteger(value)||value<(schema.minimum??0)||value>(schema.maximum??Number.MAX_SAFE_INTEGER)))throw Error('Invalid '+key);
+    if(schema.type==='object'&&!plain(value))throw Error('Invalid '+key);
+    if(schema.enum&&!schema.enum.includes(value))throw Error('Invalid '+key);
+  }
+}
+
+export async function createDevToolsServer({root,session=randomUUID(),snapshot=()=>({}),ensureRoute,invalidateRoute,sourceTools,collectMetrics,now=Date.now}={}){
+  root=await realpath(root);
+  if(!/^[\w-]{1,100}$/.test(session))throw Error('Invalid development session');
+  const token=randomBytes(32).toString('base64url'),tokenBytes=Buffer.from(token),origins=new Set(),browsers=new Map(),assistants=new Map(),serverLogs=[],requests=[],builds=[],contexts=[];
+  const assistantLeaseMs=30000;
+  const safeText=(value,max=256)=>text(value,max).replaceAll(token,'[redacted capability]');
+  const discoveryDirectory=path.join(root,'.prnext-dev'),discoveryFile=path.join(discoveryDirectory,'tools.json');
+  let endpoint,closed=false,logId=0,lastActivity=null,lastClient=null,appUrl=null,discoveryOwned=false,inFlight=0,hostRelayState={enabled:false,linked:false};
+  const envelope=value=>({version:1,session,...value});
+  const prune=()=>{for(const [id,client] of browsers)if(now()-client.lastSeen>45000)browsers.delete(id);for(const [id,client] of assistants)if(client.expiresAt<=now())assistants.delete(id);};
+  function connection(){
+    prune();const live=[...assistants.values()].sort((a,b)=>b.lastSeen-a.lastSeen),recent=lastActivity!==null&&now()-lastActivity<60000,latest=live[0];
+    return {connected:live.length>0||recent,initialized:live.length>0,lastActivity:lastActivity??latest?.initializedAt??null,client:recent?lastClient:latest?.client??null,
+      clients:live.map(({client,initializedAt,lastSeen})=>({client,initializedAt,lastSeen})),hostRelay:{...hostRelayState},mcp:{command:process.execPath,args:[fileURLToPath(new URL('../cli.mjs',import.meta.url)),'mcp',root]},endpoint:appUrl};
+  }
+  function assistantEvent(body){
+    prune();
+    if(!plain(body)||!['register','heartbeat','unregister'].includes(body.event)||typeof body.instanceId!=='string'||!/^[\w-]{16,100}$/.test(body.instanceId))throw Error('Invalid assistant lifecycle event');
+    const allowed=body.event==='register'?['event','instanceId','client']:['event','instanceId','leaseId'];
+    if(Object.keys(body).some(key=>!allowed.includes(key)))throw Error('Unknown assistant lifecycle field');
+    if(body.event==='register'){
+      if(typeof body.client!=='string'||!body.client.trim()||body.client.length>100||/[\u0000-\u001f\u007f]/.test(body.client))throw Error('Invalid assistant client');
+      let client=assistants.get(body.instanceId);
+      if(!client){if(assistants.size>=16)throw Object.assign(Error('Too many initialized assistants'),{code:'assistant_limit',status:429});client={leaseId:randomBytes(24).toString('base64url'),client:safeText(body.client,100),initializedAt:now()};assistants.set(body.instanceId,client);}
+      client.lastSeen=now();client.expiresAt=now()+assistantLeaseMs;
+      return envelope({leaseId:client.leaseId,leaseMs:assistantLeaseMs});
+    }
+    const client=assistants.get(body.instanceId);
+    if(!client&&body.event==='unregister')return envelope({accepted:true});
+    if(!client||typeof body.leaseId!=='string'||client.leaseId!==body.leaseId)throw Object.assign(Error('Assistant lease expired; initialize again'),{code:'assistant_lease_expired',status:404});
+    if(body.event==='unregister')assistants.delete(body.instanceId);
+    else {client.lastSeen=now();client.expiresAt=now()+assistantLeaseMs;}
+    return envelope({accepted:true,leaseMs:assistantLeaseMs});
+  }
+  function routes(){return boundedArray(snapshot().routes,2000).map(route=>typeof route==='string'?{path:text(route,1024)}:{path:text(route.path,1024),kind:text(route.kind,40),source:route.source?text(route.source,512):undefined,compiled:!!route.compiled,pinned:!!route.pinned});}
+  function compact(value){
+    // Keep a single tool response below the Host relay's 512 KiB envelope.
+    // Explicit counts disclose trimming; never cut an image or JSON string.
+    const shortened={};
+    const lists=[['serverLogs',value.serverLogs],['requests',value.requests],['builds',value.builds],['routes',value.routes],['logs',value.logs],['browsers',value.browsers]];
+    for(const [name,list] of lists)if(list)shortened[name]=list.length;
+    const large=()=>Buffer.byteLength(JSON.stringify(value))>470*1024;
+    for(const [name,list] of lists){if(!Array.isArray(list))continue;while(list.length>1&&large())list.splice(0,Math.ceil(list.length/2));if(list.length!==shortened[name])(value.truncated??={})[name]={returned:list.length,total:shortened[name]};}
+    if(large()&&value.ai?.contexts?.length>1)value.ai.contexts=value.ai.contexts.slice(-1);
+    return value;
+  }
+  function view(){
+    prune();const state=snapshot();
+    return compact(envelope({...state,error:state.error?safeText(state.error,8000):undefined,typeErrors:boundedArray(state.typeErrors,30).map(value=>safeText(value,4000)),serverLogs:[...serverLogs],requests:[...requests],builds:[...builds],routes:routes(),cache:state.cache||{},ai:{...connection(),contexts:[...contexts]},browsers:[...browsers.values()].map(({seenLogs,logs,...client})=>({...client,errors:client.errors?.slice(-10).map(error=>({...error,message:safeText(error.message,2000),stack:undefined})),selection:undefined}))}));
+  }
+  function addServerLog(level,value,extra={}){
+    const content=safeText(value,16000);if(!content.trim())return;
+    if(!extra.structuredLevel){
+      if(/^(?:\(node:\d+\)\s+)?(?:\[[^\]]+\]\s+)?\w*Warning:/.test(content))level='warn';
+      else if(/^\(Use .+--trace-warnings/.test(content))level='info';
+      else if(/^\d{4}-\d{2}-\d{2}T\S+\s+(ERROR|INFO|DEBUG|TRACE|WARN)\b/.test(content))level=/\sERROR\b/.test(content)?'error':/\sWARN\b/.test(content)?'warn':'info';
+    }
+    serverLogs.push({id:++logId,time:now(),level:['error','warn','info','log','debug','trace'].includes(level)?level:'info',text:content.replaceAll(token,'[redacted capability]'),source:'server',...extra});if(serverLogs.length>300)serverLogs.splice(0,serverLogs.length-300);
+  }
+  function recordBuild(value){builds.push({...value});if(builds.length>40)builds.shift();}
+  function recordRequest(item){
+    if(!plain(item))return;
+    requests.push({id:++logId,originalId:item.id,clientId:item.clientId,source:item.source==='server'?'server':'browser',time:number(item.time)||now(),path:requestPath(item.path||'/'),route:item.route?requestPath(item.route):undefined,method:text(item.method||'GET',12),status:number(item.status),duration:number(item.duration),kind:text(item.kind||'fetch',20),buildId:item.buildId,failed:!!item.failed,error:item.error?text(item.error,200):undefined});
+    if(requests.length>300)requests.shift();
+  }
+  function browserEvent(body){
+    if(!plain(body)||body.session!==session||typeof body.clientId!=='string'||!/^[\w-]{1,100}$/.test(body.clientId))throw Error('Invalid browser session');
+    if(!['heartbeat','applied','errors','request','selection','reload'].includes(body.kind))throw Error('Invalid browser event');
+    prune();let client=browsers.get(body.clientId);
+    if(!client){if(browsers.size>=8)browsers.delete(browsers.keys().next().value);client={clientId:body.clientId,seenLogs:new Set(),logs:[]};browsers.set(body.clientId,client);}
+    client.lastSeen=now();client.path=devPath(body.path||'/');
+    client.buildId=text(body.buildId,128);client.sequence=Number.isSafeInteger(body.sequence)?body.sequence:0;
+    if(body.kind==='applied'&&body.hydrated===true&&body.building!==true)client.applied={buildId:client.buildId,sequence:client.sequence,time:now()};
+    if(body.kind==='reload'){client.applied=undefined;client.reloadReason=text(body.reason||'Full reload required',256);client.reloadAt=now();}
+    client.issues=Number.isSafeInteger(body.issues)?Math.max(0,body.issues):0;client.building=body.building===true;
+    if(Number.isSafeInteger(body.droppedLogs)&&body.droppedLogs>=0)client.droppedLogs=Math.max(client.droppedLogs||0,body.droppedLogs);
+    if(Array.isArray(body.errors))client.errors=body.errors.slice(0,30).map(error=>typeof error==='string'?{message:safeText(error,8000),time:now()}:{name:safeText(error?.name,128),message:safeText(error?.message||error?.text,8000),stack:safeText(error?.stack,16000),time:number(error?.time)||now()});
+    for(const log of boundedArray(body.logs,100)){
+      if(!plain(log))continue;const id=text(log.id,100);if(!id||client.seenLogs.has(id))continue;
+      client.seenLogs.add(id);client.logs.push({id:body.clientId+':'+id,time:number(log.time)||now(),level:text(log.level||'log',16),text:safeText(log.text,8000)});
+    }
+    if(client.logs.length>100)client.logs.splice(0,client.logs.length-100);
+    // Keep a bounded dedup window; client log IDs are monotonically increasing.
+    if(client.seenLogs.size>500)client.seenLogs=new Set([...client.seenLogs].slice(-300));
+    if(body.kind==='request'&&plain(body.request)){
+      recordRequest({...body.request,clientId:body.clientId,source:'browser',buildId:client.buildId});
+    }
+    if(body.kind==='selection'&&plain(body.selection))client.selection=limitedContext(body.selection,token);
+    return envelope({accepted:true});
+  }
+  async function verify(args){
+    const baseline=args.sinceSequence??snapshot().sequence??0,start=now(),clock=performance.now(),timeout=Math.min(args.timeoutMs??10000,30000),pathname=args.path&&devPath(args.path);
+    while(!closed&&performance.now()-clock<timeout){
+      const state=snapshot();prune();
+      const clients=[...browsers.values()].filter(client=>(!args.clientId||client.clientId===args.clientId)&&(!pathname||client.path===pathname));
+      const match=clients.find(client=>!client.building&&client.applied?.sequence===state.sequence&&client.applied?.buildId===state.buildId&&client.sequence===state.sequence&&client.buildId===state.buildId);
+      if(state.state==='ready'&&state.sequence>baseline&&match&&now()-match.applied.time>=300){
+        const since=builds.find(build=>build.buildId===state.buildId)?.startedAt||start;
+        const errors=[...boundedArray(state.typeErrors,100).map(value=>safeText(value,4000)),...boundedArray(match.errors,30).filter(error=>error.time>=since),...(match.issues?['Browser reports '+match.issues+' current issue(s).']:[])];
+        return envelope({verified:errors.length===0,state:errors.length?'failed':'verified',reason:errors.length?'Current generation has reported errors.':'New generation compiled and confirmed by the browser.',scope:'Observed compilation, TypeScript diagnostics and browser errors; this is not a full test suite.',buildId:state.buildId,sequence:state.sequence,browser:{clientId:match.clientId,path:match.path,confirmedAt:match.applied.time},errors});
+      }
+      if(state.state==='error')return envelope({verified:false,state:'failed',reason:'Development compilation failed.',errors:[safeText(state.error,8000)],sequence:state.sequence});
+      await new Promise(resolve=>setTimeout(resolve,Math.min(100,timeout)));
+    }
+    const state=snapshot();return envelope({verified:false,state:'inconclusive',reason:closed?'Development session closed.':state.sequence>baseline?'No browser confirmed the current generation before the timeout.':'No new ready generation appeared before the timeout.',buildId:state.buildId,sequence:state.sequence});
+  }
+  async function executeTool(name,args={},meta={}){
+    validArguments(name,args);if(closed)throw Error('Development session is closed');
+    if(meta.assistantId){
+      prune();const assistant=assistants.get(meta.assistantId);
+      if(!assistant||meta.leaseId!==assistant.leaseId)throw Object.assign(Error('Assistant lease expired; initialize again'),{code:'assistant_lease_expired',status:409});
+      assistant.lastSeen=now();assistant.expiresAt=now()+assistantLeaseMs;
+    }else if(meta.client&&meta.client!=='browser'){lastActivity=now();lastClient=text(meta.client,100);}
+    if((name==='dev_snapshot'||name==='dev_logs')&&collectMetrics)await collectMetrics(recordRequest);
+    if(name==='dev_snapshot')return view();
+    if(name==='dev_connection')return envelope(connection());
+    if(name==='dev_routes')return compact(envelope({routes:routes(),cache:snapshot().cache||{}}));
+    if(name==='dev_logs'){
+      prune();const source=args.source||'all',limit=args.limit||200;
+      const logs=[...(source!=='browser'?serverLogs:[]),...(source!=='server'?[...browsers.values()].flatMap(client=>client.logs.map(log=>({...log,source:'browser',clientId:client.clientId}))):[])].filter(log=>!args.level||log.level===args.level).sort((a,b)=>a.time-b.time).slice(-limit);
+      return compact(envelope({logs,requests:requests.slice(-limit),droppedBrowserLogs:[...browsers.values()].reduce((count,client)=>count+(client.droppedLogs||0),0)}));
+    }
+    if(name==='dev_route_ensure'||name==='dev_cache_invalidate'){
+      const pathname=devPath(args.path),handler=name==='dev_route_ensure'?ensureRoute:invalidateRoute;if(!handler)throw Error('Development route operation is unavailable');
+      const result=await handler(pathname);return envelope({...result,path:pathname,invalidated:result.invalidated??name==='dev_cache_invalidate'});
+    }
+    if(name==='dev_verify')return verify(args);
+    if(name==='dev_ai_context'){
+      if(!connection().connected)throw Object.assign(Error('Connect your assistant before sending context.'),{code:'assistant_required',status:409});
+      const item={id:randomUUID(),time:now(),kind:text(args.kind||'context',32),prompt:safeText(args.prompt||'',4000),context:limitedContext(args.context,token)};
+      // The latest selection owns the one retained image; older text context
+      // remains useful without multiplying snapshot/relay payload sizes.
+      for(const previous of contexts)if(previous.context?.screenshot)previous.context.screenshot={omitted:true,reason:'A newer context was queued.'};
+      contexts.push(item);while(contexts.length>3||Buffer.byteLength(JSON.stringify(contexts))>410*1024)contexts.shift();return envelope({queued:true,id:item.id,connected:connection().connected});
+    }
+    if(name==='dev_source'||name==='dev_open_editor'){
+      const handler=name==='dev_source'?sourceTools?.source:sourceTools?.editor;if(!handler)throw Error('Source inspection is unavailable');return envelope(await handler(args));
+    }
+  }
+  function respond(res,status,value,origin){
+    const headers={'Content-Type':'application/json; charset=utf-8','Cache-Control':'no-store','X-Content-Type-Options':'nosniff'};
+    if(origin&&origins.has(origin)){headers['Access-Control-Allow-Origin']=origin;headers.Vary='Origin';headers['Access-Control-Allow-Methods']='POST, OPTIONS';headers['Access-Control-Allow-Headers']='Authorization, Content-Type, X-PRNext-Client';headers['Access-Control-Allow-Private-Network']='true';}
+    res.writeHead(status,headers);res.end(JSON.stringify(value));
+  }
+  const server=createServer(async(req,res)=>{
+    const origin=req.headers.origin;
+    if(!['127.0.0.1','::1','::ffff:127.0.0.1'].includes(req.socket.remoteAddress)||req.headers.host!==new URL(endpoint).host||origin&&!origins.has(origin))return respond(res,403,{error:'Local development origin required'});
+    if(req.method==='OPTIONS')return respond(res,204,{},origin);
+    const supplied=Buffer.from((req.headers.authorization||'').replace(/^Bearer /,''));
+    if(supplied.length!==tokenBytes.length||!timingSafeEqual(supplied,tokenBytes))return respond(res,401,{error:'Development capability required'},origin);
+    if(req.method!=='POST'||!/^application\/json(?:\s*;|$)/i.test(req.headers['content-type']||''))return respond(res,415,{error:'POST application/json required'},origin);
+    if(Number(req.headers['content-length'])>420*1024)return respond(res,413,{error:'Request too large'},origin);
+    if(inFlight>=16)return respond(res,429,{error:'Too many pending development requests'},origin);
+    inFlight++;
+    try{
+      let size=0;const chunks=[];for await(const chunk of req){size+=chunk.length;if(size>420*1024){respond(res,413,{error:'Request too large'},origin);req.destroy();return;}chunks.push(chunk);}
+      const body=JSON.parse(Buffer.concat(chunks).toString('utf8'));
+      const pathname=new URL(req.url,endpoint).pathname;
+      if(pathname==='/v1/assistant'&&origin)return respond(res,403,{error:'Only an initialized native MCP client can register an assistant.',code:'native_assistant_required'},origin);
+      const result=pathname==='/v1/assistant'?assistantEvent(body):pathname==='/v1/browser'?browserEvent(body):pathname.startsWith('/v1/tools/')?await executeTool(pathname.slice(10),body,{client:origin?'browser':req.headers['x-prnext-client'],...(!origin&&req.headers['x-prnext-assistant']?{assistantId:req.headers['x-prnext-assistant'],leaseId:req.headers['x-prnext-lease']}: {})}):null;
+      if(result===null)return respond(res,404,{error:'Unknown development endpoint'},origin);respond(res,200,result,origin);
+    }catch(error){respond(res,Number.isInteger(error.status)&&error.status>=400&&error.status<=599?error.status:400,{error:text(error.message,1000),...(typeof error.code==='string'&&/^[a-z_]{1,64}$/.test(error.code)?{code:error.code}:{})},origin);}finally{inFlight--;}
+  });
+  server.requestTimeout=35000;server.headersTimeout=5000;server.maxRequestsPerSocket=1000;
+  await new Promise((resolve,reject)=>{server.once('error',reject);server.listen(0,'127.0.0.1',resolve);});
+  endpoint='http://127.0.0.1:'+server.address().port;
+  try{
+    await mkdir(discoveryDirectory,{recursive:true,mode:0o700});
+    const directoryInfo=await lstat(discoveryDirectory);if(!directoryInfo.isDirectory()||directoryInfo.isSymbolicLink()||await realpath(discoveryDirectory)!==discoveryDirectory)throw Error('Development capability directory must be a real project directory');
+    const previous=await lstat(discoveryFile).catch(error=>{if(error.code!=='ENOENT')throw error;});
+    if(previous?.isSymbolicLink()||previous&&!previous.isFile())throw Error('Development capability file must be a regular file');
+    const temporary=discoveryFile+'.'+session+'.tmp';
+    try{const file=await open(temporary,'wx',0o600);try{await file.writeFile(JSON.stringify({version:1,root,session,endpoint,token,pid:process.pid}));}finally{await file.close();}await rename(temporary,discoveryFile);discoveryOwned=true;}finally{await rm(temporary,{force:true});}
+  }catch(error){server.closeAllConnections();await new Promise(resolve=>server.close(resolve));throw error;}
+  return {endpoint,token,session,executeTool,browserEvent,addServerLog,recordBuild,recordRequest,snapshot:view,bootstrap:{version:1,endpoint,token,session},
+    setHostRelayState(value={}){let origin;try{const url=new URL(value.origin);if(['https:','http:'].includes(url.protocol))origin=url.origin;}catch{}hostRelayState={enabled:value.enabled===true,linked:value.linked===true,...(origin?{origin}:{}),...(Number.isFinite(value.lastSeen)?{lastSeen:value.lastSeen}:{}),...(value.error?{error:safeText(value.error,1000)}:{})};},
+    setAppUrl(value){appUrl=value;const url=new URL(value);origins.add(url.origin);for(const host of ['127.0.0.1','localhost','[::1]'])origins.add(url.protocol+'//'+host+':'+url.port);},
+    async close(){if(closed)return;closed=true;assistants.clear();server.closeAllConnections();await new Promise(resolve=>server.close(resolve));if(discoveryOwned){let owned;try{owned=JSON.parse(await readFile(discoveryFile,'utf8'));}catch{}if(owned?.session===session&&owned?.token===token)await rm(discoveryFile,{force:true});}}
+  };
+}

package/runtime/dev-tools-source.mjs

@@ -0,0 +1,104 @@
+import { readFile, realpath, stat, readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SourceMap } from 'node:module';
+import { readBuildDirectory } from './build-directory.mjs';
+
+const allowed = /\.(?:[cm]?jsx?|tsx?|css|s[ac]ss|html|mdx?|json)$/i;
+const privatePart = /^(?:node_modules|\.git|\.codex|secrets?|credentials?|\.ssh)$/i;
+const privateFile = /^(?:\.env(?:\..*)?|.*\.(?:pem|key|p12|pfx)|(?:credentials|secrets?)(?:[.-].*)?)$/i;
+const within = (root, file) => { const relative=path.relative(root,file);return relative!==''&&!path.isAbsolute(relative)&&relative!=='..'&&!relative.startsWith('..'+path.sep); };
+const bounded = (value, fallback=1) => Number.isInteger(Number(value))&&Number(value)>0&&Number(value)<=10_000_000?Number(value):fallback;
+function locations(args) {
+  const found=[];
+  const add=(file,line,column)=>{if(typeof file==='string'&&file.length<=4096)found.push({file,line:bounded(line),column:bounded(column)});};
+  if(args.file||args.url)add(args.file||args.url,args.line,args.column);
+  for(const input of [args.source,args.stack,args.error?.stack,typeof args.error==='string'?args.error:undefined]){
+    if(typeof input!=='string')continue;
+    for(const line of input.slice(0,128*1024).split('\n').slice(0,80)){
+      const match=/(?:\bat\s+(?:.*?\s+\()?|^\s*|\s+)((?:https?:\/\/|file:\/\/\/|[A-Za-z]:[\\/]|\.?\.?[\\/])?[^()\n]+?):(\d+):(\d+)(?:\)?(?:\s|:|$))/.exec(line);
+      if(match)add(match[1].trim(),match[2],match[3]);
+      else {const ts=/^\s*(.+?)\((\d+),(\d+)\)/.exec(line);if(ts)add(ts[1],ts[2],ts[3]);}
+      if(found.length>=24)return found;
+    }
+  }
+  return found;
+}
+
+/** Read only bounded source inside this dev project. No shell, HTTP fetch or eval. */
+export function createDevSourceTools(projectRoot) {
+  const canonical=realpath(projectRoot);
+  async function scoped(file,{compiled=false}={}) {
+    const root=await canonical;
+    if(typeof file!=='string'||/[\x00-\x1f\x7f]/.test(file))throw Error('Source file is not available in this project.');
+    const resolved=path.resolve(root,file),relative=path.relative(root,resolved);
+    if(!within(root,resolved)||relative.split(/[\\/]/).some(part=>privatePart.test(part)||privateFile.test(part))||!allowed.test(resolved))throw Error('Source file is not available in this project.');
+    const dist=compiled?undefined:await readBuildDirectory(root);
+    const generated=file=>{const value=path.relative(root,file);return value.split(/[\\/]/).some(part=>part.startsWith('.prnext'))||value===dist||value.startsWith(dist+path.sep);};
+    if(!compiled&&generated(resolved))throw Error('Choose an original project source file.');
+    const actual=await realpath(resolved);
+    if(!within(root,actual)||!compiled&&generated(actual)||path.relative(root,actual).split(/[\\/]/).some(part=>privatePart.test(part)||privateFile.test(part)))throw Error('Source file is not available in this project.');
+    const info=await stat(actual);if(!info.isFile()||info.size>1024*1024)throw Error('Source file exceeds the development preview limit.');
+    return {root,file:actual,relative:path.relative(root,actual).split(path.sep).join('/')};
+  }
+  async function mapAsset(location) {
+    let pathname=location.file;
+    if(/^https?:\/\//.test(pathname)){try{pathname=decodeURIComponent(new URL(pathname).pathname);}catch{return;}}
+    const asset=/(?:^|\/)_(?:prnext|next)\/assets\/([^/]+\.m?js)$/.exec(pathname);
+    const root=await canonical,dist=await readBuildDirectory(root);
+    let logical,original;
+    if(asset)logical=path.join(root,dist,'assets',asset[1]);
+    else {
+      if(pathname.startsWith('file:')){try{pathname=fileURLToPath(pathname);}catch{return;}}
+      const generated=path.resolve(root,pathname),relative=path.relative(root,generated).split(path.sep).join('/');
+      const suffix=/(?:^|\/)(assets|server|app-ssr|app-ssr-edge|edge)\/([^/]+\.m?js)$/.exec(relative);
+      if(!within(root,generated)||!suffix||!(relative.startsWith(dist+'/')||relative.startsWith('.prnext-dev/')))return;
+      original=generated;logical=path.join(root,dist,suffix[1],suffix[2]);
+    }
+    const choices=[...(original?[original]:[]),logical];
+    // Source maps refer to the logical build depth even after a generation is
+    // copied under .prnext-dev/<session>/<generation> for in-flight requests.
+    const home=path.join(root,'.prnext-dev');
+    const sessions=await readdir(home,{withFileTypes:true}).catch(()=>[]);
+    for(const session of sessions.filter(entry=>entry.isDirectory()&&!entry.isSymbolicLink()).slice(-4)){
+      const directory=path.join(home,session.name),generations=await readdir(directory,{withFileTypes:true}).catch(()=>[]);
+      const suffix=path.relative(path.join(root,dist),logical);
+      for(const generation of generations.filter(entry=>entry.isDirectory()&&!entry.isSymbolicLink()).slice(-8).reverse())choices.push(path.join(directory,generation.name,suffix));
+    }
+    for(const choice of choices){try{
+      const checked=await scoped(choice,{compiled:true});
+      const mapFile=await realpath(checked.file+'.map');if(!within(root,mapFile))continue;
+      const size=await stat(mapFile);if(size.size>8*1024*1024)continue;
+      const payload=JSON.parse(await readFile(mapFile,'utf8'));
+      const entry=new SourceMap(payload).findEntry(location.line-1,location.column-1);
+      if(!entry?.originalSource)continue;
+      const original=entry.originalSource.startsWith('file:')?fileURLToPath(entry.originalSource):path.resolve(path.dirname(logical),payload.sourceRoot||'',entry.originalSource);
+      const captured=payload.sourcesContent?.[payload.sources?.indexOf(entry.originalSource)];
+      return {...await scoped(original),line:entry.originalLine+1,column:entry.originalColumn+1,mapped:true,...(typeof captured==='string'&&captured.length<=1024*1024?{captured}:{} )};
+    }catch{/* Another generation may have retired; try the next retained map. */}}
+  }
+  async function locate(args) {
+    for(const location of locations(args)){
+      try {
+        const mapped=await mapAsset(location);if(mapped)return mapped;
+        let name=location.file;
+        if(name.startsWith('file:'))name=fileURLToPath(name);
+        if(/^https?:\/\//.test(name))continue;
+        return {...await scoped(name),line:location.line,column:location.column,mapped:false};
+      } catch {/* Framework and external stack frames are not project source. */}
+    }
+    throw Error('No original project source was found for this message.');
+  }
+  async function source(args={}) {
+    const found=await locate(args),text=found.captured??await readFile(found.file,'utf8'),lines=text.split(/\r?\n/),line=Math.min(found.line,Math.max(1,lines.length));
+    const excerpt=[];for(let current=Math.max(1,line-3);current<=Math.min(lines.length,line+3);current++)excerpt.push({line:current,text:lines[current-1].slice(0,4000)});
+    const column=Math.min(found.column,(lines[line-1]?.length||0)+1);
+    return {file:found.relative,line,column,mapped:found.mapped,excerpt,frame:excerpt.map(item=>`${item.line===line?'>':' '} ${String(item.line).padStart(4)} | ${item.text}`).join('\n'),editorUrl:editorUrl(found.file,line,column,'vscode')};
+  }
+  function editorUrl(file,line,column,editor){return `${editor}://file/${file.split(path.sep).map(encodeURIComponent).join('/').replace(/^\//,'')}:${line}:${column}`;}
+  async function editor(args={}) {
+    const editor=args.editor||'vscode';if(!['vscode','cursor'].includes(editor))throw Error('Choose VS Code or Cursor.');
+    const found=await locate(args);return {file:found.relative,line:found.line,column:found.column,editorUrl:editorUrl(found.file,found.line,found.column,editor)};
+  }
+  return {source,editor};
+}

package/runtime/dev-tooltip.mjs

@@ -0,0 +1,94 @@
+// One tooltip per workbench, rendered above modal clipping in its own window.
+let sequence = 0;
+export function createDevTooltips(shadow) {
+  const document=shadow.ownerDocument,view=document.defaultView;
+  const controller=new view.AbortController(),events={signal:controller.signal};
+  const tooltip=document.createElement('div'),label=document.createElement('span'),detail=document.createElement('span');
+  tooltip.className='wb wb-tooltip';tooltip.id=`prnext-dev-tooltip-${++sequence}`;tooltip.popover='manual';tooltip.setAttribute('role','tooltip');
+  label.className='wb-tooltip-label';detail.className='wb-tooltip-detail';tooltip.append(label,detail);shadow.append(tooltip);
+  let owner,pending,suppressed,hovered,focused,showTimer,hideTimer,exitTimer,lastShown=-Infinity;
+  const target=event=>event.composedPath().find(node=>node?.hasAttribute?.('data-wb-tooltip'));
+  const contains=(node,other)=>other instanceof view.Node&&node.contains(other);
+  function clearTimers(){view.clearTimeout(showTimer);view.clearTimeout(hideTimer);view.clearTimeout(exitTimer);}
+  function describe(node,enabled){
+    const ids=new Set((node.getAttribute('aria-describedby')||'').split(/\s+/).filter(Boolean));
+    if(enabled)ids.add(tooltip.id);else ids.delete(tooltip.id);
+    if(ids.size)node.setAttribute('aria-describedby',[...ids].join(' '));else node.removeAttribute('aria-describedby');
+  }
+  function hide({immediate=false}={}){
+    clearTimers();pending=undefined;if(owner)describe(owner,false);owner=undefined;tooltip.dataset.open='false';
+    const close=()=>{if(tooltip.matches(':popover-open'))tooltip.hidePopover();};
+    if(immediate||view.matchMedia('(prefers-reduced-motion: reduce)').matches)close();else exitTimer=view.setTimeout(close,100);
+  }
+  function position(node){
+    const anchor=node.getBoundingClientRect(),margin=8,gap=8;
+    const viewport=view.visualViewport,width=viewport?.width||view.innerWidth,height=viewport?.height||view.innerHeight;
+    tooltip.style.maxWidth=Math.max(1,width-2*margin)+'px';
+    const bounds=tooltip.getBoundingClientRect();
+    const leftEdge=viewport?.offsetLeft||0,topEdge=viewport?.offsetTop||0;
+    const below=anchor.bottom+gap,bottom=topEdge+height-margin;
+    const top=below+bounds.height<=bottom?below:Math.max(topEdge+margin,anchor.top-gap-bounds.height);
+    tooltip.dataset.side=top>=anchor.bottom?'bottom':'top';
+    tooltip.style.left=Math.max(leftEdge+margin,Math.min(anchor.x+(anchor.width-bounds.width)/2,leftEdge+width-margin-bounds.width))+'px';
+    tooltip.style.top=top+'px';
+  }
+  function show(node){
+    pending=undefined;
+    if(!node.isConnected||node===suppressed||!node.getClientRects().length)return;
+    clearTimers();if(owner&&owner!==node)describe(owner,false);owner=node;
+    label.textContent=node.dataset.wbTooltip;detail.textContent=node.dataset.wbTooltipDetail||'';detail.hidden=!detail.textContent;
+    // Keep the popover in the active dialog's non-inert subtree.
+    const container=node.closest('dialog')||shadow;if(tooltip.parentNode!==container)container.append(tooltip);
+    if(!tooltip.matches(':popover-open')){
+      tooltip.dataset.open='false';try{tooltip.showPopover();}catch{owner=undefined;return;}
+    }
+    position(node);tooltip.getBoundingClientRect();tooltip.dataset.open='true';describe(node,true);lastShown=view.performance.now();
+  }
+  function schedule(node,keyboard=false){
+    if(!node||node===suppressed)return;
+    view.clearTimeout(hideTimer);view.clearTimeout(exitTimer);
+    if(node===owner){tooltip.dataset.open='true';return;}
+    view.clearTimeout(showTimer);pending=node;
+    const warm=tooltip.matches(':popover-open')||view.performance.now()-lastShown<600;
+    showTimer=view.setTimeout(()=>show(node),keyboard||warm?60:280);
+  }
+  function maybeHide(node){
+    if(node===hovered||node===focused)return;
+    if(suppressed===node)suppressed=undefined;
+    if(node===pending){view.clearTimeout(showTimer);pending=undefined;}
+    if(node===owner){const next=[hovered,focused].find(value=>value&&value!==suppressed);if(next)schedule(next,next===focused);else hideTimer=view.setTimeout(()=>hide(),120);}
+  }
+  shadow.addEventListener('pointerover',event=>{const node=target(event);if(node&&event.pointerType!=='touch'){hovered=node;schedule(node);}},events);
+  shadow.addEventListener('pointerout',event=>{const node=target(event);if(!node||contains(node,event.relatedTarget)||contains(tooltip,event.relatedTarget))return;if(hovered===node)hovered=undefined;maybeHide(node);},events);
+  shadow.addEventListener('focusin',event=>{const node=target(event);if(node?.matches(':focus-visible')){focused=node;schedule(node,true);}},events);
+  shadow.addEventListener('focusout',event=>{const node=target(event);if(!node||contains(node,event.relatedTarget))return;if(focused===node)focused=undefined;maybeHide(node);},events);
+  tooltip.addEventListener('pointerenter',()=>view.clearTimeout(hideTimer),events);
+  tooltip.addEventListener('pointerleave',event=>{if(owner&&contains(owner,event.relatedTarget))return;const node=hovered;hovered=undefined;if(node)maybeHide(node);},events);
+  const dismiss=event=>{const node=target(event);if(node)suppressed=node;if(event.type==='pointerdown')focused=undefined;hide({immediate:true});};
+  shadow.addEventListener('pointerdown',dismiss,{...events,capture:true});
+  shadow.addEventListener('click',dismiss,{...events,capture:true});
+  shadow.addEventListener('keydown',event=>{
+    if(event.key==='Escape'&&(owner||pending)){
+      const path=event.composedPath();
+      const consume=[owner,pending].some(node=>{
+        if(!node)return false;
+        const modal=node.closest('dialog[open]');
+        return path.includes(node)||Boolean(modal&&path.includes(modal));
+      });
+      // A hovered control must not steal Escape from another focused control
+      // in the nonmodal console. Native modals retain tooltip-first dismissal.
+      suppressed=owner||pending;hide({immediate:true});
+      if(consume){event.preventDefault();event.stopPropagation();}
+    }
+  },{...events,capture:true});
+  const dismissLayout=()=>hide({immediate:true});
+  view.addEventListener('resize',dismissLayout,events);view.addEventListener('blur',dismissLayout,events);
+  view.addEventListener('scroll',dismissLayout,{...events,capture:true});
+  view.visualViewport?.addEventListener('resize',dismissLayout,events);
+  view.visualViewport?.addEventListener('scroll',dismissLayout,events);
+  return{
+    set(node,text,description=''){node.dataset.wbTooltip=text;node.dataset.wbTooltipDetail=description;node.removeAttribute('title');if(owner===node)show(node);return node;},
+    hide:()=>hide({immediate:true}),
+    dispose(){hide({immediate:true});controller.abort();tooltip.remove();},
+  };
+}

package/runtime/dev-ui-icons.mjs

@@ -0,0 +1,8 @@
+export const svg = paths => `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${paths}</svg>`;
+export const deviceIcons = {
+  desktop: svg('<rect x="2" y="3" width="20" height="14" rx="2"/><path d="M8 21h8m-4-4v4"/>'),
+  phone: svg('<rect x="7" y="2" width="10" height="20" rx="2"/><path d="M11 18h2"/>'),
+  tablet: svg('<rect x="4" y="2" width="16" height="20" rx="2"/><path d="M11 18h2"/>'),
+};
+export const copyIcon = svg('<rect x="8" y="8" width="12" height="13" rx="2"/><path d="M16 8V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h3"/>');
+export const chevronIcon = svg('<path d="m8 10 4 4 4-4"/>');

package/runtime/dev-workbench-style.mjs

@@ -0,0 +1,106 @@
+// Shared by embedded and detached tools; neutral surfaces match the logo menu.
+export const workbenchStyle = `
+  .wb{color-scheme:dark;color:#ededed;font:12px/1.5 ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;text-align:left;box-sizing:border-box}
+  .wb *,.wb *::before,.wb *::after{box-sizing:border-box}
+  .wb button,.wb input,.wb select{font:inherit;color:inherit}
+  .wb button,.wb select{cursor:pointer}
+  .wb button{border:0;border-radius:8px;background:transparent;padding:6px 10px;min-height:34px;white-space:nowrap}
+  .wb button:hover{background:#191919}.wb button[aria-pressed=true]{background:#232323;color:#fff}
+  .wb button:focus-visible,.wb input:focus-visible,.wb select:focus-visible,.wb summary:focus-visible,.wb [tabindex]:focus-visible{outline:1px solid #929292;outline-offset:-2px}
+  .wb svg{width:16px;height:16px;flex:none}
+  .wb .wb-close{display:grid;place-items:center;width:34px;padding:0}.wb .wb-push{margin-left:auto}
+  .wb .wb-popout,.wb .wb-icon{display:grid;place-items:center;width:34px;padding:6px;color:#aaa}
+  .wb .wb-popout:hover,.wb .wb-icon:hover{color:#fff}.wb button[aria-pressed=true]{color:#fff}
+  .wb-popup-feedback{padding:6px 10px;color:#e9c58b;font-size:11px}
+  .wb-console{position:fixed;left:18px;bottom:74px;width:min(820px,calc(100vw - 36px));height:min(350px,calc(100dvh - 110px));min-height:180px;display:flex;flex-direction:column;background:#080808;border:1px solid #292929;border-radius:14px;box-shadow:0 12px 40px #0008;overflow:hidden;container-type:inline-size}
+  .wb-head,.wb-filters{display:flex;align-items:center;gap:6px;padding:7px 10px;border-bottom:1px solid #202020;flex:none;min-width:0}
+  .wb-filters{flex-direction:column;align-items:stretch;gap:8px;padding:10px}.wb-title{font-weight:600}
+  .wb .wb-pause{position:relative}.wb-pause svg{grid-area:1/1}.wb-pause .wb-resume-icon{opacity:0;scale:.25;filter:blur(4px)}
+  .wb-pause[aria-pressed=true] .wb-pause-icon{opacity:0;scale:.25;filter:blur(4px)}.wb-pause[aria-pressed=true] .wb-resume-icon{opacity:1;scale:1;filter:blur(0)}
+  .wb-search-row,.wb-filter-row,.wb-filter-options,.wb-console-utilities{display:flex;align-items:center;gap:6px;min-width:0}
+  .wb-search{position:relative;flex:1;min-width:0}.wb-search>svg{position:absolute;left:10px;top:50%;translate:0 -50%;width:14px;height:14px;color:#888;pointer-events:none}
+  .wb-filters input{display:block;width:100%;min-width:0;border:1px solid #292929;border-radius:8px;padding:6px 9px 6px 30px;background:#111;min-height:34px}
+  .wb-console-utilities{flex:none;gap:2px}.wb-console-utilities button{min-width:48px;color:#aaa}.wb-console-utilities button:hover{color:#ededed}
+  .wb-filter-options{flex:1;flex-wrap:wrap}.wb-filter-row{justify-content:space-between;gap:10px}
+  .wb-filters select{border:1px solid #292929;border-radius:8px;padding:6px;background:#111;max-width:110px;min-height:34px}.wb-copy{font-size:11px}
+  .wb-logs{overflow:auto;overscroll-behavior:contain;flex:1;min-height:0;font:11px/1.6 ui-monospace,SFMono-Regular,Consolas,monospace;scrollbar-color:#333 #080808}
+  .wb-line{display:grid;grid-template-columns:65px 43px minmax(0,1fr);gap:10px;padding:7px 12px;border-bottom:1px solid #ffffff08}
+  .wb-line time,.wb-level{color:#999}.wb-line pre{margin:0;font:inherit;white-space:pre-wrap;overflow-wrap:anywhere;user-select:text}
+  .wb-line[data-level=error]{background:#ce3c4a0e;color:#ffa2ac}.wb-line[data-level=warn]{background:#e6b45a0a;color:#e9c58b}
+  .wb-line[data-level=error] .wb-level{color:#ffa2ac}.wb-line[data-level=warn] .wb-level{color:#e9c58b}
+  .wb-empty{padding:24px;text-align:center;color:#999}.wb-foot{display:flex;gap:10px;flex-wrap:wrap;padding:6px 12px;color:#999;border-top:1px solid #202020;font-size:11px}
+  .wb-entry{border-bottom:1px solid #ffffff08}.wb-entry summary{list-style:none;cursor:pointer;border:0;grid-template-columns:65px 43px minmax(0,1fr) 14px}
+  .wb-entry summary::-webkit-details-marker{display:none}.wb-message{white-space:pre-wrap;overflow-wrap:anywhere;user-select:text;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
+  .wb-entry[open] .wb-message{-webkit-line-clamp:1}.wb-entry-caret svg{width:13px;height:16px;color:#888}.wb-entry[open] .wb-entry-caret svg{rotate:180deg}.wb-entry:hover{background:#ffffff04}
+  .wb-entry-actions{display:flex;gap:6px;padding:6px 12px 8px 130px}.wb-entry-actions button{display:inline-flex;align-items:center;gap:6px;font:11px/1.5 ui-sans-serif,system-ui;background:#161616}.wb-entry-actions svg{width:13px;height:13px}
+  .wb-entry-full{margin:0;padding:0 12px 12px 130px;font:inherit;white-space:pre-wrap;overflow-wrap:anywhere;user-select:text}
+  .wb-ai{display:flex;align-items:stretch;flex:none;margin-left:auto;border-radius:8px;background:#191919}
+  .wb-ai button{display:flex;align-items:center;justify-content:center;gap:7px;font-weight:600}.wb-ai button:disabled{opacity:.5;cursor:default}
+  .wb-ai-main{border-radius:8px 0 0 8px!important}.wb-ai-toggle{width:28px;padding:4px!important;border-radius:0 8px 8px 0!important}.wb-ai svg{width:14px;height:14px}
+  .wb-ai-menu{position:fixed;inset:auto;margin:0;min-width:220px;max-width:calc(100vw - 16px);padding:5px;border:1px solid #292929;border-radius:11px;background:#080808;color:#ededed;box-shadow:0 10px 30px #0008;z-index:2147483647}
+  .wb-ai-menu button{display:flex;align-items:center;gap:8px;width:100%;min-height:36px;text-align:left;font-size:12px}.wb-ai-menu button:disabled{opacity:.45;cursor:default}.wb-ai-menu::backdrop{background:transparent}
+  dialog.wb-preview{position:fixed;inset:12px;width:calc(100vw - 24px);height:calc(100dvh - 24px);max-width:none;max-height:none;padding:0;margin:0;border:0;border-radius:12px;background:#080808;box-shadow:0 12px 40px #0008;overflow:hidden;overscroll-behavior:contain}
+  dialog.wb-preview[open]{display:flex;flex-direction:column}dialog.wb-preview::backdrop{background:#000b}
+  .wb-preview-head{display:flex;align-items:center;flex-wrap:wrap;gap:12px;padding:10px 12px;border-bottom:1px solid #202020;flex:none}
+  .wb-devices{display:flex;gap:2px;padding:3px;background:#111;border-radius:11px}
+  .wb-devices .wb-device{position:relative;display:grid;place-items:center;width:34px;height:34px;padding:0;border-radius:8px;color:#999}
+  .wb-device[aria-pressed=true]{background:#272727;color:#fff;box-shadow:inset 0 0 0 1px #ffffff15}
+  .wb-tooltip{position:fixed;inset:auto;margin:0;width:max-content;max-width:calc(100vw - 16px);padding:7px 10px;gap:9px;align-items:center;background:#111;color:#ededed;border:1px solid #ffffff12;border-radius:8px;box-shadow:0 4px 16px #0007;font-size:11px;line-height:16px;opacity:0;translate:0 -3px;overflow-wrap:anywhere;z-index:2147483647}
+  .wb-tooltip:popover-open{display:flex}.wb-tooltip:not(:popover-open){display:none}.wb-tooltip::backdrop{background:transparent;pointer-events:none}
+  .wb-tooltip[data-side=top]{translate:0 3px}.wb-tooltip[data-open=true]{opacity:1;translate:0 0}
+  .wb-tooltip-label{font-weight:550;min-width:0}.wb-tooltip-detail{min-width:0;color:#929292;font:10px/16px ui-monospace,SFMono-Regular,Consolas,monospace;font-variant-numeric:tabular-nums}
+  .wb-dimensions{font:11px ui-monospace,monospace;color:#999;font-variant-numeric:tabular-nums}
+  .wb-preview-actions{display:flex;align-items:center;gap:2px;margin-left:auto;flex:none}
+  .wb .wb-frame-toggle{display:flex;align-items:center;justify-content:center;gap:6px;width:auto;padding:6px 9px}
+  .wb-preview .wb-console{position:relative;left:auto;bottom:auto;width:100%;height:min(300px,42dvh);min-height:140px;flex:none;border:0;border-top:1px solid #292929;border-radius:0;box-shadow:none}
+  .wb-preview-note{display:flex;align-items:center;padding:7px 12px;color:#aaa;font-size:11px;border-top:1px solid #202020}
+  .wb-preview-note span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+  .wb-stage{position:relative;flex:1;min-height:0;overflow:hidden;background:#080808}
+  .wb-frame-wrap{position:absolute;background:#101010;isolation:isolate;box-shadow:none}
+  .wb-frame-wrap[data-frame=true]::before{content:'';position:absolute;inset:0;z-index:3;border:1px solid #303030;border-radius:inherit;pointer-events:none}
+  .wb-frame-wrap[data-frame=false]{box-shadow:none;background:transparent}
+  .wb-screen{position:absolute;overflow:hidden;isolation:isolate;z-index:1;line-height:0;background:#080808;border:0;outline:0;box-shadow:none}
+  .wb-frame{position:absolute;left:0;top:0;display:block;border:0;border-radius:0;outline:0;box-shadow:none;transform-origin:top left;background:transparent}
+  .wb .wb-frame:focus-visible{outline:0}
+  .wb-device-top,.wb-device-home{position:absolute;pointer-events:none;z-index:2}
+  .wb-frame-wrap[data-frame=false] .wb-device-top,.wb-frame-wrap[data-frame=false] .wb-device-home{display:none}
+  .wb-device-top{left:50%;top:calc(4px * var(--s));translate:-50% 0;width:calc(68px * var(--s));height:calc(4px * var(--s));background:transparent}
+  .wb-device-top::before,.wb-device-top::after{content:'';position:absolute;border-radius:999px;background:#292929}
+  .wb-device-top::before{left:calc(7px * var(--s));top:calc(1px * var(--s));width:calc(42px * var(--s));height:calc(2px * var(--s))}
+  .wb-device-top::after{right:calc(7px * var(--s));top:0;width:calc(4px * var(--s));height:calc(4px * var(--s));background:#222}
+  .wb-device-home{bottom:calc(4px * var(--s));left:50%;translate:-50% 0;width:calc(88px * var(--s));height:calc(3px * var(--s));border-radius:99px;background:#555}
+  .wb-frame-wrap[data-device=tablet] .wb-device-top{width:calc(4px * var(--s));height:calc(4px * var(--s));top:calc(7px * var(--s));border-radius:50%;background:#292929}
+  .wb-frame-wrap[data-device=tablet] .wb-device-top::before,.wb-frame-wrap[data-device=tablet] .wb-device-top::after{display:none}
+  .wb-frame-wrap[data-device=tablet] .wb-device-home{display:none}
+  .wb-frame-wrap[data-device=phone][data-rotated=true] .wb-device-top{left:calc(4px * var(--s));top:50%;translate:0 -50%;width:calc(4px * var(--s));height:calc(68px * var(--s))}
+  .wb-frame-wrap[data-device=phone][data-rotated=true] .wb-device-top::before{left:calc(1px * var(--s));top:calc(19px * var(--s));width:calc(2px * var(--s));height:calc(42px * var(--s))}
+  .wb-frame-wrap[data-device=phone][data-rotated=true] .wb-device-top::after{left:0;right:auto;top:calc(7px * var(--s));bottom:auto}
+  .wb-frame-wrap[data-device=phone][data-rotated=true] .wb-device-home{bottom:auto;left:auto;right:calc(4px * var(--s));top:50%;translate:0 -50%;width:calc(3px * var(--s));height:calc(88px * var(--s))}
+  .wb-frame-wrap[data-device=tablet][data-rotated=true] .wb-device-top{left:calc(7px * var(--s));top:50%;translate:0 -50%}
+  .wb-frame-wrap[data-frame=true][data-device=desktop] .wb-device-top{left:0;top:0;translate:0;width:100%;height:calc(32px * var(--s));display:flex;align-items:center;gap:calc(5px * var(--s));padding:0 calc(12px * var(--s));border-radius:inherit;background:transparent}
+  .wb-frame-wrap[data-device=desktop] .wb-device-top::before,.wb-frame-wrap[data-device=desktop] .wb-device-top::after{display:none}
+  .wb-device-top i{display:none}.wb-frame-wrap[data-device=desktop] .wb-device-top i{display:block;width:calc(6px * var(--s));height:calc(6px * var(--s));border-radius:50%;background:#555}
+  .wb-frame-wrap[data-device=desktop] .wb-device-home{display:none}
+  .wb .wb-resize{position:absolute;right:-17px;top:50%;translate:0 -50%;width:26px;height:64px;padding:0;border-radius:8px;cursor:ew-resize;background:transparent!important;touch-action:none;display:grid;place-items:center;z-index:3}
+  .wb-resize::before{content:'';width:3px;height:38px;border-radius:3px;background:#666}.wb-stage[data-resizing=true] iframe{pointer-events:none}.wb-stage[data-resizing=true]{cursor:ew-resize}
+  dialog.wb-tools{inset:0;margin:auto;width:min(920px,calc(100vw - 32px));height:min(680px,calc(100dvh - 48px));max-width:none;max-height:none;padding:0;border:0;border-radius:14px;background:#080808;color:#ededed;box-shadow:0 18px 60px #000a;overflow:hidden;overscroll-behavior:contain}
+  dialog.wb-tools[open]{display:flex;flex-direction:column}dialog.wb-tools::backdrop{background:#000b}
+  .wb-tools-nav{display:flex;gap:3px;padding:7px 10px;overflow:auto;flex:none;border-bottom:1px solid #202020}.wb-tools-nav button{color:#aaa}.wb-tools-nav [aria-current=page]{background:#202020;color:#fff}
+  .wb-editor-link{display:inline-flex;align-items:center;min-height:34px;padding:6px 10px;border-radius:8px;background:#191919;color:#ededed;text-decoration:none}.wb-editor-link:focus-visible{outline:1px solid #929292;outline-offset:-2px}
+  .wb-mcp-controls{display:flex;align-items:center;flex-wrap:wrap;gap:8px;margin-top:10px}.wb-mcp-controls select{border:1px solid #292929;border-radius:7px;padding:7px 9px;background:#111;min-height:34px;max-width:100%}
+  .wb-tools-search{margin:12px 14px 0;padding:8px 10px;background:#111;border:1px solid #292929;border-radius:8px;flex:none;min-width:0}
+  .wb-tools-content{padding:14px;overflow:auto;min-height:0;flex:1;scrollbar-color:#333 #080808}.wb-tools-feedback{padding:8px 14px;font-size:12px;color:#ccc;flex:none}.wb-tools-feedback:empty{display:none}
+  .wb-muted{color:#999;font-size:11px}.wb-truncate{overflow:hidden;white-space:nowrap;text-overflow:ellipsis;min-width:0}.wb-tools-labels{padding:6px 10px;color:#999;font-size:11px}
+  .wb-request-grid{display:grid;grid-template-columns:minmax(0,1fr) 65px 80px 60px;align-items:center;gap:12px}.wb-request{border-bottom:1px solid #ffffff09}.wb-request summary{list-style:none;cursor:pointer;padding:10px}.wb-request summary::-webkit-details-marker{display:none}.wb-request-path{min-width:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;font:11px ui-monospace,monospace}.wb-request-path b{font-weight:600;color:#aaa;margin-right:8px}.wb-error-text{color:#ffa2ac}.wb-request-info{padding:0 10px 12px}.wb-request-info pre,.wb-source-code{white-space:pre-wrap;overflow-wrap:anywhere;font:11px/1.6 ui-monospace,monospace}
+  .wb-tools-pair{display:flex;align-items:baseline;justify-content:space-between;gap:12px;padding:5px 0;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.wb-tools-section{padding:8px 0 18px}.wb-tools-section+.wb-tools-section{border-top:1px solid #202020}.wb-tools-section h3{margin:4px 0 14px;font:600 13px/1.5 ui-sans-serif,system-ui}.wb-tools-section p{margin:8px 0 14px}
+  .wb-metrics{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px;padding:6px 0 20px}.wb-metric{display:flex;flex-direction:column;gap:5px}.wb-metric strong{font-size:22px;font-weight:550;font-variant-numeric:tabular-nums}.wb-build{padding:8px 0;border-bottom:1px solid #ffffff09}.wb-build summary{display:flex;justify-content:space-between;gap:12px;cursor:pointer;list-style:none}.wb-build summary::-webkit-details-marker{display:none}.wb-build[open] summary{margin-bottom:12px}.wb-phase{display:grid;grid-template-columns:85px minmax(0,1fr) 70px;align-items:center;gap:10px;font-size:11px;padding:5px 0}.wb-phase-meter{height:4px;border-radius:4px;background:#202020;overflow:hidden}.wb-phase-meter::before{content:'';display:block;width:var(--amount);height:100%;border-radius:inherit;background:#999}
+  .wb-cache-summary{display:flex;flex-wrap:wrap;gap:12px;padding-bottom:12px}.wb-cache-summary .wb-tools-pair{gap:8px}.wb-route{border-bottom:1px solid #ffffff09}.wb-route summary{display:flex;align-items:center;gap:12px;padding:12px 4px;cursor:pointer;list-style:none}.wb-route summary::-webkit-details-marker{display:none}.wb-route summary code{flex:1;min-width:0;overflow-wrap:anywhere;font-size:12px}.wb-route-actions{padding:0 4px 14px}.wb-route-param{display:inline-flex;flex-direction:column;gap:5px;margin:0 8px 12px 0;color:#aaa;font-size:11px;max-width:100%}.wb-route-param input{background:#111;border:1px solid #292929;border-radius:7px;padding:7px 9px;min-width:0;color:#eee}.wb-button-row{display:flex;flex-wrap:wrap;gap:6px;margin-bottom:8px}.wb-button-row button,.wb-tools-section>button{background:#191919}.wb-context-source{display:block;overflow-wrap:anywhere}.wb-selection-text{color:#aaa;max-height:80px;overflow:auto;font-size:11px}.wb-selection-image{display:block;max-width:100%;max-height:180px;object-fit:contain;object-position:left;margin:10px 0;border-radius:6px}.wb-instruction{display:flex;flex-direction:column;gap:8px;margin:12px 0;font-size:11px;color:#aaa}.wb-instruction textarea{resize:vertical;min-height:70px;font:12px/1.5 ui-sans-serif,system-ui;background:#111;color:#eee;border:1px solid #292929;border-radius:8px;padding:9px}.wb-instruction textarea:focus-visible{outline:1px solid #929292;outline-offset:-2px}.wb-mcp-config{margin-top:10px}.wb-mcp-config summary{cursor:pointer;color:#999;font-size:11px}.wb-mcp-config pre{overflow:auto;font:11px/1.6 ui-monospace,monospace;background:#111;padding:10px;border-radius:8px}
+  @media(max-width:500px){dialog.wb-tools{width:calc(100vw - 16px);height:calc(100dvh - 32px)}.wb-tools-content{padding:10px}.wb-tools-nav{padding:6px;gap:0}.wb-tools-nav button{padding:6px 8px}.wb-request-grid{grid-template-columns:minmax(0,1fr) 48px 58px;gap:5px}.wb-request-grid>:last-child{display:none}.wb-request-grid{font-size:11px}.wb-metrics{gap:8px}.wb-metric strong{font-size:17px}.wb-route summary{gap:8px}.wb-route summary>.wb-muted:last-child{display:none}}
+  @media(min-width:1000px){dialog.wb-preview:has(>.wb-console:not([hidden])){display:grid;grid-template-columns:minmax(0,1fr) minmax(360px,40%);grid-template-rows:auto minmax(0,1fr) auto}.wb-preview-head{grid-column:1/-1}.wb-stage{grid-column:1;grid-row:2}.wb-preview-note{grid-column:1;grid-row:3}.wb-preview .wb-console{grid-column:2;grid-row:2/4;height:100%;min-height:0;border-top:0;border-left:1px solid #292929}}
+  @media(max-width:640px){.wb-preview-head{gap:6px;padding:7px 8px}.wb-dimensions{margin-left:auto}.wb-preview-actions{width:100%;justify-content:flex-end}.wb-preview-actions .wb-preview-reload{margin-right:auto}.wb .wb-frame-toggle{width:34px;padding:6px}.wb-frame-toggle span{display:none}}
+  @media(max-width:500px){.wb-console{left:8px;bottom:70px;width:calc(100vw - 16px)}.wb-line,.wb-entry summary{grid-template-columns:38px minmax(0,1fr) 14px;gap:8px}.wb-line time{display:none}.wb-entry-actions,.wb-entry-full{padding-left:12px}.wb-copy{max-width:70px}}
+  @container(max-width:359px){.wb-filter-row{gap:6px}.wb-ai-main [data-copy-label]{display:none}.wb-ai .wb-ai-main{min-width:34px;padding:6px}.wb-filter-options{gap:6px}.wb-filters select{flex:1;min-width:0;max-width:none}.wb-console-utilities button{padding:6px 8px}}
+  @media(pointer:coarse){.wb button,.wb input,.wb select{min-height:44px}.wb .wb-close,.wb .wb-icon,.wb .wb-popout,.wb-devices .wb-device{width:44px}.wb-frame-toggle span{display:none}}
+  @media(prefers-reduced-motion:no-preference){.wb button{transition:background-color 120ms,color 120ms}.wb-pause svg{transition:opacity 180ms cubic-bezier(.2,0,0,1),scale 180ms cubic-bezier(.2,0,0,1),filter 180ms cubic-bezier(.2,0,0,1)}.wb-tooltip{transition:opacity 100ms ease-out,translate 100ms ease-out}.wb-console{animation:wb-enter 130ms ease-out}@keyframes wb-enter{from{opacity:0;translate:0 4px}to{opacity:1;translate:0 0}}}
+  @media(forced-colors:active){.wb-console,dialog.wb-preview,.wb input,.wb select{border-color:ButtonText}.wb-frame-wrap[data-frame=true]::before{border-color:CanvasText}.wb-frame-wrap[data-frame=false] .wb-screen{outline:1px solid CanvasText;outline-offset:-1px}.wb-device-top::before,.wb-device-top::after,.wb-device-home,.wb-frame-wrap[data-device=tablet] .wb-device-top,.wb-frame-wrap[data-device=desktop] .wb-device-top i{background:CanvasText}.wb-device[aria-pressed=true]{outline:1px solid Highlight}.wb button:focus-visible,.wb input:focus-visible,.wb select:focus-visible,.wb summary:focus-visible,.wb [tabindex]:focus-visible{outline:2px solid Highlight;outline-offset:-3px}}
+`;