@vorionsys/shared-constants 1.0.1 → 1.0.3

package/dist/chunk-PHL3CB53.js

@@ -1,159 +0,0 @@
-// src/tiers.ts
-var TrustTier = /* @__PURE__ */ ((TrustTier2) => {
-  TrustTier2[TrustTier2["T0_SANDBOX"] = 0] = "T0_SANDBOX";
-  TrustTier2[TrustTier2["T1_OBSERVED"] = 1] = "T1_OBSERVED";
-  TrustTier2[TrustTier2["T2_PROVISIONAL"] = 2] = "T2_PROVISIONAL";
-  TrustTier2[TrustTier2["T3_MONITORED"] = 3] = "T3_MONITORED";
-  TrustTier2[TrustTier2["T4_STANDARD"] = 4] = "T4_STANDARD";
-  TrustTier2[TrustTier2["T5_TRUSTED"] = 5] = "T5_TRUSTED";
-  TrustTier2[TrustTier2["T6_CERTIFIED"] = 6] = "T6_CERTIFIED";
-  TrustTier2[TrustTier2["T7_AUTONOMOUS"] = 7] = "T7_AUTONOMOUS";
-  return TrustTier2;
-})(TrustTier || {});
-var TIER_THRESHOLDS = {
-  [0 /* T0_SANDBOX */]: {
-    min: 0,
-    max: 199,
-    name: "Sandbox",
-    description: "Isolated, no external access, observation only",
-    color: "#78716c",
-    textColor: "#ffffff"
-  },
-  [1 /* T1_OBSERVED */]: {
-    min: 200,
-    max: 349,
-    name: "Observed",
-    description: "Read-only, sandboxed execution, monitored",
-    color: "#ef4444",
-    textColor: "#ffffff"
-  },
-  [2 /* T2_PROVISIONAL */]: {
-    min: 350,
-    max: 500,
-    name: "Provisional",
-    description: "Basic operations, heavy supervision",
-    color: "#f97316",
-    textColor: "#ffffff"
-  },
-  [3 /* T3_MONITORED */]: {
-    min: 501,
-    max: 649,
-    name: "Monitored",
-    description: "Standard operations with continuous monitoring",
-    color: "#eab308",
-    textColor: "#000000"
-  },
-  [4 /* T4_STANDARD */]: {
-    min: 650,
-    max: 799,
-    name: "Standard",
-    description: "External API access, policy-governed",
-    color: "#22c55e",
-    textColor: "#ffffff"
-  },
-  [5 /* T5_TRUSTED */]: {
-    min: 800,
-    max: 875,
-    name: "Trusted",
-    description: "Cross-agent communication, delegated tasks",
-    color: "#3b82f6",
-    textColor: "#ffffff"
-  },
-  [6 /* T6_CERTIFIED */]: {
-    min: 876,
-    max: 950,
-    name: "Certified",
-    description: "Admin tasks, agent spawning, minimal oversight",
-    color: "#8b5cf6",
-    textColor: "#ffffff"
-  },
-  [7 /* T7_AUTONOMOUS */]: {
-    min: 951,
-    max: 1e3,
-    name: "Autonomous",
-    description: "Full autonomy, self-governance, strategic only",
-    color: "#06b6d4",
-    textColor: "#ffffff"
-  }
-};
-function scoreToTier(score) {
-  if (score < 0 || score > 1e3) {
-    throw new Error(`Trust score must be between 0 and 1000, got ${score}`);
-  }
-  if (score >= 951) return 7 /* T7_AUTONOMOUS */;
-  if (score >= 876) return 6 /* T6_CERTIFIED */;
-  if (score >= 800) return 5 /* T5_TRUSTED */;
-  if (score >= 650) return 4 /* T4_STANDARD */;
-  if (score >= 501) return 3 /* T3_MONITORED */;
-  if (score >= 350) return 2 /* T2_PROVISIONAL */;
-  if (score >= 200) return 1 /* T1_OBSERVED */;
-  return 0 /* T0_SANDBOX */;
-}
-function getTierThreshold(tier) {
-  return TIER_THRESHOLDS[tier];
-}
-function getTierName(tier) {
-  return TIER_THRESHOLDS[tier].name;
-}
-function getTierColor(tier) {
-  return TIER_THRESHOLDS[tier].color;
-}
-function getTierMinScore(tier) {
-  return TIER_THRESHOLDS[tier].min;
-}
-function getTierMaxScore(tier) {
-  return TIER_THRESHOLDS[tier].max;
-}
-function meetsTierRequirement(score, minTier) {
-  const actualTier = scoreToTier(score);
-  return actualTier >= minTier;
-}
-function getTierCode(tier) {
-  return `T${tier}`;
-}
-function parseTier(input) {
-  const normalized = input.toUpperCase().trim();
-  const tMatch = normalized.match(/^T?(\d)$/);
-  if (tMatch) {
-    const num = parseInt(tMatch[1], 10);
-    if (num >= 0 && num <= 7) {
-      return num;
-    }
-  }
-  const nameMap = {
-    SANDBOX: 0 /* T0_SANDBOX */,
-    OBSERVED: 1 /* T1_OBSERVED */,
-    PROVISIONAL: 2 /* T2_PROVISIONAL */,
-    MONITORED: 3 /* T3_MONITORED */,
-    STANDARD: 4 /* T4_STANDARD */,
-    TRUSTED: 5 /* T5_TRUSTED */,
-    CERTIFIED: 6 /* T6_CERTIFIED */,
-    AUTONOMOUS: 7 /* T7_AUTONOMOUS */
-  };
-  return nameMap[normalized] ?? null;
-}
-var ALL_TIERS = [
-  0 /* T0_SANDBOX */,
-  1 /* T1_OBSERVED */,
-  2 /* T2_PROVISIONAL */,
-  3 /* T3_MONITORED */,
-  4 /* T4_STANDARD */,
-  5 /* T5_TRUSTED */,
-  6 /* T6_CERTIFIED */,
-  7 /* T7_AUTONOMOUS */
-];
-
-export {
-  TrustTier,
-  TIER_THRESHOLDS,
-  scoreToTier,
-  getTierThreshold,
-  getTierName,
-  getTierColor,
-  getTierMinScore,
-  getTierMaxScore,
-  meetsTierRequirement,
-  getTierCode,
-  parseTier,
-  ALL_TIERS
-};

