@nifrajs/agent-app 3.3.0 → 4.0.0

package/src/client.ts

@@ -40,6 +40,7 @@ export const AGENT_APP_FEATURES = [
   "inbox",
   "reload",
   "resume",
+  "run-studio",
   "workflows",
 ] as const
 
@@ -188,7 +189,12 @@ export class AgentAppClient {
       ...(options?.signal ? { signal: options.signal } : {}),
     })
     for await (const event of stream) {
-      for (const view of buffer.offer(toEventView(event))) yield view
+      for (const view of buffer.offer(toEventView(event))) {
+        // The host numbers events per session, so the next turn's buffer starts after this one.
+        if (this.currentSession !== undefined && view.seq > this.currentSession.lastSeq)
+          this.currentSession = Object.freeze({ ...this.currentSession, lastSeq: view.seq })
+        yield view
+      }
     }
   }
 

package/src/index.ts

@@ -48,6 +48,11 @@ export {
   OrderedEventBuffer,
   type RegistryCapabilityView,
   type RepairRequiredView,
+  type ReviewView,
+  type ReviewViewCheck,
+  type ReviewViewEvidence,
+  type ReviewViewFinding,
+  type ReviewViewStatus,
   type RunStudioNodeState,
   type RunStudioNodeView,
   type RunStudioView,
@@ -66,6 +71,7 @@ export {
   toFaultInjectionViews,
   toHandoffView,
   toRegistryCapabilityView,
+  toReviewView,
   toRunStudioView,
   toRunView,
   toSessionView,

package/src/transport.ts

@@ -8,8 +8,14 @@
  * is never copied into a result, an error, or a log line.
  */
 
-import type { AgentEvent } from "@nifrajs/agent-protocol"
-import { isAgentEvent } from "@nifrajs/agent-protocol"
+import {
+  type AgentEvent,
+  assertTransportByteLimit,
+  isAgentEvent,
+  MAX_TRANSPORT_BYTES,
+  parseTransportContentLength,
+  readBoundedTransportBytes,
+} from "@nifrajs/agent-protocol"
 
 /** One RPC-style call. `params` is JSON-serializable; `signal` cancels the in-flight request. */
 export interface AgentTransportRequest {
@@ -41,6 +47,8 @@ export interface HttpAgentTransportOptions {
   readonly authorize?: AuthProvider
   /** Injectable fetch for tests and non-DOM hosts. Defaults to the ambient `fetch`. */
   readonly fetch?: typeof fetch
+  /** Maximum response bytes retained by command and SSE reads. Defaults to 8 MiB. */
+  readonly maxResponseBytes?: number
 }
 
 /** Thrown only for transport-level faults (network, malformed body). Carries no credential. */
@@ -59,6 +67,7 @@ export class HttpAgentTransport implements AgentTransport {
   private readonly url: string
   private readonly authorize: AuthProvider | undefined
   private readonly fetchImpl: typeof fetch
+  private readonly maxResponseBytes: number
 
   constructor(options: HttpAgentTransportOptions) {
     if (typeof options.endpoint !== "string" || options.endpoint.length === 0)
@@ -68,6 +77,8 @@ export class HttpAgentTransport implements AgentTransport {
     const bound = options.fetch ?? globalThis.fetch
     if (typeof bound !== "function") throw new TypeError("agent transport: no fetch available")
     this.fetchImpl = bound.bind(globalThis)
+    this.maxResponseBytes = options.maxResponseBytes ?? DEFAULT_MAX_RESPONSE_BYTES
+    assertResponseLimit(this.maxResponseBytes)
   }
 
   private async headers(accept: string): Promise<Headers> {
@@ -90,7 +101,7 @@ export class HttpAgentTransport implements AgentTransport {
     } catch (error) {
       throw new AgentTransportError(request.method, describe(error))
     }
-    const text = await response.text()
+    const text = await readResponseText(response, request.method, this.maxResponseBytes)
     if (!response.ok)
       return { ok: false, status: response.status, error: text || response.statusText }
     if (text.length === 0) return { ok: true, status: response.status, value: undefined as T }
@@ -114,11 +125,11 @@ export class HttpAgentTransport implements AgentTransport {
       throw new AgentTransportError(request.method, describe(error))
     }
     if (!response.ok) {
-      const text = await response.text()
+      const text = await readResponseText(response, request.method, this.maxResponseBytes)
       throw new AgentTransportError(request.method, text || `status ${response.status}`)
     }
     if (response.body === null) return
-    yield* parseEventStream(response.body, request.method)
+    yield* parseEventStream(response.body, request.method, this.maxResponseBytes)
   }
 }
 
@@ -126,34 +137,76 @@ export class HttpAgentTransport implements AgentTransport {
 export async function* parseEventStream(
   body: ReadableStream<Uint8Array>,
   method: string,
+  maxFrameBytes = DEFAULT_MAX_RESPONSE_BYTES,
 ): AsyncIterable<AgentEvent> {
+  assertResponseLimit(maxFrameBytes)
   const reader = body.getReader()
   const decoder = new TextDecoder()
+  const encoder = new TextEncoder()
   let buffer = ""
+  let reachedEof = false
   try {
     for (;;) {
       const chunk = await reader.read()
-      if (chunk.done) break
+      if (chunk.done) {
+        reachedEof = true
+        buffer += decoder.decode()
+        let boundary = sseBoundary(buffer)
+        while (boundary !== undefined) {
+          const frame = buffer.slice(0, boundary.index)
+          buffer = buffer.slice(boundary.end)
+          if (encoder.encode(frame).byteLength > maxFrameBytes)
+            throw new AgentTransportError(method, "SSE frame exceeds the configured response limit")
+          const event = frameToEvent(frame)
+          if (event !== undefined) yield event
+          boundary = sseBoundary(buffer)
+        }
+        if (encoder.encode(buffer).byteLength > maxFrameBytes)
+          throw new AgentTransportError(method, "SSE frame exceeds the configured response limit")
+        const event = frameToEvent(buffer)
+        if (event !== undefined) yield event
+        break
+      }
       buffer += decoder.decode(chunk.value, { stream: true })
-      let boundary = buffer.indexOf("\n\n")
-      while (boundary !== -1) {
-        const frame = buffer.slice(0, boundary)
-        buffer = buffer.slice(boundary + 2)
+      let boundary = sseBoundary(buffer)
+      while (boundary !== undefined) {
+        const frame = buffer.slice(0, boundary.index)
+        buffer = buffer.slice(boundary.end)
+        if (encoder.encode(frame).byteLength > maxFrameBytes)
+          throw new AgentTransportError(method, "SSE frame exceeds the configured response limit")
         const event = frameToEvent(frame)
         if (event !== undefined) yield event
-        boundary = buffer.indexOf("\n\n")
+        boundary = sseBoundary(buffer)
+      }
+      if (encoder.encode(buffer).byteLength > maxFrameBytes) {
+        try {
+          await reader.cancel()
+        } catch {
+          // Preserve the bounded transport error if the source has already closed.
+        }
+        throw new AgentTransportError(method, "SSE frame exceeds the configured response limit")
       }
     }
   } catch (error) {
+    if (error instanceof AgentTransportError) throw error
     throw new AgentTransportError(method, describe(error))
   } finally {
+    if (!reachedEof) {
+      // Releasing a reader lock does not stop the response producer. Cancel the body when a
+      // consumer breaks early so sockets, server-side work, and buffered chunks can be reclaimed.
+      try {
+        await reader.cancel()
+      } catch {
+        // Preserve the original transport/read error, or the consumer's early-return semantics.
+      }
+    }
     reader.releaseLock()
   }
 }
 
 function frameToEvent(frame: string): AgentEvent | undefined {
   const data = frame
-    .split("\n")
+    .split(/\r\n|\n|\r/)
     .filter((line) => line.startsWith("data:"))
     .map((line) => line.slice(5).replace(/^ /, ""))
     .join("\n")
@@ -167,6 +220,66 @@ function frameToEvent(frame: string): AgentEvent | undefined {
   return isAgentEvent(value) ? value : undefined
 }
 
+function sseBoundary(value: string): { readonly index: number; readonly end: number } | undefined {
+  for (let index = 0; index < value.length; index++) {
+    const firstLength = lineEndingLength(value, index)
+    if (firstLength === undefined) return undefined
+    if (firstLength === 0) continue
+    const secondIndex = index + firstLength
+    const secondLength = lineEndingLength(value, secondIndex)
+    if (secondLength === undefined) return undefined
+    if (secondLength > 0) return { index, end: secondIndex + secondLength }
+    index = secondIndex
+  }
+  return undefined
+}
+
+function lineEndingLength(value: string, index: number): number | undefined {
+  const character = value[index]
+  if (character === "\n") return 1
+  if (character !== "\r") return 0
+  if (index + 1 >= value.length) return undefined
+  return value[index + 1] === "\n" ? 2 : 1
+}
+
+const DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024
+const MAX_RESPONSE_BYTES = MAX_TRANSPORT_BYTES
+
+function assertResponseLimit(value: number): void {
+  assertTransportByteLimit(value, {
+    minimum: 1_024,
+    maximum: MAX_RESPONSE_BYTES,
+    label: "agent transport: maxResponseBytes",
+  })
+}
+
+async function readResponseText(
+  response: Response,
+  method: string,
+  maxBytes: number,
+): Promise<string> {
+  const declared = parseTransportContentLength(response.headers.get("content-length"))
+  if (declared !== undefined && declared > maxBytes) {
+    try {
+      await response.body?.cancel()
+    } catch {
+      // The response is already over its cap; cancellation failure must not replace the useful error.
+    }
+    throw new AgentTransportError(method, "response body exceeds the configured limit")
+  }
+  if (response.body === null) return ""
+  const read = await readBoundedTransportBytes(response.body, maxBytes)
+  if (!read.ok) {
+    throw new AgentTransportError(
+      method,
+      read.reason === "too-large"
+        ? "response body exceeds the configured limit"
+        : describe(read.error),
+    )
+  }
+  return new TextDecoder().decode(read.bytes)
+}
+
 function serialize(request: AgentTransportRequest): string {
   return JSON.stringify({
     method: request.method,