@nifrajs/agent-protocol 3.3.0 → 4.0.0

package/dist/index.d.ts

@@ -217,5 +217,8 @@ export * from "./orchestration.js";
  * feature negotiation, cursor resume). Additive to the session protocol; carries no payload content.
  */
 export * from "./run-lifecycle.js";
+/** Shared fail-closed byte-limit policy used by independent HTTP adapters. */
+export * from "./transport-policy.js";
+/** Validate the complete discriminated event union before a projection or UI consumer sees it. */
 export declare function isAgentEvent(value: unknown): value is AgentEvent;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,13 +6,16 @@
  * framework, model provider, or UI code into an application.
  */
 export const AGENT_PROTOCOL_VERSION = 1;
+const MAX_AGENT_EVENT_QUEUE_SIZE = 65_536;
 /**
  * Small bounded event stream for RPC clients and UIs. The authoritative event history belongs to
  * the backend/session store; this live view may drop old transient events if a consumer falls behind.
  */
 export function createAgentEventStream(maxQueueSize = 256) {
-    if (!Number.isSafeInteger(maxQueueSize) || maxQueueSize < 1)
-        throw new RangeError("agent event stream: maxQueueSize must be a positive safe integer");
+    if (!Number.isSafeInteger(maxQueueSize) ||
+        maxQueueSize < 1 ||
+        maxQueueSize > MAX_AGENT_EVENT_QUEUE_SIZE)
+        throw new RangeError(`agent event stream: maxQueueSize must be between 1 and ${MAX_AGENT_EVENT_QUEUE_SIZE}`);
     const queue = [];
     const waiters = [];
     let completed = false;
@@ -96,17 +99,178 @@ export * from "./orchestration.js";
  * feature negotiation, cursor resume). Additive to the session protocol; carries no payload content.
  */
 export * from "./run-lifecycle.js";
+/** Shared fail-closed byte-limit policy used by independent HTTP adapters. */
+export * from "./transport-policy.js";
+const AGENT_TOKEN_RE = /^[A-Za-z0-9._:/-]{1,128}$/;
+const AGENT_MAX_TEXT = 256 * 1024;
+const AGENT_MAX_PAYLOAD_TEXT = 64 * 1024;
+const AGENT_MAX_ARRAY = 256;
+const AGENT_MAX_OBJECT_KEYS = 256;
+const AGENT_MAX_PAYLOAD_DEPTH = 6;
+const AGENT_STATUSES = new Set([
+    "idle",
+    "running",
+    "waiting",
+    "completed",
+    "failed",
+    "stopped",
+]);
+const AGENT_COMPACTION_REASONS = new Set([
+    "manual",
+    "threshold",
+    "overflow",
+    "workflow",
+]);
+function agentRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function agentToken(value) {
+    return typeof value === "string" && AGENT_TOKEN_RE.test(value);
+}
+function agentText(value, max = AGENT_MAX_TEXT, allowEmpty = true) {
+    return (typeof value === "string" &&
+        value.length <= max &&
+        (allowEmpty || value.length > 0) &&
+        !value.includes("\0"));
+}
+function agentCount(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function boundedAgentValue(value, depth = 0, state = { remaining: 2_048 }) {
+    if (state.remaining-- <= 0 || depth > AGENT_MAX_PAYLOAD_DEPTH)
+        return false;
+    if (value === null || typeof value === "boolean")
+        return true;
+    if (typeof value === "string")
+        return agentText(value, AGENT_MAX_PAYLOAD_TEXT);
+    if (typeof value === "number")
+        return Number.isFinite(value) && Math.abs(value) <= Number.MAX_SAFE_INTEGER;
+    if (Array.isArray(value))
+        return (value.length <= AGENT_MAX_ARRAY &&
+            value.every((item) => boundedAgentValue(item, depth + 1, state)));
+    if (!agentRecord(value) || Object.keys(value).length > AGENT_MAX_OBJECT_KEYS)
+        return false;
+    return Object.entries(value).every(([key, child]) => agentText(key, 128, false) && boundedAgentValue(child, depth + 1, state));
+}
+function optionalBoundedAgentValue(record, key) {
+    return !Object.hasOwn(record, key) || boundedAgentValue(record[key]);
+}
+function validAgentError(value) {
+    if (!agentRecord(value))
+        return false;
+    return (agentToken(value.code) &&
+        agentText(value.message, AGENT_MAX_TEXT, false) &&
+        optionalBoundedAgentValue(value, "details"));
+}
+function validAgentSnapshot(value, sessionId) {
+    if (!agentRecord(value))
+        return false;
+    if (value.version !== AGENT_PROTOCOL_VERSION ||
+        !agentToken(value.id) ||
+        value.id !== sessionId ||
+        !agentToken(value.backend) ||
+        !agentText(value.cwd, 4_096, false) ||
+        typeof value.status !== "string" ||
+        !AGENT_STATUSES.has(value.status) ||
+        !agentCount(value.createdAt) ||
+        !agentCount(value.updatedAt) ||
+        !agentCount(value.lastSeq) ||
+        !Array.isArray(value.capabilities) ||
+        value.capabilities.length > AGENT_MAX_ARRAY ||
+        !value.capabilities.every(agentToken))
+        return false;
+    if (value.activeTurnId !== undefined && !agentToken(value.activeTurnId))
+        return false;
+    if (value.extensionRevision !== undefined && !agentToken(value.extensionRevision))
+        return false;
+    return true;
+}
+function validRepairTask(value) {
+    if (!agentRecord(value))
+        return false;
+    return (agentToken(value.id) &&
+        (value.verification === "check" ||
+            value.verification === "assure" ||
+            value.verification === "test") &&
+        agentText(value.cwd, 4_096, false) &&
+        agentText(value.reason, AGENT_MAX_TEXT, false) &&
+        Array.isArray(value.capabilities) &&
+        value.capabilities.length <= AGENT_MAX_ARRAY &&
+        value.capabilities.every(agentToken) &&
+        (value.output === undefined || agentText(value.output)) &&
+        optionalBoundedAgentValue(value, "report"));
+}
+/** Validate the complete discriminated event union before a projection or UI consumer sees it. */
 export function isAgentEvent(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value))
