@tiflis-io/tiflis-code-workstation 0.3.12 → 0.3.13

package/dist/main.js

@@ -127,7 +127,11 @@ var EnvSchema = z.object({
   // Terminal Configuration
   // ─────────────────────────────────────────────────────────────
   /** Terminal output buffer size (number of messages, in-memory only, does not survive restarts) */
-  TERMINAL_OUTPUT_BUFFER_SIZE: z.coerce.number().default(100),
+  TERMINAL_OUTPUT_BUFFER_SIZE: z.coerce.number().default(1e4),
+  /** Terminal output batch interval in milliseconds (how long to wait before flushing) */
+  TERMINAL_BATCH_INTERVAL_MS: z.coerce.number().default(64),
+  /** Terminal output batch max size in bytes (flush immediately when exceeded) */
+  TERMINAL_BATCH_MAX_SIZE: z.coerce.number().default(4096),
   // Legacy (fallback for STT/TTS if specific keys not set)
   OPENAI_API_KEY: z.string().optional(),
   // ─────────────────────────────────────────────────────────────
@@ -283,7 +287,7 @@ var SESSION_CONFIG = {
   /** Data retention period for terminated sessions (30 days in ms) */
   DATA_RETENTION_MS: 30 * 24 * 60 * 60 * 1e3,
   /** Default terminal output buffer size (number of messages) */
-  DEFAULT_TERMINAL_OUTPUT_BUFFER_SIZE: 100
+  DEFAULT_TERMINAL_OUTPUT_BUFFER_SIZE: 1e4
 };
 var AGENT_COMMANDS = {
   cursor: {
@@ -2588,15 +2592,12 @@ var TerminalSession = class extends Session {
     return this._masterDeviceId;
   }
   /**
-   * Sets the master device ID. Only sets if not already set (first subscriber wins).
-   * @returns true if this device became master, false if master was already set
+   * Sets the master device ID. Always overrides the current master (new subscriber wins).
+   * @returns true (new subscriber always becomes master)
    */
   setMaster(deviceId) {
-    if (this._masterDeviceId === null) {
-      this._masterDeviceId = deviceId;
-      return true;
-    }
-    return this._masterDeviceId === deviceId;
+    this._masterDeviceId = deviceId;
+    return true;
   }
   /**
    * Checks if the given device is the master for this session.
@@ -2917,6 +2918,75 @@ var PtyManager = class {
   }
 };
 
+// src/infrastructure/terminal/terminal-output-batcher.ts
+var TerminalOutputBatcher = class {
+  buffer = "";
+  timeout = null;
+  lastActivityTime = Date.now();
+  outputRate = 0;
+  // Bytes/second estimate (exponential moving average)
+  batchIntervalMs;
+  maxBatchSize;
+  onFlush;
+  constructor(config2) {
+    this.batchIntervalMs = config2.batchIntervalMs;
+    this.maxBatchSize = config2.maxBatchSize;
+    this.onFlush = config2.onFlush;
+  }
+  /**
+   * Appends data to the batch buffer.
+   * Triggers flush based on size threshold or adaptive timeout.
+   */
+  append(chunk) {
+    this.buffer += chunk;
+    const now = Date.now();
+    const elapsed = Math.max(now - this.lastActivityTime, 1);
+    const instantRate = chunk.length / elapsed * 1e3;
+    this.outputRate = this.outputRate * 0.7 + instantRate * 0.3;
+    this.lastActivityTime = now;
+    if (this.buffer.length >= this.maxBatchSize) {
+      this.flush();
+      return;
+    }
+    if (this.timeout === null) {
+      const adaptiveInterval = this.outputRate > 1e3 ? this.batchIntervalMs : Math.min(8, this.batchIntervalMs);
+      this.timeout = setTimeout(() => this.flush(), adaptiveInterval);
+    }
+  }
+  /**
+   * Immediately flushes the buffer, invoking the onFlush callback.
+   */
+  flush() {
+    if (this.timeout !== null) {
+      clearTimeout(this.timeout);
+      this.timeout = null;
+    }
+    if (this.buffer.length > 0) {
+      const data = this.buffer;
+      this.buffer = "";
+      this.onFlush(data);
+    }
+  }
+  /**
+   * Disposes the batcher, flushing any pending data.
+   */
+  dispose() {
+    this.flush();
+  }
+  /**
+   * Returns current buffer size (for debugging/monitoring).
+   */
+  get pendingSize() {
+    return this.buffer.length;
+  }
+  /**
+   * Returns estimated output rate in bytes/second.
+   */
+  get currentOutputRate() {
+    return this.outputRate;
+  }
+};
+
 // src/infrastructure/agents/agent-session-manager.ts
 import { EventEmitter as EventEmitter2 } from "events";
 import { randomUUID as randomUUID2 } from "crypto";
@@ -9461,7 +9531,7 @@ async function bootstrap() {
       let currentStreamingBlocks;
       if (supervisorIsExecuting) {
         const blocks = supervisorMessageAccumulator.get();
-        if (blocks && blocks.length > 0) {
+        if (blocks.length > 0) {
           currentStreamingBlocks = blocks;
         }
       }
@@ -10540,7 +10610,7 @@ async function bootstrap() {
           let streamingMessageId;
           if (isExecuting && !beforeSequence) {
             const blocks = supervisorMessageAccumulator.get();
-            if (blocks && blocks.length > 0) {
+            if (blocks.length > 0) {
               currentStreamingBlocks = blocks;
               streamingMessageId = supervisorMessageAccumulator.getStreamingMessageId() ?? void 0;
             }
@@ -11153,23 +11223,35 @@ async function bootstrap() {
       }
     };
     broadcaster.broadcastToAll(JSON.stringify(broadcastMessage));
+    const batcher = new TerminalOutputBatcher({
+      batchIntervalMs: env.TERMINAL_BATCH_INTERVAL_MS,
+      maxBatchSize: env.TERMINAL_BATCH_MAX_SIZE,
+      onFlush: (batchedData) => {
+        const outputMessage = session.addOutputToBuffer(batchedData);
+        const outputEvent = {
+          type: "session.output",
+          session_id: sessionId.value,
+          payload: {
+            content_type: "terminal",
+            content: batchedData,
+            timestamp: outputMessage.timestamp,
+            sequence: outputMessage.sequence
+          }
+        };
+        broadcaster.broadcastToSubscribers(
+          sessionId.value,
+          JSON.stringify(outputEvent)
+        );
+      }
+    });
     session.onOutput((data) => {
-      const outputMessage = session.addOutputToBuffer(data);
-      const outputEvent = {
-        type: "session.output",
-        session_id: sessionId.value,
-        payload: {
-          content_type: "terminal",
-          content: data,
-          timestamp: outputMessage.timestamp,
-          sequence: outputMessage.sequence
-        }
-      };
-      broadcaster.broadcastToSubscribers(
-        sessionId.value,
-        JSON.stringify(outputEvent)
-      );
+      batcher.append(data);
     });
+    const originalTerminate = session.terminate.bind(session);
+    session.terminate = async () => {
+      batcher.dispose();
+      return originalTerminate();
+    };
   });
   if (env.MOCK_MODE) {
     const terminalSession = await sessionManager.createSession({
@@ -11401,6 +11483,14 @@ bootstrap().catch((error) => {
  * @copyright 2025 Roman Barinov <rbarinov@gmail.com>
  * @license FSL-1.1-NC
  */
+/**
+ * @file terminal-output-batcher.ts
+ * @copyright 2025 Roman Barinov <rbarinov@gmail.com>
+ * @license FSL-1.1-NC
+ *
+ * Batches terminal output chunks to reduce message frequency and improve performance.
+ * Uses adaptive batching based on output rate for optimal responsiveness.
+ */
 /**
  * @file headless-agent-executor.ts
  * @copyright 2025 Roman Barinov <rbarinov@gmail.com>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiflis-io/tiflis-code-workstation",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "Workstation server for tiflis-code - manages agent sessions and terminal access",
   "author": "Roman Barinov <rbarinov@gmail.com>",
   "license": "FSL-1.1-NC",