@abide/abide 0.58.0 → 0.100.0

package/src/devEntry.ts

@@ -1,381 +0,0 @@
-import { readdirSync, watch } from 'node:fs'
-import type { Subprocess } from 'bun'
-import { build } from './build.ts'
-import { DEFAULT_PORT } from './lib/server/runtime/DEFAULT_PORT.ts'
-import { DEV_READY_MESSAGE } from './lib/server/runtime/DEV_READY_MESSAGE.ts'
-import { DEV_REBUILD_MESSAGE } from './lib/server/runtime/DEV_REBUILD_MESSAGE.ts'
-import { findOpenPort } from './lib/server/runtime/findOpenPort.ts'
-import { abideLog } from './lib/shared/abideLog.ts'
-import { changeAffectsClient } from './lib/shared/changeAffectsClient.ts'
-import { DEV_REBUILD_PATH } from './lib/shared/DEV_REBUILD_PATH.ts'
-
-/*
-Dev orchestrator. Replaces `bun --watch` (which only watches the import graph,
-so new files / CSS / public assets never triggered a restart) with an explicit
-loop we own end to end:
-
-  1. Build the client once — uncompressed, unminified (compressing on every
-     rebuild dwarfs the bundle; the server serves the plain bytes when no .gz exists).
-  2. Spawn the server as a child against a fixed dev port and ABIDE_DEV=1, which
-     makes it mount the /__abide/dev live-reload channel.
-  3. Watch src/ recursively. On any change, rebuild then swap the worker: the
-     replacement boots alongside the incumbent (both bind the port via
-     reusePort) and the incumbent is retired only once the replacement reports
-     ready over IPC — the port keeps answering across the whole restart. SSR
-     renders pages through Bun's module cache, so a fresh module graph (a new
-     process) is the reliable way to reflect a source edit — Bun has no stable
-     in-process invalidation. Killing the incumbent drops the browser's
-     live-reload channel; it reconnects straight onto the already-listening
-     replacement and reloads itself.
-
-Each client build lands in its OWN `dist/_app.gen-<id>` directory (build.ts,
-`clean: false`) and the worker spawned for it is pinned to that dir via
-`ABIDE_APP_DIR`. So the incumbent keeps serving its generation's chunks off disk
-for the whole overlap while the replacement serves the new one — nothing is a
-shared mutable `_app`, so a draining worker can never 500 on chunks the new build
-would otherwise have deleted. A generation dir is pruned once its worker exits.
-
-Restarts are serialized (a build mid-flight queues the next) and the port is
-fixed so the browser tab stays valid across restarts. A failed build — or a
-replacement that dies or hangs while booting — keeps the last-good server
-running rather than tearing the loop down. A worker that crashes while active
-is respawned, bounded so a boot-time crash loop gives up and waits for a save.
-*/
-const cwd = process.cwd()
-const PRELOAD = new URL('./preload.ts', import.meta.url).pathname
-const SERVER_ENTRY = new URL('./serverEntry.ts', import.meta.url).pathname
-const SOURCE_DIR = `${cwd}/src`
-// Coalesce editor save bursts (and multi-file saves) into one rebuild.
-const REBUILD_DEBOUNCE_MS = 60
-// How long a booting replacement gets to report ready before it is discarded.
-const READY_TIMEOUT_MS = 30000
-// Consecutive worker exits with no ready signal in between before the
-// crash-respawn loop gives up and waits for the next save.
-const MAX_EXITS_WITHOUT_READY = 3
-/*
-Generated dir the build itself writes into src/ (route type declarations). It
-must be ignored or each rebuild's write retriggers the watcher — an endless
-rebuild loop.
-*/
-const GENERATED_DIR = '.abide'
-
-// True for paths under src/.abide (the build's own generated output).
-function isGenerated(filename: string): boolean {
-    return filename.split(/[\\/]/).includes(GENERATED_DIR)
-}
-
-// clean:false leaves the live dist in place — each build emits its own
-// `_app.gen-<id>` dir, so the running server never serves a half-built bundle and
-// a rebuild never mutates the dir an existing worker is reading.
-const buildOptions = {
-    cwd,
-    minify: false,
-    compress: false,
-    clean: false,
-    exitOnFailure: false,
-    dev: true,
-} as const
-
-// The worker currently meant to be serving; undefined while crashed or replaced.
-let server: Subprocess | undefined
-// The `_app.gen-<id>` dir the active worker is pinned to — the bundle it serves and
-// the dir to prune once it (and no successor sharing it) is gone.
-let currentAppDir = `${cwd}/dist/_app`
-let shuttingDown = false
-// Worker exits since the last ready signal — bounds the crash-respawn loop.
-let exitsWithoutReady = 0
-
-/* Remove a spent generation dir. Guarded to a `_app.gen-*` path so a bug (or the
-   `${cwd}/dist/_app` fallback when the first build failed) can never `rm` the wrong
-   thing. Best-effort — a leftover is swept by pruneStaleBuildDirs next dev start. */
-async function pruneGenDir(dir: string): Promise<void> {
-    if (!dir.includes('/_app.gen-')) {
-        return
-    }
-    await Bun.$`rm -rf ${dir}`.quiet().nothrow()
-}
-
-/* Sweep generation/staging/old dirs left by a prior dev session that exited without
-   cleaning up (crash, kill -9). Runs once before the first build so dist doesn't
-   accumulate them across sessions. */
-function pruneStaleBuildDirs(): void {
-    const distDir = `${cwd}/dist`
-    let entries: string[]
-    try {
-        entries = readdirSync(distDir)
-    } catch {
-        return // no dist yet — nothing to sweep
-    }
-    for (const name of entries) {
-        if (/^_app\.(gen|staging|old)-/.test(name)) {
-            void Bun.$`rm -rf ${distDir}/${name}`.quiet().nothrow()
-        }
-    }
-}
-
-/*
-Spawn a server worker against the fixed dev port, pinned to `appDir` (its build
-generation) via ABIDE_APP_DIR so its shell, preload manifest, and asset server all
-read that one dir for its whole life. `ready` resolves when the worker reports its
-listener is up and init() has run (DEV_READY_MESSAGE) — the cue that a replacement
-may retire its predecessor.
-*/
-function spawnWorker(
-    port: number,
-    appDir: string,
-    /* Only the first worker prints the diagnostic surface map (it eager-loads the
-       registry — off the reload hot path for every respawn, whose surface is identical). */
-    printSurface = false,
-): { proc: Subprocess; ready: Promise<void> } {
-    const readiness = Promise.withResolvers<void>()
-    const proc = Bun.spawn({
-        cmd: ['bun', '--preload', PRELOAD, SERVER_ENTRY],
-        cwd,
-        /*
-        ABIDE_PARENT_PID activates serverEntry's exitWithParent watchdog: the
-        worker polls this orchestrator and self-exits if it dies abruptly
-        (kill -9, OOM) without running its shutdown handlers, so a wedged
-        orchestrator can't leave the worker orphaned holding the dev port.
-        */
-        env: {
-            ...process.env,
-            PORT: String(port),
-            ABIDE_DEV: '1',
-            ABIDE_PARENT_PID: String(process.pid),
-            ABIDE_APP_DIR: appDir,
-            ABIDE_DEV_SURFACE: printSurface ? '1' : '0',
-        },
-        stdio: ['inherit', 'inherit', 'inherit'],
-        // The child's POST /__abide/reload route signals a rebuild over IPC, so the
-        // trigger rides the app's own port instead of a side channel.
-        ipc(message) {
-            if (message === DEV_REBUILD_MESSAGE) {
-                void rebuild(port)
-            }
-            if (message === DEV_READY_MESSAGE) {
-                exitsWithoutReady = 0
-                readiness.resolve()
-            }
-        },
-    })
-    respawnOnUnexpectedExit(proc, port, appDir)
-    return { proc, ready: readiness.promise }
-}
-
-/*
-A worker that dies while it is the active server — an app crash, not a swap or
-shutdown — used to leave the port dead until a manual restart. Respawn it,
-giving up after MAX_EXITS_WITHOUT_READY exits in a row so a crash-on-boot
-doesn't spin; the next save retries through rebuild.
-*/
-function respawnOnUnexpectedExit(proc: Subprocess, port: number, appDir: string): void {
-    void proc.exited.then((exitCode) => {
-        if (shuttingDown || server !== proc) {
-            return
-        }
-        server = undefined
-        exitsWithoutReady += 1
-        if (exitsWithoutReady >= MAX_EXITS_WITHOUT_READY) {
-            abideLog.warn(
-                `server keeps exiting (code ${exitCode}) — fix the error and save to retry`,
-            )
-            return
-        }
-        abideLog.warn(`server exited unexpectedly (code ${exitCode}) — restarting`)
-        // Respawn on the SAME generation dir — the bundle is fine, the process crashed.
-        server = spawnWorker(port, appDir).proc
-    })
-}
-
-/* Terminate a worker and wait for it to exit (SIGKILL watchdog for a wedged exit). */
-async function stopWorker(proc: Subprocess): Promise<void> {
-    proc.kill()
-    const watchdog = setTimeout(() => proc.kill('SIGKILL'), 3000)
-    await proc.exited
-    clearTimeout(watchdog)
-}
-
-/*
-Zero-downtime swap onto `nextAppDir` (the new build's generation dir). The
-replacement overlaps the incumbent — both bind the dev port via reusePort (see
-createServer) and the kernel keeps delivering connections to the incumbent until it
-stops — so the port answers throughout the new module graph's boot, and each worker
-serves its own generation dir so the overlap never crosses chunk sets. Only a
-replacement that reports ready retires the incumbent; one that dies or hangs booting
-is discarded and the last-good server keeps serving, mirroring how a failed build is
-handled. A generation dir is pruned once no worker references it: the retired
-incumbent's dir after it exits, or the failed replacement's own dir if it never
-took over (unless a server-only restart reused the incumbent's dir — then it stays).
-*/
-async function replaceServer(port: number, nextAppDir: string): Promise<void> {
-    const previous = server
-    const previousAppDir = currentAppDir
-    const next = spawnWorker(port, nextAppDir)
-    const outcome = await Promise.race([
-        next.ready.then(() => 'ready' as const),
-        next.proc.exited.then(() => 'exited' as const),
-        Bun.sleep(READY_TIMEOUT_MS).then(() => 'timeout' as const),
-    ])
-    if (outcome !== 'ready') {
-        if (outcome === 'timeout') {
-            await stopWorker(next.proc)
-        }
-        abideLog.warn('new server failed to boot — the previous one (if any) keeps serving')
-        // The replacement never served; its fresh generation dir is orphaned. Prune it,
-        // unless a server-only restart reused the still-serving incumbent's dir.
-        if (nextAppDir !== previousAppDir) {
-            await pruneGenDir(nextAppDir)
-        }
-        return
-    }
-    server = next.proc
-    currentAppDir = nextAppDir
-    if (previous) {
-        await stopWorker(previous)
-        // The incumbent is gone; retire its generation dir — unless the replacement is
-        // serving that same dir (a server-only restart with no client rebuild).
-        if (previousAppDir !== nextAppDir) {
-            await pruneGenDir(previousAppDir)
-        }
-    }
-}
-
-let building = false
-let queued = false
-// True once any change collapsed into the queued run needs the client rebuilt;
-// a client-affecting change can never be downgraded to a server-only restart.
-let queuedNeedsClient = false
-
-/*
-Apply a change: rebuild the client (unless `skipClientBuild` — a server/MCP-only
-change leaves the client bundle byte-identical), then on success swap in a fresh
-server child. The worker restart always runs: SSR renders through Bun's module
-cache, so a new process is the only reliable way to reflect any source edit,
-client-affecting or not.
-
-Serialized: a change arriving mid-build sets `queued` so exactly one more run
-follows, collapsing further changes in between; `queuedNeedsClient` records
-whether any of them needs the client, so the collapsed run never skips a client
-rebuild a queued change required. A failed build leaves the current child
-untouched — the error is logged and the last-good server keeps serving.
-*/
-async function rebuild(port: number, skipClientBuild = false): Promise<void> {
-    if (building) {
-        queued = true
-        queuedNeedsClient ||= !skipClientBuild
-        return
-    }
-    building = true
-    try {
-        /* A server/MCP-only change keeps the existing client bundle, so the replacement
-           worker reuses the incumbent's generation dir; a client rebuild produces a fresh
-           one. Either way the swap needs the dir the new worker should serve. */
-        const built = skipClientBuild ? { appDir: currentAppDir } : await build(buildOptions)
-        if (built) {
-            await replaceServer(port, built.appDir)
-        }
-        /* A server/MCP-only change reuses the existing client bundle. That's correct for
-           an rpc/socket handler BODY edit, but changing an rpc's method or its export name
-           changes the client proxy stub too — the stale bundle then calls with the old shape
-           (e.g. a 405). Flag the skip so that case isn't silent. */
-        if (skipClientBuild) {
-            abideLog.info(
-                'server-only change — kept the existing client bundle; if you changed an rpc method or export name, save a client file (or restart dev) for a full rebuild',
-            )
-        }
-    } finally {
-        building = false
-        if (queued) {
-            queued = false
-            const needsClient = queuedNeedsClient
-            queuedNeedsClient = false
-            void rebuild(port, !needsClient)
-        }
-    }
-}
-
-/*
-Pick a free port once and reuse it for every restart, so the browser tab keeps
-pointing at the same address. Scans upward from the shared default so dev lands
-on the same predictable 3000+ address as `bun start`; reusing the number across
-restarts (not re-scanning) is what keeps the tab valid.
-*/
-const port = findOpenPort(DEFAULT_PORT)
-// Sweep generation dirs a prior session may have left behind before building afresh.
-pruneStaleBuildDirs()
-/* Announce the boot before the first build. build() stays silent under dev (its
-   "building…" log is gated so watch rebuilds don't spam), so without this line the
-   terminal shows nothing for the whole initial build — a cold boot reads as a hang.
-   One line up front: the server is alive, building, and where it will land. */
-abideLog.info(`starting dev server at http://localhost:${port} — building client…`)
-const firstBuild = await build(buildOptions)
-if (firstBuild) {
-    currentAppDir = firstBuild.appDir
-} else {
-    // Leave currentAppDir at the `${cwd}/dist/_app` fallback; the worker will serve
-    // broken assets until a save produces a real generation, matching prior behaviour.
-    abideLog.warn('initial build failed — fix the error and save to retry')
-}
-// The initial worker prints the surface map once (printSurface); respawns don't.
-server = spawnWorker(port, currentAppDir, true).proc
-
-/*
-ABIDE_DEV_NO_WATCH=1 skips the fs watcher: rebuild only on demand via POST
-/__abide/reload (always mounted under dev), so a long-lived in-process job — e.g.
-an agent editing the app's own source — isn't yanked mid-run by a save.
-*/
-const manualRebuild = Bun.env.ABIDE_DEV_NO_WATCH === '1'
-
-let debounce: ReturnType<typeof setTimeout> | undefined
-/*
-True only while every change collapsed into the pending debounce is server/MCP-
-only; one client-affecting change in the burst flips it false (latches until the
-debounce fires), so a multi-file save that touches the client never skips the
-client rebuild.
-*/
-let pendingSkipClientBuild = true
-const watcher = manualRebuild
-    ? undefined
-    : watch(SOURCE_DIR, { recursive: true }, (_event, filename) => {
-          if (!filename || isGenerated(filename)) {
-              return
-          }
-          pendingSkipClientBuild &&= !changeAffectsClient(filename)
-          clearTimeout(debounce)
-          debounce = setTimeout(() => {
-              const skipClientBuild = pendingSkipClientBuild
-              pendingSkipClientBuild = true
-              void rebuild(port, skipClientBuild)
-          }, REBUILD_DEBOUNCE_MS)
-      })
-if (manualRebuild) {
-    abideLog.info(
-        `manual rebuild mode — POST http://localhost:${port}${DEV_REBUILD_PATH} to apply changes`,
-    )
-}
-
-/* Tear down the watcher and the child on shutdown so neither outlives the orchestrator. */
-const shutdown = async () => {
-    shuttingDown = true
-    watcher?.close()
-    if (server) {
-        await stopWorker(server)
-    }
-    // Drop the active generation dir on the way out; any other leftover is swept on the
-    // next dev start by pruneStaleBuildDirs.
-    await pruneGenDir(currentAppDir)
-    process.exit(0)
-}
-process.on('SIGINT', shutdown)
-process.on('SIGTERM', shutdown)
-process.on('SIGHUP', shutdown)
-
-/*
-Last-resort sync cleanup: Bun.spawn'd children aren't reaped when the parent
-dies, so a crash (uncaught error, terminal close) would otherwise leave the
-server holding the dev port. 'exit' fires for every exit path; kill is
-synchronous, which is enough to signal the child before we go.
-*/
-process.on('exit', () => {
-    server?.kill()
-})

