ghostykit 0.0.0-stage → 0.2.0

package/dist/transport/index.d.ts

@@ -0,0 +1,32 @@
+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. */
+    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;
+}
+/** 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;

package/dist/transport/index.js

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

package/dist/transport/postStream.d.ts

@@ -0,0 +1,44 @@
+import type { SendInput, Turn } from "../core/types";
+import { type PilotTransport } from "./types";
+/** 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`. Llama `onMessage` por cada evento con
+ * nombre y `onBytes` con CUALQUIER cosa que llegue (los comentarios `: ka` cuentan como vida).
+ */
+export declare function readSse(body: ReadableStream<Uint8Array>, onMessage: (m: SseMessage) => void, onBytes?: () => void): Promise<void>;
+export interface PostStreamTransportOptions {
+    fetch?: typeof fetch;
+    /** Default `same-origin` (la cookie de sesión viaja; EasyBits rechaza cualquier Bearer). */
+    credentials?: RequestCredentials;
+    /** Cuerpo del POST. Default: el contrato de EasyBits. */
+    body?: (input: SendInput & {
+        turnId: string;
+    }) => unknown;
+    /** URL del re-enganche. Default `${url}?attach=1`; `null` = sin re-enganche. */
+    attachUrl?: string | null;
+    /** URL del historial (JSON). Default `url`; `null` = sin historial. */
+    historyUrl?: string | null;
+    /** Cómo leer el historial. Default: `{messages:[{role:"user"|"agent",text}]}`. */
+    parseHistory?: (json: unknown) => Turn[];
+    /** URL para cancelar (POST). Sin ella, «detener» sólo deja de escuchar: el turno sigue en el servidor. */
+    cancelUrl?: string;
+    /** Silencio (sin un solo byte, ni `: ka`) tras el que la conexión se da por muerta. Default 60 s. */
+    silenceMs?: number;
+    /** Reintentos de un 503 (deploy) o de un re-enganche. Default 6. */
+    retries?: number;
+    newTurnId?: () => string;
+    /** Reloj y espera inyectables (pruebas). */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * El transporte de «POST que devuelve el stream». Cada turno es su propio stream; si se corta sin
+ * evento final (red, deploy), se re-engancha con el GET de attach y el servidor dice la verdad
+ * (`snapshot` y sigue, o el evento final, o `idle`).
+ */
+export declare function createPostStreamTransport(target: string | (PostStreamTransportOptions & {
+    url: string;
+}), options?: PostStreamTransportOptions): PilotTransport;

package/dist/transport/types.d.ts

@@ -0,0 +1,37 @@
+import type { SendInput, SendResult, Turn } from "../core/types";
+/** Un evento con nombre y su `data` ya parseado (`null` si no traía o no era JSON). */
+export type PilotListener = (name: string, data: unknown) => void;
+export interface SubscribeOptions {
+    /** ¿Hay un turno en vuelo? Con turno vivo, un silencio largo = conexión muerta → se reabre. */
+    isBusy?: () => boolean;
+}
+export interface PilotTransport {
+    /** Abre el stream de eventos. Devuelve con qué cerrarlo. */
+    subscribe(listener: PilotListener, opts?: SubscribeOptions): () => void;
+    /** Encarga un turno (o lo mete al turno en vuelo). Rechaza con `PilotHttpError` si el servidor dice que no. */
+    send(input: SendInput): Promise<SendResult>;
+    /** Detiene el turno en curso. */
+    cancel(): Promise<void>;
+    /** Cambia el modelo de la sesión (el stream confirma con `models`). */
+    setModel?(value: string): Promise<void>;
+    /** Contesta un pedido de permiso. `resolved: false` = ya no estaba abierto (se agotó el plazo). */
+    respondPermission?(id: string, optionId: string): Promise<{
+        resolved: boolean;
+    }>;
+    /** El hilo guardado, para pintarlo al montar (si la app no pasa `initialTurns`). */
+    history?(): Promise<Turn[]>;
+    /**
+     * ¿Se puede mandar un mensaje con un turno en vuelo (steer)? Default `true` (Ghosty). Con
+     * `false` (el servidor contesta 409) el composer no deja mandar hasta que el turno cierre.
+     */
+    steer?: boolean;
+}
+/** El servidor rechazó el encargo (sin saldo, sin cuenta, agente de otro). */
+export declare class PilotHttpError extends Error {
+    status: number;
+    /** El servidor pide cuenta (`X-Needs-Login`). */
+    needsLogin: boolean;
+    /** El `error` del cuerpo, si el servidor lo dio (`turn_busy`, `draining`…). */
+    code?: string;
+    constructor(message: string, status: number, needsLogin?: boolean);
+}

package/package.json

@@ -1,6 +1,93 @@
 {
   "name": "ghostykit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.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.",
+  "type": "module",
+  "main": "./dist/core/index.js",
+  "types": "./dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./transport": {
+      "types": "./dist/transport/index.d.ts",
+      "import": "./dist/transport/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./pointer": {
+      "types": "./dist/pointer/index.d.ts",
+      "import": "./dist/pointer/index.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./package.json": "./package.json",
+    "./fonts.css": "./dist/fonts.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && node scripts/build.mjs && tsc -p tsconfig.build.json && node scripts/build-css.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepack": "cp ../../LICENSE . && npm run build"
+  },
+  "peerDependencies": {
+    "@ghostystudio/pointer": ">=0.4.0",
+    "motion": ">=11",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "streamdown": ">=2.5.0 <3"
+  },
+  "peerDependenciesMeta": {
+    "@ghostystudio/pointer": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ghostystudio/pointer": "^0.4.0",
+    "@tailwindcss/cli": "^4.1.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "esbuild": "^0.25.0",
+    "lucide-react": "^1.44.0",
+    "motion": "^12.38.0",
+    "postcss": "^8.5.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "streamdown": "^2.7.0",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "copilot",
+    "chat",
+    "react",
+    "sse",
+    "acp",
+    "human-in-the-loop",
+    "ghosty"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blissito/ghostykit.git",
+    "directory": "packages/ghostykit"
+  },
+  "homepage": "https://github.com/blissito/ghostykit#readme"
+}