@vorionsys/contracts 0.1.0

package/dist/canonical/intent.d.ts.map

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

package/dist/canonical/intent.js

@@ -0,0 +1,203 @@
+/**
+ * @fileoverview Canonical Intent type definitions for the Vorion Platform.
+ *
+ * This file provides the authoritative definition for intents - requests from
+ * agents to perform actions. It combines and reconciles the various Intent
+ * definitions found across the codebase into a single canonical source.
+ *
+ * An Intent represents what an agent wants to do, including the action,
+ * resources involved, classification metadata, and trust context.
+ *
+ * @module @vorion/contracts/canonical/intent
+ */
+import { z } from 'zod';
+import { trustBandSchema } from './trust-band.js';
+import { trustScoreSchema } from './trust-score.js';
+// Re-export enums from v2 to avoid duplication
+export { ActionType, DataSensitivity, Reversibility } from '../v2/enums.js';
+import { ActionType, DataSensitivity, Reversibility } from '../v2/enums.js';
+/**
+ * All possible intent status values as an array.
+ */
+export const INTENT_STATUS_VALUES = [
+    'pending',
+    'evaluating',
+    'approved',
+    'denied',
+    'escalated',
+    'executing',
+    'completed',
+    'failed',
+    'cancelled',
+];
+/**
+ * Terminal intent statuses (intent lifecycle has ended).
+ */
+export const TERMINAL_INTENT_STATUSES = [
+    'denied',
+    'completed',
+    'failed',
+    'cancelled',
+];
+/**
+ * Active intent statuses (intent is still in progress).
+ */
+export const ACTIVE_INTENT_STATUSES = [
+    'pending',
+    'evaluating',
+    'approved',
+    'escalated',
+    'executing',
+];
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if a value is a valid IntentStatus.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid IntentStatus
+ */
+export function isIntentStatus(value) {
+    return typeof value === 'string' && INTENT_STATUS_VALUES.includes(value);
+}
+/**
+ * Type guard to check if an IntentStatus is terminal.
+ *
+ * @param status - Status to check
+ * @returns True if status is a terminal state
+ */
+export function isTerminalStatus(status) {
+    return TERMINAL_INTENT_STATUSES.includes(status);
+}
+/**
+ * Type guard to check if an IntentStatus is active.
+ *
+ * @param status - Status to check
+ * @returns True if status is an active state
+ */
+export function isActiveStatus(status) {
+    return ACTIVE_INTENT_STATUSES.includes(status);
+}
+// Note: isActionType, isDataSensitivity, and isReversibility type guards
+// are exported from canonical/validation.ts to avoid duplication
+// ============================================================================
+// Zod Schemas
+// ============================================================================
+/**
+ * Zod schema for ActionType enum.
+ */
+export const actionTypeSchema = z.nativeEnum(ActionType, {
+    errorMap: () => ({ message: 'Invalid action type' }),
+});
+/**
+ * Zod schema for DataSensitivity enum.
+ */
+export const dataSensitivitySchema = z.nativeEnum(DataSensitivity, {
+    errorMap: () => ({ message: 'Invalid data sensitivity level' }),
+});
+/**
+ * Zod schema for Reversibility enum.
+ */
+export const reversibilitySchema = z.nativeEnum(Reversibility, {
+    errorMap: () => ({ message: 'Invalid reversibility value' }),
+});
+/**
+ * Zod schema for IntentStatus.
+ */
+export const intentStatusSchema = z.enum([
+    'pending',
+    'evaluating',
+    'approved',
+    'denied',
+    'escalated',
+    'executing',
+    'completed',
+    'failed',
+    'cancelled',
+], {
+    errorMap: () => ({ message: 'Invalid intent status' }),
+});
+/**
+ * Zod schema for IntentContext.
+ */
+export const intentContextSchema = z.object({
+    domain: z.string().optional(),
+    environment: z.string().optional(),
+    onBehalfOf: z.string().optional(),
+    sessionId: z.string().optional(),
+    parentIntentId: z.string().uuid().optional(),
+    priority: z.number().int().min(0).max(10).optional(),
+    handlesPii: z.boolean().optional(),
+    handlesPhi: z.boolean().optional(),
+    jurisdictions: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+    metadata: z.record(z.unknown()).optional(),
+}).strict();
+/**
+ * Zod schema for TrustSnapshot.
+ */
+export const trustSnapshotSchema = z.object({
+    score: trustScoreSchema,
+    band: trustBandSchema,
+    capturedAt: z.coerce.date(),
+    profileVersion: z.number().int().positive().optional(),
+});
+/**
+ * Zod schema for Intent validation.
+ */
+export const intentSchema = z.object({
+    intentId: z.string().uuid(),
+    tenantId: z.string().min(1),
+    agentId: z.string().min(1),
+    correlationId: z.string().uuid(),
+    action: z.string().min(1).max(1000),
+    actionType: actionTypeSchema,
+    resourceScope: z.array(z.string().min(1)).min(1),
+    dataSensitivity: dataSensitivitySchema,
+    reversibility: reversibilitySchema,
+    context: intentContextSchema,
+    trustSnapshot: trustSnapshotSchema,
+    status: intentStatusSchema,
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+    expiresAt: z.coerce.date().optional(),
+    deletedAt: z.coerce.date().optional(),
+    cancellationReason: z.string().optional(),
+    denialReason: z.string().optional(),
+    failureReason: z.string().optional(),
+    source: z.string().optional(),
+    decisionId: z.string().uuid().optional(),
+    executionId: z.string().uuid().optional(),
+});
+/**
+ * Zod schema for IntentSummary.
+ */
+export const intentSummarySchema = z.object({
+    intentId: z.string().uuid(),
+    tenantId: z.string().min(1),
+    agentId: z.string().min(1),
+    correlationId: z.string().uuid(),
+    action: z.string(),
+    actionType: actionTypeSchema,
+    dataSensitivity: dataSensitivitySchema,
+    status: intentStatusSchema,
+    trustBand: trustBandSchema,
+    createdAt: z.coerce.date(),
+});
+/**
+ * Zod schema for CreateIntentRequest validation.
+ */
+export const createIntentRequestSchema = z.object({
+    agentId: z.string().min(1),
+    action: z.string().min(1).max(1000),
+    actionType: actionTypeSchema,
+    resourceScope: z.array(z.string().min(1)).min(1),
+    dataSensitivity: dataSensitivitySchema,
+    reversibility: reversibilitySchema,
+    correlationId: z.string().uuid().optional(),
+    context: intentContextSchema.partial().optional(),
+    expiresInMs: z.number().int().positive().optional(),
+    source: z.string().optional(),
+});
+//# sourceMappingURL=intent.js.map

