@volter/teams 0.1.72 → 0.1.73

package/browser-channel.d.ts

@@ -46,11 +46,17 @@ export type BrowserTurnAnswer =
   | { code: 0; turn_id?: string; door?: 'runtime' | 'pane' | 'waiting'; text?: string }
   | { code: number; text?: string };
 
+/** The accepted stream ended without a valid receipt; delivery may have occurred. */
+export declare class TurnDeliveryUnconfirmedError extends Error {
+  constructor(message: string);
+}
+
 /**
  * One line typed into the channel's session as its user's own turn; rejects when the machine refuses the stream.
  * `turnKey`: one per typed line, reused on retry, so the machine types the line once.
  * Receipt waits time out after thirty seconds. Cancellation stops waiting; it
- * does not undo delivery. Reuse the same key when retrying an uncertain receipt.
+ * does not undo delivery. After acceptance, a lost, invalid or cancelled receipt
+ * rejects with TurnDeliveryUnconfirmedError. Reuse the same key when retrying it.
  */
 export function sendBrowserTurn(channel: BrowserChannel, text: string, options?: { turnKey?: string; signal?: AbortSignal }): Promise<BrowserTurnAnswer>;
 

package/browser-channel.mjs

@@ -167,6 +167,11 @@ export function openBrowserSession({ origin, teamId, sessionId, token }, { WebSo
   return connectBrowserChannel(socket, channel, `could not reach session ${sessionId} through ${origin}`, 'the server closed the session channel');
 }
 
+/** A turn was accepted by its stream, but its delivery receipt was not obtained. */
+export class TurnDeliveryUnconfirmedError extends Error {
+  constructor(message) { super(message); this.name = 'TurnDeliveryUnconfirmedError'; }
+}
+
 /**
  * One line typed into the channel's session as its user's own turn. Resolves with the machine's answer:
  * `{ code: 0, turn_id, door: 'runtime' | 'pane' | 'waiting' }` (waiting: filed, typed when the session's composer
@@ -189,13 +194,19 @@ export async function sendBrowserTurn(channel, text, { turnKey, signal } = {}) {
       // receipt as success, or imply that a typed turn was rolled back.
       stream.close(error.message);
     };
-    const cancelled = () => fail(Object.assign(new Error('Turn delivery wait cancelled'), { name: 'AbortError' }));
-    const timer = setTimeout(() => fail(new Error('Turn delivery acknowledgement timed out')), 30_000);
-    const data = chunk => { answer += chunk; if (answer.length > 256_000) fail(new Error('Turn delivery receipt too large')); };
-    const closed = () => {
+    const cancelled = () => fail(new TurnDeliveryUnconfirmedError('Turn delivery wait cancelled'));
+    const timer = setTimeout(() => fail(new TurnDeliveryUnconfirmedError('Turn delivery acknowledgement timed out')), 30_000);
+    const data = chunk => { answer += chunk; if (answer.length > 256_000) fail(new TurnDeliveryUnconfirmedError('Turn delivery receipt too large')); };
+    const closed = reason => {
       if (settled) return;
       settled = true; cleanup();
-      try { resolve(JSON.parse(answer)); } catch { resolve({ code: 1, text: answer || 'no answer from the machine' }); }
+      // Only an actual machine answer establishes delivery or refusal. A socket
+      // closing, an incomplete JSON frame or an empty receipt cannot prove either.
+      try {
+        const receipt = JSON.parse(answer);
+        if (!receipt || !Number.isInteger(receipt.code)) throw new Error('Invalid receipt');
+        resolve(receipt);
+      } catch { reject(new TurnDeliveryUnconfirmedError(reason || 'No complete delivery receipt from the machine')); }
     };
     stream.on('data', data);
     if (!settled) stream.on('close', closed);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.72",
+  "version": "0.1.73",
   "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",