+    if (!agentRecord(value))
+        return false;
+    if (value.version !== AGENT_PROTOCOL_VERSION ||
+        !agentToken(value.sessionId) ||
+        !agentCount(value.seq) ||
+        !agentCount(value.at) ||
+        typeof value.type !== "string")
         return false;
-    const record = value;
-    return (record.version === AGENT_PROTOCOL_VERSION &&
-        typeof record.sessionId === "string" &&
-        typeof record.seq === "number" &&
-        Number.isSafeInteger(record.seq) &&
-        typeof record.at === "number" &&
-        Number.isFinite(record.at) &&
-        typeof record.type === "string" &&
-        record.type.includes("."));
+    switch (value.type) {
+        case "session.started":
+        case "session.updated":
+        case "session.completed":
+            return validAgentSnapshot(value.snapshot, value.sessionId);
+        case "turn.started":
+            return agentToken(value.turnId) && agentText(value.prompt);
+        case "assistant.delta":
+        case "assistant.message":
+            return agentToken(value.turnId) && agentText(value.text);
+        case "tool.started":
+            return (agentToken(value.turnId) &&
+                agentToken(value.callId) &&
+                agentToken(value.name) &&
+                optionalBoundedAgentValue(value, "input"));
+        case "tool.delta":
+            return agentToken(value.turnId) && agentToken(value.callId) && agentText(value.text);
+        case "tool.completed":
+            return (agentToken(value.turnId) &&
+                agentToken(value.callId) &&
+                agentToken(value.name) &&
+                typeof value.ok === "boolean" &&
+                optionalBoundedAgentValue(value, "output") &&
+                (value.error === undefined || validAgentError(value.error)));
+        case "approval.required":
+            return (agentToken(value.turnId) &&
+                agentToken(value.approvalId) &&
+                agentText(value.action, AGENT_MAX_TEXT, false) &&
+                agentToken(value.capability) &&
+                (value.reason === undefined || agentText(value.reason)));
+        case "approval.resolved":
+            return ((value.turnId === undefined || agentToken(value.turnId)) &&
+                agentToken(value.approvalId) &&
+                typeof value.approved === "boolean" &&
+                (value.reason === undefined || agentText(value.reason)));
+        case "repair.required":
+            return (value.turnId === undefined || agentToken(value.turnId)) && validRepairTask(value.task);
+        case "verification.completed":
+            return ((value.name === "check" || value.name === "assure" || value.name === "test") &&
+                typeof value.ok === "boolean" &&
+                optionalBoundedAgentValue(value, "report"));
+        case "memory.compacted":
+            return (agentCount(value.before) &&
+                agentCount(value.after) &&
+                typeof value.reason === "string" &&
+                AGENT_COMPACTION_REASONS.has(value.reason));
+        case "extension.reloaded":
+            return (agentToken(value.revision) &&
+                Array.isArray(value.loaded) &&
+                value.loaded.length <= AGENT_MAX_ARRAY &&
+                value.loaded.every(agentToken) &&
+                Array.isArray(value.disabled) &&
+                value.disabled.length <= AGENT_MAX_ARRAY &&
+                value.disabled.every(agentToken) &&
+                typeof value.rolledBack === "boolean");
+        case "session.failed":
+            return validAgentError(value.error) && typeof value.recoverable === "boolean";
+        case "session.stopped":
+            return value.reason === undefined || agentText(value.reason);
+        default:
+            return false;
+    }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAU,CAAA;AAgShD,MAAM,0BAA0B,GAAG,MAAM,CAAA;AAEzC;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAY,GAAG,GAAG;IACvD,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC;QACnC,YAAY,GAAG,CAAC;QAChB,YAAY,GAAG,0BAA0B;QAEzC,MAAM,IAAI,UAAU,CAClB,0DAA0D,0BAA0B,EAAE,CACvF,CAAA;IAEH,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,MAAM,OAAO,GAGR,EAAE,CAAA;IACP,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,OAAgB,CAAA;IACpB,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAM;QAC1C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;YAC9B,IAAI,MAAM;gBAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;;gBAC9B,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAqB;QAC/B,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,CAAC,KAAK;YACR,IAAI,SAAS;gBAAE,OAAM;YACrB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;YAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;gBAC7C,OAAM;YACR,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;gBACjC,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,OAAO,IAAI,CAAC,CAAA;YACd,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;QACD,QAAQ;YACN,SAAS,GAAG,IAAI,CAAA;YAChB,MAAM,EAAE,CAAA;QACV,CAAC;QACD,IAAI,CAAC,KAAK;YACR,IAAI,SAAS;gBAAE,OAAM;YACrB,OAAO,GAAG,KAAK,CAAA;YACf,MAAM,GAAG,IAAI,CAAA;YACb,SAAS,GAAG,IAAI,CAAA;YAChB,MAAM,EAAE,CAAA;QACV,CAAC;QACD,IAAI;YACF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC3B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9E,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,MAAM;oBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAC1D,CAAC;YACD,OAAO,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACjE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAClC,CAAA;QACH,CAAC;QACD,MAAM;YACJ,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YAChB,SAAS,GAAG,IAAI,CAAA;YAChB,MAAM,EAAE,CAAA;YACR,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,CAAC,MAAM,CAAC,aAAa,CAAC;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,OAAiB;IACzE,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC/E,CAAC;AAED;;;GAGG;AACH,cAAc,oBAAoB,CAAA;AAElC;;;GAGG;AACH,cAAc,oBAAoB,CAAA;AAElC,8EAA8E;AAC9E,cAAc,uBAAuB,CAAA;AAErC,MAAM,cAAc,GAAG,2BAA2B,CAAA;AAClD,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAA;AACjC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAA;AACxC,MAAM,eAAe,GAAG,GAAG,CAAA;AAC3B,MAAM,qBAAqB,GAAG,GAAG,CAAA;AACjC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AACjC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,MAAM;IACN,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,SAAS;CACV,CAAC,CAAA;AACF,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IAC5D,QAAQ;IACR,WAAW;IACX,UAAU;IACV,UAAU;CACX,CAAC,CAAA;AAEF,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,GAAG,GAAG,cAAc,EAAE,UAAU,GAAG,IAAI;IACxE,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,IAAI,GAAG;QACnB,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAChC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtB,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC/E,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc,EACd,KAAK,GAAG,CAAC,EACT,QAA+B,EAAE,SAAS,EAAE,KAAK,EAAE;IAEnD,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,KAAK,GAAG,uBAAuB;QAAE,OAAO,KAAK,CAAA;IAC3E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAA;IAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAA;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,CACL,KAAK,CAAC,MAAM,IAAI,eAAe;YAC/B,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CACjE,CAAA;IACH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,qBAAqB;QAAE,OAAO,KAAK,CAAA;IAC1F,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAChC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAC3F,CAAA;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA+B,EAAE,GAAW;IAC7E,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QACtB,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC;QAC/C,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAC5C,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc,EAAE,SAAiB;IAC3D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,IACE,KAAK,CAAC,OAAO,KAAK,sBAAsB;QACxC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,KAAK,SAAS;QACtB,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1B,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACjC,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5B,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5B,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;QAClC,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,eAAe;QAC3C,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC;QAErC,OAAO,KAAK,CAAA;IACd,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAA;IACrF,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,CAAC,KAAK,CAAC,YAAY,KAAK,OAAO;YAC7B,KAAK,CAAC,YAAY,KAAK,QAAQ;YAC/B,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC;QAChC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC;QAClC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC;QAC9C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;QACjC,KAAK,CAAC,YAAY,CAAC,MAAM,IAAI,eAAe;QAC5C,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC;QACpC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAC3C,CAAA;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,IACE,KAAK,CAAC,OAAO,KAAK,sBAAsB;QACxC,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5B,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;QACtB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAE9B,OAAO,KAAK,CAAA;IACd,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,iBAAiB,CAAC;QACvB,KAAK,iBAAiB,CAAC;QACvB,KAAK,mBAAmB;YACtB,OAAO,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;QAC5D,KAAK,cAAc;YACjB,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5D,KAAK,iBAAiB,CAAC;QACvB,KAAK,mBAAmB;YACtB,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1D,KAAK,cAAc;YACjB,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;gBACtB,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,CAC1C,CAAA;QACH,KAAK,YAAY;YACf,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACtF,KAAK,gBAAgB;YACnB,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;gBACtB,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS;gBAC7B,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAC1C,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAC5D,CAAA;QACH,KAAK,mBAAmB;YACtB,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5B,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC;gBAC9C,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5B,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CACxD,CAAA;QACH,KAAK,mBAAmB;YACtB,OAAO,CACL,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACxD,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5B,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS;gBACnC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CACxD,CAAA;QACH,KAAK,iBAAiB;YACpB,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAChG,KAAK,wBAAwB;YAC3B,OAAO,CACL,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;gBAC5E,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS;gBAC7B,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAC3C,CAAA;QACH,KAAK,kBAAkB;YACrB,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;gBACvB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAChC,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAC3C,CAAA;QACH,KAAK,oBAAoB;YACvB,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC1B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC3B,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe;gBACtC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC9B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC7B,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,eAAe;gBACxC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;gBAChC,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS,CACtC,CAAA;QACH,KAAK,gBAAgB;YACnB,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,SAAS,CAAA;QAC/E,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC9D;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC"}