package/src/discoveryEntry.ts

@@ -1,82 +0,0 @@
-// @ts-expect-error virtual module resolved by abideResolverPlugin
-import { rpc } from './_virtual/rpc.ts'
-// @ts-expect-error virtual module resolved by abideResolverPlugin
-import { sockets } from './_virtual/sockets.ts'
-import type { CliManifestEntry } from './lib/cli/types/CliManifestEntry.ts'
-import { resolveInputJsonSchema } from './lib/server/rpc/resolveRpcJsonSchema.ts'
-import { rpcRegistry } from './lib/server/rpc/rpcRegistry.ts'
-import { socketOperations } from './lib/server/sockets/socketOperations.ts'
-import { socketRegistry } from './lib/server/sockets/socketRegistry.ts'
-import { commandNameForUrl } from './lib/shared/commandNameForUrl.ts'
-import { jsonSchemaForSchema } from './lib/shared/jsonSchemaForSchema.ts'
-
-/*
-One-shot script that imports every rpc + socket module so defineRpc /
-defineSocket populate the process-wide registries, then prints the CLI
-manifest to stdout as JSON. Used by buildCli to bake the manifest into
-the standalone binary at build time without resorting to static source
-parsing (which can't see toJsonSchema()/toJSONSchema() at compile time).
-*/
-await Promise.all([
-    ...Object.values(rpc).map((loader) => (loader as () => Promise<unknown>)()),
-    ...Object.values(sockets).map((loader) => (loader as () => Promise<unknown>)()),
-])
-
-const manifest: Record<string, CliManifestEntry> = {}
-
-for (const entry of rpcRegistry.values()) {
-    if (!entry.remote.clients.cli) {
-        continue
-    }
-    manifest[commandNameForUrl(entry.remote.url)] = {
-        method: entry.remote.method,
-        url: entry.remote.url,
-        jsonSchema: resolveInputJsonSchema(entry) ?? jsonSchemaForSchema(undefined),
-    }
-}
-
-/*
-Sockets advertised to the CLI become commands against the socket's HTTP
-face (see socketOperations): `<base>-tail` streams live (GET +
-text/event-stream, with an optional --tail N to seed from the retained
-tail first) and, when clientPublish is set, `<base>-publish` sends the args bag
-as a message (POST).
-*/
-for (const entry of socketRegistry.values()) {
-    if (!entry.clients.cli) {
-        continue
-    }
-    for (const operation of socketOperations(entry)) {
-        if (operation.kind === 'tail') {
-            manifest[operation.name] = {
-                method: operation.method,
-                url: operation.restUrl,
-                accept: 'text/event-stream',
-                jsonSchema: {
-                    type: 'object',
-                    description: `tail the "${operation.socketName}" socket`,
-                    properties: {
-                        tail: {
-                            type: 'number',
-                            description: 'replay last N messages before tailing live',
-                        },
-                    },
-                },
-            }
-            continue
-        }
-        const payloadSchema = jsonSchemaForSchema(entry.schema)
-        manifest[operation.name] = {
-            method: operation.method,
-            url: operation.restUrl,
-            jsonSchema: {
-                ...payloadSchema,
-                description:
-                    (payloadSchema.description as string | undefined) ??
-                    `publish a message to the "${operation.socketName}" socket`,
-            },
-        }
-    }
-}
-
-process.stdout.write(JSON.stringify(manifest))

