@schlenkr/ragents 0.1.13 → 0.1.15

package/bundles/ragents.processes/web/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["ragents-host-read:read", "ragents-host-value:typebox#Type", "ragents-host-value:@ragents/engine/src/rpc/contract#defineChannel", "ragents-host-value:@ragents/engine/src/rpc/contract#defineOperation", "ragents-host-value:@ragents/engine/src/http/contracts#openJson", "../../../plugins/ragents.processes/contract.ts", "ragents-host-value:react#useEffect", "ragents-host-value:react#useLayoutEffect", "ragents-host-value:react#useRef", "ragents-host-value:react#useState", "ragents-host-value:@ragents/web/AccessContext#useAccess", "ragents-host-value:@ragents/web/ui#Dialog", "ragents-host-value:@ragents/web/ui#DialogBody", "ragents-host-value:@ragents/web/ui#DialogContent", "ragents-host-value:@ragents/web/ui#DialogHeader", "ragents-host-value:@ragents/web/ui#DialogTitle", "ragents-host-value:@ragents/web/ui#StopButton", "ragents-host-value:@ragents/web/ui#cn", "ragents-host-value:@ragents/web/Toolbar#ToolbarCopy", "ragents-host-value:@ragents/web/Toolbar#ToolbarItem", "ragents-host-value:@ragents/web/Toolbar#ToolbarLabel", "ragents-host-value:@ragents/web/Toolbar#ToolbarText", "ragents-host-value:@ragents/web/rpc#rpc", "ragents-host-value:@ragents/web/lib/guards#isRecord", "../../../plugins/ragents.processes/web/processes.ts", "ragents-host-value:react/jsx-runtime#Fragment", "ragents-host-value:react/jsx-runtime#jsx", "ragents-host-value:react/jsx-runtime#jsxs", "../../../plugins/ragents.processes/web/ProcessHeader.tsx", "../../../plugins/ragents.processes/web/index.tsx"],
-  "sourcesContent": ["export const read = (specifier, name) => {\n  const module = globalThis[\"__ragentsHostModules\"]?.[specifier];\n  if (module === undefined) throw new Error(`The host does not provide ${specifier}`);\n  if (!(name in module)) throw new Error(`The host does not provide ${name} from ${specifier}; the bundle was built against a newer host`);\n  return module[name];\n};", "import { read } from \"ragents-host-read:read\";\nexport default read(\"typebox\", \"Type\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/rpc/contract\", \"defineChannel\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/rpc/contract\", \"defineOperation\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/http/contracts\", \"openJson\");\n", "import { Type } from \"typebox\";\nimport { defineChannel, defineOperation } from \"@ragents/engine/src/rpc/contract\";\nimport { openJson } from \"@ragents/engine/src/http/contracts\";\n\nexport const PROCESSES_PLUGIN_ID = \"ragents.processes\";\n\nexport interface RunProcessPort {\n  port: number;\n  address: string;\n}\n\nexport type RunProcessOrigin = \"tool-call\" | \"background\";\n\nexport interface RunProcess {\n  id: string;\n  pid: number;\n  label: string;\n  command: string;\n  origin: RunProcessOrigin;\n  ports: RunProcessPort[];\n  seenSince: string;\n}\n\nexport interface RunProcessSnapshot {\n  runId: string;\n  observedAt: string;\n  processes: RunProcess[];\n}\n\nexport type RunProcessMessage =\n  | { kind: \"snapshot\"; snapshot: RunProcessSnapshot }\n  | { kind: \"error\"; error: string };\n\nconst runId = Type.String({ minLength: 1, maxLength: 64, description: \"Run id\" });\n\nexport const processesContracts = {\n  snapshot: defineOperation({\n    id: \"ragents.processes.snapshot\",\n    description: \"The observed processes of a run with their open ports. Rights: runs.read and ragents.processes.read.\",\n    rights: [\"runs.read\", \"ragents.processes.read\"],\n    input: Type.Object({ runId }, { additionalProperties: false }),\n    result: openJson<RunProcessSnapshot>(\"RunProcessSnapshot\"),\n  }),\n  stop: defineOperation({\n    id: \"ragents.processes.stop\",\n    description: \"End a process of the run. Rights: runs.read, runs.write and runs.inspect.\",\n    rights: [\"runs.read\", \"runs.write\", \"runs.inspect\"],\n    input: Type.Object({\n      runId,\n      processId: Type.String({ pattern: \"^[1-9][0-9]*-[a-f0-9]{64}$\", description: \"Process id from the snapshot\" }),\n    }, { additionalProperties: false }),\n    result: Type.Null(),\n  }),\n  live: defineChannel({\n    id: \"ragents.processes\",\n    description: \"The live state of a run's process monitoring. Rights: runs.read and ragents.processes.read.\",\n    rights: [\"runs.read\", \"ragents.processes.read\"],\n    params: Type.Object({ runId }, { additionalProperties: false }),\n    message: openJson<RunProcessMessage>(\"RunProcessMessage\"),\n  }),\n};\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useEffect\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useLayoutEffect\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useRef\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useState\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/AccessContext\", \"useAccess\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"Dialog\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogBody\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogContent\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogHeader\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogTitle\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"StopButton\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"cn\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarCopy\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarItem\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarLabel\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarText\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/rpc\", \"rpc\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/lib/guards\", \"isRecord\");\n", "import { isRecord } from \"@ragents/web/lib/guards\";\nimport type { RunProcess, RunProcessMessage, RunProcessPort, RunProcessSnapshot } from \"../contract\";\n\nexport const VISIBLE_PROCESSES = 4;\n\nconst ORIGINS = [\"tool-call\", \"background\"] as const;\n\nconst portFrom = (value: unknown): RunProcessPort => {\n  if (!isRecord(value) || typeof value.port !== \"number\" || typeof value.address !== \"string\") {\n    throw new Error(\"A port entry of the process monitoring is unreadable\");\n  }\n  return { port: value.port, address: value.address };\n};\n\nconst processFrom = (value: unknown): RunProcess => {\n  if (!isRecord(value) || typeof value.id !== \"string\" || !value.id || typeof value.pid !== \"number\" || typeof value.label !== \"string\"\n    || typeof value.command !== \"string\" || typeof value.seenSince !== \"string\"\n    || !ORIGINS.includes(value.origin as RunProcess[\"origin\"]) || !Array.isArray(value.ports)) {\n    throw new Error(\"A process entry of the process monitoring is unreadable\");\n  }\n  return {\n    id: value.id,\n    pid: value.pid,\n    label: value.label,\n    command: value.command,\n    origin: value.origin as RunProcess[\"origin\"],\n    ports: value.ports.map(portFrom),\n    seenSince: value.seenSince,\n  };\n};\n\nconst snapshotFrom = (value: unknown): RunProcessSnapshot => {\n  if (!isRecord(value) || typeof value.runId !== \"string\" || typeof value.observedAt !== \"string\"\n    || !Array.isArray(value.processes)) {\n    throw new Error(\"The process monitoring snapshot is unreadable\");\n  }\n  return { runId: value.runId, observedAt: value.observedAt, processes: value.processes.map(processFrom) };\n};\n\nexport const messageFrom = (value: unknown): RunProcessMessage => {\n  if (!isRecord(value)) throw new Error(\"The process monitoring message is unreadable\");\n  if (value.kind === \"error\" && typeof value.error === \"string\") return { kind: \"error\", error: value.error };\n  if (value.kind === \"snapshot\") return { kind: \"snapshot\", snapshot: snapshotFrom(value.snapshot) };\n  throw new Error(\"The process monitoring message has an unknown kind\");\n};\n\nexport const serviceUrl = (hostname: string, port: number): string =>\n  `http://${hostname.includes(\":\") ? `[${hostname}]` : hostname}:${port}/`;\n\nexport const kindLabel = (process: RunProcess): string => process.ports.length > 0 ? \"Service\" : \"Process\";\n\nconst originText = (origin: RunProcess[\"origin\"]): string =>\n  origin === \"background\" ? \"keeps running in the background\" : \"runs in a tool call\";\n\nconst timeText = (iso: string): string => {\n  const parsed = new Date(iso);\n  return Number.isNaN(parsed.getTime()) ? iso : parsed.toLocaleTimeString(\"en-US\");\n};\n\nexport const titleOf = (process: RunProcess): string => {\n  const ports = process.ports.length > 0\n    ? `\\nListening on ${process.ports.map((port) => `${port.address}:${port.port}`).join(\", \")}`\n    : \"\";\n  return `${process.command}\\nPID ${process.pid}, ${originText(process.origin)}, observed since ${timeText(process.seenSince)}${ports}`;\n};\n\nexport interface VisibleProcesses {\n  shown: readonly RunProcess[];\n  hidden: number;\n}\n\nexport const visibleProcesses = (processes: readonly RunProcess[]): VisibleProcesses => ({\n  shown: processes.slice(0, VISIBLE_PROCESSES),\n  hidden: Math.max(0, processes.length - VISIBLE_PROCESSES),\n});\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"Fragment\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"jsx\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"jsxs\");\n", "import { useEffect, useLayoutEffect, useRef, useState, type ComponentType, type FocusEvent } from \"react\";\nimport { useAccess } from \"@ragents/web/AccessContext\";\nimport type { SessionHeaderContext } from \"@ragents/web/PluginRegistry\";\nimport { Dialog, DialogBody, DialogContent, DialogHeader, DialogTitle, StopButton, cn } from \"@ragents/web/ui\";\nimport { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from \"@ragents/web/Toolbar\";\nimport { rpc } from \"@ragents/web/rpc\";\nimport { processesContracts, type RunProcess, type RunProcessSnapshot } from \"../contract\";\nimport { kindLabel, messageFrom, serviceUrl, titleOf, visibleProcesses } from \"./processes\";\n\ninterface ProcessWatchState {\n  snapshot: RunProcessSnapshot | undefined;\n  error: string | undefined;\n}\n\nconst idle: ProcessWatchState = { snapshot: undefined, error: undefined };\n\nconst pillClass = \"inline-flex h-6 min-w-0 items-center gap-1.5 whitespace-nowrap rounded-full border border-border-soft bg-card/78 pl-2.5 pr-0.5 text-xs font-medium text-muted-foreground data-[origin=background]:border-dashed [&>svg]:flex-none\";\nconst portClass = \"flex-none rounded-full bg-primary/14 px-1.5 py-px text-foreground tabular-nums underline underline-offset-2 hover:bg-primary/28 focus-visible:bg-primary/28\";\nconst stopClass = \"size-5 min-w-5 rounded-full p-0.75 [&_svg]:size-2.5\";\n\nconst useRunProcesses = (runId: string): ProcessWatchState => {\n  const [state, setState] = useState<ProcessWatchState>(idle);\n  useEffect(() => {\n    setState(idle);\n    return rpc.subscribe(processesContracts.live, { runId }, (data) => {\n      try {\n        const message = messageFrom(data);\n        if (message.kind === \"snapshot\" && message.snapshot.runId !== runId) throw new Error(\"The process snapshot belongs to another run\");\n        setState((current) => message.kind === \"snapshot\"\n          ? { snapshot: message.snapshot, error: undefined }\n          : { snapshot: current.snapshot, error: message.error });\n      } catch (caught) {\n        setState((current) => ({ ...current, error: caught instanceof Error ? caught.message : String(caught) }));\n      }\n    }, (message) => setState((current) => ({ ...current, error: message })));\n  }, [runId]);\n  return state;\n};\n\nfunction IconProcess() {\n  return <svg aria-hidden fill=\"none\" height=\"12\" stroke=\"currentColor\" strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth=\"1.8\" viewBox=\"0 0 24 24\" width=\"12\">\n    <rect height=\"16\" rx=\"2\" width=\"18\" x=\"3\" y=\"4\" />\n    <path d=\"m7 9 3 3-3 3M13 15h4\" />\n  </svg>;\n}\n\ninterface StopState { busy?: boolean; error?: string }\n\nfunction ProcessPill({ process, state, writable, onStop, toolbar = false }: { process: RunProcess; state?: StopState; writable: boolean; onStop: () => void; toolbar?: boolean }) {\n  const stop = <StopButton busy={state?.busy === true} className={stopClass} disabled={!writable || state?.busy}\n    label={state?.busy ? `Stopping ${process.label}` : `Stop ${process.label}`}\n    onClick={onStop} size=\"icon-xs\"\n    title={!writable ? \"Write or inspect rights are missing to stop\" : state?.busy ? \"Stopping ...\" : `Stop ${process.label}`} />;\n  const ports = process.ports.map((port) => <a className={portClass} href={serviceUrl(window.location.hostname, port.port)}\n    key={`${port.address}:${port.port}`} rel=\"noreferrer\" target=\"_blank\" title={`Open ${port.address}:${port.port} in a new tab`}>\n    :{port.port}\n  </a>);\n  return <div className={cn(\"flex min-w-0 flex-col\", toolbar ? \"flex-none self-stretch max-md:not-first:hidden\" : \"w-full\")} data-process-id={process.id}>\n    {toolbar\n      ? <ToolbarItem className=\"max-w-none flex-1 data-[origin=background]:[border-right-style:dashed]\" data-origin={process.origin} title={titleOf(process)}>\n        <IconProcess />\n        <ToolbarCopy className=\"w-35 flex-none\">\n          <ToolbarLabel>{kindLabel(process)}</ToolbarLabel>\n          <ToolbarText>{process.label}</ToolbarText>\n        </ToolbarCopy>\n        {ports}\n        {stop}\n      </ToolbarItem>\n      : <span className={cn(pillClass, \"w-full\")} data-origin={process.origin} title={titleOf(process)}>\n        <IconProcess />\n        <em className=\"flex-none text-[0.56rem] font-bold uppercase not-italic tracking-[0.035em]\">{kindLabel(process)}</em>\n        <span className=\"min-w-0 flex-1 overflow-hidden text-ellipsis text-foreground\">{process.label}</span>\n        {ports}\n        {stop}\n      </span>}\n    {state?.error && <span className={cn(\"text-[0.65rem] text-destructive\", toolbar ? \"max-w-62 overflow-hidden text-ellipsis whitespace-nowrap\" : \"[overflow-wrap:anywhere]\")}\n      role=\"alert\" title={state.error}>{state.error}</span>}\n  </div>;\n}\n\nfunction ProcessHeaderContent({ runId }: { runId: string }) {\n  const access = useAccess();\n  const writable = access.can(\"runs.write\") && access.can(\"runs.inspect\");\n  const state = useRunProcesses(runId);\n  const [stops, setStops] = useState<Record<string, StopState>>({});\n  const [allOpen, setAllOpen] = useState(false);\n  const requests = useRef(new Map<string, AbortController>());\n  const rootRef = useRef<HTMLDivElement>(null);\n  const dialogRef = useRef<HTMLDivElement>(null);\n  const focused = useRef<HTMLElement>(null);\n  const fallback = useRef<HTMLElement>(null);\n  const processes = state.snapshot?.processes ?? [];\n  const { shown, hidden } = visibleProcesses(processes);\n  useEffect(() => {\n    const active = requests.current;\n    return () => { for (const controller of active.values()) controller.abort(); active.clear(); };\n  }, []);\n  useLayoutEffect(() => {\n    if (!focused.current || focused.current.isConnected || document.activeElement !== document.body) return;\n    const target = (allOpen ? dialogRef.current : rootRef.current)?.querySelector<HTMLElement>(\"button:not(:disabled), a[href]\")\n      ?? (allOpen ? dialogRef.current : null) ?? fallback.current;\n    focused.current = null;\n    target?.focus({ preventScroll: true });\n  }, [state.snapshot, allOpen]);\n  const rememberFocus = (event: FocusEvent<HTMLElement>) => {\n    if (!(event.target instanceof HTMLElement)) return;\n    focused.current = event.target;\n    const header = rootRef.current?.closest(\"header\");\n    fallback.current = [...(header?.querySelectorAll<HTMLElement>(\"button:not(:disabled), a[href]\") ?? [])]\n      .find((element) => !rootRef.current?.contains(element)) ?? null;\n  };\n  const stop = async (process: RunProcess) => {\n    if (!writable || requests.current.has(process.id) || stops[process.id]?.busy) return;\n    const controller = new AbortController();\n    requests.current.set(process.id, controller);\n    setStops((current) => ({ ...current, [process.id]: { busy: true } }));\n    try {\n      await rpc.call(processesContracts.stop, { runId, processId: process.id }, { signal: controller.signal });\n    } catch (cause) {\n      if (!controller.signal.aborted) setStops((current) => ({ ...current, [process.id]: { error: cause instanceof Error ? cause.message : String(cause) } }));\n    } finally { requests.current.delete(process.id); }\n  };\n  const renderProcess = (process: RunProcess, toolbar = false) => <ProcessPill key={process.id} process={process} state={stops[process.id]} writable={writable} toolbar={toolbar} onStop={() => { void stop(process); }} />;\n  if (shown.length === 0 && state.error === undefined && !allOpen) return null;\n  return <>\n    <div aria-label=\"Processes and ports of the run\" className=\"flex min-w-0 flex-none items-stretch self-stretch\" ref={rootRef} onFocusCapture={rememberFocus}>\n      {shown.map((process) => renderProcess(process, true))}\n      {(processes.length > 1 || allOpen) && <ToolbarItem as=\"button\" className=\"md:data-[hidden=false]:hidden\" data-hidden={hidden > 0 || allOpen} type=\"button\" onClick={() => setAllOpen(true)} title=\"Show all processes of the run\">\n        <span className=\"max-md:hidden\">{hidden > 0 ? `+${hidden} more` : \"Processes\"}</span><span className=\"hidden max-md:inline\">All {processes.length}</span>\n      </ToolbarItem>}\n      {state.error !== undefined && <ToolbarItem className=\"w-42 text-destructive\" role=\"status\" title={state.error}><ToolbarCopy><ToolbarLabel>Processes</ToolbarLabel><ToolbarText>Monitoring disrupted</ToolbarText></ToolbarCopy></ToolbarItem>}\n    </div>\n    {allOpen && <Dialog open onOpenChange={(open) => {\n      if (open) return;\n      setAllOpen(false);\n      if (processes.length === 0) requestAnimationFrame(() => fallback.current?.focus({ preventScroll: true }));\n    }}>\n      <DialogContent scope=\"run\">\n        <DialogHeader><DialogTitle>Processes and ports</DialogTitle></DialogHeader>\n        <DialogBody className=\"flex flex-col gap-3 outline-none\" ref={dialogRef} tabIndex={-1} onFocusCapture={rememberFocus}>\n          {processes.length > 0 ? processes.map((process) => renderProcess(process)) : <p role=\"status\">No active processes.</p>}\n          {state.error !== undefined && <p className=\"text-destructive\" role=\"alert\">{state.error}</p>}\n        </DialogBody>\n      </DialogContent>\n    </Dialog>}\n  </>;\n}\n\nexport const processHeader = (): ComponentType<SessionHeaderContext> =>\n  function ProcessHeader({ session }: SessionHeaderContext) {\n    const access = useAccess();\n    return access.can(\"runs.read\") && access.can(\"ragents.processes.read\")\n      ? <ProcessHeaderContent key={session.session.id} runId={session.session.id} /> : null;\n  };\n", "import {\n  type WebPlugin,\n  type WebPluginDescriptor,\n} from \"@ragents/web/PluginRegistry\";\nimport { PROCESSES_PLUGIN_ID } from \"../contract\";\nimport { processHeader } from \"./ProcessHeader\";\n\nconst configuredPlugin = (descriptor: WebPluginDescriptor): WebPlugin => ({\n  ...descriptor,\n  sessionHeaders: [{\n    readRight: \"ragents.processes.read\",\n    requiresWorkspace: true,\n    id: \"ragents.processes.live\",\n    order: 110,\n    Header: processHeader(),\n  }],\n});\n\nconst descriptor: WebPluginDescriptor = { id: PROCESSES_PLUGIN_ID };\n\nexport const webPlugin: WebPlugin = {\n  ...descriptor,\n  activate: () => configuredPlugin(descriptor),\n};\n"],
-  "mappings": "AAAO,IAAMA,EAAO,CAACC,EAAWC,IAAS,CACvC,IAAMC,EAAS,WAAW,uBAA0BF,CAAS,EAC7D,GAAIE,IAAW,OAAW,MAAM,IAAI,MAAM,6BAA6BF,CAAS,EAAE,EAClF,GAAI,EAAEC,KAAQC,GAAS,MAAM,IAAI,MAAM,6BAA6BD,CAAI,SAASD,CAAS,6CAA6C,EACvI,OAAOE,EAAOD,CAAI,CACpB,ECJA,IAAOE,EAAQC,EAAK,UAAW,MAAM,ECArC,IAAOC,EAAQC,EAAK,mCAAoC,eAAe,ECAvE,IAAOC,EAAQC,EAAK,mCAAoC,iBAAiB,ECAzE,IAAOC,EAAQC,EAAK,qCAAsC,UAAU,ECG7D,IAAMC,EAAsB,oBA6B7BC,EAAQC,EAAK,OAAO,CAAE,UAAW,EAAG,UAAW,GAAI,YAAa,QAAS,CAAC,EAEnEC,EAAqB,CAChC,SAAUC,EAAgB,CACxB,GAAI,6BACJ,YAAa,uGACb,OAAQ,CAAC,YAAa,wBAAwB,EAC9C,MAAOF,EAAK,OAAO,CAAE,MAAAD,CAAM,EAAG,CAAE,qBAAsB,EAAM,CAAC,EAC7D,OAAQI,EAA6B,oBAAoB,CAC3D,CAAC,EACD,KAAMD,EAAgB,CACpB,GAAI,yBACJ,YAAa,4EACb,OAAQ,CAAC,YAAa,aAAc,cAAc,EAClD,MAAOF,EAAK,OAAO,CACjB,MAAAD,EACA,UAAWC,EAAK,OAAO,CAAE,QAAS,6BAA8B,YAAa,8BAA+B,CAAC,CAC/G,EAAG,CAAE,qBAAsB,EAAM,CAAC,EAClC,OAAQA,EAAK,KAAK,CACpB,CAAC,EACD,KAAMI,EAAc,CAClB,GAAI,oBACJ,YAAa,8FACb,OAAQ,CAAC,YAAa,wBAAwB,EAC9C,OAAQJ,EAAK,OAAO,CAAE,MAAAD,CAAM,EAAG,CAAE,qBAAsB,EAAM,CAAC,EAC9D,QAASI,EAA4B,mBAAmB,CAC1D,CAAC,CACH,EC3DA,IAAOE,EAAQC,EAAK,QAAS,WAAW,ECAxC,IAAOC,EAAQC,EAAK,QAAS,iBAAiB,ECA9C,IAAOC,EAAQC,EAAK,QAAS,QAAQ,ECArC,IAAOC,EAAQC,EAAK,QAAS,UAAU,ECAvC,IAAOC,EAAQC,EAAK,6BAA8B,WAAW,ECA7D,IAAOC,EAAQC,EAAK,kBAAmB,QAAQ,ECA/C,IAAOC,EAAQC,EAAK,kBAAmB,YAAY,ECAnD,IAAOC,EAAQC,EAAK,kBAAmB,eAAe,ECAtD,IAAOC,EAAQC,EAAK,kBAAmB,cAAc,ECArD,IAAOC,EAAQC,EAAK,kBAAmB,aAAa,ECApD,IAAOC,EAAQC,EAAK,kBAAmB,YAAY,ECAnD,IAAOC,EAAQC,EAAK,kBAAmB,IAAI,ECA3C,IAAOC,EAAQC,EAAK,uBAAwB,aAAa,ECAzD,IAAOC,EAAQC,EAAK,uBAAwB,aAAa,ECAzD,IAAOC,EAAQC,EAAK,uBAAwB,cAAc,ECA1D,IAAOC,EAAQC,EAAK,uBAAwB,aAAa,ECAzD,IAAOC,EAAQC,EAAK,mBAAoB,KAAK,ECA7C,IAAOC,EAAQC,EAAK,0BAA2B,UAAU,ECElD,IAAMC,EAAoB,EAE3BC,GAAU,CAAC,YAAa,YAAY,EAEpCC,GAAYC,GAAmC,CACnD,GAAI,CAACC,EAASD,CAAK,GAAK,OAAOA,EAAM,MAAS,UAAY,OAAOA,EAAM,SAAY,SACjF,MAAM,IAAI,MAAM,sDAAsD,EAExE,MAAO,CAAE,KAAMA,EAAM,KAAM,QAASA,EAAM,OAAQ,CACpD,EAEME,GAAeF,GAA+B,CAClD,GAAI,CAACC,EAASD,CAAK,GAAK,OAAOA,EAAM,IAAO,UAAY,CAACA,EAAM,IAAM,OAAOA,EAAM,KAAQ,UAAY,OAAOA,EAAM,OAAU,UACxH,OAAOA,EAAM,SAAY,UAAY,OAAOA,EAAM,WAAc,UAChE,CAACF,GAAQ,SAASE,EAAM,MAA8B,GAAK,CAAC,MAAM,QAAQA,EAAM,KAAK,EACxF,MAAM,IAAI,MAAM,yDAAyD,EAE3E,MAAO,CACL,GAAIA,EAAM,GACV,IAAKA,EAAM,IACX,MAAOA,EAAM,MACb,QAASA,EAAM,QACf,OAAQA,EAAM,OACd,MAAOA,EAAM,MAAM,IAAID,EAAQ,EAC/B,UAAWC,EAAM,SACnB,CACF,EAEMG,GAAgBH,GAAuC,CAC3D,GAAI,CAACC,EAASD,CAAK,GAAK,OAAOA,EAAM,OAAU,UAAY,OAAOA,EAAM,YAAe,UAClF,CAAC,MAAM,QAAQA,EAAM,SAAS,EACjC,MAAM,IAAI,MAAM,+CAA+C,EAEjE,MAAO,CAAE,MAAOA,EAAM,MAAO,WAAYA,EAAM,WAAY,UAAWA,EAAM,UAAU,IAAIE,EAAW,CAAE,CACzG,EAEaE,EAAeJ,GAAsC,CAChE,GAAI,CAACC,EAASD,CAAK,EAAG,MAAM,IAAI,MAAM,8CAA8C,EACpF,GAAIA,EAAM,OAAS,SAAW,OAAOA,EAAM,OAAU,SAAU,MAAO,CAAE,KAAM,QAAS,MAAOA,EAAM,KAAM,EAC1G,GAAIA,EAAM,OAAS,WAAY,MAAO,CAAE,KAAM,WAAY,SAAUG,GAAaH,EAAM,QAAQ,CAAE,EACjG,MAAM,IAAI,MAAM,oDAAoD,CACtE,EAEaK,GAAa,CAACC,EAAkBC,IAC3C,UAAUD,EAAS,SAAS,GAAG,EAAI,IAAIA,CAAQ,IAAMA,CAAQ,IAAIC,CAAI,IAE1DC,EAAaC,GAAgCA,EAAQ,MAAM,OAAS,EAAI,UAAY,UAE3FC,GAAcC,GAClBA,IAAW,aAAe,kCAAoC,sBAE1DC,GAAYC,GAAwB,CACxC,IAAMC,EAAS,IAAI,KAAKD,CAAG,EAC3B,OAAO,OAAO,MAAMC,EAAO,QAAQ,CAAC,EAAID,EAAMC,EAAO,mBAAmB,OAAO,CACjF,EAEaC,EAAWN,GAAgC,CACtD,IAAMO,EAAQP,EAAQ,MAAM,OAAS,EACjC;AAAA,eAAkBA,EAAQ,MAAM,IAAKF,GAAS,GAAGA,EAAK,OAAO,IAAIA,EAAK,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC,GACxF,GACJ,MAAO,GAAGE,EAAQ,OAAO;AAAA,MAASA,EAAQ,GAAG,KAAKC,GAAWD,EAAQ,MAAM,CAAC,oBAAoBG,GAASH,EAAQ,SAAS,CAAC,GAAGO,CAAK,EACrI,EAOaC,GAAoBC,IAAwD,CACvF,MAAOA,EAAU,MAAM,EAAGrB,CAAiB,EAC3C,OAAQ,KAAK,IAAI,EAAGqB,EAAU,OAASrB,CAAiB,CAC1D,GCzEA,IAAOsB,EAAQC,EAAK,oBAAqB,UAAU,ECAnD,IAAOC,EAAQC,EAAK,oBAAqB,KAAK,ECA9C,IAAOC,EAAQC,EAAK,oBAAqB,MAAM,ECa/C,IAAMC,GAA0B,CAAE,SAAU,OAAW,MAAO,MAAU,EAElEC,GAAY,oOACZC,GAAY,8JACZC,GAAY,sDAEZC,GAAmBC,GAAqC,CAC5D,GAAM,CAACC,EAAOC,CAAQ,EAAIC,EAA4BR,EAAI,EAC1D,OAAAS,EAAU,KACRF,EAASP,EAAI,EACNU,EAAI,UAAUC,EAAmB,KAAM,CAAE,MAAAN,CAAM,EAAIO,GAAS,CACjE,GAAI,CACF,IAAMC,EAAUC,EAAYF,CAAI,EAChC,GAAIC,EAAQ,OAAS,YAAcA,EAAQ,SAAS,QAAUR,EAAO,MAAM,IAAI,MAAM,6CAA6C,EAClIE,EAAUQ,GAAYF,EAAQ,OAAS,WACnC,CAAE,SAAUA,EAAQ,SAAU,MAAO,MAAU,EAC/C,CAAE,SAAUE,EAAQ,SAAU,MAAOF,EAAQ,KAAM,CAAC,CAC1D,OAASG,EAAQ,CACfT,EAAUQ,IAAa,CAAE,GAAGA,EAAS,MAAOC,aAAkB,MAAQA,EAAO,QAAU,OAAOA,CAAM,CAAE,EAAE,CAC1G,CACF,EAAIH,GAAYN,EAAUQ,IAAa,CAAE,GAAGA,EAAS,MAAOF,CAAQ,EAAE,CAAC,GACtE,CAACR,CAAK,CAAC,EACHC,CACT,EAEA,SAASW,IAAc,CACrB,OAAOC,EAAC,OAAI,cAAW,GAAC,KAAK,OAAO,OAAO,KAAK,OAAO,eAAe,cAAc,QAAQ,eAAe,QAAQ,YAAY,MAAM,QAAQ,YAAY,MAAM,KAC7J,UAAAC,EAAC,QAAK,OAAO,KAAK,GAAG,IAAI,MAAM,KAAK,EAAE,IAAI,EAAE,IAAI,EAChDA,EAAC,QAAK,EAAE,uBAAuB,GACjC,CACF,CAIA,SAASC,GAAY,CAAE,QAAAC,EAAS,MAAAf,EAAO,SAAAgB,EAAU,OAAAC,EAAQ,QAAAC,EAAU,EAAM,EAAyG,CAChL,IAAMC,EAAON,EAACO,EAAA,CAAW,KAAMpB,GAAO,OAAS,GAAM,UAAWH,GAAW,SAAU,CAACmB,GAAYhB,GAAO,KACvG,MAAOA,GAAO,KAAO,YAAYe,EAAQ,KAAK,GAAK,QAAQA,EAAQ,KAAK,GACxE,QAASE,EAAQ,KAAK,UACtB,MAAQD,EAA2DhB,GAAO,KAAO,eAAiB,QAAQe,EAAQ,KAAK,GAApG,8CAAwG,EACvHM,EAAQN,EAAQ,MAAM,IAAKO,GAASV,EAAC,KAAE,UAAWhB,GAAW,KAAM2B,GAAW,OAAO,SAAS,SAAUD,EAAK,IAAI,EAChF,IAAI,aAAa,OAAO,SAAS,MAAO,QAAQA,EAAK,OAAO,IAAIA,EAAK,IAAI,gBAAiB,cAC7HA,EAAK,OADF,GAAGA,EAAK,OAAO,IAAIA,EAAK,IAAI,EAEnC,CAAI,EACJ,OAAOV,EAAC,OAAI,UAAWY,EAAG,wBAAyBN,EAAU,iDAAmD,QAAQ,EAAG,kBAAiBH,EAAQ,GACjJ,UAAAG,EACGN,EAACa,EAAA,CAAY,UAAU,yEAAyE,cAAaV,EAAQ,OAAQ,MAAOW,EAAQX,CAAO,EACnJ,UAAAF,EAACF,GAAA,EAAY,EACbC,EAACe,EAAA,CAAY,UAAU,iBACrB,UAAAd,EAACe,EAAA,CAAc,SAAAC,EAAUd,CAAO,EAAE,EAClCF,EAACiB,EAAA,CAAa,SAAAf,EAAQ,MAAM,GAC9B,EACCM,EACAF,GACH,EACEP,EAAC,QAAK,UAAWY,EAAG7B,GAAW,QAAQ,EAAG,cAAaoB,EAAQ,OAAQ,MAAOW,EAAQX,CAAO,EAC7F,UAAAF,EAACF,GAAA,EAAY,EACbE,EAAC,MAAG,UAAU,6EAA8E,SAAAgB,EAAUd,CAAO,EAAE,EAC/GF,EAAC,QAAK,UAAU,+DAAgE,SAAAE,EAAQ,MAAM,EAC7FM,EACAF,GACH,EACDnB,GAAO,OAASa,EAAC,QAAK,UAAWW,EAAG,kCAAmCN,EAAU,2DAA6D,0BAA0B,EACvK,KAAK,QAAQ,MAAOlB,EAAM,MAAQ,SAAAA,EAAM,MAAM,GAClD,CACF,CAEA,SAAS+B,GAAqB,CAAE,MAAAhC,CAAM,EAAsB,CAC1D,IAAMiC,EAASC,EAAU,EACnBjB,EAAWgB,EAAO,IAAI,YAAY,GAAKA,EAAO,IAAI,cAAc,EAChEhC,EAAQF,GAAgBC,CAAK,EAC7B,CAACmC,EAAOC,CAAQ,EAAIjC,EAAoC,CAAC,CAAC,EAC1D,CAACkC,EAASC,CAAU,EAAInC,EAAS,EAAK,EACtCoC,EAAWC,EAAO,IAAI,GAA8B,EACpDC,EAAUD,EAAuB,IAAI,EACrCE,EAAYF,EAAuB,IAAI,EACvCG,EAAUH,EAAoB,IAAI,EAClCI,EAAWJ,EAAoB,IAAI,EACnCK,EAAY5C,EAAM,UAAU,WAAa,CAAC,EAC1C,CAAE,MAAA6C,EAAO,OAAAC,CAAO,EAAIC,GAAiBH,CAAS,EACpDzC,EAAU,IAAM,CACd,IAAM6C,EAASV,EAAS,QACxB,MAAO,IAAM,CAAE,QAAWW,KAAcD,EAAO,OAAO,EAAGC,EAAW,MAAM,EAAGD,EAAO,MAAM,CAAG,CAC/F,EAAG,CAAC,CAAC,EACLE,EAAgB,IAAM,CACpB,GAAI,CAACR,EAAQ,SAAWA,EAAQ,QAAQ,aAAe,SAAS,gBAAkB,SAAS,KAAM,OACjG,IAAMS,GAAUf,EAAUK,EAAU,QAAUD,EAAQ,UAAU,cAA2B,gCAAgC,IACrHJ,EAAUK,EAAU,QAAU,OAASE,EAAS,QACtDD,EAAQ,QAAU,KAClBS,GAAQ,MAAM,CAAE,cAAe,EAAK,CAAC,CACvC,EAAG,CAACnD,EAAM,SAAUoC,CAAO,CAAC,EAC5B,IAAMgB,EAAiBC,GAAmC,CACxD,GAAI,EAAEA,EAAM,kBAAkB,aAAc,OAC5CX,EAAQ,QAAUW,EAAM,OACxB,IAAMC,EAASd,EAAQ,SAAS,QAAQ,QAAQ,EAChDG,EAAS,QAAU,CAAC,GAAIW,GAAQ,iBAA8B,gCAAgC,GAAK,CAAC,CAAE,EACnG,KAAMC,GAAY,CAACf,EAAQ,SAAS,SAASe,CAAO,CAAC,GAAK,IAC/D,EACMpC,GAAO,MAAOJ,GAAwB,CAC1C,GAAI,CAACC,GAAYsB,EAAS,QAAQ,IAAIvB,EAAQ,EAAE,GAAKmB,EAAMnB,EAAQ,EAAE,GAAG,KAAM,OAC9E,IAAMkC,EAAa,IAAI,gBACvBX,EAAS,QAAQ,IAAIvB,EAAQ,GAAIkC,CAAU,EAC3Cd,EAAU1B,IAAa,CAAE,GAAGA,EAAS,CAACM,EAAQ,EAAE,EAAG,CAAE,KAAM,EAAK,CAAE,EAAE,EACpE,GAAI,CACF,MAAMX,EAAI,KAAKC,EAAmB,KAAM,CAAE,MAAAN,EAAO,UAAWgB,EAAQ,EAAG,EAAG,CAAE,OAAQkC,EAAW,MAAO,CAAC,CACzG,OAASO,EAAO,CACTP,EAAW,OAAO,SAASd,EAAU1B,KAAa,CAAE,GAAGA,GAAS,CAACM,EAAQ,EAAE,EAAG,CAAE,MAAOyC,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CAAE,CAAE,EAAE,CACzJ,QAAE,CAAUlB,EAAS,QAAQ,OAAOvB,EAAQ,EAAE,CAAG,CACnD,EACM0C,EAAgB,CAAC1C,EAAqBG,EAAU,KAAUL,EAACC,GAAA,CAA6B,QAASC,EAAS,MAAOmB,EAAMnB,EAAQ,EAAE,EAAG,SAAUC,EAAU,QAASE,EAAS,OAAQ,IAAM,CAAOC,GAAKJ,CAAO,CAAG,GAAlIA,EAAQ,EAA6H,EACvN,OAAI8B,EAAM,SAAW,GAAK7C,EAAM,QAAU,QAAa,CAACoC,EAAgB,KACjExB,EAAA8C,EAAA,CACL,UAAA9C,EAAC,OAAI,aAAW,iCAAiC,UAAU,oDAAoD,IAAK4B,EAAS,eAAgBY,EAC1I,UAAAP,EAAM,IAAK9B,GAAY0C,EAAc1C,EAAS,EAAI,CAAC,GAClD6B,EAAU,OAAS,GAAKR,IAAYxB,EAACa,EAAA,CAAY,GAAG,SAAS,UAAU,gCAAgC,cAAaqB,EAAS,GAAKV,EAAS,KAAK,SAAS,QAAS,IAAMC,EAAW,EAAI,EAAG,MAAM,gCAChM,UAAAxB,EAAC,QAAK,UAAU,gBAAiB,SAAAiC,EAAS,EAAI,IAAIA,CAAM,QAAU,YAAY,EAAOlC,EAAC,QAAK,UAAU,uBAAuB,iBAAKgC,EAAU,QAAO,GACpJ,EACC5C,EAAM,QAAU,QAAaa,EAACY,EAAA,CAAY,UAAU,wBAAwB,KAAK,SAAS,MAAOzB,EAAM,MAAO,SAAAY,EAACe,EAAA,CAAY,UAAAd,EAACe,EAAA,CAAa,qBAAS,EAAef,EAACiB,EAAA,CAAY,gCAAoB,GAAc,EAAc,GACjO,EACCM,GAAWvB,EAAC8C,EAAA,CAAO,KAAI,GAAC,aAAeC,GAAS,CAC3CA,IACJvB,EAAW,EAAK,EACZO,EAAU,SAAW,GAAG,sBAAsB,IAAMD,EAAS,SAAS,MAAM,CAAE,cAAe,EAAK,CAAC,CAAC,EAC1G,EACE,SAAA/B,EAACiD,EAAA,CAAc,MAAM,MACnB,UAAAhD,EAACiD,EAAA,CAAa,SAAAjD,EAACkD,EAAA,CAAY,+BAAmB,EAAc,EAC5DnD,EAACoD,EAAA,CAAW,UAAU,mCAAmC,IAAKvB,EAAW,SAAU,GAAI,eAAgBW,EACpG,UAAAR,EAAU,OAAS,EAAIA,EAAU,IAAK7B,GAAY0C,EAAc1C,CAAO,CAAC,EAAIF,EAAC,KAAE,KAAK,SAAS,gCAAoB,EACjHb,EAAM,QAAU,QAAaa,EAAC,KAAE,UAAU,mBAAmB,KAAK,QAAS,SAAAb,EAAM,MAAM,GAC1F,GACF,EACF,GACF,CACF,CAEO,IAAMiE,GAAgB,IAC3B,SAAuB,CAAE,QAAAC,CAAQ,EAAyB,CACxD,IAAMlC,EAASC,EAAU,EACzB,OAAOD,EAAO,IAAI,WAAW,GAAKA,EAAO,IAAI,wBAAwB,EACjEnB,EAACkB,GAAA,CAA8C,MAAOmC,EAAQ,QAAQ,IAA3CA,EAAQ,QAAQ,EAA+B,EAAK,IACrF,EClJF,IAAMC,GAAoBC,IAAgD,CACxE,GAAGA,EACH,eAAgB,CAAC,CACf,UAAW,yBACX,kBAAmB,GACnB,GAAI,yBACJ,MAAO,IACP,OAAQC,GAAc,CACxB,CAAC,CACH,GAEMD,GAAkC,CAAE,GAAIE,CAAoB,EAErDC,GAAuB,CAClC,GAAGH,GACH,SAAU,IAAMD,GAAiBC,EAAU,CAC7C",
+  "sourcesContent": ["export const read = (specifier, name) => {\n  const module = globalThis[\"__ragentsHostModules\"]?.[specifier];\n  if (module === undefined) throw new Error(`The host does not provide ${specifier}`);\n  if (!(name in module)) throw new Error(`The host does not provide ${name} from ${specifier}; the bundle was built against a newer host`);\n  return module[name];\n};", "import { read } from \"ragents-host-read:read\";\nexport default read(\"typebox\", \"Type\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/rpc/contract\", \"defineChannel\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/rpc/contract\", \"defineOperation\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/engine/src/http/contracts\", \"openJson\");\n", "import { Type } from \"typebox\";\nimport { defineChannel, defineOperation } from \"@ragents/engine/src/rpc/contract\";\nimport { openJson } from \"@ragents/engine/src/http/contracts\";\n\nexport const PROCESSES_PLUGIN_ID = \"ragents.processes\";\n\nexport interface RunProcessPort {\n  port: number;\n  address: string;\n}\n\nexport type RunProcessOrigin = \"tool-call\" | \"background\";\n\nexport interface RunProcess {\n  id: string;\n  pid: number;\n  label: string;\n  command: string;\n  origin: RunProcessOrigin;\n  ports: RunProcessPort[];\n  seenSince: string;\n}\n\nexport interface RunProcessSnapshot {\n  runId: string;\n  observedAt: string;\n  processes: RunProcess[];\n}\n\nexport type RunProcessMessage =\n  | { kind: \"snapshot\"; snapshot: RunProcessSnapshot }\n  | { kind: \"error\"; error: string };\n\nconst runId = Type.String({ minLength: 1, maxLength: 64, description: \"Run id\" });\n\nexport const processesContracts = {\n  snapshot: defineOperation({\n    id: \"ragents.processes.snapshot\",\n    description: \"The observed processes of a run with their open ports. Rights: runs.read and ragents.processes.read.\",\n    rights: [\"runs.read\", \"ragents.processes.read\"],\n    input: Type.Object({ runId }, { additionalProperties: false }),\n    result: openJson<RunProcessSnapshot>(\"RunProcessSnapshot\"),\n  }),\n  stop: defineOperation({\n    id: \"ragents.processes.stop\",\n    description: \"End a process of the run. Rights: runs.read, runs.write and runs.inspect.\",\n    rights: [\"runs.read\", \"runs.write\", \"runs.inspect\"],\n    input: Type.Object({\n      runId,\n      processId: Type.String({ pattern: \"^[1-9][0-9]*-[a-f0-9]{64}$\", description: \"Process id from the snapshot\" }),\n    }, { additionalProperties: false }),\n    result: Type.Null(),\n  }),\n  live: defineChannel({\n    id: \"ragents.processes\",\n    description: \"The live state of a run's process monitoring. Rights: runs.read and ragents.processes.read.\",\n    rights: [\"runs.read\", \"ragents.processes.read\"],\n    params: Type.Object({ runId }, { additionalProperties: false }),\n    message: openJson<RunProcessMessage>(\"RunProcessMessage\"),\n  }),\n};\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useEffect\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useLayoutEffect\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useRef\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react\", \"useState\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/AccessContext\", \"useAccess\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"Dialog\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogBody\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogContent\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogHeader\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"DialogTitle\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"StopButton\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/ui\", \"cn\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarCopy\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarItem\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarLabel\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/Toolbar\", \"ToolbarText\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/rpc\", \"rpc\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"@ragents/web/lib/guards\", \"isRecord\");\n", "import { isRecord } from \"@ragents/web/lib/guards\";\nimport type { RunProcess, RunProcessMessage, RunProcessPort, RunProcessSnapshot } from \"../contract\";\n\nexport const VISIBLE_PROCESSES = 4;\n\nconst ORIGINS = [\"tool-call\", \"background\"] as const;\n\nconst portFrom = (value: unknown): RunProcessPort => {\n  if (!isRecord(value) || typeof value.port !== \"number\" || typeof value.address !== \"string\") {\n    throw new Error(\"A port entry of the process monitoring is unreadable\");\n  }\n  return { port: value.port, address: value.address };\n};\n\nconst processFrom = (value: unknown): RunProcess => {\n  if (!isRecord(value) || typeof value.id !== \"string\" || !value.id || typeof value.pid !== \"number\" || typeof value.label !== \"string\"\n    || typeof value.command !== \"string\" || typeof value.seenSince !== \"string\"\n    || !ORIGINS.includes(value.origin as RunProcess[\"origin\"]) || !Array.isArray(value.ports)) {\n    throw new Error(\"A process entry of the process monitoring is unreadable\");\n  }\n  return {\n    id: value.id,\n    pid: value.pid,\n    label: value.label,\n    command: value.command,\n    origin: value.origin as RunProcess[\"origin\"],\n    ports: value.ports.map(portFrom),\n    seenSince: value.seenSince,\n  };\n};\n\nconst snapshotFrom = (value: unknown): RunProcessSnapshot => {\n  if (!isRecord(value) || typeof value.runId !== \"string\" || typeof value.observedAt !== \"string\"\n    || !Array.isArray(value.processes)) {\n    throw new Error(\"The process monitoring snapshot is unreadable\");\n  }\n  return { runId: value.runId, observedAt: value.observedAt, processes: value.processes.map(processFrom) };\n};\n\nexport const messageFrom = (value: unknown): RunProcessMessage => {\n  if (!isRecord(value)) throw new Error(\"The process monitoring message is unreadable\");\n  if (value.kind === \"error\" && typeof value.error === \"string\") return { kind: \"error\", error: value.error };\n  if (value.kind === \"snapshot\") return { kind: \"snapshot\", snapshot: snapshotFrom(value.snapshot) };\n  throw new Error(\"The process monitoring message has an unknown kind\");\n};\n\nexport const serviceUrl = (hostname: string, port: number): string =>\n  `http://${hostname.includes(\":\") ? `[${hostname}]` : hostname}:${port}/`;\n\nexport const kindLabel = (process: RunProcess): string => process.ports.length > 0 ? \"Service\" : \"Process\";\n\nconst originText = (origin: RunProcess[\"origin\"]): string =>\n  origin === \"background\" ? \"keeps running in the background\" : \"runs in a tool call\";\n\nconst timeText = (iso: string): string => {\n  const parsed = new Date(iso);\n  return Number.isNaN(parsed.getTime()) ? iso : parsed.toLocaleTimeString();\n};\n\nexport const titleOf = (process: RunProcess): string => {\n  const ports = process.ports.length > 0\n    ? `\\nListening on ${process.ports.map((port) => `${port.address}:${port.port}`).join(\", \")}`\n    : \"\";\n  return `${process.command}\\nPID ${process.pid}, ${originText(process.origin)}, observed since ${timeText(process.seenSince)}${ports}`;\n};\n\nexport interface VisibleProcesses {\n  shown: readonly RunProcess[];\n  hidden: number;\n}\n\nexport const visibleProcesses = (processes: readonly RunProcess[]): VisibleProcesses => ({\n  shown: processes.slice(0, VISIBLE_PROCESSES),\n  hidden: Math.max(0, processes.length - VISIBLE_PROCESSES),\n});\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"Fragment\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"jsx\");\n", "import { read } from \"ragents-host-read:read\";\nexport default read(\"react/jsx-runtime\", \"jsxs\");\n", "import { useEffect, useLayoutEffect, useRef, useState, type ComponentType, type FocusEvent } from \"react\";\nimport { useAccess } from \"@ragents/web/AccessContext\";\nimport type { SessionHeaderContext } from \"@ragents/web/PluginRegistry\";\nimport { Dialog, DialogBody, DialogContent, DialogHeader, DialogTitle, StopButton, cn } from \"@ragents/web/ui\";\nimport { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from \"@ragents/web/Toolbar\";\nimport { rpc } from \"@ragents/web/rpc\";\nimport { processesContracts, type RunProcess, type RunProcessSnapshot } from \"../contract\";\nimport { kindLabel, messageFrom, serviceUrl, titleOf, visibleProcesses } from \"./processes\";\n\ninterface ProcessWatchState {\n  snapshot: RunProcessSnapshot | undefined;\n  error: string | undefined;\n}\n\nconst idle: ProcessWatchState = { snapshot: undefined, error: undefined };\n\nconst pillClass = \"inline-flex h-6 min-w-0 items-center gap-1.5 whitespace-nowrap rounded-full border border-border-soft bg-card/78 pl-2.5 pr-0.5 text-xs font-medium text-muted-foreground data-[origin=background]:border-dashed [&>svg]:flex-none\";\nconst portClass = \"flex-none rounded-full bg-primary/14 px-1.5 py-px text-foreground tabular-nums underline underline-offset-2 hover:bg-primary/28 focus-visible:bg-primary/28\";\nconst stopClass = \"size-5 min-w-5 rounded-full p-0.75 [&_svg]:size-2.5\";\n\nconst useRunProcesses = (runId: string): ProcessWatchState => {\n  const [state, setState] = useState<ProcessWatchState>(idle);\n  useEffect(() => {\n    setState(idle);\n    return rpc.subscribe(processesContracts.live, { runId }, (data) => {\n      try {\n        const message = messageFrom(data);\n        if (message.kind === \"snapshot\" && message.snapshot.runId !== runId) throw new Error(\"The process snapshot belongs to another run\");\n        setState((current) => message.kind === \"snapshot\"\n          ? { snapshot: message.snapshot, error: undefined }\n          : { snapshot: current.snapshot, error: message.error });\n      } catch (caught) {\n        setState((current) => ({ ...current, error: caught instanceof Error ? caught.message : String(caught) }));\n      }\n    }, (message) => setState((current) => ({ ...current, error: message })));\n  }, [runId]);\n  return state;\n};\n\nfunction IconProcess() {\n  return <svg aria-hidden fill=\"none\" height=\"12\" stroke=\"currentColor\" strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth=\"1.8\" viewBox=\"0 0 24 24\" width=\"12\">\n    <rect height=\"16\" rx=\"2\" width=\"18\" x=\"3\" y=\"4\" />\n    <path d=\"m7 9 3 3-3 3M13 15h4\" />\n  </svg>;\n}\n\ninterface StopState { busy?: boolean; error?: string }\n\nfunction ProcessPill({ process, state, writable, onStop, toolbar = false }: { process: RunProcess; state?: StopState; writable: boolean; onStop: () => void; toolbar?: boolean }) {\n  const stop = <StopButton busy={state?.busy === true} className={stopClass} disabled={!writable || state?.busy}\n    label={state?.busy ? `Stopping ${process.label}` : `Stop ${process.label}`}\n    onClick={onStop} size=\"icon-xs\"\n    title={!writable ? \"Write or inspect rights are missing to stop\" : state?.busy ? \"Stopping ...\" : `Stop ${process.label}`} />;\n  const ports = process.ports.map((port) => <a className={portClass} href={serviceUrl(window.location.hostname, port.port)}\n    key={`${port.address}:${port.port}`} rel=\"noreferrer\" target=\"_blank\" title={`Open ${port.address}:${port.port} in a new tab`}>\n    :{port.port}\n  </a>);\n  return <div className={cn(\"flex min-w-0 flex-col\", toolbar ? \"flex-none self-stretch max-md:not-first:hidden\" : \"w-full\")} data-process-id={process.id}>\n    {toolbar\n      ? <ToolbarItem className=\"max-w-none flex-1 data-[origin=background]:[border-right-style:dashed]\" data-origin={process.origin} title={titleOf(process)}>\n        <IconProcess />\n        <ToolbarCopy className=\"w-35 flex-none\">\n          <ToolbarLabel>{kindLabel(process)}</ToolbarLabel>\n          <ToolbarText>{process.label}</ToolbarText>\n        </ToolbarCopy>\n        {ports}\n        {stop}\n      </ToolbarItem>\n      : <span className={cn(pillClass, \"w-full\")} data-origin={process.origin} title={titleOf(process)}>\n        <IconProcess />\n        <em className=\"flex-none text-[0.56rem] font-bold uppercase not-italic tracking-[0.035em]\">{kindLabel(process)}</em>\n        <span className=\"min-w-0 flex-1 overflow-hidden text-ellipsis text-foreground\">{process.label}</span>\n        {ports}\n        {stop}\n      </span>}\n    {state?.error && <span className={cn(\"text-[0.65rem] text-destructive\", toolbar ? \"max-w-62 overflow-hidden text-ellipsis whitespace-nowrap\" : \"[overflow-wrap:anywhere]\")}\n      role=\"alert\" title={state.error}>{state.error}</span>}\n  </div>;\n}\n\nfunction ProcessHeaderContent({ runId }: { runId: string }) {\n  const access = useAccess();\n  const writable = access.can(\"runs.write\") && access.can(\"runs.inspect\");\n  const state = useRunProcesses(runId);\n  const [stops, setStops] = useState<Record<string, StopState>>({});\n  const [allOpen, setAllOpen] = useState(false);\n  const requests = useRef(new Map<string, AbortController>());\n  const rootRef = useRef<HTMLDivElement>(null);\n  const dialogRef = useRef<HTMLDivElement>(null);\n  const focused = useRef<HTMLElement>(null);\n  const fallback = useRef<HTMLElement>(null);\n  const processes = state.snapshot?.processes ?? [];\n  const { shown, hidden } = visibleProcesses(processes);\n  useEffect(() => {\n    const active = requests.current;\n    return () => { for (const controller of active.values()) controller.abort(); active.clear(); };\n  }, []);\n  useLayoutEffect(() => {\n    if (!focused.current || focused.current.isConnected || document.activeElement !== document.body) return;\n    const target = (allOpen ? dialogRef.current : rootRef.current)?.querySelector<HTMLElement>(\"button:not(:disabled), a[href]\")\n      ?? (allOpen ? dialogRef.current : null) ?? fallback.current;\n    focused.current = null;\n    target?.focus({ preventScroll: true });\n  }, [state.snapshot, allOpen]);\n  const rememberFocus = (event: FocusEvent<HTMLElement>) => {\n    if (!(event.target instanceof HTMLElement)) return;\n    focused.current = event.target;\n    const header = rootRef.current?.closest(\"header\");\n    fallback.current = [...(header?.querySelectorAll<HTMLElement>(\"button:not(:disabled), a[href]\") ?? [])]\n      .find((element) => !rootRef.current?.contains(element)) ?? null;\n  };\n  const stop = async (process: RunProcess) => {\n    if (!writable || requests.current.has(process.id) || stops[process.id]?.busy) return;\n    const controller = new AbortController();\n    requests.current.set(process.id, controller);\n    setStops((current) => ({ ...current, [process.id]: { busy: true } }));\n    try {\n      await rpc.call(processesContracts.stop, { runId, processId: process.id }, { signal: controller.signal });\n    } catch (cause) {\n      if (!controller.signal.aborted) setStops((current) => ({ ...current, [process.id]: { error: cause instanceof Error ? cause.message : String(cause) } }));\n    } finally { requests.current.delete(process.id); }\n  };\n  const renderProcess = (process: RunProcess, toolbar = false) => <ProcessPill key={process.id} process={process} state={stops[process.id]} writable={writable} toolbar={toolbar} onStop={() => { void stop(process); }} />;\n  if (shown.length === 0 && state.error === undefined && !allOpen) return null;\n  return <>\n    <div aria-label=\"Processes and ports of the run\" className=\"flex min-w-0 flex-none items-stretch self-stretch\" ref={rootRef} onFocusCapture={rememberFocus}>\n      {shown.map((process) => renderProcess(process, true))}\n      {(processes.length > 1 || allOpen) && <ToolbarItem as=\"button\" className=\"md:data-[hidden=false]:hidden\" data-hidden={hidden > 0 || allOpen} type=\"button\" onClick={() => setAllOpen(true)} title=\"Show all processes of the run\">\n        <span className=\"max-md:hidden\">{hidden > 0 ? `+${hidden} more` : \"Processes\"}</span><span className=\"hidden max-md:inline\">All {processes.length}</span>\n      </ToolbarItem>}\n      {state.error !== undefined && <ToolbarItem className=\"w-42 text-destructive\" role=\"status\" title={state.error}><ToolbarCopy><ToolbarLabel>Processes</ToolbarLabel><ToolbarText>Monitoring disrupted</ToolbarText></ToolbarCopy></ToolbarItem>}\n    </div>\n    {allOpen && <Dialog open onOpenChange={(open) => {\n      if (open) return;\n      setAllOpen(false);\n      if (processes.length === 0) requestAnimationFrame(() => fallback.current?.focus({ preventScroll: true }));\n    }}>\n      <DialogContent scope=\"run\">\n        <DialogHeader><DialogTitle>Processes and ports</DialogTitle></DialogHeader>\n        <DialogBody className=\"flex flex-col gap-3 outline-none\" ref={dialogRef} tabIndex={-1} onFocusCapture={rememberFocus}>\n          {processes.length > 0 ? processes.map((process) => renderProcess(process)) : <p role=\"status\">No active processes.</p>}\n          {state.error !== undefined && <p className=\"text-destructive\" role=\"alert\">{state.error}</p>}\n        </DialogBody>\n      </DialogContent>\n    </Dialog>}\n  </>;\n}\n\nexport const processHeader = (): ComponentType<SessionHeaderContext> =>\n  function ProcessHeader({ session }: SessionHeaderContext) {\n    const access = useAccess();\n    return access.can(\"runs.read\") && access.can(\"ragents.processes.read\")\n      ? <ProcessHeaderContent key={session.session.id} runId={session.session.id} /> : null;\n  };\n", "import {\n  type WebPlugin,\n  type WebPluginDescriptor,\n} from \"@ragents/web/PluginRegistry\";\nimport { PROCESSES_PLUGIN_ID } from \"../contract\";\nimport { processHeader } from \"./ProcessHeader\";\n\nconst configuredPlugin = (descriptor: WebPluginDescriptor): WebPlugin => ({\n  ...descriptor,\n  sessionHeaders: [{\n    readRight: \"ragents.processes.read\",\n    requiresWorkspace: true,\n    id: \"ragents.processes.live\",\n    order: 110,\n    Header: processHeader(),\n  }],\n});\n\nconst descriptor: WebPluginDescriptor = { id: PROCESSES_PLUGIN_ID };\n\nexport const webPlugin: WebPlugin = {\n  ...descriptor,\n  activate: () => configuredPlugin(descriptor),\n};\n"],
+  "mappings": "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",
   "names": ["read", "specifier", "name", "module", "typebox_Type_default", "read", "contract_defineChannel_default", "read", "contract_defineOperation_default", "read", "contracts_openJson_default", "read", "PROCESSES_PLUGIN_ID", "runId", "typebox_Type_default", "processesContracts", "contract_defineOperation_default", "contracts_openJson_default", "contract_defineChannel_default", "react_useEffect_default", "read", "react_useLayoutEffect_default", "read", "react_useRef_default", "read", "react_useState_default", "read", "AccessContext_useAccess_default", "read", "ui_Dialog_default", "read", "ui_DialogBody_default", "read", "ui_DialogContent_default", "read", "ui_DialogHeader_default", "read", "ui_DialogTitle_default", "read", "ui_StopButton_default", "read", "ui_cn_default", "read", "Toolbar_ToolbarCopy_default", "read", "Toolbar_ToolbarItem_default", "read", "Toolbar_ToolbarLabel_default", "read", "Toolbar_ToolbarText_default", "read", "rpc_rpc_default", "read", "guards_isRecord_default", "read", "VISIBLE_PROCESSES", "ORIGINS", "portFrom", "value", "guards_isRecord_default", "processFrom", "snapshotFrom", "messageFrom", "serviceUrl", "hostname", "port", "kindLabel", "process", "originText", "origin", "timeText", "iso", "parsed", "titleOf", "ports", "visibleProcesses", "processes", "jsx_runtime_Fragment_default", "read", "jsx_runtime_jsx_default", "read", "jsx_runtime_jsxs_default", "read", "idle", "pillClass", "portClass", "stopClass", "useRunProcesses", "runId", "state", "setState", "react_useState_default", "react_useEffect_default", "rpc_rpc_default", "processesContracts", "data", "message", "messageFrom", "current", "caught", "IconProcess", "jsx_runtime_jsxs_default", "jsx_runtime_jsx_default", "ProcessPill", "process", "writable", "onStop", "toolbar", "stop", "ui_StopButton_default", "ports", "port", "serviceUrl", "ui_cn_default", "Toolbar_ToolbarItem_default", "titleOf", "Toolbar_ToolbarCopy_default", "Toolbar_ToolbarLabel_default", "kindLabel", "Toolbar_ToolbarText_default", "ProcessHeaderContent", "access", "AccessContext_useAccess_default", "stops", "setStops", "allOpen", "setAllOpen", "requests", "react_useRef_default", "rootRef", "dialogRef", "focused", "fallback", "processes", "shown", "hidden", "visibleProcesses", "active", "controller", "react_useLayoutEffect_default", "target", "rememberFocus", "event", "header", "element", "cause", "renderProcess", "jsx_runtime_Fragment_default", "ui_Dialog_default", "open", "ui_DialogContent_default", "ui_DialogHeader_default", "ui_DialogTitle_default", "ui_DialogBody_default", "processHeader", "session", "configuredPlugin", "descriptor", "processHeader", "PROCESSES_PLUGIN_ID", "webPlugin"]
 }

