sandstream-kit 1.0.0

package/dist/agent-governance-service.d.ts

@@ -0,0 +1,101 @@
+import type { GovernancePolicy, AgentPermission, AgentSecurityProfile, GovernanceAuditLog, RateLimitPolicy, ResourceQuota, GovernanceMetrics, PolicyEvaluation, PolicyType, ActionType, PermissionLevel } from "./agent-governance-model.js";
+/**
+ * Create governance policy
+ */
+export declare function createGovernancePolicy(team_id: string, policy_name: string, policy_type: PolicyType, created_by: string, description?: string): {
+    policy: GovernancePolicy;
+    error?: string;
+};
+/**
+ * Add rule to policy
+ */
+export declare function addPolicyRule(team_id: string, policy_id: string, condition: string, action: string, consequence?: string): {
+    policy: GovernancePolicy;
+    error?: string;
+};
+/**
+ * Activate policy
+ */
+export declare function activatePolicy(team_id: string, policy_id: string): {
+    policy: GovernancePolicy;
+    error?: string;
+};
+/**
+ * Create security profile for agent
+ */
+export declare function createSecurityProfile(team_id: string, agent_id: string, agent_type: string): {
+    profile: AgentSecurityProfile;
+    error?: string;
+};
+/**
+ * Grant permission to agent
+ */
+export declare function grantPermission(team_id: string, agent_id: string, resource_type: string, action: ActionType, permission_level: PermissionLevel, granted_by: string, resource_id?: string, expires_at?: string): {
+    permission: AgentPermission;
+    error?: string;
+};
+/**
+ * Revoke permission
+ */
+export declare function revokePermission(team_id: string, permission_id: string): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Evaluate policy for agent action
+ */
+export declare function evaluatePolicy(team_id: string, policy_id: string, agent_id: string, action: ActionType, resource_type: string, resource_id?: string): {
+    evaluation: PolicyEvaluation;
+    error?: string;
+};
+/**
+ * Log audit event
+ */
+export declare function logAuditEvent(team_id: string, agent_id: string | undefined, status: "allowed" | "denied" | "warning", action: ActionType, resource_type: string, resource_id?: string, policy_id?: string): {
+    log: GovernanceAuditLog;
+};
+/**
+ * Set rate limit for agent
+ */
+export declare function setRateLimit(team_id: string, agent_id: string | undefined, resource_type: string, requests_per_minute: number, requests_per_hour: number): {
+    rateLimit: RateLimitPolicy;
+    error?: string;
+};
+/**
+ * Set resource quota for agent
+ */
+export declare function setResourceQuota(team_id: string, agent_id: string | undefined, resource_type: string, limit: number, unit: string, period: "hour" | "day" | "month"): {
+    quota: ResourceQuota;
+    error?: string;
+};
+/**
+ * Get security profile
+ */
+export declare function getSecurityProfile(team_id: string, agent_id: string): {
+    profile: AgentSecurityProfile | null;
+    error?: string;
+};
+/**
+ * Get audit logs for period
+ */
+export declare function getAuditLogs(team_id: string, agent_id?: string, limit?: number, offset?: number): {
+    logs: GovernanceAuditLog[];
+    total: number;
+};
+/**
+ * Get governance metrics
+ */
+export declare function getGovernanceMetrics(team_id: string): GovernanceMetrics;
+/**
+ * Update agent trust score
+ */
+export declare function updateTrustScore(team_id: string, agent_id: string, score_adjustment: number): {
+    profile: AgentSecurityProfile;
+    error?: string;
+};
+/**
+ * List all policies
+ */
+export declare function listPolicies(team_id: string): {
+    policies: GovernancePolicy[];
+};

package/dist/agent-governance-service.js