package/dist/transport-policy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Protocol-neutral byte limits for HTTP adapters.
+ *
+ * MCP's HTTP server and the Agent App browser transport have different wire protocols, but both need
+ * the same fail-closed rules when reading an untrusted stream. Keeping this small policy here avoids
+ * coupling either adapter to the other while making the limit and cancellation semantics identical.
+ */
+export declare const MAX_TRANSPORT_BYTES: number;
+export interface TransportByteLimitOptions {
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly label?: string;
+}
+export declare function assertTransportByteLimit(value: number, options?: TransportByteLimitOptions): void;
+/** Parse a decimal Content-Length without allowing malformed or unsafe values to pass as a size. */
+export declare function parseTransportContentLength(value: string | null): number | undefined;
+export type BoundedTransportRead = {
+    readonly ok: true;
+    readonly bytes: Uint8Array;
+} | {
+    readonly ok: false;
+    readonly reason: "too-large" | "read-error";
+    readonly error?: unknown;
+};
+/** Read a Web stream under one byte cap, canceling the source as soon as the cap is exceeded. */
+export declare function readBoundedTransportBytes(body: ReadableStream<Uint8Array>, maxBytes: number): Promise<BoundedTransportRead>;
+//# sourceMappingURL=transport-policy.d.ts.map