package/bundles/ragents.product/ragents-bundle.json

@@ -76,7 +76,7 @@
     }
   },
   "revision": "7a3eb7a847ce6a4c8324b9c073c3c7a13c760088a194d419fe21342575c4208f",
-  "sourceRevision": "c6fefb62c103db8f057e3b61019810ffca13b46bcaa449ed5c53d7139a524cfe",
+  "sourceRevision": "7c8b3522ee90f89a7d3941ea396c458980ac53c83fa5096eab5a19b5f1a7aa81",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.profile-distribution/ragents-bundle.json

@@ -53,7 +53,7 @@
     "web": {}
   },
   "revision": "3e99cf5cb8921685ad83aa6aaf9657da4c648f9d68cb744988a73f227c342e1d",
-  "sourceRevision": "f86bd0f1a439a2c9d143101af2a58881306dd8910240226548afbebfc125682c",
+  "sourceRevision": "cbf9d98fe42583b619b84425e648666df7cafd04930cf0692b43a5943fb4bd39",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.reference/actors/notebook/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "notebook",
+  "private": true,
+  "type": "module",
+  "ragents": {
+    "title": "Notebook",
+    "description": "Keeps the notes that run scripts send it, newest first.",
+    "backend": "src/server.ts",
+    "views": [
+      {
+        "id": "main",
+        "client": "src/client.tsx"
+      }
+    ]
+  }
+}

