genaicode 2.7.0 → 2.9.0

package/dist/ui/web-client.js.LEGAL.txt

@@ -0,0 +1,56 @@
+Bundled license information:
+
+react/cjs/react.production.js:
+  /**
+   * @license React
+   * react.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+scheduler/cjs/scheduler.production.js:
+  /**
+   * @license React
+   * scheduler.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react-dom/cjs/react-dom.production.js:
+  /**
+   * @license React
+   * react-dom.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react-dom/cjs/react-dom-client.production.js:
+  /**
+   * @license React
+   * react-dom-client.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react/cjs/react-jsx-runtime.production.js:
+  /**
+   * @license React
+   * react-jsx-runtime.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */

package/dist/vite/overlay.d.ts

@@ -0,0 +1,19 @@
+/** What the plugin tells the overlay. */
+export interface OverlayConfig {
+    /** Path of the plugin's endpoints on the dev server, e.g. `/__genaicode`. */
+    api: string;
+    /** Collect errors from the page and offer to send them to the agent. */
+    captureErrors: boolean;
+}
+/** The part of Vite's `import.meta.hot` the overlay listens to. */
+export interface OverlayHot {
+    on(event: string, callback: (payload: unknown) => void): void;
+}
+/**
+ * The dev-server overlay: a wolf in the corner of the app that opens the genaicode UI in a
+ * panel, and collects the page's errors so one click sends them to the agent.
+ *
+ * The plugin serves this function's source (`mountOverlay.toString()`) as a module, so it must
+ * not use anything from outside its own body.
+ */
+export declare function mountOverlay(config: OverlayConfig, hot: OverlayHot | undefined): void;

package/dist/vite/overlay.js

