@mono-agent/web 0.20.11 → 0.21.0

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { type WebTheme } from "./contracts.js";
+import { type WebEvent, type WebTheme } from "./contracts.js";
 import { type CreateWebServiceOptions } from "./service.js";
 export declare const DEFAULT_WEB_HOST = "0.0.0.0";
 export declare const DEFAULT_WEB_PORT = 5050;
@@ -6,6 +6,8 @@ export interface StartWebServerOptions extends CreateWebServiceOptions {
     readonly host?: string;
     readonly port?: number;
     readonly theme?: WebTheme;
+    /** Operator-chosen console label for the PWA manifest, tab title, and rail brand. Defaults to the machine hostname. */
+    readonly name?: string;
     readonly staticDir?: string;
     /** Exact additional DNS hostnames accepted at the browser boundary (for example this node's Tailscale DNSName). */
     readonly allowedHosts?: readonly string[];
@@ -21,4 +23,43 @@ export interface WebServerHandle {
 }
 export declare function startWebServer(options?: StartWebServerOptions): Promise<WebServerHandle>;
 export declare function isAllowedWebHostname(hostname: string, configuredHost: string, machineHostname?: string, additionalHosts?: readonly string[]): boolean;
+/**
+ * One connection's view of the event stream: which frames it is served, and in
+ * what form.
+ *
+ * A console names the conversation it is looking at with `?thread=`. It is
+ * served EVERYTHING about that conversation unthrottled -- `message.delta`
+ * frames carrying what each write changed, and the `message.changed` hints the
+ * delta path emits when it declines (a delta bigger than the message, a
+ * reconciliation that describes nothing), because both are things it must act
+ * on. Anything about any OTHER conversation is reduced to a
+ * `message.changed { messageId, updatedAt }` and rate-limited to one per
+ * conversation per {@link DELTA_HINT_INTERVAL_MS}, dropped rather than queued:
+ * a console is not rendering it.
+ *
+ * A console that named NO conversation is not telling this stream which
+ * conversation it is looking at, so it keeps every reconciliation hint and is
+ * rate-limited only on what the delta path produces -- downgraded deltas and
+ * the declines above -- which is the write-rate traffic the limit exists for. A
+ * turn's `thread.changed` still follows every finish unthrottled, so a dropped
+ * frame never leaves a settled conversation stale.
+ *
+ * Every other event type passes through untouched. `Last-Event-ID` is ignored
+ * and nothing is replayed: this is state invalidation, not a log. A
+ * reconnecting console bootstraps, and `ready` means resync the conversation it
+ * has open.
+ *
+ * Lives outside the route because neither of the two things that matter is
+ * observable through an HTTP fixture: the rate limit is a clock decision, and a
+ * frame this connection cannot serialize or write must CLOSE it rather than
+ * leave a socket that reads live and receives nothing.
+ */
+export declare function createWebEventDispatch(options: {
+    /** The conversation this connection named, if it named one. */
+    readonly subscribed?: string;
+    readonly write: (event: WebEvent) => boolean;
+    readonly close: () => void;
+    readonly onFailure?: (error: unknown) => void;
+    readonly now?: () => number;
+}): (event: WebEvent) => boolean;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqBA,OAAO,EAcL,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAYxB,OAAO,EAAc,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAExE,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAWrC,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mHAAmH;IACnH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CAomBlG;AAmOD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,eAAe,SAAmB,EAClC,eAAe,GAAE,SAAS,MAAM,EAAO,GACtC,OAAO,CAYT"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA2BA,OAAO,EAcL,KAAK,QAAQ,EAKb,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAkBxB,OAAO,EAAc,KAAK,uBAAuB,EAA2B,MAAM,cAAc,CAAC;AAEjG,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAwCrC,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,uHAAuH;IACvH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mHAAmH;IACnH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CAk7BlG;AAgRD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,eAAe,SAAmB,EAClC,eAAe,GAAE,SAAS,MAAM,EAAO,GACtC,OAAO,CAYT;AA+SD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAmE/B"}