package/src/initAgent.ts

@@ -1,50 +0,0 @@
-/* Marker pair fencing the abide block, so a re-run replaces it in place rather
-   than duplicating, and the rest of an existing CLAUDE.md stays untouched. */
-const GUIDE_START = '<!-- abide:agent-guide -->'
-const GUIDE_END = '<!-- /abide:agent-guide -->'
-
-/* The pointer injected into the consumer's root CLAUDE.md. Claude Code auto-loads
-   root CLAUDE.md but never reads node_modules, so this is the only reliable hook
-   telling it where abide's full surface map lives. */
-const GUIDE_BLOCK = `${GUIDE_START}
-## Working with abide
-
-This project uses **abide**. Before using any abide API, read the complete surface
-map: \`node_modules/@abide/abide/AGENTS.md\` — every export (import path + signature),
-the file-based conventions, the CLI, env vars, and the \`.abide\` component grammar.
-Open the source under \`node_modules/@abide/abide/src/lib/\` for depth.
-${GUIDE_END}`
-
-/* Folds the guide block into existing CLAUDE.md content: replaces a fenced block
-   when both markers are present, otherwise appends it; titles a fresh file when
-   there is no content. Pure — the side effect (write) stays in initAgent. */
-function mergeGuide(existing: string | undefined): string {
-    if (existing === undefined) {
-        return `# Project guide for Claude\n\n${GUIDE_BLOCK}\n`
-    }
-    const start = existing.indexOf(GUIDE_START)
-    const end = existing.indexOf(GUIDE_END)
-    if (start !== -1 && end > start) {
-        return existing.slice(0, start) + GUIDE_BLOCK + existing.slice(end + GUIDE_END.length)
-    }
-    return `${existing.replace(/\s*$/, '')}\n\n${GUIDE_BLOCK}\n`
-}
-
-/*
-Writes (or refreshes) the abide agent-guide block in the project's root CLAUDE.md
-so Claude is pointed at node_modules/@abide/abide/AGENTS.md. Idempotent: the marker
-pair fences the block, so re-running updates it in place instead of duplicating, and
-any surrounding CLAUDE.md content is preserved. For projects that added abide as a
-dependency without scaffolding (the scaffold ships this pointer already).
-*/
-export async function initAgent({ cwd }: { cwd: string }): Promise<void> {
-    const path = `${cwd}/CLAUDE.md`
-    const file = Bun.file(path)
-    const existed = await file.exists()
-    await Bun.write(path, mergeGuide(existed ? await file.text() : undefined))
-    console.log(
-        existed
-            ? `[abide] refreshed the abide agent-guide in ${path}`
-            : `[abide] wrote ${path} pointing Claude at node_modules/@abide/abide/AGENTS.md`,
-    )
-}

