@vorionsys/contracts 0.1.0

package/dist/v2/decision.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Decision types - the result of authorizing an intent
+ *
+ * Supports both legacy binary (permitted/denied) and the new
+ * three-tier fluid governance model (GREEN/YELLOW/RED).
+ */
+import type { ApprovalType, TrustBand, DecisionTier, RefinementAction, WorkflowState } from './enums.js';
+/**
+ * Rate limit constraint
+ */
+export interface RateLimit {
+    /** What is being limited (requests, tokens, etc.) */
+    resource: string;
+    /** Maximum allowed */
+    limit: number;
+    /** Time window in seconds */
+    windowSeconds: number;
+}
+/**
+ * Approval requirement for permitted actions
+ */
+export interface ApprovalRequirement {
+    /** Type of approval needed */
+    type: ApprovalType;
+    /** Who needs to approve (role, user, system) */
+    approver: string;
+    /** Time limit to get approval (ms) */
+    timeoutMs?: number;
+    /** Reason this approval is required */
+    reason: string;
+}
+/**
+ * Constraints applied to permitted actions
+ */
+export interface DecisionConstraints {
+    /** Required approvals before execution */
+    requiredApprovals: ApprovalRequirement[];
+    /** Tools/capabilities the agent can use */
+    allowedTools: string[];
+    /** Data scopes the agent can access */
+    dataScopes: string[];
+    /** Rate limits to enforce */
+    rateLimits: RateLimit[];
+    /** Must action be reversible? */
+    reversibilityRequired: boolean;
+    /** Maximum execution time in ms */
+    maxExecutionTimeMs?: number;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Resource quotas */
+    resourceQuotas?: Record<string, number>;
+}
+/**
+ * Decision - the authorization result for an intent
+ */
+export interface Decision {
+    /** Unique decision identifier */
+    decisionId: string;
+    /** Intent this decision is for */
+    intentId: string;
+    /** Agent who made the request */
+    agentId: string;
+    /** Correlation ID for tracing */
+    correlationId: string;
+    /** The verdict: can the agent proceed? */
+    permitted: boolean;
+    /** If permitted, what constraints apply */
+    constraints?: DecisionConstraints;
+    /** Agent's trust band at decision time */
+    trustBand: TrustBand;
+    /** Agent's trust score at decision time */
+    trustScore: number;
+    /** Policy set used for this decision */
+    policySetId?: string;
+    /** Human-readable reasoning for the decision */
+    reasoning: string[];
+    /** When decision was made */
+    decidedAt: Date;
+    /** Decision is only valid until this time */
+    expiresAt: Date;
+    /** Time taken to make decision (ms) */
+    latencyMs: number;
+    /** Version for audit */
+    version: number;
+}
+/**
+ * Summary view of a decision
+ */
+export interface DecisionSummary {
+    decisionId: string;
+    intentId: string;
+    agentId: string;
+    correlationId: string;
+    permitted: boolean;
+    trustBand: TrustBand;
+    decidedAt: Date;
+}
+/**
+ * Request to authorize an intent
+ * (Intent itself is the request body)
+ */
+export interface AuthorizationRequest {
+    /** The intent to authorize */
+    intent: {
+        agentId: string;
+        action: string;
+        actionType: string;
+        resourceScope: string[];
+        dataSensitivity: string;
+        reversibility: string;
+        context?: Record<string, unknown>;
+    };
+    /** Optional: Override default policy set */
+    policySetId?: string;
+    /** Optional: Request specific constraints */
+    requestedConstraints?: Partial<DecisionConstraints>;
+}
+/**
+ * Response from authorization
+ */
+export interface AuthorizationResponse {
+    decision: Decision;
+    /** If denied, what would need to change to permit */
+    remediations?: string[];
+}
+/**
+ * Denial reasons enum for structured denials
+ */
+export declare enum DenialReason {
+    INSUFFICIENT_TRUST = "insufficient_trust",
+    POLICY_VIOLATION = "policy_violation",
+    RESOURCE_RESTRICTED = "resource_restricted",
+    DATA_SENSITIVITY_EXCEEDED = "data_sensitivity_exceeded",
+    RATE_LIMIT_EXCEEDED = "rate_limit_exceeded",
+    CONTEXT_MISMATCH = "context_mismatch",
+    EXPIRED_INTENT = "expired_intent",
+    SYSTEM_ERROR = "system_error"
+}
+/**
+ * A refinement option presented to the agent for YELLOW decisions
+ *
+ * Refinements allow the agent to modify their request to achieve GREEN status
+ * rather than receiving a binary denial.
+ */
+export interface RefinementOption {
+    /** Unique identifier for this refinement option */
+    id: string;
+    /** Type of refinement action */
+    action: RefinementAction;
+    /** Human-readable description of what needs to change */
+    description: string;
+    /** Likelihood that this refinement will succeed (0-1) */
+    successProbability: number;
+    /** Estimated effort/cost to implement this refinement */
+    effort: 'low' | 'medium' | 'high';
+    /** Specific parameters for the refinement */
+    parameters?: Record<string, unknown>;
+    /** If the agent applies this, what constraints would result? */
+    resultingConstraints?: Partial<DecisionConstraints>;
+}
+/**
+ * Fluid Decision - extends Decision with three-tier governance
+ *
+ * The fluid decision model replaces binary allow/deny with:
+ * - GREEN: Approved with constraints
+ * - YELLOW: Can be refined to achieve approval
+ * - RED: Hard denial (policy violation)
+ */
+export interface FluidDecision extends Decision {
+    /**
+     * Decision tier (GREEN/YELLOW/RED)
+     *
+     * - GREEN: Proceed with constraints
+     * - YELLOW: Refinement required
+     * - RED: Cannot proceed
+     */
+    tier: DecisionTier;
+    /**
+     * For YELLOW decisions: available refinement options
+     *
+     * The agent can choose one or more refinements to upgrade
+     * their decision to GREEN.
+     */
+    refinementOptions?: RefinementOption[];
+    /**
+     * For YELLOW decisions: deadline to submit refinement
+     */
+    refinementDeadline?: Date;
+    /**
+     * For YELLOW decisions: maximum refinement attempts allowed
+     */
+    maxRefinementAttempts?: number;
+    /**
+     * Current refinement attempt number (0 = initial decision)
+     */
+    refinementAttempt: number;
+    /**
+     * If this is a refined decision, reference to original
+     */
+    originalDecisionId?: string;
+    /**
+     * Applied refinements that led to this decision
+     */
+    appliedRefinements?: Array<{
+        refinementId: string;
+        appliedAt: Date;
+    }>;
+    /**
+     * For RED decisions: whether this is a soft or hard denial
+     *
+     * - Soft: Could potentially be overridden by higher authority
+     * - Hard: Absolute denial, no override possible
+     */
+    hardDenial?: boolean;
+    /**
+     * For RED decisions: specific policies that were violated
+     */
+    violatedPolicies?: Array<{
+        policyId: string;
+        policyName: string;
+        severity: 'warning' | 'error' | 'critical';
+    }>;
+}
+/**
+ * Request to refine a YELLOW decision
+ */
+export interface RefinementRequest {
+    /** Original decision being refined */
+    decisionId: string;
+    /** Refinement options being applied */
+    selectedRefinements: string[];
+    /** Additional context for the refinement */
+    refinementContext?: Record<string, unknown>;
+    /** Modified intent parameters (if applicable) */
+    modifiedIntent?: Partial<{
+        action: string;
+        resourceScope: string[];
+        dataSensitivity: string;
+        reversibility: string;
+        context: Record<string, unknown>;
+    }>;
+}
+/**
+ * Response from a refinement request
+ */
+export interface RefinementResponse {
+    /** The new decision after refinement */
+    decision: FluidDecision;
+    /** Whether the refinement was successful */
+    success: boolean;
+    /** If unsuccessful, reason for failure */
+    failureReason?: string;
+    /** Remaining refinement attempts */
+    remainingAttempts: number;
+}
+/**
+ * Workflow instance - tracks the lifecycle of an intent through governance
+ */
+export interface WorkflowInstance {
+    /** Unique workflow identifier */
+    workflowId: string;
+    /** Intent being processed */
+    intentId: string;
+    /** Agent who submitted the intent */
+    agentId: string;
+    /** Correlation ID for tracing */
+    correlationId: string;
+    /** Current workflow state */
+    state: WorkflowState;
+    /** All decisions made for this workflow */
+    decisions: FluidDecision[];
+    /** Current/latest decision */
+    currentDecisionId?: string;
+    /** When the workflow was created */
+    createdAt: Date;
+    /** When the workflow was last updated */
+    updatedAt: Date;
+    /** When the workflow expires */
+    expiresAt: Date;
+    /** History of state transitions */
+    stateHistory: Array<{
+        from: WorkflowState;
+        to: WorkflowState;
+        reason: string;
+        timestamp: Date;
+    }>;
+    /** Execution details if approved and executed */
+    execution?: {
+        executionId: string;
+        startedAt: Date;
+        completedAt?: Date;
+        status: 'running' | 'completed' | 'failed';
+        result?: unknown;
+        error?: string;
+    };
+}
+/**
+ * Fluid authorization response - extends standard response with workflow
+ */
+export interface FluidAuthorizationResponse {
+    /** The fluid decision */
+    decision: FluidDecision;
+    /** The workflow instance tracking this authorization */
+    workflow: WorkflowInstance;
+    /** For YELLOW: available refinements */
+    refinementOptions?: RefinementOption[];
+    /** For RED: what would need to change (from legacy system) */
+    remediations?: string[];
+}
+//# sourceMappingURL=decision.d.ts.map

