@yeaft/webchat-agent 0.1.561 → 0.1.563

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.561",
+  "version": "0.1.563",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/unify/engine.js

@@ -661,6 +661,13 @@ export class Engine {
       const toolCalls = [];
       let stopReason = 'end_turn';
       const totalUsage = { inputTokens: 0, outputTokens: 0 };
+      // task-344: capture redacted raw request / raw response for debug panel.
+      let rawRequest = null;
+      let rawResponse = null;
+      const captureRawExchange = (exchange) => {
+        if (exchange?.rawRequest) rawRequest = exchange.rawRequest;
+        if (exchange?.rawResponse) rawResponse = exchange.rawResponse;
+      };
 
       yield { type: 'turn_start', turnNumber };
 
@@ -678,6 +685,7 @@ export class Engine {
           maxTokens: this.#config.maxOutputTokens || 16384,
           effort: resolvedEffort,
           signal,
+          onRawExchange: captureRawExchange,
         })) {
           switch (event.type) {
             case 'text_delta':
@@ -730,6 +738,8 @@ export class Engine {
           latencyMs,
           ttfbMs,
           stopReason: 'error',
+          rawRequest,
+          rawResponse,
         };
 
         // ─── task-325a: abort short-circuit ────────────────
@@ -806,6 +816,8 @@ export class Engine {
         latencyMs,
         ttfbMs,
         stopReason,
+        rawRequest,
+        rawResponse,
       };
 
       // Append assistant message to conversation

package/unify/llm/adapter.js

@@ -101,6 +101,29 @@ export class LLMAbortError extends Error {
   }
 }
 
+// ─── task-344: Raw payload redaction helper ────────────────────
+
+/**
+ * Redact sensitive headers (API keys / bearer tokens) from a raw request
+ * shape before exposing it to debug UI. Always returns a NEW object — never
+ * mutates the input.
+ *
+ * @param {{ url: string, method: string, headers: object, body: any }} req
+ * @returns {{ url: string, method: string, headers: object, body: any }}
+ */
+export function redactRawRequest(req) {
+  if (!req || typeof req !== 'object') return req;
+  const headers = { ...(req.headers || {}) };
+  // Common auth headers
+  for (const k of Object.keys(headers)) {
+    const lower = k.toLowerCase();
+    if (lower === 'x-api-key' || lower === 'authorization' || lower === 'api-key') {
+      headers[k] = '***';
+    }
+  }
+  return { url: req.url, method: req.method, headers, body: req.body };
+}
+
 // ─── Base Class ────────────────────────────────────────────────
 
 /**

package/unify/llm/anthropic.js

@@ -13,6 +13,7 @@ import {
   LLMContextError,
   LLMServerError,
   LLMAbortError,
+  redactRawRequest,
 } from './adapter.js';
 import {
   normalizeEffort,
@@ -139,7 +140,7 @@ export class AnthropicAdapter extends LLMAdapter {
    * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', signal?: AbortSignal }} params
    * @returns {AsyncGenerator<import('./adapter.js').StreamEvent>}
    */
-  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, signal }) {
+  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, signal, onRawExchange }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -173,19 +174,40 @@ export class AnthropicAdapter extends LLMAdapter {
     const translatedTools = this.#translateTools(tools);
     if (translatedTools) body.tools = translatedTools;
 
-    const response = await fetch(`${this.#baseUrl}/v1/messages`, {
+    const url = `${this.#baseUrl}/v1/messages`;
+    const headers = {
+      'Content-Type': 'application/json',
+      'x-api-key': this.#apiKey,
+      'anthropic-version': API_VERSION,
+    };
+
+    // task-344: expose raw request (redacted) for debug panel.
+    const rawRequest = redactRawRequest({ url, method: 'POST', headers, body });
+
+    const response = await fetch(url, {
       method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-api-key': this.#apiKey,
-        'anthropic-version': API_VERSION,
-      },
+      headers,
       body: JSON.stringify(body),
       signal,
     });
 
     if (!response.ok) {
       const errorBody = await response.text();
+      // task-344: capture error response too, then throw.
+      if (onRawExchange) {
+        try {
+          onRawExchange({
+            rawRequest,
+            rawResponse: {
+              status: response.status,
+              headers: response.headers && typeof response.headers.entries === 'function'
+                ? Object.fromEntries(response.headers.entries())
+                : {},
+              body: errorBody,
+            },
+          });
+        } catch { /* ignore */ }
+      }
       throw this.#classifyError(response.status, errorBody);
     }
 
@@ -196,13 +218,21 @@ export class AnthropicAdapter extends LLMAdapter {
     let currentToolCallId = null;
     let currentToolName = null;
     let currentToolInput = '';
+    // task-344: accumulate raw SSE body for debug exposure.
+    let rawSseBody = '';
+    const responseHeaders = response.headers && typeof response.headers.entries === 'function'
+      ? Object.fromEntries(response.headers.entries())
+      : {};
+    const responseStatus = response.status;
 
     try {
       while (true) {
         const { done, value } = await reader.read();
         if (done) break;
 
-        buffer += decoder.decode(value, { stream: true });
+        const chunkText = decoder.decode(value, { stream: true });
+        buffer += chunkText;
+        rawSseBody += chunkText;
         const lines = buffer.split('\n');
         buffer = lines.pop() || ''; // Keep incomplete line
 
@@ -292,6 +322,20 @@ export class AnthropicAdapter extends LLMAdapter {
       }
     } finally {
       reader.releaseLock();
+      // task-344: emit raw exchange after stream completes (or errors).
+      if (onRawExchange) {
+        try {
+          onRawExchange({
+            rawRequest,
+            rawResponse: {
+              status: responseStatus,
+              headers: responseHeaders,
+              body: rawSseBody,
+              format: 'sse',
+            },
+          });
+        } catch { /* ignore */ }
+      }
     }
   }
 

package/unify/llm/chat-completions.js

@@ -27,6 +27,7 @@ import {
   LLMContextError,
   LLMServerError,
   LLMAbortError,
+  redactRawRequest,
 } from './adapter.js';
 import {
   normalizeEffort,
@@ -199,7 +200,7 @@ export class ChatCompletionsAdapter extends LLMAdapter {
    * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', extraBody?: object, signal?: AbortSignal }} params
    * @returns {AsyncGenerator<import('./adapter.js').StreamEvent>}
    */
-  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, extraBody, signal }) {
+  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, extraBody, signal, onRawExchange }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -231,18 +232,38 @@ export class ChatCompletionsAdapter extends LLMAdapter {
     // extraBody allows callers to pass through any additional/override parameters
     if (extraBody) Object.assign(body, extraBody);
 
-    const response = await fetch(`${this.#baseUrl}/chat/completions`, {
+    const url = `${this.#baseUrl}/chat/completions`;
+    const headers = {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${this.#apiKey}`,
+    };
+
+    // task-344: expose raw request (redacted) for debug panel.
+    const rawRequest = redactRawRequest({ url, method: 'POST', headers, body });
+
+    const response = await fetch(url, {
       method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${this.#apiKey}`,
-      },
+      headers,
       body: JSON.stringify(body),
       signal,
     });
 
     if (!response.ok) {
       const errorBody = await response.text();
+      if (onRawExchange) {
+        try {
+          onRawExchange({
+            rawRequest,
+            rawResponse: {
+              status: response.status,
+              headers: response.headers && typeof response.headers.entries === 'function'
+                ? Object.fromEntries(response.headers.entries())
+                : {},
+              body: errorBody,
+            },
+          });
+        } catch { /* ignore */ }
+      }
       throw this.#classifyError(response.status, errorBody);
     }
 
@@ -250,6 +271,12 @@ export class ChatCompletionsAdapter extends LLMAdapter {
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let buffer = '';
+    // task-344: accumulate raw SSE body + headers/status for debug exposure.
+    let rawSseBody = '';
+    const responseHeaders = response.headers && typeof response.headers.entries === 'function'
+      ? Object.fromEntries(response.headers.entries())
+      : {};
+    const responseStatus = response.status;
 
     // Tool call accumulation — Chat Completions sends tool args as fragments
     // keyed by index within the delta.tool_calls array
@@ -261,7 +288,9 @@ export class ChatCompletionsAdapter extends LLMAdapter {
         const { done, value } = await reader.read();
         if (done) break;
 
-        buffer += decoder.decode(value, { stream: true });
+        const chunkText = decoder.decode(value, { stream: true });
+        buffer += chunkText;
+        rawSseBody += chunkText;
         const lines = buffer.split('\n');
         buffer = lines.pop() || '';
 
@@ -345,6 +374,20 @@ export class ChatCompletionsAdapter extends LLMAdapter {
       }
     } finally {
       reader.releaseLock();
+      // task-344: emit raw exchange after stream completes.
+      if (onRawExchange) {
+        try {
+          onRawExchange({
+            rawRequest,
+            rawResponse: {
+              status: responseStatus,
+              headers: responseHeaders,
+              body: rawSseBody,
+              format: 'sse',
+            },
+          });
+        } catch { /* ignore */ }
+      }
     }
   }
 

package/unify/web-bridge.js

@@ -898,6 +898,9 @@ function handleEngineEvent(event, threadId, hctx) {
         latencyMs: event.latencyMs,
         ttfbMs: event.ttfbMs,
         stopReason: event.stopReason,
+        // task-344: forward raw request / response (redacted) to web debug panel.
+        rawRequest: event.rawRequest,
+        rawResponse: event.rawResponse,
         threadId,
       });
       break;