ghostykit 0.3.0 → 0.3.2

package/dist/chunks/{chunk-D6JXJWYM.js → chunk-XZHX2NZT.js}

@@ -141,6 +141,8 @@ function createPostStreamTransport(target, options = {}) {
   return {
     // Sin steer: con un turno corriendo el servidor contesta 409. El composer no deja mandar.
     steer: false,
+    // Cada turno trae su stream: no hay «conectando» que enseñar.
+    stream: "per-turn",
     subscribe(l, sub = {}) {
       listener = l;
       isBusy = sub.isBusy ?? (() => false);

package/dist/react/connectingGate.d.ts

@@ -0,0 +1,17 @@
+/** Sin conexión por este rato, se enseña. */
+export declare const CONNECTING_DELAY_MS = 1200;
+/** Una vez a la vista, se queda al menos esto. */
+export declare const CONNECTING_MIN_MS = 700;
+export interface ConnectingGate {
+    /** Desde cuándo está a la vista (null = oculto). */
+    shownAt: number | null;
+    /** Desde cuándo falta la conexión (null = conectado). */
+    waitingSince: number | null;
+}
+export declare const initialGate: (now: number, connected: boolean) => ConnectingGate;
+/** El estado a `now`, y cuándo volver a mirar (null = no hace falta). */
+export declare function stepGate(g: ConnectingGate, connected: boolean, now: number, delay?: number, min?: number): {
+    gate: ConnectingGate;
+    visible: boolean;
+    recheckAt: number | null;
+};

package/dist/react/index.js

@@ -35,7 +35,7 @@ import {
   createPostStreamTransport,
   createSseTransport,
   readSse
-} from "../chunks/chunk-D6JXJWYM.js";
+} from "../chunks/chunk-XZHX2NZT.js";
 import {
   applyReferences,
   cleanUserText,
@@ -43,6 +43,9 @@ import {
   systemNoteOf
 } from "../chunks/chunk-6U545WJG.js";
 
+// src/react/Piloto.tsx
+import { AnimatePresence as AnimatePresence3 } from "motion/react";
+
 // ../../node_modules/lucide-react/dist/esm/createLucideIcon.mjs
 import { forwardRef as forwardRef2, createElement as createElement3 } from "react";
 
@@ -1862,7 +1865,7 @@ function Composer({
     const id = requestAnimationFrame(() => {
       const el = ref.current;
       if (!el) return;
-      el.focus();
+      el.focus({ preventScroll: true });
       el.setSelectionRange(el.value.length, el.value.length);
     });
     return () => cancelAnimationFrame(id);
@@ -1915,7 +1918,7 @@ function Composer({
         return next;
       });
       setNotice(rejected.length ? rejected.join(" \xB7 ") : null);
-      ref.current?.focus();
+      ref.current?.focus({ preventScroll: true });
     },
     [busy, canSeeImages, upload, maxFiles, maxFileMb, t]
   );
@@ -2296,6 +2299,22 @@ function ModelPicker({ models, current, onChange }) {
   ] });
 }
 
+// src/react/connectingGate.ts
+var CONNECTING_DELAY_MS = 1200;
+var CONNECTING_MIN_MS = 700;
+var initialGate = (now, connected) => ({ shownAt: null, waitingSince: connected ? null : now });
+function stepGate(g, connected, now, delay = CONNECTING_DELAY_MS, min = CONNECTING_MIN_MS) {
+  const waitingSince = connected ? null : g.waitingSince ?? now;
+  let shownAt = g.shownAt;
+  if (shownAt === null && waitingSince !== null && now - waitingSince >= delay) shownAt = now;
+  if (shownAt !== null && connected && now - shownAt >= min) shownAt = null;
+  const gate = { shownAt, waitingSince };
+  let recheckAt = null;
+  if (shownAt === null && waitingSince !== null) recheckAt = waitingSince + delay;
+  else if (shownAt !== null && connected) recheckAt = shownAt + min;
+  return { gate, visible: shownAt !== null, recheckAt };
+}
+
 // src/react/Status.tsx
 import { AnimatePresence as AnimatePresence2, motion as motion2 } from "motion/react";
 import { useEffect as useEffect4, useState as useState7 } from "react";
@@ -2657,10 +2676,10 @@ var Piloto = forwardRef3(function Piloto2(props, handle) {
       addReference: (r) => {
         const current = refsRef.current;
         if (!current.some((x) => x.id === r.id)) setRefs([...current, r]);
-        requestAnimationFrame(() => composerBox.current?.querySelector("textarea")?.focus());
+        requestAnimationFrame(() => composerBox.current?.querySelector("textarea")?.focus({ preventScroll: true }));
       },
       setDraft: (text) => setDraftState((d) => ({ text, n: d.n + 1 })),
-      focus: () => composerBox.current?.querySelector("textarea")?.focus()
+      focus: () => composerBox.current?.querySelector("textarea")?.focus({ preventScroll: true })
     }),
     [send, setRefs]
   );
