@nextera.one/axis-server-sdk 1.2.0 → 1.3.0

package/dist/index.js

@@ -33,6 +33,7 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 
 // src/index.ts
 var index_exports = {};
@@ -41,8 +42,13 @@ __export(index_exports, {
   ATS1_SCHEMA: () => ATS1_SCHEMA,
   AXIS_MAGIC: () => import_axis_protocol2.AXIS_MAGIC,
   AXIS_OPCODES: () => AXIS_OPCODES,
+  AXIS_UPLOAD_FILE_STORE: () => AXIS_UPLOAD_FILE_STORE,
+  AXIS_UPLOAD_RECEIPT_SIGNER: () => AXIS_UPLOAD_RECEIPT_SIGNER,
+  AXIS_UPLOAD_SESSION_STORE: () => AXIS_UPLOAD_SESSION_STORE,
   AXIS_VERSION: () => import_axis_protocol2.AXIS_VERSION,
   Ats1Codec: () => ats1_exports,
+  AxisFilesDownloadHandler: () => AxisFilesDownloadHandler,
+  AxisFilesFinalizeHandler: () => AxisFilesFinalizeHandler,
   AxisFrameZ: () => AxisFrameZ,
   AxisIdDto: () => AxisIdDto,
   AxisPacketTags: () => T,
@@ -55,6 +61,7 @@ __export(index_exports, {
   DEFAULT_CONTRACTS: () => DEFAULT_CONTRACTS,
   DEFAULT_TIMEOUT: () => DEFAULT_TIMEOUT,
   Decision: () => Decision,
+  DiskUploadFileStore: () => DiskUploadFileStore,
   ERR_BAD_SIGNATURE: () => import_axis_protocol2.ERR_BAD_SIGNATURE,
   ERR_CONTRACT_VIOLATION: () => import_axis_protocol2.ERR_CONTRACT_VIOLATION,
   ERR_INVALID_PACKET: () => import_axis_protocol2.ERR_INVALID_PACKET,
@@ -66,14 +73,18 @@ __export(index_exports, {
   FLAG_HAS_WITNESS: () => import_axis_protocol2.FLAG_HAS_WITNESS,
   HANDLER_METADATA_KEY: () => HANDLER_METADATA_KEY,
   Handler: () => Handler,
+  INTENT_BODY_KEY: () => INTENT_BODY_KEY,
   INTENT_METADATA_KEY: () => INTENT_METADATA_KEY,
   INTENT_REQUIREMENTS: () => INTENT_REQUIREMENTS,
   INTENT_ROUTES_KEY: () => INTENT_ROUTES_KEY,
   INTENT_SENSITIVITY_MAP: () => INTENT_SENSITIVITY_MAP,
+  INTENT_SENSORS_KEY: () => INTENT_SENSORS_KEY,
   INTENT_TIMEOUTS: () => INTENT_TIMEOUTS,
   Intent: () => Intent,
+  IntentBody: () => IntentBody,
   IntentRouter: () => IntentRouter,
   IntentSensitivity: () => IntentSensitivity,
+  IntentSensors: () => IntentSensors,
   MAX_BODY_LEN: () => import_axis_protocol2.MAX_BODY_LEN,
   MAX_FRAME_LEN: () => import_axis_protocol2.MAX_FRAME_LEN,
   MAX_HDR_LEN: () => import_axis_protocol2.MAX_HDR_LEN,
@@ -164,6 +175,8 @@ __export(index_exports, {
   classifyIntent: () => classifyIntent,
   computeReceiptHash: () => computeReceiptHash,
   computeSignaturePayload: () => computeSignaturePayload,
+  core: () => core_exports,
+  crypto: () => crypto_exports,
   decodeArray: () => import_axis_protocol.decodeArray,
   decodeAxis1Frame: () => decodeAxis1Frame,
   decodeFrame: () => decodeFrame,
@@ -171,11 +184,13 @@ __export(index_exports, {
   decodeTLVs: () => import_axis_protocol.decodeTLVs,
   decodeTLVsList: () => import_axis_protocol.decodeTLVsList,
   decodeVarint: () => import_axis_protocol3.decodeVarint,
+  decorators: () => decorators_exports,
   encVarint: () => encVarint,
   encodeAxis1Frame: () => encodeAxis1Frame,
   encodeFrame: () => encodeFrame,
   encodeTLVs: () => import_axis_protocol.encodeTLVs,
   encodeVarint: () => import_axis_protocol3.encodeVarint,
+  engine: () => engine_exports,
   extractDtoSchema: () => extractDtoSchema,
   generateEd25519KeyPair: () => generateEd25519KeyPair,
   getSignTarget: () => getSignTarget,
@@ -183,6 +198,7 @@ __export(index_exports, {
   isAdminOpcode: () => isAdminOpcode,
   isKnownOpcode: () => isKnownOpcode,
   isTimestampValid: () => isTimestampValid,
+  loom: () => loom_exports,
   nonce16: () => nonce16,
   normalizeSensorDecision: () => normalizeSensorDecision,
   packPasskeyLoginOptionsReq: () => packPasskeyLoginOptionsReq,
@@ -192,7 +208,10 @@ __export(index_exports, {
   packPasskeyRegisterOptionsReq: () => packPasskeyRegisterOptionsReq,
   parseScope: () => parseScope,
   resolveTimeout: () => resolveTimeout,
+  schemas: () => schemas_exports,
+  security: () => security_exports,
   sensitivityName: () => sensitivityName,
+  sensors: () => sensors_exports,
   sha256: () => sha256,
   signFrame: () => signFrame,
   tlv: () => tlv,
@@ -201,6 +220,7 @@ __export(index_exports, {
   unpackPasskeyLoginVerifyReq: () => unpackPasskeyLoginVerifyReq,
   unpackPasskeyRegisterOptionsReq: () => unpackPasskeyRegisterOptionsReq,
   utf8: () => utf8,
+  utils: () => utils_exports,
   validateFrameShape: () => validateFrameShape,
   varintLength: () => import_axis_protocol3.varintLength,
   varintU: () => varintU,
@@ -245,8 +265,26 @@ function Intent(action, options) {
   };
 }
 
-// src/decorators/tlv-field.decorator.ts
+// src/decorators/intent-body.decorator.ts
 var import_reflect_metadata2 = require("reflect-metadata");
+var INTENT_BODY_KEY = "axis:intent:body";
+function IntentBody(decoder) {
+  return (target, propertyKey) => {
+    Reflect.defineMetadata(INTENT_BODY_KEY, decoder, target, propertyKey);
+  };
+}
+
+// src/decorators/intent-sensors.decorator.ts
+var import_reflect_metadata3 = require("reflect-metadata");
+var INTENT_SENSORS_KEY = "axis:intent:sensors";
+function IntentSensors(sensors) {
+  return (target, propertyKey) => {
+    Reflect.defineMetadata(INTENT_SENSORS_KEY, sensors, target, propertyKey);
+  };
+}
+
+// src/decorators/tlv-field.decorator.ts
+var import_reflect_metadata4 = require("reflect-metadata");
 var TLV_FIELDS_KEY = "axis:tlv:fields";
 var TLV_VALIDATORS_KEY = "axis:tlv:validators";
 function TlvField(tag, options) {
@@ -304,7 +342,7 @@ function TlvRange(min, max, message) {
 }
 
 // src/decorators/dto-schema.util.ts
-var import_reflect_metadata3 = require("reflect-metadata");
+var import_reflect_metadata5 = require("reflect-metadata");
 
 // src/core/tlv.ts
 var import_axis_protocol = require("@nextera.one/axis-protocol");
@@ -405,7 +443,7 @@ __decorateClass([
 ], AxisIdDto.prototype, "id", 2);
 
 // src/base/axis-partial-type.ts
-var import_reflect_metadata4 = require("reflect-metadata");
+var import_reflect_metadata6 = require("reflect-metadata");
 function AxisPartialType(BaseDto) {
   class PartialDto extends BaseDto {
   }
@@ -452,10 +490,145 @@ __decorateClass([
 
 // src/engine/intent.router.ts
 var import_common2 = require("@nestjs/common");
+
+// src/sensor/axis-sensor.ts
+var Decision = /* @__PURE__ */ ((Decision2) => {
+  Decision2["ALLOW"] = "ALLOW";
+  Decision2["DENY"] = "DENY";
+  Decision2["THROTTLE"] = "THROTTLE";
+  Decision2["FLAG"] = "FLAG";
+  return Decision2;
+})(Decision || {});
+function normalizeSensorDecision(sensorDecision) {
+  if ("action" in sensorDecision) {
+    switch (sensorDecision.action) {
+      case "ALLOW":
+        return {
+          allow: true,
+          riskScore: 0,
+          reasons: [],
+          meta: sensorDecision.meta
+        };
+      case "DENY":
+        return {
+          allow: false,
+          riskScore: 100,
+          reasons: [sensorDecision.code, sensorDecision.reason].filter(
+            Boolean
+          ),
+          meta: sensorDecision.meta,
+          retryAfterMs: sensorDecision.retryAfterMs
+        };
+      case "THROTTLE":
+        return {
+          allow: false,
+          riskScore: 50,
+          reasons: ["RATE_LIMIT"],
+          retryAfterMs: sensorDecision.retryAfterMs,
+          meta: sensorDecision.meta
+        };
+      case "FLAG":
+        return {
+          allow: true,
+          riskScore: sensorDecision.scoreDelta,
+          reasons: sensorDecision.reasons,
+          meta: sensorDecision.meta
+        };
+    }
+  }
+  return {
+    allow: sensorDecision.allow,
+    riskScore: sensorDecision.riskScore,
+    reasons: sensorDecision.reasons,
+    tags: sensorDecision.tags,
+    meta: sensorDecision.meta,
+    tighten: sensorDecision.tighten,
+    retryAfterMs: sensorDecision.retryAfterMs
+  };
+}
+var SensorDecisions = {
+  allow(meta, tags) {
+    return {
+      decision: "ALLOW" /* ALLOW */,
+      allow: true,
+      riskScore: 0,
+      reasons: [],
+      tags,
+      meta
+    };
+  },
+  deny(code, reason, meta) {
+    return {
+      decision: "DENY" /* DENY */,
+      allow: false,
+      riskScore: 100,
+      code,
+      reasons: [code, reason].filter(Boolean),
+      meta
+    };
+  },
+  throttle(retryAfterMs, meta) {
+    return {
+      decision: "THROTTLE" /* THROTTLE */,
+      allow: false,
+      riskScore: 50,
+      retryAfterMs,
+      code: "RATE_LIMIT",
+      reasons: ["RATE_LIMIT"],
+      meta
+    };
+  },
+  flag(scoreDelta, reasons, meta) {
+    return {
+      decision: "FLAG" /* FLAG */,
+      allow: true,
+      riskScore: scoreDelta,
+      scoreDelta,
+      reasons,
+      meta
+    };
+  }
+};
+
+// src/engine/intent.router.ts
 var IntentRouter = class {
-  constructor() {
+  constructor(moduleRef) {
+    this.moduleRef = moduleRef;
+    this.logger = new import_common2.Logger(IntentRouter.name);
     /** Internal registry of dynamic intent handlers */
     this.handlers = /* @__PURE__ */ new Map();
+    /** Per-intent sensor classes (resolved at call time) */
+    this.intentSensors = /* @__PURE__ */ new Map();
+    /** Per-intent body decoders */
+    this.intentDecoders = /* @__PURE__ */ new Map();
+    /** Per-intent TLV schemas */
+    this.intentSchemas = /* @__PURE__ */ new Map();
+    /** Per-intent custom validators */
+    this.intentValidators = /* @__PURE__ */ new Map();
+    /** Per-intent operation kind */
+    this.intentKinds = /* @__PURE__ */ new Map();
+  }
+  getSchema(intent) {
+    return this.intentSchemas.get(intent);
+  }
+  getValidators(intent) {
+    return this.intentValidators.get(intent);
+  }
+  has(intent) {
+    return this.handlers.has(intent) || IntentRouter.BUILTIN_INTENTS.has(intent);
+  }
+  getRegisteredIntents() {
+    return [...IntentRouter.BUILTIN_INTENTS, ...this.handlers.keys()];
+  }
+  getIntentEntry(intent) {
+    if (!this.has(intent)) return null;
+    return {
+      schema: this.intentSchemas.get(intent),
+      validators: this.intentValidators.get(intent),
+      hasSensors: this.intentSensors.has(intent),
+      builtin: IntentRouter.BUILTIN_INTENTS.has(intent),
+      kind: this.intentKinds.get(intent)
+    };
   }
   /**
    * Registers a handler for a specific intent.
@@ -491,6 +664,16 @@ var IntentRouter = class {
       } else {
         this.register(intentName, fn);
       }
+      this.registerIntentMeta(intentName, Object.getPrototypeOf(instance), String(route.methodName));
+    }
+    const proto = Object.getPrototypeOf(instance);
+    for (const key of Object.getOwnPropertyNames(proto)) {
+      const meta = Reflect.getMetadata(INTENT_METADATA_KEY, proto, key);
+      if (!meta?.intent) continue;
+      if (!this.handlers.has(meta.intent)) {
+        this.register(meta.intent, instance[key].bind(instance));
+      }
+      this.registerIntentMeta(meta.intent, proto, key);
     }
   }
   /**
@@ -514,6 +697,7 @@ var IntentRouter = class {
       intent = new TextDecoder().decode(intentBytes);
       let effect;
       if (intent === "system.ping" || intent === "public.ping") {
+        this.logger.debug("PING received");
         effect = {
           ok: true,
           effect: "pong",
@@ -554,6 +738,7 @@ var IntentRouter = class {
           if (!innerIntent) {
             throw new Error("INTENT.EXEC missing inner intent");
           }
+          this.logger.debug(`EXEC: routing to inner intent '${innerIntent}'`);
           const innerFrame = {
             ...frame,
             headers: new Map(frame.headers),
@@ -569,8 +754,23 @@ var IntentRouter = class {
         if (!handler) {
           throw new Error(`Intent not found: ${intent}`);
         }
+        const sensorClasses = this.intentSensors.get(intent);
+        if (sensorClasses && sensorClasses.length > 0) {
+          await this.runIntentSensors(sensorClasses, intent, frame);
+        }
+        const decoder = this.intentDecoders.get(intent);
+        let decodedBody = frame.body;
+        if (decoder) {
+          try {
+            decodedBody = decoder(Buffer.from(frame.body));
+          } catch (decodeErr) {
+            throw new Error(
+              `IntentBody decode failed for ${intent}: ${decodeErr.message}`
+            );
+          }
+        }
         if (typeof handler === "function") {
-          const resultBody = await handler(frame.body, frame.headers);
+          const resultBody = decoder ? await handler(decodedBody, frame.headers) : await handler(frame.body, frame.headers);
           effect = {
             ok: true,
             effect: "complete",
@@ -580,10 +780,7 @@ var IntentRouter = class {
           if (typeof handler.handle === "function") {
             effect = await handler.handle(frame);
           } else if (typeof handler.execute === "function") {
-            const bodyRes = await handler.execute(
-              frame.body,
-              frame.headers
-            );
+            const bodyRes = decoder ? await handler.execute(decodedBody, frame.headers) : await handler.execute(frame.body, frame.headers);
             effect = {
               ok: true,
               effect: "complete",
@@ -596,20 +793,130 @@ var IntentRouter = class {
           }
         }
       }
-      this.recordLatency(intent, start);
+      this.logIntent(intent, start, true);
       return effect;
     } catch (e) {
-      console.error(`Error routing intent ${intent}:`, e.message);
+      this.logIntent(intent, start, false, e.message);
       throw e;
     }
   }
-  recordLatency(intent, start) {
+  logIntent(intent, start, ok, error) {
     const diff = process.hrtime(start);
-    void diff;
+    const ms = (diff[0] * 1e3 + diff[1] / 1e6).toFixed(2);
+    if (ok) {
+      this.logger.debug(`${intent} completed in ${ms}ms`);
+    } else {
+      this.logger.warn(`${intent} failed in ${ms}ms - ${error}`);
+    }
+  }
+  registerIntentMeta(intent, proto, methodName) {
+    const decoder = Reflect.getMetadata(INTENT_BODY_KEY, proto, methodName);
+    if (decoder) {
+      this.intentDecoders.set(intent, decoder);
+    }
+    const sensors = Reflect.getMetadata(INTENT_SENSORS_KEY, proto, methodName);
+    if (sensors && Array.isArray(sensors) && sensors.length > 0) {
+      this.intentSensors.set(intent, sensors);
+    }
+    const meta = Reflect.getMetadata(INTENT_METADATA_KEY, proto, methodName);
+    if (meta) {
+      this.storeSchema(meta);
+      if (meta.kind) {
+        this.intentKinds.set(intent, meta.kind);
+      }
+    }
+  }
+  async runIntentSensors(sensorClasses, intent, frame) {
+    if (!this.moduleRef) return;
+    for (const SensorClass of sensorClasses) {
+      let sensor;
+      try {
+        sensor = this.moduleRef.get(SensorClass, { strict: false });
+      } catch {
+        this.logger.warn(
+          `@IntentSensors: could not resolve ${SensorClass.name} for ${intent}`
+        );
+        continue;
+      }
+      const sensorInput = {
+        rawBytes: frame.body,
+        intent,
+        body: frame.body,
+        headerTLVs: frame.headers,
+        metadata: { phase: "intent", intent }
+      };
+      if (sensor.supports && !sensor.supports(sensorInput)) continue;
+      const decision = normalizeSensorDecision(await sensor.run(sensorInput));
+      if (!decision.allow) {
+        const reason = decision.reasons[0] || `${sensor.name}:DENIED`;
+        this.logger.warn(
+          `Intent sensor ${sensor.name} denied ${intent}: ${reason}`
+        );
+        throw new Error(`SENSOR_DENY:${reason}`);
+      }
+    }
+  }
+  storeSchema(meta) {
+    if (meta.dto) {
+      if (meta.tlv && meta.tlv.length > 0) {
+        this.logger.warn(
+          `${meta.intent}: both 'dto' and 'tlv' specified - using dto, ignoring tlv`
+        );
+      }
+      const extracted = extractDtoSchema(meta.dto);
+      const schema2 = {
+        intent: meta.intent,
+        version: 1,
+        bodyProfile: meta.bodyProfile || "TLV_MAP",
+        fields: extracted.fields.map((f) => ({
+          name: f.name,
+          tlv: f.tag,
+          kind: f.kind,
+          required: f.required,
+          maxLen: f.maxLen,
+          max: f.max,
+          scope: f.scope
+        }))
+      };
+      this.intentSchemas.set(meta.intent, schema2);
+      if (extracted.validators.size > 0) {
+        this.intentValidators.set(meta.intent, extracted.validators);
+      }
+      if (!this.intentDecoders.has(meta.intent)) {
+        this.intentDecoders.set(meta.intent, buildDtoDecoder(meta.dto));
+      }
+      return;
+    }
+    if (!meta.tlv || meta.tlv.length === 0) return;
+    const schema = {
+      intent: meta.intent,
+      version: 1,
+      bodyProfile: meta.bodyProfile || "TLV_MAP",
+      fields: meta.tlv.map((f) => ({
+        name: f.name,
+        tlv: f.tag,
+        kind: f.kind,
+        required: f.required,
+        maxLen: f.maxLen,
+        max: f.max,
+        scope: f.scope
+      }))
+    };
+    this.intentSchemas.set(meta.intent, schema);
   }
 };
+/** Intents handled inline in route() — not in `handlers` map */
+IntentRouter.BUILTIN_INTENTS = /* @__PURE__ */ new Set([
+  "system.ping",
+  "public.ping",
+  "system.time",
+  "system.echo",
+  "INTENT.EXEC",
+  "axis.intent.exec"
+]);
 IntentRouter = __decorateClass([
-  (0, import_common2.Injectable)()
+  (0, import_common2.Injectable)(),
+  __decorateParam(0, (0, import_common2.Optional)())
 ], IntentRouter);
 
 // src/core/constants.ts
@@ -1985,105 +2292,6 @@ function buildPacket(hdr, body, sig, flags = 0) {
   };
 }
 
-// src/sensor/axis-sensor.ts
-var Decision = /* @__PURE__ */ ((Decision2) => {
-  Decision2["ALLOW"] = "ALLOW";
-  Decision2["DENY"] = "DENY";
-  Decision2["THROTTLE"] = "THROTTLE";
-  Decision2["FLAG"] = "FLAG";
-  return Decision2;
-})(Decision || {});
-function normalizeSensorDecision(sensorDecision) {
-  if ("action" in sensorDecision) {
-    switch (sensorDecision.action) {
-      case "ALLOW":
-        return {
-          allow: true,
-          riskScore: 0,
-          reasons: [],
-          meta: sensorDecision.meta
-        };
-      case "DENY":
-        return {
-          allow: false,
-          riskScore: 100,
-          reasons: [sensorDecision.code, sensorDecision.reason].filter(
-            Boolean
-          ),
-          meta: sensorDecision.meta,
-          retryAfterMs: sensorDecision.retryAfterMs
-        };
-      case "THROTTLE":
-        return {
-          allow: false,
-          riskScore: 50,
-          reasons: ["RATE_LIMIT"],
-          retryAfterMs: sensorDecision.retryAfterMs,
-          meta: sensorDecision.meta
-        };
-      case "FLAG":
-        return {
-          allow: true,
-          riskScore: sensorDecision.scoreDelta,
-          reasons: sensorDecision.reasons,
-          meta: sensorDecision.meta
-        };
-    }
-  }
-  return {
-    allow: sensorDecision.allow,
-    riskScore: sensorDecision.riskScore,
-    reasons: sensorDecision.reasons,
-    tags: sensorDecision.tags,
-    meta: sensorDecision.meta,
-    tighten: sensorDecision.tighten,
-    retryAfterMs: sensorDecision.retryAfterMs
-  };
-}
-var SensorDecisions = {
-  allow(meta, tags) {
-    return {
-      decision: "ALLOW" /* ALLOW */,
-      allow: true,
-      riskScore: 0,
-      reasons: [],
-      tags,
-      meta
-    };
-  },
-  deny(code, reason, meta) {
-    return {
-      decision: "DENY" /* DENY */,
-      allow: false,
-      riskScore: 100,
-      code,
-      reasons: [code, reason].filter(Boolean),
-      meta
-    };
-  },
-  throttle(retryAfterMs, meta) {
-    return {
-      decision: "THROTTLE" /* THROTTLE */,
-      allow: false,
-      riskScore: 50,
-      retryAfterMs,
-      code: "RATE_LIMIT",
-      reasons: ["RATE_LIMIT"],
-      meta
-    };
-  },
-  flag(scoreDelta, reasons, meta) {
-    return {
-      decision: "FLAG" /* FLAG */,
-      allow: true,
-      riskScore: scoreDelta,
-      scoreDelta,
-      reasons,
-      meta
-    };
-  }
-};
-
 // src/security/scopes.ts
 function hasScope(scopes, required) {
   if (!Array.isArray(scopes) || scopes.length === 0) {
@@ -2381,14 +2589,3066 @@ function isTimestampValid(ts, skewSeconds = 120) {
   const diff = Math.abs(now - ts);
   return diff <= skewSeconds;
 }
+
+// src/upload/axis-files.handlers.ts
+var import_common3 = require("@nestjs/common");
+var crypto2 = __toESM(require("crypto"));
+
+// src/upload/upload.tokens.ts
+var AXIS_UPLOAD_SESSION_STORE = "AXIS_UPLOAD_SESSION_STORE";
+var AXIS_UPLOAD_FILE_STORE = "AXIS_UPLOAD_FILE_STORE";
+var AXIS_UPLOAD_RECEIPT_SIGNER = "AXIS_UPLOAD_RECEIPT_SIGNER";
+
+// src/upload/axis-files.handlers.ts
+var AxisFilesDownloadHandler = class {
+  constructor(sessions, files) {
+    this.sessions = sessions;
+    this.files = files;
+    this.logger = new import_common3.Logger(AxisFilesDownloadHandler.name);
+    this.name = "axis.files.download";
+    this.open = true;
+    this.description = "File download handler";
+  }
+  async execute(body, headers) {
+    const h = headers;
+    if (!h) throw new Error("MISSING_HEADERS");
+    const uploadIdBytes = h.get(20);
+    if (!uploadIdBytes) throw new Error("MISSING_UPLOAD_ID");
+    const uploadId = new TextDecoder().decode(uploadIdBytes);
+    let rangeStart = 0;
+    let rangeLen = -1;
+    const startBytes = h.get(21);
+    if (startBytes) {
+      const { value } = (0, import_axis_protocol3.decodeVarint)(startBytes);
+      rangeStart = value;
+    }
+    const lenBytes = h.get(22);
+    if (lenBytes) {
+      const { value } = (0, import_axis_protocol3.decodeVarint)(lenBytes);
+      rangeLen = value;
+    }
+    const session = await this.sessions.findByFileId(uploadId);
+    if (!session) {
+      throw new Error(`SESSION_NOT_FOUND: ${uploadId}`);
+    }
+    if (session.status !== "COMPLETE") {
+      throw new Error(`FILE_NOT_READY: Status is ${session.status}`);
+    }
+    const stat = await this.files.statFinal(
+      uploadId,
+      session.filename
+    );
+    const fileSize = stat.size;
+    if (rangeStart < 0) rangeStart = 0;
+    if (rangeStart >= fileSize) throw new Error("RANGE_OUT_OF_BOUNDS");
+    let end = fileSize;
+    if (rangeLen >= 0) {
+      end = Math.min(rangeStart + rangeLen, fileSize);
+    }
+    const actualLen = end - rangeStart;
+    const buffer = await this.files.readFinalRange(
+      uploadId,
+      session.filename,
+      rangeStart,
+      actualLen
+    );
+    const responseHeaders = /* @__PURE__ */ new Map();
+    responseHeaders.set(30, (0, import_axis_protocol3.encodeVarint)(fileSize));
+    responseHeaders.set(31, (0, import_axis_protocol3.encodeVarint)(rangeStart));
+    responseHeaders.set(32, (0, import_axis_protocol3.encodeVarint)(actualLen));
+    return {
+      ok: true,
+      effect: "FILE_PART",
+      body: buffer,
+      headers: responseHeaders
+    };
+  }
+};
+__decorateClass([
+  Intent("file.download", { absolute: true, kind: "read" })
+], AxisFilesDownloadHandler.prototype, "execute", 1);
+AxisFilesDownloadHandler = __decorateClass([
+  Handler("axis.files.download"),
+  (0, import_common3.Injectable)(),
+  __decorateParam(0, (0, import_common3.Inject)(AXIS_UPLOAD_SESSION_STORE)),
+  __decorateParam(1, (0, import_common3.Inject)(AXIS_UPLOAD_FILE_STORE))
+], AxisFilesDownloadHandler);
+var AxisFilesFinalizeHandler = class {
+  constructor(sessions, files, keyring) {
+    this.sessions = sessions;
+    this.files = files;
+    this.keyring = keyring;
+    this.logger = new import_common3.Logger(AxisFilesFinalizeHandler.name);
+    this.name = "axis.files.finalize";
+    this.open = false;
+    this.description = "File upload finalization handler";
+  }
+  async execute(body, headers) {
+    const bodyStr = new TextDecoder().decode(body);
+    const req = JSON.parse(bodyStr);
+    const { fileId, expectedHash } = req;
+    if (!fileId) throw new Error("MISSING_FILE_ID");
+    const session = await this.sessions.findByFileId(fileId);
+    if (!session) throw new Error("SESSION_NOT_FOUND");
+    if (!await this.files.hasTemp(fileId)) {
+      throw new Error("CHUNKS_NOT_FOUND");
+    }
+    const hash = crypto2.createHash("sha256");
+    const rs = this.files.createTempReadStream(fileId);
+    for await (const chunk of rs) {
+      hash.update(chunk);
+    }
+    const finalHash = hash.digest("hex");
+    if (expectedHash && finalHash !== expectedHash) {
+      throw new Error("HASH_MISMATCH");
+    }
+    const finalPath = await this.files.moveTempToFinal(
+      fileId,
+      session.filename
+    );
+    await this.sessions.updateStatus(fileId, "COMPLETE", null);
+    if (!this.keyring) {
+      this.logger.warn("Receipt signer not configured; returning unsigned receipt");
+      return {
+        ok: true,
+        effect: "FILE_FINALIZED",
+        body: new TextEncoder().encode(
+          JSON.stringify({
+            uploadId: fileId,
+            sha256_final: finalHash,
+            totalSize: session.totalSize,
+            tsMs: Date.now(),
+            path: finalPath
+          })
+        )
+      };
+    }
+    const receiptData = {
+      uploadId: fileId,
+      sha256_final: finalHash,
+      totalSize: session.totalSize,
+      tsMs: Date.now()
+    };
+    const receiptJson = JSON.stringify(receiptData);
+    const receiptBody = new TextEncoder().encode(receiptJson);
+    const SIG_PRESENT = 1;
+    const responseFrame = {
+      flags: SIG_PRESENT,
+      headers: /* @__PURE__ */ new Map(),
+      body: receiptBody,
+      sig: new Uint8Array(0)
+    };
+    const signTarget = getSignTarget(responseFrame);
+    const { sig, kid } = this.keyring.signActive(signTarget);
+    responseFrame.sig = sig;
+    return {
+      ok: true,
+      effect: "FILE_FINALIZED",
+      data: encodeFrame(responseFrame),
+      headers: /* @__PURE__ */ new Map([[1, new TextEncoder().encode(kid)]])
+    };
+  }
+};
+__decorateClass([
+  Intent("file.finalize", { absolute: true, kind: "action" })
+], AxisFilesFinalizeHandler.prototype, "execute", 1);
+AxisFilesFinalizeHandler = __decorateClass([
+  Handler("axis.files.finalize"),
+  (0, import_common3.Injectable)(),
+  __decorateParam(0, (0, import_common3.Inject)(AXIS_UPLOAD_SESSION_STORE)),
+  __decorateParam(1, (0, import_common3.Inject)(AXIS_UPLOAD_FILE_STORE)),
+  __decorateParam(2, (0, import_common3.Optional)()),
+  __decorateParam(2, (0, import_common3.Inject)(AXIS_UPLOAD_RECEIPT_SIGNER))
+], AxisFilesFinalizeHandler);
+
+// src/upload/disk-upload-file.store.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var DiskUploadFileStore = class {
+  constructor(options) {
+    this.uploadDir = options.uploadDir;
+    this.chunkDir = options.chunkDir;
+  }
+  getFinalPath(fileId, filename) {
+    const safeFilename = filename ? path.basename(filename) : fileId;
+    return path.join(this.uploadDir, safeFilename);
+  }
+  getTempPath(fileId) {
+    const safeId = path.basename(fileId);
+    return path.join(this.chunkDir, safeId);
+  }
+  async statFinal(fileId, filename) {
+    const finalPath = this.getFinalPath(fileId, filename);
+    if (!fs.existsSync(finalPath)) {
+      throw new Error("FILE_MISSING_ON_DISK");
+    }
+    const stat = fs.statSync(finalPath);
+    return { path: finalPath, size: stat.size };
+  }
+  async readFinalRange(fileId, filename, start, length) {
+    const finalPath = this.getFinalPath(fileId, filename);
+    const buffer = Buffer.alloc(length);
+    const fd = fs.openSync(finalPath, "r");
+    try {
+      fs.readSync(fd, buffer, 0, length, start);
+    } finally {
+      fs.closeSync(fd);
+    }
+    return buffer;
+  }
+  async hasTemp(fileId) {
+    const tempPath = this.getTempPath(fileId);
+    return fs.existsSync(tempPath);
+  }
+  async moveTempToFinal(fileId, filename) {
+    const tempPath = this.getTempPath(fileId);
+    const finalPath = this.getFinalPath(fileId, filename);
+    try {
+      await fs.promises.rename(tempPath, finalPath);
+    } catch {
+      await fs.promises.copyFile(tempPath, finalPath);
+      await fs.promises.unlink(tempPath);
+    }
+    return finalPath;
+  }
+  createTempReadStream(fileId) {
+    const tempPath = this.getTempPath(fileId);
+    return fs.createReadStream(tempPath);
+  }
+};
+
+// src/core/index.ts
+var core_exports = {};
+__export(core_exports, {
+  AXIS_MAGIC: () => import_axis_protocol2.AXIS_MAGIC,
+  AXIS_VERSION: () => import_axis_protocol2.AXIS_VERSION,
+  AxisError: () => AxisError,
+  AxisFrameZ: () => AxisFrameZ,
+  BodyProfile: () => import_axis_protocol2.BodyProfile,
+  ERR_BAD_SIGNATURE: () => import_axis_protocol2.ERR_BAD_SIGNATURE,
+  ERR_CONTRACT_VIOLATION: () => import_axis_protocol2.ERR_CONTRACT_VIOLATION,
+  ERR_INVALID_PACKET: () => import_axis_protocol2.ERR_INVALID_PACKET,
+  ERR_REPLAY_DETECTED: () => import_axis_protocol2.ERR_REPLAY_DETECTED,
+  FLAG_BODY_TLV: () => import_axis_protocol2.FLAG_BODY_TLV,
+  FLAG_CHAIN_REQ: () => import_axis_protocol2.FLAG_CHAIN_REQ,
+  FLAG_HAS_WITNESS: () => import_axis_protocol2.FLAG_HAS_WITNESS,
+  MAX_BODY_LEN: () => import_axis_protocol2.MAX_BODY_LEN,
+  MAX_FRAME_LEN: () => import_axis_protocol2.MAX_FRAME_LEN,
+  MAX_HDR_LEN: () => import_axis_protocol2.MAX_HDR_LEN,
+  MAX_SIG_LEN: () => import_axis_protocol2.MAX_SIG_LEN,
+  NCERT_ALG: () => import_axis_protocol2.NCERT_ALG,
+  NCERT_EXP: () => import_axis_protocol2.NCERT_EXP,
+  NCERT_ISSUER_KID: () => import_axis_protocol2.NCERT_ISSUER_KID,
+  NCERT_KID: () => import_axis_protocol2.NCERT_KID,
+  NCERT_NBF: () => import_axis_protocol2.NCERT_NBF,
+  NCERT_NODE_ID: () => import_axis_protocol2.NCERT_NODE_ID,
+  NCERT_PAYLOAD: () => import_axis_protocol2.NCERT_PAYLOAD,
+  NCERT_PUB: () => import_axis_protocol2.NCERT_PUB,
+  NCERT_SCOPE: () => import_axis_protocol2.NCERT_SCOPE,
+  NCERT_SIG: () => import_axis_protocol2.NCERT_SIG,
+  PROOF_CAPSULE: () => import_axis_protocol2.PROOF_CAPSULE,
+  PROOF_JWT: () => import_axis_protocol2.PROOF_JWT,
+  PROOF_LOOM: () => import_axis_protocol2.PROOF_LOOM,
+  PROOF_MTLS: () => import_axis_protocol2.PROOF_MTLS,
+  PROOF_NONE: () => import_axis_protocol2.PROOF_NONE,
+  PROOF_WITNESS: () => import_axis_protocol2.PROOF_WITNESS,
+  ProofType: () => import_axis_protocol2.ProofType,
+  TLV: () => import_axis_protocol.TLV,
+  TLV_ACTOR_ID: () => import_axis_protocol2.TLV_ACTOR_ID,
+  TLV_AUD: () => import_axis_protocol2.TLV_AUD,
+  TLV_BODY_ARR: () => import_axis_protocol2.TLV_BODY_ARR,
+  TLV_BODY_OBJ: () => import_axis_protocol2.TLV_BODY_OBJ,
+  TLV_CAPSULE: () => import_axis_protocol2.TLV_CAPSULE,
+  TLV_EFFECT: () => import_axis_protocol2.TLV_EFFECT,
+  TLV_ERROR_CODE: () => import_axis_protocol2.TLV_ERROR_CODE,
+  TLV_ERROR_MSG: () => import_axis_protocol2.TLV_ERROR_MSG,
+  TLV_INDEX: () => import_axis_protocol2.TLV_INDEX,
+  TLV_INTENT: () => import_axis_protocol2.TLV_INTENT,
+  TLV_KID: () => import_axis_protocol2.TLV_KID,
+  TLV_LOOM_PRESENCE_ID: () => import_axis_protocol2.TLV_LOOM_PRESENCE_ID,
+  TLV_LOOM_THREAD_HASH: () => import_axis_protocol2.TLV_LOOM_THREAD_HASH,
+  TLV_LOOM_WRIT: () => import_axis_protocol2.TLV_LOOM_WRIT,
+  TLV_NODE: () => import_axis_protocol2.TLV_NODE,
+  TLV_NODE_CERT_HASH: () => import_axis_protocol2.TLV_NODE_CERT_HASH,
+  TLV_NODE_KID: () => import_axis_protocol2.TLV_NODE_KID,
+  TLV_NONCE: () => import_axis_protocol2.TLV_NONCE,
+  TLV_OFFSET: () => import_axis_protocol2.TLV_OFFSET,
+  TLV_OK: () => import_axis_protocol2.TLV_OK,
+  TLV_PID: () => import_axis_protocol2.TLV_PID,
+  TLV_PREV_HASH: () => import_axis_protocol2.TLV_PREV_HASH,
+  TLV_PROOF_REF: () => import_axis_protocol2.TLV_PROOF_REF,
+  TLV_PROOF_TYPE: () => import_axis_protocol2.TLV_PROOF_TYPE,
+  TLV_REALM: () => import_axis_protocol2.TLV_REALM,
+  TLV_RECEIPT_HASH: () => import_axis_protocol2.TLV_RECEIPT_HASH,
+  TLV_RID: () => import_axis_protocol2.TLV_RID,
+  TLV_SHA256_CHUNK: () => import_axis_protocol2.TLV_SHA256_CHUNK,
+  TLV_TRACE_ID: () => import_axis_protocol2.TLV_TRACE_ID,
+  TLV_TS: () => import_axis_protocol2.TLV_TS,
+  TLV_UPLOAD_ID: () => import_axis_protocol2.TLV_UPLOAD_ID,
+  computeReceiptHash: () => computeReceiptHash,
+  computeSignaturePayload: () => computeSignaturePayload,
+  decodeArray: () => import_axis_protocol.decodeArray,
+  decodeFrame: () => decodeFrame,
+  decodeObject: () => import_axis_protocol.decodeObject,
+  decodeTLVs: () => import_axis_protocol.decodeTLVs,
+  decodeTLVsList: () => import_axis_protocol.decodeTLVsList,
+  decodeVarint: () => import_axis_protocol3.decodeVarint,
+  encodeFrame: () => encodeFrame,
+  encodeTLVs: () => import_axis_protocol.encodeTLVs,
+  encodeVarint: () => import_axis_protocol3.encodeVarint,
+  generateEd25519KeyPair: () => generateEd25519KeyPair,
+  getSignTarget: () => getSignTarget,
+  sha256: () => sha256,
+  signFrame: () => signFrame,
+  varintLength: () => import_axis_protocol3.varintLength,
+  verifyFrameSignature: () => verifyFrameSignature
+});
+
+// src/core/axis-error.ts
+var AxisError = class extends Error {
+  constructor(code, message, httpStatus = 400, details) {
+    super(message);
+    this.code = code;
+    this.httpStatus = httpStatus;
+    this.details = details;
+    this.name = "AxisError";
+  }
+};
+
+// src/crypto/index.ts
+var crypto_exports = {};
+__export(crypto_exports, {
+  ProofVerificationService: () => ProofVerificationService,
+  b64urlDecode: () => b64urlDecode,
+  b64urlDecodeString: () => b64urlDecodeString,
+  b64urlEncode: () => b64urlEncode,
+  b64urlEncodeString: () => b64urlEncodeString,
+  canonicalJson: () => canonicalJson,
+  canonicalJsonExcluding: () => canonicalJsonExcluding
+});
+
+// src/crypto/proof-verification.service.ts
+var import_common4 = require("@nestjs/common");
+var crypto3 = __toESM(require("crypto"));
+var nacl = __toESM(require("tweetnacl"));
+var ProofVerificationService = class {
+  constructor() {
+    this.logger = new import_common4.Logger(ProofVerificationService.name);
+    // Cache of registered device public keys (deviceId -> pubKey)
+    this.deviceKeys = /* @__PURE__ */ new Map();
+    // Cache of trusted mTLS certificate fingerprints
+    this.trustedCerts = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Verifies an authentication proof based on its type.
+   *
+   * **Supported Types:**
+   * - 1 (CAPSULE): Delegated to `verifyCapsuleProof`
+   * - 2 (JWT): Verified by `verifyJWTProof`
+   * - 3 (MTLS_ID): Verified by `verifyMTLSProof`
+   * - 4 (DEVICE_SE): Verified by `verifyDeviceSEProof`
+   *
+   * @param {ProofType} proofType - The numeric AXIS proof type
+   * @param {Uint8Array} proofRef - The binary reference or token for the proof
+   * @param {Object} context - Additional metadata required for specific proof types
+   * @param {Uint8Array} [context.signTarget] - The canonical bytes that were signed (for Ed25519)
+   * @param {Uint8Array} [context.signature] - The signature to verify (for Ed25519)
+   * @param {MTLSContext} [context.mtls] - mTLS certificate data
+   * @param {DeviceSEContext} [context.deviceSE] - Device Secure Element information
+   * @returns {Promise<ProofVerificationResult>} The outcome of the verification
+   */
+  async verifyProof(proofType, proofRef, context) {
+    switch (proofType) {
+      case 1:
+        return this.verifyCapsuleProof(proofRef);
+      case 2:
+        return this.verifyJWTProof(proofRef);
+      case 3:
+        return this.verifyMTLSProof(context.mtls);
+      case 4:
+        return this.verifyDeviceSEProof(
+          context.signTarget,
+          context.signature,
+          context.deviceSE
+        );
+      default:
+        return { valid: false, error: `Unknown proof type: ${proofType}` };
+    }
+  }
+  /**
+   * Verify CAPSULE proof (delegated to CapsuleService)
+   */
+  async verifyCapsuleProof(proofRef) {
+    const capsuleId = new TextDecoder().decode(proofRef);
+    return {
+      valid: true,
+      metadata: { capsuleId, requiresCapsuleValidation: true }
+    };
+  }
+  /**
+   * Verifies a JSON Web Token (JWT) proof.
+   *
+   * **Validation Logic:**
+   * 1. Decodes the token string.
+   * 2. Checks for valid 3-part JWT structure.
+   * 3. Validates `exp` (expiration) and `nbf` (not before) claims.
+   * 4. Extracts `actor_id` or `sub` as the identity.
+   *
+   * @param {Uint8Array} proofRef - Binary representation of the JWT string
+   * @returns {Promise<ProofVerificationResult>} Result including the actor identifier
+   */
+  async verifyJWTProof(proofRef) {
+    try {
+      const token = new TextDecoder().decode(proofRef);
+      const parts = token.split(".");
+      if (parts.length !== 3) {
+        return { valid: false, error: "Invalid JWT format" };
+      }
+      const header = JSON.parse(Buffer.from(parts[0], "base64url").toString());
+      const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString());
+      if (payload.exp && Date.now() / 1e3 > payload.exp) {
+        return { valid: false, error: "JWT expired" };
+      }
+      if (payload.nbf && Date.now() / 1e3 < payload.nbf) {
+        return { valid: false, error: "JWT not yet valid" };
+      }
+      return {
+        valid: true,
+        actorId: payload.sub || payload.actor_id,
+        metadata: { iss: payload.iss, scope: payload.scope }
+      };
+    } catch (e) {
+      const message = e instanceof Error ? e.message : "Unknown error";
+      return { valid: false, error: `JWT parse error: ${message}` };
+    }
+  }
+  /**
+   * Verify mTLS client certificate proof
+   */
+  async verifyMTLSProof(mtls) {
+    if (!mtls) {
+      return { valid: false, error: "No mTLS context provided" };
+    }
+    if (!mtls.verified) {
+      return { valid: false, error: "mTLS not verified by TLS terminator" };
+    }
+    if (mtls.clientCertFingerprint) {
+      const trusted = this.trustedCerts.get(mtls.clientCertFingerprint);
+      if (trusted) {
+        return {
+          valid: true,
+          actorId: trusted.actorId,
+          metadata: {
+            fingerprint: mtls.clientCertFingerprint,
+            subject: mtls.clientCertSubject
+          }
+        };
+      }
+    }
+    if (mtls.clientCertSubject) {
+      const cnMatch = mtls.clientCertSubject.match(/CN=([^,]+)/);
+      if (cnMatch) {
+        return {
+          valid: true,
+          actorId: cnMatch[1],
+          metadata: {
+            subject: mtls.clientCertSubject,
+            issuer: mtls.clientCertIssuer
+          }
+        };
+      }
+    }
+    return { valid: false, error: "Could not extract actor from certificate" };
+  }
+  /**
+   * Verify Device Secure Element signature
+   */
+  async verifyDeviceSEProof(signTarget, signature, deviceSE) {
+    if (!deviceSE || !signTarget || !signature) {
+      return { valid: false, error: "Missing Device SE context" };
+    }
+    let publicKey = deviceSE.publicKey;
+    const registeredKey = this.deviceKeys.get(deviceSE.deviceId);
+    if (registeredKey) {
+      publicKey = registeredKey;
+    }
+    if (!publicKey || publicKey.length !== 32) {
+      return {
+        valid: false,
+        error: "Invalid or unregistered device public key"
+      };
+    }
+    try {
+      const valid = nacl.sign.detached.verify(signTarget, signature, publicKey);
+      if (!valid) {
+        return { valid: false, error: "Device signature verification failed" };
+      }
+      return {
+        valid: true,
+        actorId: deviceSE.deviceId,
+        metadata: { deviceId: deviceSE.deviceId, proofType: "DEVICE_SE" }
+      };
+    } catch (e) {
+      const message = e instanceof Error ? e.message : "Unknown error";
+      return {
+        valid: false,
+        error: `Signature verification error: ${message}`
+      };
+    }
+  }
+  /**
+   * Registers a public key for a trusted device.
+   * This key will be used for future `DEVICE_SE` proof verifications.
+   *
+   * @param {string} deviceId - Unique identifier for the device
+   * @param {Uint8Array} publicKey - 32-byte Ed25519 public key
+   * @throws {Error} If the public key is not 32 bytes
+   */
+  registerDeviceKey(deviceId, publicKey) {
+    if (publicKey.length !== 32) {
+      throw new Error("Device public key must be 32 bytes (Ed25519)");
+    }
+    this.deviceKeys.set(deviceId, publicKey);
+    this.logger.log(`Registered device key for ${deviceId}`);
+  }
+  /**
+   * Unregister a device
+   */
+  unregisterDevice(deviceId) {
+    return this.deviceKeys.delete(deviceId);
+  }
+  /**
+   * Registers a trusted mTLS certificate fingerprint and associates it with an actor.
+   *
+   * @param {string} fingerprint - SHA-256 fingerprint of the client certificate
+   * @param {string} actorId - The actor to associate with this certificate
+   */
+  registerMTLSCert(fingerprint, actorId) {
+    this.trustedCerts.set(fingerprint, { actorId, issuedAt: Date.now() });
+    this.logger.log(`Registered mTLS cert ${fingerprint} for actor ${actorId}`);
+  }
+  /**
+   * Revoke an mTLS certificate
+   */
+  revokeMTLSCert(fingerprint) {
+    return this.trustedCerts.delete(fingerprint);
+  }
+  /**
+   * Calculate certificate fingerprint (SHA-256)
+   */
+  static calculateFingerprint(certPem) {
+    const der = Buffer.from(
+      certPem.replace(/-----BEGIN CERTIFICATE-----/, "").replace(/-----END CERTIFICATE-----/, "").replace(/\s/g, ""),
+      "base64"
+    );
+    return crypto3.createHash("sha256").update(der).digest("hex");
+  }
+};
+ProofVerificationService = __decorateClass([
+  (0, import_common4.Injectable)()
+], ProofVerificationService);
+
+// src/decorators/index.ts
+var decorators_exports = {};
+__export(decorators_exports, {
+  AxisContext: () => AxisContext,
+  AxisDemoPubkey: () => AxisDemoPubkey,
+  AxisFrame: () => AxisFrame3,
+  AxisIp: () => AxisIp,
+  AxisRaw: () => AxisRaw,
+  HANDLER_METADATA_KEY: () => HANDLER_METADATA_KEY,
+  Handler: () => Handler,
+  INTENT_BODY_KEY: () => INTENT_BODY_KEY,
+  INTENT_METADATA_KEY: () => INTENT_METADATA_KEY,
+  INTENT_ROUTES_KEY: () => INTENT_ROUTES_KEY,
+  INTENT_SENSORS_KEY: () => INTENT_SENSORS_KEY,
+  Intent: () => Intent,
+  IntentBody: () => IntentBody,
+  IntentSensors: () => IntentSensors,
+  SENSOR_METADATA_KEY: () => SENSOR_METADATA_KEY,
+  Sensor: () => Sensor,
+  TLV_FIELDS_KEY: () => TLV_FIELDS_KEY,
+  TLV_VALIDATORS_KEY: () => TLV_VALIDATORS_KEY,
+  TlvEnum: () => TlvEnum,
+  TlvField: () => TlvField,
+  TlvMinLen: () => TlvMinLen,
+  TlvRange: () => TlvRange,
+  TlvUtf8Pattern: () => TlvUtf8Pattern,
+  TlvValidate: () => TlvValidate,
+  buildDtoDecoder: () => buildDtoDecoder,
+  extractDtoSchema: () => extractDtoSchema
+});
+
+// src/decorators/axis-request.decorator.ts
+var import_common5 = require("@nestjs/common");
+function resolveIp(req) {
+  return req.headers["x-forwarded-for"]?.split(",")[0]?.trim() || req.headers["x-real-ip"] || req.socket.remoteAddress || void 0;
+}
+var AxisRaw = (0, import_common5.createParamDecorator)(
+  (_data, ctx) => {
+    const req = ctx.switchToHttp().getRequest();
+    return req.body;
+  }
+);
+var AxisIp = (0, import_common5.createParamDecorator)(
+  (_data, ctx) => {
+    const req = ctx.switchToHttp().getRequest();
+    return resolveIp(req);
+  }
+);
+var AxisContext = (0, import_common5.createParamDecorator)(
+  (_data, ctx) => {
+    const req = ctx.switchToHttp().getRequest();
+    const axisData = req.axis || {};
+    return {
+      raw: req.body,
+      ip: resolveIp(req),
+      preDecodeInput: axisData.preDecodeInput,
+      frameBytesCount: axisData.frameBytesCount || 0
+    };
+  }
+);
+var AxisDemoPubkey = (0, import_common5.createParamDecorator)(
+  (_data, ctx) => {
+    if (process.env.NODE_ENV !== "development") return void 0;
+    const req = ctx.switchToHttp().getRequest();
+    return req.headers["x-demo-pubkey"];
+  }
+);
+var AxisFrame3 = (0, import_common5.createParamDecorator)(
+  (_data, ctx) => {
+    const req = ctx.switchToHttp().getRequest();
+    const decoded = req.axisDecoded;
+    if (!decoded) {
+      throw new Error(
+        "@AxisFrame() requires AxisDecodeInterceptor on the route. Add @UseInterceptors(AxisDecodeInterceptor) to use this decorator."
+      );
+    }
+    return decoded;
+  }
+);
+
+// src/decorators/sensor.decorator.ts
+var import_common6 = require("@nestjs/common");
+var SENSOR_METADATA_KEY = "axis:sensor";
+function Sensor(options) {
+  return (0, import_common6.SetMetadata)(SENSOR_METADATA_KEY, options ?? true);
+}
+
+// src/engine/index.ts
+var engine_exports = {};
+__export(engine_exports, {
+  BAND: () => BAND,
+  HandlerDiscoveryService: () => HandlerDiscoveryService,
+  IntentRouter: () => IntentRouter,
+  PRE_DECODE_BOUNDARY: () => PRE_DECODE_BOUNDARY,
+  SensorDiscoveryService: () => SensorDiscoveryService,
+  SensorRegistry: () => SensorRegistry,
+  createObservation: () => createObservation,
+  endStage: () => endStage,
+  finalizeObservation: () => finalizeObservation,
+  recordSensor: () => recordSensor,
+  startStage: () => startStage
+});
+
+// src/engine/axis-observation.ts
+var import_crypto4 = require("crypto");
+function createObservation(transport, ip) {
+  return {
+    id: (0, import_crypto4.randomBytes)(16).toString("hex"),
+    startMs: Date.now(),
+    transport,
+    ip,
+    stages: [],
+    sensors: [],
+    facts: {}
+  };
+}
+function startStage(obs, name) {
+  const stage = { name, status: "ok", startMs: Date.now() };
+  obs.stages.push(stage);
+  return stage;
+}
+function endStage(stage, status = "ok", reason, code) {
+  stage.endMs = Date.now();
+  stage.durationMs = stage.endMs - stage.startMs;
+  stage.status = status;
+  if (reason) stage.reason = reason;
+  if (code) stage.code = code;
+}
+function recordSensor(obs, name, allowed, riskScore, durationMs, reasons, code) {
+  obs.sensors.push({ name, allowed, riskScore, durationMs, reasons, code });
+}
+function finalizeObservation(obs, decision, statusCode, resultCode) {
+  obs.endMs = Date.now();
+  obs.durationMs = obs.endMs - obs.startMs;
+  obs.decision = decision;
+  obs.statusCode = statusCode;
+  if (resultCode) obs.resultCode = resultCode;
+}
+
+// src/engine/handler-discovery.service.ts
+var import_common7 = require("@nestjs/common");
+var HandlerDiscoveryService = class {
+  constructor(discovery, scanner, router) {
+    this.discovery = discovery;
+    this.scanner = scanner;
+    this.router = router;
+    this.logger = new import_common7.Logger(HandlerDiscoveryService.name);
+  }
+  onModuleInit() {
+    const providers = this.discovery.getProviders();
+    let totalIntents = 0;
+    for (const wrapper of providers) {
+      const { instance, metatype } = wrapper;
+      if (!instance || !metatype) continue;
+      const handlerMeta = Reflect.getMetadata(HANDLER_METADATA_KEY, metatype);
+      if (!handlerMeta) continue;
+      const handlerName = handlerMeta.intent || metatype.name;
+      const proto = Object.getPrototypeOf(instance);
+      const methods = this.scanner.getAllMethodNames(proto);
+      let registered = 0;
+      for (const methodName of methods) {
+        const meta = Reflect.getMetadata(
+          INTENT_METADATA_KEY,
+          proto,
+          methodName
+        );
+        if (!meta?.intent) continue;
+        if (!this.router.has(meta.intent)) {
+          this.router.register(
+            meta.intent,
+            instance[methodName].bind(instance)
+          );
+          registered++;
+          totalIntents++;
+        }
+        this.router.registerIntentMeta(meta.intent, proto, methodName);
+      }
+      if (registered > 0) {
+        this.logger.log(
+          `Auto-registered ${registered} intents from ${handlerName}`
+        );
+      }
+    }
+    this.logger.log(
+      `Handler discovery complete: ${totalIntents} intents auto-registered`
+    );
+  }
+};
+HandlerDiscoveryService = __decorateClass([
+  (0, import_common7.Injectable)()
+], HandlerDiscoveryService);
+
+// src/engine/sensor-bands.ts
+var BAND = {
+  /** Pre-decode: raw byte validation, geo, budget, magic */
+  WIRE: 0,
+  /** Post-decode: identity resolution, capsule, proof */
+  IDENTITY: 40,
+  /** Post-decode: authorization, signature, rate limiting */
+  POLICY: 90,
+  /** Post-decode: content validation, TLV, schema, files */
+  CONTENT: 140,
+  /** Post-decode: business logic sensors, streams, WS */
+  BUSINESS: 200,
+  /** Post-decode: audit, logging (always last) */
+  AUDIT: 900
+};
+var PRE_DECODE_BOUNDARY = 40;
+
+// src/engine/sensor-discovery.service.ts
+var import_common8 = require("@nestjs/common");
+var SensorDiscoveryService = class {
+  constructor(discovery, reflector, registry) {
+    this.discovery = discovery;
+    this.reflector = reflector;
+    this.registry = registry;
+    this.logger = new import_common8.Logger(SensorDiscoveryService.name);
+  }
+  onApplicationBootstrap() {
+    const providers = this.discovery.getProviders();
+    let count = 0;
+    for (const wrapper of providers) {
+      const { instance } = wrapper;
+      if (!instance || !instance.constructor) continue;
+      const meta = this.reflector.get(
+        SENSOR_METADATA_KEY,
+        instance.constructor
+      );
+      if (!meta) continue;
+      const sensor = instance;
+      if (!sensor.name || sensor.order === void 0) {
+        this.logger.warn(
+          `@Sensor() on ${instance.constructor.name} missing name or order \u2014 skipped`
+        );
+        continue;
+      }
+      if (!sensor.phase) {
+        const decoratorPhase = meta !== true ? meta.phase : void 0;
+        sensor.phase = decoratorPhase ?? (sensor.order < PRE_DECODE_BOUNDARY ? "PRE_DECODE" : "POST_DECODE");
+      }
+      this.registry.register(sensor);
+      count++;
+    }
+    this.logger.log(`Auto-registered ${count} sensors via @Sensor()`);
+  }
+};
+SensorDiscoveryService = __decorateClass([
+  (0, import_common8.Injectable)()
+], SensorDiscoveryService);
+
+// src/engine/registry/sensor.registry.ts
+var import_common9 = require("@nestjs/common");
+var SensorRegistry = class {
+  constructor(configService) {
+    this.configService = configService;
+    this.sensors = [];
+    this.logger = new import_common9.Logger(SensorRegistry.name);
+  }
+  /**
+   * Registers a new sensor in the registry.
+   *
+   * Validates that:
+   * - AxisSensor has a unique name
+   * - AxisSensor has an order field
+   * - Pre-decode sensors have order < 40
+   * - Post-decode sensors have order >= 40
+   *
+   * @param {AxisSensor} sensor - The sensor instance to register
+   * @throws Error if validation fails
+   */
+  register(sensor) {
+    if (!sensor.name) {
+      throw new Error("AxisSensor must have a name");
+    }
+    const enabledSensorsStr = this.configService.get("ENABLED_SENSORS");
+    const disabledSensorsStr = this.configService.get("DISABLED_SENSORS");
+    const enabledSensors = enabledSensorsStr ? enabledSensorsStr.split(",").map((s) => s.trim()) : null;
+    const disabledSensors = disabledSensorsStr ? disabledSensorsStr.split(",").map((s) => s.trim()) : [];
+    if (enabledSensors && !enabledSensors.includes(sensor.name)) {
+      this.logger.log(`Skipping disabled sensor (not in ENABLED_SENSORS): ${sensor.name}`);
+      return;
+    }
+    if (disabledSensors.includes(sensor.name)) {
+      this.logger.log(`Skipping disabled sensor (in DISABLED_SENSORS): ${sensor.name}`);
+      return;
+    }
+    if (sensor.order === void 0) {
+      throw new Error(`AxisSensor "${sensor.name}" must have an order field`);
+    }
+    const isPreDecodeSensor = this.isPreDecodeSensor(sensor);
+    const isPostDecodeSensor = this.isPostDecodeSensor(sensor);
+    if (isPreDecodeSensor && sensor.order >= 40) {
+      this.logger.warn(
+        `AxisSensor "${sensor.name}" is marked as PRE_DECODE but has order ${sensor.order} (should be < 40)`
+      );
+    }
+    if (isPostDecodeSensor && sensor.order < 40) {
+      this.logger.warn(
+        `AxisSensor "${sensor.name}" is marked as POST_DECODE but has order ${sensor.order} (should be >= 40)`
+      );
+    }
+    this.sensors.push(sensor);
+    const phaseLabel = typeof sensor.phase === "string" ? sensor.phase : sensor.phase?.phase || "UNKNOWN";
+    this.logger.debug(
+      `Registered sensor: ${sensor.name} (order: ${sensor.order}, phase: ${phaseLabel})`
+    );
+  }
+  /**
+   * Returns all registered sensors, sorted by their execution order.
+   *
+   * @returns {AxisSensor[]} A sorted array of sensors
+   */
+  list() {
+    return [...this.sensors].sort(
+      (a, b) => (a.order ?? 999) - (b.order ?? 999)
+    );
+  }
+  /**
+   * Returns only pre-decode sensors (order < 40).
+   * These sensors run in middleware on raw bytes before frame decoding.
+   *
+   * @returns {AxisPreSensor[]} Pre-decode sensors sorted by order
+   */
+  getPreDecodeSensors() {
+    return this.list().filter((s) => (s.order ?? 999) < 40);
+  }
+  /**
+   * Returns only post-decode sensors (order >= 40).
+   * These sensors run in the controller on fully decoded frames.
+   *
+   * @returns {AxisPostSensor[]} Post-decode sensors sorted by order
+   */
+  getPostDecodeSensors() {
+    return this.list().filter(
+      (s) => (s.order ?? 999) >= 40
+    );
+  }
+  /**
+   * Helper: Check if a sensor is a pre-decode sensor.
+   *
+   * @private
+   * @param {AxisSensor} sensor - The sensor to check
+   * @returns {boolean} True if sensor is pre-decode
+   */
+  isPreDecodeSensor(sensor) {
+    const phase = typeof sensor.phase === "string" ? sensor.phase : sensor.phase?.phase;
+    return phase === "PRE_DECODE" || (sensor.order ?? 999) < 40;
+  }
+  /**
+   * Helper: Check if a sensor is a post-decode sensor.
+   *
+   * @private
+   * @param {AxisSensor} sensor - The sensor to check
+   * @returns {boolean} True if sensor is post-decode
+   */
+  isPostDecodeSensor(sensor) {
+    const phase = typeof sensor.phase === "string" ? sensor.phase : sensor.phase?.phase;
+    return phase === "POST_DECODE" || (sensor.order ?? 999) >= 40;
+  }
+  /**
+   * Returns sensor count by phase.
+   * Useful for diagnostics and monitoring.
+   *
+   * @returns {{preDecodeCount: number, postDecodeCount: number}}
+   */
+  getSensorCountByPhase() {
+    return {
+      preDecodeCount: this.getPreDecodeSensors().length,
+      postDecodeCount: this.getPostDecodeSensors().length
+    };
+  }
+  /**
+   * Clears all registered sensors.
+   * Useful for testing.
+   *
+   * @internal
+   */
+  clear() {
+    this.sensors = [];
+  }
+};
+SensorRegistry = __decorateClass([
+  (0, import_common9.Injectable)()
+], SensorRegistry);
+
+// src/loom/index.ts
+var loom_exports = {};
+__export(loom_exports, {
+  PROOF_LOOM: () => import_axis_protocol2.PROOF_LOOM,
+  TLV_PRESENCE_ID: () => import_axis_protocol2.TLV_LOOM_PRESENCE_ID,
+  TLV_THREAD_HASH: () => import_axis_protocol2.TLV_LOOM_THREAD_HASH,
+  TLV_WRIT: () => import_axis_protocol2.TLV_LOOM_WRIT,
+  canonicalizeGrant: () => canonicalizeGrant,
+  canonicalizeWrit: () => canonicalizeWrit,
+  deriveAnchorReflection: () => deriveAnchorReflection
+});
+
+// src/loom/loom.types.ts
+function deriveAnchorReflection(softid, context = "openlogs", scope = "loom") {
+  return `ar:${context}:${scope}:${softid}`;
+}
+function canonicalizeWrit(writ) {
+  const ordered = {
+    head: { tid: writ.head.tid, seq: writ.head.seq },
+    body: {
+      who: writ.body.who,
+      act: writ.body.act,
+      res: writ.body.res,
+      law: writ.body.law
+    },
+    meta: { iat: writ.meta.iat, exp: writ.meta.exp, prev: writ.meta.prev }
+  };
+  return JSON.stringify(ordered);
+}
+function canonicalizeGrant(grant) {
+  const ordered = {
+    grant_id: grant.grant_id,
+    issuer: grant.issuer,
+    subject: grant.subject,
+    grant_type: grant.grant_type,
+    caps: grant.caps,
+    meta: grant.meta
+  };
+  return JSON.stringify(ordered);
+}
+
+// src/schemas/index.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  AccessProfileZ: () => AccessProfileZ,
+  AxisContextZ: () => AxisContextZ,
+  AxisErrorZ: () => AxisErrorZ,
+  BodyBudgetInputZ: () => BodyBudgetInputZ,
+  BodyBudgetPolicyZ: () => BodyBudgetPolicyZ,
+  BodyProfile: () => BodyProfile2,
+  BodyProfileValidator: () => BodyProfileValidator,
+  BodyProfileZ: () => BodyProfileZ,
+  CapsuleClaimsZ: () => CapsuleClaimsZ,
+  CapsuleValidationResultZ: () => CapsuleValidationResultZ,
+  CapsuleVerifyResultZ: () => CapsuleVerifyResultZ,
+  CapsuleVerifySensorInputZ: () => CapsuleVerifySensorInputZ,
+  CapsuleZ: () => CapsuleZ,
+  ChunkHashInputZ: () => ChunkHashInputZ,
+  CountryBlockDecisionZ: () => CountryBlockDecisionZ,
+  CountryBlockSensorInputZ: () => CountryBlockSensorInputZ,
+  EntropySensorInputZ: () => EntropySensorInputZ,
+  ExecutionMetricsZ: () => ExecutionMetricsZ,
+  IPReputationInputZ: () => IPReputationInputZ,
+  IPReputationZ: () => IPReputationZ,
+  IntentPolicyDecisionZ: () => IntentPolicyDecisionZ,
+  IntentPolicySensorInputZ: () => IntentPolicySensorInputZ,
+  IntentPolicyZ: () => IntentPolicyZ,
+  IntentSchemaZ: () => IntentSchemaZ,
+  PassportZ: () => PassportZ,
+  ProofKindZ: () => ProofKindZ,
+  ProofPresenceInputZ: () => ProofPresenceInputZ,
+  ProofType: () => ProofType2,
+  ProtocolStrictInputZ: () => ProtocolStrictInputZ,
+  RateLimitConfigZ: () => RateLimitConfigZ,
+  RateLimitInputZ: () => RateLimitInputZ,
+  RateLimitProfileZ: () => RateLimitProfileZ,
+  ScanBurstDecisionZ: () => ScanBurstDecisionZ,
+  ScanBurstSensorInputZ: () => ScanBurstSensorInputZ,
+  SchemaFieldKindZ: () => SchemaFieldKindZ,
+  SchemaFieldZ: () => SchemaFieldZ,
+  ScopeZ: () => ScopeZ,
+  SensitivityLevelZ: () => SensitivityLevelZ,
+  SensorChainInputZ: () => SensorChainInputZ,
+  SensorDecisionWithMetadataZ: () => SensorDecisionWithMetadataZ,
+  SensorDecisionZ: () => SensorDecisionZ,
+  SensorResultZ: () => SensorResultZ,
+  UploadSessionZ: () => UploadSessionZ,
+  UploadStatusZ: () => UploadStatusZ,
+  WsHandshakeDecisionZ: () => WsHandshakeDecisionZ,
+  WsHandshakeInputZ: () => WsHandshakeInputZ
+});
+
+// src/schemas/axis-schemas.ts
+var z2 = __toESM(require("zod"));
+var SensorDecisionZ = z2.union([
+  z2.object({ action: z2.literal("ALLOW"), meta: z2.any().optional() }),
+  z2.object({
+    action: z2.literal("DENY"),
+    code: z2.string(),
+    reason: z2.string().optional(),
+    meta: z2.any().optional()
+  })
+]);
+var SensorDecisionWithMetadataZ = z2.union([
+  z2.object({ action: z2.literal("ALLOW"), meta: z2.any().optional() }),
+  z2.object({
+    action: z2.literal("DENY"),
+    code: z2.string(),
+    reason: z2.string().optional(),
+    retryAfterMs: z2.number().int().positive().optional(),
+    meta: z2.any().optional()
+  })
+]);
+var CountryBlockSensorInputZ = z2.object({
+  ip: z2.string().min(1),
+  country: z2.string().length(2).toUpperCase().optional()
+});
+var CountryBlockDecisionZ = SensorDecisionZ;
+var ScanBurstSensorInputZ = z2.object({
+  ip: z2.string().min(1),
+  isFailure: z2.boolean().optional()
+});
+var ScanBurstDecisionZ = SensorDecisionWithMetadataZ;
+var ProofKindZ = z2.enum([
+  "NONE",
+  "CAPSULE",
+  "PASSPORT",
+  "MTLS",
+  "JWT"
+]);
+var AccessProfileZ = z2.enum(["PUBLIC", "PARTNER", "INTERNAL", "NODE"]);
+var ProofPresenceInputZ = z2.object({
+  profile: AccessProfileZ,
+  visibility: z2.enum(["PUBLIC", "GUARDED"]),
+  requiredProof: z2.array(ProofKindZ).min(1),
+  hasCapsule: z2.boolean(),
+  hasPassportSignature: z2.boolean(),
+  intent: z2.string().min(1)
+});
+var SensitivityLevelZ = z2.enum(["LOW", "MEDIUM", "HIGH", "CRITICAL"]);
+var IntentPolicyZ = z2.object({
+  intent: z2.string().min(1),
+  sensitivity: SensitivityLevelZ,
+  maxFrameBytes: z2.number().int().positive(),
+  maxHeaderBytes: z2.number().int().positive(),
+  maxBodyBytes: z2.number().int().positive(),
+  maxSigBytes: z2.number().int().positive().optional(),
+  rateLimitPerMinute: z2.number().int().positive().optional(),
+  rateLimitPerHour: z2.number().int().positive().optional(),
+  requiresSignature: z2.boolean(),
+  requiresCapsule: z2.boolean(),
+  timeoutMs: z2.number().int().positive()
+});
+var IntentPolicySensorInputZ = z2.object({
+  frame: AxisFrameZ,
+  intent: z2.string().min(1),
+  rawFrameSize: z2.number().int().positive()
+});
+var IntentPolicyDecisionZ = z2.union([
+  z2.object({
+    action: z2.literal("ALLOW"),
+    policy: IntentPolicyZ
+  }),
+  z2.object({
+    action: z2.literal("DENY"),
+    reason: z2.string()
+  })
+]);
+var CapsuleClaimsZ = z2.object({
+  capsuleId: z2.string().min(8),
+  allowIntents: z2.array(z2.string()).min(1),
+  limits: z2.object({
+    maxBodyBytes: z2.number().int().positive().optional()
+  }).optional(),
+  scopes: z2.record(z2.string(), z2.any()).optional()
+});
+var CapsuleZ = z2.object({
+  id: z2.string(),
+  claims: CapsuleClaimsZ,
+  issuedAt: z2.number().int(),
+  expiresAt: z2.number().int(),
+  tier: z2.enum(["FREE", "STANDARD", "PREMIUM"])
+});
+var CapsuleValidationResultZ = z2.object({
+  valid: z2.boolean(),
+  capsule: CapsuleZ.optional(),
+  reason: z2.string().optional(),
+  requiresStepUp: z2.boolean().optional()
+});
+var CapsuleVerifySensorInputZ = z2.object({
+  headers: z2.map(
+    z2.number(),
+    z2.custom((v) => v instanceof Uint8Array)
+  ),
+  intent: z2.string().min(1),
+  ctx: z2.any()
+  // AxisContext - avoid circular dependency
+});
+var CapsuleVerifyResultZ = z2.object({
+  ok: z2.literal(true),
+  capsule: CapsuleZ
+});
+var RateLimitProfileZ = z2.enum([
+  "PUBLIC",
+  "PARTNER",
+  "INTERNAL",
+  "NODE"
+]);
+var RateLimitInputZ = z2.object({
+  ip: z2.string().min(1),
+  userAgent: z2.string().optional(),
+  actorId: z2.string().optional(),
+  capsuleId: z2.string().optional(),
+  intent: z2.string().min(1),
+  profile: RateLimitProfileZ
+});
+var RateLimitConfigZ = z2.object({
+  windowSec: z2.number().int().positive(),
+  max: z2.number().int().positive(),
+  key: z2.enum(["ip_fingerprint", "actor_capsule"])
+});
+var SensorResultZ = z2.object({
+  ok: z2.literal(true)
+});
+var PassportZ = z2.object({
+  id: z2.string(),
+  public_key: z2.custom((v) => Buffer.isBuffer(v)),
+  status: z2.enum(["ACTIVE", "REVOKED", "EXPIRED", "PENDING"]),
+  issuedAt: z2.number().int(),
+  expiresAt: z2.number().int().optional()
+});
+var ExecutionMetricsZ = z2.object({
+  dbWrites: z2.number().int(),
+  dbReads: z2.number().int(),
+  externalCalls: z2.number().int(),
+  elapsedMs: z2.number().int().optional()
+});
+var SensorChainInputZ = z2.object({
+  ip: z2.string().min(1),
+  path: z2.string().min(1),
+  contentLength: z2.number().int().nonnegative(),
+  peek: z2.instanceof(Uint8Array),
+  country: z2.string().optional()
+});
+var EntropySensorInputZ = z2.object({
+  pid: z2.custom((v) => Buffer.isBuffer(v)).optional(),
+  nonce: z2.custom((v) => Buffer.isBuffer(v)).optional(),
+  ip: z2.string().min(1)
+});
+var ProtocolStrictInputZ = z2.object({
+  rawBytes: z2.union([z2.custom((v) => Buffer.isBuffer(v)), z2.instanceof(Uint8Array)]).optional(),
+  ip: z2.string().min(1),
+  path: z2.string().min(1),
+  contentLength: z2.number().int().nonnegative(),
+  peek: z2.instanceof(Uint8Array),
+  country: z2.string().optional(),
+  contentType: z2.string().optional()
+});
+var SchemaFieldKindZ = z2.enum([
+  "utf8",
+  "u64",
+  "bytes",
+  "bytes16",
+  "bool",
+  "obj",
+  "arr"
+]);
+var ScopeZ = z2.enum(["header", "body"]);
+var SchemaFieldZ = z2.object({
+  name: z2.string().min(1),
+  tlv: z2.number().int().positive(),
+  kind: SchemaFieldKindZ,
+  required: z2.boolean().optional(),
+  maxLen: z2.number().int().positive().optional(),
+  max: z2.string().optional(),
+  scope: ScopeZ.optional()
+});
+var BodyProfileZ = z2.enum(["TLV_MAP", "RAW", "TLV_OBJ", "TLV_ARR"]);
+var IntentSchemaZ = z2.object({
+  intent: z2.string().min(1),
+  version: z2.number().int().positive(),
+  bodyProfile: BodyProfileZ,
+  fields: z2.array(SchemaFieldZ).min(1)
+});
+var WsHandshakeInputZ = z2.object({
+  clientId: z2.string().min(1),
+  isWs: z2.boolean(),
+  ip: z2.string().min(1)
+});
+var WsHandshakeDecisionZ = z2.union([
+  z2.object({ action: z2.literal("ALLOW") }),
+  z2.object({ action: z2.literal("DENY"), code: z2.string() })
+]);
+var IPReputationInputZ = z2.object({
+  ip: z2.string().min(1)
+});
+var IPReputationZ = z2.object({
+  score: z2.number().min(-100).max(100),
+  lastUpdated: z2.number().int(),
+  totalRequests: z2.number().int().nonnegative(),
+  failedRequests: z2.number().int().nonnegative(),
+  blockedRequests: z2.number().int().nonnegative(),
+  tags: z2.array(z2.string())
+});
+var UploadStatusZ = z2.enum([
+  "INIT",
+  "UPLOADING",
+  "FINALIZING",
+  "DONE",
+  "ABORTED"
+]);
+var UploadSessionZ = z2.object({
+  uploadIdHex: z2.string().min(1),
+  fileName: z2.string().min(1),
+  totalSize: z2.number().int().positive(),
+  chunkSize: z2.number().int().positive(),
+  totalChunks: z2.number().int().positive(),
+  receivedCount: z2.number().int().nonnegative(),
+  status: UploadStatusZ
+});
+var BodyBudgetInputZ = z2.object({
+  intent: z2.string().min(1),
+  headerLen: z2.number().int().nonnegative(),
+  bodyLen: z2.number().int().nonnegative()
+});
+var BodyBudgetPolicyZ = z2.object({
+  maxHeaderBytes: z2.number().int().positive(),
+  maxBodyBytes: z2.number().int().positive()
+});
+var ChunkHashInputZ = z2.object({
+  headerTLVs: z2.any(),
+  // Map<number, Uint8Array> - flexible validation for compatibility
+  bodyBytes: z2.any(),
+  // Uint8Array - flexible validation for compatibility
+  intent: z2.string().min(1)
+});
+var ProofType2 = /* @__PURE__ */ ((ProofType3) => {
+  ProofType3[ProofType3["CAPSULE"] = 1] = "CAPSULE";
+  ProofType3[ProofType3["JWT"] = 2] = "JWT";
+  ProofType3[ProofType3["MTLS_ID"] = 3] = "MTLS_ID";
+  ProofType3[ProofType3["DEVICE_SE"] = 4] = "DEVICE_SE";
+  ProofType3[ProofType3["WITNESS_SIG"] = 5] = "WITNESS_SIG";
+  return ProofType3;
+})(ProofType2 || {});
+var AxisContextZ = z2.object({
+  pid: z2.custom((v) => Buffer.isBuffer(v)),
+  // Process ID
+  ts: z2.bigint(),
+  // Timestamp
+  intent: z2.string().min(1),
+  actorId: z2.custom((v) => Buffer.isBuffer(v)),
+  proofType: z2.enum(ProofType2),
+  proofRef: z2.custom((v) => Buffer.isBuffer(v)),
+  nonce: z2.custom((v) => Buffer.isBuffer(v)),
+  ip: z2.string().min(1),
+  nodeCertHash: z2.string().optional(),
+  capsule: CapsuleZ.optional(),
+  passport: PassportZ.optional(),
+  meter: z2.any().optional()
+  // ExecutionMeter instance - any to avoid circular dependency and allow class instance
+});
+var AxisErrorZ = z2.object({
+  code: z2.string(),
+  message: z2.string(),
+  httpStatus: z2.number().int()
+});
+
+// src/schemas/body-profile.validator.ts
+var import_common10 = require("@nestjs/common");
+var BodyProfile2 = /* @__PURE__ */ ((BodyProfile3) => {
+  BodyProfile3[BodyProfile3["RAW"] = 0] = "RAW";
+  BodyProfile3[BodyProfile3["TLV_MAP"] = 1] = "TLV_MAP";
+  BodyProfile3[BodyProfile3["OBJ"] = 2] = "OBJ";
+  BodyProfile3[BodyProfile3["ARR"] = 3] = "ARR";
+  return BodyProfile3;
+})(BodyProfile2 || {});
+var BodyProfileValidator = class {
+  constructor() {
+    this.logger = new import_common10.Logger(BodyProfileValidator.name);
+  }
+  /**
+   * Validate body matches declared profile
+   */
+  validate(body, profile) {
+    switch (profile) {
+      case 0 /* RAW */:
+        return this.validateRaw(body);
+      case 1 /* TLV_MAP */:
+        return this.validateTlvMap(body);
+      case 2 /* OBJ */:
+        return this.validateObj(body);
+      case 3 /* ARR */:
+        return this.validateArr(body);
+      default:
+        return {
+          valid: false,
+          error: `Unknown body profile: ${profile}`,
+          profile
+        };
+    }
+  }
+  /**
+   * RAW profile - no validation, any bytes accepted
+   */
+  validateRaw(body) {
+    return {
+      valid: true,
+      profile: 0 /* RAW */
+    };
+  }
+  /**
+   * TLV_MAP profile - flat TLV list (no nested structures)
+   */
+  validateTlvMap(body) {
+    try {
+      const tlvs = (0, import_axis_protocol.decodeTLVsList)(body);
+      for (const tlv2 of tlvs) {
+        if (tlv2.type === 254 || tlv2.type === 255) {
+          return {
+            valid: false,
+            error: "TLV_MAP profile cannot contain nested OBJ/ARR types",
+            profile: 1 /* TLV_MAP */
+          };
+        }
+      }
+      return {
+        valid: true,
+        profile: 1 /* TLV_MAP */
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        valid: false,
+        error: `TLV_MAP decode failed: ${message}`,
+        profile: 1 /* TLV_MAP */
+      };
+    }
+  }
+  /**
+   * OBJ profile - must be valid nested object
+   */
+  validateObj(body) {
+    try {
+      const tlvs = (0, import_axis_protocol.decodeTLVsList)(body);
+      const hasObj = tlvs.some((t) => t.type === 254);
+      if (!hasObj && tlvs.length > 0) {
+        return {
+          valid: false,
+          error: "OBJ profile must contain OBJ type (254)",
+          profile: 2 /* OBJ */
+        };
+      }
+      return {
+        valid: true,
+        profile: 2 /* OBJ */
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        valid: false,
+        error: `OBJ decode failed: ${message}`,
+        profile: 2 /* OBJ */
+      };
+    }
+  }
+  /**
+   * ARR profile - must be valid array
+   */
+  validateArr(body) {
+    try {
+      const tlvs = (0, import_axis_protocol.decodeTLVsList)(body);
+      const hasArr = tlvs.some((t) => t.type === 255);
+      if (!hasArr && tlvs.length > 0) {
+        return {
+          valid: false,
+          error: "ARR profile must contain ARR type (255)",
+          profile: 3 /* ARR */
+        };
+      }
+      return {
+        valid: true,
+        profile: 3 /* ARR */
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        valid: false,
+        error: `ARR decode failed: ${message}`,
+        profile: 3 /* ARR */
+      };
+    }
+  }
+};
+BodyProfileValidator = __decorateClass([
+  (0, import_common10.Injectable)()
+], BodyProfileValidator);
+
+// src/security/index.ts
+var security_exports = {};
+__export(security_exports, {
+  CAPABILITIES: () => CAPABILITIES,
+  INTENT_REQUIREMENTS: () => INTENT_REQUIREMENTS,
+  PROOF_CAPABILITIES: () => PROOF_CAPABILITIES,
+  canAccessResource: () => canAccessResource,
+  hasScope: () => hasScope,
+  parseScope: () => parseScope
+});
+
+// src/sensors/index.ts
+var sensors_exports = {};
+__export(sensors_exports, {
+  AccessProfileResolverSensor: () => AccessProfileResolverSensor,
+  BodyBudgetSensor: () => BodyBudgetSensor,
+  CapabilityEnforcementSensor: () => CapabilityEnforcementSensor,
+  ChunkHashSensor: () => ChunkHashSensor,
+  EntropySensor: () => EntropySensor,
+  ExecutionTimeoutSensor: () => ExecutionTimeoutSensor,
+  FrameBudgetSensor: () => FrameBudgetSensor,
+  FrameHeaderSanitySensor: () => FrameHeaderSanitySensor,
+  HeaderTLVLimitSensor: () => HeaderTLVLimitSensor,
+  IntentAllowlistSensor: () => IntentAllowlistSensor,
+  IntentRegistrySensor: () => IntentRegistrySensor,
+  ProofPresenceSensor: () => ProofPresenceSensor,
+  ProtocolStrictSensor: () => ProtocolStrictSensor,
+  ReceiptPolicySensor: () => ReceiptPolicySensor,
+  SchemaValidationSensor: () => SchemaValidationSensor,
+  StreamScopeSensor: () => StreamScopeSensor,
+  TLVParseSensor: () => TLVParseSensor,
+  VarintHardeningSensor: () => VarintHardeningSensor
+});
+
+// src/sensors/access-profile-resolver.sensor.ts
+var import_common11 = require("@nestjs/common");
+var AccessProfileResolverSensor = class {
+  constructor() {
+    /** AxisSensor identifier */
+    this.name = "AccessProfileResolverSensor";
+    /**
+     * Execution order - runs early to establish the access profile
+     * for downstream sensors.
+     */
+    this.order = BAND.IDENTITY + 10;
+  }
+  supports() {
+    return true;
+  }
+  async run(input) {
+    const hasCapsule = !!input.metadata?.capsuleId;
+    const hasPassport = !!input.metadata?.passportSig;
+    const hasMTLS = !!input.metadata?.mtlsId;
+    const profile = hasCapsule || hasPassport || hasMTLS ? "GUARDED" : "PUBLIC";
+    if (!input.metadata) input.metadata = {};
+    input.metadata.profile = profile;
+    return { action: "ALLOW" };
+  }
+};
+AccessProfileResolverSensor = __decorateClass([
+  Sensor(),
+  (0, import_common11.Injectable)()
+], AccessProfileResolverSensor);
+
+// src/sensors/body-budget.sensor.ts
+var import_common12 = require("@nestjs/common");
+var BodyBudgetSensor = class {
+  constructor() {
+    /** AxisSensor identifier */
+    this.name = "BodyBudgetSensor";
+    /**
+     * Execution order - after authentication
+     *
+     * Order 150 ensures:
+     * - Authentication complete
+     * - Runs before full body read
+     * - Before schema validation (170)
+     */
+    this.order = BAND.CONTENT + 10;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Requires at least 8 bytes of peeked data to read headers.
+   *
+   * @param {SensorInput} input - Incoming request
+   * @returns {boolean} True if sufficient peek data available
+   */
+  supports(input) {
+    return !!input.peek && input.peek.length >= 8;
+  }
+  /**
+   * Validates header and body lengths against configured limits.
+   *
+   * **Frame Parsing:**
+   * - Skip magic (5 bytes)
+   * - Skip version (1 byte)
+   * - Skip flags (1 byte)
+   * - Read HDR_LEN varint
+   * - Read BODY_LEN varint
+   * - Compare against MAX_HDR_LEN and MAX_BODY_LEN
+   *
+   * @param {SensorInput} input - Request with peek data
+   * @returns {Promise<SensorDecision>} ALLOW or DENY based on size limits
+   */
+  async run(input) {
+    const { peek } = input;
+    if (!peek || peek.length < 8) {
+      return { action: "ALLOW" };
+    }
+    try {
+      let offset = 5;
+      offset += 1;
+      offset += 1;
+      const { value: hdrLen, length: hdrBytes } = (0, import_axis_protocol3.decodeVarint)(peek, offset);
+      offset += hdrBytes;
+      const { value: bodyLen } = (0, import_axis_protocol3.decodeVarint)(peek, offset);
+      if (hdrLen > import_axis_protocol2.MAX_HDR_LEN) {
+        return {
+          action: "DENY",
+          code: "HEADER_TOO_LARGE",
+          reason: `Header size ${hdrLen} exceeds limit ${import_axis_protocol2.MAX_HDR_LEN}`
+        };
+      }
+      if (bodyLen > import_axis_protocol2.MAX_BODY_LEN) {
+        return {
+          action: "DENY",
+          code: "BODY_TOO_LARGE",
+          reason: `Body size ${bodyLen} exceeds limit ${import_axis_protocol2.MAX_BODY_LEN}`
+        };
+      }
+      return { action: "ALLOW" };
+    } catch (e) {
+      return { action: "ALLOW" };
+    }
+  }
+};
+BodyBudgetSensor = __decorateClass([
+  Sensor(),
+  (0, import_common12.Injectable)()
+], BodyBudgetSensor);
+
+// src/sensors/capability-enforcement.sensor.ts
+var import_common13 = require("@nestjs/common");
+var CapabilityEnforcementSensor = class {
+  constructor() {
+    this.logger = new import_common13.Logger(CapabilityEnforcementSensor.name);
+    /** AxisSensor identifier for logging and registry */
+    this.name = "CapabilityEnforcementSensor";
+    /**
+     * Execution order - runs after authentication
+     *
+     * Order 100 ensures:
+     * - Capsule is verified (CapsuleVerifySensor @ 80)
+     * - Signature is verified (SigVerifySensor @ 90)
+     * - We know the proof type for capability lookup
+     */
+    this.order = BAND.POLICY + 10;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Only activates when an intent is present.
+   *
+   * @param {SensorInput} input - Incoming AXIS request
+   * @returns {boolean} True if intent is present
+   */
+  supports(input) {
+    return !!input.intent;
+  }
+  /**
+   * Enforces capability requirements for the requested intent.
+   *
+   * **Processing Flow:**
+   * 1. Extract proof type from packet (default: 0/NONE)
+   * 2. Look up capabilities granted by this proof type
+   * 3. Look up capabilities required by the intent
+   * 4. If no requirements, ALLOW
+   * 5. Check if all required capabilities are granted
+   * 6. If missing capabilities, DENY with details
+   * 7. Otherwise, ALLOW
+   *
+   * @param {SensorInput} input - Request with intent and packet
+   * @returns {Promise<SensorDecision>} ALLOW or DENY based on capabilities
+   */
+  async run(input) {
+    const { intent, packet } = input;
+    if (!intent) {
+      return { action: "ALLOW" };
+    }
+    const proofType = packet?.proofType ?? 0;
+    const grantedCapabilities = PROOF_CAPABILITIES[proofType] || [];
+    const requiredCapabilities = this.getRequiredCapabilities(intent);
+    if (requiredCapabilities.length === 0) {
+      return { action: "ALLOW" };
+    }
+    const missingCapabilities = requiredCapabilities.filter(
+      (cap) => !grantedCapabilities.includes(cap)
+    );
+    if (missingCapabilities.length > 0) {
+      this.logger.warn(
+        `Capability denied for ${intent}: missing ${missingCapabilities.join(", ")} (has: ${grantedCapabilities.join(", ")})`
+      );
+      return {
+        action: "DENY",
+        code: "CAPABILITY_DENIED",
+        reason: `Missing capabilities: ${missingCapabilities.join(", ")}`
+      };
+    }
+    return { action: "ALLOW" };
+  }
+  /**
+   * Gets required capabilities for an intent.
+   *
+   * **Lookup Strategy:**
+   * 1. Check for exact intent match
+   * 2. Check for prefix pattern match (*.suffix)
+   * 3. Default to 'execute' for unknown intents
+   *
+   * @private
+   * @param {string} intent - Intent name to look up
+   * @returns {Capability[]} Array of required capabilities
+   */
+  getRequiredCapabilities(intent) {
+    if (INTENT_REQUIREMENTS[intent]) {
+      return INTENT_REQUIREMENTS[intent];
+    }
+    for (const [pattern, caps] of Object.entries(INTENT_REQUIREMENTS)) {
+      if (pattern.endsWith(".*")) {
+        const prefix = pattern.slice(0, -1);
+        if (intent.startsWith(prefix)) {
+          return caps;
+        }
+      }
+    }
+    return ["execute"];
+  }
+};
+CapabilityEnforcementSensor = __decorateClass([
+  Sensor(),
+  (0, import_common13.Injectable)()
+], CapabilityEnforcementSensor);
+
+// src/sensors/chunk-hash.sensor.ts
+var import_common14 = require("@nestjs/common");
+var import_crypto5 = require("crypto");
+var ChunkHashSensor = class {
+  constructor() {
+    /** Sensor identifier */
+    this.name = "ChunkHashSensor";
+    /**
+     * Execution order - after session validation
+     *
+     * Order 190 ensures:
+     * - Session validated (180)
+     * - Chunk parameters verified
+     * - Hash check before storage
+     */
+    this.order = BAND.CONTENT + 50;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Only processes file.chunk intents.
+   *
+   * @param {SensorInput} input - Incoming request
+   * @returns {boolean} True if intent is 'file.chunk'
+   */
+  supports(input) {
+    return input.intent === "file.chunk";
+  }
+  /**
+   * Validates chunk data against declared SHA-256 hash.
+   *
+   * **Processing Flow:**
+   * 1. Check for required headerTLVs and body
+   * 2. Extract expected hash from TLV 73
+   * 3. Verify hash is exactly 32 bytes
+   * 4. Compute SHA-256 of body
+   * 5. Compare bytes (timing-safe)
+   * 6. DENY on mismatch
+   *
+   * @param {SensorInput} input - Request with chunk body
+   * @returns {Promise<SensorDecision>} ALLOW if hash matches, DENY otherwise
+   */
+  async run(input) {
+    const headerTLVs = input.headerTLVs;
+    const bodyBytes = input.body;
+    if (!headerTLVs || !bodyBytes) {
+      return {
+        action: "DENY",
+        code: "SENSOR_INVALID_INPUT",
+        reason: "Missing headerTLVs or body"
+      };
+    }
+    const TLV_SHA256_CHUNK2 = 73;
+    const expected = headerTLVs.get(TLV_SHA256_CHUNK2);
+    if (!expected || expected.length !== 32) {
+      return {
+        action: "DENY",
+        code: "FILE_CHUNK_HASH_MISSING",
+        reason: "Missing sha256Chunk TLV in header"
+      };
+    }
+    const actual = (0, import_crypto5.createHash)("sha256").update(bodyBytes).digest();
+    if (!Buffer.from(actual).equals(Buffer.from(expected))) {
+      return {
+        action: "DENY",
+        code: "FILE_CHUNK_HASH_MISMATCH",
+        reason: "Chunk hash mismatch - data corrupted"
+      };
+    }
+    return { action: "ALLOW" };
+  }
+};
+ChunkHashSensor = __decorateClass([
+  Sensor(),
+  (0, import_common14.Injectable)()
+], ChunkHashSensor);
+
+// src/sensors/entropy.sensor.ts
+var import_common15 = require("@nestjs/common");
+var crypto4 = __toESM(require("crypto"));
+var EntropySensor = class {
+  constructor() {
+    this.logger = new import_common15.Logger(EntropySensor.name);
+    /**
+     * Minimum acceptable entropy in bits per byte.
+     *
+     * 3.0 bits/byte is a conservative threshold:
+     * - Random data: ~7.9 bits/byte
+     * - English text: ~4.5 bits/byte
+     * - Sequential data: ~0-2 bits/byte
+     */
+    this.MIN_ENTROPY_THRESHOLD = 3;
+    /** AxisSensor identifier */
+    this.name = "EntropySensor";
+    /**
+     * Execution order - anomaly detection phase
+     *
+     * Order 130 ensures:
+     * - Replay protection done (120)
+     * - Runs before expensive policy lookups
+     */
+    this.order = BAND.POLICY + 35;
+  }
+  /**
+   * Calculates Shannon entropy of a byte array.
+   *
+   * **Algorithm:**
+   * 1. Count frequency of each byte value (0-255)
+   * 2. Calculate probability p = count / total
+   * 3. Sum: -Σ(p * log2(p))
+   *
+   * @private
+   * @param {Uint8Array} data - Bytes to analyze
+   * @returns {number} Entropy in bits per byte (0-8 scale)
+   */
+  calculateEntropy(data) {
+    if (data.length === 0) return 0;
+    const freq = /* @__PURE__ */ new Map();
+    for (const byte of data) {
+      freq.set(byte, (freq.get(byte) || 0) + 1);
+    }
+    let entropy = 0;
+    const len = data.length;
+    for (const count of freq.values()) {
+      const p = count / len;
+      entropy -= p * Math.log2(p);
+    }
+    return entropy;
+  }
+  /**
+   * Checks for sequential patterns in data.
+   *
+   * Detects sequences like [1,2,3,4...] or [10,9,8,7...].
+   * More than 50% sequential is considered suspicious.
+   *
+   * @private
+   * @param {Uint8Array} data - Bytes to analyze
+   * @returns {boolean} True if sequential pattern detected
+   */
+  hasSequentialPattern(data) {
+    if (data.length < 4) return false;
+    let ascending = 0;
+    let descending = 0;
+    for (let i = 1; i < data.length; i++) {
+      if (data[i] === data[i - 1] + 1) ascending++;
+      if (data[i] === data[i - 1] - 1) descending++;
+    }
+    return ascending > data.length / 2 || descending > data.length / 2;
+  }
+  /**
+   * Checks for repeated patterns in data.
+   *
+   * Detects patterns like [0xAB, 0xCD, 0xAB, 0xCD...].
+   * Checks for 2, 4, and 8 byte repeating patterns.
+   *
+   * @private
+   * @param {Uint8Array} data - Bytes to analyze
+   * @returns {boolean} True if repeated pattern detected
+   */
+  hasRepeatedPattern(data) {
+    if (data.length < 8) return false;
+    for (const patternLen of [2, 4, 8]) {
+      if (data.length % patternLen !== 0) continue;
+      let matches = 0;
+      for (let i = patternLen; i < data.length; i++) {
+        if (data[i] === data[i % patternLen]) matches++;
+      }
+      if (matches > (data.length - patternLen) * 0.9) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Analyzes entropy of PID and nonce in request headers.
+   *
+   * **Processing Flow:**
+   * 1. Extract PID and nonce from header TLVs
+   * 2. Calculate entropy for each
+   * 3. Check for sequential patterns
+   * 4. Check for repeated patterns
+   * 5. Accumulate issues and score delta
+   * 6. Return FLAG if issues found, ALLOW otherwise
+   *
+   * @param {SensorInput} input - Request with header TLVs
+   * @returns {Promise<SensorDecision>} ALLOW or FLAG based on entropy analysis
+   */
+  async run(input) {
+    const headers = input.headerTLVs;
+    if (!headers) {
+      return { action: "ALLOW" };
+    }
+    const pid = headers.get(import_axis_protocol2.TLV_PID);
+    const nonce = headers.get(import_axis_protocol2.TLV_NONCE);
+    const issues = [];
+    let totalDelta = 0;
+    if (pid && pid.length > 0) {
+      const pidEntropy = this.calculateEntropy(pid);
+      if (pidEntropy < this.MIN_ENTROPY_THRESHOLD) {
+        issues.push(`pid_low_entropy:${pidEntropy.toFixed(2)}`);
+        totalDelta -= 3;
+      }
+      if (this.hasSequentialPattern(pid)) {
+        issues.push("pid_sequential");
+        totalDelta -= 5;
+      }
+      if (this.hasRepeatedPattern(pid)) {
+        issues.push("pid_repeated");
+        totalDelta -= 5;
+      }
+    }
+    if (nonce && nonce.length > 0) {
+      const nonceEntropy = this.calculateEntropy(nonce);
+      if (nonceEntropy < this.MIN_ENTROPY_THRESHOLD) {
+        issues.push(`nonce_low_entropy:${nonceEntropy.toFixed(2)}`);
+        totalDelta -= 3;
+      }
+      if (this.hasSequentialPattern(nonce)) {
+        issues.push("nonce_sequential");
+        totalDelta -= 5;
+      }
+      if (this.hasRepeatedPattern(nonce)) {
+        issues.push("nonce_repeated");
+        totalDelta -= 5;
+      }
+    }
+    if (issues.length > 0) {
+      this.logger.warn(`Entropy issues from ${input.ip}: ${issues.join(", ")}`);
+      return {
+        action: "FLAG",
+        scoreDelta: totalDelta,
+        reasons: issues
+      };
+    }
+    return { action: "ALLOW" };
+  }
+  /**
+   * Generates cryptographically secure random bytes.
+   *
+   * Utility method for SDK/client code to ensure proper entropy.
+   * Uses Node.js crypto.randomBytes for secure PRNG.
+   *
+   * @static
+   * @param {number} length - Number of random bytes
+   * @returns {Uint8Array} Cryptographically secure random bytes
+   */
+  static generateSecureRandom(length) {
+    return new Uint8Array(crypto4.randomBytes(length));
+  }
+};
+EntropySensor = __decorateClass([
+  Sensor(),
+  (0, import_common15.Injectable)()
+], EntropySensor);
+
+// src/sensors/execution-timeout.sensor.ts
+var import_common16 = require("@nestjs/common");
+var ExecutionTimeoutSensor = class {
+  constructor() {
+    this.logger = new import_common16.Logger(ExecutionTimeoutSensor.name);
+    /** AxisSensor identifier */
+    this.name = "ExecutionTimeoutSensor";
+    /**
+     * Execution order - late, near handler execution
+     *
+     * Order 210 ensures:
+     * - All validation complete
+     * - Deadline set just before handler
+     */
+    this.order = BAND.BUSINESS + 10;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * @param {SensorInput} input - Incoming request
+   * @returns {boolean} True if intent is present
+   */
+  supports(input) {
+    return !!input.intent;
+  }
+  /**
+   * Sets execution deadline in the request context.
+   *
+   * **Processing Flow:**
+   * 1. Look up timeout for intent
+   * 2. Calculate absolute deadline
+   * 3. Store in context for handler use
+   * 4. Return ALLOW
+   *
+   * @param {SensorInput} input - Request with intent
+   * @returns {Promise<SensorDecision>} Always ALLOW
+   */
+  async run(input) {
+    const { intent, context } = input;
+    if (!intent) {
+      return { action: "ALLOW" };
+    }
+    const timeout = resolveTimeout(intent);
+    const deadline = Date.now() + timeout;
+    if (context) {
+      context.deadline = deadline;
+      context.timeoutMs = timeout;
+    }
+    this.logger.debug(
+      `Set ${timeout}ms timeout for ${intent} (deadline: ${new Date(deadline).toISOString()})`
+    );
+    return { action: "ALLOW" };
+  }
+  /**
+   * Checks if a deadline has been exceeded.
+   *
+   * Utility method for handler code.
+   *
+   * @static
+   * @param {object} ctx - Context with deadline
+   * @returns {boolean} True if deadline passed
+   */
+  static isExpired(ctx) {
+    if (!ctx.deadline) return false;
+    return Date.now() > ctx.deadline;
+  }
+  /**
+   * Gets remaining time until deadline.
+   *
+   * Utility method for handler code.
+   *
+   * @static
+   * @param {object} ctx - Context with deadline
+   * @returns {number} Remaining milliseconds (0 if expired, Infinity if no deadline)
+   */
+  static getRemainingMs(ctx) {
+    if (!ctx.deadline) return Infinity;
+    return Math.max(0, ctx.deadline - Date.now());
+  }
+};
+ExecutionTimeoutSensor = __decorateClass([
+  Sensor(),
+  (0, import_common16.Injectable)()
+], ExecutionTimeoutSensor);
+
+// src/sensors/frame-budget.sensor.ts
+var import_common17 = require("@nestjs/common");
+var FrameBudgetSensor = class {
+  constructor(config) {
+    this.config = config;
+    /** AxisSensor identifier for logging and registry */
+    this.name = "FrameBudgetSensor";
+    /**
+     * Execution order - runs after protocol validation
+     *
+     * Order 20 ensures:
+     * - Protocol is valid (ProtocolStrictSensor @ 10)
+     * - Size checked before expensive processing
+     */
+    this.order = BAND.WIRE + 20;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Only activates when Content-Length header is available.
+   * WebSocket frames may not have Content-Length; they use different size tracking.
+   *
+   * @param {SensorInput} input - Incoming AXIS request
+   * @returns {boolean} True if Content-Length is present
+   */
+  supports(input) {
+    return typeof input.contentLength === "number";
+  }
+  /**
+   * Validates frame size against configured limits.
+   *
+   * **Current Implementation:** Stub that always allows.
+   *
+   * **TODO:** Full implementation should:
+   * 1. Load intent policy for the request
+   * 2. Get maxFrameBytes from policy
+   * 3. Compare against contentLength
+   * 4. DENY if exceeded
+   *
+   * @param {SensorInput} input - Request with contentLength
+   * @returns {Promise<SensorDecision>} ALLOW or DENY based on size
+   */
+  async run(input) {
+    const maxBytes = this.config.get("AXIS_MAX_FRAME_SIZE") || 50 * 1024 * 1024;
+    const contentLength = input.contentLength;
+    if (typeof contentLength !== "number") {
+      return { action: "ALLOW" };
+    }
+    if (contentLength > maxBytes) {
+      return {
+        action: "DENY",
+        code: "FRAME_TOO_LARGE",
+        reason: `Frame size ${contentLength} exceeds limit ${maxBytes}`
+      };
+    }
+    return { action: "ALLOW" };
+  }
+};
+FrameBudgetSensor = __decorateClass([
+  Sensor({ phase: "PRE_DECODE" }),
+  (0, import_common17.Injectable)()
+], FrameBudgetSensor);
+
+// src/sensors/frame-header-sanity.sensor.ts
+var import_common18 = require("@nestjs/common");
+var FrameHeaderSanitySensor = class {
+  constructor() {
+    this.name = "FrameHeaderSanitySensor";
+    this.order = BAND.WIRE + 30;
+  }
+  supports(input) {
+    return !!input.peek && input.peek.length >= 7;
+  }
+  async run(input) {
+    const peek = input.peek;
+    const contentLen = input.contentLength || 0;
+    if (peek.length < 5 || !this.bufferEqual(peek.slice(0, 5), import_axis_protocol2.AXIS_MAGIC)) {
+      return {
+        action: "DENY",
+        code: "INVALID_MAGIC",
+        reason: "Frame magic is not AXIS1"
+      };
+    }
+    if (peek[5] !== import_axis_protocol2.AXIS_VERSION) {
+      return {
+        action: "DENY",
+        code: "UNSUPPORTED_VERSION",
+        reason: `Unsupported version: ${peek[5]}`
+      };
+    }
+    if (contentLen > import_axis_protocol2.MAX_FRAME_LEN) {
+      return {
+        action: "DENY",
+        code: "FRAME_TOO_LARGE",
+        reason: `Frame size ${contentLen} exceeds max ${import_axis_protocol2.MAX_FRAME_LEN}`
+      };
+    }
+    return { action: "ALLOW" };
+  }
+  bufferEqual(a, b) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (a[i] !== b[i]) return false;
+    }
+    return true;
+  }
+};
+FrameHeaderSanitySensor = __decorateClass([
+  (0, import_common18.Injectable)(),
+  Sensor({ phase: "PRE_DECODE" })
+], FrameHeaderSanitySensor);
+
+// src/sensors/header-tlv-limit.sensor.ts
+var import_common19 = require("@nestjs/common");
+var HeaderTLVLimitSensor = class {
+  constructor() {
+    this.name = "HeaderTLVLimitSensor";
+    this.order = BAND.CONTENT + 0;
+    this.MAX_TLVS = 64;
+  }
+  supports(input) {
+    return !!input.headerTLVs || !!input.packet;
+  }
+  async run(input) {
+    if (input.headerTLVs && input.headerTLVs.size > this.MAX_TLVS) {
+      return {
+        action: "DENY",
+        code: "TOO_MANY_TLVS",
+        reason: `Header TLVs (${input.headerTLVs.size}) exceed max (${this.MAX_TLVS})`
+      };
+    }
+    if (input.packet && input.packet.headerBytes) {
+      const hdrLen = input.packet.headerBytes.length;
+      if (hdrLen > import_axis_protocol2.MAX_HDR_LEN) {
+        return {
+          action: "DENY",
+          code: "HEADER_TOO_LARGE",
+          reason: `Header size ${hdrLen} exceeds max ${import_axis_protocol2.MAX_HDR_LEN}`
+        };
+      }
+    }
+    return { action: "ALLOW" };
+  }
+};
+HeaderTLVLimitSensor = __decorateClass([
+  (0, import_common19.Injectable)(),
+  Sensor()
+], HeaderTLVLimitSensor);
+
+// src/sensors/intent-allowlist.sensor.ts
+var import_common20 = require("@nestjs/common");
+var PUBLIC_INTENT_ALLOWLIST = [
+  "public.",
+  "schema.",
+  "catalog.",
+  "health.",
+  "system."
+];
+var IntentAllowlistSensor = class {
+  constructor() {
+    this.name = "IntentAllowlistSensor";
+    this.order = BAND.IDENTITY + 20;
+  }
+  supports(input) {
+    return !!input.intent;
+  }
+  async run(input) {
+    const profile = input.metadata?.profile || "PUBLIC";
+    const intent = input.intent || "";
+    if (profile === "PUBLIC") {
+      const isAllowed = PUBLIC_INTENT_ALLOWLIST.some(
+        (prefix) => intent.startsWith(prefix)
+      );
+      if (!isAllowed) {
+        return {
+          action: "DENY",
+          code: "INTENT_NOT_ALLOWED",
+          reason: `Intent '${intent}' not in public allowlist`
+        };
+      }
+    }
+    return { action: "ALLOW" };
+  }
+};
+IntentAllowlistSensor = __decorateClass([
+  (0, import_common20.Injectable)(),
+  Sensor()
+], IntentAllowlistSensor);
+
+// src/sensors/intent-registry.sensor.ts
+var import_common21 = require("@nestjs/common");
+var IntentRegistrySensor = class {
+  constructor(router) {
+    this.router = router;
+    this.name = "IntentRegistrySensor";
+    this.order = BAND.IDENTITY + 25;
+  }
+  supports(input) {
+    return !!input.intent;
+  }
+  async run(input) {
+    const intent = input.intent;
+    if (this.router.has(intent)) {
+      return { action: "ALLOW" };
+    }
+    return {
+      action: "DENY",
+      code: "INTENT_NOT_REGISTERED",
+      reason: `Intent '${intent}' is not registered`
+    };
+  }
+};
+IntentRegistrySensor = __decorateClass([
+  (0, import_common21.Injectable)(),
+  Sensor({ phase: "POST_DECODE" })
+], IntentRegistrySensor);
+
+// src/sensors/proof-presence.sensor.ts
+var import_common22 = require("@nestjs/common");
+var ProofPresenceSensor = class {
+  constructor() {
+    this.name = "ProofPresenceSensor";
+    this.order = BAND.IDENTITY + 30;
+  }
+  supports(input) {
+    return !!input.profile && !!input.visibility;
+  }
+  async run(input) {
+    const validatedInput = ProofPresenceInputZ.safeParse(input);
+    if (!validatedInput.success) {
+      throw new AxisError(
+        "SENSOR_INVALID_INPUT",
+        `Input validation failed: ${validatedInput.error.message}`,
+        400
+      );
+    }
+    const {
+      visibility,
+      requiredProof,
+      hasCapsule,
+      hasPassportSignature,
+      profile,
+      intent
+    } = validatedInput.data;
+    if (visibility === "PUBLIC") {
+      return { action: "ALLOW" };
+    }
+    if (requiredProof.includes("NONE")) {
+      return { action: "ALLOW" };
+    }
+    const hasCapsuleProof = requiredProof.includes("CAPSULE") && hasCapsule;
+    const hasPassportProof = requiredProof.includes("PASSPORT") && hasPassportSignature;
+    const hasNodeProof = requiredProof.includes("MTLS") && profile === "NODE";
+    const satisfied = hasCapsuleProof || hasPassportProof || hasNodeProof;
+    if (!satisfied) {
+      throw new AxisError(
+        "SENSOR_PROOF_REQUIRED",
+        `Proof required for guarded intent: ${intent}`,
+        403
+      );
+    }
+    return { action: "ALLOW" };
+  }
+};
+ProofPresenceSensor = __decorateClass([
+  Sensor(),
+  (0, import_common22.Injectable)()
+], ProofPresenceSensor);
+
+// src/sensors/protocol-strict.sensor.ts
+var import_common23 = require("@nestjs/common");
+var VALID_FLAGS = [
+  0,
+  // No flags
+  import_axis_protocol2.FLAG_BODY_TLV,
+  // Body contains TLVs
+  import_axis_protocol2.FLAG_CHAIN_REQ,
+  // Requires receipt chaining
+  import_axis_protocol2.FLAG_HAS_WITNESS,
+  // Has witness signatures
+  import_axis_protocol2.FLAG_BODY_TLV | import_axis_protocol2.FLAG_CHAIN_REQ,
+  import_axis_protocol2.FLAG_BODY_TLV | import_axis_protocol2.FLAG_HAS_WITNESS,
+  import_axis_protocol2.FLAG_CHAIN_REQ | import_axis_protocol2.FLAG_HAS_WITNESS,
+  import_axis_protocol2.FLAG_BODY_TLV | import_axis_protocol2.FLAG_CHAIN_REQ | import_axis_protocol2.FLAG_HAS_WITNESS
+];
+var ProtocolStrictSensor = class {
+  constructor(config) {
+    this.config = config;
+    this.logger = new import_common23.Logger(ProtocolStrictSensor.name);
+    /** Sensor identifier for logging and registry */
+    this.name = "ProtocolStrictSensor";
+    /**
+     * Execution order - FIRST sensor in the chain
+     *
+     * Order 10 ensures:
+     * - Runs before any other processing
+     * - Invalid frames rejected immediately
+     * - Protects all downstream sensors from malformed input
+     */
+    this.order = BAND.WIRE + 10;
+    this.protocolMagic = import_axis_protocol2.AXIS_MAGIC;
+    this.protocolVersion = import_axis_protocol2.AXIS_VERSION;
+  }
+  /**
+   * Static validation for streaming middleware (Fast Check)
+   */
+  static validateMagic(chunk, expected) {
+    if (chunk.length < expected.length) return { valid: true };
+    const actual = chunk.subarray(0, expected.length);
+    const valid = Buffer.from(actual).equals(Buffer.from(expected));
+    return {
+      valid,
+      actual: valid ? void 0 : new TextDecoder().decode(actual)
+    };
+  }
+  static validateVersion(version, expected) {
+    return version === expected;
+  }
+  /**
+   * Lifecycle hook: Registers this sensor in the chain on module initialization.
+   */
+  onModuleInit() {
+    const magicStr = this.config.get("AXIS_PROTOCOL_MAGIC");
+    this.protocolMagic = magicStr ? Buffer.from(magicStr, "ascii") : import_axis_protocol2.AXIS_MAGIC;
+    this.protocolVersion = this.config.get("AXIS_PROTOCOL_VERSION") || import_axis_protocol2.AXIS_VERSION;
+  }
+  /**
+   * Evaluate protocol strictness
+   */
+  async run(input) {
+    const validatedInput = ProtocolStrictInputZ.safeParse(input);
+    if (!validatedInput.success) {
+      this.logger.error(
+        `Invalid input: ${validatedInput.error.message}`,
+        validatedInput.error.issues
+      );
+      return {
+        action: "DENY",
+        code: "INVALID_INPUT",
+        reason: "Protocol validation input failed"
+      };
+    }
+    const { contentType, peek } = validatedInput.data;
+    const issues = [];
+    if (peek.length >= 8) {
+      const hex = Buffer.from(peek.subarray(0, 10)).toString("hex");
+      this.logger.debug(`Raw Frame Header (Hex): ${hex} (IP: ${input.ip})`);
+    }
+    if (contentType !== void 0) {
+      if (!this.isValidContentType(contentType)) {
+        issues.push(`invalid_content_type:${contentType}`);
+      }
+    }
+    if (peek.length < 9) {
+      return {
+        action: "DENY",
+        code: "FRAME_TOO_SHORT",
+        reason: "Frame too short for protocol header"
+      };
+    }
+    const magicCheck = ProtocolStrictSensor.validateMagic(
+      peek,
+      this.protocolMagic
+    );
+    if (!magicCheck.valid) {
+      return {
+        action: "DENY",
+        code: "INVALID_MAGIC",
+        reason: `Expected ${new TextDecoder().decode(this.protocolMagic)} magic, got ${magicCheck.actual}`
+      };
+    }
+    const version = peek[5];
+    if (!ProtocolStrictSensor.validateVersion(version, this.protocolVersion)) {
+      issues.push(`unsupported_version:${version}`);
+    }
+    const flags = peek[6];
+    if (!this.isValidFlags(flags)) {
+      issues.push(`invalid_flags:0x${flags.toString(16)}`);
+    }
+    if (peek.length >= 10) {
+      const lengthCheck = this.checkVarintEncoding(peek.subarray(7));
+      if (!lengthCheck.valid) {
+        issues.push(`non_minimal_varint:${lengthCheck.reason}`);
+      }
+    }
+    if (peek.length >= 20) {
+      const tlvCheck = this.checkTLVOrdering(peek);
+      if (!tlvCheck.valid) {
+        issues.push(`tlv_not_canonical:${tlvCheck.reason}`);
+      }
+      const hasClientVersion = await this.checkForClientVersion(peek);
+      if (!hasClientVersion) {
+        issues.push("missing_client_version");
+      }
+    }
+    if (issues.length > 0) {
+      const critical = issues.some(
+        (i) => i.startsWith("invalid_magic") || i.startsWith("unsupported_version")
+      );
+      if (critical) {
+        return {
+          action: "DENY",
+          code: "PROTOCOL_VIOLATION",
+          reason: issues.join(", ")
+        };
+      }
+      this.logger.warn(
+        `Protocol issues from ${input.ip}: ${issues.join(", ")}`
+      );
+      return {
+        action: "FLAG",
+        scoreDelta: -issues.length * 2,
+        reasons: issues
+      };
+    }
+    return { action: "ALLOW" };
+  }
+  /**
+   * Compare two buffers for equality
+   */
+  buffersEqual(a, b) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (a[i] !== b[i]) return false;
+    }
+    return true;
+  }
+  /**
+   * Check if Content-Type is valid for AXIS
+   */
+  isValidContentType(contentType) {
+    const valid = [
+      "application/axis-bin",
+      "application/octet-stream",
+      "application/x-axis"
+    ];
+    return valid.some((v) => contentType.toLowerCase().includes(v));
+  }
+  /**
+   * Check if flags are a valid combination
+   */
+  isValidFlags(flags) {
+    return VALID_FLAGS.includes(flags);
+  }
+  /**
+   * Check varint encoding is minimal (no leading zeros)
+   */
+  checkVarintEncoding(data) {
+    try {
+      const { value, length: bytesRead } = (0, import_axis_protocol3.decodeVarint)(data, 0);
+      if (value < 128 && bytesRead > 1) {
+        return { valid: false, reason: "non-minimal-small-value" };
+      }
+      if (value < 16384 && bytesRead > 2) {
+        return { valid: false, reason: "non-minimal-medium-value" };
+      }
+      return { valid: true };
+    } catch {
+      return { valid: false, reason: "varint-decode-error" };
+    }
+  }
+  /**
+   * Check TLV ordering is canonical (sorted by type, no duplicates)
+   */
+  checkTLVOrdering(data) {
+    try {
+      let offset = 7;
+      const { value: hdrLen, length: hdrBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += hdrBytes;
+      const { length: bodyBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += bodyBytes;
+      const { length: sigBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += sigBytes;
+      const hdrStart = offset;
+      const hdrEnd = hdrStart + Number(hdrLen);
+      if (hdrEnd > data.length) {
+        return { valid: true };
+      }
+      let lastType = -1;
+      let pos = hdrStart;
+      while (pos < hdrEnd && pos < data.length - 2) {
+        const { value: type, length: typeBytes } = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += typeBytes;
+        if (pos >= hdrEnd) break;
+        const { value: len, length: lenBytes } = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += lenBytes;
+        if (Number(type) <= lastType) {
+          return {
+            valid: false,
+            reason: `type-${type}-after-${lastType}`
+          };
+        }
+        lastType = Number(type);
+        pos += Number(len);
+      }
+      return { valid: true };
+    } catch {
+      return { valid: true };
+    }
+  }
+  /**
+   * Check if TLV 100 (Client Version) exists in the headers
+   */
+  async checkForClientVersion(data) {
+    try {
+      let offset = 7;
+      const { value: hdrLen, length: hdrBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += hdrBytes;
+      const { length: bodyBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += bodyBytes;
+      const { length: sigBytes } = (0, import_axis_protocol3.decodeVarint)(data, offset);
+      offset += sigBytes;
+      const hdrEnd = offset + Number(hdrLen);
+      let pos = offset;
+      while (pos < hdrEnd && pos < data.length) {
+        const { value: type, length: typeBytes } = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += typeBytes;
+        const { length: lenBytes } = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += lenBytes;
+        const { value: valLen, length: valLenBytes } = (0, import_axis_protocol3.decodeVarint)(
+          data,
+          pos - lenBytes
+        );
+      }
+      pos = offset;
+      while (pos < hdrEnd && pos < data.length) {
+        const t = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += t.length;
+        const l = (0, import_axis_protocol3.decodeVarint)(data, pos);
+        pos += l.length;
+        if (t.value === 100) return true;
+        pos += Number(l.value);
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+};
+ProtocolStrictSensor = __decorateClass([
+  Sensor({ phase: "PRE_DECODE" }),
+  (0, import_common23.Injectable)()
+], ProtocolStrictSensor);
+
+// src/sensors/receipt-policy.sensor.ts
+var import_common24 = require("@nestjs/common");
+var ReceiptPolicySensor = class {
+  constructor() {
+    this.name = "ReceiptPolicySensor";
+    this.order = BAND.BUSINESS + 20;
+  }
+  supports() {
+    return true;
+  }
+  async run() {
+    return { action: "ALLOW" };
+  }
+};
+ReceiptPolicySensor = __decorateClass([
+  (0, import_common24.Injectable)(),
+  Sensor()
+], ReceiptPolicySensor);
+
+// src/sensors/schema-validation.sensor.ts
+var import_common25 = require("@nestjs/common");
+function readU64be(b) {
+  if (b.length !== 8)
+    throw new AxisError("SCHEMA_TYPE_MISMATCH", "u64 must be 8 bytes", 400);
+  let x = 0n;
+  for (const by of b) x = x << 8n | BigInt(by);
+  return x;
+}
+var SchemaValidationSensor = class {
+  constructor() {
+    /** Sensor identifier for logging and registry */
+    this.name = "SchemaValidationSensor";
+    /**
+     * Execution order - runs late in the pipeline
+     *
+     * Order 170 ensures:
+     * - All authentication complete
+     * - All policy checks complete
+     * - Data validated before handler execution
+     */
+    this.order = BAND.CONTENT + 35;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Only activates when a schema is provided for the intent (post-decode phase).
+   *
+   * @param {any} input - Sensor input
+   * @returns {boolean} True if schema exists in metadata
+   */
+  supports(input) {
+    return !!input.metadata?.schema;
+  }
+  /**
+   * Validates TLV fields against the schema definition.
+   *
+   * **Validation Steps:**
+   * 1. Validate the schema itself using Zod
+   * 2. Iterate through each field definition
+   * 3. Check required fields are present
+   * 4. Validate size limits (maxLen)
+   * 5. Validate type-specific rules
+   *
+   * @param {any} input - Standard SensorInput
+   * @returns {{ action: 'ALLOW' } | { action: 'DENY', code: string, reason: string }} Decision
+   */
+  async run(input) {
+    const schema = input.metadata?.schema;
+    const headerTLVs = input.headerTLVs;
+    const bodyTLVs = input.bodyTLVs;
+    if (!schema) {
+      return { action: "ALLOW" };
+    }
+    const validatedSchema = IntentSchemaZ.safeParse(schema);
+    if (!validatedSchema.success) {
+      return {
+        action: "DENY",
+        code: "SCHEMA_INVALID",
+        reason: `Schema validation failed: ${validatedSchema.error.message}`
+      };
+    }
+    try {
+      for (const field of schema.fields) {
+        const scope = field.scope ?? "body";
+        const map3 = scope === "header" ? headerTLVs : bodyTLVs;
+        const val = map3?.get(field.tlv);
+        if (field.required && !val) {
+          throw new AxisError(
+            "SCHEMA_FIELD_MISSING",
+            `Missing required field: ${field.name} (TLV ${field.tlv})`,
+            400
+          );
+        }
+        if (!val) continue;
+        if (typeof field.maxLen === "number" && val.length > field.maxLen) {
+          throw new AxisError(
+            "SCHEMA_LIMIT_EXCEEDED",
+            `Field ${field.name} too large (${val.length} > ${field.maxLen})`,
+            413
+            // Payload Too Large
+          );
+        }
+        switch (field.kind) {
+          case "utf8":
+            try {
+              new TextDecoder("utf-8", { fatal: true }).decode(val);
+            } catch {
+              throw new AxisError(
+                "SCHEMA_TYPE_MISMATCH",
+                `Invalid UTF-8 in ${field.name}`,
+                400
+              );
+            }
+            break;
+          case "bool":
+            if (val.length !== 1 || val[0] !== 0 && val[0] !== 1) {
+              throw new AxisError(
+                "SCHEMA_TYPE_MISMATCH",
+                `Invalid bool: ${field.name}`,
+                400
+              );
+            }
+            break;
+          case "u64": {
+            const x = readU64be(val);
+            if (field.max) {
+              const mx = BigInt(field.max);
+              if (x > mx) {
+                throw new AxisError(
+                  "SCHEMA_LIMIT_EXCEEDED",
+                  `u64 ${field.name} exceeds max (${x} > ${mx})`,
+                  400
+                );
+              }
+            }
+            break;
+          }
+          case "bytes16":
+            if (val.length !== 16) {
+              throw new AxisError(
+                "SCHEMA_TYPE_MISMATCH",
+                `bytes16 required for ${field.name}`,
+                400
+              );
+            }
+            break;
+          case "bytes":
+            break;
+          case "obj":
+          case "arr":
+            break;
+          default:
+            throw new AxisError(
+              "SCHEMA_TYPE_MISMATCH",
+              `Unknown schema kind: ${field.kind}`,
+              500
+            );
+        }
+      }
+      const validators = input.metadata?.validators;
+      if (validators && validators.size > 0) {
+        for (const field of schema.fields) {
+          const fns = validators.get(field.tlv);
+          if (!fns || fns.length === 0) continue;
+          const scope = field.scope ?? "body";
+          const map3 = scope === "header" ? headerTLVs : bodyTLVs;
+          const val = map3?.get(field.tlv);
+          if (!val) continue;
+          for (const fn of fns) {
+            const error = fn(val, field.name);
+            if (error) {
+              throw new AxisError(
+                "SCHEMA_VALIDATION_FAILED",
+                `${field.name} (TLV ${field.tlv}): ${error}`,
+                400
+              );
+            }
+          }
+        }
+      }
+    } catch (err) {
+      if (err instanceof AxisError) {
+        return {
+          action: "DENY",
+          code: err.code,
+          reason: err.message
+        };
+      }
+      throw err;
+    }
+    return { action: "ALLOW" };
+  }
+};
+SchemaValidationSensor = __decorateClass([
+  Sensor(),
+  (0, import_common25.Injectable)()
+], SchemaValidationSensor);
+
+// src/sensors/stream-scope.sensor.ts
+var import_common26 = require("@nestjs/common");
+var StreamScopeSensor = class {
+  constructor() {
+    /** Sensor identifier */
+    this.name = "StreamScopeSensor";
+    /**
+     * Execution order - near handler execution
+     *
+     * Order 200 ensures:
+     * - All authentication complete
+     * - All policy checks complete
+     * - Stream-specific check right before subscription
+     */
+    this.order = BAND.BUSINESS + 0;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Currently processes all inputs.
+   *
+   * @returns {boolean} Always true
+   */
+  supports() {
+    return true;
+  }
+  /**
+   * Validates stream topic access permissions.
+   *
+   * **Current Implementation:** Stub that always allows.
+   *
+   * **TODO:** Full implementation should:
+   * 1. Check if intent is stream.subscribe or stream.publish
+   * 2. Extract topic from body TLVs
+   * 3. Parse topic into owner/resource pattern
+   * 4. Look up topic ACL from database/cache
+   * 5. Check if actor has required permission (read/write)
+   * 6. DENY if unauthorized
+   *
+   * @returns {Promise<SensorDecision>} ALLOW (stub implementation)
+   */
+  async run() {
+    return { action: "ALLOW" };
+  }
+};
+StreamScopeSensor = __decorateClass([
+  Sensor(),
+  (0, import_common26.Injectable)()
+], StreamScopeSensor);
+
+// src/sensors/tlv-parse.sensor.ts
+var import_common27 = require("@nestjs/common");
+var TLVParseSensor = class {
+  constructor() {
+    this.name = "TLVParseSensor";
+    this.order = BAND.CONTENT + 20;
+  }
+  supports(input) {
+    return !!input.packet;
+  }
+  async run(input) {
+    const packet = input.packet;
+    if (!packet) return { action: "ALLOW" };
+    const hdrBytes = packet.hdrBytes ?? packet.headerBytes;
+    if (hdrBytes && hdrBytes.length > 0) {
+      const result = this.validateCanonicalTLV(hdrBytes, "header");
+      if (result) return result;
+    }
+    const bodyBytes = packet.bodyBytes ?? input.body;
+    const bodyIsTlv = packet.flags !== void 0 ? (packet.flags & 1) !== 0 : false;
+    const bodyProfile = input.metadata?.schema?.bodyProfile;
+    const skipBody = bodyProfile === "RAW";
+    if (!skipBody && bodyIsTlv && bodyBytes && bodyBytes.length > 0) {
+      const result = this.validateCanonicalTLV(bodyBytes, "body");
+      if (result) return result;
+    }
+    return { action: "ALLOW" };
+  }
+  /**
+   * Validates a TLV buffer for canonical ordering, no duplicates,
+   * valid bounds, and minimal varint encoding.
+   */
+  validateCanonicalTLV(buf, section) {
+    let offset = 0;
+    let lastType = -1;
+    let count = 0;
+    const maxItems = 512;
+    while (offset < buf.length) {
+      if (count >= maxItems) {
+        return {
+          action: "DENY",
+          code: "TLV_LIMIT",
+          reason: `Too many TLVs in ${section}`
+        };
+      }
+      let type;
+      let typeLen;
+      try {
+        const r = (0, import_axis_protocol3.decodeVarint)(buf, offset);
+        type = r.value;
+        typeLen = r.length;
+      } catch {
+        return {
+          action: "DENY",
+          code: "TLV_PARSE_ERROR",
+          reason: `Malformed type varint in ${section} at offset ${offset}`
+        };
+      }
+      offset += typeLen;
+      if (type <= 0) {
+        return {
+          action: "DENY",
+          code: "TLV_INVALID_TAG",
+          reason: `Invalid tag ${type} in ${section}`
+        };
+      }
+      if (type <= lastType) {
+        return {
+          action: "DENY",
+          code: "TLV_NOT_CANONICAL",
+          reason: `Non-canonical tag order in ${section}: ${type} after ${lastType}`
+        };
+      }
+      lastType = type;
+      let len;
+      let lenLen;
+      try {
+        const r = (0, import_axis_protocol3.decodeVarint)(buf, offset);
+        len = r.value;
+        lenLen = r.length;
+      } catch {
+        return {
+          action: "DENY",
+          code: "TLV_PARSE_ERROR",
+          reason: `Malformed length varint in ${section}`
+        };
+      }
+      offset += lenLen;
+      if (offset + len > buf.length) {
+        return {
+          action: "DENY",
+          code: "TLV_TRUNCATED",
+          reason: `TLV value truncated in ${section}`
+        };
+      }
+      offset += len;
+      count++;
+    }
+    return null;
+  }
+};
+TLVParseSensor = __decorateClass([
+  Sensor(),
+  (0, import_common27.Injectable)()
+], TLVParseSensor);
+
+// src/sensors/varint-hardening.sensor.ts
+var import_common28 = require("@nestjs/common");
+var VarintHardeningSensor = class {
+  constructor() {
+    /** Sensor identifier */
+    this.name = "VarintHardeningSensor";
+    /**
+     * Execution order - early detection
+     *
+     * Order 40 ensures:
+     * - After protocol magic check
+     * - Before length-based parsing
+     */
+    this.order = BAND.WIRE + 35;
+    /** Maximum allowed bytes for a single varint */
+    this.MAX_VARINT_BYTES = 5;
+  }
+  /**
+   * Determines if this sensor should process the given input.
+   *
+   * Requires at least 7 bytes of peeked data.
+   *
+   * @param {SensorInput} input - Incoming request
+   * @returns {boolean} True if sufficient peek data
+   */
+  supports(input) {
+    return !!input.peek && input.peek.length >= 7;
+  }
+  /**
+   * Validates varint lengths in frame header.
+   *
+   * **Processing Flow:**
+   * 1. Skip to varint section (offset 7)
+   * 2. Scan for continuation bytes (MSB = 1)
+   * 3. Count consecutive continuation bytes
+   * 4. DENY if count exceeds MAX_VARINT_BYTES
+   *
+   * @param {SensorInput} input - Request with peek data
+   * @returns {Promise<SensorDecision>} ALLOW or DENY based on varint length
+   */
+  async run(input) {
+    const peek = input.peek;
+    const offset = 7;
+    const maxOffset = Math.min(offset + 15, peek.length);
+    let continuationCount = 0;
+    for (let i = offset; i < maxOffset; i++) {
+      if ((peek[i] & 128) !== 0) {
+        continuationCount++;
+        if (continuationCount > this.MAX_VARINT_BYTES) {
+          return {
+            action: "DENY",
+            code: "VARINT_OVERFLOW",
+            reason: `Varint exceeds ${this.MAX_VARINT_BYTES} bytes`
+          };
+        }
+      } else {
+        continuationCount = 0;
+      }
+    }
+    return { action: "ALLOW" };
+  }
+};
+VarintHardeningSensor = __decorateClass([
+  Sensor({ phase: "PRE_DECODE" }),
+  (0, import_common28.Injectable)()
+], VarintHardeningSensor);
+
+// src/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  encodeAxisTlvDto: () => encodeAxisTlvDto
+});
+
+// src/utils/axis-tlv-codec.ts
+function encodeAxisTlvDto(dtoClass, data) {
+  const schema = extractDtoSchema(dtoClass);
+  const items = schema.fields.flatMap((field) => {
+    const value = data[field.name];
+    if (value === void 0 || value === null) {
+      if (field.required) {
+        throw new Error(`Missing required TLV response field: ${field.name}`);
+      }
+      return [];
+    }
+    return [{ type: field.tag, value: encodeField(field, value) }];
+  });
+  return buildTLVs(items);
+}
+function encodeField(field, value) {
+  switch (field.kind) {
+    case "utf8":
+      return Buffer.from(String(value), "utf8");
+    case "u64":
+      return encodeU64(value);
+    case "bytes":
+    case "bytes16":
+      return toBuffer(value);
+    case "bool":
+      return Buffer.from([value ? 1 : 0]);
+    case "obj":
+    case "arr":
+      return Buffer.from(JSON.stringify(value), "utf8");
+    default:
+      return toBuffer(value);
+  }
+}
+function encodeU64(value) {
+  const encoded = Buffer.alloc(8);
+  encoded.writeBigUInt64BE(
+    typeof value === "bigint" ? value : BigInt(value)
+  );
+  return encoded;
+}
+function toBuffer(value) {
+  if (Buffer.isBuffer(value)) {
+    return value;
+  }
+  if (value instanceof Uint8Array) {
+    return Buffer.from(value);
+  }
+  if (typeof value === "string") {
+    return Buffer.from(value, "utf8");
+  }
+  throw new Error(`Unsupported TLV bytes value: ${typeof value}`);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ATS1_HDR,
   ATS1_SCHEMA,
   AXIS_MAGIC,
   AXIS_OPCODES,
+  AXIS_UPLOAD_FILE_STORE,
+  AXIS_UPLOAD_RECEIPT_SIGNER,
+  AXIS_UPLOAD_SESSION_STORE,
   AXIS_VERSION,
   Ats1Codec,
+  AxisFilesDownloadHandler,
+  AxisFilesFinalizeHandler,
   AxisFrameZ,
   AxisIdDto,
   AxisPacketTags,
@@ -2401,6 +5661,7 @@ function isTimestampValid(ts, skewSeconds = 120) {
   DEFAULT_CONTRACTS,
   DEFAULT_TIMEOUT,
   Decision,
+  DiskUploadFileStore,
   ERR_BAD_SIGNATURE,
   ERR_CONTRACT_VIOLATION,
   ERR_INVALID_PACKET,
@@ -2412,14 +5673,18 @@ function isTimestampValid(ts, skewSeconds = 120) {
   FLAG_HAS_WITNESS,
   HANDLER_METADATA_KEY,
   Handler,
+  INTENT_BODY_KEY,
   INTENT_METADATA_KEY,
   INTENT_REQUIREMENTS,
   INTENT_ROUTES_KEY,
   INTENT_SENSITIVITY_MAP,
+  INTENT_SENSORS_KEY,
   INTENT_TIMEOUTS,
   Intent,
+  IntentBody,
   IntentRouter,
   IntentSensitivity,
+  IntentSensors,
   MAX_BODY_LEN,
   MAX_FRAME_LEN,
   MAX_HDR_LEN,
@@ -2510,6 +5775,8 @@ function isTimestampValid(ts, skewSeconds = 120) {
   classifyIntent,
   computeReceiptHash,
   computeSignaturePayload,
+  core,
+  crypto,
   decodeArray,
   decodeAxis1Frame,
   decodeFrame,
@@ -2517,11 +5784,13 @@ function isTimestampValid(ts, skewSeconds = 120) {
   decodeTLVs,
   decodeTLVsList,
   decodeVarint,
+  decorators,
   encVarint,
   encodeAxis1Frame,
   encodeFrame,
   encodeTLVs,
   encodeVarint,
+  engine,
   extractDtoSchema,
   generateEd25519KeyPair,
   getSignTarget,
@@ -2529,6 +5798,7 @@ function isTimestampValid(ts, skewSeconds = 120) {
   isAdminOpcode,
   isKnownOpcode,
   isTimestampValid,
+  loom,
   nonce16,
   normalizeSensorDecision,
   packPasskeyLoginOptionsReq,
@@ -2538,7 +5808,10 @@ function isTimestampValid(ts, skewSeconds = 120) {
   packPasskeyRegisterOptionsReq,
   parseScope,
   resolveTimeout,
+  schemas,
+  security,
   sensitivityName,
+  sensors,
   sha256,
   signFrame,
   tlv,
@@ -2547,6 +5820,7 @@ function isTimestampValid(ts, skewSeconds = 120) {
   unpackPasskeyLoginVerifyReq,
   unpackPasskeyRegisterOptionsReq,
   utf8,
+  utils,
   validateFrameShape,
   varintLength,
   varintU,