@@ -0,0 +1,180 @@
+/**
+ * The dev-server overlay: a wolf in the corner of the app that opens the genaicode UI in a
+ * panel, and collects the page's errors so one click sends them to the agent.
+ *
+ * The plugin serves this function's source (`mountOverlay.toString()`) as a module, so it must
+ * not use anything from outside its own body.
+ */
+export function mountOverlay(config, hot) {
+    if (document.querySelector('genaicode-overlay'))
+        return;
+    const MAX_ERRORS = 20;
+    const MAX_TEXT = 4000;
+    let errors = [];
+    let session;
+    const host = document.createElement('genaicode-overlay');
+    host.style.cssText = 'position:fixed;z-index:2147483647;right:0;bottom:0;';
+    const root = host.attachShadow({ mode: 'open' });
+    root.innerHTML = `<style>
+:host { all: initial; }
+* { box-sizing: border-box; font: 13px/1.4 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; }
+.wolf { position: fixed; right: 18px; bottom: 18px; width: 52px; height: 52px; border-radius: 50%; border: 1px solid #e4e4df;
+  background: #fff center / 34px no-repeat; box-shadow: 0 2px 10px rgba(0,0,0,.18); cursor: pointer; padding: 0; font-size: 26px; }
+.wolf:hover { transform: scale(1.06); }
+.badge { position: absolute; top: -4px; right: -4px; min-width: 20px; height: 20px; padding: 0 5px; border-radius: 10px;
+  background: #c92a2a; color: #fff; font-size: 11px; font-weight: 700; line-height: 20px; text-align: center; }
+.badge[hidden], .panel[hidden], .fix[hidden] { display: none; }
+.panel { position: fixed; right: 18px; bottom: 82px; width: min(460px, calc(100vw - 36px)); height: min(680px, calc(100vh - 110px));
+  display: flex; flex-direction: column; background: #fff; border: 1px solid #e4e4df; border-radius: 14px; overflow: hidden;
+  box-shadow: 0 8px 40px rgba(0,0,0,.22); }
+.head { display: flex; align-items: center; gap: 8px; padding: 8px 10px; border-bottom: 1px solid #e4e4df; background: #f7f7f5; color: #1d1d1b; }
+.head b { flex: 1; }
+.head button { border: 1px solid #e4e4df; background: #fff; color: #1d1d1b; border-radius: 8px; padding: 4px 10px; cursor: pointer; }
+.head .fix { background: #c92a2a; border-color: #c92a2a; color: #fff; font-weight: 600; }
+iframe { flex: 1; width: 100%; border: 0; background: #f7f7f5; }
+.note { padding: 16px; color: #6b6b66; }
+@media (prefers-color-scheme: dark) {
+  .wolf, .panel { background-color: #1d1d1c; border-color: #2e2e2c; }
+  .head { background: #141414; border-color: #2e2e2c; color: #ececea; }
+  .head button { background: #1d1d1c; border-color: #2e2e2c; color: #ececea; }
+  iframe { background: #141414; }
+}
+</style>
+<div class="panel" hidden>
+  <div class="head"><b>genaicode</b><button class="fix" hidden></button><button class="close" title="Hide">✕</button></div>
+</div>
+<button class="wolf" title="genaicode"><span class="badge" hidden></span></button>`;
+    const $ = (selector) => root.querySelector(selector);
+    const wolf = $('.wolf');
+    const badge = $('.badge');
+    const panel = $('.panel');
+    const fix = $('.fix');
+    let frame;
+    const render = () => {
+        badge.hidden = errors.length === 0;
+        badge.textContent = String(errors.length);
+        fix.hidden = errors.length === 0;
+        fix.textContent = `Fix ${errors.length} error${errors.length === 1 ? '' : 's'}`;
+        const label = errors.length
+            ? `genaicode: ${errors.length} error${errors.length === 1 ? '' : 's'} on this page`
+            : `genaicode${session ? ` (${session.agent})` : ''}`;
+        wolf.title = label;
+        wolf.setAttribute('aria-label', label);
+    };
+    const loadSession = async () => {
+        if (session)
+            return session;
+        const response = await fetch(`${config.api}/session`, { credentials: 'same-origin' });
+        if (!response.ok)
+            throw new Error(`genaicode: ${response.status}`);
+        session = (await response.json());
+        wolf.style.backgroundImage = `url(${new URL('/assets/wolf-64.png', session.url).href})`;
+        render();
+        return session;
+    };
+    // One frame, even when the wolf and "Fix" are clicked before the session has loaded.
+    const open = () => {
+        panel.hidden = false;
+        frame ??= loadSession().then(({ url }) => {
+            const iframe = document.createElement('iframe');
+            iframe.src = url;
+            iframe.title = 'genaicode';
+            panel.append(iframe);
+        }, (error) => {
+            const note = document.createElement('div');
+            note.className = 'note';
+            note.textContent = `The genaicode UI is not available: ${error.message}. See the dev server's terminal.`;
+            panel.append(note);
+        });
+        return frame;
+    };
+    wolf.addEventListener('click', () => (panel.hidden ? void open() : (panel.hidden = true)));
+    $('.close').addEventListener('click', () => (panel.hidden = true));
+    fix.addEventListener('click', async () => {
+        const sent = errors;
+        errors = [];
+        render();
+        await open();
+        const response = await fetch(`${config.api}/fix`, {
+            method: 'POST',
+            credentials: 'same-origin',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ page: location.origin + location.pathname, errors: sent }),
+        }).catch(() => undefined);
+        if (!response?.ok) {
+            errors = [...sent, ...errors].slice(-MAX_ERRORS);
+            render();
+        }
+    });
+    const text = (value) => {
+        if (value instanceof Error)
+            return value.message;
+        if (typeof value === 'string')
+            return value;
+        try {
+            return JSON.stringify(value) ?? String(value);
+        }
+        catch {
+            try {
+                return String(value);
+            }
+            catch {
+                return Object.prototype.toString.call(value);
+            }
+        }
+    };
+    const add = (error) => {
+        error.message = error.message.slice(0, MAX_TEXT);
+        if (error.stack)
+            error.stack = error.stack.slice(0, MAX_TEXT);
+        if (errors.some((seen) => seen.message === error.message && seen.source === error.source))
+            return;
+        errors = [...errors, error].slice(-MAX_ERRORS);
+        render();
+    };
+    if (config.captureErrors) {
+        window.addEventListener('error', (event) => {
+            const where = event.filename ? ` (${event.filename}:${event.lineno}:${event.colno})` : '';
+            add({ source: 'error', message: `${event.message}${where}`, stack: event.error?.stack });
+        });
+        window.addEventListener('unhandledrejection', (event) => {
+            add({ source: 'rejection', message: text(event.reason), stack: event.reason?.stack });
+        });
+        const consoleError = console.error.bind(console);
+        console.error = (...args) => {
+            consoleError(...args);
+            // Collecting the error must never break the app's own logging.
+            try {
+                add({
+                    source: 'console',
+                    message: args.map(text).join(' '),
+                    stack: args.find((arg) => arg instanceof Error)?.stack,
+                });
+            }
+            catch {
+                // Ignore values that cannot be described.
+            }
+        };
+        hot?.on('vite:error', (payload) => {
+            const err = payload.err;
+            if (!err)
+                return;
+            const file = err.id ? `\n${err.id}` : '';
+            add({ source: 'vite', message: `${err.message ?? 'Vite error'}${file}${err.frame ? `\n${err.frame}` : ''}` });
+        });
+        // A successful update means the build errors are gone; keep what the running page reported.
+        hot?.on('vite:afterUpdate', () => {
+            const before = errors.length;
+            errors = errors.filter((error) => error.source !== 'vite');
+            if (errors.length !== before)
+                render();
+        });
+    }
+    document.body.append(host);
+    render();
+    void loadSession().catch(() => {
+        wolf.textContent = '🐺';
+        wolf.append(badge);
+    });
+}
+//# sourceMappingURL=overlay.js.map