package/bundles/ragents.reference/actors/notebook/src/client.tsx

@@ -0,0 +1,31 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { context, useAppState } from "@ragents/client";
+import * as UI from "@ragents/client/ui";
+
+const App = () => {
+  const state = useAppState();
+  const notes = state.notes ?? [];
+  const [status, setStatus] = React.useState("Run scripts add their notes here.");
+
+  const clear = async (): Promise<void> => {
+    const answer = await context.capabilities.call("clear", {});
+    setStatus(`Cleared ${answer.cleared} ${answer.cleared === 1 ? "note" : "notes"}.`);
+  };
+
+  return (
+    <UI.AppLayout title="Notebook" description={<>{notes.length} {notes.length === 1 ? "note" : "notes"}</>}>
+      <UI.Stack>
+        <p className="text-muted-foreground" role="status">{status}</p>
+        <ul className="border-t border-border">
+          {notes.map((note, index) => <li className="min-h-8 border-b border-border-soft py-1.5 [overflow-wrap:anywhere]" key={index}>{note}</li>)}
+        </ul>
+        <UI.Button disabled={notes.length === 0} onClick={() => void clear()} variant="outline">Clear</UI.Button>
+      </UI.Stack>
+    </UI.AppLayout>
+  );
+};
+
+const root = document.getElementById("root");
+if (!root) throw new Error("The #root element is missing.");
+createRoot(root).render(<App />);

