acrylblends 0.9.1 → 0.10.0

package/plugins/agent-panel/index.ts

@@ -1,7 +1,7 @@
 /**
  * The built-in agent (spec 049 slice 14): a chat panel inside the running app. The person says what they want; the app's own agent (`driver: 'agent'`) or a coding
  * agent started in the app folder (`'claude'`, `'codex'`, `'pi'`) builds it through the door, and when a plugin was installed or removed the page reloads, so the new feature
- * shows with no restart.
+ * shows with no restart. The drivers are entries of the `drivers` service this plugin provides (`drivers.ts`): chat drivers here, and other plugins (`driver-pty`) add more.
  *
  * - A middleware appends one script tag (`/api/agent-panel/panel.js`) to every HTML response of the routes mounted after it, so no page is edited.
  * - `GET /api/agent-panel/session` gives the page the drivers it may use and a token; `POST /api/agent-panel/ask` runs one message and answers server-sent events:
@@ -9,7 +9,6 @@
  * - Only the app's own page may ask (a same-origin request carrying the token), one run at a time, and every ask is written to `.acryl/audit/agent-panel.jsonl`.
  * - Development only: the plugin does nothing with `NODE_ENV=production` or `ACRYL_DOOR=off`.
  */
-import { spawn, spawnSync } from 'node:child_process'
 import { randomBytes } from 'node:crypto'
 import { appendFileSync, mkdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
@@ -19,6 +18,17 @@ import { streamSSE } from '../acryl-router/src/helpers/index.ts'
 import { Acryl } from '../acryl-router/src/index.ts'
 import type {} from '../agent/index.ts'
 import type {} from '../extensions/index.ts'
+import { provideDrivers } from './drivers.ts'
+import { agentDriver, availableHeadless, type HeadlessName, headlessDriver } from './headless.ts'
+
+export type {
+  ChatDriver,
+  ChatEvent,
+  Driver,
+  Drivers,
+  TerminalDriver,
+  TerminalSession,
+} from './drivers.ts'
 
 export const name = 'agent-panel'
 export const inject = ['router', 'agent', 'extensions', 'appInstance']
@@ -26,78 +36,9 @@ export const inject = ['router', 'agent', 'extensions', 'appInstance']
 const PREFIX = '/api/agent-panel'
 const CLIENT_DIR = join(import.meta.dirname, 'client')
 
-export type DriverName = 'agent' | 'claude' | 'codex' | 'pi'
-
 export interface PanelConfig {
-  /** Driver programs to offer besides the app's own agent; default: the ones found on the machine. */
-  drivers?: readonly Exclude<DriverName, 'agent'>[]
-}
-
-/** The command line of each coding agent started headless in the app folder (the same ones the product test uses). */
-function command(
-  driver: Exclude<DriverName, 'agent'>,
-  message: string,
-  root: string,
-): { file: string; args: string[] } {
-  switch (driver) {
-    case 'claude':
-      return {
-        file: 'claude',
-        args: [
-          '-p',
-          message,
-          '--permission-mode',
-          'acceptEdits',
-          '--allowedTools',
-          'Read,Edit,Write,Glob,Grep,Bash(npm *),Bash(npx *),Bash(node *),Bash(.acryl/bin/acryl *),Bash(curl *)',
-        ],
-      }
-    case 'codex':
-      return {
-        file: 'codex',
-        args: [
-          'exec',
-          '--skip-git-repo-check',
-          '-s',
-          'workspace-write',
-          '-c',
-          'sandbox_workspace_write.network_access=true',
-          '-C',
-          root,
-          message,
-        ],
-      }
-    case 'pi':
-      return {
-        file: 'pi',
-        args: [
-          '-p',
-          message,
-          '--provider',
-          'deepseek',
-          '--model',
-          'deepseek-v4-pro',
-          '--no-session',
-        ],
-      }
-  }
-}
-
-function onPath(program: string): boolean {
-  const found = spawnSync(process.platform === 'win32' ? 'where' : 'which', [program], {
-    encoding: 'utf8',
-  })
-  return found.status === 0
-}
-
-/** The drivers this machine can offer: the app's own agent always; a program when it is installed (pi also needs its key in the environment). */
-export function availableDrivers(wanted?: readonly Exclude<DriverName, 'agent'>[]): DriverName[] {
-  const found: DriverName[] = ['agent']
-  for (const driver of wanted ?? (['claude', 'codex', 'pi'] as const)) {
-    if (driver === 'pi' && !process.env.DEEPSEEK_API_KEY) continue
-    if (onPath(driver)) found.push(driver)
-  }
-  return found
+  /** Headless coding agents to offer besides the app's own agent; default: the ones found on the machine. */
+  drivers?: readonly HeadlessName[]
 }
 
 /** Whether a request comes from the app's own page: a browser says so itself (`Sec-Fetch-Site: same-origin`), or the Origin is the Host. */
@@ -122,7 +63,13 @@ export function apply(ctx: Context, config: PanelConfig = {}): void {
       // The audit never stops a run.
     }
   }