package/src/lib/bundle/BundleMenu.ts

@@ -1,12 +0,0 @@
-import type { BundleMenuItem } from './BundleMenuItem.ts'
-
-/*
-A top-level bundle menu, inserted into the macOS menu bar between the standard
-Edit and Window menus. `label` titles the menu; `items` are its entries top to
-bottom.
-*/
-// @documentation bundle
-export type BundleMenu = {
-    label: string
-    items: BundleMenuItem[]
-}

package/src/lib/bundle/BundleMenuItem.ts

@@ -1,25 +0,0 @@
-/*
-A single entry in a bundle menu. Serializable data — the native shim builds the
-matching NSMenuItem. Either a divider or a clickable item that dispatches a
-`abide:menu` CustomEvent into the page (detail `{ name }`); the app's own code
-handles it:
-
-    window.addEventListener('abide:menu', (event) => {
-        if (event.detail.name === 'sync') syncNow()
-    })
-
-Emitting an event (rather than calling a rpc directly) is what lets a menu
-drive parameterised work: a click carries no arguments, so the app computes
-them and makes the call itself. `shortcut` is the key for the Cmd-based
-equivalent (e.g. `'r'` → Cmd-R).
-
-A `navigate` item moves the window instead of talking to the page: clicking it
-calls `webview_navigate` with the given URL (the native side, on the UI thread).
-That's how the built-in Server menu drives the connect screen — `emit` reaches
-the loaded page, `navigate` repoints the window itself.
-*/
-// @documentation bundle
-export type BundleMenuItem =
-    | { separator: true }
-    | { label: string; shortcut?: string; emit: string }
-    | { label: string; shortcut?: string; navigate: string }

