sandstream-kit 1.0.0

package/dist/redis-adapter.js.map

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

package/dist/resilience-tests.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Resilience Testing Suite
+ *
+ * Validates system resilience metrics:
+ * - RTO (Recovery Time Objective): <5 minutes
+ * - RPO (Recovery Point Objective): <24 hours
+ * - Failover: Automatic with no data loss
+ * - Retry: Exponential backoff with jitter
+ */
+export interface ResilienceMetrics {
+    rtoSeconds: number;
+    rpoHours: number;
+    failoverAutomatic: boolean;
+    dataLossItems: number;
+    alertDelaySeconds: number;
+    recoveryAttempts: number;
+}
+export interface TestResult {
+    passed: boolean;
+    metric: string;
+    expected: string;
+    actual: string;
+    failureReason?: string;
+}
+export declare class ResilienceTestSuite {
+    private metrics;
+    private results;
+    /**
+     * Test RTO (Recovery Time Objective)
+     * Target: <5 minutes (300 seconds)
+     */
+    testRTO(): TestResult;
+    /**
+     * Test RPO (Recovery Point Objective)
+     * Target: <24 hours
+     */
+    testRPO(): TestResult;
+    /**
+     * Test Automatic Failover
+     * Validates failover happens without manual intervention
+     */
+    testAutomaticFailover(): TestResult;
+    /**
+     * Test Data Loss
+     * Target: Zero data loss
+     */
+    testDataLoss(): TestResult;
+    /**
+     * Test Alert Response Time
+     * Target: Detection within 90 seconds
+     */
+    testAlertResponse(): TestResult;
+    /**
+     * Test Recovery Attempts
+     * Valid: 1-3 attempts (not too quick, not too slow)
+     */
+    testRecoveryAttempts(): TestResult;
+    /**
+     * Run all resilience tests
+     */
+    runAll(): boolean;
+    /**
+     * Generate test report
+     */
+    generateReport(): string;
+    /**
+     * Update metrics from test results
+     */
+    updateMetrics(metrics: Partial<ResilienceMetrics>): void;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): ResilienceMetrics;
+    /**
+     * Get test results
+     */
+    getResults(): TestResult[];
+}
+/**
+ * Exponential Backoff Strategy Validator
+ * Ensures retry logic follows best practices
+ */
+export declare class BackoffValidator {
+    /**
+     * Validate exponential backoff sequence
+     * - First attempt: 1s
+     * - Second attempt: 2s (±jitter)
+     * - Third attempt: 4s (±jitter)
+     * - Max: 32s
+     */
+    static validateBackoff(delays: number[]): boolean;
+    /**
+     * Calculate recommended backoff delay
+     */
+    static calculateBackoff(attempt: number): number;
+}
+/**
+ * Circuit Breaker Pattern Validator
+ * Ensures circuit breaker is configured correctly
+ */
+export declare class CircuitBreakerValidator {
+    private state;
+    private failureCount;
+    private failureThreshold;
+    private successThreshold;
+    private successCount;
+    /**
+     * Record request result
+     */
+    recordResult(success: boolean): void;
+    /**
+     * Check if requests should be allowed
+     */
+    isAllowed(): boolean;
+    /**
+     * Get current state
+     */
+    getState(): string;
+}
+export default ResilienceTestSuite;

package/dist/resilience-tests.js

