@pipeline-moe/client-core 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,57 @@
+# @pipeline-moe/client-core
+
+Framework-agnostic client library for a
+[pipeline-moe](https://github.com/DAXZEIT/pipeline-moe) server — the shared
+core behind both official clients (the
+[`pmoe` TUI](https://www.npmjs.com/package/@pipeline-moe/tui) and the bundled
+web UI).
+
+## What's inside
+
+- **Typed REST surface** — `createApi(apiBase)` wraps every server endpoint
+  (rooms, messages, lineup, presets, providers) with typed requests/responses.
+- **Pure SSE reducer** — `reduce(state, event) -> { state, effects }` turns the
+  server's event stream into room state deterministically; trivially unit
+  testable.
+- **Effectful room store** — `createRoomStore` binds the reducer to a live
+  `EventSource`, with subscribe/notify semantics that plug straight into
+  `useSyncExternalStore` (web) or any render loop (TUI).
+- **Injectable `EventSourceFactory`** — the browser uses the global
+  `EventSource`; Node clients inject one (e.g. the
+  [`eventsource`](https://www.npmjs.com/package/eventsource) package).
+
+Ships as plain ESM with type declarations — no framework, no build-tool
+assumptions.
+
+## Install
+
+```bash
+npm i @pipeline-moe/client-core
+```
+
+## Usage sketch
+
+```ts
+import { createRoomStore } from "@pipeline-moe/client-core"
+
+const store = createRoomStore({
+  apiBase: "http://localhost:5300",
+  roomId: "default",
+  // In the browser, omit eventSourceFactory (global EventSource is used).
+  // In Node, inject one built on the `eventsource` package:
+  eventSourceFactory: nodeEventSourceFactory,
+})
+
+const unsubscribe = store.subscribe(() => {
+  const state = store.getSnapshot() // roster, transcript, streaming buffers…
+})
+store.start() // loads the snapshot and opens the SSE stream
+```
+
+A Node factory is ~10 lines over the `EventSourceFactory` seam — see
+[`packages/tui/src/nodeEventSource.ts`](https://github.com/DAXZEIT/pipeline-moe/blob/main/packages/tui/src/nodeEventSource.ts)
+for the reference implementation.
+
+## License
+
+MIT — see the [repository](https://github.com/DAXZEIT/pipeline-moe).

package/dist/store.js

@@ -82,11 +82,13 @@ export function createRoomStore(opts) {
         applyEffects(result.effects);
     };
     // ── Lifecycle ─────────────────────────────────────────────────────────────
-    /** Load the REST snapshot and open the SSE stream. Idempotent-safe to call once. */
-    const start = () => {
-        // Clear transient fields before (re)loading — a reused store must not show a
-        // prior room's in-flight turn. Fresh stores are already clean; this is cheap.
-        set(resetTransient(state));
+    /**
+     * Fetch the full REST snapshot. Runs at start() and again on every SSE open:
+     * if the client came up before the server (or the server restarted), the
+     * initial fetches failed silently — re-running them on (re)connect is what
+     * lets providers/settings/conversations self-heal instead of staying empty.
+     */
+    const loadSnapshot = () => {
         rApi.transcript().then((m) => patch({ messages: m })).catch(() => { });
         rApi.workspace().then((w) => patch({ workspace: w })).catch(() => { });
         rApi.roster().then((r) => patch({ roster: r })).catch(() => { });
@@ -115,8 +117,18 @@ export function createRoomStore(opts) {
         }).catch(() => { });
         rApi.conversations().then((c) => patch({ conversations: c.list, currentConversationId: c.currentId })).catch(() => { });
         api.providers().then((d) => patch({ providers: d.providers, explicitlyEnabled: d.explicitlyEnabled })).catch(() => { });
+    };
+    /** Load the REST snapshot and open the SSE stream. Idempotent-safe to call once. */
+    const start = () => {
+        // Clear transient fields before (re)loading — a reused store must not show a
+        // prior room's in-flight turn. Fresh stores are already clean; this is cheap.
+        set(resetTransient(state));
+        loadSnapshot();
         conn = makeEventSource(sseUrl, {
-            onOpen: () => patch({ connected: true }),
+            onOpen: () => {
+                patch({ connected: true });
+                loadSnapshot();
+            },
             onError: () => patch({ connected: false }),
             onEvent,
         });
@@ -253,8 +265,10 @@ export function createRoomStore(opts) {
         addProvider: (name, key) => {
             api.addProvider(name, key).then(() => {
                 pushNotice(`Provider "${name}" configured.`);
-                // Refresh models so the dropdown picks up new models.
+                // Refresh models so the dropdown picks up new models, and the provider
+                // list so the configured flag flips without a reconnect.
                 api.models().catch(() => { });
+                api.providers().then((d) => patch({ providers: d.providers, explicitlyEnabled: d.explicitlyEnabled })).catch(() => { });
             }).catch(fail);
         },
         removeProvider: (name) => {
@@ -264,6 +278,7 @@ export function createRoomStore(opts) {
                     msg += ` Note: ${r.agentsUsing.join(", ")} may need model reassigned.`;
                 }
                 pushNotice(msg);
+                api.providers().then((d) => patch({ providers: d.providers, explicitlyEnabled: d.explicitlyEnabled })).catch(() => { });
             }).catch(fail);
         },
         loginProvider: (name) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipeline-moe/client-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
   "type": "module",
   "description": "Framework-agnostic client for a pipeline-moe server: typed REST surface, pure SSE reducer, and an effectful room store. Consumed by the web and terminal clients.",