package/src/lib/bundle/BundleWindow.ts

@@ -1,37 +0,0 @@
-import type { StandardSchemaV1 } from '../shared/types/StandardSchemaV1.ts'
-import type { BundleMenu } from './BundleMenu.ts'
-
-/*
-User-authored bundle window configuration, default-exported from an
-optional `src/bundle/window.ts`. Baked into the launcher at build time
-(via the `abide:bundle-window` virtual) and read directly in dev. Every
-field is optional — the launcher falls back to the program name for the
-title and to openWebview's defaults for size.
-
-The standard App/Edit/Window menus (Quit, copy/paste, minimize/close) plus the
-built-in File menu (Start server / Connect / Disconnect) are always installed.
-`menu` adds custom top-level menus between the Edit and Window menus; their items
-emit `abide:menu` events the app handles. See BundleMenuItem.
-*/
-// @documentation bundle
-export type BundleWindow = {
-    title?: string
-    width?: number
-    height?: number
-    menu?: BundleMenu[]
-    /*
-    Overrides the bundle setup form's schema. By default the form is derived from
-    src/server/config.ts's env schema, so one declaration drives both boot
-    validation and the form — set this only when the bundle form should differ
-    from the env schema (it replaces, not merges; compose with the env schema
-    yourself via its `.extend(...)` if you want both).
-
-    A Standard Schema (the same kind abide accepts for RPC/MCP). Its JSON Schema
-    drives the connect screen's first-run form, shown as a modal when Start is
-    clicked with a required key still unset; the user's answers persist to the
-    data-dir `.env` the server loads at boot. Each property maps to one env var of
-    the same name; `title` is the field label, `description` the hint,
-    `format: 'password'` masks the input, and `default` pre-fills it.
-    */
-    config?: StandardSchemaV1
-}

