@volter/teams 0.1.1 → 0.1.2

package/admission.mjs

@@ -4,7 +4,8 @@
 // { id, caps, targets } rows from the caller's machine grants (design §11).
 //
 // Targets: `<kind>:<name>` for the kinds a product serves on this machine
-// (the harness: `pane:<contextKey>`, `runtime:<id>`, `root:<path>`, `port:<pane>/<n>`),
+// (the harness: `pane:<contextKey>`, `runtime:<id>`, `root:<path>`, `port:<pane>/<n>`,
+// `mail:<address>` for one session's mailbox),
 // `<kind>:*` for every target of one kind, or `*` (operate and view only).
 // `root:<path>` covers the path and everything under it.
 

package/channel.mjs

@@ -182,10 +182,17 @@ export class Channel extends EventEmitter {
     this._streams = new Map();
     this._nextStream = initiator ? 1 : 2;
     this.closed = false;
+    // A broken channel ends every open stream with the reason, so each caller's
+    // request fails with it; 'error' is emitted only to someone listening for it,
+    // never as an uncaught exception that takes the process down.
+    const failed = (error) => {
+      this.error ??= error;
+      if (this.listenerCount('error') > 0) this.emit('error', error);
+    };
     frameReader(
       socket,
       (frame) => this._onEnvelope(JSON.parse(frame.toString('utf8'))),
-      (error) => this.emit('error', error),
+      failed,
     );
     // The hello left the socket paused with any early frames unshifted; our reader is on now.
     socket.resume();
@@ -196,12 +203,12 @@ export class Channel extends EventEmitter {
       this.closed = true;
       for (const stream of this._streams.values()) {
         stream.closed = true;
-        stream._deliver('close', 'connection closed');
+        stream._deliver('close', this.error ? `connection closed: ${this.error.message}` : 'connection closed');
       }
       this._streams.clear();
       this.emit('close');
     });
-    socket.on('error', (error) => this.emit('error', error));
+    socket.on('error', failed);
   }
 
   _onEnvelope(envelope) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Volter Teams, the neutral team plane: machine identity and daemon core, the local door and server link, admission from machine grants, product doors, and the Teams server's neutral routes (company RFC 0008).",
   "license": "MIT",

package/server/machine-link.mjs

@@ -19,8 +19,8 @@ import { delegatedAccessOf, delegatedPrincipal, looksDelegated } from './delegat
 
 const LINK_PROTOCOL = 'supercode-machine-link.v1';
 const CHANNEL_PROTOCOL = 'supercode-machine-channel.v1';
-/** The machine daemon's door vocabulary: operate (operator: harness.v1 and launch) and the participant caps its doors check. */
-const CAPS = new Set(['operate', 'view', 'observe', 'interact', 'control', 'files', 'ports']);
+/** The machine daemon's door vocabulary: operate (operator: harness.v1 and launch) and the participant caps its doors check. `mail` writes one message into a session there (`mail:*`, or `mail:<address>` for one session). */
+const CAPS = new Set(['operate', 'view', 'observe', 'interact', 'control', 'files', 'ports', 'mail']);
 // A target is `*` or `<kind>:<name>`. The server checks shape only: which kinds a machine
 // serves is the daemon's business, and a grant on a kind it does not serve covers nothing.
 const TARGET = /^(\*|root:(\*|\/[^\x00-\x1f]{0,4095})|(?!root:)[a-z][a-z0-9-]{0,31}:[^\x00-\x1f]{1,4096})$/;