@humanagencyp/hap-core 0.4.5 → 0.4.6

package/dist/index.d.mts

@@ -118,6 +118,17 @@ type BoundType =
     kind: 'enum';
     values: readonly string[];
 };
+/**
+ * The measurement dimension of a numeric bound's value.
+ *
+ * Orthogonal to `BoundType` (which describes how the bound is *enforced*).
+ * `unit` describes what the *value* means — 4 minutes vs 4 hours vs 4 EUR.
+ *
+ * UI uses this to render the unit next to the input. Future gatekeeper
+ * versions can use it to enforce unit alignment between profile bounds
+ * and tool payloads.
+ */
+type FieldUnit = 'count' | 'minutes' | 'hours' | 'days' | `currency:${string}` | 'percent';
 /**
  * Bounds field definition within a v0.4 profile.
  *
@@ -138,6 +149,13 @@ interface ProfileBoundsField {
      * treat a missing boundType as an error when running in v0.4 mode.
      */
     boundType?: BoundType;
+    /**
+     * The measurement dimension of the bound's value. UI renders the unit
+     * inline next to the input (e.g. `4 min`, `100 EUR`). Independent from
+     * `boundType` — the same unit can appear under different enforcement
+     * kinds, and the same boundType can carry different units.
+     */
+    unit?: FieldUnit;
     /** @deprecated v0.4: use boundType instead. */
     constraint?: FieldConstraint;
     /** @deprecated v0.4: use boundType: { kind: 'enum', values: [...] }. */
@@ -580,4 +598,4 @@ declare function listProfiles(): string[];
 declare function getAllProfiles(): AgentProfile[];
 declare function clearProfiles(): void;
 
-export { type AgentBoundsParams, type AgentContextParams, type AgentFrameParams, type AgentProfile, type Attestation, type AttestationHeader, type AttestationPayload, type BoundType, type CumulativeFieldDef, type CumulativeWindow, type DeclaredFieldDef, type ExecutionContextFieldDef, type ExecutionLogEntry, type ExecutionLogQuery, type ExecutionMappingTransform, type ExecutionMappingValue, type ExecutionPath, type FieldConstraint, type GateQuestion, type GatekeeperError, type GatekeeperRequest, type GatekeeperResult, type ProfileBoundsField, type ProfileContextField, type ProfileFrameField, type ProfileToolGating, type ProfileToolGatingEntry, type ResolvedDomain, attestationId, canonicalBounds, canonicalContext, canonicalFrame, checkAttestationExpiry, clearProfiles, computeBoundsHash, computeContextHash, computeFrameHash, decodeAttestationBlob, encodeAttestationBlob, frameHash, getAllProfiles, getProfile, isV4Attestation, listProfiles, registerProfile, validateBoundsParams, validateContextParams, validateFrameParams, verify, verifyAttestation, verifyAttestationSignature, verifyAttestationV4, verifyBoundsHash, verifyContextHash, verifyFrameHash };
+export { type AgentBoundsParams, type AgentContextParams, type AgentFrameParams, type AgentProfile, type Attestation, type AttestationHeader, type AttestationPayload, type BoundType, type CumulativeFieldDef, type CumulativeWindow, type DeclaredFieldDef, type ExecutionContextFieldDef, type ExecutionLogEntry, type ExecutionLogQuery, type ExecutionMappingTransform, type ExecutionMappingValue, type ExecutionPath, type FieldConstraint, type FieldUnit, type GateQuestion, type GatekeeperError, type GatekeeperRequest, type GatekeeperResult, type ProfileBoundsField, type ProfileContextField, type ProfileFrameField, type ProfileToolGating, type ProfileToolGatingEntry, type ResolvedDomain, attestationId, canonicalBounds, canonicalContext, canonicalFrame, checkAttestationExpiry, clearProfiles, computeBoundsHash, computeContextHash, computeFrameHash, decodeAttestationBlob, encodeAttestationBlob, frameHash, getAllProfiles, getProfile, isV4Attestation, listProfiles, registerProfile, validateBoundsParams, validateContextParams, validateFrameParams, verify, verifyAttestation, verifyAttestationSignature, verifyAttestationV4, verifyBoundsHash, verifyContextHash, verifyFrameHash };

package/dist/index.d.ts

@@ -118,6 +118,17 @@ type BoundType =
     kind: 'enum';
     values: readonly string[];
 };
+/**
+ * The measurement dimension of a numeric bound's value.
+ *
+ * Orthogonal to `BoundType` (which describes how the bound is *enforced*).
+ * `unit` describes what the *value* means — 4 minutes vs 4 hours vs 4 EUR.
+ *
+ * UI uses this to render the unit next to the input. Future gatekeeper
+ * versions can use it to enforce unit alignment between profile bounds
+ * and tool payloads.
+ */
+type FieldUnit = 'count' | 'minutes' | 'hours' | 'days' | `currency:${string}` | 'percent';
 /**
  * Bounds field definition within a v0.4 profile.
  *
@@ -138,6 +149,13 @@ interface ProfileBoundsField {
      * treat a missing boundType as an error when running in v0.4 mode.
      */
     boundType?: BoundType;