package/dist/transport-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-policy.d.ts","sourceRoot":"","sources":["../src/transport-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,mBAAmB,QAAmB,CAAA;AAEnD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAgBN;AAED,oGAAoG;AACpG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAUpF;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEjG,iGAAiG;AACjG,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAsC/B"}

package/dist/transport-policy.js

@@ -0,0 +1,81 @@
+/**
+ * Protocol-neutral byte limits for HTTP adapters.
+ *
+ * MCP's HTTP server and the Agent App browser transport have different wire protocols, but both need
+ * the same fail-closed rules when reading an untrusted stream. Keeping this small policy here avoids
+ * coupling either adapter to the other while making the limit and cancellation semantics identical.
+ */
+export const MAX_TRANSPORT_BYTES = 64 * 1024 * 1024;
+export function assertTransportByteLimit(value, options = {}) {
+    const minimum = options.minimum ?? 0;
+    const maximum = options.maximum ?? MAX_TRANSPORT_BYTES;
+    if (!Number.isSafeInteger(value) ||
+        !Number.isSafeInteger(minimum) ||
+        !Number.isSafeInteger(maximum) ||
+        minimum < 0 ||
+        maximum < minimum ||
+        value < minimum ||
+        value > maximum) {
+        throw new RangeError(`${options.label ?? "transport byte limit"} must be between ${minimum} and ${maximum}`);
+    }
+}
+/** Parse a decimal Content-Length without allowing malformed or unsafe values to pass as a size. */
+export function parseTransportContentLength(value) {
+    if (value === null || value.length === 0)
+        return undefined;
+    let length = 0;
+    for (let index = 0; index < value.length; index++) {
+        const digit = value.charCodeAt(index) - 48;
+        if (digit < 0 || digit > 9)
+            return undefined;
+        length = length * 10 + digit;
+        if (!Number.isSafeInteger(length))
+            return Number.POSITIVE_INFINITY;
+    }
+    return length;
+}
+/** Read a Web stream under one byte cap, canceling the source as soon as the cap is exceeded. */
+export async function readBoundedTransportBytes(body, maxBytes) {
+    assertTransportByteLimit(maxBytes);
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value === undefined || value.byteLength > maxBytes - total) {
+                try {
+                    await reader.cancel();
+                }
+                catch {
+                    // Preserve the bounded-read result if the source has already closed.
+                }
+                return { ok: false, reason: "too-large" };
+            }
+            total += value.byteLength;
+            chunks.push(value);
+        }
+    }
+    catch (error) {
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // Preserve the original stream error classification.
+        }
+        return { ok: false, reason: "read-error", error };
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return { ok: true, bytes };
+}
+//# sourceMappingURL=transport-policy.js.map