-  const drivers = availableDrivers(config.drivers)
+  const registry = provideDrivers(
+    ctx,
+    (headers) => fromOwnPage(headers) && headers.get('x-agent-panel-token') === token,
+  )
+  ctx.effect(() => registry.register(agentDriver(ctx)))
+  for (const program of availableHeadless(config.drivers))
+    ctx.effect(() => registry.register(headlessDriver(program, root)))
   let running = false
 
   const tag = `<script type="module" src="${PREFIX}/panel.js"></script>`
@@ -149,19 +96,29 @@ export function apply(ctx: Context, config: PanelConfig = {}): void {
     .get(`${PREFIX}/session`, (c) => {
       if (!fromOwnPage(c.req.raw.headers))
         return c.json({ error: "only the app's own page may use the panel" }, 403)
-      return c.json({ token, drivers })
+      return c.json({
+        token,
+        drivers: registry.list().map((driver) => ({ name: driver.name, kind: driver.kind })),
+      })
     })
     .post(`${PREFIX}/ask`, async (c) => {
       if (!fromOwnPage(c.req.raw.headers) || c.req.header('x-agent-panel-token') !== token)
         return c.json({ error: "only the app's own page may ask" }, 403)
       const body = (await c.req.json().catch(() => ({}))) as { message?: unknown; driver?: unknown }
       const message = typeof body.message === 'string' ? body.message.trim() : ''
-      const driver = (typeof body.driver === 'string' ? body.driver : 'agent') as DriverName
+      const driverName = typeof body.driver === 'string' ? body.driver : 'agent'
       if (message === '' || message.length > 8000)
         return c.json({ error: 'write a message of at most 8000 characters' }, 400)
-      if (!drivers.includes(driver))
+      const driver = registry.get(driverName)
+      if (driver?.kind !== 'chat')
         return c.json(
-          { error: `the driver "${driver}" is not available here (${drivers.join(', ')})` },
+          {
+            error: `the driver "${driverName}" is not available here (${registry
+              .list()
+              .filter((d) => d.kind === 'chat')
+              .map((d) => d.name)
+              .join(', ')})`,
+          },
           400,
         )
       if (running) return c.json({ error: 'a run is already going; wait for it to end' }, 409)
@@ -174,57 +131,20 @@ export function apply(ctx: Context, config: PanelConfig = {}): void {
           changed = true
           void send('change', { extension, action })
         })
-        audit({ ask: 'start', driver, characters: message.length })
+        audit({ ask: 'start', driver: driverName, characters: message.length })
+        // Stop in the page closes the stream; that cancels the run (the model call, the tool or the program in flight is dropped).
+        const cancel = new AbortController()
+        stream.onAbort(() => cancel.abort())
         try {
-          if (driver === 'agent') {
-            const result = await ctx.agent.run(message)
-            for (const call of result.trace)
-              await send('tool', {
-                tool: call.tool,
-                input: call.input,
-                ...(call.error ? { error: call.error } : { result: call.result }),
-              })
-            await send('text', {
-              text:
-                result.status === 'completed'
-                  ? result.output
-                  : result.status === 'cancelled'
-                    ? 'The run was cancelled.'
-                    : `The run stopped after ${result.steps} steps without an answer.`,
-            })
-          } else {
-            const { file, args } = command(driver, message, root)
-            const child = spawn(file, args, {
-              cwd: root,
-              env: process.env,
-              stdio: ['ignore', 'pipe', 'pipe'],
-            })
-            stream.onAbort(() => {
-              child.kill('SIGTERM')
-            })
-            child.stdout.on(
-              'data',
-              (chunk: Buffer) => void send('text', { text: chunk.toString() }),
-            )
-            child.stderr.on(
-              'data',
-              (chunk: Buffer) =>
-                void send('tool', { tool: driver, info: chunk.toString().slice(0, 500) }),
-            )
-            const code = await new Promise<number>((done) => {
-              child.on('error', () => done(1))
-              child.on('exit', (exit) => done(exit ?? 1))
-            })
-            if (code !== 0)
-              await send('error', { message: `${driver} ended with exit code ${code}` })
-          }
+          for await (const { event, data } of driver.start({ message, signal: cancel.signal }))
+            await send(event, data)
           await send('done', { changed })
         } catch (error) {
           await send('error', { message: error instanceof Error ? error.message : String(error) })
         } finally {
           off()
           running = false
-          audit({ ask: 'end', driver, changed })
+          audit({ ask: 'end', driver: driverName, changed })
         }
       })
     })

