pi-kot 0.1.0

package/dist/server/sse-bridge.d.ts

@@ -0,0 +1,31 @@
+import type { FastifyReply } from "fastify";
+import type { LiveSession, SSEClient } from "./session-registry.js";
+/**
+ * Serialize an event into SSE wire format.
+ * Adapted from pi-forge's sse-bridge.ts.
+ */
+export declare function serializeSSE(event: {
+    type: string;
+    [k: string]: unknown;
+}): string;
+/**
+ * Build a snapshot event from the current LiveSession state.
+ * Sent immediately on SSE connect so the browser can hydrate
+ * without a separate HTTP round-trip.
+ */
+export declare function buildSnapshot(live: LiveSession): {
+    type: "snapshot";
+    sessionId: string;
+    projectId: string;
+    messages: unknown[];
+    isStreaming: boolean;
+};
+/**
+ * Hijack the Fastify reply and turn it into a long-lived SSE stream
+ * attached to `live.clients`. Sends a snapshot immediately, forwards
+ * filtered AgentSessionEvents, and unregisters on socket close.
+ *
+ * Adapted from pi-forge's sse-bridge.ts createSSEClient.
+ */
+export declare function createSSEClient(reply: FastifyReply, live: LiveSession): SSEClient;
+//# sourceMappingURL=sse-bridge.d.ts.map

package/dist/server/sse-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-bridge.d.ts","sourceRoot":"","sources":["../src/sse-bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,MAAM,CAElF;AAuCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAQA;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,CAgEjF"}

package/dist/server/sse-bridge.js

@@ -0,0 +1,126 @@
+import { randomUUID } from "node:crypto";
+/**
+ * Serialize an event into SSE wire format.
+ * Adapted from pi-forge's sse-bridge.ts.
+ */
+export function serializeSSE(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+/**
+ * Allowed event types forwarded to browser clients.
+ * Unknown types are silently dropped for forwards-compatibility.
+ */
+const ALLOWED_EVENT_TYPES = new Set([
+    "agent_start",
+    "agent_end",
+    "turn_start",
+    "turn_end",
+    "message_start",
+    "message_update",
+    "message_end",
+    "tool_execution_start",
+    "tool_execution_update",
+    "tool_execution_end",
+    "tool_call",
+    "tool_result",
+    "queue_update",
+    "compaction_start",
+    "compaction_end",
+    "auto_retry_start",
+    "auto_retry_end",
+    "snapshot",
+    "ask_user_question",
+    "ask_user_question_cancelled",
+    // Extension UI bridge events
+    "extension_ui_select",
+    "extension_ui_confirm",
+    "extension_ui_input",
+    "extension_ui_notify",
+    "extension_ui_done",
+]);
+function isAllowedEvent(event) {
+    return ALLOWED_EVENT_TYPES.has(event.type);
+}
+/**
+ * Build a snapshot event from the current LiveSession state.
+ * Sent immediately on SSE connect so the browser can hydrate
+ * without a separate HTTP round-trip.
+ */
+export function buildSnapshot(live) {
+    return {
+        type: "snapshot",
+        sessionId: live.sessionId,
+        projectId: live.projectId,
+        messages: live.session.messages,
+        isStreaming: live.session.isStreaming,
+    };
+}
+/**
+ * Hijack the Fastify reply and turn it into a long-lived SSE stream
+ * attached to `live.clients`. Sends a snapshot immediately, forwards
+ * filtered AgentSessionEvents, and unregisters on socket close.
+ *
+ * Adapted from pi-forge's sse-bridge.ts createSSEClient.
+ */
+export function createSSEClient(reply, live) {
+    reply.hijack();
+    const raw = reply.raw;
+    let registeredClient;
+    let closed = false;
+    try {
+        raw.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache, no-transform",
+            Connection: "keep-alive",
+            "X-Accel-Buffering": "no",
+        });
+        const id = randomUUID();
+        const close = () => {
+            if (closed)
+                return;
+            closed = true;
+            if (registeredClient !== undefined)
+                live.clients.delete(registeredClient);
+            try {
+                raw.end();
+            }
+            catch {
+                // socket already torn down
+            }
+        };
+        const send = (event) => {
+            if (closed)
+                return;
+            if (!isAllowedEvent(event))
+                return;
+            try {
+                raw.write(serializeSSE(event));
+            }
+            catch {
+                close();
+            }
+        };
+        const client = { id, send, close };
+        registeredClient = client;
+        // Snapshot must be sent BEFORE adding to live.clients so events
+        // after the snapshot never arrive before it.
+        raw.write(serializeSSE(buildSnapshot(live)));
+        live.clients.add(client);
+        raw.on("close", close);
+        raw.on("error", close);
+        return client;
+    }
+    catch (err) {
+        closed = true;
+        if (registeredClient !== undefined)
+            live.clients.delete(registeredClient);
+        try {
+            raw.destroy();
+        }
+        catch {
+            // already destroyed
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=sse-bridge.js.map

package/dist/server/sse-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-bridge.js","sourceRoot":"","sources":["../src/sse-bridge.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "pi-kot",
+  "version": "0.1.0",
+  "description": "Browser UI for the pi coding agent — self-hosted React workbench with chat, file browser, terminal, git panel, and session tree.",
+  "keywords": [
+    "pi",
+    "coding-agent",
+    "ai",
+    "llm",
+    "agent",
+    "webui",
+    "fastify",
+    "react"
+  ],
+  "homepage": "https://github.com/YOUR_USERNAME/pi-kot#readme",
+  "bugs": {
+    "url": "https://github.com/YOUR_USERNAME/pi-kot/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_USERNAME/pi-kot.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "pi-kot": "bin/pi-kot.mjs"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@codemirror/autocomplete": "^6.20.3",
+    "@codemirror/basic-setup": "^0.20.0",
+    "@codemirror/lang-cpp": "^6.0.3",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-java": "^6.0.2",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/lang-rust": "^6.0.2",
+    "@codemirror/lang-yaml": "^6.1.3",
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/legacy-modes": "^6.5.3",
+    "@earendil-works/pi-ai": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "0.78.0",
+    "@fastify/cors": "^11.0.1",
+    "@fastify/multipart": "^10.0.0",
+    "@fastify/static": "^9.1.3",
+    "@fastify/swagger": "^9.7.0",
+    "@fastify/swagger-ui": "^6.0.0",
+    "@fastify/websocket": "^11.2.0",
+    "codemirror": "^6.0.2",
+    "fastify": "^5.3.2",
+    "jsonwebtoken": "^9.0.3",
+    "node-pty": "^1.1.0",
+    "tar": "^7.5.15"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}