package/src/lib/bundle/WEBVIEW_BUILD_REVISION.ts

@@ -1,9 +0,0 @@
-/*
-Revision of abide's own contribution to the compiled webview library — the
-native shim sources linked in beside the vendored header (e.g. abideMenu.mm)
-and the flags buildWebviewLib compiles them with. It participates in the build
-cache key alongside the upstream version, so changing abide's native build
-selects a fresh cache path and bypasses any library built before the change.
-Bump this whenever the shim sources or their compile invocation change.
-*/
-export const WEBVIEW_BUILD_REVISION = 9

package/src/lib/bundle/WEBVIEW_VERSION.ts

@@ -1,7 +0,0 @@
-/*
-Upstream `webview/webview` release the vendored `native/webview.h` is taken
-from (https://github.com/webview/webview, MIT). Used to namespace the build
-cache so bumping the header naturally bypasses any previously built library.
-Bump this whenever `native/webview.h` is re-vendored.
-*/
-export const WEBVIEW_VERSION = '0.12.0'

package/src/lib/bundle/bindConnectedFlag.ts

@@ -1,29 +0,0 @@
-import { dlopen, FFIType } from 'bun:ffi'
-
-/*
-Binds abide_set_connected — the native flag the macOS Server menu's
-validateMenuItem: reads to enable/disable Start/Disconnect. The symbol is
-compiled only into the macOS lib (the Cocoa menu shim), so a failed lookup
-degrades to a no-op setter rather than throwing on Linux/Windows.
-
-The flag is a process-global, which is what lets the bundle's control server set
-it from off the main thread: that server runs in a Worker because `webview_run`
-blocks the main thread's JS event loop, yet the main-thread menu still reads the
-same value through the shared dylib image. The returned close releases the handle.
-*/
-export function bindConnectedFlag(libPath: string): {
-    setConnected: (connected: boolean) => void
-    close: () => void
-} {
-    try {
-        const lib = dlopen(libPath, {
-            abide_set_connected: { args: [FFIType.i32], returns: FFIType.void },
-        })
-        return {
-            setConnected: (connected) => lib.symbols.abide_set_connected(connected ? 1 : 0),
-            close: () => lib.close(),
-        }
-    } catch {
-        return { setConnected: () => {}, close: () => {} }
-    }
-}

