@schlenkr/ragents 0.1.8 → 0.1.10

package/apps/web/dist/assets/{runPanel-ZT6TPDLM.js → runPanel-DPm7s3KM.js}

@@ -1,4 +1,4 @@
-import{a as M,I as H,u as Z,r as i,j as e,B as y,J as De,K as Ae,w as ze,l as Fe,m as Te,v as _e,k as Me,P as He,H as ce,L as Ue,q as K,s as de,i as Be,N as ue,O as re,T as Ve,V as $e,A as ie,Y as qe,Z as Ke,_ as Ze,$ as Ge,t as Je,a0 as We,e as Qe,a1 as Ye,a2 as Xe,y as et,z as tt,a3 as nt,a4 as st,a5 as rt,F as it,Q as ot,a6 as at,a7 as lt,G as ct}from"./mermaid-HWGCJPDP-DfsU5ofC.js";/**
+import{a as M,H,u as Z,r as i,j as e,B as y,I as De,J as Ae,v as ze,l as Fe,m as Te,t as _e,k as Me,P as He,G as ce,K as Ue,p as K,q as de,i as Be,L as ue,N as re,O as Ve,T as $e,A as ie,V as qe,Y as Ke,Z as Ze,_ as Ge,s as Je,$ as We,e as Qe,a0 as Ye,a1 as Xe,x as et,y as tt,a2 as nt,a3 as st,a4 as rt,z as it,Q as ot,a5 as at,a6 as lt,F as ct}from"./mermaid-HWGCJPDP-BLLeth5_.js";/**
  * @license lucide-react v1.46.0 - ISC
  *
  * This source code is licensed under the ISC license.
@@ -18,4 +18,4 @@ import{a as M,I as H,u as Z,r as i,j as e,B as y,J as De,K as Ae,w as ze,l as Fe
  *
  * This source code is licensed under the ISC license.
  * See the LICENSE file in the root directory of this source tree.
- */const me={name:"log-out",size:24,node:[["path",{d:"m16 17 5-5-5-5",key:"1bji2h"}],["path",{d:"M21 12H9",key:"dn1m92"}],["path",{d:"M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4",key:"1uf3rs"}]]};me.node;const ht=M(me),$="flex w-full cursor-pointer items-center gap-2.5 rounded-md px-2 py-1.5 text-left hover:bg-accent focus-visible:outline-2 focus-visible:outline-ring/60 focus-visible:-outline-offset-2 disabled:cursor-default disabled:opacity-50 [&>svg]:size-4 [&>svg]:flex-none [&>svg]:text-muted-foreground";function q({onOpenSettings:t}){const o=H(),r=Z(),[s,a]=i.useState(!1),[l,c]=i.useState(!1),[f,x]=i.useState(),b=i.useRef(null),u=i.useId(),R=d=>{var S;return d.reason==="outside-press"&&d.event.target instanceof Node&&((S=b.current)==null?void 0:S.contains(d.event.target))===!0},E=()=>{if(o.kind==="vscode"){o.requestLogout(),a(!1);return}c(!0),x(void 0),r.logout().then(()=>a(!1)).catch(d=>x(d instanceof Error?d.message:String(d))).finally(()=>c(!1))};return e.jsxs(e.Fragment,{children:[e.jsx(y,{"aria-controls":s?u:void 0,"aria-expanded":s,"aria-haspopup":"dialog","aria-label":"Menü des Panels",className:"self-center",onClick:()=>a(d=>!d),ref:b,size:"icon-lg",title:"Menü",variant:"ghost",children:e.jsx(dt,{})}),e.jsx(De,{onOpenChange:(d,S)=>{!d&&R(S)||a(d)},open:s,children:e.jsxs(Ae,{align:"end",anchor:b,"aria-label":"Menü des Panels",className:"w-[220px] gap-0 p-1 text-[0.8rem]",collisionPadding:8,dim:!0,id:u,role:"dialog",side:"bottom",children:[e.jsxs("button",{className:$,onClick:()=>{a(!1),t()},type:"button",children:[e.jsx(ze,{}),"Einstellungen"]}),o.kind==="vscode"&&e.jsxs("button",{className:$,onClick:()=>{a(!1),o.openExternal(new URL("/",window.location.href).toString())},type:"button",children:[e.jsx(ut,{}),"Im Browser öffnen"]}),r.enabled&&r.user&&e.jsxs("button",{className:$,disabled:l,onClick:E,title:r.user.id,type:"button",children:[e.jsx(ht,{}),e.jsxs("span",{className:"grid min-w-0",children:[e.jsx("span",{children:"Abmelden"}),e.jsx("span",{className:"truncate text-[0.68rem] text-muted-foreground",children:r.user.label})]})]}),f&&e.jsx("p",{className:"px-2 py-1.5 text-[0.72rem] text-destructive",role:"alert",children:f})]})})]})}const xt=5e3;function pe(t){const[o,r]=i.useState([]),[s,a]=i.useState(!1),l=i.useRef(void 0),c=i.useRef(!1),f=i.useCallback(()=>{if(!t)return Promise.resolve();if(l.current)return c.current=!0,l.current;const x=async()=>{do{c.current=!1;try{r(await _e()),a(!1)}catch{a(!0)}}while(c.current)};return l.current=x().finally(()=>{l.current=void 0}),l.current},[t]);return i.useEffect(()=>{if(!t)return;f();const x=Fe.subscribe(Te.channels.runs,{},()=>void f()),b=setInterval(()=>void f(),xt);return()=>{x(),clearInterval(b)}},[t,f]),{sessions:o,unreachable:s,refresh:f}}const ge="relative z-[80] flex h-header flex-none items-stretch border-b border-border bg-shell shadow-bar",oe="max-w-[120px] self-center truncate rounded-full bg-secondary px-2 py-0.5 text-[0.66rem] font-semibold text-muted-foreground",mt="min-w-0 flex-1 self-center truncate px-1.5 text-[0.82rem] font-semibold",pt="Gestoppt im Run-Panel",gt=5e3,v="Neuer Run",vt="relative z-[80] flex h-header flex-none items-center gap-2 border-b border-border bg-shell px-3 shadow-bar",ve="m-auto max-w-[420px] p-6 text-center text-muted-foreground",wt=new Set,bt=()=>({id:crypto.randomUUID(),title:v,updatedAt:Date.now()}),we=(t,o="Run")=>({id:t,title:o,updatedAt:Date.now()}),St={kind:"working",title:"Profil wird geladen",detail:"Die Oberfläche des Servers wird geladen."},jt={kind:"working",title:"Run wird gestartet",detail:"Der neue Run wird angelegt."},ae={kind:"working",title:"Run wird gestartet",detail:"Die Vorlage wird gestartet."},kt={kind:"waiting",title:"Kein Run gewählt",detail:"Auf der Start-Seite startest Du einen neuen Run oder öffnest einen vorhandenen."},yt={kind:"error",title:"Keine Runs freigegeben",detail:"Für dieses Benutzerkonto sind keine Runs freigegeben."};function Rt({location:t}){const o=Me(),r=t.layout==="app";if(o.status==="loading")return e.jsx(w,{headless:r,state:St});if(o.status==="failed")return e.jsx(w,{headless:r,state:{kind:"error",title:"Das Profil konnte nicht geladen werden",detail:o.error},children:e.jsx(y,{onClick:()=>window.location.reload(),size:"sm",variant:"outline",children:"Neu laden"})});const s=t.layout==="app"?e.jsx(It,{elementId:t.elementId,registry:o.registry,runId:t.runId}):e.jsx(Et,{connection:t.connection,initialRunId:t.runId,registry:o.registry});return o.failures.length===0?s:e.jsxs("div",{className:"flex h-full flex-col",children:[e.jsx(He,{failures:o.failures}),e.jsx("div",{className:"flex min-h-0 flex-1 flex-col",children:s})]})}function Et({connection:t,initialRunId:o,registry:r}){var se;const s=H(),a=Z(),l=a.can("runs.read"),c=l&&a.can("runs.write"),f=c&&a.can("runs.create"),x=f||c&&r.scriptEntries.some(n=>de(a,n.id)),b=Be((se=a.user)==null?void 0:se.id),[u,R]=i.useState(o),[E,d]=i.useState(),[S,I]=i.useState(),p=i.useCallback(()=>I(n=>n===u?void 0:n),[u]),[Se,G]=i.useState(),[h,N]=i.useState(),[D,J]=i.useState(),U=i.useRef(void 0),g=i.useCallback(n=>{U.current=n==null?void 0:n.runId,J(n)},[]),[W,B]=i.useState(),[P,Q]=i.useState(!1),[Y,X]=i.useState(),V=i.useCallback(()=>Q(!0),[]),{sessions:ee,unreachable:je,refresh:ke}=pe(l&&!h&&!D),[ye,Re]=i.useState(null),[Ee,Ne]=i.useState(null),O=i.useCallback((n,m)=>{var _;const j=(_=r.startEntries.find(Le=>Le.id===m))==null?void 0:_.fixedStartOptions;N({session:bt(),startOptions:n&&ue(n,j),entryId:m})},[r]),Ce=i.useCallback(()=>O(),[O]),L=i.useCallback((n,m)=>{N(void 0),g(void 0),G(m),R(n),I(s.kind==="vscode"?n:void 0)},[s.kind,g]),te=i.useCallback(n=>{N(void 0),g(n),Nt(n,r,a).then(()=>{U.current===n.runId&&L(n.runId)},m=>{U.current===n.runId&&J({...n,error:m instanceof Error?m.message:String(m)})})},[a,L,r,g]),Ie=i.useCallback(n=>{I(void 0),d(void 0),R(n)},[]),A=i.useCallback(()=>{I(void 0),N(void 0),g(void 0),B(void 0),s.kind==="vscode"?s.notify({type:"showStart"}):R(void 0)},[s,g]);i.useLayoutEffect(()=>{if(S){if(P||h){p();return}return window.addEventListener("pointerdown",p,!0),window.addEventListener("keydown",p,!0),window.addEventListener("blur",p),()=>{window.removeEventListener("pointerdown",p,!0),window.removeEventListener("keydown",p,!0),window.removeEventListener("blur",p)}}},[h,S,P,p]),i.useEffect(()=>s.onCommand(n=>{if(n.type==="selectRun"&&(I(void 0),N(void 0),g(void 0),B(void 0),G(void 0),d(void 0),R(n.runId??void 0)),n.type!=="newRun")return;if(s.kind!=="vscode"){x&&O(n.startOptions,n.entryId);return}const m=x?n.entryId===void 0&&!f?"Freie Runs sind für dieses Benutzerkonto nicht freigegeben.":void 0:"Neue Runs sind für dieses Benutzerkonto nicht freigegeben.";if(B(m),m!==void 0)return;const j=r.startEntries.find(_=>_.id===n.entryId);if(d((j==null?void 0:j.title)??v),n.entryId===void 0){L(crypto.randomUUID(),n.startOptions);return}if(j!==void 0&&r.guideFor(j)!==void 0){g(void 0),O(n.startOptions,j.id);return}te({runId:crypto.randomUUID(),entryId:n.entryId,startOptions:n.startOptions})}),[x,f,s,L,r,g,O,te]),i.useEffect(()=>{s.notify({type:"ready"})},[s]),i.useEffect(()=>{s.notify({type:"runChanged",runId:u??null})},[s,u]);const z=P&&e.jsx(Je,{onClose:()=>Q(!1),registry:r}),C=n=>e.jsxs(e.Fragment,{children:[e.jsx(y,{"aria-label":"Zur Start-Seite",className:"self-center",onClick:A,size:"icon-lg",title:"Zur Start-Seite",variant:"ghost",children:e.jsx(re,{})}),e.jsx("strong",{className:mt,children:n}),t&&e.jsx("span",{className:oe,title:`Server ${t}`,children:t}),e.jsx(q,{onOpenSettings:V})]}),F=e.jsx(y,{onClick:A,size:"sm",variant:"outline",children:"Zur Start-Seite"}),ne=h&&e.jsx(K,{initialStartOptions:h.startOptions,onStarted:()=>{L(h.session.id),d(n=>n??v),ke()},registry:r,session:h.session,startDialog:{onClose:s.kind==="vscode"?A:()=>N(void 0),initialEntryId:h.entryId}},h.session.id);if(D)return e.jsxs(e.Fragment,{children:[D.error===void 0?e.jsx(w,{header:C(E??v),state:ae}):e.jsx(w,{header:C(E??v),state:{kind:"error",title:"Der Run konnte nicht gestartet werden",detail:D.error},children:F}),z]});if(s.kind==="vscode"&&h)return e.jsxs(e.Fragment,{children:[e.jsx(w,{header:C(E??v),state:ae}),ne,z]});if(s.kind==="vscode"&&!(l&&u))return e.jsxs(e.Fragment,{children:[l?W!==void 0?e.jsx(w,{header:C(v),state:{kind:"error",title:"Kein neuer Run möglich",detail:W},children:F}):e.jsx(Ct,{header:C(v),children:F}):e.jsx(w,{header:C(v),state:yt,children:F}),z]});const T=ee.find(n=>n.id===u),Pe=()=>{u!==void 0&&(X(void 0),We(u,pt).catch(n=>X(`Stoppen fehlgeschlagen: ${n instanceof Error?n.message:String(n)}`)))},Oe=l?e.jsx(Qe,{activeId:u,onCreate:x?Ce:void 0,onSelect:Ie,onToggleSelected:()=>{},registry:r,seenRevisions:b.revisions,selectMode:!1,selectedIds:wt,sessions:ee}):e.jsx("p",{className:ve,children:"Für dieses Benutzerkonto sind keine Runs freigegeben."});return e.jsxs("div",{className:"flex h-full flex-col bg-[image:var(--surface-backdrop)]",children:[l&&u?e.jsxs(e.Fragment,{children:[e.jsxs("header",{className:ge,children:[e.jsx(y,{"aria-label":"Zur Start-Seite",className:"self-center",onClick:A,size:"icon-lg",title:"Zur Start-Seite",variant:"ghost",children:e.jsx(re,{})}),e.jsx("div",{"aria-label":"Run-Titelleiste",className:"flex min-w-0 flex-1 items-stretch overflow-x-auto no-scrollbar",ref:Re,role:"region"}),t&&e.jsx("span",{className:oe,title:`Server ${t}`,children:t}),e.jsx(Ve,{className:"self-center px-1.5",state:T!=null&&T.running?"running":"idle"}),e.jsx($e,{className:"self-center",disabled:!c,label:"Run stoppen",onClick:Pe,size:"icon-lg",title:"Run mit allen Agenten und Abläufen stoppen"}),e.jsx("div",{"aria-label":"Werkzeuge des Panels",className:"flex flex-none items-center empty:hidden",ref:Ne,role:"toolbar"}),e.jsx(q,{onOpenSettings:V})]}),Y&&e.jsx(ie,{variant:"destructive",children:Y}),e.jsx("main",{className:"relative z-1 flex min-h-0 min-w-0 flex-1 @container/chat-content",children:e.jsx(K,{autoFocusChat:S===u&&!P&&!h,onAutoFocusChatSettled:p,toolbarContainer:Ee,headerContainer:ye,initialStartOptions:Se,layout:"panel",onViewed:b.markViewed,registry:r,session:T??we(u,E),viewing:!h&&!P},u)})]}):e.jsxs(e.Fragment,{children:[e.jsxs("header",{className:vt,children:[e.jsx(ft,{"aria-hidden":!0,className:"size-4 flex-none text-muted-foreground"}),e.jsx("strong",{className:"min-w-0 flex-1 truncate text-[0.82rem] font-semibold",children:r.brand.title}),e.jsx(q,{onOpenSettings:V})]}),e.jsxs("div",{className:"min-h-0 flex-1 overflow-auto p-3",children:[je&&e.jsx(ie,{className:"mb-3",variant:"destructive",children:"Der Server ist nicht erreichbar."}),Oe]})]}),z,ne]})}async function Nt(t,o,r){const s=o.startEntries.find(a=>a.id===t.entryId);if(!s)throw new Error("Diese Vorlage gibt es in diesem Profil nicht.");if(!de(r,s.id))throw new Error(`${s.title} ist für dieses Benutzerkonto nicht freigegeben.`);if(t.startOptions){const a=await qe(t.runId),l=ue(t.startOptions,s.fixedStartOptions);for(const[c,f]of Ke(a,l))await Ze(t.runId,c,f)}await Ge(t.runId,s,null)}function Ct({children:t,header:o}){const[r,s]=i.useState(!1);return i.useEffect(()=>{const a=window.setTimeout(()=>s(!0),gt);return()=>window.clearTimeout(a)},[]),r?e.jsx(w,{header:o,state:kt,children:t}):e.jsx(w,{header:o,state:jt})}function w({children:t,header:o,headless:r=!1,state:s}){return e.jsxs("div",{className:"flex h-full flex-col bg-[image:var(--surface-backdrop)]",children:[!r&&e.jsx("header",{className:ge,children:o}),e.jsx("main",{className:"grid min-h-0 flex-1 place-items-center overflow-hidden p-6",children:e.jsx(Ue,{state:s,children:t})})]})}function It({elementId:t,registry:o,runId:r}){const s=H(),a=Z().can("runs.read"),{sessions:l}=pe(a);return i.useEffect(()=>{s.notify({type:"ready"})},[s]),a?e.jsx("main",{className:"relative flex h-full min-h-0 min-w-0 flex-1 bg-background @container/chat-content",children:e.jsx(K,{layout:{element:t},registry:o,session:l.find(c=>c.id===r)??we(r)},r)}):e.jsx("p",{className:ve,children:"Für dieses Benutzerkonto sind keine Runs freigegeben."})}function Pt(){const t=H();return e.jsxs(ce,{children:[e.jsx("h1",{className:"my-3 text-[1.5rem]",children:"Anmeldung erforderlich"}),e.jsx("p",{className:"mb-6 leading-normal text-muted-foreground",children:"Die Anmeldung läuft über VS Code. Danach lädt das Panel neu."}),e.jsx(y,{className:"w-full",onClick:()=>t.requestLogin(),children:"In VS Code anmelden"})]})}const k=t=>t!=null&&t.trim()?t.trim():void 0,Ot=t=>{if(t==="browser"||t==="vscode")return t;throw new Error(`Unbekannter Host ${JSON.stringify(t)}. Erlaubt sind browser und vscode.`)};function Lt(t){const o=new URLSearchParams(t),r=k(o.get("layout"))??"panel";if(r!=="panel"&&r!=="app")throw new Error(`Unbekanntes Layout ${JSON.stringify(r)}. Erlaubt sind panel und app.`);const s=k(o.get("theme"));if(s!==void 0&&!Ye(s))throw new Error(`Unbekannte Darstellung ${JSON.stringify(s)}. Erlaubt sind light und dark.`);const a={host:Ot(k(o.get("host"))??"browser"),connection:k(o.get("connection")),theme:s,access:k(o.get(Xe))},l=k(o.get("run"));if(r==="panel")return{layout:r,runId:l,...a};const c=k(o.get("element"));if(!l||!c)throw new Error("Das Layout app braucht run und element.");return{layout:r,runId:l,elementId:c,...a}}et();const be=document.getElementById("root");if(!be)throw new Error("Root-Element fehlt");const le=tt.createRoot(be);try{const t=Lt(window.location.search);t.access!==void 0&&nt(t.access);const o=st(t.host,window);if(t.host==="vscode"){const s=rt(window)}const r=it(window);t.theme!==void 0&&r.setPreference(t.theme),o.onCommand(s=>{s.type==="theme"&&r.setPreference(s.theme)}),le.render(e.jsx(i.StrictMode,{children:e.jsx(ot,{children:e.jsx(at,{value:o,children:e.jsx(lt,{value:t.host==="vscode"?{open:o.openPage}:void 0,children:e.jsx(ct,{Login:t.host==="vscode"?Pt:void 0,children:e.jsx(Rt,{location:t})})})})})}))}catch(t){le.render(e.jsxs(ce,{children:[e.jsx("h1",{className:"my-3 text-[1.5rem]",children:"Das RAgents-Panel konnte nicht geladen werden"}),e.jsx("p",{className:"mb-6 leading-normal",role:"alert",children:t instanceof Error?t.message:String(t)}),e.jsx(y,{onClick:()=>window.location.reload(),variant:"outline",children:"Erneut laden"})]}))}
+ */const pe={name:"log-out",size:24,node:[["path",{d:"m16 17 5-5-5-5",key:"1bji2h"}],["path",{d:"M21 12H9",key:"dn1m92"}],["path",{d:"M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4",key:"1uf3rs"}]]};pe.node;const ht=M(pe),$="flex w-full cursor-pointer items-center gap-2.5 rounded-md px-2 py-1.5 text-left hover:bg-accent focus-visible:outline-2 focus-visible:outline-ring/60 focus-visible:-outline-offset-2 disabled:cursor-default disabled:opacity-50 [&>svg]:size-4 [&>svg]:flex-none [&>svg]:text-muted-foreground";function q({onOpenSettings:t}){const o=H(),r=Z(),[s,a]=i.useState(!1),[l,c]=i.useState(!1),[f,x]=i.useState(),b=i.useRef(null),u=i.useId(),R=d=>{var S;return d.reason==="outside-press"&&d.event.target instanceof Node&&((S=b.current)==null?void 0:S.contains(d.event.target))===!0},E=()=>{if(o.kind==="vscode"){o.requestLogout(),a(!1);return}c(!0),x(void 0),r.logout().then(()=>a(!1)).catch(d=>x(d instanceof Error?d.message:String(d))).finally(()=>c(!1))};return e.jsxs(e.Fragment,{children:[e.jsx(y,{"aria-controls":s?u:void 0,"aria-expanded":s,"aria-haspopup":"dialog","aria-label":"Menü des Panels",className:"self-center",onClick:()=>a(d=>!d),ref:b,size:"icon-lg",title:"Menü",variant:"ghost",children:e.jsx(dt,{})}),e.jsx(De,{onOpenChange:(d,S)=>{!d&&R(S)||a(d)},open:s,children:e.jsxs(Ae,{align:"end",anchor:b,"aria-label":"Menü des Panels",className:"w-[220px] gap-0 p-1 text-[0.8rem]",collisionPadding:8,dim:!0,id:u,role:"dialog",side:"bottom",children:[e.jsxs("button",{className:$,onClick:()=>{a(!1),t()},type:"button",children:[e.jsx(ze,{}),"Einstellungen"]}),o.kind==="vscode"&&e.jsxs("button",{className:$,onClick:()=>{a(!1),o.openExternal(new URL("/",window.location.href).toString())},type:"button",children:[e.jsx(ut,{}),"Im Browser öffnen"]}),r.enabled&&r.user&&e.jsxs("button",{className:$,disabled:l,onClick:E,title:r.user.id,type:"button",children:[e.jsx(ht,{}),e.jsxs("span",{className:"grid min-w-0",children:[e.jsx("span",{children:"Abmelden"}),e.jsx("span",{className:"truncate text-[0.68rem] text-muted-foreground",children:r.user.label})]})]}),f&&e.jsx("p",{className:"px-2 py-1.5 text-[0.72rem] text-destructive",role:"alert",children:f})]})})]})}const xt=5e3;function me(t){const[o,r]=i.useState([]),[s,a]=i.useState(!1),l=i.useRef(void 0),c=i.useRef(!1),f=i.useCallback(()=>{if(!t)return Promise.resolve();if(l.current)return c.current=!0,l.current;const x=async()=>{do{c.current=!1;try{r(await _e()),a(!1)}catch{a(!0)}}while(c.current)};return l.current=x().finally(()=>{l.current=void 0}),l.current},[t]);return i.useEffect(()=>{if(!t)return;f();const x=Fe.subscribe(Te.channels.runs,{},()=>void f()),b=setInterval(()=>void f(),xt);return()=>{x(),clearInterval(b)}},[t,f]),{sessions:o,unreachable:s,refresh:f}}const ge="relative z-[80] flex h-header flex-none items-stretch border-b border-border bg-shell shadow-bar",oe="max-w-[120px] self-center truncate rounded-full bg-secondary px-2 py-0.5 text-[0.66rem] font-semibold text-muted-foreground",pt="min-w-0 flex-1 self-center truncate px-1.5 text-[0.82rem] font-semibold",mt="Gestoppt im Run-Panel",gt=5e3,v="Neuer Run",vt="relative z-[80] flex h-header flex-none items-center gap-2 border-b border-border bg-shell px-3 shadow-bar",ve="m-auto max-w-[420px] p-6 text-center text-muted-foreground",wt=new Set,bt=()=>({id:crypto.randomUUID(),title:v,updatedAt:Date.now()}),we=(t,o="Run")=>({id:t,title:o,updatedAt:Date.now()}),St={kind:"working",title:"Profil wird geladen",detail:"Die Oberfläche des Servers wird geladen."},jt={kind:"working",title:"Run wird gestartet",detail:"Der neue Run wird angelegt."},ae={kind:"working",title:"Run wird gestartet",detail:"Die Vorlage wird gestartet."},kt={kind:"waiting",title:"Kein Run gewählt",detail:"Auf der Start-Seite startest Du einen neuen Run oder öffnest einen vorhandenen."},yt={kind:"error",title:"Keine Runs freigegeben",detail:"Für dieses Benutzerkonto sind keine Runs freigegeben."};function Rt({location:t}){const o=Me(),r=t.layout==="app";if(o.status==="loading")return e.jsx(w,{headless:r,state:St});if(o.status==="failed")return e.jsx(w,{headless:r,state:{kind:"error",title:"Das Profil konnte nicht geladen werden",detail:o.error},children:e.jsx(y,{onClick:()=>window.location.reload(),size:"sm",variant:"outline",children:"Neu laden"})});const s=t.layout==="app"?e.jsx(It,{elementId:t.elementId,registry:o.registry,runId:t.runId}):e.jsx(Et,{connection:t.connection,initialRunId:t.runId,registry:o.registry});return o.failures.length===0?s:e.jsxs("div",{className:"flex h-full flex-col",children:[e.jsx(He,{failures:o.failures}),e.jsx("div",{className:"flex min-h-0 flex-1 flex-col",children:s})]})}function Et({connection:t,initialRunId:o,registry:r}){var se;const s=H(),a=Z(),l=a.can("runs.read"),c=l&&a.can("runs.write"),f=c&&a.can("runs.create"),x=f||c&&r.scriptEntries.some(n=>de(a,n.id)),b=Be((se=a.user)==null?void 0:se.id),[u,R]=i.useState(o),[E,d]=i.useState(),[S,I]=i.useState(),m=i.useCallback(()=>I(n=>n===u?void 0:n),[u]),[Se,G]=i.useState(),[h,N]=i.useState(),[D,J]=i.useState(),U=i.useRef(void 0),g=i.useCallback(n=>{U.current=n==null?void 0:n.runId,J(n)},[]),[W,B]=i.useState(),[P,Q]=i.useState(!1),[Y,X]=i.useState(),V=i.useCallback(()=>Q(!0),[]),{sessions:ee,unreachable:je,refresh:ke}=me(l&&!h&&!D),[ye,Re]=i.useState(null),[Ee,Ne]=i.useState(null),O=i.useCallback((n,p)=>{var _;const j=(_=r.startEntries.find(Le=>Le.id===p))==null?void 0:_.fixedStartOptions;N({session:bt(),startOptions:n&&ue(n,j),entryId:p})},[r]),Ce=i.useCallback(()=>O(),[O]),L=i.useCallback((n,p)=>{N(void 0),g(void 0),G(p),R(n),I(s.kind==="vscode"?n:void 0)},[s.kind,g]),te=i.useCallback(n=>{N(void 0),g(n),Nt(n,r,a).then(()=>{U.current===n.runId&&L(n.runId)},p=>{U.current===n.runId&&J({...n,error:p instanceof Error?p.message:String(p)})})},[a,L,r,g]),Ie=i.useCallback(n=>{I(void 0),d(void 0),R(n)},[]),A=i.useCallback(()=>{I(void 0),N(void 0),g(void 0),B(void 0),s.kind==="vscode"?s.notify({type:"showStart"}):R(void 0)},[s,g]);i.useLayoutEffect(()=>{if(S){if(P||h){m();return}return window.addEventListener("pointerdown",m,!0),window.addEventListener("keydown",m,!0),window.addEventListener("blur",m),()=>{window.removeEventListener("pointerdown",m,!0),window.removeEventListener("keydown",m,!0),window.removeEventListener("blur",m)}}},[h,S,P,m]),i.useEffect(()=>s.onCommand(n=>{if(n.type==="selectRun"&&(I(void 0),N(void 0),g(void 0),B(void 0),G(void 0),d(void 0),R(n.runId??void 0)),n.type!=="newRun")return;if(s.kind!=="vscode"){x&&O(n.startOptions,n.entryId);return}const p=x?n.entryId===void 0&&!f?"Freie Runs sind für dieses Benutzerkonto nicht freigegeben.":void 0:"Neue Runs sind für dieses Benutzerkonto nicht freigegeben.";if(B(p),p!==void 0)return;const j=r.startEntries.find(_=>_.id===n.entryId);if(d((j==null?void 0:j.title)??v),n.entryId===void 0){L(crypto.randomUUID(),n.startOptions);return}if(j!==void 0&&r.guideFor(j)!==void 0){g(void 0),O(n.startOptions,j.id);return}te({runId:crypto.randomUUID(),entryId:n.entryId,startOptions:n.startOptions})}),[x,f,s,L,r,g,O,te]),i.useEffect(()=>{s.notify({type:"ready"})},[s]),i.useEffect(()=>{s.notify({type:"runChanged",runId:u??null})},[s,u]);const z=P&&e.jsx(Je,{onClose:()=>Q(!1),registry:r}),C=n=>e.jsxs(e.Fragment,{children:[e.jsx(y,{"aria-label":"Zur Start-Seite",className:"self-center",onClick:A,size:"icon-lg",title:"Zur Start-Seite",variant:"ghost",children:e.jsx(re,{})}),e.jsx("strong",{className:pt,children:n}),t&&e.jsx("span",{className:oe,title:`Server ${t}`,children:t}),e.jsx(q,{onOpenSettings:V})]}),F=e.jsx(y,{onClick:A,size:"sm",variant:"outline",children:"Zur Start-Seite"}),ne=h&&e.jsx(K,{initialStartOptions:h.startOptions,onStarted:()=>{L(h.session.id),d(n=>n??v),ke()},registry:r,session:h.session,startDialog:{onClose:s.kind==="vscode"?A:()=>N(void 0),initialEntryId:h.entryId}},h.session.id);if(D)return e.jsxs(e.Fragment,{children:[D.error===void 0?e.jsx(w,{header:C(E??v),state:ae}):e.jsx(w,{header:C(E??v),state:{kind:"error",title:"Der Run konnte nicht gestartet werden",detail:D.error},children:F}),z]});if(s.kind==="vscode"&&h)return e.jsxs(e.Fragment,{children:[e.jsx(w,{header:C(E??v),state:ae}),ne,z]});if(s.kind==="vscode"&&!(l&&u))return e.jsxs(e.Fragment,{children:[l?W!==void 0?e.jsx(w,{header:C(v),state:{kind:"error",title:"Kein neuer Run möglich",detail:W},children:F}):e.jsx(Ct,{header:C(v),children:F}):e.jsx(w,{header:C(v),state:yt,children:F}),z]});const T=ee.find(n=>n.id===u),Pe=()=>{u!==void 0&&(X(void 0),We(u,mt).catch(n=>X(`Stoppen fehlgeschlagen: ${n instanceof Error?n.message:String(n)}`)))},Oe=l?e.jsx(Qe,{activeId:u,onCreate:x?Ce:void 0,onSelect:Ie,onToggleSelected:()=>{},registry:r,seenRevisions:b.revisions,selectMode:!1,selectedIds:wt,sessions:ee}):e.jsx("p",{className:ve,children:"Für dieses Benutzerkonto sind keine Runs freigegeben."});return e.jsxs("div",{className:"flex h-full flex-col bg-[image:var(--surface-backdrop)]",children:[l&&u?e.jsxs(e.Fragment,{children:[e.jsxs("header",{className:ge,children:[e.jsx(y,{"aria-label":"Zur Start-Seite",className:"self-center",onClick:A,size:"icon-lg",title:"Zur Start-Seite",variant:"ghost",children:e.jsx(re,{})}),e.jsx("div",{"aria-label":"Run-Titelleiste",className:"flex min-w-0 flex-1 items-stretch overflow-x-auto no-scrollbar",ref:Re,role:"region"}),t&&e.jsx("span",{className:oe,title:`Server ${t}`,children:t}),e.jsx(Ve,{className:"self-center px-1.5",state:T!=null&&T.running?"running":"idle"}),e.jsx($e,{className:"self-center",disabled:!c,label:"Run stoppen",onClick:Pe,size:"icon-lg",title:"Run mit allen Agenten und Abläufen stoppen"}),e.jsx("div",{"aria-label":"Werkzeuge des Panels",className:"flex flex-none items-center empty:hidden",ref:Ne,role:"toolbar"}),e.jsx(q,{onOpenSettings:V})]}),Y&&e.jsx(ie,{variant:"destructive",children:Y}),e.jsx("main",{className:"relative z-1 flex min-h-0 min-w-0 flex-1 @container/chat-content",children:e.jsx(K,{autoFocusChat:S===u&&!P&&!h,onAutoFocusChatSettled:m,toolbarContainer:Ee,headerContainer:ye,initialStartOptions:Se,layout:"panel",onViewed:b.markViewed,registry:r,session:T??we(u,E),viewing:!h&&!P},u)})]}):e.jsxs(e.Fragment,{children:[e.jsxs("header",{className:vt,children:[e.jsx(ft,{"aria-hidden":!0,className:"size-4 flex-none text-muted-foreground"}),e.jsx("strong",{className:"min-w-0 flex-1 truncate text-[0.82rem] font-semibold",children:r.brand.title}),e.jsx(q,{onOpenSettings:V})]}),e.jsxs("div",{className:"min-h-0 flex-1 overflow-auto p-3",children:[je&&e.jsx(ie,{className:"mb-3",variant:"destructive",children:"Der Server ist nicht erreichbar."}),Oe]})]}),z,ne]})}async function Nt(t,o,r){const s=o.startEntries.find(a=>a.id===t.entryId);if(!s)throw new Error("Diese Vorlage gibt es in diesem Profil nicht.");if(!de(r,s.id))throw new Error(`${s.title} ist für dieses Benutzerkonto nicht freigegeben.`);if(t.startOptions){const a=await qe(t.runId),l=ue(t.startOptions,s.fixedStartOptions);for(const[c,f]of Ke(a,l))await Ze(t.runId,c,f)}await Ge(t.runId,s,null)}function Ct({children:t,header:o}){const[r,s]=i.useState(!1);return i.useEffect(()=>{const a=window.setTimeout(()=>s(!0),gt);return()=>window.clearTimeout(a)},[]),r?e.jsx(w,{header:o,state:kt,children:t}):e.jsx(w,{header:o,state:jt})}function w({children:t,header:o,headless:r=!1,state:s}){return e.jsxs("div",{className:"flex h-full flex-col bg-[image:var(--surface-backdrop)]",children:[!r&&e.jsx("header",{className:ge,children:o}),e.jsx("main",{className:"grid min-h-0 flex-1 place-items-center overflow-hidden p-6",children:e.jsx(Ue,{state:s,children:t})})]})}function It({elementId:t,registry:o,runId:r}){const s=H(),a=Z().can("runs.read"),{sessions:l}=me(a);return i.useEffect(()=>{s.notify({type:"ready"})},[s]),a?e.jsx("main",{className:"relative flex h-full min-h-0 min-w-0 flex-1 bg-background @container/chat-content",children:e.jsx(K,{layout:{element:t},registry:o,session:l.find(c=>c.id===r)??we(r)},r)}):e.jsx("p",{className:ve,children:"Für dieses Benutzerkonto sind keine Runs freigegeben."})}function Pt(){const t=H();return e.jsxs(ce,{children:[e.jsx("h1",{className:"my-3 text-[1.5rem]",children:"Anmeldung erforderlich"}),e.jsx("p",{className:"mb-6 leading-normal text-muted-foreground",children:"Die Anmeldung läuft über VS Code. Danach lädt das Panel neu."}),e.jsx(y,{className:"w-full",onClick:()=>t.requestLogin(),children:"In VS Code anmelden"})]})}const k=t=>t!=null&&t.trim()?t.trim():void 0,Ot=t=>{if(t==="browser"||t==="vscode")return t;throw new Error(`Unbekannter Host ${JSON.stringify(t)}. Erlaubt sind browser und vscode.`)};function Lt(t){const o=new URLSearchParams(t),r=k(o.get("layout"))??"panel";if(r!=="panel"&&r!=="app")throw new Error(`Unbekanntes Layout ${JSON.stringify(r)}. Erlaubt sind panel und app.`);const s=k(o.get("theme"));if(s!==void 0&&!Ye(s))throw new Error(`Unbekannte Darstellung ${JSON.stringify(s)}. Erlaubt sind light und dark.`);const a={host:Ot(k(o.get("host"))??"browser"),connection:k(o.get("connection")),theme:s,access:k(o.get(Xe))},l=k(o.get("run"));if(r==="panel")return{layout:r,runId:l,...a};const c=k(o.get("element"));if(!l||!c)throw new Error("Das Layout app braucht run und element.");return{layout:r,runId:l,elementId:c,...a}}et();const be=document.getElementById("root");if(!be)throw new Error("Root-Element fehlt");const le=tt.createRoot(be);try{const t=Lt(window.location.search);t.access!==void 0&&nt(t.access);const o=st(t.host,window);if(t.host==="vscode"){const s=rt(window)}const r=it(window);t.theme!==void 0&&r.setPreference(t.theme),o.onCommand(s=>{s.type==="theme"&&r.setPreference(s.theme)}),le.render(e.jsx(i.StrictMode,{children:e.jsx(ot,{children:e.jsx(at,{value:o,children:e.jsx(lt,{value:t.host==="vscode"?{open:o.openPage}:void 0,children:e.jsx(ct,{Login:t.host==="vscode"?Pt:void 0,children:e.jsx(Rt,{location:t})})})})})}))}catch(t){le.render(e.jsxs(ce,{children:[e.jsx("h1",{className:"my-3 text-[1.5rem]",children:"Das RAgents-Panel konnte nicht geladen werden"}),e.jsx("p",{className:"mb-6 leading-normal",role:"alert",children:t instanceof Error?t.message:String(t)}),e.jsx(y,{onClick:()=>window.location.reload(),variant:"outline",children:"Erneut laden"})]}))}