package/dist/transport-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-policy.js","sourceRoot":"","sources":["../src/transport-policy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/agent-protocol",
-  "version": "3.3.0",
+  "version": "4.0.0",
   "description": "Small backend-neutral session and event protocol for Nifra coding agents.",
   "keywords": [
     "bun",
@@ -11,6 +11,9 @@
     "rpc"
   ],
   "type": "module",
+  "nifra": {
+    "environment": "library"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -294,13 +294,21 @@ export interface AgentEventStream extends AgentEventSink, AsyncIterableIterator<
   readonly dropped: number
 }
 
+const MAX_AGENT_EVENT_QUEUE_SIZE = 65_536
+
 /**
  * Small bounded event stream for RPC clients and UIs. The authoritative event history belongs to
  * the backend/session store; this live view may drop old transient events if a consumer falls behind.
  */
 export function createAgentEventStream(maxQueueSize = 256): AgentEventStream {
-  if (!Number.isSafeInteger(maxQueueSize) || maxQueueSize < 1)
-    throw new RangeError("agent event stream: maxQueueSize must be a positive safe integer")
+  if (
+    !Number.isSafeInteger(maxQueueSize) ||
+    maxQueueSize < 1 ||
+    maxQueueSize > MAX_AGENT_EVENT_QUEUE_SIZE
+  )
+    throw new RangeError(
+      `agent event stream: maxQueueSize must be between 1 and ${MAX_AGENT_EVENT_QUEUE_SIZE}`,
+    )
 
   const queue: AgentEvent[] = []
   const waiters: Array<{
@@ -389,17 +397,210 @@ export * from "./orchestration.ts"
  */
 export * from "./run-lifecycle.ts"
 
-export function isAgentEvent(value: unknown): value is AgentEvent {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return false
-  const record = value as Record<string, unknown>
+/** Shared fail-closed byte-limit policy used by independent HTTP adapters. */
+export * from "./transport-policy.ts"
+
+const AGENT_TOKEN_RE = /^[A-Za-z0-9._:/-]{1,128}$/
+const AGENT_MAX_TEXT = 256 * 1024
+const AGENT_MAX_PAYLOAD_TEXT = 64 * 1024
+const AGENT_MAX_ARRAY = 256
+const AGENT_MAX_OBJECT_KEYS = 256
+const AGENT_MAX_PAYLOAD_DEPTH = 6
+const AGENT_STATUSES: ReadonlySet<string> = new Set([
+  "idle",
+  "running",
+  "waiting",
+  "completed",
+  "failed",
+  "stopped",
+])
+const AGENT_COMPACTION_REASONS: ReadonlySet<string> = new Set([
+  "manual",
+  "threshold",
+  "overflow",
+  "workflow",
+])
+
+function agentRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value)
+}
+
+function agentToken(value: unknown): value is string {
+  return typeof value === "string" && AGENT_TOKEN_RE.test(value)
+}
+
+function agentText(value: unknown, max = AGENT_MAX_TEXT, allowEmpty = true): value is string {
+  return (
+    typeof value === "string" &&
+    value.length <= max &&
+    (allowEmpty || value.length > 0) &&
+    !value.includes("\0")
+  )
+}
+
+function agentCount(value: unknown): value is number {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0
+}
+
+function boundedAgentValue(
+  value: unknown,
+  depth = 0,
+  state: { remaining: number } = { remaining: 2_048 },
+): boolean {
+  if (state.remaining-- <= 0 || depth > AGENT_MAX_PAYLOAD_DEPTH) return false
+  if (value === null || typeof value === "boolean") return true
+  if (typeof value === "string") return agentText(value, AGENT_MAX_PAYLOAD_TEXT)
+  if (typeof value === "number")
+    return Number.isFinite(value) && Math.abs(value) <= Number.MAX_SAFE_INTEGER
+  if (Array.isArray(value))
+    return (
+      value.length <= AGENT_MAX_ARRAY &&
+      value.every((item) => boundedAgentValue(item, depth + 1, state))
+    )
+  if (!agentRecord(value) || Object.keys(value).length > AGENT_MAX_OBJECT_KEYS) return false
+  return Object.entries(value).every(
+    ([key, child]) => agentText(key, 128, false) && boundedAgentValue(child, depth + 1, state),
+  )
+}
+
+function optionalBoundedAgentValue(record: Record<string, unknown>, key: string): boolean {
+  return !Object.hasOwn(record, key) || boundedAgentValue(record[key])
+}
+
+function validAgentError(value: unknown): boolean {
+  if (!agentRecord(value)) return false
   return (
-    record.version === AGENT_PROTOCOL_VERSION &&
-    typeof record.sessionId === "string" &&
-    typeof record.seq === "number" &&
-    Number.isSafeInteger(record.seq) &&
-    typeof record.at === "number" &&
-    Number.isFinite(record.at) &&
-    typeof record.type === "string" &&
-    record.type.includes(".")
+    agentToken(value.code) &&
+    agentText(value.message, AGENT_MAX_TEXT, false) &&
+    optionalBoundedAgentValue(value, "details")
   )
 }
+
+function validAgentSnapshot(value: unknown, sessionId: string): value is AgentSessionSnapshot {
+  if (!agentRecord(value)) return false
+  if (
+    value.version !== AGENT_PROTOCOL_VERSION ||
+    !agentToken(value.id) ||
+    value.id !== sessionId ||
+    !agentToken(value.backend) ||
+    !agentText(value.cwd, 4_096, false) ||
+    typeof value.status !== "string" ||
+    !AGENT_STATUSES.has(value.status) ||
+    !agentCount(value.createdAt) ||
+    !agentCount(value.updatedAt) ||
+    !agentCount(value.lastSeq) ||
+    !Array.isArray(value.capabilities) ||
+    value.capabilities.length > AGENT_MAX_ARRAY ||
+    !value.capabilities.every(agentToken)
+  )
+    return false
+  if (value.activeTurnId !== undefined && !agentToken(value.activeTurnId)) return false
+  if (value.extensionRevision !== undefined && !agentToken(value.extensionRevision)) return false
+  return true
+}
+
+function validRepairTask(value: unknown): boolean {
+  if (!agentRecord(value)) return false
+  return (
+    agentToken(value.id) &&
+    (value.verification === "check" ||
+      value.verification === "assure" ||
+      value.verification === "test") &&
+    agentText(value.cwd, 4_096, false) &&
+    agentText(value.reason, AGENT_MAX_TEXT, false) &&
+    Array.isArray(value.capabilities) &&
+    value.capabilities.length <= AGENT_MAX_ARRAY &&
+    value.capabilities.every(agentToken) &&
+    (value.output === undefined || agentText(value.output)) &&
+    optionalBoundedAgentValue(value, "report")
+  )
+}
+
+/** Validate the complete discriminated event union before a projection or UI consumer sees it. */
+export function isAgentEvent(value: unknown): value is AgentEvent {
+  if (!agentRecord(value)) return false
+  if (
+    value.version !== AGENT_PROTOCOL_VERSION ||
+    !agentToken(value.sessionId) ||
+    !agentCount(value.seq) ||
+    !agentCount(value.at) ||
+    typeof value.type !== "string"
+  )
+    return false
+  switch (value.type) {
+    case "session.started":
+    case "session.updated":
+    case "session.completed":
+      return validAgentSnapshot(value.snapshot, value.sessionId)
+    case "turn.started":
+      return agentToken(value.turnId) && agentText(value.prompt)
+    case "assistant.delta":
+    case "assistant.message":
+      return agentToken(value.turnId) && agentText(value.text)
+    case "tool.started":
+      return (
+        agentToken(value.turnId) &&
+        agentToken(value.callId) &&
+        agentToken(value.name) &&
+        optionalBoundedAgentValue(value, "input")
+      )
+    case "tool.delta":
+      return agentToken(value.turnId) && agentToken(value.callId) && agentText(value.text)
+    case "tool.completed":
+      return (
+        agentToken(value.turnId) &&
+        agentToken(value.callId) &&
+        agentToken(value.name) &&
+        typeof value.ok === "boolean" &&
+        optionalBoundedAgentValue(value, "output") &&
+        (value.error === undefined || validAgentError(value.error))
+      )
+    case "approval.required":
+      return (
+        agentToken(value.turnId) &&
+        agentToken(value.approvalId) &&
+        agentText(value.action, AGENT_MAX_TEXT, false) &&
+        agentToken(value.capability) &&
+        (value.reason === undefined || agentText(value.reason))
+      )
+    case "approval.resolved":
+      return (
+        (value.turnId === undefined || agentToken(value.turnId)) &&
+        agentToken(value.approvalId) &&
+        typeof value.approved === "boolean" &&
+        (value.reason === undefined || agentText(value.reason))
+      )
+    case "repair.required":
+      return (value.turnId === undefined || agentToken(value.turnId)) && validRepairTask(value.task)
+    case "verification.completed":
+      return (
+        (value.name === "check" || value.name === "assure" || value.name === "test") &&
+        typeof value.ok === "boolean" &&
+        optionalBoundedAgentValue(value, "report")
+      )
+    case "memory.compacted":
+      return (
+        agentCount(value.before) &&
+        agentCount(value.after) &&
+        typeof value.reason === "string" &&
+        AGENT_COMPACTION_REASONS.has(value.reason)
+      )
+    case "extension.reloaded":
+      return (
+        agentToken(value.revision) &&
+        Array.isArray(value.loaded) &&
+        value.loaded.length <= AGENT_MAX_ARRAY &&
+        value.loaded.every(agentToken) &&
+        Array.isArray(value.disabled) &&
+        value.disabled.length <= AGENT_MAX_ARRAY &&
+        value.disabled.every(agentToken) &&
+        typeof value.rolledBack === "boolean"
+      )
+    case "session.failed":
+      return validAgentError(value.error) && typeof value.recoverable === "boolean"
+    case "session.stopped":
+      return value.reason === undefined || agentText(value.reason)
+    default:
+      return false
+  }
+}

package/src/transport-policy.ts

@@ -0,0 +1,97 @@
+/**
+ * Protocol-neutral byte limits for HTTP adapters.
+ *
+ * MCP's HTTP server and the Agent App browser transport have different wire protocols, but both need
+ * the same fail-closed rules when reading an untrusted stream. Keeping this small policy here avoids
+ * coupling either adapter to the other while making the limit and cancellation semantics identical.
+ */
+
+export const MAX_TRANSPORT_BYTES = 64 * 1024 * 1024
+
+export interface TransportByteLimitOptions {
+  readonly minimum?: number
+  readonly maximum?: number
+  readonly label?: string
+}
+
+export function assertTransportByteLimit(
+  value: number,
+  options: TransportByteLimitOptions = {},
+): void {
+  const minimum = options.minimum ?? 0
+  const maximum = options.maximum ?? MAX_TRANSPORT_BYTES
+  if (
+    !Number.isSafeInteger(value) ||
+    !Number.isSafeInteger(minimum) ||
+    !Number.isSafeInteger(maximum) ||
+    minimum < 0 ||
+    maximum < minimum ||
+    value < minimum ||
+    value > maximum
+  ) {
+    throw new RangeError(
+      `${options.label ?? "transport byte limit"} must be between ${minimum} and ${maximum}`,
+    )
+  }
+}
+
+/** Parse a decimal Content-Length without allowing malformed or unsafe values to pass as a size. */
+export function parseTransportContentLength(value: string | null): number | undefined {
+  if (value === null || value.length === 0) return undefined
+  let length = 0
+  for (let index = 0; index < value.length; index++) {
+    const digit = value.charCodeAt(index) - 48
+    if (digit < 0 || digit > 9) return undefined
+    length = length * 10 + digit
+    if (!Number.isSafeInteger(length)) return Number.POSITIVE_INFINITY
+  }
+  return length
+}
+
+export type BoundedTransportRead =
+  | { readonly ok: true; readonly bytes: Uint8Array }
+  | { readonly ok: false; readonly reason: "too-large" | "read-error"; readonly error?: unknown }
+
+/** Read a Web stream under one byte cap, canceling the source as soon as the cap is exceeded. */
+export async function readBoundedTransportBytes(
+  body: ReadableStream<Uint8Array>,
+  maxBytes: number,
+): Promise<BoundedTransportRead> {
+  assertTransportByteLimit(maxBytes)
+  const reader = body.getReader()
+  const chunks: Uint8Array[] = []
+  let total = 0
+  try {
+    for (;;) {
+      const { done, value } = await reader.read()
+      if (done) break
+      if (value === undefined || value.byteLength > maxBytes - total) {
+        try {
+          await reader.cancel()
+        } catch {
+          // Preserve the bounded-read result if the source has already closed.
+        }
+        return { ok: false, reason: "too-large" }
+      }
+      total += value.byteLength
+      chunks.push(value)
+    }
+  } catch (error) {
+    try {
+      await reader.cancel()
+    } catch {
+      // Preserve the original stream error classification.
+    }
+    return { ok: false, reason: "read-error", error }
+  } finally {
+    reader.releaseLock()
+  }
+
+  const bytes = new Uint8Array(total)
+  let offset = 0
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset)
+    offset += chunk.byteLength
+  }
+  return { ok: true, bytes }
+}