@volter/teams 0.1.40 → 0.1.42

package/browser-channel.d.ts

@@ -46,8 +46,11 @@ export type BrowserTurnAnswer =
   | { code: 0; turn_id?: string; door?: 'runtime' | 'pane' | 'waiting'; text?: string }
   | { code: number; text?: string };
 
-/** One line typed into the channel's session as its user's own turn; rejects when the machine refuses the stream. */
-export function sendBrowserTurn(channel: BrowserChannel, text: string): Promise<BrowserTurnAnswer>;
+/**
+ * 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.
+ */
+export function sendBrowserTurn(channel: BrowserChannel, text: string, options?: { turnKey?: string }): Promise<BrowserTurnAnswer>;
 
 /** A pane's terminal stream. Events: `data` (text), `hello`, `notice`, `error-message`, `close`. */
 export interface BrowserPane extends ChannelEvents {

package/browser-channel.mjs

@@ -155,9 +155,11 @@ export function openBrowserSession({ origin, teamId, sessionId, token }, { WebSo
  * 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
  * is free), or `{ code, text }` when it was not delivered; rejects when the machine refuses the stream.
+ * `turnKey`: one key per line the person typed, reused when they retry it, so a line the machine took after its
+ * first send was given up on is not typed twice (a machine of door vocabulary 3 or later keeps each key once).
  */
-export async function sendBrowserTurn(channel, text) {
-  const stream = await channel.open('mail', { request: { op: 'turn', text } });
+export async function sendBrowserTurn(channel, text, { turnKey } = {}) {
+  const stream = await channel.open('mail', { request: { op: 'turn', text, ...(turnKey ? { turn_key: String(turnKey) } : {}) } });
   return new Promise((resolve) => {
     let answer = '';
     stream.on('data', (chunk) => { answer += chunk; });

package/channel.mjs

@@ -265,8 +265,8 @@ export class Channel extends EventEmitter {
     return this;
   }
 
-  /** Open a named stream; resolves once the peer accepts it, rejects if refused. */
-  open(name, params = {}) {
+  /** Open a named stream; resolves once the peer accepts it, rejects if refused or unanswered within `timeoutMs`. */
+  open(name, params = {}, { timeoutMs = HANDSHAKE_TIMEOUT_MS } = {}) {
     // A closed connection refuses at once rather than waiting out the handshake bound.
     if (this.closed) return Promise.reject(new Error(`${name} refused: connection closed`));
     const id = this._nextStream;
@@ -278,8 +278,8 @@ export class Channel extends EventEmitter {
       const timer = setTimeout(() => {
         stream.off('opened', onOpened); stream.off('close', onClosed);
         this._streams.delete(id);
-        reject(new Error(`${name} did not open within ${HANDSHAKE_TIMEOUT_MS} ms`));
-      }, HANDSHAKE_TIMEOUT_MS);
+        reject(new Error(`${name} did not open within ${timeoutMs} ms`));
+      }, timeoutMs);
       timer.unref?.();
       const onOpened = () => { clearTimeout(timer); stream.off('close', onClosed); resolve(stream); };
       const onClosed = (reason) => { clearTimeout(timer); stream.off('opened', onOpened); reject(new Error(`${name} refused: ${reason ?? 'closed'}`)); };

package/package.json

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