+    /**
+     * The measurement dimension of the bound's value. UI renders the unit
+     * inline next to the input (e.g. `4 min`, `100 EUR`). Independent from
+     * `boundType` — the same unit can appear under different enforcement
+     * kinds, and the same boundType can carry different units.
+     */
+    unit?: FieldUnit;
     /** @deprecated v0.4: use boundType instead. */
     constraint?: FieldConstraint;
     /** @deprecated v0.4: use boundType: { kind: 'enum', values: [...] }. */
@@ -580,4 +598,4 @@ declare function listProfiles(): string[];
 declare function getAllProfiles(): AgentProfile[];
 declare function clearProfiles(): void;
 
-export { type AgentBoundsParams, type AgentContextParams, type AgentFrameParams, type AgentProfile, type Attestation, type AttestationHeader, type AttestationPayload, type BoundType, type CumulativeFieldDef, type CumulativeWindow, type DeclaredFieldDef, type ExecutionContextFieldDef, type ExecutionLogEntry, type ExecutionLogQuery, type ExecutionMappingTransform, type ExecutionMappingValue, type ExecutionPath, type FieldConstraint, type GateQuestion, type GatekeeperError, type GatekeeperRequest, type GatekeeperResult, type ProfileBoundsField, type ProfileContextField, type ProfileFrameField, type ProfileToolGating, type ProfileToolGatingEntry, type ResolvedDomain, attestationId, canonicalBounds, canonicalContext, canonicalFrame, checkAttestationExpiry, clearProfiles, computeBoundsHash, computeContextHash, computeFrameHash, decodeAttestationBlob, encodeAttestationBlob, frameHash, getAllProfiles, getProfile, isV4Attestation, listProfiles, registerProfile, validateBoundsParams, validateContextParams, validateFrameParams, verify, verifyAttestation, verifyAttestationSignature, verifyAttestationV4, verifyBoundsHash, verifyContextHash, verifyFrameHash };
+export { type AgentBoundsParams, type AgentContextParams, type AgentFrameParams, type AgentProfile, type Attestation, type AttestationHeader, type AttestationPayload, type BoundType, type CumulativeFieldDef, type CumulativeWindow, type DeclaredFieldDef, type ExecutionContextFieldDef, type ExecutionLogEntry, type ExecutionLogQuery, type ExecutionMappingTransform, type ExecutionMappingValue, type ExecutionPath, type FieldConstraint, type FieldUnit, type GateQuestion, type GatekeeperError, type GatekeeperRequest, type GatekeeperResult, type ProfileBoundsField, type ProfileContextField, type ProfileFrameField, type ProfileToolGating, type ProfileToolGatingEntry, type ResolvedDomain, attestationId, canonicalBounds, canonicalContext, canonicalFrame, checkAttestationExpiry, clearProfiles, computeBoundsHash, computeContextHash, computeFrameHash, decodeAttestationBlob, encodeAttestationBlob, frameHash, getAllProfiles, getProfile, isV4Attestation, listProfiles, registerProfile, validateBoundsParams, validateContextParams, validateFrameParams, verify, verifyAttestation, verifyAttestationSignature, verifyAttestationV4, verifyBoundsHash, verifyContextHash, verifyFrameHash };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humanagencyp/hap-core",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Core types, cryptographic primitives, and verification logic for the Human Agency Protocol",
   "license": "MIT",
   "repository": {

package/src/types.ts

@@ -117,6 +117,22 @@ export type BoundType =
    */
   | { kind: 'enum'; values: readonly string[] };
 
+/**
+ * The measurement dimension of a numeric bound's value.
+ *
+ * Orthogonal to `BoundType` (which describes how the bound is *enforced*).
+ * `unit` describes what the *value* means — 4 minutes vs 4 hours vs 4 EUR.
+ *
+ * UI uses this to render the unit next to the input. Future gatekeeper
+ * versions can use it to enforce unit alignment between profile bounds
+ * and tool payloads.
+ */
+export type FieldUnit =
+  | 'count'                 // dimensionless integer (no unit suffix in UI)
+  | 'minutes' | 'hours' | 'days'
+  | `currency:${string}`    // ISO 4217 code, e.g. 'currency:EUR'
+  | 'percent';
+
 /**
  * Bounds field definition within a v0.4 profile.
  *
@@ -137,6 +153,13 @@ export interface ProfileBoundsField {
    * treat a missing boundType as an error when running in v0.4 mode.
    */
   boundType?: BoundType;
+  /**
+   * The measurement dimension of the bound's value. UI renders the unit
+   * inline next to the input (e.g. `4 min`, `100 EUR`). Independent from
+   * `boundType` — the same unit can appear under different enforcement
+   * kinds, and the same boundType can carry different units.
+   */
+  unit?: FieldUnit;
   /** @deprecated v0.4: use boundType instead. */
   constraint?: FieldConstraint;
   /** @deprecated v0.4: use boundType: { kind: 'enum', values: [...] }. */