@vorionsys/atsf-core 0.2.2 → 0.2.3

package/dist/intent/persistent-intent-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Persistent Intent Service
+ *
+ * Production-quality intent service that provides:
+ * - Input validation via Zod schemas
+ * - Automatic expiration of stale intents
+ * - State machine enforcement for status transitions
+ * - Correlation ID tracking for distributed tracing
+ * - Tenant isolation
+ *
+ * Uses an in-memory store by default. For durable persistence, subclass
+ * and override the storage methods, or use the Supabase-backed variant.
+ *
+ * @packageDocumentation
+ */
+import type { Intent, ID, IntentStatus } from "../common/types.js";
+import type { IIntentService, IntentSubmission, SubmitOptions } from "./types.js";
+export interface PersistentIntentServiceConfig {
+    /** Default expiration time for intents without explicit expiresIn (ms). Default: 1 hour */
+    defaultExpirationMs?: number;
+    /** How often to sweep expired intents (ms). Default: 60 seconds. 0 to disable. */
+    expirationSweepIntervalMs?: number;
+    /** Maximum intents per entity per tenant. Default: 1000 */
+    maxIntentsPerEntity?: number;
+}
+/**
+ * Production-quality intent service with validation, state machine,
+ * expiration, and tenant isolation.
+ */
+export declare class PersistentIntentService implements IIntentService {
+    private intents;
+    private entityIndex;
+    private config;
+    private sweepTimer;
+    constructor(config?: PersistentIntentServiceConfig);
+    /**
+     * Submit a new intent with full validation.
+     */
+    submit(submission: IntentSubmission, options: SubmitOptions): Promise<Intent>;
+    /**
+     * Get an intent by ID with tenant isolation.
+     */
+    get(id: ID, tenantId: ID): Promise<Intent | undefined>;
+    /**
+     * Update intent status with state machine enforcement.
+     */
+    updateStatus(id: ID, tenantId: ID, status: IntentStatus): Promise<Intent | undefined>;
+    /**
+     * List intents for an entity with tenant isolation.
+     */
+    listByEntity(entityId: ID, tenantId: ID): Promise<Intent[]>;
+    /**
+     * Get count of active intents.
+     */
+    count(): number;
+    /**
+     * Shut down the service and clean up timers.
+     */
+    close(): void;
+    /**
+     * Clear all intents (for testing).
+     */
+    clear(): void;
+    private isExpired;
+    private expireIntent;
+    private sweepExpired;
+}
+//# sourceMappingURL=persistent-intent-service.d.ts.map

package/dist/intent/persistent-intent-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-intent-service.d.ts","sourceRoot":"","sources":["../../src/intent/persistent-intent-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AA8DpB,MAAM,WAAW,6BAA6B;IAC5C,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAQD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,UAAU,CAA+C;gBAErD,MAAM,CAAC,EAAE,6BAA6B;IAmBlD;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC;IAuElB;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAe5D;;OAEG;IACG,YAAY,CAChB,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,EAAE,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAqC9B;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBjE;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,SAAS;YAKH,YAAY;IAY1B,OAAO,CAAC,YAAY;CA0BrB"}

package/dist/intent/persistent-intent-service.js