@@ -0,0 +1,319 @@
+import { randomUUID } from "node:crypto";
+const policies = new Map();
+const permissions = new Map();
+const securityProfiles = new Map();
+const auditLogs = new Map();
+const rateLimits = new Map();
+const quotas = new Map();
+const evaluations = new Map();
+/**
+ * Create governance policy
+ */
+export function createGovernancePolicy(team_id, policy_name, policy_type, created_by, description) {
+    const policy = {
+        id: `policy_${randomUUID()}`,
+        team_id,
+        policy_name,
+        description: description || "",
+        policy_type,
+        status: "draft",
+        rules: [],
+        priority: 50,
+        enforcement_enabled: false,
+        created_by,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    policies.set(policy.id, policy);
+    return { policy };
+}
+/**
+ * Add rule to policy
+ */
+export function addPolicyRule(team_id, policy_id, condition, action, consequence) {
+    const policy = policies.get(policy_id);
+    if (!policy || policy.team_id !== team_id) {
+        return { policy: {}, error: "Policy not found" };
+    }
+    policy.rules.push({ condition, action, consequence });
+    policy.updated_at = new Date().toISOString();
+    return { policy };
+}
+/**
+ * Activate policy
+ */
+export function activatePolicy(team_id, policy_id) {
+    const policy = policies.get(policy_id);
+    if (!policy || policy.team_id !== team_id) {
+        return { policy: {}, error: "Policy not found" };
+    }
+    if (policy.rules.length === 0) {
+        return { policy: {}, error: "Policy has no rules" };
+    }
+    policy.status = "active";
+    policy.enforcement_enabled = true;
+    policy.updated_at = new Date().toISOString();
+    return { policy };
+}
+/**
+ * Create security profile for agent
+ */
+export function createSecurityProfile(team_id, agent_id, agent_type) {
+    const profile = {
+        id: `profile_${randomUUID()}`,
+        team_id,
+        agent_id,
+        agent_type,
+        risk_level: "medium",
+        trust_score: 50,
+        permissions: [],
+        violations_count: 0,
+        sandboxed: false,
+        resource_limits: {
+            max_concurrent_workflows: 5,
+            max_api_calls_per_hour: 1000,
+            max_memory_mb: 512,
+            max_storage_gb: 10,
+        },
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    securityProfiles.set(profile.id, profile);
+    return { profile };
+}
+/**
+ * Grant permission to agent
+ */
+export function grantPermission(team_id, agent_id, resource_type, action, permission_level, granted_by, resource_id, expires_at) {
+    const permission = {
+        id: `perm_${randomUUID()}`,
+        team_id,
+        agent_id,
+        resource_type,
+        resource_id,
+        action,
+        permission_level,
+        granted_by,
+        granted_at: new Date().toISOString(),
+        expires_at,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    permissions.set(permission.id, permission);
+    // Update security profile
+    const profiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id && p.agent_id === agent_id);
+    if (profiles.length > 0) {
+        profiles[0].permissions.push(permission);
+    }
+    return { permission };
+}
+/**
+ * Revoke permission
+ */
+export function revokePermission(team_id, permission_id) {
+    const permission = permissions.get(permission_id);
+    if (!permission || permission.team_id !== team_id) {
+        return { success: false, error: "Permission not found" };
+    }
+    permissions.delete(permission_id);
+    // Update security profile
+    const profiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id && p.agent_id === permission.agent_id);
+    if (profiles.length > 0) {
+        profiles[0].permissions = profiles[0].permissions.filter((p) => p.id !== permission_id);
+    }
+    return { success: true };
+}
+/**
+ * Evaluate policy for agent action
+ */
+export function evaluatePolicy(team_id, policy_id, agent_id, action, resource_type, resource_id) {
+    const policy = policies.get(policy_id);
+    if (!policy || policy.team_id !== team_id) {
+        return { evaluation: {}, error: "Policy not found" };
+    }
+    if (!policy.enforcement_enabled) {
+        return { evaluation: {}, error: "Policy not active" };
+    }
+    // Check if agent is in target list
+    if (policy.target_agents && !policy.target_agents.includes(agent_id) && !policy.target_agents.includes("*")) {
+        return { evaluation: {}, error: "Agent not subject to policy" };
+    }
+    // Evaluate rules (check if any rule applies)
+    let allowed = true;
+    const matchedRules = policy.rules.filter((r) => r.action.includes(action) || r.action === "allow");
+    if (matchedRules.length > 0) {
+        const denialRule = matchedRules.find((r) => r.consequence === "deny");
+        allowed = !denialRule;
+    }
+    else {
+        // Default to allow if no specific rules match
+        allowed = true;
+    }
+    const evaluation = {
+        id: `eval_${randomUUID()}`,
+        team_id,
+        policy_id,
+        agent_id,
+        action,
+        resource_type,
+        allowed,
+        reason: allowed ? "Policy allowed action" : "Policy denied action",
+        timestamp: new Date().toISOString(),
+        created_at: new Date().toISOString(),
+    };
+    evaluations.set(evaluation.id, evaluation);
+    // Log to audit
+    logAuditEvent(team_id, agent_id, allowed ? "allowed" : "denied", action, resource_type, resource_id, policy_id);
+    return { evaluation };
+}
+/**
+ * Log audit event
+ */
+export function logAuditEvent(team_id, agent_id, status, action, resource_type, resource_id, policy_id) {
+    const log = {
+        id: `audit_${randomUUID()}`,
+        team_id,
+        agent_id,
+        action: action,
+        resource_type,
+        resource_id,
+        details: {},
+        severity: status === "denied" ? "critical" : "info",
+        status,
+        policy_evaluated: policy_id,
+        timestamp: new Date().toISOString(),
+        created_at: new Date().toISOString(),
+    };
+    auditLogs.set(log.id, log);
+    // Update security profile violation count if denied
+    if (status === "denied" && agent_id) {
+        const profiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id && p.agent_id === agent_id);
+        if (profiles.length > 0) {
+            profiles[0].violations_count += 1;
+            profiles[0].last_violation = new Date().toISOString();
+        }
+    }
+    return { log };
+}
+/**
+ * Set rate limit for agent
+ */
+export function setRateLimit(team_id, agent_id, resource_type, requests_per_minute, requests_per_hour) {
+    const rateLimit = {
+        id: `ratelimit_${randomUUID()}`,
+        team_id,
+        agent_id,
+        resource_type,
+        requests_per_minute,
+        requests_per_hour,
+        requests_per_day: requests_per_hour * 24,
+        burst_limit: Math.ceil(requests_per_minute * 1.5),
+        enabled: true,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    rateLimits.set(rateLimit.id, rateLimit);
+    return { rateLimit };
+}
+/**
+ * Set resource quota for agent
+ */
+export function setResourceQuota(team_id, agent_id, resource_type, limit, unit, period) {
+    const quota = {
+        id: `quota_${randomUUID()}`,
+        team_id,
+        agent_id,
+        resource_type,
+        limit,
+        unit,
+        period,
+        current_usage: 0,
+        warning_threshold_percent: 80,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    quotas.set(quota.id, quota);
+    return { quota };
+}
+/**
+ * Get security profile
+ */
+export function getSecurityProfile(team_id, agent_id) {
+    const profiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id && p.agent_id === agent_id);
+    if (profiles.length === 0) {
+        return { profile: null, error: "Security profile not found" };
+    }
+    return { profile: profiles[0] };
+}
+/**
+ * Get audit logs for period
+ */
+export function getAuditLogs(team_id, agent_id, limit = 100, offset = 0) {
+    let filtered = Array.from(auditLogs.values()).filter((log) => log.team_id === team_id);
+    if (agent_id) {
+        filtered = filtered.filter((log) => log.agent_id === agent_id);
+    }
+    // Sort by timestamp descending
+    filtered.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    const results = filtered.slice(offset, offset + limit);
+    return { logs: results, total: filtered.length };
+}
+/**
+ * Get governance metrics
+ */
+export function getGovernanceMetrics(team_id) {
+    const teamPolicies = Array.from(policies.values()).filter((p) => p.team_id === team_id);
+    const activePolicies = teamPolicies.filter((p) => p.status === "active").length;
+    const teamPermissions = Array.from(permissions.values()).filter((p) => p.team_id === team_id);
+    const teamProfiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id);
+    const profilesWithViolations = teamProfiles.filter((p) => p.violations_count > 0).length;
+    const avgTrust = teamProfiles.length > 0
+        ? teamProfiles.reduce((sum, p) => sum + p.trust_score, 0) / teamProfiles.length
+        : 0;
+    const teamLogs = Array.from(auditLogs.values()).filter((log) => log.team_id === team_id);
+    const criticalLogs = teamLogs.filter((log) => log.severity === "critical").length;
+    const deniedLogs = teamLogs.filter((log) => log.status === "denied").length;
+    const violationRate = teamLogs.length > 0 ? (deniedLogs / teamLogs.length) * 100 : 0;
+    return {
+        total_policies: teamPolicies.length,
+        active_policies: activePolicies,
+        total_permissions: teamPermissions.length,
+        agents_with_violations: profilesWithViolations,
+        total_audit_events: teamLogs.length,
+        critical_events_count: criticalLogs,
+        average_trust_score: avgTrust,
+        policy_violation_rate_percent: violationRate,
+        average_response_time_ms: 45,
+    };
+}
+/**
+ * Update agent trust score
+ */
+export function updateTrustScore(team_id, agent_id, score_adjustment) {
+    const profiles = Array.from(securityProfiles.values()).filter((p) => p.team_id === team_id && p.agent_id === agent_id);
+    if (profiles.length === 0) {
+        return { profile: {}, error: "Security profile not found" };
+    }
+    const profile = profiles[0];
+    profile.trust_score = Math.max(0, Math.min(100, profile.trust_score + score_adjustment));
+    profile.updated_at = new Date().toISOString();
+    // Adjust risk level based on trust score
+    if (profile.trust_score >= 80) {
+        profile.risk_level = "low";
+    }
+    else if (profile.trust_score >= 50) {
+        profile.risk_level = "medium";
+    }
+    else {
+        profile.risk_level = "high";
+    }
+    return { profile };
+}
+/**
+ * List all policies
+ */
+export function listPolicies(team_id) {
+    const teamPolicies = Array.from(policies.values()).filter((p) => p.team_id === team_id);
+    return { policies: teamPolicies };
+}
+//# sourceMappingURL=agent-governance-service.js.map