package/dist/vite/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../src/vite/overlay.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,GAA2B;IAC7E,IAAI,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC;QAAE,OAAO;IAOxD,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;IACtB,IAAI,MAAM,GAAgB,EAAE,CAAC;IAC7B,IAAI,OAAmD,CAAC;IAExD,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,qDAAqD,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFA4BgE,CAAC;IAClF,MAAM,CAAC,GAAG,CAAoB,QAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAM,CAAC;IACrF,MAAM,IAAI,GAAG,CAAC,CAAoB,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,CAAc,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,CAAc,QAAQ,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,CAAC,CAAoB,MAAM,CAAC,CAAC;IACzC,IAAI,KAAgC,CAAC;IAErC,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,WAAW,GAAG,OAAO,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM;YACzB,CAAC,CAAC,cAAc,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,eAAe;YACnF,CAAC,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;QAC7B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,IAAI,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;QACxF,MAAM,EAAE,CAAC;QACT,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,qFAAqF;IACrF,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,KAAK,KAAK,WAAW,EAAE,CAAC,IAAI,CAC1B,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;YACV,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;YACjB,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG,sCAAuC,KAAe,CAAC,OAAO,kCAAkC,CAAC;YACpH,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CACF,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAoB,QAAQ,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACtF,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC;QACpB,MAAM,GAAG,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC;QACT,MAAM,IAAI,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClF,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;YAClB,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;YACjD,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE;QACtC,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAgB,EAAE,EAAE;QAC/B,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO;QAClG,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,EAAE,KAAK,EAAG,KAAK,CAAC,KAA2B,EAAE,KAAK,EAAE,CAAC,CAAC;QAClH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;YACtD,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAG,KAAK,CAAC,MAA4B,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/G,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACrC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;YACtB,+DAA+D;YAC/D,IAAI,CAAC;gBACH,GAAG,CAAC;oBACF,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;oBACjC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAgB,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,EAAE,KAAK;iBACrE,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC,CAAC;QACF,GAAG,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;YAChC,MAAM,GAAG,GAAI,OAAuF,CAAC,GAAG,CAAC;YACzG,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,IAAI,YAAY,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAChH,CAAC,CAAC,CAAC;QACH,4FAA4F;QAC5F,GAAG,EAAE,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;gBAAE,MAAM,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC;IACT,KAAK,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/vite/plugin.d.ts

