sideby 0.16.0 → 0.17.0

package/dist/src/panel/page-styles.js

@@ -197,7 +197,8 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .next-why { margin: 0 0 10px; max-width: 280px; line-height: 1.5; }
 .next-cmd { display: block; margin-top: 8px; color: var(--muted); font-size: 11px; }
 /* A Same Login (spec §3.21, ADR-0026): one row; opened, a short line per directory. */
-.tag-login { font-weight: 400; }
+.login-mark { display: inline-flex; flex: none; color: var(--muted); cursor: help; }
+.login-mark .ic { width: 13px; height: 13px; }
 .login-detail { flex-direction: column; gap: 8px; }
 .login-detail .rd-note { margin: 0; }
 /* The directories share one set of columns (subgrid), so a wider cell in one line moves every line alike. */
@@ -220,9 +221,9 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .arrange-tools { display: inline-flex; align-items: center; gap: 2px; }
 .arrange-tools .icon-btn { width: 28px; height: 28px; }
 .arrange-tools .icon-btn .ic { width: 14px; height: 14px; }
-.pin-btn { color: var(--faint); }
-.pin-btn[aria-pressed="true"] { color: var(--accent); }
-.pin-btn[aria-pressed="true"] .ic { fill: currentColor; }
+/* One width for "Pin to top" and "Unpin", so the arrows line up down the list. */
+.arrange-tools .pin-btn { min-width: 96px; margin-left: 6px; justify-content: center; }
+.pin-btn[aria-disabled="true"] { color: var(--faint); cursor: not-allowed; }
 .drag-handle { width: 20px; height: 28px; color: var(--muted); cursor: grab; }
 .drag-handle:hover { color: var(--accent); }
 .drag-handle .ic { width: 14px; height: 14px; }
@@ -251,9 +252,12 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .col-head > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; }
 .col-head .quota > span { overflow: hidden; text-overflow: ellipsis; }
 .ident { grid-area: id; display: flex; align-items: center; gap: 10px; min-width: 0; }
-.ident-text { min-width: 0; flex: 1; }
+.ident-text { min-width: 0; flex: 1; position: relative; padding-left: 18px; }
+/* The pin sits in the text column's own gutter, so the name and the email below it start at the same place. */
+.ident-text .pin-slot, .ident-text .pin-mark { position: absolute; left: 0; top: 2px; margin: 0; }
 .ident-name { display: flex; align-items: center; gap: 6px; min-width: 0; flex-wrap: wrap; row-gap: 3px; }
 .ident-name .name { font-weight: var(--strong-weight); font-size: var(--font-size); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 100%; }
+.ident-name .alias { color: var(--muted); font-family: var(--mono); font-size: 12px; white-space: nowrap; }
 .ident-email { color: var(--muted); font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; margin-top: 1px; }
 .email-btn, .model-btn { all: unset; cursor: pointer; border-radius: 4px; }
 .model-btn:hover { color: var(--text); text-decoration: underline dotted; }
@@ -263,11 +267,12 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .br-list { list-style: none; margin: 0 0 12px; padding: 0; display: flex; flex-direction: column; gap: 6px; }
 .br-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 6px 10px; border: 1px solid var(--border); border-radius: var(--ctl-radius); }
 .email-btn:hover { color: var(--text); text-decoration: underline dotted; }
+/* A button is laid out as one box, so the parent's ellipsis does not reach its text: it ends its own. */
+.ident-email .email-btn { display: inline-block; max-width: 100%; overflow: hidden; text-overflow: ellipsis; vertical-align: bottom; }
 .email-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; }
