@vorionsys/platform-core 0.1.0

package/dist/intent/adapters.js

@@ -0,0 +1,250 @@
+/**
+ * Intent Adapters
+ *
+ * Provides conversion between internal Intent type (src/common/types.ts)
+ * and canonical Intent type (@vorion/contracts).
+ *
+ * This adapter layer enables gradual migration to canonical types while
+ * maintaining backwards compatibility with existing internal code.
+ *
+ * @packageDocumentation
+ */
+import { ActionType, DataSensitivity, Reversibility, TrustBand, } from '@vorionsys/contracts';
+// =============================================================================
+// TYPE MAPPINGS
+// =============================================================================
+/**
+ * Maps internal trust level (0-7) to canonical TrustBand enum
+ */
+export function trustLevelToTrustBand(level) {
+    if (level === null || level === undefined) {
+        return TrustBand.T0_SANDBOX;
+    }
+    const mapping = {
+        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,
+    };
+    return mapping[level] ?? TrustBand.T0_SANDBOX;
+}
+/**
+ * Maps canonical TrustBand enum to internal trust level (0-7)
+ */
+export function trustBandToTrustLevel(band) {
+    return band;
+}
+/**
+ * Parses action type string to ActionType enum
+ */
+export function parseActionType(value) {
+    if (!value)
+        return ActionType.EXECUTE;
+    const normalized = value.toLowerCase();
+    const mapping = {
+        read: ActionType.READ,
+        write: ActionType.WRITE,
+        delete: ActionType.DELETE,
+        execute: ActionType.EXECUTE,
+        communicate: ActionType.COMMUNICATE,
+        transfer: ActionType.TRANSFER,
+    };
+    return mapping[normalized] ?? ActionType.EXECUTE;
+}
+/**
+ * Parses data sensitivity string to DataSensitivity enum
+ */
+export function parseDataSensitivity(value) {
+    if (!value)
+        return DataSensitivity.INTERNAL;
+    const normalized = value.toUpperCase();
+    const mapping = {
+        PUBLIC: DataSensitivity.PUBLIC,
+        INTERNAL: DataSensitivity.INTERNAL,
+        CONFIDENTIAL: DataSensitivity.CONFIDENTIAL,
+        RESTRICTED: DataSensitivity.RESTRICTED,
+    };
+    return mapping[normalized] ?? DataSensitivity.INTERNAL;
+}
+/**
+ * Parses reversibility string to Reversibility enum
+ */
+export function parseReversibility(value) {
+    if (!value)
+        return Reversibility.REVERSIBLE;
+    const normalized = value.toUpperCase();
+    const mapping = {
+        REVERSIBLE: Reversibility.REVERSIBLE,
+        PARTIALLY_REVERSIBLE: Reversibility.PARTIALLY_REVERSIBLE,
+        IRREVERSIBLE: Reversibility.IRREVERSIBLE,
+    };
+    return mapping[normalized] ?? Reversibility.REVERSIBLE;
+}
+/**
+ * Converts internal Intent to canonical Intent format
+ *
+ * @param internal - Internal intent (may include extended canonical fields)
+ * @returns Canonical intent
+ */
+export function toCanonicalIntent(internal) {
+    // Build trust snapshot from internal fields
+    const trustSnapshot = {
+        score: (internal.trustScore ?? 0),
+        band: trustLevelToTrustBand(internal.trustLevel),
+        capturedAt: new Date(internal.createdAt),
+        profileVersion: undefined,
+    };
+    // Extract context fields from internal context
+    const internalContext = internal.context ?? {};
+    const canonicalContext = {
+        domain: internalContext.domain,
+        environment: internalContext.environment,
+        onBehalfOf: internalContext.onBehalfOf,
+        sessionId: internalContext.sessionId,
+        parentIntentId: internalContext.parentIntentId,
+        priority: internal.priority ?? internalContext.priority,
+        handlesPii: internalContext.handlesPii,
+        handlesPhi: internalContext.handlesPhi,
+        jurisdictions: internalContext.jurisdictions,
+        tags: internalContext.tags,
+        metadata: internal.metadata,
+    };
+    const canonical = {
+        intentId: internal.id,
+        tenantId: internal.tenantId,
+        agentId: internal.entityId,
+        correlationId: internal.correlationId ?? crypto.randomUUID(),
+        action: internal.goal,
+        actionType: parseActionType(internal.actionType ?? internal.intentType),
+        resourceScope: internal.resourceScope ?? [],
+        dataSensitivity: parseDataSensitivity(internal.dataSensitivity),
+        reversibility: parseReversibility(internal.reversibility),
+        context: canonicalContext,
+        trustSnapshot,
+        status: internal.status,
+        createdAt: new Date(internal.createdAt),
+        updatedAt: new Date(internal.updatedAt),
+        expiresAt: internal.expiresAt ? new Date(internal.expiresAt) : undefined,
+        deletedAt: internal.deletedAt ? new Date(internal.deletedAt) : undefined,
+        cancellationReason: internal.cancellationReason ?? undefined,
+        denialReason: internal.denialReason ?? undefined,
+        failureReason: internal.failureReason ?? undefined,
+        source: internal.source ?? undefined,
+        decisionId: internal.decisionId ?? undefined,
+        executionId: internal.executionId ?? undefined,
+    };
+    return canonical;
+}
+// =============================================================================
+// CANONICAL TO INTERNAL
+// =============================================================================
+/**
+ * Converts canonical Intent to internal Intent format
+ *
+ * @param canonical - Canonical intent from @vorion/contracts
+ * @returns Internal intent with extended fields
+ */
+export function toInternalIntent(canonical) {
+    // Flatten context metadata into internal context
+    const internalContext = {
+        domain: canonical.context.domain,
+        environment: canonical.context.environment,
+        onBehalfOf: canonical.context.onBehalfOf,
+        sessionId: canonical.context.sessionId,
+        parentIntentId: canonical.context.parentIntentId,
+        handlesPii: canonical.context.handlesPii,
+        handlesPhi: canonical.context.handlesPhi,
+        jurisdictions: canonical.context.jurisdictions,
+        tags: canonical.context.tags,
+        ...canonical.context.metadata,
+    };
+    // Remove undefined values
+    Object.keys(internalContext).forEach((key) => {
+        if (internalContext[key] === undefined) {
+            delete internalContext[key];
+        }
+    });
+    const internal = {
+        id: canonical.intentId,
+        tenantId: canonical.tenantId,
+        entityId: canonical.agentId,
+        goal: canonical.action,
+        intentType: canonical.actionType,
+        priority: canonical.context.priority,
+        context: internalContext,
+        metadata: canonical.context.metadata ?? {},
+        trustSnapshot: {
+            score: canonical.trustSnapshot.score,
+            band: canonical.trustSnapshot.band,
+        },
+        trustLevel: trustBandToTrustLevel(canonical.trustSnapshot.band),
+        trustScore: canonical.trustSnapshot.score,
+        status: canonical.status,
+        createdAt: canonical.createdAt.toISOString(),
+        updatedAt: canonical.updatedAt.toISOString(),
+        deletedAt: canonical.deletedAt?.toISOString() ?? null,
+        cancellationReason: canonical.cancellationReason ?? null,
+        // Extended canonical fields
+        correlationId: canonical.correlationId,
+        actionType: canonical.actionType,
+        resourceScope: canonical.resourceScope,
+        dataSensitivity: canonical.dataSensitivity,
+        reversibility: canonical.reversibility,
+        expiresAt: canonical.expiresAt?.toISOString() ?? null,
+        denialReason: canonical.denialReason ?? null,
+        failureReason: canonical.failureReason ?? null,
+        decisionId: canonical.decisionId ?? null,
+        executionId: canonical.executionId ?? null,
+        source: canonical.source ?? null,
+    };
+    return internal;
+}
+// =============================================================================
+// CREATE REQUEST ADAPTERS
+// =============================================================================
+/**
+ * Converts a CreateIntentRequest to internal submission format
+ */
+export function fromCreateIntentRequest(request, tenantId) {
+    return {
+        submission: {
+            entityId: request.agentId,
+            goal: request.action,
+            context: request.context ?? {},
+            metadata: request.context?.metadata,
+            intentType: request.actionType,
+            priority: request.context?.priority,
+        },
+        extended: {
+            correlationId: request.correlationId,
+            actionType: request.actionType,
+            resourceScope: request.resourceScope,
+            dataSensitivity: request.dataSensitivity,
+            reversibility: request.reversibility,
+            expiresAt: request.expiresInMs
+                ? new Date(Date.now() + request.expiresInMs)
+                : undefined,
+            source: request.source,
+        },
+    };
+}
+// =============================================================================
+// BATCH ADAPTERS
+// =============================================================================
+/**
+ * Converts an array of internal intents to canonical format
+ */
+export function toCanonicalIntents(internals) {
+    return internals.map(toCanonicalIntent);
+}
+/**
+ * Converts an array of canonical intents to internal format
+ */
+export function toInternalIntents(canonicals) {
+    return canonicals.map(toInternalIntent);
+}
+//# sourceMappingURL=adapters.js.map

