ghostykit 0.3.1 → 0.4.0

package/dist/react/strings.d.ts

@@ -1,11 +1,9 @@
-import type { ConnectPhase } from "../core/types";
 export interface PilotStrings {
     /** Para formatear números y moneda. */
     numberLocale: string;
     placeholder: (agentName: string) => string;
     /** Sin `agentName`. */
     placeholderDefault: string;
-    placeholderConnecting: string;
     send: string;
     stop: string;
     uploading: string;
@@ -31,21 +29,12 @@ export interface PilotStrings {
     voiceFailed: string;
     model: string;
     thinking: string;
-    steered: string;
-    /** Lo que se ve mientras conecta, por fase (en primera persona: habla el agente). */
-    waitPhase: Record<ConnectPhase, string>;
     /** Qué dice el agente de un turno del que sólo sabe cuánto lleva. */
     howItGoes: (seconds: number) => string;
     /** Frases propias mientras piensa (rotan cada 4 s en lugar de `howItGoes`). */
     thinkingPhrases?: string[];
     stillWorking: string;
-    cantStart: string;
     retry: string;
-    resume: string;
-    /** Con `interrupted.canContinue`: el servidor continúa ESE turno. */
-    continueTurn: string;
-    interrupted: (reason: string) => string;
-    interruptedOurFault: string;
     copy: string;
     copied: string;
     copyMessage: string;
@@ -59,11 +48,6 @@ export interface PilotStrings {
     failed: string;
     step: string;
     replyOptions: string;
-    connectSteps: {
-        label: string;
-        hint: string;
-    }[];
-    connectRetry: string;
     linkTitle: string;
     linkCopy: string;
     linkCopied: string;
@@ -73,14 +57,14 @@ export interface PilotStrings {
     confirmTitle: string;
     approve: string;
     reject: string;
-    confirmExpired: string;
-    confirmFailed: string;
     /** «Vence en 14:32». */
     expiresIn: (mmss: string) => string;
     expiredNow: string;
     decisionApproved: string;
     decisionRejected: string;
     decisionExpired: string;
+    decisionCancelled: string;
+    stampCancelled: string;
     stampApproved: string;
     stampRejected: string;
     stampExpired: string;

package/dist/react/usePilot.d.ts

@@ -1,67 +1,55 @@
-import type { Attachment, Interrupted, PermissionRequest, PilotState, Reference, SendInput, Turn } from "../core/types";
-import { type PilotTransport, type SseTransportOptions } from "../transport";
+import type { BaseEvent, RunAgentInput } from "@ag-ui/core";
+import type { Attachment, Decision, PermissionRequest, PilotState, Reference, Turn } from "../core/types";
+import { type PilotTransport } from "../transport";
 export interface TurnDoneInfo {
     /** El texto final de la respuesta. */
     text: string;
-    turnId?: string;
-    /** Cuánto tardó (sólo si lo encargó este cliente). */
+    runId?: string;
+    /** Cuánto tardó. */
     seconds?: number;
-    /** Se cortó por falla del servidor (el chat ofrece Retomar). */
-    interrupted?: Interrupted;
+    /** El run terminó en RUN_ERROR. */
+    error?: string;
+    /** El run se detuvo a pedir aprobación. */
+    interrupted?: boolean;
 }
 export interface UsePilotOptions {
-    /** El hilo guardado. Si cambia (la app volvió a leerlo), se reconcilia en reposo. */
+    /** El hilo (AG-UI `threadId`). Con él, al montar se pide el hilo guardado (MESSAGES_SNAPSHOT). Sin él, hilo nuevo. */
+    threadId?: string;
+    /** Turnos para pintar de entrada (sin pedirlos al servidor). */
     initialTurns?: Turn[];
-    /** Lo que el usuario ve en pantalla: viaja con CADA turno. Una función se evalúa al mandar. */
+    /**
+     * Lo que el usuario ve en pantalla: viaja en CADA run como `context` de AG-UI. Un objeto da una
+     * entrada por llave (`{description: llave, value: JSON}`); una función se evalúa al mandar.
+     */
     context?: unknown | (() => unknown);
     onTurnStart?: () => void;
     /** Fin de turno con su texto: aquí la app re-lee datos, repinta efectos, avisa. */
     onTurnDone?: (info: TurnDoneInfo) => void;
-    /** El servidor bautizó el hilo. */
+    /** El servidor bautizó el hilo (`CUSTOM ghosty.title`). */
     onTitle?: (title?: string) => void;
-    /** El servidor pide cuenta (cupo sin cuenta agotado). */
-    onNeedsLogin?: () => void;
-    /** El stream se cerró (el hilo sigue en el servidor y se puede reabrir). */
-    onDisconnected?: () => void;
-    /** Cada evento crudo, antes del reductor (analítica, efectos propios). */
-    onEvent?: (name: string, data: unknown) => void;
-    /** Cada mensaje que sale (analítica: «primer mensaje»). */
-    onSend?: (input: SendInput) => void;
+    /** Cada evento AG-UI crudo, antes del reductor (analítica, STATE_*, CUSTOM propios). */
+    onEvent?: (event: BaseEvent) => void;
+    /** Cada run que sale (analítica). */
+    onSend?: (input: RunAgentInput) => void;
 }
 export interface SendOptions {
-    resume?: boolean;
-    resumeTurnId?: string;
     references?: Reference[];
 }
 export interface Pilot {
     state: PilotState;
+    threadId: string;
     send: (text: string, attachments?: Attachment[], opts?: SendOptions) => Promise<void>;
+    /** Detiene el run: corta la conexión (el servidor corta el run). */
     stop: () => void;
-    /** Reintenta el último mensaje (quita la respuesta anterior). */
+    /** Reintenta el último mensaje. */
     retry: () => void;
-    /** Turno PERDIDO (no arrancó): se abandona y se reenvía. */
-    abandonAndRetry: () => void;
-    /** «Retomar» un turno cortado por el servidor. */
-    resume: () => void;
-    setModel: (value: string) => void;
-    /**
-     * Contesta una tarjeta. `via` = cómo la contesta la app (p. ej. su ruta de aprobación con la
-     * sesión); sin él, `transport.respondPermission`. La decisión queda anotada en la respuesta.
-     */
-    respondPermission: (id: string, optionId: string, via?: PermissionHandler) => Promise<PermissionAnswer>;
-    /** Anota lo que ya contestó la app (sin volver a contestar): la tarjeta sale y queda la decisión. */
-    recordDecision: (id: string, optionId: string, answer: PermissionAnswer, asked?: PermissionRequest) => void;
-    /** Una tarjeta que venció sin contestarse: sale de las abiertas como «venció». */
+    /** Contesta una tarjeta. Cuando ya están contestadas TODAS las abiertas, sale el `resume`. */
+    respondPermission: (id: string, approved: boolean) => void;
+    /** Anota la decisión bajo la respuesta y retira la tarjeta (tras su sello). */
+    recordDecision: (id: string, status: Decision["status"], asked?: PermissionRequest) => void;
+    /** Una tarjeta venció sin contestarse: se anota y su interrupt viaja como `cancelled` en el siguiente run. */
     expirePermission: (id: string) => void;
-    /** Un mensaje del agente que llegó fuera de un turno: espera a que cierre el turno vivo. */
-    appendAgentMessage: (text: string) => void;
 }
-/** Lo que contesta la app al resolver una tarjeta. `resolved: false` = ya no estaba abierta. */
-export type PermissionAnswer = {
-    resolved: boolean;
-    detail?: string;
-} | void;
-export type PermissionHandler = (id: string, optionId: string) => Promise<PermissionAnswer> | PermissionAnswer;
+/** El contexto de la app como `context` de AG-UI: `[{description, value}]`, `value` siempre texto. */
+export declare function toAgUiContext(ctx: unknown): RunAgentInput["context"];
 export declare function usePilot(transport: PilotTransport | null, opts?: UsePilotOptions): Pilot;
-/** Un transporte SSE estable por `base` (crearlo en cada render reabriría el stream). */
-export declare function useSseTransport(base: string | null | undefined, opts?: SseTransportOptions): PilotTransport | null;

package/dist/styles.css

@@ -1,4 +1,4 @@
-/* ghostykit — Piloto UI · MIT · https://github.com/blissito/ghostykit */
+/* ghostykit — Ghosty Autopilot · MIT · https://github.com/blissito/ghostykit */
 /* ── Utilidades (Tailwind v4, encerradas en .piloto) ── */
 /*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
 .piloto {
@@ -34,7 +34,6 @@
   --font-weight-semibold: 600;
   --font-weight-extrabold: 800;
   --tracking-tight: -0.025em;
-  --leading-tight: 1.25;
   --radius-md: calc(0.375 * var(--piloto-rem));
   --radius-lg: calc(0.5 * var(--piloto-rem));
   --radius-xl: calc(0.75 * var(--piloto-rem));
@@ -304,9 +303,6 @@
 .piloto .h-2 {
   height: calc(var(--spacing) * 2);
 }
-.piloto .h-2\.5 {
-  height: calc(var(--spacing) * 2.5);
-}
 .piloto .h-3 {
   height: calc(var(--spacing) * 3);
 }
@@ -331,9 +327,6 @@
 .piloto .h-9 {
   height: calc(var(--spacing) * 9);
 }
-.piloto .h-12 {
-  height: calc(var(--spacing) * 12);
-}
 .piloto .h-16 {
   height: calc(var(--spacing) * 16);
 }
@@ -373,18 +366,12 @@
 .piloto .min-h-\[24px\] {
   min-height: 24px;
 }
-.piloto .min-h-\[50vh\] {
-  min-height: 50vh;
-}
 .piloto .min-h-\[200px\] {
   min-height: 200px;
 }
 .piloto .w-2 {
   width: calc(var(--spacing) * 2);
 }
-.piloto .w-2\.5 {
-  width: calc(var(--spacing) * 2.5);
-}
 .piloto .w-3 {
   width: calc(var(--spacing) * 3);
 }
@@ -412,9 +399,6 @@
 .piloto .w-10 {
   width: calc(var(--spacing) * 10);
 }
-.piloto .w-12 {
-  width: calc(var(--spacing) * 12);
-}
 .piloto .w-16 {
   width: calc(var(--spacing) * 16);
 }
@@ -581,9 +565,6 @@
 .piloto .gap-6 {
   gap: calc(var(--spacing) * 6);
 }
-.piloto .gap-8 {
-  gap: calc(var(--spacing) * 8);
-}
 .piloto .gap-\[2px\] {
   gap: 2px;
 }
@@ -769,9 +750,6 @@
     background-color: color-mix(in oklab, var(--color-background-secondary) 50%, transparent);
   }
 }
-.piloto .bg-background-success {
-  background-color: var(--color-background-success);
-}
 .piloto .bg-background\/50 {
   background-color: var(--color-background);
   @supports (color: color-mix(in lab, red, red)) {
@@ -808,9 +786,6 @@
     background-color: color-mix(in oklab, var(--color-black) 60%, transparent);
   }
 }
-.piloto .bg-border-primary {
-  background-color: var(--color-border-primary);
-}
 .piloto .bg-brand-500 {
   background-color: var(--color-brand-500);
 }
@@ -862,9 +837,6 @@
     background-color: color-mix(in oklab, var(--color-sidebar) 80%, transparent);
   }
 }
-.piloto .bg-text-danger {
-  background-color: var(--color-text-danger);
-}
 .piloto .bg-text-primary {
   background-color: var(--color-text-primary);
 }
@@ -1037,10 +1009,6 @@
   --tw-leading: 1;
   line-height: 1;
 }
-.piloto .leading-tight {
-  --tw-leading: var(--leading-tight);
-  line-height: var(--leading-tight);
-}
 .piloto .font-extrabold {
   --tw-font-weight: var(--font-weight-extrabold);
   font-weight: var(--font-weight-extrabold);
@@ -1190,9 +1158,6 @@
 .piloto .ring-ring-info {
   --tw-ring-color: var(--color-ring-info);
 }
-.piloto .filter {
-  filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
-}
 .piloto .backdrop-blur-sm {
   --tw-backdrop-blur: blur(var(--blur-sm));
   -webkit-backdrop-filter: var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,);
@@ -1697,59 +1662,6 @@
   inherits: false;
   initial-value: 0 0 #0000;
 }
-@property --tw-blur {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-brightness {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-contrast {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-grayscale {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-hue-rotate {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-invert {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-opacity {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-saturate {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-sepia {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-drop-shadow {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-drop-shadow-color {
-  syntax: "*";
-  inherits: false;
-}
-@property --tw-drop-shadow-alpha {
-  syntax: "<percentage>";
-  inherits: false;
-  initial-value: 100%;
-}
-@property --tw-drop-shadow-size {
-  syntax: "*";
-  inherits: false;
-}
 @property --tw-backdrop-blur {
   syntax: "*";
   inherits: false;
@@ -1860,19 +1772,6 @@
       --tw-ring-offset-width: 0px;
       --tw-ring-offset-color: #fff;
       --tw-ring-offset-shadow: 0 0 #0000;
-      --tw-blur: initial;
-      --tw-brightness: initial;
-      --tw-contrast: initial;
-      --tw-grayscale: initial;
-      --tw-hue-rotate: initial;
-      --tw-invert: initial;
-      --tw-opacity: initial;
-      --tw-saturate: initial;
-      --tw-sepia: initial;
-      --tw-drop-shadow: initial;
-      --tw-drop-shadow-color: initial;
-      --tw-drop-shadow-alpha: 100%;
-      --tw-drop-shadow-size: initial;
       --tw-backdrop-blur: initial;
       --tw-backdrop-brightness: initial;
       --tw-backdrop-contrast: initial;
@@ -1891,7 +1790,7 @@
 
 /* ── La piel ── */
 /* ─────────────────────────────────────────────────────────────────────────────
-   Piloto UI — la piel.
+   Ghosty Autopilot — la piel.
 
    El chat es el de Ghosty Studio (`/c`): mismas piezas, mismas clases, mismos
    valores. Aquí viven (1) las variables `--piloto-*`, cuyos valores de casa son

package/dist/transport/index.d.ts

@@ -1,32 +1,42 @@
-import { type PilotTransport } from "./types";
-export * from "./types";
-export { createPostStreamTransport, readSse, type PostStreamTransportOptions, type SseMessage } from "./postStream";
-/** Los eventos con nombre del contrato. Un evento SSE sin `addEventListener` no se despacha nunca. */
-export declare const SSE_EVENTS: readonly ["started", "status", "caps", "models", "chunk", "thought", "tool", "artifact", "usage", "title", "done", "error", "warning", "reemplazo", "permission", "permission-resolved", "closed", "page-plan", "section-building", "section-update", "section", "page-ready", "page-error", "page-planning", "page-drop", "review", "page-version", "page-edit", "snapshot", "idle", "interrupted", "capacity"];
-/**
- * Tope de silencio del cliente, la red de seguridad: pasado esto SIN NINGÚN evento —ni el `status`
- * que el servidor manda cada 25 s con turno vivo— la conexión está muerta aunque el navegador no lo
- * note. No se da el turno por perdido: se reconecta y el servidor dice la verdad. ≥ el silencio
- * máximo del servidor (10 min) para no adelantarse nunca a él si no manda latido.
- */
-export declare const SILENCE_MAX_MS: number;
-/** Con latido anunciado, basta con perder unos cuantos para saber que la conexión murió. */
-export declare const MISSED_BEATS = 4;
-/** Piso del tope con latido: un latido muy corto no debe reconectar a lo loco. */
-export declare const MIN_SILENCE_MS = 90000;
-export interface SseTransportOptions {
-    /** Para mandar cabeceras propias (auth) en los POST. */
+import type { BaseEvent, RunAgentInput } from "@ag-ui/core";
+export interface PilotTransport {
+    /**
+     * Corre un run: manda `input`, entrega cada evento AG-UI a `onEvent` en orden y se resuelve cuando el
+     * servidor cierra el stream. Rechaza con `PilotHttpError` si el servidor dice que no antes de empezar.
+     */
+    run(input: RunAgentInput, onEvent: (event: BaseEvent) => void, signal?: AbortSignal): Promise<void>;
+}
+/** El servidor rechazó el run antes de empezar (§6 de docs/protocol.md). */
+export declare class PilotHttpError extends Error {
+    status: number;
+    /** El `error` del cuerpo: `run_active`, `interrupt_pending`, `bad_request`… */
+    code?: string;
+    /** Segundos de `Retry-After` (429/503). */
+    retryAfter?: number;
+    constructor(message: string, status: number, code?: string, retryAfter?: number);
+}
+export interface AgUiTransportOptions {
+    /** El endpoint del agente: `POST <url>`. */
+    url: string;
+    /** Cabeceras propias (auth por token). */
+    headers?: Record<string, string>;
+    /** Default `same-origin`: la cookie de sesión viaja sola. */
+    credentials?: RequestCredentials;
     fetch?: typeof fetch;
-    /** Cookies en un stream de otro origen (widget embebido). */
-    withCredentials?: boolean;
-    /** Para pruebas o entornos sin `EventSource` global. */
-    EventSource?: typeof EventSource;
-    /** Eventos extra a escuchar (además de `SSE_EVENTS`). */
-    events?: string[];
-    /** Cada cuánto se revisa el silencio. */
-    checkEveryMs?: number;
-    /** Reloj inyectable (pruebas). */
-    now?: () => number;
+    /** Reintentos de un 503 (deploy) con el MISMO run. Default 6. */
+    retries?: number;
+    /** Espera inyectable (pruebas). */
+    sleep?: (ms: number) => Promise<void>;
 }
-/** El transporte SSE de Ghosty: `GET ${base}/events` (stream) y POST a `messages|cancel|model|permission`. */
-export declare function createSseTransport(base: string, opts?: SseTransportOptions): PilotTransport;
+/** Un evento SSE ya separado: nombre + data crudo. */
+export interface SseMessage {
+    event: string;
+    data: string;
+}
+/**
+ * Lee un stream SSE (`text/event-stream`) de un `fetch`. Los comentarios (`: ping`) se ignoran; un
+ * evento puede llegar partido en varios pedazos de red.
+ */
+export declare function readSse(body: ReadableStream<Uint8Array>, onMessage: (m: SseMessage) => void): Promise<void>;
+/** El transporte AG-UI sobre HTTP (SSE). */
+export declare function createAgUiTransport(opts: AgUiTransportOptions): PilotTransport;

package/dist/transport/index.js

@@ -1,20 +1,10 @@
 import {
-  MIN_SILENCE_MS,
-  MISSED_BEATS,
   PilotHttpError,
-  SILENCE_MAX_MS,
-  SSE_EVENTS,
-  createPostStreamTransport,
-  createSseTransport,
+  createAgUiTransport,
   readSse
-} from "../chunks/chunk-XZHX2NZT.js";
+} from "../chunks/chunk-DXFWACUL.js";
 export {
-  MIN_SILENCE_MS,
-  MISSED_BEATS,
   PilotHttpError,
-  SILENCE_MAX_MS,
-  SSE_EVENTS,
-  createPostStreamTransport,
-  createSseTransport,
+  createAgUiTransport,
   readSse
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ghostykit",
-  "version": "0.3.1",
-  "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.4.0",
+  "description": "Ghosty Autopilot \u2014 the autopilot chat for your React app, on AG-UI: works with LangGraph, Mastra, CrewAI or any AG-UI agent. Streaming text, agent steps, human approval cards (interrupt/resume), attachments and voice.",
   "type": "module",
   "main": "./dist/core/index.js",
   "types": "./dist/core/index.d.ts",
@@ -59,9 +59,11 @@
   "devDependencies": {
     "@ghostystudio/pointer": "^0.4.0",
     "@tailwindcss/cli": "^4.1.0",
+    "@types/node": "^22.20.5",
     "@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",
@@ -73,15 +75,18 @@
     "vitest": "^3.2.0"
   },
   "keywords": [
-    "ai",
+    "acp",
+    "ag-ui",
     "agent",
-    "copilot",
+    "ai",
+    "autopilot",
     "chat",
-    "react",
-    "sse",
-    "acp",
+    "copilot",
+    "ghosty",
     "human-in-the-loop",
-    "ghosty"
+    "langgraph",
+    "react",
+    "sse"
   ],
   "license": "MIT",
   "repository": {
@@ -89,5 +94,8 @@
     "url": "git+https://github.com/blissito/ghostykit.git",
     "directory": "packages/ghostykit"
   },
-  "homepage": "https://github.com/blissito/ghostykit#readme"
+  "homepage": "https://github.com/blissito/ghostykit#readme",
+  "dependencies": {
+    "@ag-ui/core": "^1.0.3"
+  }
 }