package/bundles/ragents.reference/actors/notebook/src/server.ts

@@ -0,0 +1,27 @@
+import { defineActor } from "@ragents/server";
+import { Type } from "typebox";
+
+const KEPT_NOTES = 50;
+
+const contract = {
+  state: Type.Object({ notes: Type.Optional(Type.Array(Type.String())) }, { additionalProperties: false }),
+  functions: {
+    clear: { label: "Clear notes", input: Type.Object({}, { additionalProperties: false }), output: Type.Object({ cleared: Type.Integer() }, { additionalProperties: false }) },
+  },
+  input: { capabilities: [] },
+} as const;
+
+export default defineActor(contract, {
+  functions: {
+    clear: (_input, context) => {
+      const cleared = context.state.read().notes?.length ?? 0;
+      context.state.replace({ notes: [] });
+      return { cleared };
+    },
+  },
+  onInput: (input, context) => {
+    const note = input.content.trim();
+    if (!note) throw new Error("A note needs text.");
+    context.state.replace({ notes: [note, ...context.state.read().notes ?? []].slice(0, KEPT_NOTES) });
+  },
+});

package/bundles/ragents.reference/actors/notebook/tests/program.test.ts

@@ -0,0 +1,27 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createTestContext } from "@ragents/server/testing";
+import program from "../src/server.ts";
+
+const input = (content: string) => ({ id: "input-1", content, artifactIds: [], sourceEventIds: [], subscriptionId: null, event: null });
+
+test("keeps notes newest first and at most fifty", async () => {
+  const context = createTestContext<{ notes?: string[] }>({ state: { notes: Array.from({ length: 50 }, (_, index) => `old ${index}`) } });
+  await program.onInput!(input("  new note  "), context);
+  const notes = context.state.read().notes!;
+  assert.equal(notes.length, 50);
+  assert.equal(notes[0], "new note");
+  assert.equal(notes.at(-1), "old 48");
+});
+
+test("an empty note is refused and changes nothing", async () => {
+  const context = createTestContext<{ notes?: string[] }>({ state: { notes: ["kept"] } });
+  await assert.rejects(async () => program.onInput!(input("   "), context), /needs text/);
+  assert.deepEqual(context.state.read(), { notes: ["kept"] });
+});
+
+test("clear empties the notebook and names how many notes it removed", async () => {
+  const context = createTestContext<{ notes?: string[] }>({ state: { notes: ["one", "two"] } });
+  assert.deepEqual(await program.functions.clear({}, context), { cleared: 2 });
+  assert.deepEqual(context.state.read(), { notes: [] });
+});