package/dist/v2/decision.d.ts.map

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

package/dist/v2/decision.js

@@ -0,0 +1,21 @@
+/**
+ * Decision types - the result of authorizing an intent
+ *
+ * Supports both legacy binary (permitted/denied) and the new
+ * three-tier fluid governance model (GREEN/YELLOW/RED).
+ */
+/**
+ * Denial reasons enum for structured denials
+ */
+export var DenialReason;
+(function (DenialReason) {
+    DenialReason["INSUFFICIENT_TRUST"] = "insufficient_trust";
+    DenialReason["POLICY_VIOLATION"] = "policy_violation";
+    DenialReason["RESOURCE_RESTRICTED"] = "resource_restricted";
+    DenialReason["DATA_SENSITIVITY_EXCEEDED"] = "data_sensitivity_exceeded";
+    DenialReason["RATE_LIMIT_EXCEEDED"] = "rate_limit_exceeded";
+    DenialReason["CONTEXT_MISMATCH"] = "context_mismatch";
+    DenialReason["EXPIRED_INTENT"] = "expired_intent";
+    DenialReason["SYSTEM_ERROR"] = "system_error";
+})(DenialReason || (DenialReason = {}));
+//# sourceMappingURL=decision.js.map

package/dist/v2/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/v2/decision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwJH;;GAEG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,yDAAyC,CAAA;IACzC,qDAAqC,CAAA;IACrC,2DAA2C,CAAA;IAC3C,uEAAuD,CAAA;IACvD,2DAA2C,CAAA;IAC3C,qDAAqC,CAAA;IACrC,iDAAiC,CAAA;IACjC,6CAA6B,CAAA;AAC/B,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB"}

