@guuey/agent-layout 0.16.0 → 0.16.2

package/dist/machine.d.ts

@@ -39,6 +39,16 @@ export type AgentModeInput =
  | {
     type: "agentSubmit";
 }
+/**
+ * Give the agent panel the room WITHOUT claiming a submit happened
+ * (guuey#427, the first consumer's near-miss): a host reopening the
+ * agent surface (restoring a view, a deep link) wants the tone flip
+ * and NOTHING else — arming the working state here would leave a
+ * permanent spinner, since no turn will ever mount a view or settle.
+ */
+ | {
+    type: "agentPanelActivated";
+}
 /** The turn reached `ready`. NO panel transition (platform-ruled: no bounce-back). */
  | {
     type: "agentSettled";

package/dist/machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,wBAAwB,EAAE,cAKtC,CAAC;AAEF,MAAM,MAAM,cAAc;AACxB,kFAAkF;AAChF;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE;AAC7B,wDAAwD;GACtD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE;AACzB,sFAAsF;GACpF;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE;AAC1B,4EAA4E;GAC1E;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE;AAC9B,gEAAgE;GAC9D;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc,CAkB5F"}
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,wBAAwB,EAAE,cAKtC,CAAC;AAEF,MAAM,MAAM,cAAc;AACxB,kFAAkF;AAChF;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE;AAC7B,wDAAwD;GACtD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE;AACzB;;;;;;GAMG;GACD;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE;AACjC,sFAAsF;GACpF;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE;AAC1B,4EAA4E;GAC1E;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE;AAC9B,gEAAgE;GAC9D;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc,CAqB5F"}

package/dist/machine.js

@@ -39,6 +39,9 @@ export function agentModeReduce(state, input) {
             return { ...state, activePanel: "app", pending: false };
         case "agentSubmit":
             return { activePanel: "agent", streaming: true, pending: true };
+        case "agentPanelActivated":
+            // The neutral flip: panel only — streaming/pending untouched.
+            return { ...state, activePanel: "agent" };
         case "agentSettled":
             // Stream end changes nothing about the panel — the tone tracks the
             // user's locus of action, not the agent's state.

package/dist/react.d.ts

@@ -54,7 +54,13 @@ export interface UseAgentModeResult {
     pending: boolean;
     /** The raw machine door — `bindGuueyChat(dispatch)` wires a kit surface. */
     dispatch: (input: AgentModeInput) => void;
-    /** Escape hatch for surfaces with custom needs (documented as rarely needed). */
+    /**
+     * The NEUTRAL panel setter (guuey#427): flips which panel has the room
+     * and nothing else — `"agent"` never claims a submit happened (no
+     * working state, no streaming). Submit intent goes through
+     * `dispatch({ type: "agentSubmit" })` / `bindGuueyChat`. Escape hatch,
+     * documented as rarely needed.
+     */
     setActivePanel: (panel: ActivePanel) => void;
     /** The <1024px overlay drawer (lib-owned state; Shell renders the toggle). */
     drawerOpen: boolean;

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAUL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,IAAc,EACd,KAAK,EACL,YAAyC,EACzC,QAAe,EACf,aAAa,GACd,EAAE,sBAAsB,GAAG,SAAS,CAiDpC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,iFAAiF;IACjF,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,wBAAgB,YAAY,IAAI,kBAAkB,CAoBjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,SAAS,CAqB5C;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,CAUzC;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAcpG;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACrE;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,eAAe,GAAG,SAAS,CAwBrG;AAMD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAUL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,IAAc,EACd,KAAK,EACL,YAAyC,EACzC,QAAe,EACf,aAAa,GACd,EAAE,sBAAsB,GAAG,SAAS,CAiDpC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,wBAAgB,YAAY,IAAI,kBAAkB,CAwBjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,SAAS,CAqB5C;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,CAUzC;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAcpG;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACrE;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,eAAe,GAAG,SAAS,CAwBrG;AAMD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/react.js

@@ -57,7 +57,12 @@ export function useAgentMode() {
         throw new Error("useAgentMode: no <AgentModeProvider> above this component.");
     }
     const { state, dispatch, drawerOpen, setDrawerOpen } = ctx;
-    const setActivePanel = useCallback((panel) => dispatch(panel === "app" ? { type: "menuInteraction" } : { type: "agentSubmit" }), [dispatch]);
+    const setActivePanel = useCallback((panel) => 
+    // guuey#427: the name promises a neutral setter, so it IS one — the
+    // agent arm activates the panel WITHOUT arming the working state
+    // (the first consumer nearly shipped a permanent spinner on the
+    // agentSubmit sugar this used to be).
+    dispatch(panel === "app" ? { type: "menuInteraction" } : { type: "agentPanelActivated" }), [dispatch]);
     return {
         activePanel: state.activePanel,
         streaming: state.streaming,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/agent-layout",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "description": "Agent-mode layout: the two-tone shell where an app and its agent share one surface — the pane follows attention, the transport owns the stream.",
   "license": "MIT",
   "repository": {

package/src/machine.ts

@@ -44,6 +44,14 @@ export type AgentModeInput =
   | { type: "menuInteraction" }
   /** The user sent a message — the agent bridge fired. */
   | { type: "agentSubmit" }
+  /**
+   * Give the agent panel the room WITHOUT claiming a submit happened
+   * (guuey#427, the first consumer's near-miss): a host reopening the
+   * agent surface (restoring a view, a deep link) wants the tone flip
+   * and NOTHING else — arming the working state here would leave a
+   * permanent spinner, since no turn will ever mount a view or settle.
+   */
+  | { type: "agentPanelActivated" }
   /** The turn reached `ready`. NO panel transition (platform-ruled: no bounce-back). */
   | { type: "agentSettled" }
   /** A live view mounted — the working state has been replaced by content. */
@@ -63,6 +71,9 @@ export function agentModeReduce(state: AgentModeState, input: AgentModeInput): A
       return { ...state, activePanel: "app", pending: false };
     case "agentSubmit":
       return { activePanel: "agent", streaming: true, pending: true };
+    case "agentPanelActivated":
+      // The neutral flip: panel only — streaming/pending untouched.
+      return { ...state, activePanel: "agent" };
     case "agentSettled":
       // Stream end changes nothing about the panel — the tone tracks the
       // user's locus of action, not the agent's state.

package/src/react.tsx

@@ -142,7 +142,13 @@ export interface UseAgentModeResult {
   pending: boolean;
   /** The raw machine door — `bindGuueyChat(dispatch)` wires a kit surface. */
   dispatch: (input: AgentModeInput) => void;
-  /** Escape hatch for surfaces with custom needs (documented as rarely needed). */
+  /**
+   * The NEUTRAL panel setter (guuey#427): flips which panel has the room
+   * and nothing else — `"agent"` never claims a submit happened (no
+   * working state, no streaming). Submit intent goes through
+   * `dispatch({ type: "agentSubmit" })` / `bindGuueyChat`. Escape hatch,
+   * documented as rarely needed.
+   */
   setActivePanel: (panel: ActivePanel) => void;
   /** The <1024px overlay drawer (lib-owned state; Shell renders the toggle). */
   drawerOpen: boolean;
@@ -157,7 +163,11 @@ export function useAgentMode(): UseAgentModeResult {
   const { state, dispatch, drawerOpen, setDrawerOpen } = ctx;
   const setActivePanel = useCallback(
     (panel: ActivePanel) =>
-      dispatch(panel === "app" ? { type: "menuInteraction" } : { type: "agentSubmit" }),
+      // guuey#427: the name promises a neutral setter, so it IS one — the
+      // agent arm activates the panel WITHOUT arming the working state
+      // (the first consumer nearly shipped a permanent spinner on the
+      // agentSubmit sugar this used to be).
+      dispatch(panel === "app" ? { type: "menuInteraction" } : { type: "agentPanelActivated" }),
     [dispatch],
   );
   return {

package/styles.css

@@ -11,14 +11,37 @@
  * set it.
  */
 
+/* guuey#429 (founder rule, requirement-grade): the shell is VIEWPORT-PINNED
+ * by default — "the sidebar's height should be fixed and the lower part
+ * should be stick on its bottom". `height: 100%` only pins when every
+ * ancestor carries a definite height, which no adopter's tree guarantees —
+ * against auto ancestors it computes to auto, tall pane content stretches
+ * the PAGE, and the agent rail scrolls below the fold (a scrollable-away
+ * agent panel defeats the category). So the ROOT establishes the chain
+ * itself: dynamic-viewport height (dvh; vh first as the older-browser
+ * fallback), `overflow: hidden` so content can only scroll inside the
+ * panels' own scroll contexts (the pane's overflow:auto; the chat's own
+ * scroller), never the page. An embedder that genuinely wants an in-flow
+ * layout sets `--guuey-layout-height` (e.g. `100%` inside its own pinned
+ * region) — a seam, not a fight. */
 .guuey-agent-layout {
-  height: 100%;
+  height: var(--guuey-layout-height, 100vh);
+  height: var(--guuey-layout-height, 100dvh);
   min-height: 0;
+  overflow: hidden;
 }
 
 .guuey-layout-shell {
   display: grid;
   grid-template-columns: minmax(240px, 300px) 1fr;
+  /* guuey#429, the completing half (console's adjudication): without an
+   * explicit row the grid's IMPLICIT row is `auto` — it sizes to content,
+   * growing past any bounded container and rendering every child's
+   * min-height:0 + overflow:auto inert (clip-not-scroll). minmax(0, 1fr)
+   * makes the row exactly the container's height, so the root's viewport
+   * pin actually DISTRIBUTES: sidebar bound, pane scrolling within
+   * itself. */
+  grid-template-rows: minmax(0, 1fr);
   height: 100%;
   min-height: 0;
 }
@@ -36,11 +59,18 @@
   transition: background-color var(--guuey-layout-tone-transition) ease-out;
 }
 .guuey-layout-panel-app {
+  /* The app panel keeps its content height; the agent panel takes the
+   * remaining lower space (guuey#429 — stuck on its bottom, never
+   * crushed nor scrolled away). */
+  flex-shrink: 0;
   background: var(--guuey-layout-tone-upper);
   color: var(--guuey-layout-tone-upper-on);
 }
 .guuey-layout-panel-agent {
-  flex: 1;
+  /* Host-overridable default (guuey#427): a host that wants a fixed-height
+   * rail sets `--guuey-layout-agent-panel-flex` (e.g. `0 0 auto` + its own
+   * height) — a custom-property seam, never a specificity fight. */
+  flex: var(--guuey-layout-agent-panel-flex, 1);
   display: flex;
   flex-direction: column;
   background: var(--guuey-layout-tone-lower);