@vorionsys/platform-core 0.1.0

package/dist/enforce/adapters.js

@@ -0,0 +1,293 @@
+/**
+ * Decision Adapters
+ *
+ * Provides conversion between internal Decision type and canonical
+ * Decision/FluidDecision types from @vorion/contracts.
+ *
+ * @packageDocumentation
+ */
+import { TrustBand, DecisionTier, RefinementAction, ApprovalType, DenialReason, } from '@vorionsys/contracts';
+// =============================================================================
+// TRUST BAND MAPPING
+// =============================================================================
+const TRUST_BAND_MAP = {
+    T0_SANDBOX: TrustBand.T0_SANDBOX,
+    T1_OBSERVED: TrustBand.T1_OBSERVED,
+    T2_PROVISIONAL: TrustBand.T2_PROVISIONAL,
+    T3_MONITORED: TrustBand.T3_MONITORED,
+    T4_STANDARD: TrustBand.T4_STANDARD,
+    T5_TRUSTED: TrustBand.T5_TRUSTED,
+    T6_CERTIFIED: TrustBand.T6_CERTIFIED,
+    T7_AUTONOMOUS: TrustBand.T7_AUTONOMOUS,
+};
+const TRUST_LEVEL_TO_BAND = {
+    0: TrustBand.T0_SANDBOX,
+    1: TrustBand.T1_OBSERVED,
+    2: TrustBand.T2_PROVISIONAL,
+    3: TrustBand.T3_MONITORED,
+    4: TrustBand.T4_STANDARD,
+    5: TrustBand.T5_TRUSTED,
+    6: TrustBand.T6_CERTIFIED,
+    7: TrustBand.T7_AUTONOMOUS,
+};
+/**
+ * Parse trust band string to enum
+ */
+export function parseTrustBand(value) {
+    if (typeof value === 'number') {
+        return TRUST_LEVEL_TO_BAND[value] ?? TrustBand.T0_SANDBOX;
+    }
+    return TRUST_BAND_MAP[value] ?? TrustBand.T0_SANDBOX;
+}
+/**
+ * Convert trust band enum to string
+ */
+export function trustBandToString(band) {
+    const entries = Object.entries(TRUST_BAND_MAP);
+    for (const [key, value] of entries) {
+        if (value === band)
+            return key;
+    }
+    return 'T0_SANDBOX';
+}
+// =============================================================================
+// DECISION TIER MAPPING
+// =============================================================================
+const DECISION_TIER_MAP = {
+    GREEN: DecisionTier.GREEN,
+    YELLOW: DecisionTier.YELLOW,
+    RED: DecisionTier.RED,
+};
+/**
+ * Parse decision tier string to enum
+ */
+export function parseDecisionTier(value) {
+    return DECISION_TIER_MAP[value] ?? DecisionTier.RED;
+}
+// =============================================================================
+// REFINEMENT ACTION MAPPING
+// =============================================================================
+const REFINEMENT_ACTION_MAP = {
+    REDUCE_SCOPE: RefinementAction.REDUCE_SCOPE,
+    ADD_CONSTRAINTS: RefinementAction.ADD_CONSTRAINTS,
+    REQUEST_APPROVAL: RefinementAction.REQUEST_APPROVAL,
+    PROVIDE_CONTEXT: RefinementAction.PROVIDE_CONTEXT,
+    DECOMPOSE: RefinementAction.DECOMPOSE,
+    WAIT_FOR_TRUST: RefinementAction.WAIT_FOR_TRUST,
+};
+/**
+ * Parse refinement action string to enum
+ */
+export function parseRefinementAction(value) {
+    return REFINEMENT_ACTION_MAP[value] ?? RefinementAction.ADD_CONSTRAINTS;
+}
+// =============================================================================
+// APPROVAL TYPE MAPPING
+// =============================================================================
+const APPROVAL_TYPE_MAP = {
+    none: ApprovalType.NONE,
+    human_review: ApprovalType.HUMAN_REVIEW,
+    automated_check: ApprovalType.AUTOMATED_CHECK,
+    multi_party: ApprovalType.MULTI_PARTY,
+};
+/**
+ * Parse approval type string to enum
+ */
+export function parseApprovalType(value) {
+    return APPROVAL_TYPE_MAP[value] ?? ApprovalType.NONE;
+}
+// =============================================================================
+// DENIAL REASON MAPPING
+// =============================================================================
+const DENIAL_REASON_MAP = {
+    insufficient_trust: DenialReason.INSUFFICIENT_TRUST,
+    policy_violation: DenialReason.POLICY_VIOLATION,
+    resource_restricted: DenialReason.RESOURCE_RESTRICTED,
+    data_sensitivity_exceeded: DenialReason.DATA_SENSITIVITY_EXCEEDED,
+    rate_limit_exceeded: DenialReason.RATE_LIMIT_EXCEEDED,
+    context_mismatch: DenialReason.CONTEXT_MISMATCH,
+    expired_intent: DenialReason.EXPIRED_INTENT,
+    system_error: DenialReason.SYSTEM_ERROR,
+};
+/**
+ * Parse denial reason string to enum
+ */
+export function parseDenialReason(value) {
+    if (!value)
+        return undefined;
+    return DENIAL_REASON_MAP[value];
+}
+// =============================================================================
+// INTERNAL TO CANONICAL
+// =============================================================================
+/**
+ * Convert internal constraints to canonical format
+ */
+export function toCanonicalConstraints(internal) {
+    return {
+        allowedTools: internal.allowedTools,
+        dataScopes: internal.dataScopes,
+        rateLimits: internal.rateLimits,
+        requiredApprovals: internal.requiredApprovals.map((a) => ({
+            type: parseApprovalType(a.type),
+            approver: a.approver,
+            timeoutMs: a.timeoutMs,
+            reason: a.reason,
+        })),
+        reversibilityRequired: internal.reversibilityRequired,
+        maxExecutionTimeMs: internal.maxExecutionTimeMs ?? undefined,
+        maxRetries: internal.maxRetries,
+        resourceQuotas: internal.resourceQuotas ?? undefined,
+    };
+}
+/**
+ * Convert internal refinement option to canonical format
+ */
+export function toCanonicalRefinementOption(internal) {
+    return {
+        id: internal.id,
+        action: parseRefinementAction(internal.action),
+        description: internal.description,
+        successProbability: internal.successProbability,
+        effort: internal.effort,
+        parameters: internal.parameters ?? undefined,
+        resultingConstraints: internal.resultingConstraints,
+    };
+}
+/**
+ * Convert internal decision to canonical Decision format
+ */
+export function toCanonicalDecision(internal) {
+    return {
+        decisionId: internal.id,
+        intentId: internal.intentId,
+        agentId: internal.agentId,
+        correlationId: internal.correlationId,
+        permitted: internal.permitted,
+        constraints: internal.constraints
+            ? toCanonicalConstraints(internal.constraints)
+            : undefined,
+        trustBand: parseTrustBand(internal.trustBand),
+        trustScore: internal.trustScore,
+        policySetId: internal.policySetId ?? undefined,
+        reasoning: internal.reasoning,
+        decidedAt: new Date(internal.decidedAt),
+        expiresAt: new Date(internal.expiresAt),
+        latencyMs: internal.latencyMs,
+        version: internal.version,
+    };
+}
+/**
+ * Convert internal decision to canonical FluidDecision format
+ */
+export function toCanonicalFluidDecision(internal) {
+    const baseDecision = toCanonicalDecision(internal);
+    return {
+        ...baseDecision,
+        tier: parseDecisionTier(internal.tier),
+        refinementOptions: internal.refinementOptions?.map(toCanonicalRefinementOption),
+        refinementDeadline: internal.refinementDeadline
+            ? new Date(internal.refinementDeadline)
+            : undefined,
+        maxRefinementAttempts: internal.maxRefinementAttempts,
+        refinementAttempt: internal.refinementAttempt,
+        originalDecisionId: internal.originalDecisionId ?? undefined,
+        appliedRefinements: internal.appliedRefinements?.map((r) => ({
+            refinementId: r.refinementId,
+            appliedAt: new Date(r.appliedAt),
+        })),
+        hardDenial: internal.hardDenial,
+        violatedPolicies: internal.violatedPolicies ?? undefined,
+    };
+}
+/**
+ * Convert internal workflow to canonical format
+ */
+export function toCanonicalWorkflow(internal, decisions) {
+    return {
+        workflowId: internal.id,
+        intentId: internal.intentId,
+        agentId: internal.agentId,
+        correlationId: internal.correlationId,
+        state: internal.state,
+        decisions: decisions.map(toCanonicalFluidDecision),
+        currentDecisionId: internal.currentDecisionId ?? undefined,
+        createdAt: new Date(internal.createdAt),
+        updatedAt: new Date(internal.updatedAt),
+        expiresAt: new Date(internal.expiresAt),
+        stateHistory: internal.stateHistory.map((h) => ({
+            from: h.from,
+            to: h.to,
+            reason: h.reason,
+            timestamp: new Date(h.timestamp),
+        })),
+        execution: internal.execution
+            ? {
+                executionId: internal.execution.executionId,
+                startedAt: new Date(internal.execution.startedAt),
+                completedAt: internal.execution.completedAt
+                    ? new Date(internal.execution.completedAt)
+                    : undefined,
+                status: internal.execution.status,
+                result: internal.execution.result,
+                error: internal.execution.error,
+            }
+            : undefined,
+    };
+}
+// =============================================================================
+// CANONICAL TO INTERNAL
+// =============================================================================
+/**
+ * Convert canonical constraints to internal format
+ */
+export function toInternalConstraints(canonical, decisionId, tenantId) {
+    return {
+        decisionId,
+        tenantId,
+        allowedTools: canonical.allowedTools,
+        dataScopes: canonical.dataScopes,
+        rateLimits: canonical.rateLimits,
+        requiredApprovals: canonical.requiredApprovals.map((a) => ({
+            type: a.type.toString(),
+            approver: a.approver,
+            timeoutMs: a.timeoutMs,
+            reason: a.reason,
+        })),
+        reversibilityRequired: canonical.reversibilityRequired,
+        maxExecutionTimeMs: canonical.maxExecutionTimeMs ?? null,
+        maxRetries: canonical.maxRetries,
+        resourceQuotas: canonical.resourceQuotas ?? null,
+    };
+}
+/**
+ * Convert canonical refinement option to internal format
+ */
+export function toInternalRefinementOption(canonical, decisionId, tenantId) {
+    return {
+        decisionId,
+        tenantId,
+        action: canonical.action,
+        description: canonical.description,
+        successProbability: canonical.successProbability,
+        effort: canonical.effort,
+        parameters: canonical.parameters ?? null,
+        resultingConstraints: canonical.resultingConstraints ?? null,
+    };
+}
+// =============================================================================
+// BATCH CONVERTERS
+// =============================================================================
+/**
+ * Convert array of internal decisions to canonical format
+ */
+export function toCanonicalDecisions(internals) {
+    return internals.map(toCanonicalDecision);
+}
+/**
+ * Convert array of internal decisions to canonical fluid format
+ */
+export function toCanonicalFluidDecisions(internals) {
+    return internals.map(toCanonicalFluidDecision);
+}
+//# sourceMappingURL=adapters.js.map