package/bundles/ragents.reference/ragents-bundle.json

@@ -20,8 +20,8 @@
       ]
     }
   },
-  "revision": "809c8770905fa2a4d557425abf27aee27a863aec8a80655b96e40bd82307f493",
-  "sourceRevision": "abe068f9695702223dd49b2169ecca54e5a82fd4b37d02346d0c9df3582cff87",
+  "revision": "2c684e9daab9b2ffe4c002c03d4fa8549b2d4dd0b20513fb5eec0e4f10a396ee",
+  "sourceRevision": "0f2f0bb43908bed73e743ed21d07d35abed4bcc84563c893c5c32117ad559ade",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",
@@ -34,6 +34,7 @@
   "uses": [],
   "assets": [
     "skills",
-    "run-scripts"
+    "run-scripts",
+    "actors"
   ]
 }

package/bundles/ragents.reference/run-scripts/quick-note/RUN.md

@@ -0,0 +1,14 @@
+---
+title: Add a quick note
+description: "A prepared one-step script shows a shared actor package: it adds a note to the notebook it shares with the roster check, in a new or a running run."
+order: 180
+coordinator: false
+embeddable: true
+shared-programs: notebook
+tags: Run scripts, Concept demo, TypeScript actors
+---
+
+The start value `{ "text": "..." }` is the note; without one, the script notes when it was
+started. The script makes the shared notebook active with `actor_program_ensure`, sends it the
+note, places the notebook's view with `canvas_layout_place`, and ends the start with
+`context.finish`. Whether the roster check or this script comes first, the run has one notebook.