@@ -0,0 +1,277 @@
+/**
+ * Persistent Intent Service
+ *
+ * Production-quality intent service that provides:
+ * - Input validation via Zod schemas
+ * - Automatic expiration of stale intents
+ * - State machine enforcement for status transitions
+ * - Correlation ID tracking for distributed tracing
+ * - Tenant isolation
+ *
+ * Uses an in-memory store by default. For durable persistence, subclass
+ * and override the storage methods, or use the Supabase-backed variant.
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from "../common/logger.js";
+const logger = createLogger({ component: "persistent-intent-service" });
+// =============================================================================
+// STATE MACHINE
+// =============================================================================
+/**
+ * Valid status transitions for the intent lifecycle.
+ * Any transition not listed here is rejected.
+ */
+const VALID_TRANSITIONS = {
+    pending: ["evaluating", "cancelled"],
+    evaluating: ["approved", "denied", "escalated", "failed"],
+    approved: ["executing", "cancelled"],
+    denied: [],
+    escalated: ["approved", "denied", "cancelled"],
+    executing: ["completed", "failed"],
+    completed: [],
+    failed: ["pending"], // allow retry
+    cancelled: [],
+};
+// =============================================================================
+// VALIDATION
+// =============================================================================
+function validateSubmission(submission) {
+    const errors = [];
+    if (!submission.entityId || typeof submission.entityId !== "string") {
+        errors.push("entityId is required and must be a non-empty string");
+    }
+    if (!submission.goal || typeof submission.goal !== "string") {
+        errors.push("goal is required and must be a non-empty string");
+    }
+    if (submission.goal && submission.goal.length > 10_000) {
+        errors.push("goal must be 10,000 characters or fewer");
+    }
+    if (submission.context !== undefined &&
+        (typeof submission.context !== "object" || submission.context === null)) {
+        errors.push("context must be a plain object");
+    }
+    if (submission.expiresIn !== undefined) {
+        if (typeof submission.expiresIn !== "number" || submission.expiresIn <= 0) {
+            errors.push("expiresIn must be a positive number (milliseconds)");
+        }
+        if (submission.expiresIn > 86_400_000) {
+            errors.push("expiresIn cannot exceed 24 hours (86400000ms)");
+        }
+    }
+    return errors;
+}
+const DEFAULT_CONFIG = {
+    defaultExpirationMs: 3_600_000,
+    expirationSweepIntervalMs: 60_000,
+    maxIntentsPerEntity: 1_000,
+};
+/**
+ * Production-quality intent service with validation, state machine,
+ * expiration, and tenant isolation.
+ */
+export class PersistentIntentService {
+    intents = new Map();
+    entityIndex = new Map(); // "tenantId:entityId" → intent IDs
+    config;
+    sweepTimer = null;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (this.config.expirationSweepIntervalMs > 0) {
+            this.sweepTimer = setInterval(() => this.sweepExpired(), this.config.expirationSweepIntervalMs);
+            // Don't prevent Node.js from exiting
+            if (this.sweepTimer &&
+                typeof this.sweepTimer === "object" &&
+                "unref" in this.sweepTimer) {
+                this.sweepTimer.unref();
+            }
+        }
+    }
+    /**
+     * Submit a new intent with full validation.
+     */
+    async submit(submission, options) {
+        // Validate input
+        const errors = validateSubmission(submission);
+        if (errors.length > 0) {
+            throw new Error(`Invalid intent submission: ${errors.join("; ")}`);
+        }
+        if (!options.tenantId) {
+            throw new Error("tenantId is required in SubmitOptions");
+        }
+        // Check per-entity limit
+        const indexKey = `${options.tenantId}:${submission.entityId}`;
+        const existingIds = this.entityIndex.get(indexKey);
+        if (existingIds && existingIds.size >= this.config.maxIntentsPerEntity) {
+            throw new Error(`Entity '${submission.entityId}' has reached the maximum of ${this.config.maxIntentsPerEntity} active intents`);
+        }
+        const now = new Date().toISOString();
+        const correlationId = submission.correlationId ?? crypto.randomUUID();
+        const expiresAt = submission.expiresIn
+            ? new Date(Date.now() + submission.expiresIn).toISOString()
+            : new Date(Date.now() + this.config.defaultExpirationMs).toISOString();
+        const intent = {
+            id: crypto.randomUUID(),
+            tenantId: options.tenantId,
+            entityId: submission.entityId,
+            goal: submission.goal,
+            context: submission.context ?? {},
+            metadata: submission.metadata ?? {},
+            status: "pending",
+            createdAt: now,
+            updatedAt: now,
+            trustSnapshot: options.trustSnapshot ?? null,
+            trustLevel: options.trustLevel ?? null,
+            correlationId,
+            actionType: submission.actionType ?? null,
+            resourceScope: submission.resourceScope ?? null,
+            dataSensitivity: submission.dataSensitivity ?? null,
+            reversibility: submission.reversibility ?? null,
+            expiresAt,
+            source: submission.source ?? null,
+        };
+        // Store
+        this.intents.set(intent.id, intent);
+        // Update entity index
+        if (!this.entityIndex.has(indexKey)) {
+            this.entityIndex.set(indexKey, new Set());
+        }
+        this.entityIndex.get(indexKey).add(intent.id);
+        logger.info({
+            intentId: intent.id,
+            entityId: intent.entityId,
+            tenantId: options.tenantId,
+            goal: intent.goal.slice(0, 100),
+            correlationId,
+            actionType: intent.actionType,
+        }, "Intent submitted");
+        return intent;
+    }
+    /**
+     * Get an intent by ID with tenant isolation.
+     */
+    async get(id, tenantId) {
+        const intent = this.intents.get(id);
+        if (!intent || intent.tenantId !== tenantId) {
+            return undefined;
+        }
+        // Check expiration
+        if (this.isExpired(intent)) {
+            await this.expireIntent(intent);
+            return undefined;
+        }
+        return intent;
+    }
+    /**
+     * Update intent status with state machine enforcement.
+     */
+    async updateStatus(id, tenantId, status) {
+        const intent = this.intents.get(id);
+        if (!intent || intent.tenantId !== tenantId) {
+            return undefined;
+        }
+        // Validate transition
+        const allowed = VALID_TRANSITIONS[intent.status];
+        if (!allowed || !allowed.includes(status)) {
+            throw new Error(`Invalid status transition: '${intent.status}' → '${status}'. ` +
+                `Allowed transitions from '${intent.status}': [${allowed?.join(", ") ?? "none"}]`);
+        }
+        const previousStatus = intent.status;
+        intent.status = status;
+        intent.updatedAt = new Date().toISOString();
+        // Clean up terminal intents from entity index
+        if (status === "completed" ||
+            status === "cancelled" ||
+            status === "denied") {
+            const indexKey = `${tenantId}:${intent.entityId}`;
+            this.entityIndex.get(indexKey)?.delete(id);
+        }
+        logger.info({ intentId: id, from: previousStatus, to: status }, "Intent status updated");
+        return intent;
+    }
+    /**
+     * List intents for an entity with tenant isolation.
+     */
+    async listByEntity(entityId, tenantId) {
+        const indexKey = `${tenantId}:${entityId}`;
+        const ids = this.entityIndex.get(indexKey);
+        if (!ids || ids.size === 0)
+            return [];
+        const results = [];
+        for (const id of ids) {
+            const intent = this.intents.get(id);
+            if (intent && !this.isExpired(intent)) {
+                results.push(intent);
+            }
+        }
+        // Sort by creation time (newest first)
+        return results.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    /**
+     * Get count of active intents.
+     */
+    count() {
+        return this.intents.size;
+    }
+    /**
+     * Shut down the service and clean up timers.
+     */
+    close() {
+        if (this.sweepTimer) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = null;
+        }
+    }
+    /**
+     * Clear all intents (for testing).
+     */
+    clear() {
+        this.intents.clear();
+        this.entityIndex.clear();
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    isExpired(intent) {
+        if (!intent.expiresAt)
+            return false;
+        return new Date(intent.expiresAt).getTime() < Date.now();
+    }
+    async expireIntent(intent) {
+        if (intent.status !== "completed" &&
+            intent.status !== "cancelled" &&
+            intent.status !== "denied") {
+            intent.status = "cancelled";
+            intent.updatedAt = new Date().toISOString();
+            logger.debug({ intentId: intent.id }, "Intent expired");
+        }
+    }
+    sweepExpired() {
+        let swept = 0;
+        for (const [id, intent] of this.intents) {
+            if (this.isExpired(intent)) {
+                // Remove terminal intents entirely, expire active ones
+                const isTerminal = [
+                    "completed",
+                    "cancelled",
+                    "denied",
+                    "failed",
+                ].includes(intent.status);
+                if (isTerminal) {
+                    this.intents.delete(id);
+                    const indexKey = `${intent.tenantId}:${intent.entityId}`;
+                    this.entityIndex.get(indexKey)?.delete(id);
+                    swept++;
+                }
+                else {
+                    this.expireIntent(intent);
+                    swept++;
+                }
+            }
+        }
+        if (swept > 0) {
+            logger.debug({ swept }, "Expired intents swept");
+        }
+    }
+}
+//# sourceMappingURL=persistent-intent-service.js.map

