agent-relay 1.1.0 → 1.2.3

package/dist/policy/cloud-policy-fetcher.js

@@ -0,0 +1,64 @@
+/**
+ * Cloud Policy Fetcher
+ *
+ * Fetches workspace agent policies from the cloud API.
+ * Used by workspace containers to get their policy configuration.
+ */
+/**
+ * Create a cloud policy fetcher for workspace containers
+ */
+export function createCloudPolicyFetcher() {
+    const cloudApiUrl = process.env.CLOUD_API_URL;
+    const workspaceId = process.env.WORKSPACE_ID;
+    const workspaceToken = process.env.WORKSPACE_TOKEN;
+    if (!cloudApiUrl || !workspaceId) {
+        return null;
+    }
+    return {
+        async getWorkspacePolicy(requestedWorkspaceId) {
+            // Only allow fetching policy for this workspace
+            if (requestedWorkspaceId !== workspaceId) {
+                console.warn(`[policy-fetcher] Attempted to fetch policy for different workspace: ${requestedWorkspaceId}`);
+                return null;
+            }
+            try {
+                const url = `${cloudApiUrl}/api/policy/${workspaceId}/internal`;
+                const headers = {
+                    'Content-Type': 'application/json',
+                };
+                // Add auth header if we have a workspace token
+                if (workspaceToken) {
+                    headers['Authorization'] = `Bearer ${workspaceToken}`;
+                }
+                const response = await fetch(url, { headers });
+                if (!response.ok) {
+                    console.error(`[policy-fetcher] Failed to fetch policy: ${response.status} ${response.statusText}`);
+                    return null;
+                }
+                const data = await response.json();
+                // Convert API response to WorkspacePolicy
+                const policy = {
+                    defaultPolicy: data.defaultPolicy ?? {
+                        name: '*',
+                        maxSpawns: 10,
+                        rateLimit: 60,
+                        canBeSpawned: true,
+                    },
+                    agents: data.agents ?? [],
+                    settings: data.settings ?? {
+                        requireExplicitAgents: false,
+                        auditEnabled: true,
+                        maxTotalAgents: 50,
+                    },
+                };
+                console.log(`[policy-fetcher] Fetched policy for workspace ${workspaceId}: ${policy.agents.length} agent rules`);
+                return policy;
+            }
+            catch (error) {
+                console.error('[policy-fetcher] Error fetching policy:', error);
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=cloud-policy-fetcher.js.map

package/dist/resiliency/crash-insights.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Crash Insights Service
+ *
+ * Captures and analyzes agent crashes to provide actionable insights:
+ * - Memory state at crash time
+ * - Crash history and patterns
+ * - Root cause analysis
+ * - Recommendations for prevention
+ */
+import { EventEmitter } from 'events';
+import { AgentMemoryMonitor, CrashMemoryContext } from './memory-monitor.js';
+export interface CrashRecord {
+    id: string;
+    agentName: string;
+    pid: number;
+    crashTime: Date;
+    exitCode: number | null;
+    signal: string | null;
+    reason: string;
+    memoryContext: CrashMemoryContext;
+    stackTrace?: string;
+    lastOutput?: string;
+    environment: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+        systemMemory: {
+            total: number;
+            free: number;
+        };
+        uptime: number;
+    };
+    analysis: CrashAnalysis;
+}
+export interface CrashAnalysis {
+    likelyCause: 'oom' | 'memory_leak' | 'sudden_spike' | 'signal' | 'error' | 'unknown';
+    confidence: 'high' | 'medium' | 'low';
+    summary: string;
+    details: string[];
+    recommendations: string[];
+    relatedCrashes: string[];
+}
+export interface CrashPattern {
+    pattern: string;
+    occurrences: number;
+    lastSeen: Date;
+    affectedAgents: string[];
+    avgMemoryAtCrash: number;
+    commonCause: string;
+}
+export interface CrashStats {
+    totalCrashes: number;
+    crashesByAgent: Record<string, number>;
+    crashesByCause: Record<string, number>;
+    avgTimeBetweenCrashes: number;
+    mostCrashProne: {
+        agent: string;
+        count: number;
+    } | null;
+    recentCrashes: CrashRecord[];
+    patterns: CrashPattern[];
+}
+export declare class CrashInsightsService extends EventEmitter {
+    private crashes;
+    private memoryMonitor;
+    private persistPath;
+    private maxCrashHistory;
+    constructor(memoryMonitor?: AgentMemoryMonitor);
+    /**
+     * Set the memory monitor instance
+     */
+    setMemoryMonitor(monitor: AgentMemoryMonitor): void;
+    /**
+     * Record a crash event
+     */
+    recordCrash(params: {
+        agentName: string;
+        pid: number;
+        exitCode: number | null;
+        signal: string | null;
+        reason: string;
+        stackTrace?: string;
+        lastOutput?: string;
+    }): CrashRecord;
+    /**
+     * Get crash history for an agent
+     */
+    getCrashHistory(agentName?: string, limit?: number): CrashRecord[];
+    /**
+     * Get a specific crash record
+     */
+    getCrash(id: string): CrashRecord | undefined;
+    /**
+     * Get crash statistics
+     */
+    getStats(): CrashStats;
+    /**
+     * Get insights and recommendations
+     */
+    getInsights(): {
+        summary: string;
+        topIssues: Array<{
+            issue: string;
+            severity: 'high' | 'medium' | 'low';
+            recommendation: string;
+        }>;
+        healthScore: number;
+        trends: Array<{
+            metric: string;
+            trend: 'improving' | 'stable' | 'degrading';
+            details: string;
+        }>;
+    };
+    /**
+     * Analyze a crash and determine likely cause
+     */
+    private analyzeCrash;
+    /**
+     * Find related crashes
+     */
+    private findRelatedCrashes;
+    /**
+     * Detect crash patterns
+     */
+    private detectPatterns;
+    /**
+     * Generate crash summary
+     */
+    private generateCrashSummary;
+    /**
+     * Generate overall summary
+     */
+    private generateSummary;
+    /**
+     * Create empty memory context when no monitor available
+     */
+    private createEmptyMemoryContext;
+    /**
+     * Load crashes from disk
+     */
+    private loadCrashes;
+    /**
+     * Save crashes to disk
+     */
+    private saveCrashes;
+    /**
+     * Clear all crash history
+     */
+    clear(): void;
+    /**
+     * Structured logging
+     */
+    private log;
+}
+export declare function getCrashInsights(memoryMonitor?: AgentMemoryMonitor): CrashInsightsService;
+//# sourceMappingURL=crash-insights.d.ts.map