mcp-tenant-lib 0.1.0 → 0.1.2

package/dist/tenant.d.ts

@@ -36,6 +36,26 @@ export declare class Tenant<TSchema, TValues> {
     schema: TSchema;
     store: Store<TValues>;
     submitBus: EventEmitter;
+    /**
+     * Whether some caller currently has a `submitBus.once('submit', ...)`
+     * listener registered — i.e. wait_for_submit / define_form({wait:true})
+     * is actively blocked on this tenant right now. Tracked via submitBus's
+     * own newListener/removeListener events (see constructor) rather than a
+     * manual flag, so it can never drift from the real listener count.
+     * Broadcast to the browser as a 'waiting' WS message so the UI can show
+     * whether anyone is listening, without implying Submit is meaningless
+     * when nobody currently is (see `submitted`).
+     */
+    waiting: boolean;
+    /**
+     * Whether the user has clicked Submit at least once since the form was
+     * last (re)defined. Set unconditionally on the 'submit' WS message,
+     * independent of `waiting` — the user can fill in and submit a form
+     * with no agent currently waiting (e.g. it was defined with wait:false,
+     * or the agent's turn ended), and a later wait_for_submit call or
+     * list_fields read should be able to see that they're done.
+     */
+    submitted: boolean;
     wsClients: Set<WebSocket>;
     connections: Map<string, TenantConnection>;
     lastActivityAt: number;

package/dist/tenant.js

@@ -39,6 +39,26 @@ export class Tenant {
     schema;
     store;
     submitBus;
+    /**
+     * Whether some caller currently has a `submitBus.once('submit', ...)`
+     * listener registered — i.e. wait_for_submit / define_form({wait:true})
+     * is actively blocked on this tenant right now. Tracked via submitBus's
+     * own newListener/removeListener events (see constructor) rather than a
+     * manual flag, so it can never drift from the real listener count.
+     * Broadcast to the browser as a 'waiting' WS message so the UI can show
+     * whether anyone is listening, without implying Submit is meaningless
+     * when nobody currently is (see `submitted`).
+     */
+    waiting = false;
+    /**
+     * Whether the user has clicked Submit at least once since the form was
+     * last (re)defined. Set unconditionally on the 'submit' WS message,
+     * independent of `waiting` — the user can fill in and submit a form
+     * with no agent currently waiting (e.g. it was defined with wait:false,
+     * or the agent's turn ended), and a later wait_for_submit call or
+     * list_fields read should be able to see that they're done.
+     */
+    submitted = false;
     wsClients;
     connections = new Map();
     #legacyManifest;
@@ -85,6 +105,16 @@ export class Tenant {
         this.store = new Store(initialValues);
         this.submitBus = new EventEmitter();
         this.submitBus.setMaxListeners(0);
+        this.submitBus.on('newListener', (event) => {
+            if (event !== 'submit')
+                return;
+            queueMicrotask(() => this.#syncWaiting());
+        });
+        this.submitBus.on('removeListener', (event) => {
+            if (event !== 'submit')
+                return;
+            this.#syncWaiting();
+        });
         this.wsClients = new Set();
         this.lastActivityAt = Date.now();
         this.store.onChange((field, value) => this.broadcastUpdate(field, value));
@@ -252,11 +282,12 @@ export class Tenant {
         this.store.dispose();
         this.schema = schema;
         this.store = new Store(values);
+        this.submitted = false;
         this.store.onChange((field, value) => this.broadcastUpdate(field, value));
         this.broadcastReinit();
     }
     broadcastReinit() {
-        const payload = JSON.stringify({ type: 'reinit', schema: this.schema, state: this.store.snapshot() });
+        const payload = JSON.stringify({ type: 'reinit', schema: this.schema, state: this.store.snapshot(), waiting: this.waiting, submitted: this.submitted });
         for (const client of this.wsClients) {
             if (client.readyState === client.OPEN)
                 client.send(payload);
@@ -269,6 +300,17 @@ export class Tenant {
                 client.send(payload);
         }
     }
+    #syncWaiting() {
+        const nowWaiting = this.submitBus.listenerCount('submit') > 0;
+        if (nowWaiting === this.waiting)
+            return;
+        this.waiting = nowWaiting;
+        const payload = JSON.stringify({ type: 'waiting', waiting: this.waiting });
+        for (const client of this.wsClients) {
+            if (client.readyState === client.OPEN)
+                client.send(payload);
+        }
+    }
     dispose() {
         this.submitBus.emit('submit', { __interrupted: true, __disposed: true, ...this.store.snapshot() });
         this.store.dispose();

package/dist/types.d.ts

@@ -7,10 +7,15 @@ export type ServerMessage<TSchema = unknown, TValues = unknown> = {
     type: 'init' | 'reinit';
     schema: TSchema;
     state: TValues;
+    waiting: boolean;
+    submitted: boolean;
 } | {
     type: 'update';
     field: string;
     value: unknown;
+} | {
+    type: 'waiting';
+    waiting: boolean;
 } | CallMessage;
 export interface SetMessage {
     type: 'set';

package/dist/ws.js

@@ -51,7 +51,7 @@ export function attachWebSocketServer(httpServer, port, initialSchema, initialVa
             if (state)
                 state.isAlive = true;
         });
-        ws.send(JSON.stringify({ type: 'init', schema: t.schema, state: t.store.snapshot() }));
+        ws.send(JSON.stringify({ type: 'init', schema: t.schema, state: t.store.snapshot(), waiting: t.waiting, submitted: t.submitted }));
         ws.on('message', (raw) => {
             t.touch();
             let msg;
@@ -65,6 +65,7 @@ export function attachWebSocketServer(httpServer, port, initialSchema, initialVa
                 t.store.set(msg.field, msg.value);
             }
             if (msg.type === 'submit') {
+                t.submitted = true;
                 t.submitBus.emit('submit', { __interrupted: false, ...t.store.snapshot() });
             }
             if (msg.type === 'interrupt') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-tenant-lib",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "Generic tenant/session bookkeeping + MCP wiring, reusable across projects.",
   "repository": {