package/plugins/agent-panel/plugin.json

@@ -12,7 +12,7 @@
     "instance"
   ],
   "inject": ["router", "agent", "extensions", "appInstance"],
-  "provides": [],
+  "provides": ["drivers"],
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.4"
   },

package/plugins/driver-pty/client/terminal.ts

@@ -0,0 +1,188 @@
+// The terminal tab of the agent panel: xterm.js in the page, a real terminal on the server (the `driver-pty` plugin). Output arrives as server-sent events with ids (fetch
+// reads the stream, so the panel's token header can be sent; a dropped stream is reopened from the last id), keystrokes go up as POSTs batched per animation frame.
+import { FitAddon } from './vendor/addon-fit.mjs'
+import { Terminal } from './vendor/xterm.mjs'
+import css from './vendor/xterm-css.mjs'
+
+const PREFIX = '/api/driver-pty'
+const REMEMBERED = 'driver-pty-session'
+
+export interface TerminalView {
+  /** Ends the view (not the session): the server keeps the terminal for a re-attach. */
+  detach(): void
+  /** Stops the session on the server. */
+  stop(): Promise<void>
+}
+
+interface Options {
+  /** Where the terminal goes: a node inside the panel's shadow root. */
+  container: HTMLElement
+  /** The panel's session token. */
+  token: string
+  /** The terminal driver's name (`pty:claude`). */
+  driver: string
+  /** Called with a line of status for the panel to show (`The terminal ended (exit 0).`). */
+  status(text: string): void
+  /** A plugin was installed or removed while the terminal was open. */
+  onChange(change: { extension: string; action: string }): void
+}
+
+interface Frame {
+  event: string
+  id?: string
+  data: string
+}
+
+async function* frames(response: Response): AsyncGenerator<Frame> {
+  const reader = response.body!.getReader()
+  const decoder = new TextDecoder()
+  let buffer = ''
+  for (;;) {
+    const { value, done } = await reader.read()
+    if (done) return
+    buffer += decoder.decode(value, { stream: true }).replace(/\r\n/gu, '\n')
+    for (let end = buffer.indexOf('\n\n'); end !== -1; end = buffer.indexOf('\n\n')) {
+      const block = buffer.slice(0, end)
+      buffer = buffer.slice(end + 2)
+      const frame: Frame = { event: 'message', data: '' }
+      for (const line of block.split('\n')) {
+        if (line.startsWith('event:')) frame.event = line.slice(6).trim()
+        else if (line.startsWith('id:')) frame.id = line.slice(3).trim()
+        else if (line.startsWith('data:')) frame.data += line.slice(5).trimStart()
+      }
+      yield frame
+    }
+  }
+}
+
+export async function openTerminal(options: Options): Promise<TerminalView> {
+  const { container, token, driver, status, onChange } = options
+  const headers = { 'content-type': 'application/json', 'x-agent-panel-token': token }
+  const call = (path: string, body: unknown = {}): Promise<Response> =>
+    fetch(`${PREFIX}${path}`, { method: 'POST', headers, body: JSON.stringify(body) })
+
+  const style = document.createElement('style')
+  style.textContent = `${css}\n.xterm { height: 100%; padding: 4px }`
+  container.append(style)
+  const host = document.createElement('div')
+  host.style.cssText = 'width:100%;height:100%'
+  container.append(host)
+  const term = new Terminal({ cursorBlink: true, fontSize: 13, convertEol: false })
+  const fit = new FitAddon()
+  term.loadAddon(fit)
+  term.open(host)
+  fit.fit()
+
+  // A terminal the page opened earlier is re-attached (a reload keeps the session on the server); otherwise a new one starts.
+  let id: string | undefined
+  try {
+    const remembered = JSON.parse(sessionStorage.getItem(REMEMBERED) ?? 'null') as {
+      id: string
+      driver: string
+    } | null
+    if (remembered?.driver === driver) id = remembered.id
+  } catch {
+    // No storage: always a new terminal.
+  }
+  let ended = false
+  let lastId = 0
+  const abort = new AbortController()
+
+  const start = async (): Promise<boolean> => {
+    const reply = await call('/sessions', { driver, cols: term.cols, rows: term.rows })
+    const body = (await reply.json().catch(() => ({}))) as { id?: string; error?: string }
+    if (!reply.ok || !body.id) {
+      status(body.error ?? `The terminal could not start (${reply.status}).`)
+      return false
+    }
+    id = body.id
+    lastId = 0
+    try {
+      sessionStorage.setItem(REMEMBERED, JSON.stringify({ id, driver }))
+    } catch {
+      // Not remembered.
+    }
+    return true
+  }
+
+  /** Reads the output until the session ends; a dropped stream is opened again from the last id. */
+  const attach = async (): Promise<void> => {
+    let failures = 0
+    while (!ended && !abort.signal.aborted && id) {
+      try {
+        const response = await fetch(`${PREFIX}/${id}/output`, {
+          headers: { ...headers, ...(lastId > 0 ? { 'last-event-id': String(lastId) } : {}) },
+          signal: abort.signal,
+        })
+        if (response.status === 404 && lastId === 0) {
+          // The remembered terminal is gone: start a new one.
+          sessionStorage.removeItem(REMEMBERED)
+          if (!(await start())) return
+          continue
+        }
+        if (!response.ok) throw new Error(String(response.status))
+        failures = 0
+        for await (const frame of frames(response)) {
+          if (frame.event === 'reset') term.reset()
+          else if (frame.event === 'change')
+            onChange(JSON.parse(frame.data) as { extension: string; action: string })
+          else if (frame.event === 'data') {
+            if (frame.id) lastId = Number(frame.id)
+            term.write(JSON.parse(frame.data) as string)
+          } else if (frame.event === 'exit') {
+            ended = true
+            const code = (JSON.parse(frame.data) as { code: number | null }).code
+            status(
+              code === null ? 'The terminal was closed.' : `The terminal ended (exit ${code}).`,
+            )
+            sessionStorage.removeItem(REMEMBERED)
+          }
+        }
+      } catch {
+        if (abort.signal.aborted) return
+        if (++failures > 5) {
+          status('The connection to the terminal was lost.')
+          return
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500 * failures))
+      }
+    }
+  }
+
+  // Keystrokes: one request per animation frame, in order.
+  let pending = ''
+  let scheduled = false
+  let sending: Promise<unknown> = Promise.resolve()
+  term.onData((data) => {
+    pending += data
+    if (scheduled) return
+    scheduled = true
+    requestAnimationFrame(() => {
+      scheduled = false
+      const batch = pending
+      pending = ''
+      if (id && !ended && batch !== '')
+        sending = sending.then(() => call(`/${id}/input`, { data: batch }))
+    })
+  })
+  const resize = new ResizeObserver(() => {
+    fit.fit()
+    if (id && !ended) void call(`/${id}/resize`, { cols: term.cols, rows: term.rows })
+  })
+  resize.observe(container)
+
+  if (!id && !(await start())) return { detach() {}, stop: async () => {} }
+  void attach()
+  term.focus()
+  return {
+    detach() {
+      abort.abort()
+      resize.disconnect()
+      term.dispose()
+      container.replaceChildren()
+    },
+    async stop() {
+      if (id) await call(`/${id}/stop`)
+    },
+  }
+}