@@ -2763,14 +2782,23 @@ var Piloto = forwardRef3(function Piloto2(props, handle) {
   const pageInProgress = last?.role === "assistant" && (Boolean(last.planning) || (last.pages ?? []).some((p) => !p.error && (!p.readyAt || p.review?.status === "running")));
   const toolRunning = busy && last?.role === "assistant" && ((last.tools ?? []).some(isRunning) || pageInProgress);
   const empty = turns.length === 0 && !busy;
-  const placeholder = !connected ? t.placeholderConnecting : props.placeholder ?? (props.agentName ? t.placeholder(props.agentName) : t.placeholderDefault);
+  const perTurn = !external && transport?.stream === "per-turn";
+  const ready = connected || perTurn;
+  const placeholder = !ready ? t.placeholderConnecting : props.placeholder ?? (props.agentName ? t.placeholder(props.agentName) : t.placeholderDefault);
   const showFiles = features.attachments ?? Boolean(props.upload);
-  const [slowConnect, setSlowConnect] = useState9(false);
+  const gateRef = useRef5(initialGate(Date.now(), ready));
+  const [showConnecting, setShowConnecting] = useState9(false);
   useEffect6(() => {
-    if (connected) return setSlowConnect(false);
-    const id = setTimeout(() => setSlowConnect(true), 800);
+    let id;
+    const tick = () => {
+      const r = stepGate(gateRef.current, ready, Date.now());
+      gateRef.current = r.gate;
+      setShowConnecting(r.visible);
+      if (r.recheckAt !== null) id = setTimeout(tick, Math.max(0, r.recheckAt - Date.now()));
+    };
+    tick();
     return () => clearTimeout(id);
-  }, [connected]);
+  }, [ready]);
   const pointedRefs = refs.filter((r) => r.prompt);
   const plainRefs = refs.filter((r) => !r.prompt);
   const removeRef = (id) => setRefs(refsRef.current.filter((r) => r.id !== id));
@@ -2807,7 +2835,7 @@ var Piloto = forwardRef3(function Piloto2(props, handle) {
     // empezar. Si no cabe (panel bajo), se desplaza: `safe center` nunca empuja nada fuera.
     /* @__PURE__ */ jsxs8("div", { className: "gs-scroll flex min-h-0 flex-1 flex-col items-center justify-center overflow-y-auto px-4 pb-[10vh] [justify-content:safe_center]", children: [
       slots.headerActions && /* @__PURE__ */ jsx10("div", { className: "absolute right-4 top-3 flex gap-2", children: slots.headerActions }),
-      !connected && slowConnect ? /* @__PURE__ */ jsx10(ConnectingState, { phase, error, avatar: props.avatar }) : slots.emptyState ?? /* @__PURE__ */ jsxs8("div", { className: "mb-6 flex flex-col items-center", children: [
+      /* @__PURE__ */ jsx10(AnimatePresence3, { mode: "wait", initial: false, children: showConnecting ? /* @__PURE__ */ jsx10(ConnectingState, { phase, error, avatar: props.avatar }, "connecting") : /* @__PURE__ */ jsx10("div", { children: slots.emptyState ?? /* @__PURE__ */ jsxs8("div", { className: "mb-6 flex flex-col items-center", children: [
         props.avatar && /* @__PURE__ */ jsx10("div", { className: "mb-3", children: props.avatar }),
         props.welcome && // Un saludo largo (una explicación del copiloto) baja a letra de lectura.
         /* @__PURE__ */ jsx10(
@@ -2817,7 +2845,7 @@ var Piloto = forwardRef3(function Piloto2(props, handle) {
             children: props.welcome
           }
         )
-      ] }),
+      ] }) }, "welcome") }),
       /* @__PURE__ */ jsxs8("div", { className: "w-full max-w-3xl", children: [
         slots.aboveComposer,
         composer,

package/dist/transport/index.js

@@ -7,7 +7,7 @@ import {
   createPostStreamTransport,
   createSseTransport,
   readSse
-} from "../chunks/chunk-D6JXJWYM.js";
+} from "../chunks/chunk-XZHX2NZT.js";
 export {
   MIN_SILENCE_MS,
   MISSED_BEATS,

package/dist/transport/types.d.ts

@@ -23,6 +23,11 @@ export interface PilotTransport {
     respondPermission?(id: string, optionId: string): Promise<{
         resolved: boolean;
     }>;
+    /**
+     * `"per-turn"`: no hay un stream vivo que esperar (cada turno trae el suyo, como el POST de
+     * EasyBits). Piloto pinta el hilo al instante y nunca enseña «conectando». Default `"live"`.
+     */
+    stream?: "live" | "per-turn";
     /** El hilo guardado, para pintarlo al montar (si la app no pasa `initialTurns`). */
     history?(): Promise<Turn[] | PilotHistory>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ghostykit",
-  "version": "0.3.0",
-  "description": "Piloto UI \u2014 the in-app copilot chat from Ghosty Studio: streaming, agent steps, attachments, voice, reconnection and human approval cards. Pure event reducer + SSE transport + React components.",
+  "version": "0.3.2",
+  "description": "Piloto UI — the in-app copilot chat from Ghosty Studio: streaming, agent steps, attachments, voice, reconnection and human approval cards. Pure event reducer + SSE transport + React components.",
   "type": "module",
   "main": "./dist/core/index.js",
   "types": "./dist/core/index.d.ts",
@@ -62,6 +62,7 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "esbuild": "^0.25.0",
+    "jsdom": "^26.1.0",
     "lucide-react": "^1.44.0",
     "motion": "^12.38.0",
     "postcss": "^8.5.0",