sandstream-kit 1.0.0

package/dist/moderation-system.js

@@ -0,0 +1,338 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+import { IdGenerators } from "./id-generator.js";
+// ─── ModerationSystem ─────────────────────────────────────────────────────────
+export class ModerationSystem {
+    reports = new Map();
+    actions = new Map();
+    appeals = new Map();
+    suspendedUsers = new Map();
+    bannedUsers = new Set();
+    guidelines = new Map();
+    reportQueue = [];
+    // ─── Reporting & Flagging ─────────────────────────────────────────────────
+    /**
+     * File a moderation report against content (plugin, review, comment, author).
+     */
+    fileReport(contentId, contentType, reportedBy, reason, description, evidence = []) {
+        const reportId = IdGenerators.report();
+        const report = {
+            id: reportId,
+            contentId,
+            contentType,
+            reportedBy,
+            reason,
+            description,
+            evidence,
+            status: "pending",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        this.reports.set(reportId, report);
+        // Add to moderation queue
+        this.updateQueue(contentId, contentType, reportedBy);
+        return report;
+    }
+    getReport(reportId) {
+        return this.reports.get(reportId) || null;
+    }
+    getContentReports(contentId) {
+        return [...this.reports.values()].filter((r) => r.contentId === contentId);
+    }
+    // ─── Queue Management ─────────────────────────────────────────────────────
+    /**
+     * Update moderation queue with new report.
+     * Tracks priority based on report count and violation type.
+     */
+    updateQueue(contentId, contentType, reportedBy) {
+        const reports = this.getContentReports(contentId);
+        let priority = "low";
+        if (reports.length >= 10) {
+            priority = "critical";
+        }
+        else if (reports.length >= 5) {
+            priority = "high";
+        }
+        else if (reports.length >= 3) {
+            priority = "medium";
+        }
+        // Check for high-severity violations
+        if (reports.some((r) => ["malware", "copyright", "abuse"].includes(r.reason))) {
+            priority = "critical";
+        }
+        const queueEntry = {
+            reportId: reports[reports.length - 1].id,
+            contentId,
+            contentType,
+            reportCount: reports.length,
+            priority,
+            createdAt: new Date().toISOString(),
+        };
+        // Remove duplicate if exists
+        this.reportQueue = this.reportQueue.filter((q) => q.contentId !== contentId);
+        this.reportQueue.push(queueEntry);
+        this.reportQueue.sort((a, b) => ({ critical: 0, high: 1, medium: 2, low: 3 }[b.priority] -
+            { critical: 0, high: 1, medium: 2, low: 3 }[a.priority]));
+    }
+    getQueue(limit = 20) {
+        return this.reportQueue.slice(0, limit);
+    }
+    getQueueStats() {
+        const stats = { total: this.reportQueue.length, critical: 0, high: 0, medium: 0, low: 0 };
+        for (const q of this.reportQueue) {
+            stats[q.priority]++;
+        }
+        return stats;
+    }
+    // ─── Automated Spam Detection ─────────────────────────────────────────────
+    /**
+     * Analyze content for spam signals.
+     * Returns a score 0-100 indicating spam likelihood.
+     */
+    detectSpam(content, metadata) {
+        const signals = {
+            hasMultipleReports: false,
+            hasAbusiveLanguage: false,
+            hasExcessiveLinks: false,
+            hasSuspiciousPatterns: false,
+            isNewAccount: false,
+            score: 0,
+        };
+        // Abusive language detection (simple keyword-based)
+        const abusiveWords = [
+            "kill",
+            "hate",
+            "stupid",
+            "idiot",
+            "worthless",
+            "deserve to die",
+        ];
+        if (abusiveWords.some((word) => content.toLowerCase().includes(word))) {
+            signals.hasAbusiveLanguage = true;
+            signals.score += 30;
+        }
+        // Excessive links (> 3 links per 100 chars)
+        const linkCount = (content.match(/https?:\/\//g) || []).length;
+        if (linkCount > Math.max(3, content.length / 100)) {
+            signals.hasExcessiveLinks = true;
+            signals.score += 25;
+        }
+        // Suspicious patterns: all caps, repeated chars, spam keywords
+        const allCaps = (content.match(/[A-Z]/g) || []).length > content.length * 0.8;
+        const repeatedChars = /(.)\1{4,}/.test(content);
+        const spamKeywords = [
+            "click here now",
+            "buy now",
+            "limited offer",
+            "act now",
+            "guaranteed",
+        ];
+        const hasSuspicious = allCaps || repeatedChars || spamKeywords.some((kw) => content.toLowerCase().includes(kw));
+        if (hasSuspicious) {
+            signals.hasSuspiciousPatterns = true;
+            signals.score += 25;
+        }
+        // Check if author is new
+        if (metadata.createdAt && typeof metadata.createdAt === "string") {
+            const createdDate = new Date(metadata.createdAt);
+            const ageMs = Date.now() - createdDate.getTime();
+            const ageDays = ageMs / (1000 * 60 * 60 * 24);
+            if (ageDays < 7) {
+                signals.isNewAccount = true;
+                signals.score += 20;
+            }
+        }
+        return signals;
+    }
+    // ─── Moderation Actions ───────────────────────────────────────────────────
+    /**
+     * Take a moderation action: warning, suspend, or ban.
+     */
+    takeAction(reportId, contentId, action, reason, duration, appliedBy = "system") {
+        const actionId = IdGenerators.modAction();
+        const modAction = {
+            id: actionId,
+            reportId,
+            contentId,
+            action,
+            reason,
+            duration,
+            appliedBy,
+            appliedAt: new Date().toISOString(),
+            metadata: {},
+        };
+        this.actions.set(actionId, modAction);
+        // Update report status
+        const report = this.reports.get(reportId);
+        if (report) {
+            report.status = action === "warning" ? "approved" : "approved";
+            report.updatedAt = new Date().toISOString();
+        }
+        // Handle user suspensions/bans
+        const report2 = this.reports.get(reportId);
+        if (report2) {
+            if (action === "suspend_user" && duration) {
+                const until = new Date(Date.now() + duration * 24 * 60 * 60 * 1000);
+                this.suspendedUsers.set(report2.reportedBy, { until, reason });
+            }
+            else if (action === "ban_user") {
+                this.bannedUsers.add(report2.reportedBy);
+            }
+        }
+        return modAction;
+    }
+    getAction(actionId) {
+        return this.actions.get(actionId) || null;
+    }
+    getContentActions(contentId) {
+        return [...this.actions.values()].filter((a) => a.contentId === contentId);
+    }
+    isSuspended(userId) {
+        const suspension = this.suspendedUsers.get(userId);
+        if (!suspension)
+            return false;
+        return new Date() < suspension.until;
+    }
+    isBanned(userId) {
+        return this.bannedUsers.has(userId);
+    }
+    getSuspensionStatus(userId) {
+        return this.suspendedUsers.get(userId) || null;
+    }
+    // ─── Appeals ──────────────────────────────────────────────────────────────
+    /**
+     * File an appeal against a moderation action.
+     */
+    fileAppeal(actionId, reportId, contentId, appealedBy, reason, evidence = []) {
+        const appealId = IdGenerators.appeal();
+        const appeal = {
+            id: appealId,
+            actionId,
+            reportId,
+            contentId,
+            appealedBy,
+            reason,
+            evidence,
+            status: "pending",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        this.appeals.set(appealId, appeal);
+        // Update report status
+        const report = this.reports.get(reportId);
+        if (report) {
+            report.status = "appealed";
+            report.updatedAt = new Date().toISOString();
+        }
+        return appeal;
+    }
+    getAppeal(appealId) {
+        return this.appeals.get(appealId) || null;
+    }
+    getPendingAppeals(limit = 20) {
+        return [...this.appeals.values()]
+            .filter((a) => a.status === "pending")
+            .sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime())
+            .slice(0, limit);
+    }
+    /**
+     * Review an appeal: uphold or overturn the original action.
+     */
+    reviewAppeal(appealId, reviewedBy, decision, reason) {
+        const appeal = this.appeals.get(appealId);
+        if (!appeal || appeal.status !== "pending")
+            return null;
+        appeal.status = decision;
+        appeal.reviewedBy = reviewedBy;
+        appeal.reviewedAt = new Date().toISOString();
+        appeal.decision = reason;
+        appeal.updatedAt = new Date().toISOString();
+        // If appeal overturned, remove suspension/ban
+        if (decision === "overturned") {
+            const action = this.actions.get(appeal.actionId);
+            if (action) {
+                const report = this.reports.get(appeal.reportId);
+                if (report && report.reportedBy) {
+                    if (action.action === "suspend_user") {
+                        this.suspendedUsers.delete(report.reportedBy);
+                    }
+                    else if (action.action === "ban_user") {
+                        this.bannedUsers.delete(report.reportedBy);
+                    }
+                }
+            }
+        }
+        return appeal;
+    }
+    // ─── Community Guidelines ─────────────────────────────────────────────────
+    registerGuideline(title, description, examples, consequenceLevel) {
+        const id = `guideline-${Date.now()}`;
+        const guideline = {
+            id,
+            title,
+            description,
+            examples,
+            consequenceLevel,
+            active: true,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        this.guidelines.set(id, guideline);
+        return guideline;
+    }
+    getGuideline(id) {
+        return this.guidelines.get(id) || null;
+    }
+    getActiveGuidelines() {
+        return [...this.guidelines.values()].filter((g) => g.active);
+    }
+    deactivateGuideline(id) {
+        const guideline = this.guidelines.get(id);
+        if (!guideline)
+            return false;
+        guideline.active = false;
+        guideline.updatedAt = new Date().toISOString();
+        return true;
+    }
+    // ─── Statistics ───────────────────────────────────────────────────────────
+    getModerationStats() {
+        const reports = [...this.reports.values()];
+        const actions = [...this.actions.values()];
+        const appeals = [...this.appeals.values()];
+        const approvedCount = reports.filter((r) => r.status === "approved").length;
+        const rejectedCount = reports.filter((r) => r.status === "rejected").length;
+        const pendingCount = reports.filter((r) => r.status === "pending").length;
+        const appealsCount = appeals.length;
+        const suspensionsCount = actions.filter((a) => a.action === "suspend_user").length;
+        const bansCount = actions.filter((a) => a.action === "ban_user").length;
+        // Calculate average resolution time
+        const resolved = reports.filter((r) => r.status === "approved" || r.status === "rejected");
+        const avgTime = resolved.length > 0
+            ? resolved.reduce((sum, r) => {
+                const createdMs = new Date(r.createdAt).getTime();
+                const updatedMs = new Date(r.updatedAt).getTime();
+                return sum + (updatedMs - createdMs);
+            }, 0) / resolved.length
+            : 0;
+        return {
+            totalReports: reports.length,
+            approvedCount,
+            rejectedCount,
+            pendingCount,
+            appealsCount,
+            suspensionsCount,
+            bansCount,
+            averageResolutionTimeMs: Math.round(avgTime),
+        };
+    }
+    // ─── Cache helpers ────────────────────────────────────────────────────────
+    getReportsCache() {
+        return this.reports;
+    }
+    getActionsCache() {
+        return this.actions;
+    }
+    getAppealCache() {
+        return this.appeals;
+    }
+}
+//# sourceMappingURL=moderation-system.js.map

package/dist/moderation-system.js.map

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

package/dist/multi-agent-workflow-model.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Multi-Agent Workflows — data models
+ * Orchestrate complex tasks across multiple agents with coordination and state management
+ */
+export type WorkflowStatus = "draft" | "active" | "paused" | "completed" | "failed" | "cancelled";
+export type TaskStatus = "pending" | "assigned" | "in_progress" | "completed" | "failed" | "skipped" | "waiting";
+export type CoordinationType = "sequential" | "parallel" | "fan_out" | "conditional";
+export type AgentRole = "primary" | "secondary" | "reviewer" | "observer";
+export interface WorkflowTask {
+    id: string;
+    workflow_id: string;
+    task_name: string;
+    description: string;
+    sequence_order: number;
+    status: TaskStatus;
+    assigned_agent_id?: string;
+    assigned_agent_type?: string;
+    dependencies: string[];
+    input_data?: Record<string, unknown>;
+    output_data?: Record<string, unknown>;
+    error_message?: string;
+    retry_count: number;
+    max_retries: number;
+    timeout_minutes: number;
+    started_at?: string;
+    completed_at?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowCoordination {
+    id: string;
+    workflow_id: string;
+    coordination_type: CoordinationType;
+    condition?: string;
+    parallel_tasks: string[];
+    sequential_tasks: string[];
+    fan_out_source_task?: string;
+    fan_out_targets?: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface MultiAgentWorkflow {
+    id: string;
+    team_id: string;
+    workflow_name: string;
+    description?: string;
+    status: WorkflowStatus;
+    tasks: WorkflowTask[];
+    coordination: WorkflowCoordination[];
+    agents: {
+        agent_id: string;
+        agent_type: string;
+        role: AgentRole;
+        assigned_tasks: string[];
+    }[];
+    input_data?: Record<string, unknown>;
+    output_data?: Record<string, unknown>;
+    max_parallel_tasks: number;
+    timeout_minutes: number;
+    created_by: string;
+    started_at?: string;
+    completed_at?: string;
+    estimated_completion?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowExecution {
+    id: string;
+    workflow_id: string;
+    team_id: string;
+    execution_status: WorkflowStatus;
+    tasks_completed: number;
+    tasks_failed: number;
+    tasks_pending: number;
+    overall_progress_percent: number;
+    started_at: string;
+    completed_at?: string;
+    duration_minutes?: number;
+    error_count: number;
+    warning_count: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface AgentCoordination {
+    id: string;
+    workflow_id: string;
+    team_id: string;
+    agents: {
+        agent_id: string;
+        agent_type: string;
+        role: AgentRole;
+    }[];
+    shared_context: Record<string, unknown>;
+    handoff_enabled: boolean;
+    result_aggregation_mode: "merge" | "sequential" | "consensus";
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowMetrics {
+    total_workflows: number;
+    active_workflows: number;
+    completed_workflows: number;
+    failed_workflows: number;
+    average_duration_minutes: number;
+    average_tasks_per_workflow: number;
+    most_used_coordination_type: CoordinationType;
+    agent_utilization_percent: number;
+    success_rate_percent: number;
+    average_retries: number;
+}
+export interface WorkflowTemplate {
+    id: string;
+    template_name: string;
+    description?: string;
+    category: string;
+    tasks: Omit<WorkflowTask, "id" | "workflow_id" | "created_at" | "updated_at">[];
+    coordination: Omit<WorkflowCoordination, "id" | "workflow_id" | "created_at" | "updated_at">[];
+    required_agents: number;
+    estimated_duration_minutes: number;
+    complexity: "simple" | "moderate" | "complex";
+    public: boolean;
+    created_at: string;
+    updated_at: string;
+}

package/dist/multi-agent-workflow-model.js

@@ -0,0 +1,6 @@
+/**
+ * Multi-Agent Workflows — data models
+ * Orchestrate complex tasks across multiple agents with coordination and state management
+ */
+export {};
+//# sourceMappingURL=multi-agent-workflow-model.js.map

package/dist/multi-agent-workflow-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-workflow-model.js","sourceRoot":"","sources":["../src/multi-agent-workflow-model.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/multi-agent-workflow-service.d.ts

@@ -0,0 +1,102 @@
+import type { MultiAgentWorkflow, WorkflowTask, WorkflowCoordination, WorkflowExecution, WorkflowMetrics, WorkflowTemplate } from "./multi-agent-workflow-model.js";
+/**
+ * Create new workflow
+ */
+export declare function createWorkflow(team_id: string, workflow_name: string, created_by: string, description?: string): {
+    workflow: MultiAgentWorkflow;
+    error?: string;
+};
+/**
+ * Add task to workflow
+ */
+export declare function addWorkflowTask(team_id: string, workflow_id: string, task_name: string, description: string, sequence_order: number, dependencies?: string[], timeout_minutes?: number): {
+    task: WorkflowTask;
+    error?: string;
+};
+/**
+ * Assign agent to task
+ */
+export declare function assignAgentToTask(team_id: string, workflow_id: string, task_id: string, agent_id: string, agent_type: string): {
+    task: WorkflowTask;
+    error?: string;
+};
+/**
+ * Setup workflow coordination
+ */
+export declare function setupCoordination(team_id: string, workflow_id: string, coordination_type: string, task_ids: string[]): {
+    coordination: WorkflowCoordination;
+    error?: string;
+};
+/**
+ * Execute workflow
+ */
+export declare function executeWorkflow(team_id: string, workflow_id: string, input_data?: Record<string, unknown>): {
+    execution: WorkflowExecution;
+    error?: string;
+};
+/**
+ * Complete task
+ */
+export declare function completeTask(team_id: string, workflow_id: string, task_id: string, output_data?: Record<string, unknown>): {
+    task: WorkflowTask;
+    error?: string;
+};
+/**
+ * Fail task
+ */
+export declare function failTask(team_id: string, workflow_id: string, task_id: string, error_message: string): {
+    task: WorkflowTask;
+    error?: string;
+};
+/**
+ * Get workflow status
+ */
+export declare function getWorkflowStatus(team_id: string, workflow_id: string): {
+    workflow: MultiAgentWorkflow | null;
+    error?: string;
+};
+/**
+ * Get task status
+ */
+export declare function getTaskStatus(team_id: string, workflow_id: string, task_id: string): {
+    task: WorkflowTask | null;
+    error?: string;
+};
+/**
+ * Pause workflow
+ */
+export declare function pauseWorkflow(team_id: string, workflow_id: string): {
+    workflow: MultiAgentWorkflow;
+    error?: string;
+};
+/**
+ * Resume workflow
+ */
+export declare function resumeWorkflow(team_id: string, workflow_id: string): {
+    workflow: MultiAgentWorkflow;
+    error?: string;
+};
+/**
+ * Cancel workflow
+ */
+export declare function cancelWorkflow(team_id: string, workflow_id: string): {
+    workflow: MultiAgentWorkflow;
+    error?: string;
+};
+/**
+ * Create workflow from template
+ */
+export declare function createWorkflowFromTemplate(team_id: string, template_id: string, workflow_name: string, created_by: string): {
+    workflow: MultiAgentWorkflow;
+    error?: string;
+};
+/**
+ * List workflow templates
+ */
+export declare function listWorkflowTemplates(): {
+    templates: WorkflowTemplate[];
+};
+/**
+ * Get workflow metrics
+ */
+export declare function getWorkflowMetrics(team_id: string): WorkflowMetrics;