package/dist/intent/adapters.js.map

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

package/dist/intent/audit.d.ts

@@ -0,0 +1,119 @@
+/**
+ * INTENT Read Audit Logging
+ *
+ * SOC2 compliant audit logging for read operations in the INTENT module.
+ * Tracks who accessed/viewed data for compliance reporting.
+ *
+ * @packageDocumentation
+ */
+import { CircuitBreakerOpenError } from "../common/circuit-breaker.js";
+import type { ID } from "../common/types.js";
+export { CircuitBreakerOpenError };
+export type AuditAction = "intent.create" | "intent.read" | "intent.read_list" | "intent.update" | "intent.delete" | "escalation.read" | "escalation.approve" | "escalation.reject" | "webhook.read" | "webhook.read_deliveries" | "webhook.read_delivery" | "webhook.read_failed_deliveries" | "webhook.replay" | "gdpr.export" | "gdpr.erase" | "governance.read_regime" | "governance.update_config";
+export type AuditResourceType = "intent" | "escalation" | "webhook" | "user_data" | "governance";
+export interface AuditEntry {
+    id: string;
+    tenantId: string;
+    userId: string;
+    action: AuditAction;
+    resourceType: AuditResourceType;
+    resourceId: string;
+    metadata?: Record<string, unknown>;
+    ipAddress?: string;
+    userAgent?: string;
+    timestamp: Date;
+}
+export type CreateAuditEntry = Omit<AuditEntry, "id" | "timestamp">;
+export interface AuditQueryFilters {
+    tenantId: ID;
+    userId?: string;
+    action?: AuditAction;
+    resourceType?: AuditResourceType;
+    resourceId?: string;
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    offset?: number;
+}
+export interface AuditQueryResult {
+    entries: AuditEntry[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Get the current audit DLQ size for monitoring/alerting
+ * @returns Number of entries in the DLQ
+ */
+export declare function getAuditDlqSize(): Promise<number>;
+/**
+ * Record an audit entry asynchronously.
+ * Uses a queue to batch writes and avoid blocking the request path.
+ *
+ * @param entry - The audit entry to record (without id and timestamp)
+ */
+export declare function recordAudit(entry: CreateAuditEntry): Promise<void>;
+/**
+ * Record an audit entry synchronously (for testing or critical paths).
+ * Prefer recordAudit() for production use.
+ * Protected by circuit breaker to prevent cascading failures.
+ *
+ * @param entry - The audit entry to record
+ * @returns The created audit entry with id and timestamp
+ * @throws CircuitBreakerOpenError if the audit service circuit breaker is open
+ */
+export declare function recordAuditSync(entry: CreateAuditEntry): Promise<AuditEntry>;
+/**
+ * Query audit log entries for compliance reporting.
+ * Supports filtering by user, action, resource, and time range.
+ * Protected by circuit breaker to prevent cascading failures.
+ *
+ * @param filters - Query filters
+ * @returns Paginated audit entries
+ * @throws CircuitBreakerOpenError if the audit service circuit breaker is open
+ */
+export declare function queryAuditLog(filters: AuditQueryFilters): Promise<AuditQueryResult>;
+/**
+ * Get audit entries for a specific resource.
+ * Useful for showing access history on a detail page.
+ *
+ * @param tenantId - Tenant identifier
+ * @param resourceType - Type of resource
+ * @param resourceId - Resource identifier
+ * @param limit - Maximum entries to return
+ * @returns Recent audit entries for the resource
+ */
+export declare function getResourceAuditHistory(tenantId: ID, resourceType: AuditResourceType, resourceId: string, limit?: number): Promise<AuditEntry[]>;
+/**
+ * Get audit entries for a specific user.
+ * Useful for user activity reports and compliance audits.
+ *
+ * @param tenantId - Tenant identifier
+ * @param userId - User identifier
+ * @param options - Query options
+ * @returns Audit entries for the user
+ */
+export declare function getUserAuditHistory(tenantId: ID, userId: string, options?: {
+    from?: Date;
+    to?: Date;
+    limit?: number;
+}): Promise<AuditEntry[]>;
+/**
+ * Gracefully shutdown the audit system.
+ * Flushes any pending entries before returning.
+ */
+export declare function shutdownAuditSystem(): Promise<void>;
+/**
+ * Extract request metadata for audit logging.
+ * Helper function to standardize metadata extraction from requests.
+ *
+ * @param request - Fastify request object
+ * @returns Metadata object with IP and user agent
+ */
+export declare function extractRequestMetadata(request: {
+    ip?: string;
+    headers?: Record<string, string | string[] | undefined>;
+}): {
+    ipAddress?: string;
+    userAgent?: string;
+};
+//# sourceMappingURL=audit.d.ts.map

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

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