package/dist/agent-governance-service.js.map

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

package/dist/alert-rules-engine.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Alert rules engine
+ * Evaluates conditions against event stream and triggers actions
+ */
+import { EventStream, StreamEvent } from "./event-stream.js";
+export type AlertMetric = "error_rate" | "response_time" | "downloads" | "revenue" | "sla_breach" | "payout_delay" | "abuse_score";
+export type AlertOperator = ">" | "<" | "==" | "!=" | "anomaly";
+export type AlertAggregation = "avg" | "max" | "min" | "sum" | "count";
+export type AlertSeverity = "low" | "medium" | "high" | "critical";
+export type AlertActionType = "notify" | "alert" | "escalate" | "webhook";
+export interface AlertAction {
+    type: AlertActionType;
+    target: string;
+    severity: AlertSeverity;
+}
+export interface AlertCondition {
+    metric: AlertMetric;
+    operator: AlertOperator;
+    threshold: number;
+    window: number;
+    aggregation: AlertAggregation;
+}
+export interface AlertRule {
+    id: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    condition: AlertCondition;
+    actions: AlertAction[];
+    createdAt: string;
+    updatedAt: string;
+    evaluatedAt?: string;
+    lastTriggered?: string;
+    acknowledgedUntil?: number;
+}
+export interface AlertTriggerEvent {
+    ruleId: string;
+    triggeredAt: number;
+    value: number;
+    threshold: number;
+    window: number;
+    breachEvents: StreamEvent[];
+}
+export declare class AlertRulesEngine {
+    private rules;
+    private history;
+    private stream;
+    private onTrigger?;
+    private maxHistorySize;
+    constructor(stream: EventStream);
+    /**
+     * Add or update alert rule
+     */
+    addRule(rule: Omit<AlertRule, "id" | "createdAt" | "updatedAt">): AlertRule;
+    /**
+     * Remove rule by ID
+     */
+    removeRule(ruleId: string): boolean;
+    /**
+     * Get rule by ID
+     */
+    getRule(ruleId: string): AlertRule | undefined;
+    /**
+     * Get all rules
+     */
+    getAllRules(): AlertRule[];
+    /**
+     * Get active (non-acknowledged) rules
+     */
+    getActiveAlerts(authorId?: string): AlertRule[];
+    /**
+     * Evaluate rule against stream events
+     */
+    evaluateRule(rule: AlertRule): {
+        triggered: boolean;
+        value: number;
+    };
+    /**
+     * Evaluate all rules and trigger actions
+     */
+    evaluateAll(): Promise<AlertTriggerEvent[]>;
+    /**
+     * Acknowledge alert to suppress duplicates
+     */
+    acknowledgeAlert(ruleId: string, suppressMinutes?: number): void;
+    /**
+     * Get alert trigger history
+     */
+    getHistory(ruleId?: string, limit?: number, offset?: number): AlertTriggerEvent[];
+    /**
+     * Clear history
+     */
+    clearHistory(): void;
+    /**
+     * Set trigger callback
+     */
+    setTriggerCallback(callback: (event: AlertTriggerEvent) => Promise<void>): void;
+    private recordTrigger;
+    private matchesMetric;
+    private aggregateValue;
+    private evaluateCondition;
+}