package/apps/web/dist/help/guide-clients.html

@@ -156,8 +156,10 @@ mini-app, so unsaved input in it is lost. The choice is stored per run and survi
 The extension can also open a mini-app as an editor tab in the center, which works well with
 &quot;Nur Chat&quot; in the run panel.</p>
 <p>In &quot;Chat unten&quot;, the handle controls the expanded chat height. Dragging up makes it taller;
-dragging down makes it shorter. The chosen height is stored per run. The collapsed chat always
-shows only the handle, status, and complete input, including multiple input lines. Hovering or
+dragging down makes it shorter. The chosen height is stored per run. The collapsed chat shows the
+handle, status, and complete input, including multiple input lines. An open question sits
+completely above the input there as well: the collapsed chat grows by its height, up to half of
+the panel, and the status line reads &quot;Wartet auf Eingabe&quot; (waiting for input). Hovering or
 writing opens the chat to the chosen height (90 percent of the panel by default). Dragging leaves
 the chat open at its new height. Clicking the handle opens or closes it. With
 keyboard focus on the handle, up and down change the height, Home and End select its limits, and
@@ -204,11 +206,14 @@ a checkout. <code>ragents.hostPath</code> remains an override pointing to a chec
 The status bar shows the number of connected servers and opens the start page when clicked. See
 the root <code>README.md</code> for details.</p>
 <p>Install the extension from the Marketplace as <code>purestate.ragents-vscode</code> using &quot;Extensions:
-Install Extension&quot; or <code>code --install-extension purestate.ragents-vscode</code>. To install a locally
-packaged file, run <code>pnpm package:vscode</code>, which builds
-<code>dist/ragents-vscode-&lt;version&gt;.vsix</code>, then use &quot;Extensions: Install from VSIX&quot; or
-<code>code --install-extension dist/ragents-vscode-&lt;version&gt;.vsix --force</code>. <code>scripts/vscode/install-local.sh</code>
-performs both steps, rebuilds the built-in plugins, and
+Install Extension&quot; or <code>code --install-extension purestate.ragents-vscode</code>. The Marketplace
+delivers the build for your platform, which carries ripgrep for the <code>bash</code> tool (see
+<a href="guide-distributed.html#work-on-windows">Work on Windows</a> for the Windows bash). To install a locally
+packaged file, run <code>pnpm package:vscode</code>, which builds the universal
+<code>dist/ragents-vscode-&lt;version&gt;.vsix</code> and one <code>dist/ragents-vscode-&lt;platform&gt;-&lt;version&gt;.vsix</code> per
+platform, such as <code>darwin-arm64</code>, then use &quot;Extensions: Install from VSIX&quot; or
+<code>code --install-extension dist/ragents-vscode-darwin-arm64-&lt;version&gt;.vsix --force</code>. <code>scripts/vscode/install-local.sh</code>
+performs both steps with the file for this machine, rebuilds the built-in plugins, and
 rebuilds the web interface if it no longer matches its sources, so that hosts from this checkout
 start again. The script then restarts manually launched
 servers (<code>scripts/start.sh</code>, identified by <code>RAGENTS_LAUNCH=start.sh</code> in their environment, with logs under
@@ -263,7 +268,20 @@ server has locked, for example because its journal uses an older format, shows a
 tooltip names the cause; it does not open, but the selection mode deletes it.</p>
 <p><strong>Server</strong> is the configuration page. You can add, edit, sign in, sign out, connect,
 disconnect, and remove servers with confirmation, then open <code>settings.json</code> from the link
-at the bottom.</p>
+at the bottom. If a connected server does not accept this window&#39;s folders as a workstation, its
+entry says &quot;Arbeitsplatz nicht angemeldet&quot; (workstation not registered) with the cause.</p>
+<p>The extension compares its own RAgents version with the version each server reports. If they
+differ, the server row, the top of Start, the status bar, and a notification show &quot;RAgents-Fassung
+passt nicht: Erweiterung 0.1.9, Server 0.1.8 - ...&quot; (RAgents version does not match), followed by
+what to update: the extension if it is older, the server if it is older, or the host in
+<code>ragents.hostPath</code> for a local profile. A server that reports no version counts as older. While the
+workstation stays registered, this is a warning and everything keeps working. When the server
+rejects the workstation for the same reason, because the workspace executor versions differ or the
+host the extension uses lacks a plugin bundle the server&#39;s executor carries, or carries it in
+another version, it is an error that also names the server&#39;s cause; the same error appears when
+both report the same version but their builds differ. The notification appears once per server
+and message; &quot;Erweiterung zeigen&quot; (show extension) opens the extension page for the update, and
+&quot;Server zeigen&quot; (show server) opens the Server page.</p>
 <p>Every status uses a colored icon and a tooltip with the same vocabulary everywhere. A run is
 &quot;läuft&quot; (running), &quot;wartet auf Eingabe&quot; (waiting for input, with the number of open inputs),
 &quot;ruht&quot; (idle), &quot;beendet&quot; (ended), &quot;fehlgeschlagen&quot; (failed), or &quot;abgebrochen&quot; (cancelled). A

package/apps/web/dist/help/guide-clients.md

@@ -32,8 +32,10 @@ The extension can also open a mini-app as an editor tab in the center, which wor
 "Nur Chat" in the run panel.
 
 In "Chat unten", the handle controls the expanded chat height. Dragging up makes it taller;
-dragging down makes it shorter. The chosen height is stored per run. The collapsed chat always
-shows only the handle, status, and complete input, including multiple input lines. Hovering or
+dragging down makes it shorter. The chosen height is stored per run. The collapsed chat shows the
+handle, status, and complete input, including multiple input lines. An open question sits
+completely above the input there as well: the collapsed chat grows by its height, up to half of
+the panel, and the status line reads "Wartet auf Eingabe" (waiting for input). Hovering or
 writing opens the chat to the chosen height (90 percent of the panel by default). Dragging leaves
 the chat open at its new height. Clicking the handle opens or closes it. With
 keyboard focus on the handle, up and down change the height, Home and End select its limits, and
@@ -84,11 +86,14 @@ The status bar shows the number of connected servers and opens the start page wh
 the root `README.md` for details.
 
 Install the extension from the Marketplace as `purestate.ragents-vscode` using "Extensions:
-Install Extension" or `code --install-extension purestate.ragents-vscode`. To install a locally
-packaged file, run `pnpm package:vscode`, which builds
-`dist/ragents-vscode-<version>.vsix`, then use "Extensions: Install from VSIX" or
-`code --install-extension dist/ragents-vscode-<version>.vsix --force`. `scripts/vscode/install-local.sh`
-performs both steps, rebuilds the built-in plugins, and
+Install Extension" or `code --install-extension purestate.ragents-vscode`. The Marketplace
+delivers the build for your platform, which carries ripgrep for the `bash` tool (see
+[Work on Windows](guide-distributed.html#work-on-windows) for the Windows bash). To install a locally
+packaged file, run `pnpm package:vscode`, which builds the universal
+`dist/ragents-vscode-<version>.vsix` and one `dist/ragents-vscode-<platform>-<version>.vsix` per
+platform, such as `darwin-arm64`, then use "Extensions: Install from VSIX" or
+`code --install-extension dist/ragents-vscode-darwin-arm64-<version>.vsix --force`. `scripts/vscode/install-local.sh`
+performs both steps with the file for this machine, rebuilds the built-in plugins, and
 rebuilds the web interface if it no longer matches its sources, so that hosts from this checkout
 start again. The script then restarts manually launched
 servers (`scripts/start.sh`, identified by `RAGENTS_LAUNCH=start.sh` in their environment, with logs under
@@ -150,7 +155,21 @@ tooltip names the cause; it does not open, but the selection mode deletes it.
 
 **Server** is the configuration page. You can add, edit, sign in, sign out, connect,
 disconnect, and remove servers with confirmation, then open `settings.json` from the link
-at the bottom.
+at the bottom. If a connected server does not accept this window's folders as a workstation, its
+entry says "Arbeitsplatz nicht angemeldet" (workstation not registered) with the cause.
+
+The extension compares its own RAgents version with the version each server reports. If they
+differ, the server row, the top of Start, the status bar, and a notification show "RAgents-Fassung
+passt nicht: Erweiterung 0.1.9, Server 0.1.8 - ..." (RAgents version does not match), followed by
+what to update: the extension if it is older, the server if it is older, or the host in
+`ragents.hostPath` for a local profile. A server that reports no version counts as older. While the
+workstation stays registered, this is a warning and everything keeps working. When the server
+rejects the workstation for the same reason, because the workspace executor versions differ or the
+host the extension uses lacks a plugin bundle the server's executor carries, or carries it in
+another version, it is an error that also names the server's cause; the same error appears when
+both report the same version but their builds differ. The notification appears once per server
+and message; "Erweiterung zeigen" (show extension) opens the extension page for the update, and
+"Server zeigen" (show server) opens the Server page.
 
 Every status uses a colored icon and a tooltip with the same vocabulary everywhere. A run is
 "läuft" (running), "wartet auf Eingabe" (waiting for input, with the number of open inputs),

package/apps/web/dist/help/guide-distributed.html

@@ -287,9 +287,14 @@ After transfer, inspect the journal with <code>pnpm driver journal &lt;runId&gt;
 <li><strong>The VS Code extension for Windows</strong> brings its own bash. The Marketplace delivers a
 <code>win32-x64</code> or <code>win32-arm64</code> build that contains a slim bash with the GNU tools (coreutils,
 <code>grep</code>, <code>sed</code>, <code>awk</code>, <code>find</code>, <code>diff</code>, <code>patch</code>, <code>tar</code>, <code>unzip</code>, <code>cygpath</code> and more), taken from
-a fixed Git for Windows release. The <code>bash</code> tool uses only this bash, for the workspace and for
-the local host; an installed Git Bash or a <code>bash.exe</code> on <code>PATH</code> is never used. PowerShell and
-<code>cmd.exe</code> are not used either.</li>
+a fixed Git for Windows release, plus <code>rg.exe</code> (ripgrep) from a fixed ripgrep release. The
+<code>bash</code> tool uses only this bash, for the workspace and for the local host; an installed Git
+Bash or a <code>bash.exe</code> on <code>PATH</code> is never used. PowerShell and <code>cmd.exe</code> are not used either.</li>
+<li><strong>Code search</strong> runs through <code>rg</code>, which skips <code>node_modules</code>, <code>bin</code>, <code>obj</code> and everything else
+<code>.gitignore</code> excludes. The extension builds for macOS and Linux carry <code>rg</code> as well and put it at
+the front of the <code>bash</code> tool&#39;s <code>PATH</code>, on the workstation and for the local host. The system
+prompt tells the model to search with <code>rg</code> only when the machine running <code>bash</code> has one;
+otherwise it tells the model to exclude dependency and build folders from <code>grep -r</code>.</li>
 <li><strong>Git</strong> is your own <code>git.exe</code> on <code>PATH</code>, for example from Git for Windows. The bundled bash
 contains no git, so your login works as usual: Git Credential Manager, <code>~/.gitconfig</code> and
 <code>~/.ssh</code>. On your own machine the bash inherits your whole environment, except the variables of
@@ -297,7 +302,10 @@ VS Code itself and <code>BASH_ENV</code>/<code>ENV</code>.</li>
 <li><strong>Without the extension</strong> (<code>ragents start</code> or <code>ragents workspace-client</code> from the npm package)
 set <code>RAGENTS_BASH</code> to the <code>bash.exe</code> of such a bundle, for example
 <code>&lt;extension folder&gt;\dist\bash\win32-x64\usr\bin\bash.exe</code>. Without it every <code>bash</code> call fails
-and names what is missing.</li>
+and names what is missing. <code>RAGENTS_RG</code> names an <code>rg</code> in the same way, for example
+<code>&lt;extension folder&gt;\dist\rg\win32-x64\rg.exe</code>, on every platform; without it, an <code>rg</code> on
+<code>PATH</code> is used if there is one. A <code>RAGENTS_RG</code> that points to a missing file stops the server
+start or the workstation&#39;s registration.</li>
 <li><strong>Node.js</strong> is enough with <code>@schlenkr/ragents</code>. A checkout additionally needs <strong>pnpm</strong>, and
 <code>pnpm install</code>, <code>pnpm build:agent</code>, and <code>scripts/start.sh</code> need a bash of your own, such as
 Git Bash.</li>

package/apps/web/dist/help/guide-distributed.md

@@ -191,9 +191,14 @@ The local host and workspace also run on Windows. Requirements are:
 - **The VS Code extension for Windows** brings its own bash. The Marketplace delivers a
   `win32-x64` or `win32-arm64` build that contains a slim bash with the GNU tools (coreutils,
   `grep`, `sed`, `awk`, `find`, `diff`, `patch`, `tar`, `unzip`, `cygpath` and more), taken from
-  a fixed Git for Windows release. The `bash` tool uses only this bash, for the workspace and for
-  the local host; an installed Git Bash or a `bash.exe` on `PATH` is never used. PowerShell and
-  `cmd.exe` are not used either.
+  a fixed Git for Windows release, plus `rg.exe` (ripgrep) from a fixed ripgrep release. The
+  `bash` tool uses only this bash, for the workspace and for the local host; an installed Git
+  Bash or a `bash.exe` on `PATH` is never used. PowerShell and `cmd.exe` are not used either.
+- **Code search** runs through `rg`, which skips `node_modules`, `bin`, `obj` and everything else
+  `.gitignore` excludes. The extension builds for macOS and Linux carry `rg` as well and put it at
+  the front of the `bash` tool's `PATH`, on the workstation and for the local host. The system
+  prompt tells the model to search with `rg` only when the machine running `bash` has one;
+  otherwise it tells the model to exclude dependency and build folders from `grep -r`.
 - **Git** is your own `git.exe` on `PATH`, for example from Git for Windows. The bundled bash
   contains no git, so your login works as usual: Git Credential Manager, `~/.gitconfig` and
   `~/.ssh`. On your own machine the bash inherits your whole environment, except the variables of
@@ -201,7 +206,10 @@ The local host and workspace also run on Windows. Requirements are:
 - **Without the extension** (`ragents start` or `ragents workspace-client` from the npm package)
   set `RAGENTS_BASH` to the `bash.exe` of such a bundle, for example
   `<extension folder>\dist\bash\win32-x64\usr\bin\bash.exe`. Without it every `bash` call fails
-  and names what is missing.
+  and names what is missing. `RAGENTS_RG` names an `rg` in the same way, for example
+  `<extension folder>\dist\rg\win32-x64\rg.exe`, on every platform; without it, an `rg` on
+  `PATH` is used if there is one. A `RAGENTS_RG` that points to a missing file stops the server
+  start or the workstation's registration.
 - **Node.js** is enough with `@schlenkr/ragents`. A checkout additionally needs **pnpm**, and
   `pnpm install`, `pnpm build:agent`, and `scripts/start.sh` need a bash of your own, such as
   Git Bash.

package/apps/web/dist/help/guide-getting-started.html

@@ -156,15 +156,19 @@ that exact environment variable. Startup fails if it is missing. Existing enviro
 take precedence over profile values; no <code>.env</code> file is loaded. Startup reports a missing
 referenced variable as an error. Configured models and reasoning levels must be valid in the
 available model catalog.</p>
-<p>A profile can also name its models by alias: <code>MODEL_ALIASES</code> in the <code>host</code> section lists
-<code>alias=provider/model</code> or <code>alias=provider/model@thinking</code>, and <code>AGENT_PROVIDER: &quot;alias&quot;</code> makes the
-product use them. The interface, the chat, and the journal then show only the alias names.</p>
+<p>A profile can also name its models by alias: <code>MODEL_ALIASES</code> in the <code>host</code> section lists objects
+with <code>alias</code>, <code>model</code> as <code>provider/model</code>, an optional default <code>thinking</code> level, and the model&#39;s
+<code>compaction</code> values: the context size in tokens at which an agent compacts (<code>threshold</code>), how much
+recent context stays verbatim (<code>keepRecentTokens</code>), and the summary budget (<code>summaryTokens</code>).
+<code>AGENT_PROVIDER: &quot;alias&quot;</code> makes the product use them. The interface, the chat, and the journal then
+show only the alias names.</p>
 <p>Alternatively, a profile can obtain its models from another RAgents server running the
-<code>ragents.model-relay</code> plugin, which offers that server&#39;s <code>MODEL_ALIASES</code>: set
-<code>AGENT_PROVIDER: &quot;relay&quot;</code>, point <code>RELAY_URL</code> to that server, use <code>RELAY_TOKEN: env(&quot;...&quot;)</code> with a
-user&#39;s personal token there, and use relay aliases for every model key. Only the relay server can
-see which model is behind an alias. Its log at <code>plugins/ragents.model-relay/relay.log</code> records the
-user, alias, target, and token count for each request.</p>
+<code>ragents.model-relay</code> plugin, which offers that server&#39;s <code>MODEL_ALIASES</code> with their compaction
+values: set <code>AGENT_PROVIDER: &quot;relay&quot;</code>, point <code>RELAY_URL</code> to that server, use
+<code>RELAY_TOKEN: env(&quot;...&quot;)</code> with a user&#39;s personal token there, and use relay aliases for every model
+key. Only the relay server can see which model is behind an alias. Its log at
+<code>plugins/ragents.model-relay/relay.log</code> records the user, alias, target, and token count for each
+request.</p>
 <p>Then start the neutral profile:</p>
 <pre><code class="language-sh">scripts/start.sh core
 </code></pre>

package/apps/web/dist/help/guide-getting-started.md

@@ -35,16 +35,20 @@ take precedence over profile values; no `.env` file is loaded. Startup reports a
 referenced variable as an error. Configured models and reasoning levels must be valid in the
 available model catalog.
 
-A profile can also name its models by alias: `MODEL_ALIASES` in the `host` section lists
-`alias=provider/model` or `alias=provider/model@thinking`, and `AGENT_PROVIDER: "alias"` makes the
-product use them. The interface, the chat, and the journal then show only the alias names.
+A profile can also name its models by alias: `MODEL_ALIASES` in the `host` section lists objects
+with `alias`, `model` as `provider/model`, an optional default `thinking` level, and the model's
+`compaction` values: the context size in tokens at which an agent compacts (`threshold`), how much
+recent context stays verbatim (`keepRecentTokens`), and the summary budget (`summaryTokens`).
+`AGENT_PROVIDER: "alias"` makes the product use them. The interface, the chat, and the journal then
+show only the alias names.
 
 Alternatively, a profile can obtain its models from another RAgents server running the
-`ragents.model-relay` plugin, which offers that server's `MODEL_ALIASES`: set
-`AGENT_PROVIDER: "relay"`, point `RELAY_URL` to that server, use `RELAY_TOKEN: env("...")` with a
-user's personal token there, and use relay aliases for every model key. Only the relay server can
-see which model is behind an alias. Its log at `plugins/ragents.model-relay/relay.log` records the
-user, alias, target, and token count for each request.
+`ragents.model-relay` plugin, which offers that server's `MODEL_ALIASES` with their compaction
+values: set `AGENT_PROVIDER: "relay"`, point `RELAY_URL` to that server, use
+`RELAY_TOKEN: env("...")` with a user's personal token there, and use relay aliases for every model
+key. Only the relay server can see which model is behind an alias. Its log at
+`plugins/ragents.model-relay/relay.log` records the user, alias, target, and token count for each
+request.
 
 Then start the neutral profile:
 

package/apps/web/dist/help/guide-plugins.html

@@ -312,6 +312,7 @@ the built-in plugins live under <code>plugins/&lt;id&gt;/</code>:</p>
   contract.ts        import-free contract shared by both halves, when present
   prompt.hbs         assets at the plugin root, alongside prompts/, skills/,
                      run-scripts/, provision.ts
+  executor.ts        contribution to the workspace executor, when present
 </code></pre>
 <p><code>server/index.ts</code> exports exactly one entry point:</p>
 <pre><code class="language-ts">export const plugin: PluginModule = {
@@ -379,7 +380,8 @@ loads plugin sources; it loads finished bundles, and the author builds them. The
 <code>@schlenkr/ragents</code> carries everything this needs, so an empty folder and the package are enough.</p>
 <p><strong>Source folder.</strong> One folder per plugin, named after its ID, such as <code>acme.tickets</code>. It holds
 <code>ragents-plugin.json</code>, <code>server/index.ts</code> exporting <code>plugin</code>, optionally <code>provision.ts</code> for tools the
-plugin installs, <code>web/index.tsx</code> exporting <code>webPlugin</code> when there is an interface, and assets such
+plugin installs and <code>executor.ts</code> for work that runs on the machine of a workspace, such as a
+language server, <code>web/index.tsx</code> exporting <code>webPlugin</code> when there is an interface, and assets such
 as <code>prompt.hbs</code>, <code>prompts/</code>, <code>skills/</code>, and <code>run-scripts/</code> at the root. <code>ragents-plugin.json</code>
 names the ID, the files other plugins may import (per half, as paths without extension), and
 additional assets that go into the bundle:</p>
@@ -422,7 +424,9 @@ so does a host with the same number that lacks one of the names, as an older hos
 changes only when the host API changes incompatibly, not with every host release.</p>
 <p><strong>Ship.</strong> A bundle is a plain folder without <code>node_modules</code> or native binaries and runs wherever a
 host offers the same host API with the names it uses. Native tools such as language servers come through the plugin&#39;s
-provisioning. To hand a profile together with its bundles to other machines, a server adds
+provisioning. The contribution to the workspace executor becomes one self-contained file that
+imports only Node modules, so every machine can load it, the VS Code extension included; a
+workstation loads it from the bundles of its own host, in exactly the version the server uses. To hand a profile together with its bundles to other machines, a server adds
 <code>ragents.profile-distribution</code>; <code>ragents connect</code> fetches the profile and its bundles and starts
 them with the local host (<a href="guide-distributed.html">Distributed work</a>). The client
 profile names such bundles relative to itself (<code>./</code> or <code>../</code>); the client resolves an absolute or

package/apps/web/dist/help/guide-plugins.md

@@ -174,6 +174,7 @@ plugins/ragents.actor-programs/
   contract.ts        import-free contract shared by both halves, when present
   prompt.hbs         assets at the plugin root, alongside prompts/, skills/,
                      run-scripts/, provision.ts
+  executor.ts        contribution to the workspace executor, when present
 ```
 
 `server/index.ts` exports exactly one entry point:
@@ -257,7 +258,8 @@ loads plugin sources; it loads finished bundles, and the author builds them. The
 
 **Source folder.** One folder per plugin, named after its ID, such as `acme.tickets`. It holds
 `ragents-plugin.json`, `server/index.ts` exporting `plugin`, optionally `provision.ts` for tools the
-plugin installs, `web/index.tsx` exporting `webPlugin` when there is an interface, and assets such
+plugin installs and `executor.ts` for work that runs on the machine of a workspace, such as a
+language server, `web/index.tsx` exporting `webPlugin` when there is an interface, and assets such
 as `prompt.hbs`, `prompts/`, `skills/`, and `run-scripts/` at the root. `ragents-plugin.json`
 names the ID, the files other plugins may import (per half, as paths without extension), and
 additional assets that go into the bundle:
@@ -310,7 +312,9 @@ changes only when the host API changes incompatibly, not with every host release
 
 **Ship.** A bundle is a plain folder without `node_modules` or native binaries and runs wherever a
 host offers the same host API with the names it uses. Native tools such as language servers come through the plugin's
-provisioning. To hand a profile together with its bundles to other machines, a server adds
+provisioning. The contribution to the workspace executor becomes one self-contained file that
+imports only Node modules, so every machine can load it, the VS Code extension included; a
+workstation loads it from the bundles of its own host, in exactly the version the server uses. To hand a profile together with its bundles to other machines, a server adds
 `ragents.profile-distribution`; `ragents connect` fetches the profile and its bundles and starts
 them with the local host ([Distributed work](guide-distributed.html)). The client
 profile names such bundles relative to itself (`./` or `../`); the client resolves an absolute or

package/apps/web/dist/help/guide-runtime.html

@@ -200,7 +200,8 @@ copy of the current model context, and a new turn does not mean the model starts
 conversation memory.</p>
 <p>When the context grows too large, the agent compacts it: older parts are replaced by a summary
 written by the model, and recent parts are kept. A compaction is recorded in the journal as well,
-and the chat shows a short system note.</p>
+and the chat shows a short system note. When it starts, how much recent context stays verbatim,
+and how long the summary may be are values of the model; a profile sets them for each model alias.</p>
 <h2 id="interrupting-a-turn-stopping-an-actor-stopping-a-run-and-shutting-down-the-server">Interrupting a turn, stopping an actor, stopping a run, and shutting down the server</h2>
 <p>All stop paths follow the same principle: block new work first, then cancel, wait for running
 work, and only then release resources. The exact boundary differs:</p>

package/apps/web/dist/help/guide-runtime.md

@@ -84,7 +84,8 @@ conversation memory.
 
 When the context grows too large, the agent compacts it: older parts are replaced by a summary
 written by the model, and recent parts are kept. A compaction is recorded in the journal as well,
-and the chat shows a short system note.
+and the chat shows a short system note. When it starts, how much recent context stays verbatim,
+and how long the summary may be are values of the model; a profile sets them for each model alias.
 
 ## Interrupting a turn, stopping an actor, stopping a run, and shutting down the server