@sudodevstudio/astro-ai 0.1.0

package/dist/toolbar/app.js

@@ -0,0 +1,274 @@
+import { defineToolbarApp } from 'astro/toolbar';
+import { CLIENT_EVENTS, PROTOCOL_VERSION, SERVER_EVENTS, } from '../shared/protocol.js';
+import { createChatDrawerStyle } from './chat-drawer.js';
+import { ChatWindowManager } from './chat-windows.js';
+import { DiagnosticActionBridge } from './diagnostic-actions.js';
+import { SelectionOverlay } from './overlay.js';
+const APP_OPEN_KEY = 'astro-ai:app-open';
+export default defineToolbarApp({
+    init(canvas, app, server) {
+        let disposed = false;
+        let restoringOpenState = readSession(APP_OPEN_KEY) === 'true';
+        const pendingInspectRequests = new Map();
+        let insertionZonesRequestId;
+        let overlay;
+        const windows = new ChatWindowManager({
+            onSubmit({ requestId, sessionId, instruction, mode, attachments, locked, files, externalContext }) {
+                server.send(CLIENT_EVENTS.agentInstruction, {
+                    requestId,
+                    sessionId,
+                    instruction,
+                    mode,
+                    ...(attachments === undefined
+                        ? {}
+                        : {
+                            attachments: attachments.map(({ nodeId, route }) => ({ nodeId, route })),
+                        }),
+                    ...(locked === true ? { locked: true } : {}),
+                    ...(files === undefined ? {} : { files }),
+                    ...(externalContext === undefined ? {} : { externalContext }),
+                });
+                windows.noticeFor(sessionId, 'AI agent operation started…');
+            },
+            onCancel(requestId) {
+                server.send(CLIENT_EVENTS.agentCancel, { requestId });
+            },
+            onUndo() {
+                windows.broadcastNotice('Undoing the last source transaction…');
+                server.send(CLIENT_EVENTS.undo, { requestId: createRequestId() });
+            },
+            onRedo() {
+                windows.broadcastNotice('Redoing the source transaction…');
+                server.send(CLIENT_EVENTS.redo, { requestId: createRequestId() });
+            },
+            onSessionClose(sessionId) {
+                server.send(CLIENT_EVENTS.sessionClose, { sessionId });
+            },
+            onEmpty() {
+                app.toggleState({ state: false });
+            },
+            onSelectionPaused(paused) {
+                if (paused) {
+                    overlay.disable();
+                    windows.broadcastNotice('Selection mode paused while every chat is minimized.');
+                }
+                else {
+                    overlay.enable();
+                    overlay.start();
+                    windows.broadcastNotice('Click to select · Shift-click to add · drag to marquee');
+                    requestInsertionZones();
+                }
+            },
+        });
+        overlay = new SelectionOverlay({
+            onInspect(nodeId) {
+                const requestId = createRequestId();
+                pendingInspectRequests.set(requestId, nodeId);
+                windows.broadcastNotice('Resolving source capabilities…');
+                server.send(CLIENT_EVENTS.inspect, {
+                    requestId,
+                    nodeId,
+                    route: window.location.pathname,
+                });
+            },
+            onActiveChange() { },
+            onCommand(command) {
+                execute(command);
+            },
+            onAskAI(contexts, elements) {
+                windows.openWithSelections(contexts, elements);
+            },
+            onClear() {
+                windows.broadcastNotice('Click to select · Shift-click to add · drag to marquee');
+            },
+            onSelectionChange(contexts, elements) {
+                windows.setCurrentSelections(contexts, elements);
+                if (contexts.length > 1) {
+                    windows.broadcastNotice(`${contexts.length} source-backed elements selected.`);
+                }
+            },
+            onSelectionAnchorChange(rect) {
+                windows.setSelectionAnchor(rect);
+            },
+        });
+        const diagnosticActions = new DiagnosticActionBridge({
+            onFix(context) {
+                overlay.clearSelection();
+                app.toggleState({ state: true });
+                window.setTimeout(() => windows.openWithExternalContext(context), 0);
+            },
+        });
+        const drawerStyle = createChatDrawerStyle();
+        canvas.replaceChildren(drawerStyle, windows.element);
+        windows.hideAll(false);
+        /**
+         * Astro's app canvas rewrites its own shadow root in `connectedCallback`,
+         * and a client-side navigation re-appends the toolbar to the swapped body,
+         * which reconnects the canvas and throws away everything rendered into it.
+         * The chat windows survive as objects, so they only need remounting.
+         */
+        function ensureMounted() {
+            if (windows.element.parentNode === canvas)
+                return;
+            canvas.append(drawerStyle, windows.element);
+        }
+        app.onToggled(({ state }) => {
+            writeSession(APP_OPEN_KEY, String(state));
+            if (state) {
+                ensureMounted();
+                overlay.enable();
+                overlay.start();
+                // Astro re-applies app status when the toolbar reconnects after a
+                // navigation. That is a re-assert, not the user opening the app, so it
+                // must not steal focus or expand a window they deliberately collapsed.
+                const opening = !restoringOpenState && !windows.visible;
+                windows.openAll(opening, true, opening);
+                windows.broadcastNotice('Click to select · Shift-click to add · drag to marquee');
+                requestInsertionZones();
+            }
+            else {
+                overlay.disable();
+                windows.hideAll();
+            }
+            restoringOpenState = false;
+        });
+        server.on(SERVER_EVENTS.ready, ({ protocolVersion, history, agent }) => {
+            if (disposed || protocolVersion !== PROTOCOL_VERSION)
+                return;
+            windows.setProvider(agent);
+            windows.setHistory(history);
+            requestInsertionZones();
+            if (agent.provider !== 'none' && !agent.authenticated) {
+                windows.broadcastNotice(agent.message, true);
+            }
+        });
+        server.on(SERVER_EVENTS.selection, ({ requestId, context }) => {
+            if (disposed || !pendingInspectRequests.delete(requestId))
+                return;
+            overlay.setSelection(context);
+            windows.broadcastNotice('Source-backed selection resolved locally.');
+        });
+        server.on(SERVER_EVENTS.insertionZones, ({ requestId, zones }) => {
+            if (disposed || requestId !== insertionZonesRequestId)
+                return;
+            insertionZonesRequestId = undefined;
+            overlay.setInsertionZones(zones);
+        });
+        server.on(SERVER_EVENTS.operation, ({ transaction, history }) => {
+            if (disposed)
+                return;
+            windows.setHistory(history);
+            windows.broadcastNotice(`${humanize(transaction.kind)} applied; Vite HMR is updating the page.`);
+            requestInsertionZones();
+            if (transaction.kind === 'reorder-sibling')
+                overlay.clearSelection();
+        });
+        server.on(SERVER_EVENTS.history, (history) => {
+            if (!disposed)
+                windows.setHistory(history);
+        });
+        server.on(SERVER_EVENTS.error, ({ requestId, message, fallbackEligible }) => {
+            if (disposed)
+                return;
+            if (requestId !== undefined) {
+                const nodeId = pendingInspectRequests.get(requestId);
+                pendingInspectRequests.delete(requestId);
+                if (nodeId !== undefined)
+                    overlay.rejectSelection(nodeId);
+            }
+            windows.broadcastNotice(fallbackEligible ? `${message} Ask AI or open the source to continue.` : message, true);
+        });
+        server.on(SERVER_EVENTS.agentEvent, (event) => {
+            if (disposed)
+                return;
+            // Progress belongs to the window that started the run; a sibling window
+            // must not report a run it never made.
+            const drawer = windows.handleAgentEvent(event);
+            drawer?.setNotice(event.state === 'completion'
+                ? event.transaction === undefined
+                    ? 'AI response completed without changing source.'
+                    : 'AI changes applied. Undo is available.'
+                : event.state === 'failure'
+                    ? 'The AI run failed. Review the message for details.'
+                    : `AI agent · ${humanize(event.state)}…`, event.state === 'failure');
+        });
+        server.send(CLIENT_EVENTS.ready, {
+            protocolVersion: PROTOCOL_VERSION,
+            route: window.location.pathname,
+            pendingAgentRequestIds: windows.pendingRequestIds(),
+            activeSessionIds: windows.sessionIds(),
+        });
+        if (readSession(APP_OPEN_KEY) === 'true') {
+            window.setTimeout(() => app.toggleState({ state: true }), 0);
+        }
+        // A client-side navigation swaps the document body and moves the toolbar
+        // into it. Every selection and node id then refers to a page that is gone,
+        // and the view transition can leave the chat windows hidden behind its
+        // snapshot, so the editor re-establishes itself against the new page.
+        const onNavigation = () => {
+            if (disposed)
+                return;
+            ensureMounted();
+            overlay.clearSelection();
+            windows.handleNavigation();
+            if (windows.visible || readSession(APP_OPEN_KEY) === 'true') {
+                overlay.enable();
+                overlay.start();
+                windows.openAll(false, true, false);
+            }
+            requestInsertionZones();
+        };
+        document.addEventListener('astro:after-swap', onNavigation);
+        document.addEventListener('astro:page-load', onNavigation);
+        window.addEventListener('popstate', onNavigation);
+        const cleanup = () => {
+            if (disposed)
+                return;
+            disposed = true;
+            document.removeEventListener('astro:after-swap', onNavigation);
+            document.removeEventListener('astro:page-load', onNavigation);
+            window.removeEventListener('popstate', onNavigation);
+            overlay.destroy();
+            diagnosticActions.destroy();
+            windows.destroy();
+        };
+        import.meta.hot?.dispose(cleanup);
+        function execute(command) {
+            windows.broadcastNotice('Applying a deterministic source transformation…');
+            server.send(CLIENT_EVENTS.execute, {
+                requestId: createRequestId(),
+                command,
+            });
+        }
+        function requestInsertionZones() {
+            insertionZonesRequestId = createRequestId();
+            server.send(CLIENT_EVENTS.insertionZones, {
+                requestId: insertionZonesRequestId,
+                route: window.location.pathname,
+            });
+        }
+    },
+});
+function createRequestId() {
+    return crypto.randomUUID();
+}
+function humanize(kind) {
+    return kind.replaceAll('-', ' ');
+}
+function readSession(key) {
+    try {
+        return sessionStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+}
+function writeSession(key, value) {
+    try {
+        sessionStorage.setItem(key, value);
+    }
+    catch {
+        // The editor remains usable if session storage is restricted.
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/toolbar/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/toolbar/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,GASd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,eAAe,gBAAgB,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM;QACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,kBAAkB,GAAG,WAAW,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;QAC9D,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzD,IAAI,uBAA2C,CAAC;QAChD,IAAI,OAAyB,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC;YACpC,QAAQ,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC/F,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE;oBAC1C,SAAS;oBACT,SAAS;oBACT,WAAW;oBACX,IAAI;oBACJ,GAAG,CAAC,WAAW,KAAK,SAAS;wBAC3B,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;yBACzE,CAAC;oBACN,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;oBACzC,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;iBAC9D,CAAC,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;YAC9D,CAAC;YACD,QAAQ,CAAC,SAAS;gBAChB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,MAAM;gBACJ,OAAO,CAAC,eAAe,CAAC,sCAAsC,CAAC,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,MAAM;gBACJ,OAAO,CAAC,eAAe,CAAC,iCAAiC,CAAC,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,cAAc,CAAC,SAAS;gBACtB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO;gBACL,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACpC,CAAC;YACD,iBAAiB,CAAC,MAAM;gBACtB,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,CAAC,OAAO,EAAE,CAAC;oBAClB,OAAO,CAAC,eAAe,CAAC,sDAAsD,CAAC,CAAC;gBAClF,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,EAAE,CAAC;oBACjB,OAAO,CAAC,KAAK,EAAE,CAAC;oBAChB,OAAO,CAAC,eAAe,CAAC,wDAAwD,CAAC,CAAC;oBAClF,qBAAqB,EAAE,CAAC;gBAC1B,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAC7B,SAAS,CAAC,MAAM;gBACd,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;gBACpC,sBAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9C,OAAO,CAAC,eAAe,CAAC,gCAAgC,CAAC,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;oBACjC,SAAS;oBACT,MAAM;oBACN,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;iBAChC,CAAC,CAAC;YACL,CAAC;YACD,cAAc,KAAI,CAAC;YACnB,SAAS,CAAC,OAAO;gBACf,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YACD,OAAO,CAAC,QAAQ,EAAE,QAAQ;gBACxB,OAAO,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;YACD,OAAO;gBACL,OAAO,CAAC,eAAe,CAAC,wDAAwD,CAAC,CAAC;YACpF,CAAC;YACD,iBAAiB,CAAC,QAAQ,EAAE,QAAQ;gBAClC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACjD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,mCAAmC,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;YACD,uBAAuB,CAAC,IAAI;gBAC1B,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;QACH,MAAM,iBAAiB,GAAG,IAAI,sBAAsB,CAAC;YACnD,KAAK,CAAC,OAAO;gBACX,OAAO,CAAC,cAAc,EAAE,CAAC;gBACzB,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACvE,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEvB;;;;;WAKG;QACH,SAAS,aAAa;YACpB,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,MAAM;gBAAE,OAAO;YAClD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;YAC1B,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,EAAE,CAAC;gBAChB,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,kEAAkE;gBAClE,uEAAuE;gBACvE,uEAAuE;gBACvE,MAAM,OAAO,GAAG,CAAC,kBAAkB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBACxD,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBACxC,OAAO,CAAC,eAAe,CAAC,wDAAwD,CAAC,CAAC;gBAClF,qBAAqB,EAAE,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;YACD,kBAAkB,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAqB,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;YACzF,IAAI,QAAQ,IAAI,eAAe,KAAK,gBAAgB;gBAAE,OAAO;YAC7D,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,qBAAqB,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;gBACtD,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAA2B,aAAa,CAAC,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YACtF,IAAI,QAAQ,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC;gBAAE,OAAO;YAClE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,eAAe,CAAC,2CAA2C,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAgC,aAAa,CAAC,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;YAC9F,IAAI,QAAQ,IAAI,SAAS,KAAK,uBAAuB;gBAAE,OAAO;YAC9D,uBAAuB,GAAG,SAAS,CAAC;YACpC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAA4B,aAAa,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;YACzF,IAAI,QAAQ;gBAAE,OAAO;YACrB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACjG,qBAAqB,EAAE,CAAC;YACxB,IAAI,WAAW,CAAC,IAAI,KAAK,iBAAiB;gBAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAwB,aAAa,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YAClE,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAA2B,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE;YACpG,IAAI,QAAQ;gBAAE,OAAO;YACrB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACrD,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACzC,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,CAAC,eAAe,CACrB,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,yCAAyC,CAAC,CAAC,CAAC,OAAO,EAChF,IAAI,CACL,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAsB,aAAa,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACjE,IAAI,QAAQ;gBAAE,OAAO;YACrB,wEAAwE;YACxE,uCAAuC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,EAAE,SAAS,CACf,KAAK,CAAC,KAAK,KAAK,YAAY;gBAC1B,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;oBAC/B,CAAC,CAAC,gDAAgD;oBAClD,CAAC,CAAC,wCAAwC;gBAC5C,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;oBACzB,CAAC,CAAC,oDAAoD;oBACtD,CAAC,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAC5C,KAAK,CAAC,KAAK,KAAK,SAAS,CAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAqB,aAAa,CAAC,KAAK,EAAE;YACnD,eAAe,EAAE,gBAAgB;YACjC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAC/B,sBAAsB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YACnD,gBAAgB,EAAE,OAAO,CAAC,UAAU,EAAE;SACvC,CAAC,CAAC;QAEH,IAAI,WAAW,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,sEAAsE;QACtE,MAAM,YAAY,GAAG,GAAS,EAAE;YAC9B,IAAI,QAAQ;gBAAE,OAAO;YACrB,aAAa,EAAE,CAAC;YAChB,OAAO,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC5D,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACtC,CAAC;YACD,qBAAqB,EAAE,CAAC;QAC1B,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC5D,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QAC3D,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;YAC/D,QAAQ,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YAC9D,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACrD,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,iBAAiB,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAElC,SAAS,OAAO,CAAC,OAAmC;YAClD,OAAO,CAAC,eAAe,CAAC,iDAAiD,CAAC,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;gBACjC,SAAS,EAAE,eAAe,EAAE;gBAC5B,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAED,SAAS,qBAAqB;YAC5B,uBAAuB,GAAG,eAAe,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE;gBACxC,SAAS,EAAE,uBAAuB;gBAClC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,eAAe;IACtB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,KAAa;IAC9C,IAAI,CAAC;QACH,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/toolbar/chat-drawer.d.ts

@@ -0,0 +1,111 @@
+import type { AgentExternalContext, AgentFileAttachment, AgentOperationEvent, AgentRequestMode, ServerReadyMessage } from '../shared/protocol.js';
+import type { SelectionContext } from '../shared/selection-context.js';
+import { type SelectionAttachment } from './action-model.js';
+export type AgentSubmit = {
+    requestId: string;
+    sessionId: string;
+    instruction: string;
+    mode: AgentRequestMode;
+    attachments?: SelectionAttachment[];
+    locked?: boolean;
+    files?: AgentFileAttachment[];
+    externalContext?: AgentExternalContext;
+};
+export type ChatDrawerCallbacks = {
+    onSubmit(request: AgentSubmit): void;
+    onCancel(requestId: string): void;
+    onUndo(): void;
+    onRedo(): void;
+    /** Closes this chat window only. */
+    onClose(): void;
+    onNewWindow?(): void;
+    onRename?(title: string): void;
+    onFocus?(): void;
+    onMinimizedChange?(minimized: boolean): void;
+};
+export type ChatDrawerOptions = {
+    sessionId: string;
+    title: string;
+    /** Cascade offset applied when this window has no saved position. */
+    index?: number;
+};
+type SelectionAnchor = Pick<DOMRect, 'left' | 'right' | 'top' | 'bottom' | 'width' | 'height'>;
+type ChatWindowPosition = {
+    left: number;
+    top: number;
+};
+type ChatWindowSize = {
+    width: number;
+    height: number;
+};
+type ReadableFile = Pick<File, 'name' | 'size' | 'type' | 'text'> & {
+    arrayBuffer?(): Promise<ArrayBuffer>;
+};
+export declare class ChatDrawer {
+    #private;
+    readonly element: HTMLElement;
+    readonly sessionId: string;
+    constructor(callbacks: ChatDrawerCallbacks, options: ChatDrawerOptions);
+    get title(): string;
+    get minimized(): boolean;
+    rename(title: string): void;
+    /** Raises this window above its siblings. */
+    setFocused(focused: boolean, zIndex?: number): void;
+    /** Drops every persisted key for this window so a closed chat leaves nothing behind. */
+    clearStoredState(): void;
+    setProvider(provider: ServerReadyMessage['agent']): void;
+    pendingRequestIds(): string[];
+    attachFiles(files: ReadonlyArray<ReadableFile>): Promise<void>;
+    setCurrentSelections(contexts: SelectionContext[], elements?: readonly HTMLElement[]): void;
+    setSelectionAnchor(rect?: SelectionAnchor): void;
+    setHistory(history: ServerReadyMessage['history']): void;
+    setNotice(message: string, error?: boolean): void;
+    openWithSelections(contexts: SelectionContext[], elements?: readonly HTMLElement[]): void;
+    openWithExternalContext(context: AgentExternalContext): void;
+    /**
+     * Handles a client-side navigation. The page's DOM was replaced, so every
+     * node id this window held now points at an element that no longer exists,
+     * and the view transition can leave the window itself stale or hidden.
+     */
+    handleNavigation(): void;
+    open(focus?: boolean, persist?: boolean, expand?: boolean): void;
+    hide(persist?: boolean): void;
+    toggleCollapsed(): void;
+    handleAgentEvent(event: AgentOperationEvent): void;
+    destroy(): void;
+    /** Re-measures the connector after the page geometry may have changed. */
+    refreshConnector(): void;
+}
+export declare function isSendShortcut(event: Pick<KeyboardEvent, 'key' | 'shiftKey' | 'isComposing'>): boolean;
+export declare function chatWindowCollapseControl(minimized: boolean): {
+    symbol: '✦' | '−';
+    label: 'Expand chat window' | 'Collapse chat window';
+    expanded: boolean;
+};
+export declare function constrainChatWindowPosition(position: ChatWindowPosition, size: ChatWindowSize, viewport: ChatWindowSize, margin?: number): ChatWindowPosition;
+export declare function createChatDrawerStyle(): HTMLStyleElement;
+export type AgentMarkdownBlock = {
+    kind: 'paragraph';
+    text: string;
+} | {
+    kind: 'code';
+    text: string;
+    language?: string;
+} | {
+    kind: 'list';
+    items: string[];
+};
+/** Small, injection-safe markdown subset for CLI explanations. */
+export declare function parseAgentMarkdown(source: string): AgentMarkdownBlock[];
+/**
+ * Never throws. This decides the margin used to pull a window back on screen,
+ * and an exception there would leave the window stranded out of view, so a
+ * host without matchMedia falls back to the desktop margin.
+ */
+/** True when any part of the box is inside the viewport. */
+export declare function intersectsViewport(rect: Pick<DOMRect, 'left' | 'right' | 'top' | 'bottom'>, viewport?: {
+    width: number;
+    height: number;
+}): boolean;
+export {};
+//# sourceMappingURL=chat-drawer.d.ts.map

package/dist/toolbar/chat-drawer.d.ts.map

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