package/bundles/ragents.reference/run-scripts/quick-note/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "quick-note",
+  "private": true,
+  "type": "module",
+  "ragents": {
+    "title": "Quick note",
+    "backend": "src/server.ts"
+  }
+}

package/bundles/ragents.reference/run-scripts/quick-note/src/server.ts

@@ -0,0 +1,29 @@
+import { defineActor } from "@ragents/server";
+import { Type } from "typebox";
+
+const contract = {
+  state: Type.Object({}, { additionalProperties: false }),
+  functions: {},
+  input: { capabilities: ["actor_program_ensure", "actor_input", "canvas_layout_place"] },
+} as const;
+
+const noteOf = (input: unknown, now: string): string => {
+  if (input === null) return `Started at ${now}.`;
+  const text = typeof input === "object" && input !== null && "text" in input ? (input as { text: unknown }).text : undefined;
+  if (typeof text !== "string" || !text.trim()) throw new Error('The start value is { "text": "..." } with the note, or none.');
+  return text.trim();
+};
+
+export default defineActor(contract, {
+  functions: {},
+  onInput: () => {
+    throw new Error("The quick note answers only starts; start it again with the note as its start value.");
+  },
+  onStart: async (start, context) => {
+    const note = noteOf(start.input, context.std.now());
+    const notebook = await context.functions.actor_program_ensure({ name: "notebook" });
+    await context.functions.actor_input({ actor: `@${notebook.handle}`, content: note });
+    await context.functions.canvas_layout_place({ entity: "app:notebook/main" });
+    context.finish({ note, notebook: notebook.status }, { summary: `Noted: ${note}` });
+  },
+});