@@ -0,0 +1,293 @@
+/**
+ * Resilience Testing Suite
+ *
+ * Validates system resilience metrics:
+ * - RTO (Recovery Time Objective): <5 minutes
+ * - RPO (Recovery Point Objective): <24 hours
+ * - Failover: Automatic with no data loss
+ * - Retry: Exponential backoff with jitter
+ */
+export class ResilienceTestSuite {
+    metrics = {
+        rtoSeconds: 0,
+        rpoHours: 0,
+        failoverAutomatic: false,
+        dataLossItems: 0,
+        alertDelaySeconds: 0,
+        recoveryAttempts: 0,
+    };
+    results = [];
+    /**
+     * Test RTO (Recovery Time Objective)
+     * Target: <5 minutes (300 seconds)
+     */
+    testRTO() {
+        const RTOTarget = 300;
+        const passed = this.metrics.rtoSeconds <= RTOTarget;
+        const result = {
+            passed,
+            metric: 'RTO',
+            expected: `<${RTOTarget}s`,
+            actual: `${this.metrics.rtoSeconds}s`,
+            failureReason: passed ? undefined : `RTO exceeded target by ${this.metrics.rtoSeconds - RTOTarget}s`,
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Test RPO (Recovery Point Objective)
+     * Target: <24 hours
+     */
+    testRPO() {
+        const RPOTarget = 24;
+        const passed = this.metrics.rpoHours <= RPOTarget;
+        const result = {
+            passed,
+            metric: 'RPO',
+            expected: `<${RPOTarget}h`,
+            actual: `${this.metrics.rpoHours}h`,
+            failureReason: passed ? undefined : `RPO exceeded target by ${this.metrics.rpoHours - RPOTarget}h`,
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Test Automatic Failover
+     * Validates failover happens without manual intervention
+     */
+    testAutomaticFailover() {
+        const passed = this.metrics.failoverAutomatic;
+        const result = {
+            passed,
+            metric: 'Automatic Failover',
+            expected: 'true',
+            actual: this.metrics.failoverAutomatic.toString(),
+            failureReason: passed ? undefined : 'Failover requires manual intervention',
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Test Data Loss
+     * Target: Zero data loss
+     */
+    testDataLoss() {
+        const passed = this.metrics.dataLossItems === 0;
+        const result = {
+            passed,
+            metric: 'Data Loss',
+            expected: '0 items',
+            actual: `${this.metrics.dataLossItems} items`,
+            failureReason: passed ? undefined : `Data loss detected: ${this.metrics.dataLossItems} items`,
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Test Alert Response Time
+     * Target: Detection within 90 seconds
+     */
+    testAlertResponse() {
+        const AlertTarget = 90;
+        const passed = this.metrics.alertDelaySeconds <= AlertTarget;
+        const result = {
+            passed,
+            metric: 'Alert Detection',
+            expected: `<${AlertTarget}s`,
+            actual: `${this.metrics.alertDelaySeconds}s`,
+            failureReason: passed ? undefined : `Alert delayed by ${this.metrics.alertDelaySeconds - AlertTarget}s`,
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Test Recovery Attempts
+     * Valid: 1-3 attempts (not too quick, not too slow)
+     */
+    testRecoveryAttempts() {
+        const minAttempts = 1;
+        const maxAttempts = 3;
+        const passed = this.metrics.recoveryAttempts >= minAttempts && this.metrics.recoveryAttempts <= maxAttempts;
+        const result = {
+            passed,
+            metric: 'Recovery Attempts',
+            expected: `${minAttempts}-${maxAttempts}`,
+            actual: `${this.metrics.recoveryAttempts}`,
+            failureReason: passed ? undefined : `Recovery attempts out of range`,
+        };
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Run all resilience tests
+     */
+    runAll() {
+        this.testRTO();
+        this.testRPO();
+        this.testAutomaticFailover();
+        this.testDataLoss();
+        this.testAlertResponse();
+        this.testRecoveryAttempts();
+        return this.results.every((r) => r.passed);
+    }
+    /**
+     * Generate test report
+     */
+    generateReport() {
+        const passed = this.results.filter((r) => r.passed).length;
+        const total = this.results.length;
+        const passRate = ((passed / total) * 100).toFixed(1);
+        let report = `
+=== Resilience Test Report ===
+Date: ${new Date().toISOString()}
+Results: ${passed}/${total} passed (${passRate}%)
+
+`;
+        for (const result of this.results) {
+            const status = result.passed ? '✅' : '❌';
+            report += `${status} ${result.metric}: ${result.actual} (expected: ${result.expected})`;
+            if (result.failureReason) {
+                report += `\n   Reason: ${result.failureReason}`;
+            }
+            report += '\n';
+        }
+        report += `
+Metrics Summary:
+- RTO: ${this.metrics.rtoSeconds}s (target: <300s)
+- RPO: ${this.metrics.rpoHours}h (target: <24h)
+- Failover: ${this.metrics.failoverAutomatic ? 'Automatic' : 'Manual'}
+- Data Loss: ${this.metrics.dataLossItems} items (target: 0)
+- Alert Delay: ${this.metrics.alertDelaySeconds}s (target: <90s)
+- Recovery Attempts: ${this.metrics.recoveryAttempts} (target: 1-3)
+
+Overall: ${passed === total ? 'PASS' : 'FAIL'}
+`;
+        return report;
+    }
+    /**
+     * Update metrics from test results
+     */
+    updateMetrics(metrics) {
+        this.metrics = { ...this.metrics, ...metrics };
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        return this.metrics;
+    }
+    /**
+     * Get test results
+     */
+    getResults() {
+        return this.results;
+    }
+}
+/**
+ * Exponential Backoff Strategy Validator
+ * Ensures retry logic follows best practices
+ */
+export class BackoffValidator {
+    /**
+     * Validate exponential backoff sequence
+     * - First attempt: 1s
+     * - Second attempt: 2s (±jitter)
+     * - Third attempt: 4s (±jitter)
+     * - Max: 32s
+     */
+    static validateBackoff(delays) {
+        const minBackoffs = [1000, 2000, 4000];
+        const maxBackoffs = [1100, 2200, 4400];
+        const maxDelay = 32000;
+        if (delays.length === 0) {
+            return false;
+        }
+        for (let i = 0; i < Math.min(delays.length, 3); i++) {
+            const delay = delays[i];
+            if (i < 3) {
+                // Check exponential sequence with jitter tolerance (10%)
+                if (delay < minBackoffs[i] || delay > maxBackoffs[i]) {
+                    console.error(`Delay ${i}: ${delay}ms not in range [${minBackoffs[i]}, ${maxBackoffs[i]}]`);
+                    return false;
+                }
+            }
+            if (delay > maxDelay) {
+                console.error(`Delay exceeds max: ${delay}ms > ${maxDelay}ms`);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Calculate recommended backoff delay
+     */
+    static calculateBackoff(attempt) {
+        const minBackoff = 1000;
+        const maxBackoff = 32000;
+        const exponential = Math.min(maxBackoff, minBackoff * Math.pow(2, attempt));
+        const jitter = exponential * 0.1 * (Math.random() - 0.5) * 2;
+        return Math.round(exponential + jitter);
+    }
+}
+/**
+ * Circuit Breaker Pattern Validator
+ * Ensures circuit breaker is configured correctly
+ */
+export class CircuitBreakerValidator {
+    state = 'closed';
+    failureCount = 0;
+    failureThreshold = 5;
+    successThreshold = 2;
+    successCount = 0;
+    /**
+     * Record request result
+     */
+    recordResult(success) {
+        if (this.state === 'closed') {
+            if (success) {
+                this.failureCount = 0;
+            }
+            else {
+                this.failureCount++;
+                if (this.failureCount >= this.failureThreshold) {
+                    this.state = 'open';
+                    console.log('Circuit breaker opened');
+                }
+            }
+        }
+        else if (this.state === 'open') {
+            // After timeout, move to half-open
+            this.state = 'half-open';
+            this.successCount = 0;
+            console.log('Circuit breaker half-open');
+        }
+        else if (this.state === 'half-open') {
+            if (success) {
+                this.successCount++;
+                if (this.successCount >= this.successThreshold) {
+                    this.state = 'closed';
+                    this.failureCount = 0;
+                    console.log('Circuit breaker closed');
+                }
+            }
+            else {
+                this.state = 'open';
+                console.log('Circuit breaker reopened');
+            }
+        }
+    }
+    /**
+     * Check if requests should be allowed
+     */
+    isAllowed() {
+        return this.state !== 'open';
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+}
+export default ResilienceTestSuite;
+//# sourceMappingURL=resilience-tests.js.map

package/dist/resilience-tests.js.map

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

package/dist/revocation.d.ts

@@ -0,0 +1,22 @@
+import type { GovernanceConfig } from "./config.js";
+export interface RevocationStatus {
+    revoked: boolean;
+    reason?: string;
+    timestamp?: string;
+}
+/**
+ * Check if agent access has been revoked
+ */
+export declare function checkRevocationStatus(config: GovernanceConfig | undefined): Promise<boolean>;
+/**
+ * Force a fresh revocation check (ignore cache)
+ */
+export declare function forceRevocationCheck(config: GovernanceConfig | undefined): Promise<RevocationStatus>;
+/**
+ * Clear local secrets and caches (called when revocation detected)
+ */
+export declare function handleRevocation(config: GovernanceConfig | undefined): Promise<void>;
+/**
+ * Get formatted revocation status for display
+ */
+export declare function formatRevocationStatus(status: RevocationStatus): string;

package/dist/revocation.js

@@ -0,0 +1,100 @@
+import { mergeGovernanceConfig } from "./governance.js";
+let lastRevocationCheck = 0;
+let cachedRevocationStatus = null;
+/**
+ * Check if agent access has been revoked
+ */
+export async function checkRevocationStatus(config) {
+    const fullConfig = mergeGovernanceConfig(config);
+    if (!fullConfig.revocation.enabled) {
+        return false;
+    }
+    // Use cached status if recent enough
+    const now = Date.now();
+    const checkInterval = (fullConfig.revocation.check_interval || 300) * 1000;
+    if (cachedRevocationStatus &&
+        now - lastRevocationCheck < checkInterval) {
+        return cachedRevocationStatus.revoked;
+    }
+    // Check revocation endpoint
+    const status = await fetchRevocationStatus(fullConfig);
+    cachedRevocationStatus = status;
+    lastRevocationCheck = now;
+    return status.revoked;
+}
+/**
+ * Fetch revocation status from endpoint
+ */
+async function fetchRevocationStatus(config) {
+    if (!config.revocation.revocation_endpoint || !config.agent.id) {
+        return { revoked: false };
+    }
+    try {
+        const endpoint = config.revocation.revocation_endpoint.replace("{agent_id}", config.agent.id);
+        const response = await fetch(endpoint, {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            // If endpoint is unreachable, assume not revoked
+            console.warn(`Revocation check failed: ${response.statusText}`);
+            return { revoked: false };
+        }
+        const data = (await response.json());
+        return data;
+    }
+    catch (error) {
+        // If endpoint is unreachable, assume not revoked
+        console.warn(`Revocation check failed: ${error}`);
+        return { revoked: false };
+    }
+}
+/**
+ * Force a fresh revocation check (ignore cache)
+ */
+export async function forceRevocationCheck(config) {
+    const fullConfig = mergeGovernanceConfig(config);
+    if (!fullConfig.revocation.enabled) {
+        return { revoked: false };
+    }
+    const status = await fetchRevocationStatus(fullConfig);
+    cachedRevocationStatus = status;
+    lastRevocationCheck = Date.now();
+    return status;
+}
+/**
+ * Clear local secrets and caches (called when revocation detected)
+ */
+export async function handleRevocation(config) {
+    console.error("\n" + "=".repeat(80));
+    console.error("ACCESS REVOKED");
+    console.error("=".repeat(80));
+    console.error("Your agent access has been revoked.");
+    console.error("All operations are blocked.");
+    console.error("Please contact the system administrator.");
+    console.error("=".repeat(80) + "\n");
+    // Clear local cache
+    cachedRevocationStatus = null;
+    lastRevocationCheck = 0;
+    // Exit process
+    process.exit(1);
+}
+/**
+ * Get formatted revocation status for display
+ */
+export function formatRevocationStatus(status) {
+    if (!status.revoked) {
+        return "✓ Access active";
+    }
+    let message = "✗ Access revoked";
+    if (status.reason) {
+        message += ` - ${status.reason}`;
+    }
+    if (status.timestamp) {
+        message += ` (${new Date(status.timestamp).toLocaleString()})`;
+    }
+    return message;
+}
+//# sourceMappingURL=revocation.js.map

package/dist/revocation.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,21 @@
+export interface RunOptions {
+    /** Command and arguments to execute */
+    commandArgs: string[];
+    /** Project directory (defaults to cwd) */
+    cwd?: string;
+    /** Environment variable overrides (e.g., from .kit.toml) */
+    envOverrides?: Record<string, string>;
+    /** Inherit parent process environment */
+    inheritEnv?: boolean;
+}
+export interface RunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Execute a command with project environment variables loaded.
+ * Loads .env.local and merges with optional env overrides.
+ * The subprocess inherits parent process env + .env.local + overrides.
+ */
+export declare function executeCommand(opts: RunOptions): Promise<RunResult>;

package/dist/run.js

@@ -0,0 +1,80 @@
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+/**
+ * Execute a command with project environment variables loaded.
+ * Loads .env.local and merges with optional env overrides.
+ * The subprocess inherits parent process env + .env.local + overrides.
+ */
+export async function executeCommand(opts) {
+    const { commandArgs, cwd = process.cwd(), envOverrides = {}, inheritEnv = true } = opts;
+    if (commandArgs.length === 0) {
+        throw new Error("No command provided");
+    }
+    // Build environment
+    let env = inheritEnv ? { ...process.env } : {};
+    // Load .env.local if it exists
+    const envPath = resolve(cwd, ".env.local");
+    try {
+        const envContent = await readFile(envPath, "utf-8");
+        const lines = envContent.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eqIndex = trimmed.indexOf("=");
+            if (eqIndex === -1)
+                continue;
+            const key = trimmed.substring(0, eqIndex);
+            const value = trimmed.substring(eqIndex + 1);
+            env[key] = value;
+        }
+    }
+    catch {
+        // .env.local not found or unreadable — continue with existing env
+    }
+    // Apply overrides
+    for (const [key, value] of Object.entries(envOverrides)) {
+        env[key] = value;
+    }
+    // Execute the command
+    return new Promise((resolve) => {
+        const [command, ...args] = commandArgs;
+        const child = spawn(command, args, {
+            cwd,
+            env,
+            stdio: ["inherit", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        if (child.stdout) {
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+                process.stdout.write(chunk);
+            });
+        }
+        if (child.stderr) {
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString();
+                process.stderr.write(chunk);
+            });
+        }
+        child.on("close", (exitCode) => {
+            resolve({
+                exitCode: exitCode ?? 1,
+                stdout,
+                stderr,
+            });
+        });
+        child.on("error", (err) => {
+            // Command not found or spawn error
+            console.error(`Failed to execute command: ${err.message}`);
+            resolve({
+                exitCode: 127,
+                stdout: "",
+                stderr: err.message,
+            });
+        });
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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