agent-relay 1.1.0 → 1.2.0

package/dist/cloud/webhooks/rules-engine.js

@@ -0,0 +1,287 @@
+/**
+ * Webhook Rules Engine
+ *
+ * Matches normalized events against configured rules and determines actions to take.
+ */
+/**
+ * Simple JSONPath-like evaluator for conditions
+ * Supports: $.field, $.field.subfield, comparisons (==, !=, in, contains)
+ */
+function evaluateCondition(condition, event) {
+    if (!condition || condition.trim() === '')
+        return true;
+    try {
+        // Parse condition: $.path operator value
+        // Note: >= and <= must come before > and < in the alternation to match correctly
+        const conditionPattern = /^\$\.([a-zA-Z0-9_.]+)\s*(==|!=|>=|<=|>|<|in|contains)\s*(.+)$/;
+        const match = condition.match(conditionPattern);
+        if (!match) {
+            console.warn(`[rules-engine] Invalid condition format: ${condition}`);
+            return false;
+        }
+        const [, path, operator, rawValue] = match;
+        const value = rawValue.trim();
+        // Get the value from the event
+        const eventValue = getValueByPath(event, path);
+        // Parse the comparison value
+        let compareValue;
+        if (value.startsWith('[') && value.endsWith(']')) {
+            // Array literal
+            compareValue = JSON.parse(value);
+        }
+        else if (value.startsWith('"') && value.endsWith('"')) {
+            // String literal
+            compareValue = value.slice(1, -1);
+        }
+        else if (value === 'true') {
+            compareValue = true;
+        }
+        else if (value === 'false') {
+            compareValue = false;
+        }
+        else if (value === 'null') {
+            compareValue = null;
+        }
+        else if (!isNaN(Number(value))) {
+            compareValue = Number(value);
+        }
+        else {
+            // Treat as string
+            compareValue = value;
+        }
+        switch (operator) {
+            case '==':
+                // Handle null/undefined equivalence
+                if (compareValue === null) {
+                    return eventValue === null || eventValue === undefined;
+                }
+                return eventValue === compareValue;
+            case '!=':
+                return eventValue !== compareValue;
+            case 'in':
+                return Array.isArray(compareValue) && compareValue.includes(eventValue);
+            case 'contains':
+                if (Array.isArray(eventValue)) {
+                    return eventValue.includes(compareValue);
+                }
+                if (typeof eventValue === 'string' && typeof compareValue === 'string') {
+                    return eventValue.includes(compareValue);
+                }
+                return false;
+            case '>':
+                return typeof eventValue === 'number' && typeof compareValue === 'number' && eventValue > compareValue;
+            case '<':
+                return typeof eventValue === 'number' && typeof compareValue === 'number' && eventValue < compareValue;
+            case '>=':
+                return typeof eventValue === 'number' && typeof compareValue === 'number' && eventValue >= compareValue;
+            case '<=':
+                return typeof eventValue === 'number' && typeof compareValue === 'number' && eventValue <= compareValue;
+            default:
+                return false;
+        }
+    }
+    catch (error) {
+        console.error(`[rules-engine] Error evaluating condition: ${condition}`, error);
+        return false;
+    }
+}
+/**
+ * Get a value from an object by dot-separated path
+ */
+function getValueByPath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Check if a rule matches an event
+ */
+export function matchesRule(rule, event) {
+    // Check if rule is enabled
+    if (!rule.enabled)
+        return false;
+    // Check source match
+    if (rule.source !== '*' && rule.source !== event.source) {
+        return false;
+    }
+    // Check event type match
+    if (rule.eventType !== '*' && rule.eventType !== event.type) {
+        // Support wildcard prefix matching (e.g., 'ci_*' matches 'ci_failure')
+        if (rule.eventType.endsWith('*')) {
+            const prefix = rule.eventType.slice(0, -1);
+            if (!event.type.startsWith(prefix)) {
+                return false;
+            }
+        }
+        else {
+            return false;
+        }
+    }
+    // Check condition if present
+    if (rule.condition && !evaluateCondition(rule.condition, event)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Find all matching rules for an event, sorted by priority
+ */
+export function findMatchingRules(rules, event) {
+    return rules
+        .filter(rule => matchesRule(rule, event))
+        .sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Resolve template variables in action configuration
+ * Supports: ${event.field}, ${event.field.subfield}
+ */
+export function resolveActionTemplate(action, event) {
+    const resolvedAction = { ...action };
+    // Resolve agentType if it references an event field
+    if (resolvedAction.agentType?.startsWith('$.')) {
+        const path = resolvedAction.agentType.slice(2);
+        const value = getValueByPath(event, path);
+        if (typeof value === 'string') {
+            resolvedAction.agentType = value;
+        }
+        else if (Array.isArray(value) && value.length > 0) {
+            // Use first mentioned agent
+            resolvedAction.agentType = String(value[0]);
+        }
+    }
+    // Resolve prompt template references
+    if (resolvedAction.prompt?.startsWith('${') && resolvedAction.prompt?.endsWith('}')) {
+        const path = resolvedAction.prompt.slice(2, -1);
+        const value = getValueByPath(event, path);
+        if (typeof value === 'string') {
+            resolvedAction.prompt = value;
+        }
+    }
+    return resolvedAction;
+}
+/**
+ * Default rules for common patterns
+ */
+export const defaultRules = [
+    // CI Failures
+    {
+        id: 'ci-failure',
+        name: 'CI Failure Handler',
+        enabled: true,
+        source: 'github',
+        eventType: 'ci_failure',
+        action: {
+            type: 'spawn_agent',
+            agentType: 'ci-fix',
+            prompt: 'ci-failure',
+        },
+        priority: 10,
+    },
+    // GitHub Mentions
+    {
+        id: 'github-mention',
+        name: 'GitHub Mention Handler',
+        enabled: true,
+        source: 'github',
+        eventType: 'mention',
+        action: {
+            type: 'spawn_agent',
+            agentType: '$.mentions', // Use first mentioned agent
+            prompt: 'mention',
+        },
+        priority: 20,
+    },
+    // GitHub Issues
+    {
+        id: 'github-issue',
+        name: 'GitHub Issue Handler',
+        enabled: true,
+        source: 'github',
+        eventType: 'issue_created',
+        condition: '$.priority in ["critical", "high"]',
+        action: {
+            type: 'spawn_agent',
+            agentType: 'developer',
+            prompt: 'issue',
+        },
+        priority: 30,
+    },
+    // Linear Issues
+    {
+        id: 'linear-issue',
+        name: 'Linear Issue Handler',
+        enabled: true,
+        source: 'linear',
+        eventType: 'issue_created',
+        action: {
+            type: 'spawn_agent',
+            agentType: 'developer',
+            prompt: 'linear-issue',
+        },
+        priority: 20,
+    },
+    // Linear Mentions
+    {
+        id: 'linear-mention',
+        name: 'Linear Mention Handler',
+        enabled: true,
+        source: 'linear',
+        eventType: 'mention',
+        action: {
+            type: 'spawn_agent',
+            agentType: '$.mentions',
+            prompt: 'mention',
+        },
+        priority: 20,
+    },
+    // Slack App Mentions
+    {
+        id: 'slack-mention',
+        name: 'Slack App Mention Handler',
+        enabled: true,
+        source: 'slack',
+        eventType: 'mention',
+        action: {
+            type: 'spawn_agent',
+            agentType: '$.mentions',
+            prompt: 'slack-request',
+        },
+        priority: 20,
+    },
+    // Linear Issue Assignments (native integration)
+    {
+        id: 'linear-assignment',
+        name: 'Linear Issue Assignment Handler',
+        enabled: true,
+        source: 'linear',
+        eventType: 'issue_assigned',
+        action: {
+            type: 'spawn_agent',
+            agentType: '$.mentions', // Use the assigned agent type
+            prompt: 'linear-issue',
+        },
+        priority: 15,
+    },
+    // GitHub Issue Assignments
+    {
+        id: 'github-assignment',
+        name: 'GitHub Issue Assignment Handler',
+        enabled: true,
+        source: 'github',
+        eventType: 'issue_assigned',
+        action: {
+            type: 'spawn_agent',
+            agentType: '$.mentions',
+            prompt: 'issue',
+        },
+        priority: 15,
+    },
+];
+//# sourceMappingURL=rules-engine.js.map

package/dist/cloud/webhooks/rules-engine.js.map

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

package/dist/cloud/webhooks/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Generic Webhook System - Type Definitions
+ *
+ * Defines the core types for a configurable webhook system
+ * that can handle events from any source (GitHub, GitLab, Linear, Slack, etc.)
+ */
+/**
+ * Normalized event format that all parsers produce
+ */
+export interface NormalizedEvent {
+    /** Unique event ID */
+    id: string;
+    /** Source system (github, gitlab, linear, slack, etc.) */
+    source: string;
+    /** Event type (e.g., 'ci_failure', 'mention', 'issue_created') */
+    type: string;
+    /** Timestamp of the event */
+    timestamp: Date;
+    /** Actor who triggered the event */
+    actor: {
+        id: string;
+        name: string;
+        email?: string;
+    };
+    /** Repository or project context */
+    context: {
+        /** Full name (e.g., 'owner/repo' or project ID) */
+        name: string;
+        /** URL to the repository/project */
+        url?: string;
+    };
+    /** The item this event relates to (issue, PR, ticket, message) */
+    item?: {
+        type: 'issue' | 'pull_request' | 'ticket' | 'message' | 'comment' | 'check';
+        id: string | number;
+        number?: number;
+        title?: string;
+        body?: string;
+        url?: string;
+        state?: string;
+    };
+    /** Mentioned agents or users */
+    mentions: string[];
+    /** Labels, tags, or categories */
+    labels: string[];
+    /** Priority level if applicable */
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    /** Additional source-specific data */
+    metadata: Record<string, unknown>;
+    /** Raw payload for debugging */
+    rawPayload: unknown;
+}
+/**
+ * Action to take in response to an event
+ */
+export interface WebhookAction {
+    type: 'spawn_agent' | 'message_agent' | 'post_comment' | 'create_issue' | 'custom';
+    /** Agent type or name to spawn/message */
+    agentType?: string;
+    /** Prompt template name or inline prompt */
+    prompt?: string;
+    /** Additional action-specific config */
+    config?: Record<string, unknown>;
+}
+/**
+ * Signature verification configuration
+ */
+export interface SignatureConfig {
+    /** Header containing the signature */
+    header: string;
+    /** Algorithm to use for verification */
+    algorithm: 'sha256' | 'sha1' | 'token' | 'slack-v0' | 'none';
+    /** Environment variable containing the secret */
+    secretEnvVar: string;
+    /** Optional prefix to strip from signature (e.g., 'sha256=') */
+    signaturePrefix?: string;
+}
+/**
+ * Webhook source configuration
+ */
+export interface WebhookSourceConfig {
+    /** Source identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Whether this source is enabled */
+    enabled: boolean;
+    /** Signature verification config */
+    signature: SignatureConfig;
+    /** Parser to use for this source */
+    parser: string;
+    /** Responder to use for sending responses */
+    responder: string;
+    /** Parser-specific configuration */
+    parserConfig?: Record<string, unknown>;
+    /** Responder-specific configuration */
+    responderConfig?: Record<string, unknown>;
+}
+/**
+ * Event routing rule
+ */
+export interface WebhookRule {
+    /** Rule identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Whether this rule is enabled */
+    enabled: boolean;
+    /** Source to match (* for any) */
+    source: string;
+    /** Event type to match (* for any) */
+    eventType: string;
+    /** JSONPath condition (optional) */
+    condition?: string;
+    /** Action to take when matched */
+    action: WebhookAction;
+    /** Priority (lower = higher priority) */
+    priority: number;
+}
+/**
+ * Complete webhook configuration
+ */
+export interface WebhookConfig {
+    sources: Record<string, WebhookSourceConfig>;
+    rules: WebhookRule[];
+}
+/**
+ * Parser interface - transforms source-specific payloads to normalized events
+ */
+export interface WebhookParser {
+    /** Parser identifier */
+    id: string;
+    /** Parse raw payload into normalized event(s) */
+    parse(payload: unknown, headers: Record<string, string | string[] | undefined>, config?: Record<string, unknown>): NormalizedEvent[];
+}
+/**
+ * Response to send back to the source system
+ */
+export interface WebhookResponse {
+    /** Type of response */
+    type: 'comment' | 'message' | 'reaction' | 'status';
+    /** Target (issue number, channel ID, etc.) */
+    target: string | number;
+    /** Response body/content */
+    body: string;
+    /** Additional response metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Responder interface - sends responses back to source systems
+ */
+export interface WebhookResponder {
+    /** Responder identifier */
+    id: string;
+    /** Send a response to the source system */
+    respond(event: NormalizedEvent, response: WebhookResponse, config?: Record<string, unknown>): Promise<{
+        success: boolean;
+        id?: string;
+        url?: string;
+        error?: string;
+    }>;
+}
+/**
+ * Result of processing a webhook
+ */
+export interface WebhookResult {
+    success: boolean;
+    eventId: string;
+    source: string;
+    eventType: string;
+    matchedRules: string[];
+    actions: Array<{
+        ruleId: string;
+        action: WebhookAction;
+        success: boolean;
+        error?: string;
+    }>;
+    responses: Array<{
+        type: string;
+        success: boolean;
+        id?: string;
+        url?: string;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cloud/webhooks/types.d.ts.map

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

package/dist/cloud/webhooks/types.js

@@ -0,0 +1,8 @@
+/**
+ * Generic Webhook System - Type Definitions
+ *
+ * Defines the core types for a configurable webhook system
+ * that can handle events from any source (GitHub, GitLab, Linear, Slack, etc.)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cloud/webhooks/types.js.map

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

package/dist/continuity/formatter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Context Formatter
+ *
+ * Formats ledgers, handoffs, and learnings into markdown
+ * for injection into agent context.
+ */
+import type { Ledger, Handoff, StartupContext, FileRef, Decision } from './types.js';
+/**
+ * Format options for context injection
+ */
+export interface FormatOptions {
+    /** Maximum length of the formatted context */
+    maxLength?: number;
+    /** Include file references */
+    includeFiles?: boolean;
+    /** Include decisions */
+    includeDecisions?: boolean;
+    /** Include learnings */
+    includeLearnings?: boolean;
+    /** Compact mode (less verbose) */
+    compact?: boolean;
+}
+/**
+ * Format a startup context for injection
+ */
+export declare function formatStartupContext(context: Omit<StartupContext, 'formatted'>, options?: FormatOptions): string;
+/**
+ * Format a ledger for context injection
+ */
+export declare function formatLedger(ledger: Ledger, options?: FormatOptions): string;
+/**
+ * Format a handoff for context injection
+ */
+export declare function formatHandoff(handoff: Handoff, options?: FormatOptions): string;
+/**
+ * Format a search result summary
+ */
+export declare function formatSearchResults(handoffs: Handoff[], query: string): string;
+/**
+ * Format a brief status summary (for status line / dashboard)
+ */
+export declare function formatBriefStatus(ledger: Ledger | null, handoff: Handoff | null): string;
+/**
+ * Format file references for injection
+ */
+export declare function formatFileRefs(files: FileRef[]): string;
+/**
+ * Format decisions for injection
+ */
+export declare function formatDecisions(decisions: Decision[]): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/continuity/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/continuity/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAC1C,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAwCR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAqGhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2FnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAwBxF;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAUvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE7D"}