package/bundles/ragents.reference/run-scripts/quick-note/tests/program.test.ts

@@ -0,0 +1,43 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createTestContext } from "@ragents/server/testing";
+import program from "../src/server.ts";
+
+const start = (input: unknown) => ({ input, options: {}, embedded: true, startedBy: "owner-id", count: 1 });
+
+const note = (status: "active" | "installed" = "installed") => {
+  const calls: { name: string; input: unknown }[] = [];
+  const record = <T>(name: string, answer: T) => (input: unknown): T => { calls.push({ name, input }); return answer; };
+  const context = createTestContext<Record<string, never>>({ state: {}, functions: {
+    actor_program_ensure: record("actor_program_ensure", { actorId: "id-notebook", handle: "notebook", status }),
+    actor_input: record("actor_input", []),
+    canvas_layout_place: record("canvas_layout_place", { placed: status === "installed" }),
+  } });
+  return { calls, context };
+};
+
+test("sends the note to the shared notebook and reports it", async () => {
+  const { calls, context } = note();
+  await program.onStart!(start({ text: "  Ask about the budget  " }), context);
+  assert.deepEqual(calls.map((call) => [call.name, call.input]), [
+    ["actor_program_ensure", { name: "notebook" }],
+    ["actor_input", { actor: "@notebook", content: "Ask about the budget" }],
+    ["canvas_layout_place", { entity: "app:notebook/main" }],
+  ]);
+  assert.deepEqual(context.finished, [{ result: { note: "Ask about the budget", notebook: "installed" }, summary: "Noted: Ask about the budget" }]);
+});
+
+test("without a start value it notes when it started; an invalid value changes nothing", async () => {
+  const { calls, context } = note("active");
+  await program.onStart!(start(null), context);
+  assert.match(String((calls[1]!.input as { content: string }).content), /^Started at /);
+  const invalid = note();
+  await assert.rejects(async () => program.onStart!(start({ text: "" }), invalid.context), /start value/);
+  assert.deepEqual(invalid.calls, []);
+  assert.deepEqual(invalid.context.finished, []);
+});
+
+test("an ordinary message is refused", async () => {
+  const { context } = note();
+  await assert.rejects(async () => program.onInput!({ id: "input-1", content: "hello", artifactIds: [], sourceEventIds: [], subscriptionId: null, event: null }, context), /answers only starts/);
+});