package/dist/intent/persistent-intent-service.js.map

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

package/dist/intent/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Intent Service Types
+ *
+ * Extracted from intent/index.ts to break circular dependency with
+ * persistent-intent-service.ts.
+ *
+ * @packageDocumentation
+ */
+import type { Intent, ID, IntentStatus } from "../common/types.js";
+/** Action type values (mirrors ActionType const in index.ts) */
+type ActionTypeValue = "read" | "write" | "delete" | "execute" | "communicate" | "transfer";
+/** Data sensitivity values (mirrors DataSensitivity const in index.ts) */
+type DataSensitivityValue = "PUBLIC" | "INTERNAL" | "CONFIDENTIAL" | "RESTRICTED";
+/** Reversibility values (mirrors Reversibility const in index.ts) */
+type ReversibilityValue = "REVERSIBLE" | "PARTIALLY_REVERSIBLE" | "IRREVERSIBLE";
+/**
+ * Intent submission request with canonical fields
+ */
+export interface IntentSubmission {
+    /** Agent/entity making the request */
+    entityId: ID;
+    /** Human-readable goal/action description */
+    goal: string;
+    /** Additional context for evaluation */
+    context: Record<string, unknown>;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Correlation ID for distributed tracing */
+    correlationId?: string;
+    /** Action type category */
+    actionType?: ActionTypeValue;
+    /** Resources this intent accesses/modifies */
+    resourceScope?: string[];
+    /** Data sensitivity level */
+    dataSensitivity?: DataSensitivityValue;
+    /** Whether action can be undone */
+    reversibility?: ReversibilityValue;
+    /** Intent expiration in milliseconds from now */
+    expiresIn?: number;
+    /** Source system identifier */
+    source?: string;
+}
+/**
+ * Options for submitting an intent
+ */
+export interface SubmitOptions {
+    /** Tenant identifier */
+    tenantId: ID;
+    /** Trust snapshot at submission time */
+    trustSnapshot?: Record<string, unknown> | null;
+    /** Current trust level of the entity */
+    trustLevel?: number;
+}
+/**
+ * Interface for intent service implementations
+ *
+ * Implement this interface to create custom intent handling:
+ * - API client for remote Vorion service
+ * - Custom persistence layer
+ * - Testing mocks with specific behaviors
+ */
+export interface IIntentService {
+    submit(submission: IntentSubmission, options: SubmitOptions): Promise<Intent>;
+    get(id: ID, tenantId: ID): Promise<Intent | undefined>;
+    updateStatus(id: ID, tenantId: ID, status: IntentStatus): Promise<Intent | undefined>;
+    listByEntity(entityId: ID, tenantId: ID): Promise<Intent[]>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOnE,gEAAgE;AAChE,KAAK,eAAe,GAChB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,aAAa,GACb,UAAU,CAAC;AAEf,0EAA0E;AAC1E,KAAK,oBAAoB,GACrB,QAAQ,GACR,UAAU,GACV,cAAc,GACd,YAAY,CAAC;AAEjB,qEAAqE;AACrE,KAAK,kBAAkB,GACnB,YAAY,GACZ,sBAAsB,GACtB,cAAc,CAAC;AAMnB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,EAAE,EAAE,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGnC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,mCAAmC;IACnC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,EAAE,EAAE,CAAC;IACb,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,YAAY,CACV,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,EAAE,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/B,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7D"}

package/dist/intent/types.js

@@ -0,0 +1,10 @@
+/**
+ * Intent Service Types
+ *
+ * Extracted from intent/index.ts to break circular dependency with
+ * persistent-intent-service.ts.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/intent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}