package/dist/v2/enums.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Core enums for the Vorion Platform
+ */
+/**
+ * Trust bands representing autonomy levels (T0-T7)
+ *
+ * The 8-tier system maps trust scores (0-1000) to discrete autonomy levels:
+ * - T0: Sandbox - Isolated testing, no real operations (0-199)
+ * - T1: Observed - Under active observation and supervision (200-349)
+ * - T2: Provisional - Limited operations with strict constraints (350-499)
+ * - T3: Monitored - Continuous monitoring with expanding freedom (500-649)
+ * - T4: Standard - Trusted for routine operations (650-799)
+ * - T5: Trusted - Expanded capabilities with minimal oversight (800-875)
+ * - T6: Certified - Independent operation with audit trail (876-950)
+ * - T7: Autonomous - Full autonomy for mission-critical operations (951-1000)
+ */
+export declare enum TrustBand {
+    T0_SANDBOX = 0,
+    T1_OBSERVED = 1,
+    T2_PROVISIONAL = 2,
+    T3_MONITORED = 3,
+    T4_STANDARD = 4,
+    T5_TRUSTED = 5,
+    T6_CERTIFIED = 6,
+    T7_AUTONOMOUS = 7
+}
+/**
+ * Observation tiers - determines maximum trust ceiling
+ * based on system observability
+ *
+ * Per ATSF v2.0 RTA findings:
+ * - WHITE_BOX reduced from 95% to 90% (sleeper agent risk)
+ * - ATTESTED_BOX reduced from 100% to 95% (TEE side-channel risk)
+ * - VERIFIED_BOX added requiring multiple verification layers
+ */
+export declare enum ObservationTier {
+    /** I/O only - API accessed proprietary models (max 60%) */
+    BLACK_BOX = "BLACK_BOX",
+    /** I/O + logs - Platform-hosted models (max 75%) */
+    GRAY_BOX = "GRAY_BOX",
+    /** Full code access - Open-source models (max 90%, reduced for sleeper risk) */
+    WHITE_BOX = "WHITE_BOX",
+    /** TEE verified - Models in secure enclaves (max 95%, reduced for side-channel risk) */
+    ATTESTED_BOX = "ATTESTED_BOX",
+    /** Full verification: TEE + zkML + interpretability (max 100%) */
+    VERIFIED_BOX = "VERIFIED_BOX"
+}
+/**
+ * Trust ceiling values for each observation tier (0-1000 scale)
+ * Updated per ATSF v2.0 Red Team Assessment findings
+ */
+export declare const OBSERVATION_CEILINGS: Record<ObservationTier, number>;
+/**
+ * Data sensitivity levels for intent classification
+ */
+export declare enum DataSensitivity {
+    PUBLIC = "PUBLIC",
+    INTERNAL = "INTERNAL",
+    CONFIDENTIAL = "CONFIDENTIAL",
+    RESTRICTED = "RESTRICTED"
+}
+/**
+ * Action reversibility classification
+ */
+export declare enum Reversibility {
+    REVERSIBLE = "REVERSIBLE",
+    PARTIALLY_REVERSIBLE = "PARTIALLY_REVERSIBLE",
+    IRREVERSIBLE = "IRREVERSIBLE"
+}
+/**
+ * Action types for categorizing intents
+ */
+export declare enum ActionType {
+    READ = "read",
+    WRITE = "write",
+    DELETE = "delete",
+    EXECUTE = "execute",
+    COMMUNICATE = "communicate",
+    TRANSFER = "transfer"
+}
+/**
+ * Proof event types for the audit trail
+ */
+export declare enum ProofEventType {
+    INTENT_RECEIVED = "intent_received",
+    DECISION_MADE = "decision_made",
+    TRUST_DELTA = "trust_delta",
+    EXECUTION_STARTED = "execution_started",
+    EXECUTION_COMPLETED = "execution_completed",
+    EXECUTION_FAILED = "execution_failed",
+    INCIDENT_DETECTED = "incident_detected",
+    ROLLBACK_INITIATED = "rollback_initiated",
+    COMPONENT_REGISTERED = "component_registered",
+    COMPONENT_UPDATED = "component_updated"
+}
+/**
+ * Component types in the registry
+ */
+export declare enum ComponentType {
+    AGENT = "agent",
+    SERVICE = "service",
+    ADAPTER = "adapter",
+    POLICY_BUNDLE = "policy_bundle"
+}
+/**
+ * Component lifecycle status
+ */
+export declare enum ComponentStatus {
+    ACTIVE = "active",
+    DEPRECATED = "deprecated",
+    RETIRED = "retired"
+}
+/**
+ * Approval requirement types
+ */
+export declare enum ApprovalType {
+    NONE = "none",
+    HUMAN_REVIEW = "human_review",
+    AUTOMATED_CHECK = "automated_check",
+    MULTI_PARTY = "multi_party"
+}
+/**
+ * Decision Tier - Three-tier governance model for fluid decisions
+ *
+ * Part of Fluid Governance Architecture:
+ * - GREEN: Auto-approved within constraints, proceed immediately
+ * - YELLOW: Requires refinement or human review before proceeding
+ * - RED: Denied, cannot proceed (hard policy violation)
+ *
+ * YELLOW decisions support iterative refinement, allowing agents to
+ * modify their request rather than receiving a binary allow/deny.
+ */
+export declare enum DecisionTier {
+    /** Auto-approved - proceed with constraints */
+    GREEN = "GREEN",
+    /** Requires refinement or review - can be upgraded to GREEN */
+    YELLOW = "YELLOW",
+    /** Denied - hard policy violation, cannot proceed */
+    RED = "RED"
+}
+/**
+ * Refinement action types for YELLOW decisions
+ */
+export declare enum RefinementAction {
+    /** Reduce the scope of the request */
+    REDUCE_SCOPE = "REDUCE_SCOPE",
+    /** Add safety constraints */
+    ADD_CONSTRAINTS = "ADD_CONSTRAINTS",
+    /** Request human approval */
+    REQUEST_APPROVAL = "REQUEST_APPROVAL",
+    /** Provide additional context/justification */
+    PROVIDE_CONTEXT = "PROVIDE_CONTEXT",
+    /** Split into smaller sub-requests */
+    DECOMPOSE = "DECOMPOSE",
+    /** Wait for trust score to improve */
+    WAIT_FOR_TRUST = "WAIT_FOR_TRUST"
+}
+/**
+ * Workflow state for fluid governance
+ */
+export declare enum WorkflowState {
+    /** Initial submission of intent */
+    SUBMITTED = "SUBMITTED",
+    /** Being evaluated by decision engine */
+    EVALUATING = "EVALUATING",
+    /** GREEN - approved and ready for execution */
+    APPROVED = "APPROVED",
+    /** YELLOW - awaiting refinement */
+    PENDING_REFINEMENT = "PENDING_REFINEMENT",
+    /** YELLOW - awaiting human review */
+    PENDING_REVIEW = "PENDING_REVIEW",
+    /** RED - denied */
+    DENIED = "DENIED",
+    /** Currently executing */
+    EXECUTING = "EXECUTING",
+    /** Completed successfully */
+    COMPLETED = "COMPLETED",
+    /** Failed during execution */
+    FAILED = "FAILED",
+    /** Cancelled by user/system */
+    CANCELLED = "CANCELLED",
+    /** Expired before completion */
+    EXPIRED = "EXPIRED"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/v2/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/v2/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,oBAAY,SAAS;IACnB,UAAU,IAAI;IACd,WAAW,IAAI;IACf,cAAc,IAAI;IAClB,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,UAAU,IAAI;IACd,YAAY,IAAI;IAChB,aAAa,IAAI;CAClB;AAED;;;;;;;;GAQG;AACH,oBAAY,eAAe;IACzB,2DAA2D;IAC3D,SAAS,cAAc;IACvB,oDAAoD;IACpD,QAAQ,aAAa;IACrB,gFAAgF;IAChF,SAAS,cAAc;IACvB,wFAAwF;IACxF,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,YAAY,iBAAiB;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAMhE,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,oBAAoB,yBAAyB;IAC7C,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;CACxC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;CAC5B;AAED;;;;;;;;;;GAUG;AACH,oBAAY,YAAY;IACtB,+CAA+C;IAC/C,KAAK,UAAU;IACf,+DAA+D;IAC/D,MAAM,WAAW;IACjB,qDAAqD;IACrD,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,sCAAsC;IACtC,YAAY,iBAAiB;IAC7B,6BAA6B;IAC7B,eAAe,oBAAoB;IACnC,6BAA6B;IAC7B,gBAAgB,qBAAqB;IACrC,+CAA+C;IAC/C,eAAe,oBAAoB;IACnC,sCAAsC;IACtC,SAAS,cAAc;IACvB,sCAAsC;IACtC,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,mCAAmC;IACnC,SAAS,cAAc;IACvB,yCAAyC;IACzC,UAAU,eAAe;IACzB,+CAA+C;IAC/C,QAAQ,aAAa;IACrB,mCAAmC;IACnC,kBAAkB,uBAAuB;IACzC,qCAAqC;IACrC,cAAc,mBAAmB;IACjC,mBAAmB;IACnB,MAAM,WAAW;IACjB,0BAA0B;IAC1B,SAAS,cAAc;IACvB,6BAA6B;IAC7B,SAAS,cAAc;IACvB,8BAA8B;IAC9B,MAAM,WAAW;IACjB,+BAA+B;IAC/B,SAAS,cAAc;IACvB,gCAAgC;IAChC,OAAO,YAAY;CACpB"}