@vorionsys/shared-constants 1.0.2 → 1.0.3

package/dist/index.cjs

@@ -34,6 +34,8 @@ __export(index_exports, {
   BASIS_SPEC_VERSION: () => BASIS_SPEC_VERSION,
   BASIS_VERSIONS: () => BASIS_VERSIONS,
   CAPABILITIES: () => CAPABILITIES,
+  CARCategory: () => CARCategory,
+  CAR_CATEGORIES: () => CAR_CATEGORIES,
   CAR_SPEC_CURRENT_VERSION: () => CAR_SPEC_CURRENT_VERSION,
   CAR_SPEC_VERSIONS: () => CAR_SPEC_VERSIONS,
   COGNIGATE_CURRENT_VERSION: () => COGNIGATE_CURRENT_VERSION,
@@ -75,8 +77,14 @@ __export(index_exports, {
   formatErrorMessage: () => formatErrorMessage,
   formatRateLimit: () => formatRateLimit,
   getActiveTheme: () => getActiveTheme,
+  getAllCARCategoryCodes: () => getAllCARCategoryCodes,
+  getAllCARSubcategoryCodes: () => getAllCARSubcategoryCodes,
   getAllCapabilityCodes: () => getAllCapabilityCodes,
   getAllThemeIds: () => getAllThemeIds,
+  getCARCategoriesForTier: () => getCARCategoriesForTier,
+  getCARCategory: () => getCARCategory,
+  getCARCategoryMinTier: () => getCARCategoryMinTier,
+  getCARSubcategory: () => getCARSubcategory,
   getCapabilitiesByCategory: () => getCapabilitiesByCategory,
   getCapabilitiesForTier: () => getCapabilitiesForTier,
   getCapability: () => getCapability,
@@ -84,7 +92,9 @@ __export(index_exports, {
   getCurrentVersion: () => getCurrentVersion,
   getErrorByCode: () => getErrorByCode,
   getErrorsByCategory: () => getErrorsByCategory,
+  getHighRiskCategories: () => getHighRiskCategories,
   getMinTierForLimits: () => getMinTierForLimits,
+  getParentCategory: () => getParentCategory,
   getProduct: () => getProduct,
   getProductsByCategory: () => getProductsByCategory,
   getProductsByOrganization: () => getProductsByOrganization,
@@ -100,8 +110,11 @@ __export(index_exports, {
   getTierName: () => getTierName,
   getTierThreshold: () => getTierThreshold,
   getVersionDefinition: () => getVersionDefinition,
+  isCARCategoryAvailable: () => isCARCategoryAvailable,
   isCapabilityAvailable: () => isCapabilityAvailable,
   isUnlimited: () => isUnlimited,
+  isValidCARCategory: () => isValidCARCategory,
+  isValidCARSubcategory: () => isValidCARSubcategory,
   isVersionDeprecated: () => isVersionDeprecated,
   isVersionSupported: () => isVersionSupported,
   meetsTierRequirement: () => meetsTierRequirement,
@@ -388,12 +401,13 @@ var ALL_DOMAINS = {
 // src/capabilities.ts
 var CapabilityCategory = /* @__PURE__ */ ((CapabilityCategory2) => {
   CapabilityCategory2["DATA_ACCESS"] = "data_access";
+  CapabilityCategory2["FILE_OPERATIONS"] = "file_operations";
   CapabilityCategory2["API_ACCESS"] = "api_access";
   CapabilityCategory2["CODE_EXECUTION"] = "code_execution";
   CapabilityCategory2["AGENT_INTERACTION"] = "agent_interaction";
   CapabilityCategory2["RESOURCE_MANAGEMENT"] = "resource_management";
+  CapabilityCategory2["SYSTEM_ADMINISTRATION"] = "system_administration";
   CapabilityCategory2["GOVERNANCE"] = "governance";
-  CapabilityCategory2["ADMIN"] = "admin";
   return CapabilityCategory2;
 })(CapabilityCategory || {});
 var CAPABILITIES = [
@@ -433,7 +447,7 @@ var CAPABILITIES = [
   {
     code: "CAP-FILE-WRITE",
     name: "Write Files",
-    category: "data_access" /* DATA_ACCESS */,
+    category: "file_operations" /* FILE_OPERATIONS */,
     description: "Write to approved directories",
     unlockTier: 2 /* T2_PROVISIONAL */,
     constraints: ["Approved dirs only", "Size limited"]
@@ -549,7 +563,7 @@ var CAPABILITIES = [
   {
     code: "CAP-FULL-ADMIN",
     name: "Full Administration",
-    category: "admin" /* ADMIN */,
+    category: "system_administration" /* SYSTEM_ADMINISTRATION */,
     description: "Full administrative access",
     unlockTier: 7 /* T7_AUTONOMOUS */
   },
@@ -624,7 +638,7 @@ var VORION_PRODUCTS = {
   carId: {
     id: "car-id",
     name: "CAR ID",
-    description: "Categorical Agent Registry - Universal agent identification system",
+    description: "Categorical Agentic Registry - Universal agent identification system",
     category: "open_source" /* OPEN_SOURCE */,
     status: "ga" /* GA */,
     url: "https://carid.vorion.org",
@@ -1663,8 +1677,320 @@ function themeToCssVars(themeId = ACTIVE_THEME) {
   `.trim();
 }
 
+// src/car-categories.ts
+var CARCategory = /* @__PURE__ */ ((CARCategory2) => {
+  CARCategory2["GOVERNANCE"] = "GOV";
+  CARCategory2["REASONING"] = "RSN";
+  CARCategory2["TOOL_USE"] = "TUL";
+  CARCategory2["MEMORY"] = "MEM";
+  CARCategory2["MULTI_AGENT"] = "MAG";
+  CARCategory2["SAFETY"] = "SAF";
+  CARCategory2["AUDIT"] = "AUD";
+  CARCategory2["COMPLIANCE"] = "CMP";
+  CARCategory2["FINANCE"] = "FIN";
+  CARCategory2["HEALTHCARE"] = "HLT";
+  CARCategory2["EMPLOYMENT"] = "EMP";
+  CARCategory2["CREATIVE"] = "CRE";
+  CARCategory2["RESEARCH"] = "RES";
+  CARCategory2["SWARM"] = "SWM";
+  CARCategory2["SELF_IMPROVEMENT"] = "SLF";
+  CARCategory2["HUMAN_INTERFACE"] = "HIF";
+  CARCategory2["SYSTEM"] = "SYS";
+  return CARCategory2;
+})(CARCategory || {});
+var CAR_CATEGORIES = [
+  // ---- Core Agent Functions ----
+  {
+    code: "GOV" /* GOVERNANCE */,
+    name: "Governance",
+    description: "Policy enforcement, decision arbitration, and oversight agents",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "GOV-POL", name: "Policy Enforcement", description: "Enforces organizational policies" },
+      { code: "GOV-ARB", name: "Decision Arbitration", description: "Arbitrates between competing decisions" },
+      { code: "GOV-ESC", name: "Escalation Management", description: "Manages escalation workflows" },
+      { code: "GOV-AUT", name: "Authority Delegation", description: "Delegates authority to sub-agents" }
+    ]
+  },
+  {
+    code: "RSN" /* REASONING */,
+    name: "Reasoning",
+    description: "Logical analysis, planning, and inference agents",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "reliability"],
+    subcategories: [
+      { code: "RSN-LOG", name: "Logical Inference", description: "Deductive and inductive reasoning" },
+      { code: "RSN-PLN", name: "Planning", description: "Multi-step plan generation and optimization" },
+      { code: "RSN-ANL", name: "Analysis", description: "Data analysis and pattern recognition" },
+      { code: "RSN-DEC", name: "Decision Support", description: "Structured decision-making support" }
+    ]
+  },
+  {
+    code: "TUL" /* TOOL_USE */,
+    name: "Tool Use",
+    description: "API invocation, code execution, and external system interaction",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "compliance", "context"],
+    subcategories: [
+      { code: "TUL-API", name: "API Integration", description: "Calls external APIs" },
+      { code: "TUL-COD", name: "Code Execution", description: "Executes code in sandbox or runtime" },
+      { code: "TUL-FIL", name: "File Operations", description: "Reads, writes, and manages files" },
+      { code: "TUL-DB", name: "Database Operations", description: "Queries and modifies databases" }
+    ]
+  },
+  {
+    code: "MEM" /* MEMORY */,
+    name: "Memory",
+    description: "Context retention, knowledge management, and recall agents",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["identity", "context", "reliability"],
+    subcategories: [
+      { code: "MEM-STM", name: "Short-Term Memory", description: "Session and conversation context" },
+      { code: "MEM-LTM", name: "Long-Term Memory", description: "Persistent knowledge storage" },
+      { code: "MEM-RET", name: "Retrieval", description: "Knowledge retrieval and RAG" },
+      { code: "MEM-SUM", name: "Summarization", description: "Context compression and summarization" }
+    ]
+  },
+  // ---- Multi-Agent & Swarm ----
+  {
+    code: "MAG" /* MULTI_AGENT */,
+    name: "Multi-Agent",
+    description: "Inter-agent coordination, messaging, and collaboration",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "identity", "reliability"],
+    subcategories: [
+      { code: "MAG-COM", name: "Communication", description: "Inter-agent message passing" },
+      { code: "MAG-DEL", name: "Delegation", description: "Task delegation between agents" },
+      { code: "MAG-CRD", name: "Coordination", description: "Multi-agent workflow coordination" },
+      { code: "MAG-NEG", name: "Negotiation", description: "Inter-agent negotiation and consensus" }
+    ]
+  },
+  {
+    code: "SWM" /* SWARM */,
+    name: "Swarm",
+    description: "Large-scale agent coordination, topology management, and contagion control",
+    minTier: 6 /* T6_CERTIFIED */,
+    euHighRisk: true,
+    trustDimensions: ["behavioral", "compliance", "reliability", "transparency"],
+    subcategories: [
+      { code: "SWM-TOP", name: "Topology Management", description: "Agent network topology and routing" },
+      { code: "SWM-CON", name: "Contagion Control", description: "Failure spread rate monitoring and containment" },
+      { code: "SWM-SEG", name: "Segment Isolation", description: "Network segment isolation and quarantine" },
+      { code: "SWM-HLT", name: "Health Monitoring", description: "Swarm-wide health and status tracking" }
+    ]
+  },
+  // ---- Safety & Audit ----
+  {
+    code: "SAF" /* SAFETY */,
+    name: "Safety",
+    description: "Content filtering, harm prevention, and safety enforcement",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "reliability", "transparency"],
+    subcategories: [
+      { code: "SAF-FLT", name: "Content Filtering", description: "Input/output content safety filtering" },
+      { code: "SAF-INJ", name: "Injection Detection", description: "Prompt injection and adversarial input detection" },
+      { code: "SAF-BND", name: "Boundary Enforcement", description: "Operational boundary and scope enforcement" },
+      { code: "SAF-KIL", name: "Kill Switch", description: "Emergency halt and containment" }
+    ]
+  },
+  {
+    code: "AUD" /* AUDIT */,
+    name: "Audit",
+    description: "Decision logging, proof chains, and transparency agents",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "transparency", "identity"],
+    subcategories: [
+      { code: "AUD-LOG", name: "Decision Logging", description: "Records all decisions and rationale" },
+      { code: "AUD-PRF", name: "Proof Generation", description: "Generates cryptographic decision proofs" },
+      { code: "AUD-TRC", name: "Traceability", description: "Decision provenance and traceability" },
+      { code: "AUD-RPT", name: "Reporting", description: "Audit report generation and compliance summaries" }
+    ]
+  },
+  {
+    code: "CMP" /* COMPLIANCE */,
+    name: "Compliance",
+    description: "Regulatory compliance monitoring and enforcement",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "CMP-REG", name: "Regulatory Monitoring", description: "Monitors regulatory requirements" },
+      { code: "CMP-DPR", name: "Data Protection", description: "GDPR, CCPA, and data privacy compliance" },
+      { code: "CMP-STD", name: "Standards Compliance", description: "ISO, NIST, and industry standard compliance" },
+      { code: "CMP-RPT", name: "Compliance Reporting", description: "Generates compliance reports and attestations" }
+    ]
+  },
+  // ---- Domain-Specific (EU AI Act High-Risk) ----
+  {
+    code: "FIN" /* FINANCE */,
+    name: "Finance",
+    description: "Financial analysis, trading, risk assessment, and compliance",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "reliability", "transparency", "behavioral"],
+    subcategories: [
+      { code: "FIN-TRD", name: "Trading", description: "Automated trading and portfolio management" },
+      { code: "FIN-RSK", name: "Risk Assessment", description: "Financial risk analysis and scoring" },
+      { code: "FIN-AML", name: "Anti-Money Laundering", description: "AML/KYC compliance and monitoring" },
+      { code: "FIN-ADV", name: "Advisory", description: "Financial advice and recommendations" }
+    ]
+  },
+  {
+    code: "HLT" /* HEALTHCARE */,
+    name: "Healthcare",
+    description: "Medical analysis, diagnostics support, and health data processing",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "reliability", "identity", "transparency"],
+    subcategories: [
+      { code: "HLT-DGN", name: "Diagnostics Support", description: "Assists with medical diagnosis" },
+      { code: "HLT-DAT", name: "Health Data Processing", description: "Processes PHI/ePHI data" },
+      { code: "HLT-RES", name: "Medical Research", description: "Clinical research and trial analysis" },
+      { code: "HLT-MON", name: "Patient Monitoring", description: "Continuous patient health monitoring" }
+    ]
+  },
+  {
+    code: "EMP" /* EMPLOYMENT */,
+    name: "Employment",
+    description: "Hiring, HR decisions, performance evaluation, and workforce management",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "transparency", "behavioral", "identity"],
+    subcategories: [
+      { code: "EMP-HIR", name: "Hiring", description: "Resume screening and candidate evaluation" },
+      { code: "EMP-EVL", name: "Performance Evaluation", description: "Employee performance assessment" },
+      { code: "EMP-WFM", name: "Workforce Management", description: "Scheduling, allocation, and planning" },
+      { code: "EMP-TRN", name: "Training", description: "Employee training and development" }
+    ]
+  },
+  // ---- Creative & Research ----
+  {
+    code: "CRE" /* CREATIVE */,
+    name: "Creative",
+    description: "Content generation, design, and creative production",
+    minTier: 1 /* T1_OBSERVED */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "context"],
+    subcategories: [
+      { code: "CRE-TXT", name: "Text Generation", description: "Copywriting, articles, and text content" },
+      { code: "CRE-IMG", name: "Image Generation", description: "Visual content creation and editing" },
+      { code: "CRE-AUD", name: "Audio Generation", description: "Music, voice, and audio content" },
+      { code: "CRE-VID", name: "Video Generation", description: "Video content creation and editing" }
+    ]
+  },
+  {
+    code: "RES" /* RESEARCH */,
+    name: "Research",
+    description: "Information gathering, literature review, and experimental analysis",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "reliability", "context"],
+    subcategories: [
+      { code: "RES-LIT", name: "Literature Review", description: "Academic and technical literature analysis" },
+      { code: "RES-DAT", name: "Data Collection", description: "Structured data gathering and curation" },
+      { code: "RES-EXP", name: "Experimentation", description: "Experimental design and execution" },
+      { code: "RES-SYN", name: "Synthesis", description: "Research synthesis and meta-analysis" }
+    ]
+  },
+  // ---- Advanced Capabilities ----
+  {
+    code: "SLF" /* SELF_IMPROVEMENT */,
+    name: "Self-Improvement",
+    description: "Self-modification, learning optimization, and capability enhancement",
+    minTier: 7 /* T7_AUTONOMOUS */,
+    euHighRisk: true,
+    trustDimensions: ["behavioral", "compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "SLF-LRN", name: "Self-Learning", description: "Autonomous learning and adaptation" },
+      { code: "SLF-OPT", name: "Self-Optimization", description: "Performance self-optimization" },
+      { code: "SLF-MOD", name: "Self-Modification", description: "Configuration and behavior self-modification" }
+    ]
+  },
+  {
+    code: "HIF" /* HUMAN_INTERFACE */,
+    name: "Human Interface",
+    description: "Human interaction, communication, and user experience",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "context", "identity"],
+    subcategories: [
+      { code: "HIF-CHT", name: "Chat", description: "Conversational user interface" },
+      { code: "HIF-AST", name: "Assistant", description: "Task-oriented personal assistant" },
+      { code: "HIF-TUT", name: "Tutorial", description: "Interactive teaching and guidance" },
+      { code: "HIF-ACC", name: "Accessibility", description: "Accessibility and accommodation support" }
+    ]
+  },
+  {
+    code: "SYS" /* SYSTEM */,
+    name: "System",
+    description: "Infrastructure management, deployment, and system operations",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "reliability", "identity"],
+    subcategories: [
+      { code: "SYS-DEP", name: "Deployment", description: "Application deployment and release management" },
+      { code: "SYS-MON", name: "Monitoring", description: "System monitoring and alerting" },
+      { code: "SYS-SEC", name: "Security", description: "Security scanning and incident response" },
+      { code: "SYS-INF", name: "Infrastructure", description: "Infrastructure provisioning and management" }
+    ]
+  }
+];
+function getCARCategory(code) {
+  return CAR_CATEGORIES.find((cat) => cat.code === code);
+}
+function getCARCategoriesForTier(tier) {
+  return CAR_CATEGORIES.filter((cat) => cat.minTier <= tier);
+}
+function getHighRiskCategories() {
+  return CAR_CATEGORIES.filter((cat) => cat.euHighRisk);
+}
+function isCARCategoryAvailable(code, tier) {
+  const cat = getCARCategory(code);
+  return cat !== void 0 && cat.minTier <= tier;
+}
+function getCARCategoryMinTier(code) {
+  return getCARCategory(code)?.minTier;
+}
+function getCARSubcategory(fullCode) {
+  for (const cat of CAR_CATEGORIES) {
+    const sub = cat.subcategories.find((s) => s.code === fullCode);
+    if (sub) return sub;
+  }
+  return void 0;
+}
+function getParentCategory(subcategoryCode) {
+  for (const cat of CAR_CATEGORIES) {
+    if (cat.subcategories.some((s) => s.code === subcategoryCode)) {
+      return cat;
+    }
+  }
+  return void 0;
+}
+function getAllCARCategoryCodes() {
+  return CAR_CATEGORIES.map((cat) => cat.code);
+}
+function getAllCARSubcategoryCodes() {
+  return CAR_CATEGORIES.flatMap(
+    (cat) => cat.subcategories.map((sub) => sub.code)
+  );
+}
+function isValidCARCategory(code) {
+  return CAR_CATEGORIES.some((cat) => cat.code === code);
+}
+function isValidCARSubcategory(code) {
+  return getCARSubcategory(code) !== void 0;
+}
+
 // src/index.ts
-var VERSION = "1.0.1";
+var VERSION = "1.0.2";
 var LAST_UPDATED = "2026-02-16";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -1682,6 +2008,8 @@ var LAST_UPDATED = "2026-02-16";
   BASIS_SPEC_VERSION,
   BASIS_VERSIONS,
   CAPABILITIES,
+  CARCategory,
+  CAR_CATEGORIES,
   CAR_SPEC_CURRENT_VERSION,
   CAR_SPEC_VERSIONS,
   COGNIGATE_CURRENT_VERSION,
@@ -1723,8 +2051,14 @@ var LAST_UPDATED = "2026-02-16";
   formatErrorMessage,
   formatRateLimit,
   getActiveTheme,
+  getAllCARCategoryCodes,
+  getAllCARSubcategoryCodes,
   getAllCapabilityCodes,
   getAllThemeIds,
+  getCARCategoriesForTier,
+  getCARCategory,
+  getCARCategoryMinTier,
+  getCARSubcategory,
   getCapabilitiesByCategory,
   getCapabilitiesForTier,
   getCapability,
@@ -1732,7 +2066,9 @@ var LAST_UPDATED = "2026-02-16";
   getCurrentVersion,
   getErrorByCode,
   getErrorsByCategory,
+  getHighRiskCategories,
   getMinTierForLimits,
+  getParentCategory,
   getProduct,
   getProductsByCategory,
   getProductsByOrganization,
@@ -1748,8 +2084,11 @@ var LAST_UPDATED = "2026-02-16";
   getTierName,
   getTierThreshold,
   getVersionDefinition,
+  isCARCategoryAvailable,
   isCapabilityAvailable,
   isUnlimited,
+  isValidCARCategory,
+  isValidCARSubcategory,
   isVersionDeprecated,
   isVersionSupported,
   meetsTierRequirement,

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-export { ALL_TIERS, TIER_THRESHOLDS, TierThreshold, TrustTier, TrustTierCode, TrustTierName, getTierCode, getTierColor, getTierMaxScore, getTierMinScore, getTierName, getTierThreshold, meetsTierRequirement, parseTier, scoreToTier } from './tiers.cjs';
+import { TrustTier } from './tiers.cjs';
+export { ALL_TIERS, TIER_THRESHOLDS, TierThreshold, TrustTierCode, TrustTierName, getTierCode, getTierColor, getTierMaxScore, getTierMinScore, getTierName, getTierThreshold, meetsTierRequirement, parseTier, scoreToTier } from './tiers.cjs';
 export { AGENTANCHOR_DOMAINS, AGENTANCHOR_EMAILS, ALL_DOMAINS, API_ENDPOINTS, AgentAnchorDomain, COGNIGATE_DOMAINS, CognigateDomain, DOMAIN_ALIASES, GITHUB, NPM_PACKAGES, VORION_DOMAINS, VORION_EMAILS, VorionDomain } from './domains.cjs';
 export { CAPABILITIES, CapabilityCategory, CapabilityDefinition, getAllCapabilityCodes, getCapabilitiesByCategory, getCapabilitiesForTier, getCapability, getCapabilityMinTier, isCapabilityAvailable } from './capabilities.cjs';
 export { AGENTANCHOR_PRODUCTS, ALL_PRODUCTS, ProductCategory, ProductDefinition, ProductStatus, VORION_PRODUCTS, getProduct, getProductsByCategory, getProductsByOrganization, getProductsByStatus } from './products.cjs';
@@ -7,6 +8,120 @@ export { AUTH_ERRORS, ERROR_CODES, EXTERNAL_ERRORS, ErrorCategory, ErrorCode, Er
 export { API_VERSIONS, ApiVersionDefinition, BASIS_CURRENT_VERSION, BASIS_SPEC_VERSION, BASIS_VERSIONS, CAR_SPEC_CURRENT_VERSION, CAR_SPEC_VERSIONS, COGNIGATE_CURRENT_VERSION, COGNIGATE_DEFAULT_VERSION, COGNIGATE_VERSIONS, LOGIC_API_VERSIONS, LOGIC_CURRENT_VERSION, TRUST_API_VERSIONS, TRUST_CURRENT_VERSION, VERSION_HEADERS, VersionStatus, buildApiUrl, getCurrentVersion, getStableVersions, getVersionDefinition, isVersionDeprecated, isVersionSupported } from './api-versions.cjs';
 export { ACTIVE_THEME, THEMES, ThemeId, ThemeTokens, getActiveTheme, getAllThemeIds, themeToCssVars } from './themes.cjs';
 
+/**
+ * @vorionsys/shared-constants - CAR Identity Category Taxonomy v2.0
+ *
+ * Hierarchical controlled vocabulary for agent classification.
+ * Used across all Vorion ecosystem products for consistent agent categorization.
+ *
+ * Categories define:
+ * - Minimum trust tier required for the category
+ * - EU AI Act high-risk classification
+ * - Subcategories for fine-grained classification
+ * - Trust dimensions most relevant to the category
+ *
+ * @see https://basis.vorion.org/car/categories
+ */
+
+/**
+ * Top-level category codes for agent classification
+ */
+declare enum CARCategory {
+    GOVERNANCE = "GOV",
+    REASONING = "RSN",
+    TOOL_USE = "TUL",
+    MEMORY = "MEM",
+    MULTI_AGENT = "MAG",
+    SAFETY = "SAF",
+    AUDIT = "AUD",
+    COMPLIANCE = "CMP",
+    FINANCE = "FIN",
+    HEALTHCARE = "HLT",
+    EMPLOYMENT = "EMP",
+    CREATIVE = "CRE",
+    RESEARCH = "RES",
+    SWARM = "SWM",
+    SELF_IMPROVEMENT = "SLF",
+    HUMAN_INTERFACE = "HIF",
+    SYSTEM = "SYS"
+}
+/**
+ * Trust dimensions relevant to category classification
+ */
+type TrustDimension = 'behavioral' | 'compliance' | 'identity' | 'context' | 'reliability' | 'transparency';
+/**
+ * Subcategory within a top-level category
+ */
+interface CARSubcategory {
+    readonly code: string;
+    readonly name: string;
+    readonly description: string;
+}
+/**
+ * Full category definition with metadata
+ */
+interface CARCategoryDefinition {
+    readonly code: CARCategory;
+    readonly name: string;
+    readonly description: string;
+    /** Minimum trust tier required to operate in this category */
+    readonly minTier: TrustTier;
+    /** Whether this category is high-risk under EU AI Act */
+    readonly euHighRisk: boolean;
+    /** Trust dimensions most relevant to this category */
+    readonly trustDimensions: readonly TrustDimension[];
+    /** Subcategories for fine-grained classification */
+    readonly subcategories: readonly CARSubcategory[];
+}
+/**
+ * Complete CAR category taxonomy
+ */
+declare const CAR_CATEGORIES: readonly CARCategoryDefinition[];
+/**
+ * Get a category by code
+ */
+declare function getCARCategory(code: CARCategory | string): CARCategoryDefinition | undefined;
+/**
+ * Get all categories available at a specific trust tier
+ */
+declare function getCARCategoriesForTier(tier: TrustTier): CARCategoryDefinition[];
+/**
+ * Get all EU AI Act high-risk categories
+ */
+declare function getHighRiskCategories(): CARCategoryDefinition[];
+/**
+ * Check if a category is available at a given trust tier
+ */
+declare function isCARCategoryAvailable(code: CARCategory | string, tier: TrustTier): boolean;
+/**
+ * Get the minimum tier required for a category
+ */
+declare function getCARCategoryMinTier(code: CARCategory | string): TrustTier | undefined;
+/**
+ * Get a subcategory by its full code (e.g., "GOV-POL")
+ */
+declare function getCARSubcategory(fullCode: string): CARSubcategory | undefined;
+/**
+ * Get the parent category for a subcategory code
+ */
+declare function getParentCategory(subcategoryCode: string): CARCategoryDefinition | undefined;
+/**
+ * Get all category codes
+ */
+declare function getAllCARCategoryCodes(): CARCategory[];
+/**
+ * Get all subcategory codes
+ */
+declare function getAllCARSubcategoryCodes(): string[];
+/**
+ * Validate that a category code is valid
+ */
+declare function isValidCARCategory(code: string): code is CARCategory;
+/**
+ * Validate that a subcategory code is valid
+ */
+declare function isValidCARSubcategory(code: string): boolean;
+
 /**
  * @vorionsys/shared-constants
  *
@@ -47,8 +162,8 @@ export { ACTIVE_THEME, THEMES, ThemeId, ThemeTokens, getActiveTheme, getAllTheme
  */
 
 /** Package version */
-declare const VERSION = "1.0.1";
+declare const VERSION = "1.0.2";
 /** Last updated date */
 declare const LAST_UPDATED = "2026-02-16";
 
-export { LAST_UPDATED, VERSION };
+export { CARCategory, type CARCategoryDefinition, type CARSubcategory, CAR_CATEGORIES, LAST_UPDATED, type TrustDimension, TrustTier, VERSION, getAllCARCategoryCodes, getAllCARSubcategoryCodes, getCARCategoriesForTier, getCARCategory, getCARCategoryMinTier, getCARSubcategory, getHighRiskCategories, getParentCategory, isCARCategoryAvailable, isValidCARCategory, isValidCARSubcategory };