package/src/api-versions.ts

@@ -1,250 +0,0 @@
-/**
- * @vorionsys/shared-constants - API Versions
- *
- * Centralized API version management across all services
- * Ensures consistent versioning strategy
- *
- * @see https://cognigate.dev/docs/versioning
- */
-
-// =============================================================================
-// VERSION STATUS
-// =============================================================================
-
-export enum VersionStatus {
-  /** Currently in development, not available */
-  DEVELOPMENT = 'development',
-
-  /** Available as preview/beta */
-  PREVIEW = 'preview',
-
-  /** Stable and recommended */
-  STABLE = 'stable',
-
-  /** Still supported but deprecated */
-  DEPRECATED = 'deprecated',
-
-  /** No longer supported */
-  RETIRED = 'retired',
-}
-
-// =============================================================================
-// API VERSION DEFINITIONS
-// =============================================================================
-
-export interface ApiVersionDefinition {
-  /** Version identifier (e.g., "v1") */
-  version: string;
-
-  /** Full version number (e.g., "1.0.0") */
-  fullVersion: string;
-
-  /** Release date */
-  releaseDate: string;
-
-  /** End of support date (if deprecated/retired) */
-  endOfLife?: string;
-
-  /** Current status */
-  status: VersionStatus;
-
-  /** Changelog URL */
-  changelogUrl?: string;
-
-  /** Migration guide URL (if deprecated) */
-  migrationUrl?: string;
-}
-
-// =============================================================================
-// COGNIGATE API VERSIONS
-// =============================================================================
-
-export const COGNIGATE_VERSIONS: Record<string, ApiVersionDefinition> = {
-  v1: {
-    version: 'v1',
-    fullVersion: '1.0.0',
-    releaseDate: '2026-02-01',
-    status: VersionStatus.STABLE,
-    changelogUrl: 'https://cognigate.dev/changelog/v1',
-  },
-} as const;
-
-export const COGNIGATE_CURRENT_VERSION = 'v1';
-export const COGNIGATE_DEFAULT_VERSION = 'v1';
-
-// =============================================================================
-// AGENT ANCHOR TRUST API VERSIONS
-// =============================================================================
-
-export const TRUST_API_VERSIONS: Record<string, ApiVersionDefinition> = {
-  v1: {
-    version: 'v1',
-    fullVersion: '1.0.0',
-    releaseDate: '2026-02-01',
-    status: VersionStatus.STABLE,
-    changelogUrl: 'https://trust.agentanchorai.com/changelog/v1',
-  },
-} as const;
-
-export const TRUST_CURRENT_VERSION = 'v1';
-
-// =============================================================================
-// AGENT ANCHOR LOGIC API VERSIONS
-// =============================================================================
-
-export const LOGIC_API_VERSIONS: Record<string, ApiVersionDefinition> = {
-  v1: {
-    version: 'v1',
-    fullVersion: '1.0.0',
-    releaseDate: '2026-02-01',
-    status: VersionStatus.PREVIEW,
-    changelogUrl: 'https://logic.agentanchorai.com/changelog/v1',
-  },
-} as const;
-
-export const LOGIC_CURRENT_VERSION = 'v1';
-
-// =============================================================================
-// BASIS SPEC VERSIONS
-// =============================================================================
-
-export const BASIS_VERSIONS: Record<string, ApiVersionDefinition> = {
-  v1: {
-    version: 'v1',
-    fullVersion: '1.0.0',
-    releaseDate: '2026-02-01',
-    status: VersionStatus.STABLE,
-    changelogUrl: 'https://basis.vorion.org/changelog',
-  },
-} as const;
-
-export const BASIS_CURRENT_VERSION = 'v1';
-export const BASIS_SPEC_VERSION = '1.0.0';
-
-// =============================================================================
-// CAR SPEC VERSIONS
-// =============================================================================
-
-export const CAR_SPEC_VERSIONS: Record<string, ApiVersionDefinition> = {
-  v1: {
-    version: 'v1',
-    fullVersion: '1.0.0',
-    releaseDate: '2026-02-01',
-    status: VersionStatus.STABLE,
-    changelogUrl: 'https://carid.vorion.org/changelog',
-  },
-} as const;
-
-export const CAR_SPEC_CURRENT_VERSION = 'v1';
-
-// =============================================================================
-// ALL API VERSIONS
-// =============================================================================
-
-export const API_VERSIONS = {
-  cognigate: COGNIGATE_VERSIONS,
-  trust: TRUST_API_VERSIONS,
-  logic: LOGIC_API_VERSIONS,
-  basis: BASIS_VERSIONS,
-  carSpec: CAR_SPEC_VERSIONS,
-} as const;
-
-// =============================================================================
-// HELPER FUNCTIONS
-// =============================================================================
-
-/**
- * Get the current stable version for a service
- */
-export function getCurrentVersion(
-  service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec',
-): string {
-  switch (service) {
-    case 'cognigate':
-      return COGNIGATE_CURRENT_VERSION;
-    case 'trust':
-      return TRUST_CURRENT_VERSION;
-    case 'logic':
-      return LOGIC_CURRENT_VERSION;
-    case 'basis':
-      return BASIS_CURRENT_VERSION;
-    case 'carSpec':
-      return CAR_SPEC_CURRENT_VERSION;
-  }
-}
-
-/**
- * Get version definition
- */
-export function getVersionDefinition(
-  service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec',
-  version: string,
-): ApiVersionDefinition | undefined {
-  return API_VERSIONS[service][version];
-}
-
-/**
- * Check if a version is still supported
- */
-export function isVersionSupported(
-  service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec',
-  version: string,
-): boolean {
-  const def = getVersionDefinition(service, version);
-  if (!def) return false;
-  return def.status !== VersionStatus.RETIRED;
-}
-
-/**
- * Check if a version is deprecated
- */
-export function isVersionDeprecated(
-  service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec',
-  version: string,
-): boolean {
-  const def = getVersionDefinition(service, version);
-  if (!def) return false;
-  return def.status === VersionStatus.DEPRECATED;
-}
-
-/**
- * Get all stable versions for a service
- */
-export function getStableVersions(
-  service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec',
-): ApiVersionDefinition[] {
-  return Object.values(API_VERSIONS[service]).filter(
-    v => v.status === VersionStatus.STABLE,
-  );
-}
-
-/**
- * Build versioned API URL
- */
-export function buildApiUrl(
-  baseUrl: string,
-  version: string,
-  path: string,
-): string {
-  const cleanBase = baseUrl.replace(/\/$/, '');
-  const cleanPath = path.replace(/^\//, '');
-  return `${cleanBase}/${version}/${cleanPath}`;
-}
-
-// =============================================================================
-// HTTP HEADERS
-// =============================================================================
-
-export const VERSION_HEADERS = {
-  /** Header to request specific API version */
-  REQUEST_VERSION: 'X-API-Version',
-
-  /** Header indicating actual API version used */
-  RESPONSE_VERSION: 'X-API-Version',
-
-  /** Header warning about deprecation */
-  DEPRECATION_WARNING: 'X-Deprecation-Warning',
-
-  /** Header with sunset date */
-  SUNSET: 'Sunset',
-} as const;

package/src/capabilities.ts

@@ -1,272 +0,0 @@
-/**
- * @vorionsys/shared-constants - Capability Definitions
- *
- * Single source of truth for capability codes and tier requirements
- * Used across all Vorion ecosystem products
- *
- * @see https://basis.vorion.org/capabilities
- */
-
-import { TrustTier } from './tiers';
-
-// =============================================================================
-// CAPABILITY CATEGORIES
-// =============================================================================
-
-export enum CapabilityCategory {
-  DATA_ACCESS = 'data_access',
-  API_ACCESS = 'api_access',
-  CODE_EXECUTION = 'code_execution',
-  AGENT_INTERACTION = 'agent_interaction',
-  RESOURCE_MANAGEMENT = 'resource_management',
-  GOVERNANCE = 'governance',
-  ADMIN = 'admin',
-}
-
-// =============================================================================
-// CAPABILITY DEFINITION
-// =============================================================================
-
-export interface CapabilityDefinition {
-  readonly code: string;
-  readonly name: string;
-  readonly category: CapabilityCategory;
-  readonly description: string;
-  readonly unlockTier: TrustTier;
-  readonly constraints?: readonly string[];
-}
-
-// =============================================================================
-// STANDARD CAPABILITIES
-// =============================================================================
-
-export const CAPABILITIES: readonly CapabilityDefinition[] = [
-  // T0 - Sandbox
-  {
-    code: 'CAP-READ-PUBLIC',
-    name: 'Read Public Data',
-    category: CapabilityCategory.DATA_ACCESS,
-    description: 'Access publicly available data',
-    unlockTier: TrustTier.T0_SANDBOX,
-  },
-  {
-    code: 'CAP-GENERATE-TEXT',
-    name: 'Generate Text',
-    category: CapabilityCategory.CODE_EXECUTION,
-    description: 'Generate text responses',
-    unlockTier: TrustTier.T0_SANDBOX,
-  },
-
-  // T1 - Observed
-  {
-    code: 'CAP-READ-INTERNAL',
-    name: 'Read Internal Data',
-    category: CapabilityCategory.DATA_ACCESS,
-    description: 'Access internal data within allowed scopes',
-    unlockTier: TrustTier.T1_OBSERVED,
-    constraints: ['Read-only', 'Logged'],
-  },
-  {
-    code: 'CAP-INTERNAL-API',
-    name: 'Internal API Access',
-    category: CapabilityCategory.API_ACCESS,
-    description: 'Make read-only internal API calls',
-    unlockTier: TrustTier.T1_OBSERVED,
-    constraints: ['GET only', 'Rate limited'],
-  },
-
-  // T2 - Provisional
-  {
-    code: 'CAP-FILE-WRITE',
-    name: 'Write Files',
-    category: CapabilityCategory.DATA_ACCESS,
-    description: 'Write to approved directories',
-    unlockTier: TrustTier.T2_PROVISIONAL,
-    constraints: ['Approved dirs only', 'Size limited'],
-  },
-  {
-    code: 'CAP-DB-READ',
-    name: 'Database Read',
-    category: CapabilityCategory.DATA_ACCESS,
-    description: 'Read from approved database tables',
-    unlockTier: TrustTier.T2_PROVISIONAL,
-    constraints: ['Approved tables', 'Query timeout'],
-  },
-  {
-    code: 'CAP-EXTERNAL-API-READ',
-    name: 'External API Read',
-    category: CapabilityCategory.API_ACCESS,
-    description: 'Make GET requests to approved external APIs',
-    unlockTier: TrustTier.T2_PROVISIONAL,
-    constraints: ['GET only', 'Approved endpoints'],
-  },
-
-  // T3 - Monitored
-  {
-    code: 'CAP-DB-WRITE',
-    name: 'Database Write',
-    category: CapabilityCategory.DATA_ACCESS,
-    description: 'Write to approved database tables',
-    unlockTier: TrustTier.T3_MONITORED,
-    constraints: ['Approved tables', 'Transaction limits'],
-  },
-  {
-    code: 'CAP-EXTERNAL-API-FULL',
-    name: 'External API Full Access',
-    category: CapabilityCategory.API_ACCESS,
-    description: 'Full REST operations on approved external APIs',
-    unlockTier: TrustTier.T3_MONITORED,
-    constraints: ['Approved endpoints', 'Rate limited'],
-  },
-  {
-    code: 'CAP-CODE-SANDBOX',
-    name: 'Sandboxed Code Execution',
-    category: CapabilityCategory.CODE_EXECUTION,
-    description: 'Execute code in isolated sandbox',
-    unlockTier: TrustTier.T3_MONITORED,
-    constraints: ['Sandboxed', 'Time limited', 'No network'],
-  },
-
-  // T4 - Standard
-  {
-    code: 'CAP-AGENT-COMMUNICATE',
-    name: 'Agent Communication',
-    category: CapabilityCategory.AGENT_INTERACTION,
-    description: 'Send and receive messages to/from other agents',
-    unlockTier: TrustTier.T4_STANDARD,
-    constraints: ['Approved agents', 'Message limits'],
-  },
-  {
-    code: 'CAP-WORKFLOW-MULTI',
-    name: 'Multi-Step Workflow',
-    category: CapabilityCategory.CODE_EXECUTION,
-    description: 'Orchestrate multi-step workflows',
-    unlockTier: TrustTier.T4_STANDARD,
-    constraints: ['Approved patterns', 'Checkpoints required'],
-  },
-  {
-    code: 'CAP-ESCALATE-HUMAN',
-    name: 'Human Escalation',
-    category: CapabilityCategory.GOVERNANCE,
-    description: 'Initiate escalation to human reviewers',
-    unlockTier: TrustTier.T4_STANDARD,
-  },
-
-  // T5 - Trusted
-  {
-    code: 'CAP-AGENT-DELEGATE',
-    name: 'Task Delegation',
-    category: CapabilityCategory.AGENT_INTERACTION,
-    description: 'Delegate tasks to other agents',
-    unlockTier: TrustTier.T5_TRUSTED,
-    constraints: ['Trust verified agents'],
-  },
-  {
-    code: 'CAP-RESOURCE-PROVISION',
-    name: 'Resource Provisioning',
-    category: CapabilityCategory.RESOURCE_MANAGEMENT,
-    description: 'Provision computational resources',
-    unlockTier: TrustTier.T5_TRUSTED,
-    constraints: ['Budget limits', 'Approval required'],
-  },
-
-  // T6 - Certified
-  {
-    code: 'CAP-AGENT-SPAWN',
-    name: 'Spawn Agents',
-    category: CapabilityCategory.AGENT_INTERACTION,
-    description: 'Create new agent instances',
-    unlockTier: TrustTier.T6_CERTIFIED,
-    constraints: ['Template required', 'Quota limited'],
-  },
-  {
-    code: 'CAP-INFRA-MANAGE',
-    name: 'Infrastructure Management',
-    category: CapabilityCategory.RESOURCE_MANAGEMENT,
-    description: 'Manage infrastructure resources',
-    unlockTier: TrustTier.T6_CERTIFIED,
-    constraints: ['Approved resources'],
-  },
-  {
-    code: 'CAP-POLICY-CREATE',
-    name: 'Policy Creation',
-    category: CapabilityCategory.GOVERNANCE,
-    description: 'Create governance policies',
-    unlockTier: TrustTier.T6_CERTIFIED,
-    constraints: ['Review required'],
-  },
-
-  // T7 - Autonomous
-  {
-    code: 'CAP-FULL-ADMIN',
-    name: 'Full Administration',
-    category: CapabilityCategory.ADMIN,
-    description: 'Full administrative access',
-    unlockTier: TrustTier.T7_AUTONOMOUS,
-  },
-  {
-    code: 'CAP-SELF-MODIFY',
-    name: 'Self-Modification',
-    category: CapabilityCategory.CODE_EXECUTION,
-    description: 'Modify own configuration and behavior',
-    unlockTier: TrustTier.T7_AUTONOMOUS,
-    constraints: ['Ethical bounds', 'Audit logged'],
-  },
-  {
-    code: 'CAP-STRATEGIC-DECISION',
-    name: 'Strategic Decisions',
-    category: CapabilityCategory.GOVERNANCE,
-    description: 'Make strategic organizational decisions',
-    unlockTier: TrustTier.T7_AUTONOMOUS,
-    constraints: ['Human oversight available'],
-  },
-] as const;
-
-// =============================================================================
-// HELPER FUNCTIONS
-// =============================================================================
-
-/**
- * Get capabilities available at a specific tier
- */
-export function getCapabilitiesForTier(tier: TrustTier): CapabilityDefinition[] {
-  return CAPABILITIES.filter((cap) => cap.unlockTier <= tier);
-}
-
-/**
- * Get capability by code
- */
-export function getCapability(code: string): CapabilityDefinition | undefined {
-  return CAPABILITIES.find((cap) => cap.code === code);
-}
-
-/**
- * Check if a capability is available at a tier
- */
-export function isCapabilityAvailable(code: string, tier: TrustTier): boolean {
-  const cap = getCapability(code);
-  return cap !== undefined && cap.unlockTier <= tier;
-}
-
-/**
- * Get minimum tier required for a capability
- */
-export function getCapabilityMinTier(code: string): TrustTier | undefined {
-  return getCapability(code)?.unlockTier;
-}
-
-/**
- * Get capabilities by category
- */
-export function getCapabilitiesByCategory(
-  category: CapabilityCategory
-): CapabilityDefinition[] {
-  return CAPABILITIES.filter((cap) => cap.category === category);
-}
-
-/**
- * Get all capability codes
- */
-export function getAllCapabilityCodes(): string[] {
-  return CAPABILITIES.map((cap) => cap.code);
-}