package/dist/canonical/intent.js.map

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

package/dist/canonical/risk-level.d.ts

@@ -0,0 +1,344 @@
+/**
+ * @fileoverview Canonical RiskLevel type definitions for the Vorion Platform.
+ *
+ * This file provides the authoritative definition for risk levels, unifying
+ * the various representations found across packages (enum, string union, numeric)
+ * into a single canonical source with conversion utilities.
+ *
+ * Risk levels classify the potential impact or severity of actions, decisions,
+ * and events within the platform.
+ *
+ * @module @vorion/contracts/canonical/risk-level
+ */
+import { z } from 'zod';
+/**
+ * Canonical risk level type.
+ *
+ * Uses lowercase string union as the authoritative format.
+ * This provides good developer experience while being easily
+ * serializable and human-readable.
+ *
+ * Levels (in ascending severity):
+ * - `low`: Minimal risk, standard operation
+ * - `medium`: Moderate risk, enhanced monitoring recommended
+ * - `high`: Significant risk, requires additional safeguards
+ * - `critical`: Severe risk, may require human intervention
+ *
+ * @example
+ * ```typescript
+ * const risk: RiskLevel = 'medium';
+ * ```
+ */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Array of all risk levels in ascending severity order.
+ *
+ * Useful for iteration, validation, and UI components.
+ */
+export declare const RISK_LEVELS: readonly RiskLevel[];
+/**
+ * Numeric values for risk levels (0-3 scale).
+ *
+ * Enables numeric comparisons and calculations while maintaining
+ * the string type as the canonical representation.
+ *
+ * @example
+ * ```typescript
+ * RISK_LEVEL_VALUES['critical']; // 3
+ * RISK_LEVEL_VALUES['low'];      // 0
+ * ```
+ */
+export declare const RISK_LEVEL_VALUES: Readonly<Record<RiskLevel, number>>;
+/**
+ * Human-readable labels for risk levels.
+ *
+ * Useful for display in UIs and reports.
+ */
+export declare const RISK_LEVEL_LABELS: Readonly<Record<RiskLevel, string>>;
+/**
+ * Detailed descriptions for each risk level.
+ *
+ * Provides guidance on what each level means and when to use it.
+ */
+export declare const RISK_LEVEL_DESCRIPTIONS: Readonly<Record<RiskLevel, string>>;
+/**
+ * Color codes for risk levels (for UI display).
+ *
+ * Uses common color conventions: green for low, yellow/orange for medium,
+ * red for high, and dark red for critical.
+ */
+export declare const RISK_LEVEL_COLORS: Readonly<Record<RiskLevel, string>>;
+/**
+ * Default risk level for unclassified items.
+ */
+export declare const DEFAULT_RISK_LEVEL: RiskLevel;
+/**
+ * Converts a numeric value to a RiskLevel.
+ *
+ * Handles the 5-level numeric system (0-4) used by some packages
+ * by mapping level 4 to 'critical' (same as level 3).
+ *
+ * @param n - Numeric value (0-4)
+ * @returns Corresponding RiskLevel
+ *
+ * @example
+ * ```typescript
+ * riskLevelFromNumber(0); // 'low'
+ * riskLevelFromNumber(2); // 'high'
+ * riskLevelFromNumber(4); // 'critical' (Council's L4 maps to critical)
+ * ```
+ */
+export declare function riskLevelFromNumber(n: number): RiskLevel;
+/**
+ * Converts a RiskLevel to its numeric value.
+ *
+ * @param level - RiskLevel to convert
+ * @returns Numeric value (0-3)
+ *
+ * @example
+ * ```typescript
+ * riskLevelToNumber('low');      // 0
+ * riskLevelToNumber('critical'); // 3
+ * ```
+ */
+export declare function riskLevelToNumber(level: RiskLevel): number;
+/**
+ * Safely parses a value to RiskLevel.
+ *
+ * Handles various input formats:
+ * - String values (case-insensitive)
+ * - Numeric values (0-4)
+ * - Enum-style uppercase strings
+ *
+ * @param value - Value to parse
+ * @returns RiskLevel or null if unparseable
+ *
+ * @example
+ * ```typescript
+ * parseRiskLevel('LOW');     // 'low'
+ * parseRiskLevel('MEDIUM');  // 'medium'
+ * parseRiskLevel(2);         // 'high'
+ * parseRiskLevel('invalid'); // null
+ * ```
+ */
+export declare function parseRiskLevel(value: unknown): RiskLevel | null;
+/**
+ * Parses a value to RiskLevel with a default fallback.
+ *
+ * @param value - Value to parse
+ * @param defaultLevel - Default level if parsing fails
+ * @returns RiskLevel (parsed or default)
+ *
+ * @example
+ * ```typescript
+ * parseRiskLevelOrDefault('high', 'low');    // 'high'
+ * parseRiskLevelOrDefault('invalid', 'low'); // 'low'
+ * ```
+ */
+export declare function parseRiskLevelOrDefault(value: unknown, defaultLevel?: RiskLevel): RiskLevel;
+/**
+ * Compares two risk levels.
+ *
+ * @param a - First risk level
+ * @param b - Second risk level
+ * @returns -1 if a < b, 0 if equal, 1 if a > b
+ *
+ * @example
+ * ```typescript
+ * compareRiskLevels('low', 'high');     // -1
+ * compareRiskLevels('high', 'medium');  // 1
+ * compareRiskLevels('medium', 'medium'); // 0
+ * ```
+ */
+export declare function compareRiskLevels(a: RiskLevel, b: RiskLevel): -1 | 0 | 1;
+/**
+ * Checks if a risk level is at least as severe as another.
+ *
+ * @param level - Level to check
+ * @param threshold - Minimum threshold
+ * @returns True if level meets or exceeds threshold
+ *
+ * @example
+ * ```typescript
+ * isRiskAtLeast('high', 'medium');     // true
+ * isRiskAtLeast('low', 'medium');      // false
+ * isRiskAtLeast('medium', 'medium');   // true
+ * ```
+ */
+export declare function isRiskAtLeast(level: RiskLevel, threshold: RiskLevel): boolean;
+/**
+ * Checks if a risk level is more severe than another.
+ *
+ * @param level - Level to check
+ * @param other - Level to compare against
+ * @returns True if level is more severe than other
+ *
+ * @example
+ * ```typescript
+ * isRiskHigherThan('high', 'medium');   // true
+ * isRiskHigherThan('medium', 'high');   // false
+ * isRiskHigherThan('high', 'high');     // false
+ * ```
+ */
+export declare function isRiskHigherThan(level: RiskLevel, other: RiskLevel): boolean;
+/**
+ * Gets the maximum (most severe) risk level from an array.
+ *
+ * @param levels - Array of risk levels
+ * @returns Most severe risk level, or 'low' if array is empty
+ *
+ * @example
+ * ```typescript
+ * maxRiskLevel(['low', 'medium', 'high']); // 'high'
+ * maxRiskLevel(['low', 'low']);            // 'low'
+ * maxRiskLevel([]);                        // 'low'
+ * ```
+ */
+export declare function maxRiskLevel(levels: RiskLevel[]): RiskLevel;
+/**
+ * Gets the minimum (least severe) risk level from an array.
+ *
+ * @param levels - Array of risk levels
+ * @returns Least severe risk level, or 'critical' if array is empty
+ *
+ * @example
+ * ```typescript
+ * minRiskLevel(['low', 'medium', 'high']); // 'low'
+ * minRiskLevel(['high', 'critical']);      // 'high'
+ * ```
+ */
+export declare function minRiskLevel(levels: RiskLevel[]): RiskLevel;
+/**
+ * Escalates a risk level by one step (if possible).
+ *
+ * @param level - Current risk level
+ * @returns Escalated risk level (or same if already critical)
+ *
+ * @example
+ * ```typescript
+ * escalateRiskLevel('low');      // 'medium'
+ * escalateRiskLevel('high');     // 'critical'
+ * escalateRiskLevel('critical'); // 'critical'
+ * ```
+ */
+export declare function escalateRiskLevel(level: RiskLevel): RiskLevel;
+/**
+ * De-escalates a risk level by one step (if possible).
+ *
+ * @param level - Current risk level
+ * @returns De-escalated risk level (or same if already low)
+ *
+ * @example
+ * ```typescript
+ * deescalateRiskLevel('critical'); // 'high'
+ * deescalateRiskLevel('medium');   // 'low'
+ * deescalateRiskLevel('low');      // 'low'
+ * ```
+ */
+export declare function deescalateRiskLevel(level: RiskLevel): RiskLevel;
+/**
+ * Type guard to check if a value is a valid RiskLevel.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid RiskLevel
+ *
+ * @example
+ * ```typescript
+ * isRiskLevel('high');    // true
+ * isRiskLevel('severe');  // false
+ * isRiskLevel(2);         // false
+ * ```
+ */
+export declare function isRiskLevel(value: unknown): value is RiskLevel;
+/**
+ * Type guard to check if a risk level requires elevated attention.
+ *
+ * Returns true for 'high' and 'critical' levels.
+ *
+ * @param level - Risk level to check
+ * @returns True if level requires elevated attention
+ */
+export declare function requiresElevatedAttention(level: RiskLevel): boolean;
+/**
+ * Type guard to check if a risk level is critical.
+ *
+ * @param level - Risk level to check
+ * @returns True if level is critical
+ */
+export declare function isCriticalRisk(level: RiskLevel): boolean;
+/**
+ * Gets the human-readable label for a risk level.
+ *
+ * @param level - Risk level
+ * @returns Human-readable label
+ */
+export declare function getRiskLevelLabel(level: RiskLevel): string;
+/**
+ * Gets the description for a risk level.
+ *
+ * @param level - Risk level
+ * @returns Description string
+ */
+export declare function getRiskLevelDescription(level: RiskLevel): string;
+/**
+ * Gets the color code for a risk level.
+ *
+ * @param level - Risk level
+ * @returns Hex color code
+ */
+export declare function getRiskLevelColor(level: RiskLevel): string;
+/**
+ * Zod schema for RiskLevel validation.
+ *
+ * Validates that a value is one of the canonical risk level strings.
+ *
+ * @example
+ * ```typescript
+ * riskLevelSchema.parse('medium'); // Success
+ * riskLevelSchema.parse('severe'); // Throws ZodError
+ * ```
+ */
+export declare const riskLevelSchema: z.ZodEnum<["low", "medium", "high", "critical"]>;
+/**
+ * Zod schema that accepts numeric input and transforms to RiskLevel.
+ *
+ * @example
+ * ```typescript
+ * riskLevelFromNumberSchema.parse(2); // 'high'
+ * ```
+ */
+export declare const riskLevelFromNumberSchema: z.ZodEffects<z.ZodNumber, "low" | "medium" | "high" | "critical", number>;
+/**
+ * Zod schema that accepts string input (case-insensitive) and transforms to RiskLevel.
+ *
+ * @example
+ * ```typescript
+ * riskLevelFlexibleSchema.parse('HIGH'); // 'high'
+ * riskLevelFlexibleSchema.parse('Medium'); // 'medium'
+ * ```
+ */
+export declare const riskLevelFlexibleSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["low", "medium", "high", "critical"]>>;
+/**
+ * Zod schema that accepts multiple input formats and normalizes to RiskLevel.
+ *
+ * Accepts: lowercase strings, uppercase strings, numbers (0-4).
+ */
+export declare const riskLevelUnionSchema: z.ZodUnion<[z.ZodEnum<["low", "medium", "high", "critical"]>, z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["low", "medium", "high", "critical"]>>, z.ZodEffects<z.ZodNumber, "low" | "medium" | "high" | "critical", number>]>;
+/**
+ * Enum-style representation for compatibility with older code.
+ *
+ * @deprecated Use RiskLevel string type directly. This is for migration only.
+ */
+export declare const RiskLevelEnum: {
+    readonly LOW: RiskLevel;
+    readonly MEDIUM: RiskLevel;
+    readonly HIGH: RiskLevel;
+    readonly CRITICAL: RiskLevel;
+};
+/**
+ * Maps legacy uppercase enum values to canonical RiskLevel.
+ *
+ * @deprecated Use RiskLevel string type directly. This is for migration only.
+ */
+export declare const LEGACY_RISK_LEVEL_MAP: Readonly<Record<string, RiskLevel>>;
+//# sourceMappingURL=risk-level.d.ts.map

package/dist/canonical/risk-level.d.ts.map

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