@artooi/ag-ui-web-component 0.33.1 → 0.35.0

package/dist/tools/chat_surface_tools.d.ts

@@ -0,0 +1,96 @@
+import type { ClientTool } from "./client_tool_registry.js";
+/** Every corner the panel can be sent to, in the order the schema states them. */
+export declare const CHAT_CORNERS: readonly ["top-left", "top-right", "bottom-left", "bottom-right"];
+/** A corner the panel can be sent to. */
+export type ChatCorner = (typeof CHAT_CORNERS)[number];
+/** What the agent is told about the surface it is speaking from. */
+export interface ChatSurfaceReport {
+    /** The placement in force, or `null` when the host set none. */
+    readonly placement: string | null;
+    /** Whether the panel is currently at its launcher. */
+    readonly collapsed: boolean;
+    /** Whether this placement has a collapsed state at all. */
+    readonly collapsible: boolean;
+    /** Whether the panel can be moved, or the placement owns its position. */
+    readonly movable: boolean;
+    /**
+     * Whether this page allows the panel to be moved at all.
+     *
+     * Reported apart from {@link ChatSurfaceReport.movable} only because the two
+     * reasons a move is refused call for different sentences: a host that turned
+     * dragging off is not the placement owning the position, and telling the
+     * user the second when the first is true is a plain falsehood.
+     */
+    readonly draggable: boolean;
+    /** Whether the panel currently covers the whole viewport. */
+    readonly fullBleed: boolean;
+    /** The panel's box, in viewport coordinates. */
+    readonly box: {
+        readonly left: number;
+        readonly top: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * The part of the viewport the panel may rest in.
+     *
+     * With an origin, because it is not always the screen's: a host can reserve
+     * the edges its own chrome occupies, and an agent reasoning about the room
+     * to the left of `box.left` would otherwise be mixing two coordinate frames
+     * without being told there were two.
+     */
+    readonly viewport: {
+        readonly left: number;
+        readonly top: number;
+        readonly width: number;
+        readonly height: number;
+    };
+}
+/** Whether a string names one of the four corners. */
+export declare function isChatCorner(value: string): value is ChatCorner;
+/**
+ * The part of the widget these tools drive.
+ *
+ * A narrow port rather than the element itself, because the element imports
+ * this module to build its own tools and importing it back would be a cycle.
+ * It also says exactly what the agent is allowed to reach, which is a shorter
+ * list than the element's public surface.
+ */
+export interface ChatSurface {
+    describeSurface(): ChatSurfaceReport;
+    /**
+     * `announce` writes a notice into the transcript with an undo beside it.
+     * The tools always pass it: a panel that rearranges itself mid-conversation
+     * has to say so, and a host driving the same method is arranging its own
+     * page and needs no telling.
+     */
+    moveTo(corner: ChatCorner, options?: {
+        readonly announce?: boolean;
+    }): boolean;
+    setCollapsed(collapsed: boolean, options?: {
+        readonly announce?: boolean;
+    }): void;
+}
+/**
+ * Tools that let the agent move the panel it is speaking from.
+ *
+ * This is the affordance nobody else can offer: every other assistant's chat
+ * is a surface of its own, so there is nothing for it to be in the way *of*.
+ * Ours is mounted in the page the user is working in, which is what makes
+ * "let me move this aside so you can see the table" a sentence the agent can
+ * act on rather than apologise for.
+ *
+ * **They report what happened, not what was asked.** A full-bleed panel on a
+ * phone has nowhere to move to, and a placement that places itself owns its
+ * position -- so `move_chat` answers `moved: false` with the reason and what
+ * would work instead, rather than returning success on a panel that did not
+ * budge. The same rule the page actions already follow: a tool reports that it
+ * fired, not that it worked.
+ *
+ * `read_chat_surface` exists so the agent can ask before it acts rather than
+ * discovering the answer through a failure. It is deliberately a tool and not
+ * ambient context: a snapshot the agent chose to take is honest about being
+ * one, and it needs no channel that does not already exist.
+ */
+export declare function createChatSurfaceTools(surface: ChatSurface): ClientTool[];
+//# sourceMappingURL=chat_surface_tools.d.ts.map

package/dist/tools/chat_surface_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat_surface_tools.d.ts","sourceRoot":"","sources":["../../src/tools/chat_surface_tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,kFAAkF;AAClF,eAAO,MAAM,YAAY,YAAI,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,CAAU,CAAC;AAE9F,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe,IAAI,iBAAiB,CAAC;IACrC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IAC/E,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACnF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,CA2GzE"}

package/dist/tools/page_action_tools.d.ts

@@ -9,6 +9,8 @@ export type ResolvePageTarget = (target: string) => HTMLElement | null;
 export declare const PAGE_ACTIONS: {
     readonly SCROLL: "scroll";
     readonly DRAG: "drag";
+    /** The widget's own position: see `createChatSurfaceTools`. */
+    readonly CHAT: "chat";
 };
 /**
  * The opt-in page-action tools selected by `enabled` (a set of

package/dist/tools/page_action_tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page_action_tools.d.ts","sourceRoot":"","sources":["../../src/tools/page_action_tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,YAAY;aACvB,MAAM,EAAE,QAAQ;aAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,aAAa,EAAE,iBAAiB,GAC/B,UAAU,EAAE,CASd"}
+{"version":3,"file":"page_action_tools.d.ts","sourceRoot":"","sources":["../../src/tools/page_action_tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,YAAY;aACvB,MAAM,EAAE,QAAQ;aAChB,IAAI,EAAE,MAAM;IACZ,+DAA+D;aAC/D,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,aAAa,EAAE,iBAAiB,GAC/B,UAAU,EAAE,CASd"}

package/dist/ui/chart_block.d.ts

@@ -11,6 +11,20 @@
  * Hand-rolled rather than a charting library, and the difference is not
  * marginal: the whole renderer costs single-digit kilobytes where a library
  * costs roughly half this bundle again, in a component distributed over a CDN.
+ *
+ * **The drawing is sized in CSS pixels, not scaled to them.** An SVG with a
+ * fixed viewBox and `width: 100%` is a picture the browser magnifies: widen the
+ * panel and every stroke, every label and the whole frame grow with it. So the
+ * geometry is computed for the width the block actually has, one user unit to
+ * one CSS pixel, and recomputed when that width changes -- a 10px label is
+ * 10px at every size the block is given.
+ *
+ * How wide the block is allowed to get is the stylesheet's question, not this
+ * module's, and the answer there is that a chart stops at its own width rather
+ * than stretching with the panel, the way a message does. The two halves are
+ * separate on purpose: this one keeps a chart from being magnified, that one
+ * keeps it from being stretched, and a host that raises the cap gets a bigger
+ * chart with the same 10px labels rather than a magnified one.
  */
 /** One named series of numbers. */
 export interface ChartSeries {
@@ -34,6 +48,10 @@ export declare function seriesColor(index: number): string;
  * A spec with no labels or no series is not drawn: an empty frame reads as
  * "there is no data" when the truth is "the caller sent nothing", and the two
  * deserve different answers.
+ *
+ * The block returned is already drawn at {@link DEFAULT_WIDTH} and redraws
+ * itself once it is in a document and knows how wide it really is, so a caller
+ * appends it exactly as before and never has to say how big it should be.
  */
 export declare function renderChart(spec: ChartSpec): HTMLDivElement | null;
 //# sourceMappingURL=chart_block.d.ts.map

package/dist/ui/chart_block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart_block.d.ts","sourceRoot":"","sources":["../../src/ui/chart_block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAoBD,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AA6OD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAoDlE"}
+{"version":3,"file":"chart_block.d.ts","sourceRoot":"","sources":["../../src/ui/chart_block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAgED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAkWD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAsClE"}

package/dist/ui/clamp_launcher.d.ts

@@ -1,14 +1,19 @@
-import type { Extent, LauncherBox } from "./launcher_placement.js";
+import type { LauncherBox, ViewportBox } from "./launcher_placement.js";
 /**
- * Keep a launcher fully on screen.
+ * Keep a launcher fully on screen, and a little clear of the edge.
  *
  * Applied to a dragged position and again to a restored one, because the
  * viewport that stored it may since have shrunk. A launcher parked past the
  * edge is unreachable, and it is the only way back to a collapsed
- * conversation -- so this clamps to the viewport itself rather than to the
- * panel's margin, which would refuse the corners users actually want.
+ * conversation.
+ *
+ * Not the panel's 24px gutter, which was rejected here on purpose: a launcher
+ * held that far in refuses the corners people actually drag it to. But not
+ * zero either -- the bubble is a circle with a drop shadow, and one flush
+ * against the boundary has its shadow cut and its curve running into the edge,
+ * which reads as clipped whether or not a pixel is actually missing.
  */
-export declare function clampLauncher(launcher: LauncherBox, viewport: Extent): {
+export declare function clampLauncher(launcher: LauncherBox, viewport: ViewportBox, margin?: number): {
     readonly left: number;
     readonly top: number;
 };

package/dist/ui/clamp_launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clamp_launcher.d.ts","sourceRoot":"","sources":["../../src/ui/clamp_launcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKjD"}
+{"version":3,"file":"clamp_launcher.d.ts","sourceRoot":"","sources":["../../src/ui/clamp_launcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,EACrB,MAAM,GAAE,MAA2B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgBjD"}

package/dist/ui/clamp_panel.d.ts

@@ -0,0 +1,13 @@
+import type { ViewportBox } from "./launcher_placement.js";
+import type { PanelRect } from "./resize_handle.js";
+/**
+ * Hold a panel inside the viewport, keeping its size.
+ *
+ * The near edge is clamped and the far edge follows, so a panel too large for
+ * the viewport is held against the near margin and left to the max-width and
+ * max-height rules rather than centred by force. The lower bound wins a
+ * contradiction for the same reason: `Math.min` first would put an oversized
+ * panel off the left edge instead of against the margin it can still honour.
+ */
+export declare function clampPanel(host: PanelRect, viewport: ViewportBox, margin?: number): PanelRect;
+//# sourceMappingURL=clamp_panel.d.ts.map

package/dist/ui/clamp_panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp_panel.d.ts","sourceRoot":"","sources":["../../src/ui/clamp_panel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,WAAW,EACrB,MAAM,GAAE,MAAoB,GAC3B,SAAS,CAYX"}

package/dist/ui/launcher_drag.d.ts

@@ -1,4 +1,4 @@
-import type { Extent, LauncherBox } from "./launcher_placement.js";
+import type { LauncherBox, ViewportBox } from "./launcher_placement.js";
 /** What the drag needs from its host to do its job. */
 export interface LauncherDragOptions {
     /**
@@ -10,7 +10,7 @@ export interface LauncherDragOptions {
     /** The launcher's current box, in viewport coordinates. */
     readonly rect: () => LauncherBox;
     /** The viewport the launcher has to stay inside. */
-    readonly viewport: () => Extent;
+    readonly viewport: () => ViewportBox;
     /** Put the launcher's top-left at this point. Called per pointer move. */
     readonly apply: (left: number, top: number) => void;
     /**

package/dist/ui/launcher_drag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launcher_drag.d.ts","sourceRoot":"","sources":["../../src/ui/launcher_drag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEnE,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CA8H5F"}
+{"version":3,"file":"launcher_drag.d.ts","sourceRoot":"","sources":["../../src/ui/launcher_drag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAuI5F"}

package/dist/ui/launcher_placement.d.ts

@@ -5,6 +5,19 @@ export interface LauncherBox {
     readonly width: number;
     readonly height: number;
 }
+/**
+ * The part of the screen a widget may rest in: a width and height, and the
+ * corner they start from.
+ *
+ * The origin is not always zero. A host can reserve the edges its own chrome
+ * occupies, and a panel clamped against a viewport that starts at the top-left
+ * of the screen will happily park itself underneath a sticky header -- where it
+ * cannot be reached, and where collapsing it only hides it further.
+ */
+export interface ViewportBox extends Extent {
+    readonly left: number;
+    readonly top: number;
+}
 /** A width/height pair, in CSS pixels. */
 export interface Extent {
     readonly width: number;
@@ -60,5 +73,5 @@ export interface LauncherPlacement {
  * later panel resize from dragging the launcher: the pinned corner is the one
  * edge a resize cannot move.
  */
-export declare function launcherPlacement(launcher: LauncherBox, panel: Extent, viewport: Extent, margin?: number): LauncherPlacement;
+export declare function launcherPlacement(launcher: LauncherBox, panel: Extent, viewport: ViewportBox, screen: Extent, margin?: number): LauncherPlacement;
 //# sourceMappingURL=launcher_placement.d.ts.map

package/dist/ui/launcher_placement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launcher_placement.d.ts","sourceRoot":"","sources":["../../src/ui/launcher_placement.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC9B;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAoB,GAC3B,iBAAiB,CA2CnB"}
+{"version":3,"file":"launcher_placement.d.ts","sourceRoot":"","sources":["../../src/ui/launcher_placement.ts"],"names":[],"mappings":"AAIA,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC9B;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAA2B,GAClC,iBAAiB,CA0CnB"}

package/dist/ui/panel_drag.d.ts

@@ -0,0 +1,40 @@
+import type { PanelRect } from "./resize_handle.js";
+/** What the drag needs from its host to do its job. */
+export interface PanelDragOptions {
+    /**
+     * Whether the panel can be moved right now, read per interaction because
+     * both halves of the answer are live: a docked or full-bleed placement has
+     * nowhere to move the panel to, and a collapsed one has no panel on screen.
+     */
+    readonly enabled: () => boolean;
+    /** The panel's current box, in viewport coordinates. */
+    readonly rect: () => PanelRect;
+    /**
+     * Put the panel at this box. Called per pointer move, with the box the press
+     * started on -- the whole gesture is one translation of that box, and a host
+     * with anything else to move alongside the panel needs the same distance
+     * rather than a distance measured from wherever the last move left things.
+     */
+    readonly apply: (box: PanelRect, from: PanelRect) => void;
+    /** Called once per completed move, for persistence. Never per pointer move. */
+    readonly commit: (box: PanelRect, from: PanelRect) => void;
+}
+/**
+ * Let the user move the whole widget by dragging the panel's header.
+ *
+ * The launcher can already be dragged, and this is the same gesture on the
+ * half of the widget that is on screen when it is open -- a chat panel is a
+ * window, and a window moves by its title bar. The two stay one position
+ * rather than two: the host answers a moved panel by moving the launcher with
+ * it, so collapsing after a drag leaves the launcher where the panel was.
+ *
+ * **No keyboard path here, deliberately.** Every other drag in this component
+ * has arrow keys on the handle, because the handle is a control and the
+ * capability is reachable nowhere else. A header is not a control: making it
+ * focusable would put a tab stop with no role in front of every keyboard user,
+ * ahead of the controls they actually came for. The capability is not lost --
+ * arrow keys on the collapsed launcher move the widget, and the panel follows
+ * it -- so what is missing is a shortcut, not the ability.
+ */
+export declare function enablePanelDrag(handle: HTMLElement, options: PanelDragOptions): void;
+//# sourceMappingURL=panel_drag.d.ts.map

package/dist/ui/panel_drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel_drag.d.ts","sourceRoot":"","sources":["../../src/ui/panel_drag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC5D;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkEpF"}

package/dist/ui/place_widget.d.ts

@@ -0,0 +1,31 @@
+import type { ExpandCorner, Extent, LauncherBox } from "./launcher_placement.js";
+import type { PanelRect } from "./resize_handle.js";
+/** Where to put the host box, and where the launcher sits inside it. */
+export interface WidgetInsets {
+    /** An `inset` shorthand for the host box. */
+    readonly hostInset: string;
+    /** An `inset` shorthand for the launcher, relative to the host box. */
+    readonly launcherInset: string;
+}
+/**
+ * Express a panel and its launcher, both already positioned, as the two
+ * `inset` shorthands the element writes.
+ *
+ * Both are measured from the **same** corner, which is what stops a later
+ * resize from dragging the launcher: the pinned corner is the one edge a
+ * resize cannot move. Which corner that is says nothing about where either box
+ * ends up -- the positions are absolute and arrive decided -- so re-picking it
+ * moves nothing, and the launcher may sit outside its own host box. Nothing
+ * clips it there, and that is what lets a launcher be flush to a screen corner
+ * while the panel it opens keeps its margin.
+ *
+ * `screen` is the **whole** viewport, not the part a host has left free. These
+ * are CSS `inset` values on a fixed element, and the browser measures those
+ * from the real edges -- so a `bottom` expressed against a box inset from the
+ * top comes out short by exactly that inset. It only shows when the corner
+ * flips mid-drag, because that is when the same point stops being expressed
+ * from `top` and starts being expressed from `bottom`: the widget then leaps by
+ * the reserved edge, which is a jump the gesture cannot explain.
+ */
+export declare function placeWidget(host: PanelRect, launcher: LauncherBox, corner: ExpandCorner, screen: Extent): WidgetInsets;
+//# sourceMappingURL=place_widget.d.ts.map

package/dist/ui/place_widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_widget.d.ts","sourceRoot":"","sources":["../../src/ui/place_widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,YAAY,CAed"}

package/dist/ui/run_notice.d.ts

@@ -3,8 +3,19 @@
  * skill loaded), rendered inline between turns.
  *
  * Distinct from a tool card, which reports work the agent asked for and
- * settles, and from an error, which is a failure. A notice never settles, takes
- * no action, and carries no controls.
+ * settles, and from an error, which is a failure. A notice never settles and
+ * takes no action of its own.
+ *
+ * It may carry exactly one control, and only ever an undo. That is a narrower
+ * rule than "no controls", which is what this said until the agent could move
+ * the panel it speaks from: something that rearranges the user's window without
+ * being asked has to be both visible and reversible, and a notice is already
+ * the surface that says what the run did. Anything the user has to *decide* is
+ * a confirmation card instead -- the difference is that this reports something
+ * already done.
  */
-export declare function renderRunNotice(icon: string, text: string, kind: string): HTMLDivElement;
+export declare function renderRunNotice(icon: string, text: string, kind: string, undo?: {
+    readonly label: string;
+    readonly onActivate: () => void;
+}): HTMLDivElement;
 //# sourceMappingURL=run_notice.d.ts.map

package/dist/ui/run_notice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_notice.d.ts","sourceRoot":"","sources":["../../src/ui/run_notice.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAuBxF"}
+{"version":3,"file":"run_notice.d.ts","sourceRoot":"","sources":["../../src/ui/run_notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAA;CAAE,GACjE,cAAc,CAuChB"}