package/src/lib/bundle/bindRequestNavigate.ts

@@ -1,34 +0,0 @@
-import { dlopen, FFIType, type Pointer } from 'bun:ffi'
-
-/*
-Binds abide_request_navigate — points the live webview window at a URL from any
-thread by hopping onto the UI thread via webview_dispatch. The launcher's control
-server runs in a Worker (off the main thread that webview_run blocks), so when it
-detects the connected server has died it uses this to bounce the window back to the
-connect screen. macOS-only symbol (the Cocoa shim), so a failed lookup degrades to
-a no-op — elsewhere the worker can still correct the menu flag, just not the window.
-
-`handle` is the webview pointer created on the main thread, forwarded to the worker
-as a number; bun:ffi accepts it for a ptr argument from either thread because the
-pointer addresses the same process heap.
-*/
-export function bindRequestNavigate(libPath: string): {
-    requestNavigate: (handle: number, url: string) => void
-    close: () => void
-} {
-    try {
-        const lib = dlopen(libPath, {
-            abide_request_navigate: { args: [FFIType.ptr, FFIType.ptr], returns: FFIType.void },
-        })
-        return {
-            requestNavigate: (handle, url) =>
-                lib.symbols.abide_request_navigate(
-                    handle as Pointer,
-                    new TextEncoder().encode(`${url}\0`),
-                ),
-            close: () => lib.close(),
-        }
-    } catch {
-        return { requestNavigate: () => {}, close: () => {} }
-    }
-}