package/plugins/driver-pty/client/vendor/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2017-2019, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+Copyright (c) 2014-2016, SourceLair Private Company (https://www.sourcelair.com)
+Copyright (c) 2012-2013, Christopher Jeffrey (https://github.com/chjj/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/plugins/driver-pty/client/vendor/LICENSE-addon-fit

@@ -0,0 +1,19 @@
+Copyright (c) 2019, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/plugins/driver-pty/client/vendor/VERSION

@@ -0,0 +1,4 @@
+@xterm/xterm 6.0.0   (xterm.mjs, xterm-css.mjs = css/xterm.css as a string)
+@xterm/addon-fit 0.11.0   (addon-fit.mjs)
+Both MIT: LICENSE (xterm) and LICENSE-addon-fit. Vendored unmodified from the npm tarballs (npm pack @xterm/xterm@6.0.0 @xterm/addon-fit@0.11.0): lib/xterm.mjs, lib/addon-fit.mjs, css/xterm.css, LICENSE.
+To update: pin a new exact version here, replace the files from the tarballs, update THIRD_PARTY_NOTICES.md.

package/plugins/driver-pty/client/vendor/addon-fit.d.mts

@@ -0,0 +1,6 @@
+import type { ITerminalAddon } from './xterm.mjs'
+export class FitAddon implements ITerminalAddon {
+  activate(terminal: import('./xterm.mjs').Terminal): void
+  dispose(): void
+  fit(): void
+}

package/plugins/driver-pty/client/vendor/addon-fit.mjs

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2014-2024 The xterm.js authors. All rights reserved.
+ * @license MIT
+ *
+ * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
+ * @license MIT
+ *
+ * Originally forked from (with the author's permission):
+ *   Fabrice Bellard's javascript vt100 for jslinux:
+ *   http://bellard.org/jslinux/
+ *   Copyright (c) 2011 Fabrice Bellard
+ */
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+var h=2,_=1,o=class{activate(e){this._terminal=e}dispose(){}fit(){let e=this.proposeDimensions();if(!e||!this._terminal||isNaN(e.cols)||isNaN(e.rows))return;let t=this._terminal._core;(this._terminal.rows!==e.rows||this._terminal.cols!==e.cols)&&(t._renderService.clear(),this._terminal.resize(e.cols,e.rows))}proposeDimensions(){if(!this._terminal||!this._terminal.element||!this._terminal.element.parentElement)return;let t=this._terminal._core._renderService.dimensions;if(t.css.cell.width===0||t.css.cell.height===0)return;let s=this._terminal.options.scrollback===0?0:this._terminal.options.overviewRuler?.width||14,r=window.getComputedStyle(this._terminal.element.parentElement),l=parseInt(r.getPropertyValue("height")),a=Math.max(0,parseInt(r.getPropertyValue("width"))),i=window.getComputedStyle(this._terminal.element),n={top:parseInt(i.getPropertyValue("padding-top")),bottom:parseInt(i.getPropertyValue("padding-bottom")),right:parseInt(i.getPropertyValue("padding-right")),left:parseInt(i.getPropertyValue("padding-left"))},m=n.top+n.bottom,d=n.right+n.left,c=l-m,p=a-d-s;return{cols:Math.max(h,Math.floor(p/t.css.cell.width)),rows:Math.max(_,Math.floor(c/t.css.cell.height))}}};export{o as FitAddon};
+//# sourceMappingURL=addon-fit.mjs.map

package/plugins/driver-pty/client/vendor/xterm-css.d.mts

@@ -0,0 +1,2 @@
+declare const css: string
+export default css

package/plugins/driver-pty/client/vendor/xterm-css.mjs

@@ -0,0 +1,2 @@
+// xterm.css of @xterm/xterm 6.0.0, as a string (the panel puts it in its shadow root).
+export default "/**\n * Copyright (c) 2014 The xterm.js authors. All rights reserved.\n * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)\n * https://github.com/chjj/term.js\n * @license MIT\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n *\n * Originally forked from (with the author's permission):\n *   Fabrice Bellard's javascript vt100 for jslinux:\n *   http://bellard.org/jslinux/\n *   Copyright (c) 2011 Fabrice Bellard\n *   The original design remains. The terminal itself\n *   has been extended to include xterm CSI codes, among\n *   other features.\n */\n\n/**\n *  Default styles for xterm.js\n */\n\n.xterm {\n    cursor: text;\n    position: relative;\n    user-select: none;\n    -ms-user-select: none;\n    -webkit-user-select: none;\n}\n\n.xterm.focus,\n.xterm:focus {\n    outline: none;\n}\n\n.xterm .xterm-helpers {\n    position: absolute;\n    top: 0;\n    /**\n     * The z-index of the helpers must be higher than the canvases in order for\n     * IMEs to appear on top.\n     */\n    z-index: 5;\n}\n\n.xterm .xterm-helper-textarea {\n    padding: 0;\n    border: 0;\n    margin: 0;\n    /* Move textarea out of the screen to the far left, so that the cursor is not visible */\n    position: absolute;\n    opacity: 0;\n    left: -9999em;\n    top: 0;\n    width: 0;\n    height: 0;\n    z-index: -5;\n    /** Prevent wrapping so the IME appears against the textarea at the correct position */\n    white-space: nowrap;\n    overflow: hidden;\n    resize: none;\n}\n\n.xterm .composition-view {\n    /* TODO: Composition position got messed up somewhere */\n    background: #000;\n    color: #FFF;\n    display: none;\n    position: absolute;\n    white-space: nowrap;\n    z-index: 1;\n}\n\n.xterm .composition-view.active {\n    display: block;\n}\n\n.xterm .xterm-viewport {\n    /* On OS X this is required in order for the scroll bar to appear fully opaque */\n    background-color: #000;\n    overflow-y: scroll;\n    cursor: default;\n    position: absolute;\n    right: 0;\n    left: 0;\n    top: 0;\n    bottom: 0;\n}\n\n.xterm .xterm-screen {\n    position: relative;\n}\n\n.xterm .xterm-screen canvas {\n    position: absolute;\n    left: 0;\n    top: 0;\n}\n\n.xterm-char-measure-element {\n    display: inline-block;\n    visibility: hidden;\n    position: absolute;\n    top: 0;\n    left: -9999em;\n    line-height: normal;\n}\n\n.xterm.enable-mouse-events {\n    /* When mouse events are enabled (eg. tmux), revert to the standard pointer cursor */\n    cursor: default;\n}\n\n.xterm.xterm-cursor-pointer,\n.xterm .xterm-cursor-pointer {\n    cursor: pointer;\n}\n\n.xterm.column-select.focus {\n    /* Column selection mode */\n    cursor: crosshair;\n}\n\n.xterm .xterm-accessibility:not(.debug),\n.xterm .xterm-message {\n    position: absolute;\n    left: 0;\n    top: 0;\n    bottom: 0;\n    right: 0;\n    z-index: 10;\n    color: transparent;\n    pointer-events: none;\n}\n\n.xterm .xterm-accessibility-tree:not(.debug) *::selection {\n  color: transparent;\n}\n\n.xterm .xterm-accessibility-tree {\n  font-family: monospace;\n  user-select: text;\n  white-space: pre;\n}\n\n.xterm .xterm-accessibility-tree > div {\n  transform-origin: left;\n  width: fit-content;\n}\n\n.xterm .live-region {\n    position: absolute;\n    left: -9999px;\n    width: 1px;\n    height: 1px;\n    overflow: hidden;\n}\n\n.xterm-dim {\n    /* Dim should not apply to background, so the opacity of the foreground color is applied\n     * explicitly in the generated class and reset to 1 here */\n    opacity: 1 !important;\n}\n\n.xterm-underline-1 { text-decoration: underline; }\n.xterm-underline-2 { text-decoration: double underline; }\n.xterm-underline-3 { text-decoration: wavy underline; }\n.xterm-underline-4 { text-decoration: dotted underline; }\n.xterm-underline-5 { text-decoration: dashed underline; }\n\n.xterm-overline {\n    text-decoration: overline;\n}\n\n.xterm-overline.xterm-underline-1 { text-decoration: overline underline; }\n.xterm-overline.xterm-underline-2 { text-decoration: overline double underline; }\n.xterm-overline.xterm-underline-3 { text-decoration: overline wavy underline; }\n.xterm-overline.xterm-underline-4 { text-decoration: overline dotted underline; }\n.xterm-overline.xterm-underline-5 { text-decoration: overline dashed underline; }\n\n.xterm-strikethrough {\n    text-decoration: line-through;\n}\n\n.xterm-screen .xterm-decoration-container .xterm-decoration {\n\tz-index: 6;\n\tposition: absolute;\n}\n\n.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer {\n\tz-index: 7;\n}\n\n.xterm-decoration-overview-ruler {\n    z-index: 8;\n    position: absolute;\n    top: 0;\n    right: 0;\n    pointer-events: none;\n}\n\n.xterm-decoration-top {\n    z-index: 2;\n    position: relative;\n}\n\n\n\n/* Derived from vs/base/browser/ui/scrollbar/media/scrollbar.css */\n\n/* xterm.js customization: Override xterm's cursor style */\n.xterm .xterm-scrollable-element > .scrollbar {\n    cursor: default;\n}\n\n/* Arrows */\n.xterm .xterm-scrollable-element > .scrollbar > .scra {\n\tcursor: pointer;\n\tfont-size: 11px !important;\n}\n\n.xterm .xterm-scrollable-element > .visible {\n\topacity: 1;\n\n\t/* Background rule added for IE9 - to allow clicks on dom node */\n\tbackground:rgba(0,0,0,0);\n\n\ttransition: opacity 100ms linear;\n\t/* In front of peek view */\n\tz-index: 11;\n}\n.xterm .xterm-scrollable-element > .invisible {\n\topacity: 0;\n\tpointer-events: none;\n}\n.xterm .xterm-scrollable-element > .invisible.fade {\n\ttransition: opacity 800ms linear;\n}\n\n/* Scrollable Content Inset Shadow */\n.xterm .xterm-scrollable-element > .shadow {\n\tposition: absolute;\n\tdisplay: none;\n}\n.xterm .xterm-scrollable-element > .shadow.top {\n\tdisplay: block;\n\ttop: 0;\n\tleft: 3px;\n\theight: 3px;\n\twidth: 100%;\n\tbox-shadow: var(--vscode-scrollbar-shadow, #000) 0 6px 6px -6px inset;\n}\n.xterm .xterm-scrollable-element > .shadow.left {\n\tdisplay: block;\n\ttop: 3px;\n\tleft: 0;\n\theight: 100%;\n\twidth: 3px;\n\tbox-shadow: var(--vscode-scrollbar-shadow, #000) 6px 0 6px -6px inset;\n}\n.xterm .xterm-scrollable-element > .shadow.top-left-corner {\n\tdisplay: block;\n\ttop: 0;\n\tleft: 0;\n\theight: 3px;\n\twidth: 3px;\n}\n.xterm .xterm-scrollable-element > .shadow.top.left {\n\tbox-shadow: var(--vscode-scrollbar-shadow, #000) 6px 0 6px -6px inset;\n}\n"

package/plugins/driver-pty/client/vendor/xterm.d.mts

@@ -0,0 +1,17 @@
+// The part of xterm.js the terminal tab uses (the vendored file ships no types).
+export interface ITerminalAddon {
+  activate(terminal: Terminal): void
+  dispose(): void
+}
+export class Terminal {
+  constructor(options?: { cursorBlink?: boolean; fontSize?: number; convertEol?: boolean })
+  readonly cols: number
+  readonly rows: number
+  loadAddon(addon: ITerminalAddon): void
+  open(parent: HTMLElement): void
+  write(data: string): void
+  reset(): void
+  focus(): void
+  dispose(): void
+  onData(listener: (data: string) => void): { dispose(): void }
+}