package/dist/enforce/adapters.js.map

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

package/dist/enforce/index.d.ts

@@ -0,0 +1,213 @@
+/**
+ * ENFORCE - Policy Decision Point with Fluid Governance
+ *
+ * Makes enforcement decisions based on rule evaluations and trust levels.
+ * Supports three-tier fluid governance (GREEN/YELLOW/RED) with refinement
+ * options for agents to modify requests.
+ *
+ * @packageDocumentation
+ */
+import type { Intent, ControlAction, TrustLevel, TrustScore, ID } from '../common/types.js';
+import type { EvaluationResult } from '../basis/types.js';
+import { type Decision, type RefinementOption, type WorkflowInstance } from './repository.js';
+import type { EscalationService } from '../intent/escalation.js';
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+/**
+ * Decision tier for fluid governance
+ */
+export type DecisionTier = 'GREEN' | 'YELLOW' | 'RED';
+/**
+ * Enforcement context combining intent and evaluation results
+ */
+export interface EnforcementContext {
+    intent: Intent;
+    evaluation: EvaluationResult;
+    trustScore: TrustScore;
+    trustLevel: TrustLevel;
+    tenantId: ID;
+    correlationId?: ID;
+}
+/**
+ * Enforcement policy configuration
+ */
+export interface EnforcementPolicy {
+    /** Default action when no rules match */
+    defaultAction: ControlAction;
+    /** Minimum trust level required */
+    requireMinTrustLevel?: TrustLevel;
+    /** Trust level thresholds for automatic approval */
+    trustThresholds?: {
+        /** Auto-approve GREEN if trust level >= this */
+        autoApproveLevel: TrustLevel;
+        /** Force YELLOW (refinement) if trust level < this */
+        requireRefinementLevel: TrustLevel;
+        /** Force RED (deny) if trust level < this */
+        autoDenyLevel: TrustLevel;
+    };
+    /** Escalation rules */
+    escalationRules?: EscalationRule[];
+    /** Default constraints for GREEN decisions */
+    defaultConstraints?: Partial<DecisionConstraintsConfig>;
+    /** Decision expiration time in milliseconds */
+    decisionExpirationMs?: number;
+    /** Refinement deadline in milliseconds */
+    refinementDeadlineMs?: number;
+    /** Maximum refinement attempts */
+    maxRefinementAttempts?: number;
+}
+/**
+ * Escalation rule definition
+ */
+export interface EscalationRule {
+    /** Condition expression */
+    condition: string;
+    /** Who to escalate to */
+    escalateTo: string;
+    /** Timeout duration (ISO 8601) */
+    timeout: string;
+    /** Reason category */
+    reasonCategory?: 'trust_insufficient' | 'high_risk' | 'policy_violation' | 'manual_review';
+}
+/**
+ * Decision constraints configuration
+ */
+export interface DecisionConstraintsConfig {
+    allowedTools: string[];
+    dataScopes: string[];
+    rateLimits: Array<{
+        resource: string;
+        limit: number;
+        windowSeconds: number;
+    }>;
+    requiredApprovals: Array<{
+        type: 'none' | 'human_review' | 'automated_check' | 'multi_party';
+        approver: string;
+        timeoutMs?: number;
+        reason: string;
+    }>;
+    reversibilityRequired: boolean;
+    maxExecutionTimeMs?: number;
+    maxRetries?: number;
+    resourceQuotas?: Record<string, number>;
+}
+/**
+ * Fluid decision result with workflow tracking
+ */
+export interface FluidDecisionResult {
+    decision: Decision;
+    workflow: WorkflowInstance;
+    tier: DecisionTier;
+    /** Action derived from tier: GREEN->allow, RED->deny, YELLOW->escalate */
+    action: ControlAction;
+    /** Whether constraints were evaluated */
+    constraintsEvaluated: boolean;
+    refinementOptions?: RefinementOption[];
+}
+/**
+ * Refinement request
+ */
+export interface RefinementRequest {
+    decisionId: ID;
+    selectedRefinements: ID[];
+    refinementContext?: Record<string, unknown>;
+    modifiedIntent?: Partial<{
+        goal: string;
+        resourceScope: string[];
+        dataSensitivity: string;
+        reversibility: string;
+        context: Record<string, unknown>;
+    }>;
+}
+/**
+ * Policy enforcement service with fluid governance
+ */
+export declare class EnforcementService {
+    private policy;
+    private repository;
+    private escalationService;
+    constructor(policy?: EnforcementPolicy);
+    /**
+     * Initialize with database connection
+     */
+    initialize(db: PostgresJsDatabase, escalationService?: EscalationService): void;
+    /**
+     * Make an enforcement decision with fluid governance
+     */
+    decide(context: EnforcementContext): Promise<FluidDecisionResult>;
+    /**
+     * Process a refinement request for a YELLOW decision
+     */
+    refine(request: RefinementRequest, tenantId: ID): Promise<FluidDecisionResult | null>;
+    /**
+     * Get decision by ID
+     */
+    getDecision(id: ID, tenantId: ID): Promise<Decision | null>;
+    /**
+     * Get workflow by intent ID
+     */
+    getWorkflow(intentId: ID, tenantId: ID): Promise<WorkflowInstance | null>;
+    /**
+     * Update enforcement policy
+     */
+    setPolicy(policy: EnforcementPolicy): void;
+    /**
+     * Determine decision tier based on evaluation and trust
+     */
+    private determineTier;
+    /**
+     * Build decision input from context
+     */
+    private buildDecisionInput;
+    /**
+     * Build reasoning array for decision
+     */
+    private buildReasoning;
+    /**
+     * Determine denial reason for RED decisions
+     */
+    private determineDenialReason;
+    /**
+     * Extract violated policies for RED decisions
+     */
+    private extractViolatedPolicies;
+    /**
+     * Build constraints from evaluation results
+     */
+    private buildConstraintsFromEvaluation;
+    /**
+     * Build constraints for a decision
+     */
+    private buildConstraints;
+    /**
+     * Generate refinement options for YELLOW decisions
+     */
+    private generateRefinementOptions;
+    /**
+     * Evaluate if refinements are sufficient to upgrade to GREEN
+     */
+    private evaluateRefinements;
+    /**
+     * Check if we should create an escalation
+     */
+    private shouldEscalate;
+    /**
+     * Create an escalation for a decision
+     */
+    private createEscalation;
+    /**
+     * Convert workflow state based on decision tier
+     */
+    private tierToWorkflowState;
+    /**
+     * Convert trust level to trust band string
+     */
+    private trustLevelToTrustBand;
+}
+/**
+ * Create a new enforcement service instance
+ */
+export declare function createEnforcementService(policy?: EnforcementPolicy): EnforcementService;
+export type { Decision, DecisionConstraints, RefinementOption, WorkflowInstance } from './repository.js';
+export { DecisionRepository, createDecisionRepository } from './repository.js';
+export * from './adapters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/enforce/index.d.ts.map

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