-.ident-email:has(.br-btn) { display: flex; align-items: center; }
-.ident-email:has(.br-btn) > * { flex: none; }
-.ident-email:has(.br-btn) > .email-btn:not(.br-btn) { flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
-.br-btn { display: inline-flex; align-items: center; gap: 3px; vertical-align: bottom; }
+.br-btn { display: inline-flex; align-items: center; gap: 4px; color: var(--muted); font-size: 12px; max-width: 100%; }
+.br-btn:hover { color: var(--text); text-decoration: underline dotted; }
+.card > .rd-browser { flex-direction: row; align-items: center; gap: 8px; }
 .br-ico { width: 12px; height: 12px; flex: none; }
 .ident-email + .ident-sub { color: var(--faint); margin-top: 0; }
 .tools .tb-icon { width: var(--ctl-h); height: var(--ctl-h); border-color: var(--border-strong); background: var(--surface); }
@@ -282,19 +287,21 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .row > .quota { grid-area: quota; }
 .row > .last { grid-area: last; }
 .row > .row-end { grid-area: more; display: flex; align-items: center; justify-content: flex-end; gap: 4px; }
-/* The row's pin (spec §3.25): filled and always there on a pinned row; on the others it shows on hover or focus. */
 .row-run { width: 28px; height: 28px; color: var(--muted); }
 .row-run .ic { width: 15px; height: 15px; }
 .row-run:hover { color: var(--accent); }
-.row-pin { width: 28px; height: 28px; color: var(--faint); opacity: 0; transition: opacity .12s, color .12s; }
-.row-pin .ic { width: 15px; height: 15px; }
-.row:hover .row-pin, .card:hover .row-pin, .row-pin:focus-visible, .row-pin.is-on { opacity: 1; }
 .card-head > .row-end { display: flex; align-items: center; gap: 2px; margin-left: auto; }
-.row-pin:hover { color: var(--accent); }
-.row-pin.is-on { color: var(--accent); }
-.row-pin.is-on .ic { fill: currentColor; }
-.row-pin[aria-disabled="true"] { cursor: not-allowed; }
-@media (hover: none) { .row-pin { opacity: .6; } }
+/* A pinned row's mark (spec §3.25, §3.27): a small muted outline pin right before the name, not a button. */
+.pin-mark { display: inline-flex; flex: none; margin-right: -2px; color: var(--faint); }
+.pin-mark .ic { width: 12px; height: 12px; }
+/* The pin before the name (spec §3.27): always there when pinned; a fainter one on hover or focus in the row
+   otherwise. The slot keeps its width either way, so the name never moves. */
+.pin-slot { display: inline-grid; place-items: center; flex: none; width: 16px; height: 16px; margin: 0 -4px 0 -2px; padding: 0; border: 0; border-radius: 4px; background: none; color: var(--faint); cursor: pointer; opacity: 0; }
+.pin-slot .ic { width: 12px; height: 12px; }
+.pin-slot.is-on { opacity: 1; }
+.row:hover .pin-slot:not(.is-on), .row:focus-within .pin-slot:not(.is-on), .card:hover .pin-slot:not(.is-on), .card:focus-within .pin-slot:not(.is-on) { opacity: .5; }
+.pin-slot:hover, .pin-slot:focus-visible { opacity: 1 !important; color: var(--accent); background: var(--hover); outline: none; }
+.ctx-anchor { position: fixed; width: 0; height: 0; pointer-events: none; }
 .row-notes { grid-area: notes; display: flex; flex-direction: column; gap: 6px; margin-top: 8px; }
 
 /* Quota meters: percent and countdown over a bar colored by level (ok, warn at 60%, fail at 85% used). */
@@ -521,6 +528,31 @@ input[type=text]:hover:not(:disabled), input[type=number]:hover:not(:disabled),
 input[type=text]:focus, input[type=search]:focus, select:focus { border-color: var(--focus); }
 input[type=text]:disabled, select:disabled { background-color: var(--surface-2); color: var(--faint); cursor: not-allowed; }
 input.invalid { border-color: var(--fail); }
+/* AI Tasks (spec §3.28): the text box, the key field, the example chips and the account and terminal pickers. */
+input[type=password] { height: var(--field-h); border-radius: var(--ctl-radius); border: 1px solid var(--border-strong); background-color: var(--surface); color: var(--text); font: inherit; padding: 0 12px; width: 100%; }
+textarea.ask-text { min-height: 64px; resize: vertical; border-radius: var(--ctl-radius); border: 1px solid var(--border-strong); background-color: var(--surface); color: var(--text); font: inherit; padding: 8px 12px; width: 100%; line-height: 1.45; }
+input[type=password]:focus, textarea.ask-text:focus { border-color: var(--focus); }
+textarea.ask-text:focus-visible, input[type=password]:focus-visible { outline: var(--focus-outline); outline-offset: 2px; box-shadow: var(--focus-ring); }
+textarea::placeholder { color: var(--faint); }
+.ask-chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.ask-chips .chip { font: inherit; font-size: var(--small); text-align: left; white-space: normal; }
+.ask-attach-row { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 10px; }
+.ask-files-wrap { display: grid; gap: 6px; }
+.ask-files-wrap:empty { display: none; }
+.ask-files { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: 8px; }
+.ask-file { position: relative; display: grid; gap: 2px; width: 104px; padding: 4px; border: 1px solid var(--border); border-radius: var(--ctl-radius); background: var(--surface); }
+.ask-file.is-error { border-color: var(--fail); }
+.ask-file-img, .ask-file-face { width: 94px; height: 64px; border-radius: calc(var(--ctl-radius) - 2px); }
+.ask-file-img { object-fit: cover; display: block; }
+.ask-file-face { display: grid; place-items: center; align-content: center; gap: 2px; background: var(--surface-2); color: var(--muted); }
+.ask-file-name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.ask-file-x { position: absolute; top: 2px; right: 2px; width: 22px; height: 22px; background: var(--surface); }
+.dialog.drop-on { outline: 2px dashed var(--focus); outline-offset: -6px; }
+.ask-pick {display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 10px; }
+.ask-setup .link-btn { display: inline-flex; align-items: center; gap: 6px; }
+.ask-setup .ic { width: 14px; height: 14px; }
+.fam-other { background: transparent; color: inherit; font: inherit; text-align: left; border-style: dashed; }
+.q-ask { margin-left: 6px; }
 /* The select draws its own chevron with two gradient strokes (the CSP allows no external images), so it follows the
    text color in both schemes and on hover. */
 select { --chevron: var(--muted); appearance: none; padding-right: 32px; cursor: pointer; text-overflow: ellipsis;
@@ -581,7 +613,7 @@ select:is(:hover, :focus) { --chevron: var(--text); }
 .dlg-foot { display: flex; justify-content: flex-end; gap: 8px; padding: 12px 18px; border-top: 1px solid var(--border); background: var(--surface-2); border-radius: 0 0 var(--radius) var(--radius); }
 
 /* Menu, tooltips, toasts */
-.menu { position: fixed; z-index: 40; min-width: 230px; max-width: min(380px, calc(100vw - 16px)); padding: 4px; background: var(--surface); border: 1px solid var(--border); border-radius: calc(var(--ctl-radius) + 2px); box-shadow: var(--float-shadow); }
+.menu { position: fixed; z-index: 40; min-width: 230px; max-width: min(380px, calc(100vw - 16px)); padding: 4px; background: var(--surface); border: 1px solid var(--border); border-radius: calc(var(--ctl-radius) + 2px); box-shadow: var(--float-shadow); overflow-y: auto; overscroll-behavior: contain; }
 .menu-item { display: flex; align-items: center; gap: 10px; width: 100%; height: 32px; padding: 0 10px; border: 0; border-radius: calc(var(--ctl-radius) - 2px); background: none; color: var(--text); font: inherit; font-size: var(--control-size); text-align: left; cursor: pointer; }
 .menu-item .ic { flex: none; color: var(--muted); }
 .menu-item:hover:not(:disabled), .menu-item:focus-visible { background: var(--hover); outline: none; }
@@ -604,6 +636,24 @@ select:is(:hover, :focus) { --chevron: var(--text); }
 .set-hint { color: var(--faint); font-size: 12px; max-width: 260px; }
 .set-link { margin: 0 -8px; width: calc(100% + 16px); }
 .set-link .chip { margin-left: auto; }
+/* Groups in the settings (spec §3.29): a small muted title, then its rows; a line between groups. */
+.pop-settings { width: 340px; }
+.set-group { display: flex; flex-direction: column; gap: 8px; }
+.set-check .set-label { white-space: normal; }
+.set-link .menu-label { flex: 1 1 auto; min-width: 0; white-space: normal; line-height: 1.3; }
+.set-link { height: auto; min-height: 32px; padding-top: 6px; padding-bottom: 6px; }
+.set-link .chip { flex: none; }
+.set-group-title { color: var(--faint); font-size: 11px; font-weight: var(--strong-weight); letter-spacing: .02em; }
+.popover .set-sep { margin: 0 -14px; }
+.set-hint .link-btn { font-size: 12px; }
+/* "More settings…" stays at the bottom of a popover that scrolls. */
+.set-more { position: sticky; bottom: -12px; margin: 0 -14px -12px; width: calc(100% + 28px); height: 40px; padding: 0 16px 0 17px; border-top: 1px solid var(--border); border-radius: 0; background: var(--surface); }
+.set-more:hover { background: var(--hover); }
+.set-more .ic { margin-left: auto; }
+.set-dialog { display: flex; flex-direction: column; gap: 12px; }
+.set-dialog .set-hint { max-width: none; }
+.set-dialog .set-link { margin: 0 -10px; width: calc(100% + 20px); }
+.as-code { display: block; margin: -4px 0 4px; padding: 8px 10px; border-radius: var(--ctl-radius); background: var(--hover); font-family: var(--mono); font-size: 12px; overflow-wrap: anywhere; }
 .set-dot { background: var(--warn-bar); }
 .tip { display: inline-flex; position: relative; vertical-align: middle; }
 .tip-btn { display: inline-grid; place-items: center; width: 16px; height: 16px; padding: 0; border: 1px solid var(--border-strong); border-radius: 50%; background: var(--surface); color: var(--muted); font: 700 10px/1 var(--font); cursor: help; }

package/dist/src/panel/page.d.ts

@@ -21,6 +21,11 @@ export interface PageOptions {
     lang?: 'auto' | 'en' | 'zh';
     /** createPanelHandler's `updates`: false hides everything about sideby updates. */
     updates?: boolean;
+    /** Config `panel` (spec §3.29): the theme and language saved for the Panel. */
+    panel?: {
+        theme?: string;
+        language?: string;
+    };
 }
 /** JSON that is safe inside a `<script>` element: no `</script>`, `<!--` or line separators survive. */
 export declare function jsonForScript(value: unknown): string;

package/dist/src/panel/page.js

@@ -42,6 +42,7 @@ export function renderPage(opts) {
         updates: opts.updates !== false,
         colorScheme: theme.colorScheme,
         lang,
+        panel: opts.panel ?? {},
         warn: QUOTA_WARN_PERCENT,
         fail: QUOTA_FAIL_PERCENT,
         usageDays: USAGE_DAYS,
@@ -74,6 +75,7 @@ export function renderPage(opts) {
     </div>
     <div class="top-actions">
       <button id="update" class="btn update-btn" type="button" hidden></button>
+      <button id="ask-ai" class="btn" type="button" aria-haspopup="dialog" aria-label="Let AI do it"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M6 9h12a2 2 0 0 1 2 2v6a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-6a2 2 0 0 1 2-2zM12 5v4M9.5 13.5v1M14.5 13.5v1"/></svg><span class="hide-sm" data-i18n="ask.button">Let AI do it</span></button>
       <button id="settings" class="btn" type="button" aria-haspopup="dialog" aria-expanded="false"${lang === 'auto' ? '' : ' hidden'}><span data-i18n="set.button">Settings</span></button>
       <button id="refresh" class="btn" type="button" aria-label="Refresh"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M20 11a8 8 0 1 0-2.3 5.7"/><path d="M20 4v7h-7"/></svg><span class="hide-sm" data-i18n="top.refresh">Refresh</span></button>
     </div>

package/dist/src/panel/server.d.ts

@@ -1,5 +1,12 @@
 import type { Runtime } from '../runtime.ts';
 export declare const DEFAULT_PANEL_PORT = 17420;
+/**
+ * Whose Panel this is: a hash of the system user and HOME, so `sideby ui` reuses only its own user's Panel. Another
+ * user of the same Mac may run one on the same port; reusing it would show that user's accounts and start none of
+ * ours. A hash, so the health answer names no path. It only tells Panels apart; it is not authentication. The real
+ * path, so one HOME reached through a symlink gives one owner.
+ */
+export declare function panelOwner(home?: string): string;
 export interface PanelServerOptions {
     runtimeFactory: () => Promise<Runtime>;
     port?: number;
@@ -11,6 +18,8 @@ export interface PanelServerOptions {
      * --stop` can tell this Panel from a reused pid or from another Panel before it sends a signal.
      */
     instance?: string;
+    /** panelOwner() of the HOME this Panel serves; defaults to this process's HOME. */
+    owner?: string;
 }
 export interface PanelServer {
     url: string;
@@ -22,11 +31,16 @@ export interface PanelIdentity {
     pid?: number;
     /** buildId() of the code serving it; absent from Panels older than this field. */
     build?: string;
+    /** panelOwner() of the user it serves; absent from Panels older than this field. */
+    owner?: string;
 }
 /** What the sideby Panel on this port says about itself, or undefined when none answers. */
 export declare function panelIdentity(port: number): Promise<PanelIdentity | undefined>;
-/** True when a sideby Panel answers on this port. */
-export declare function isSidebyPanel(port: number): Promise<boolean>;
+/**
+ * True when a sideby Panel of this user answers on this port. One that names another owner belongs to another user
+ * and counts as a busy port; one too old to name an owner is taken as ours, as before.
+ */
+export declare function isSidebyPanel(port: number, owner?: string): Promise<boolean>;
 /** Opens `url` in the default browser; returns false (and never throws) when that is not possible. */
 export declare function openBrowser(url: string): Promise<boolean>;
 export declare function startPanelServer(opts: PanelServerOptions): Promise<PanelServer>;

package/dist/src/panel/server.js

@@ -1,11 +1,34 @@
 // Standalone Panel server for `sideby ui`: loopback only, reuses a running Panel, shifts past busy ports.
 import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
 import { createServer } from 'node:http';
-import { buildId } from '../core/version.js';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { buildId, packageVersion } from '../core/version.js';
 import { createPanelHandler } from './handler.js';
 export const DEFAULT_PANEL_PORT = 17420;
 const PORT_ATTEMPTS = 20;
 const LOOPBACK = '127.0.0.1';
+/**
+ * Whose Panel this is: a hash of the system user and HOME, so `sideby ui` reuses only its own user's Panel. Another
+ * user of the same Mac may run one on the same port; reusing it would show that user's accounts and start none of
+ * ours. A hash, so the health answer names no path. It only tells Panels apart; it is not authentication. The real
+ * path, so one HOME reached through a symlink gives one owner.
+ */
+export function panelOwner(home = process.env.HOME || homedir()) {
+    let dir = resolve(home);
+    try {
+        dir = realpathSync(dir);
+    }
+    catch {
+        // keep the resolved path when HOME does not exist
+    }
+    return createHash('sha256')
+        .update(`sideby-panel\0${process.getuid?.() ?? ''}\0${dir}`)
+        .digest('hex')
+        .slice(0, 16);
+}
 function listen(server, port) {
     return new Promise((resolve, reject) => {
         const onError = (err) => {
@@ -37,15 +60,20 @@ export async function panelIdentity(port) {
             ...(typeof body.instance === 'string' ? { instance: body.instance } : {}),
             ...(Number.isInteger(body.pid) ? { pid: body.pid } : {}),
             ...(typeof body.build === 'string' ? { build: body.build } : {}),
+            ...(typeof body.owner === 'string' ? { owner: body.owner } : {}),
         };
     }
     catch {
         return undefined;
     }
 }
-/** True when a sideby Panel answers on this port. */
-export async function isSidebyPanel(port) {
-    return (await panelIdentity(port)) !== undefined;
+/**
+ * True when a sideby Panel of this user answers on this port. One that names another owner belongs to another user
+ * and counts as a busy port; one too old to name an owner is taken as ours, as before.
+ */
+export async function isSidebyPanel(port, owner = panelOwner()) {
+    const id = await panelIdentity(port);
+    return id !== undefined && (id.owner === undefined || id.owner === owner);
 }
 /** Opens `url` in the default browser; returns false (and never throws) when that is not possible. */
 export function openBrowser(url) {
@@ -69,6 +97,9 @@ export function openBrowser(url) {
 export async function startPanelServer(opts) {
     const log = opts.log ?? ((s) => console.log(s));
     const first = opts.port ?? DEFAULT_PANEL_PORT;
+    const owner = opts.owner ?? panelOwner();
+    // /api/health always names app and version (ADR-0006), also when the caller did not pass one.
+    const version = opts.version ?? packageVersion();
     const announce = async (url, reused) => {
         log(reused ? `sideby panel is already running at ${url}` : `sideby panel: ${url}`);
         if (opts.open && !(await openBrowser(url)))
@@ -79,20 +110,17 @@ export async function startPanelServer(opts) {
         const handler = createPanelHandler({
             runtime: opts.runtimeFactory,
             allowedHosts: hosts,
-            ...(opts.version ? { version: opts.version } : {}),
+            version,
         });
         const server = createServer((req, res) => {
-            if (opts.instance &&
-                req.method === 'GET' &&
-                req.url === '/api/health' &&
-                hosts.includes(req.headers.host ?? '')) {
+            if (req.method === 'GET' && req.url === '/api/health' && hosts.includes(req.headers.host ?? '')) {
                 res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
                 res.end(JSON.stringify({
                     app: 'sideby',
-                    ...(opts.version ? { version: opts.version } : {}),
+                    version,
                     build: buildId(),
-                    instance: opts.instance,
-                    pid: process.pid,
+                    owner,
+                    ...(opts.instance ? { instance: opts.instance, pid: process.pid } : {}),
                 }));
                 return;
             }
@@ -124,7 +152,7 @@ export async function startPanelServer(opts) {
                 }),
             };
         }
-        if (await isSidebyPanel(port)) {
+        if (await isSidebyPanel(port, owner)) {
             await announce(url, true);
             return { url, reused: true, close: async () => { } };
         }

package/dist/src/plugins/check.d.ts

@@ -0,0 +1,47 @@
+import type { Plugin } from '../types.ts';
+export interface PluginProblem {
+    /** Stable machine code such as `shared-item.parent`. */
+    code: string;
+    message: string;
+    /** One sentence saying what to change. */
+    fix: string;
+}
+export interface PluginCheckResult {
+    ok: boolean;
+    /** The plugin's name, when its manifest or export could be read. */
+    plugin?: string;
+    /** Family ids the plugin registered. */
+    families: string[];
+    problems: PluginProblem[];
+}
+/**
+ * Checks the Family Plugin in `dir` (the folder holding `plugin.json`): manifest, trust (owner, modes), that it
+ * only `import type`s from sideby, and a leak scan for home paths, personal emails and token-shaped strings. When the
+ * loader would trust it, also its FamilyDef fields and a discover / launch / doctor round, run by {@link checkRound} in
+ * a child process with a throwaway HOME, killed after `timeoutMs` (20 s). An untrusted plugin is never copied,
+ * changed or run. Never throws for a broken plugin: every problem is in `problems`, each with a `fix`.
+ */
+export declare function checkPlugin(opts: {
+    dir: string;
+    timeoutMs?: number;
+}): Promise<PluginCheckResult>;
+/**
+ * The child side of {@link runRound}: reads the job, runs {@link checkRound} and writes its report to fd 3, then
+ * exits so a timer or handle the plugin left open cannot keep it alive.
+ */
+export declare function checkRoundMain(arg: string | undefined): Promise<void>;
+/**
+ * `checkPlugin` for a Plugin that ships inside sideby: `dir` is its source folder, scanned for leaks. The same field
+ * checks and discover / launch / doctor round run; it loads as the only built-in.
+ */
+export declare function checkBuiltinPlugin(opts: {
+    plugin: Plugin;
+    dir: string;
+}): Promise<PluginCheckResult>;
+/** What is missing or wrong in one FamilyDef, as written by the Plugin. */
+export declare function defProblems(raw: unknown): PluginProblem[];
+/**
+ * The plugin's sources against the rules that need no loading: value imports from sideby, TODOs left from the
+ * skeleton, and the leak scan. Messages give the file and line only, never the matched value.
+ */
+export declare function scanSources(dir: string): Promise<PluginProblem[]>;