@@ -0,0 +1,57 @@
+import type { Plugin } from 'vite';
+import type { CodingAgent } from '../agents/types.js';
+export interface GenaicodeViteOptions {
+    /** Agent to start with. Default: the first installed one. */
+    agent?: string;
+    model?: string;
+    effort?: string;
+    /** Approve every permission request without asking. */
+    approveAll?: boolean;
+    /** Agents to offer. Default: the same headless drivers as `genaicode ui`. */
+    agents?: readonly CodingAgent[];
+    /** Collect the page's errors and offer to send them to the agent. Default true. */
+    captureErrors?: boolean;
+    /** Port of the genaicode UI on 127.0.0.1. Default: a free port. */
+    port?: number;
+    /** Loads the bundled front ends. Defaults to `dist/ui/index.js`; tests pass the sources. */
+    loadUi?(): Promise<EmbeddedUiModule>;
+}
+/** What the plugin needs from the bundled front ends (see `startEmbeddedWeb` in src/ui/index.tsx). */
+export interface EmbeddedUiModule {
+    NoAgentError: new (...args: never[]) => Error;
+    startEmbeddedWeb(options: {
+        agents: readonly CodingAgent[];
+        agent?: string;
+        cwd: string;
+        model?: string;
+        effort?: string;
+        approveAll?: boolean;
+        version: string;
+        port?: number;
+        frameAncestors: () => readonly string[];
+    }): Promise<{
+        url: string;
+        controller: {
+            submit(text: string): unknown;
+            get(): {
+                session: {
+                    agent: string;
+                };
+            };
+        };
+        close(): Promise<void>;
+    }>;
+}
+/**
+ * `genaicode/vite`: the genaicode UI inside a Vite dev server. The page gets a wolf in the
+ * corner that opens the chat with a coding agent working in the project, and its errors
+ * (build errors, uncaught exceptions, console.error) go to the agent with one click.
+ *
+ * Only `vite dev`: builds are untouched. The UI runs on its own port on 127.0.0.1, so a dev
+ * server started with `--host` does not expose the agent to the network.
+ */
+export declare function genaicode(options?: GenaicodeViteOptions): Plugin;
+/** The prompt for "Fix N errors", or undefined when the body is not a list of errors. */
+export declare function fixPrompt(body: unknown): string | undefined;
+/** 127.0.0.0/8 and ::1, also as IPv4-mapped IPv6 addresses. */
+export declare function isLoopback(address: string | undefined): boolean;

package/dist/vite/plugin.js