package/bundles/ragents.reference/run-scripts/run-roster/RUN.md

@@ -0,0 +1,19 @@
+---
+title: Take stock of the run
+description: "A prepared check shows a run script that also joins a running run. It lists the other participants, notes them in the shared notebook, and reports them back as its result."
+order: 170
+coordinator: false
+embeddable: true
+shared-programs: notebook
+tags: Run scripts, Concept demo, TypeScript actors
+---
+
+The TypeScript program reads the participants with `actor_list` and ends each start with
+`context.finish`. The owner reads the summary in the chat; a coordinator that starts it through
+`run_script_start` receives summary and list as a message. Started inside a running run through the
+run menu, `ragents script`, or the coordinator, it changes neither the primary actor nor the tiles,
+and a repeated start reuses the same actor. Started as a new run, it is the run's only participant.
+
+It shares the notebook with the quick note script: `shared-programs: notebook` copies the plugin's
+shared package into the run, `actor_program_ensure` makes it active once, and
+`canvas_layout_place` puts its view next to what is arranged.

package/bundles/ragents.reference/run-scripts/run-roster/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "run-roster",
+  "private": true,
+  "type": "module",
+  "ragents": {
+    "title": "Run roster",
+    "backend": "src/server.ts"
+  }
+}

package/bundles/ragents.reference/run-scripts/run-roster/src/server.ts

@@ -0,0 +1,26 @@
+import { defineActor } from "@ragents/server";
+import { Type } from "typebox";
+
+const contract = {
+  state: Type.Object({ reports: Type.Optional(Type.Number()) }, { additionalProperties: false }),
+  functions: {},
+  input: { capabilities: ["actor_list", "actor_program_ensure", "actor_input", "canvas_layout_place"] },
+} as const;
+
+export default defineActor(contract, {
+  functions: {},
+  onInput: () => {
+    throw new Error("The roster answers only starts; start it again from the run menu or with run_script_start.");
+  },
+  onStart: async (_start, context) => {
+    const actors = await context.functions.actor_list({});
+    const others = actors.filter((actor) => actor.kind !== "human" && actor.handle !== context.actor.handle);
+    const handles = others.map((actor) => `@${actor.handle}`);
+    const summary = handles.length === 0 ? "No other participants yet." : `${handles.length} participant${handles.length === 1 ? "" : "s"}: ${handles.join(", ")}.`;
+    const notebook = await context.functions.actor_program_ensure({ name: "notebook" });
+    await context.functions.actor_input({ actor: `@${notebook.handle}`, content: `Roster: ${summary}` });
+    await context.functions.canvas_layout_place({ entity: "app:notebook/main" });
+    context.state.replace({ reports: (context.state.read().reports ?? 0) + 1 });
+    context.finish({ actors: others.map(({ handle, kind, lifecycle }) => ({ handle, kind, lifecycle })) }, { summary });
+  },
+});

package/bundles/ragents.reference/run-scripts/run-roster/tests/program.test.ts

@@ -0,0 +1,47 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createTestContext } from "@ragents/server/testing";
+import program from "../src/server.ts";
+
+const start = { input: null, options: {}, embedded: true, startedBy: "owner-id", count: 1 };
+const actor = (handle: string, kind: "human" | "agent" | "script", lifecycle = "idle") =>
+  ({ id: `id-${handle}`, handle, displayName: handle, kind, lifecycle, createdBy: null, description: null, toolCount: null });
+
+const roster = (actors: ReturnType<typeof actor>[], state: { reports?: number } = {}) => {
+  const calls: { name: string; input: unknown }[] = [];
+  const record = <T>(name: string, answer: T) => (input: unknown): T => { calls.push({ name, input }); return answer; };
+  const context = createTestContext<{ reports?: number }>({ state, functions: {
+    actor_list: record("actor_list", actors),
+    actor_program_ensure: record("actor_program_ensure", { actorId: "id-notebook", handle: "notebook", status: "active" as const }),
+    actor_input: record("actor_input", []),
+    canvas_layout_place: record("canvas_layout_place", { placed: true }),
+  } });
+  return { calls, context };
+};
+
+test("reports the other participants as result and summary and notes them in the shared notebook", async () => {
+  const { calls, context } = roster([actor("owner", "human"), actor("coordinator", "agent", "running"), actor("helper", "agent"), actor("test", "script")]);
+  await program.onStart!(start, context);
+  assert.deepEqual(context.finished, [{
+    result: { actors: [{ handle: "coordinator", kind: "agent", lifecycle: "running" }, { handle: "helper", kind: "agent", lifecycle: "idle" }] },
+    summary: "2 participants: @coordinator, @helper.",
+  }]);
+  assert.deepEqual(calls.slice(1).map((call) => [call.name, call.input]), [
+    ["actor_program_ensure", { name: "notebook" }],
+    ["actor_input", { actor: "@notebook", content: "Roster: 2 participants: @coordinator, @helper." }],
+    ["canvas_layout_place", { entity: "app:notebook/main" }],
+  ]);
+  assert.deepEqual(context.state.read(), { reports: 1 });
+});
+
+test("a run without other participants still gets a result, and every start counts", async () => {
+  const { context } = roster([actor("owner", "human"), actor("test", "script")], { reports: 2 });
+  await program.onStart!({ ...start, embedded: false, count: 3 }, context);
+  assert.deepEqual(context.finished, [{ result: { actors: [] }, summary: "No other participants yet." }]);
+  assert.deepEqual(context.state.read(), { reports: 3 });
+});
+
+test("an ordinary message is refused", async () => {
+  const { context } = roster([]);
+  await assert.rejects(async () => program.onInput!({ id: "input-1", content: "hello", artifactIds: [], sourceEventIds: [], subscriptionId: null, event: null }, context), /answers only starts/);
+});

package/bundles/ragents.todo/ragents-bundle.json

@@ -33,7 +33,7 @@
     }
   },
   "revision": "5e18b249f3c8b53b61820ef05da59823d58163c6962e6d836dcb37c05034aad0",
-  "sourceRevision": "cdb1c230450ed69e96cebcee9da392c02edb499417fc7e2de657b2f89c36c379",
+  "sourceRevision": "e69f899d1733ba54341bfc2fd8c6adbf6025126a4b21a74bdd8206378e86b87e",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.transcript/ragents-bundle.json

@@ -23,7 +23,7 @@
     "web": {}
   },
   "revision": "e3bb513053f6385f9d78d314d28302324095a5163c4e1563df6fc8b3251305f7",
-  "sourceRevision": "ba610549f1f1b3e87940617518d45b4bc918362fb9c20283b2a5061877bed103",
+  "sourceRevision": "7df3be99d8024c7878a0afe2bcd698909b6389f4484d98f84a0e3bdead954ab4",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.watch/ragents-bundle.json

@@ -25,7 +25,7 @@
     "web": {}
   },
   "revision": "007ee50ab186e3070930f23e9795210fa36c723365657325d5440cc2f0b81d60",
-  "sourceRevision": "ebb0ba3e7ca11870abab5787c259c3d2ad3b36247caeb4b4efd9bcceebbb7047",
+  "sourceRevision": "1ce434ee7a1752f72e3d7160d895130948b8bcd5bba466f5555fff6ff278cd19",
   "server": "server/index.js",
   "exports": {
     "server": {

package/bundles/ragents.workspace/ragents-bundle.json

@@ -136,8 +136,8 @@
       ]
     }
   },
-  "revision": "53498a6dbf25ada77b6dcdf7bb1d188c16229a85c7ddeeafa10e6335a8230954",
-  "sourceRevision": "f937fbba39f6d0ab90e55e494976d0d650054b722212d7e25cf8ddb835f91492",
+  "revision": "db9370b7b3449c44be49986b074806351b857c430963aa878e209d2d5c9ba4f8",
+  "sourceRevision": "f91d81de973c9c7b46f1882a8cb4f067fbdf72c2e7617f24f8865f92d9ed05bc",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",