@@ -0,0 +1,214 @@
+import { createRequire } from 'node:module';
+import { defaultAgents } from '../agents/defaults.js';
+import { mountOverlay } from './overlay.js';
+const API = '/__genaicode';
+const OVERLAY_ID = 'virtual:genaicode-overlay';
+const MAX_BODY = 256 * 1024;
+/**
+ * `genaicode/vite`: the genaicode UI inside a Vite dev server. The page gets a wolf in the
+ * corner that opens the chat with a coding agent working in the project, and its errors
+ * (build errors, uncaught exceptions, console.error) go to the agent with one click.
+ *
+ * Only `vite dev`: builds are untouched. The UI runs on its own port on 127.0.0.1, so a dev
+ * server started with `--host` does not expose the agent to the network.
+ */
+export function genaicode(options = {}) {
+    let started;
+    let base = '/';
+    // Origins the app's pages were actually opened at (e.g. app.localhost), for frame-ancestors.
+    const seen = new Set();
+    return {
+        name: 'genaicode',
+        apply: 'serve',
+        configResolved(config) {
+            base = config.base;
+        },
+        configureServer(server) {
+            const log = server.config.logger;
+            started = (async () => {
+                const ui = await (options.loadUi ?? loadBundledUi)();
+                try {
+                    return await ui.startEmbeddedWeb({
+                        agents: options.agents ?? defaultAgents(),
+                        agent: options.agent,
+                        cwd: server.config.root,
+                        model: options.model,
+                        effort: options.effort,
+                        approveAll: options.approveAll,
+                        version: packageVersion(),
+                        port: options.port,
+                        frameAncestors: () => pageOrigins(server, seen),
+                    });
+                }
+                catch (error) {
+                    if (!(error instanceof ui.NoAgentError))
+                        throw error;
+                    log.warn(`[genaicode] ${error.message} The overlay is off.`);
+                    return undefined;
+                }
+            })().then((ui) => {
+                if (ui)
+                    log.info(`  ➜  genaicode: ${ui.controller.get().session.agent} in the page, or open ${ui.url}`);
+                return ui;
+            }, (error) => {
+                log.error(`[genaicode] The UI did not start: ${error.message}`);
+                return undefined;
+            });
+            server.middlewares.use(API, (req, res, next) => {
+                handleApi(req, res, started, (origin) => seen.add(origin), !!server.config.server.https).catch(next);
+            });
+        },
+        resolveId(id) {
+            if (id === OVERLAY_ID)
+                return `\0${OVERLAY_ID}`;
+        },
+        load(id) {
+            if (id !== `\0${OVERLAY_ID}`)
+                return;
+            const config = { api: API, captureErrors: options.captureErrors ?? true };
+            return `(${mountOverlay.toString()})(${JSON.stringify(config)}, import.meta.hot);\n`;
+        },
+        async transformIndexHtml() {
+            if (!(await started))
+                return;
+            return [
+                {
+                    tag: 'script',
+                    attrs: { type: 'module', src: `${base}@id/__x00__${OVERLAY_ID}` },
+                    // First, so the app's own startup errors are caught too. Module scripts are deferred.
+                    injectTo: 'head-prepend',
+                },
+            ];
+        },
+        // Vite calls this when the dev server closes or restarts.
+        async buildEnd() {
+            const ui = await started;
+            started = undefined;
+            await ui?.close();
+        },
+    };
+}
+/** The dev server's own endpoints for the overlay: the UI link, and "fix these errors". */
+async function handleApi(req, res, started, onPage, https) {
+    const send = (status, body) => {
+        res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store' });
+        res.end(JSON.stringify(body));
+    };
+    // Only this machine: with --host the dev server also answers the network, and Sec-Fetch-Site
+    // is just a header a client there could send. Then only the app's own pages: another site
+    // open in the browser must not read the UI's token or start the agent.
+    if (!isLoopback(req.socket.remoteAddress))
+        return send(403, { error: 'this machine only' });
+    if (req.headers['sec-fetch-site'] !== 'same-origin')
+        return send(403, { error: 'same-origin only' });
+    const ui = await started;
+    if (!ui)
+        return send(503, { error: 'genaicode is off; see the dev server terminal' });
+    const path = (req.url ?? '/').split('?')[0];
+    if (req.method === 'GET' && path === '/session') {
+        const origin = pageOrigin(req.headers.host, https);
+        if (origin)
+            onPage(origin);
+        return send(200, { url: ui.url, agent: ui.controller.get().session.agent });
+    }
+    if (req.method === 'POST' && path === '/fix') {
+        if (!String(req.headers['content-type'] ?? '').startsWith('application/json')) {
+            return send(415, { error: 'expected JSON' });
+        }
+        let prompt;
+        try {
+            prompt = fixPrompt(JSON.parse(await readBody(req)));
+        }
+        catch {
+            prompt = undefined;
+        }
+        if (!prompt)
+            return send(400, { error: 'bad request' });
+        ui.controller.submit(prompt);
+        return send(200, { ok: true });
+    }
+    send(404, { error: 'not found' });
+}
+const SOURCES = {
+    vite: 'build error',
+    error: 'uncaught error',
+    rejection: 'unhandled rejection',
+    console: 'console.error',
+};
+/** The prompt for "Fix N errors", or undefined when the body is not a list of errors. */
+export function fixPrompt(body) {
+    if (!body || typeof body !== 'object')
+        return undefined;
+    const { page, errors } = body;
+    if (!Array.isArray(errors) || errors.length === 0)
+        return undefined;
+    const items = [];
+    for (const error of errors.slice(0, 20)) {
+        if (!error || typeof error !== 'object')
+            return undefined;
+        const { source, message, stack } = error;
+        if (typeof message !== 'string' || typeof source !== 'string' || !Object.hasOwn(SOURCES, source))
+            return undefined;
+        const trace = typeof stack === 'string' && stack && !message.includes(stack) ? `\n${stack.slice(0, 4000)}` : '';
+        items.push(`${items.length + 1}. [${SOURCES[source]}] ${message.slice(0, 4000)}${trace}`);
+    }
+    const where = typeof page === 'string' && /^https?:\/\//.test(page) ? ` at ${page.slice(0, 500)}` : '';
+    return (`The app running in the Vite dev server${where} reports ${items.length === 1 ? 'this error' : 'these errors'} ` +
+        `in the browser. Find the cause in the code and fix it.\n\n` +
+        '```\n' +
+        items.join('\n\n').replace(/```/g, "'''") +
+        '\n```');
+}
+/** 127.0.0.0/8 and ::1, also as IPv4-mapped IPv6 addresses. */
+export function isLoopback(address) {
+    if (!address)
+        return false;
+    const v4 = address.startsWith('::ffff:') ? address.slice(7) : address;
+    return address === '::1' || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(v4);
+}
+/** The origin a same-origin request came from, by its Host header. */
+function pageOrigin(host, https) {
+    if (!host || !/^[\w.-]+(:\d+)?$|^\[[\da-f:.]+\](:\d+)?$/i.test(host))
+        return undefined;
+    return `${https ? 'https' : 'http'}://${host.toLowerCase()}`;
+}
+/** Where the app's pages come from, allowed to show the UI in a frame. */
+function pageOrigins(server, seen) {
+    const urls = [...(server.resolvedUrls?.local ?? []), ...(server.resolvedUrls?.network ?? [])];
+    const origins = new Set(seen);
+    for (const url of urls) {
+        try {
+            origins.add(new URL(url).origin);
+        }
+        catch {
+            // Not a URL: skip it.
+        }
+    }
+    if (origins.size === 0) {
+        // Middleware mode, or not listening yet: any local port.
+        for (const origin of ['http://localhost:*', 'http://127.0.0.1:*', 'http://[::1]:*'])
+            origins.add(origin);
+    }
+    return [...origins];
+}
+async function readBody(req) {
+    let size = 0;
+    const chunks = [];
+    for await (const chunk of req) {
+        size += chunk.length;
+        if (size > MAX_BODY)
+            throw new Error('Request too large');
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** The front ends are bundled into dist/ui by scripts/build-ui.mjs; the path is kept opaque to tsc. */
+function loadBundledUi() {
+    const bundle = new URL('../ui/index.js', import.meta.url).href;
+    return import(bundle);
+}
+function packageVersion() {
+    const require = createRequire(import.meta.url);
+    return require('../../package.json').version;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/vite/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/vite/plugin.ts"],"names":[],"mappings":"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"}

package/dist/vite.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `genaicode/vite`: chat with a coding agent from inside the app in `vite dev`.
+ *
+ * ```ts
+ * import { defineConfig } from 'vite';
+ * import genaicode from 'genaicode/vite';
+ *
+ * export default defineConfig({ plugins: [genaicode()] });
+ * ```
+ */
+export { genaicode, genaicode as default, type GenaicodeViteOptions } from './vite/plugin.js';

package/dist/vite.js

@@ -0,0 +1,12 @@
+/**
+ * `genaicode/vite`: chat with a coding agent from inside the app in `vite dev`.
+ *
+ * ```ts
+ * import { defineConfig } from 'vite';
+ * import genaicode from 'genaicode/vite';
+ *
+ * export default defineConfig({ plugins: [genaicode()] });
+ * ```
+ */
+export { genaicode, genaicode as default } from './vite/plugin.js';
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,SAAS,IAAI,OAAO,EAA6B,MAAM,kBAAkB,CAAC"}

package/docs/agents.md

@@ -74,6 +74,46 @@ failure of its own. A zero exit alone is not treated as success.
 
 Vendor events that have no mapping are dropped.
 
+## Follow-up turns
+
+`result.sessionId` names the agent's own session. Pass it as `resume` to continue that
+session with a new prompt; the agent keeps the earlier turns as context:
+
+```ts
+const agent = claude();
+const first = await agent.run({ prompt: 'Add a --dry-run flag', cwd }).result;
+const next = await agent.run({ prompt: 'Now cover it with a test', cwd, resume: first.sessionId }).result;
+```
+
+`claude`, `codex`, `cursor`, `opencode` and `copilot` support it (`capabilities.resume`).
+Other drivers fail the task before spawning anything rather than starting a fresh session.
+
+## Chat sessions
+
+`createAgentSession` keeps a conversation with one agent for chat front ends; the
+`genaicode chat` and `genaicode ui` commands are built on it:
+
+```ts
+import { claude, createAgentSession } from 'genaicode/agents';
+
+const session = createAgentSession({ agent: claude(), cwd: '/work/repo' });
+session.subscribe((state) => render(state)); // a new immutable snapshot on every change
+session.send('Add a --dry-run flag');
+await session.idle();
+session.send('Now cover it with a test'); // resumes the same agent session
+```
+
+- `state.turns[]` holds each prompt with its transcript: `text` (streamed, then final),
+  `tool` (input, clipped output, error flag), `files`, `approval`, `input` (steered text)
+  and `error` entries, plus the turn's `AgentResult`. Usage and cost add up in `state`.
+- `send()` while a turn runs steers the agent when it supports `steer()`, and otherwise
+  queues the prompt; queued prompts run in order. `stop()` aborts the turn and clears the
+  queue.
+- Approval requests wait in `state.approvals` until `approve(id, decision)`, unless
+  `autoApprove` decides them. `stop()` denies whatever is pending.
+- `setAgent()` switches agents between turns and starts a fresh agent session; `reset()`
+  does the same for the current agent.
+
 ## Drivers
 
 | Driver                | Command        | Mode                                     | Notes                                                                                  |

package/docs/pivot.md

@@ -44,9 +44,12 @@ The following 1.x capabilities are intentionally removed:
 The 2.x `genaicode/agents` subpath does not restore these. It drives _external_
 coding-agent CLIs behind one task/event interface, the same way providers wrap model APIs,
 and it adds no agent loop, prompts, or repository tools of its own. See [agents.md](./agents.md).
-The `genaicode` bin (`npx genaicode run`) is a thin command-line front end to those drivers,
-under the same rule: it parses flags, prints events, and adds nothing the library does not
-already do.
+The `genaicode` bin (`npx genaicode run`, `chat`, `ui`) is a thin front end to those drivers,
+under the same rule: it parses flags, shows events, and adds nothing the library does not
+already do. Its terminal and browser chat are bundled (Ink, React) into `dist/ui` and load
+only for those commands, so the library keeps no UI dependencies. `genaicode/vite` brings
+back a Vite dev plugin in the same shape: it shows that browser chat inside the app and
+hands the page's errors to the external agent as a prompt; it does not generate code itself.
 
 This is a major-version break. The old implementation remains available in git history
 and in the 1.x npm line.