crewly 1.0.0

package/dist/backend/backend/src/types/slack.types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Slack Integration Types
+ *
+ * Types for Slack bot integration enabling mobile communication
+ * with the Crewly orchestrator.
+ *
+ * @module types/slack
+ */
+/**
+ * Slack bot configuration
+ */
+export interface SlackConfig {
+    /** Bot OAuth token (xoxb-...) */
+    botToken: string;
+    /** App-level token for Socket Mode (xapp-...) */
+    appToken: string;
+    /** Signing secret for request verification */
+    signingSecret: string;
+    /** Channel ID for orchestrator notifications */
+    defaultChannelId?: string;
+    /** Allowed user IDs (empty = all users) */
+    allowedUserIds?: string[];
+    /** Enable Socket Mode for real-time events */
+    socketMode: boolean;
+}
+/**
+ * Slack user information
+ */
+export interface SlackUser {
+    id: string;
+    name: string;
+    realName?: string;
+    email?: string;
+    isAdmin?: boolean;
+    isOwner?: boolean;
+    teamId: string;
+}
+/**
+ * Slack channel information
+ */
+export interface SlackChannel {
+    id: string;
+    name: string;
+    isPrivate: boolean;
+    isIm: boolean;
+    isMpim: boolean;
+}
+/**
+ * Slack file object from event payload.
+ * Represents a file attached to a Slack message, including download URLs
+ * and optional thumbnail/dimension metadata for images.
+ */
+export interface SlackFile {
+    /** Slack file ID (e.g., F0123ABC456) */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** MIME type (e.g., image/png) */
+    mimetype: string;
+    /** Slack file type identifier (e.g., png, jpg) */
+    filetype: string;
+    /** File size in bytes */
+    size: number;
+    /** Private URL requiring Bearer token to download */
+    url_private: string;
+    /** Private download URL requiring Bearer token */
+    url_private_download: string;
+    /** Optional 360px thumbnail URL */
+    thumb_360?: string;
+    /** Original image width in pixels */
+    original_w?: number;
+    /** Original image height in pixels */
+    original_h?: number;
+    /** Permalink to view the file in Slack */
+    permalink: string;
+}
+/**
+ * Downloaded image info with local file path.
+ * Created after successfully downloading a SlackFile to the local filesystem.
+ */
+export interface SlackImageInfo {
+    /** Slack file ID */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** MIME type of the image */
+    mimetype: string;
+    /** Absolute path to the downloaded file on disk */
+    localPath: string;
+    /** Image width in pixels (from Slack metadata) */
+    width?: number;
+    /** Image height in pixels (from Slack metadata) */
+    height?: number;
+    /** Permalink to the original file in Slack */
+    permalink: string;
+}
+/**
+ * Incoming Slack message
+ */
+export interface SlackIncomingMessage {
+    id: string;
+    type: 'message' | 'app_mention' | 'command';
+    text: string;
+    userId: string;
+    channelId: string;
+    threadTs?: string;
+    ts: string;
+    teamId: string;
+    eventTs: string;
+    user?: SlackUser;
+    channel?: SlackChannel;
+    /** Raw Slack file objects from the event payload */
+    files?: SlackFile[];
+    /** Downloaded image info with local paths (populated after download) */
+    images?: SlackImageInfo[];
+    /** Whether the message contains image attachments */
+    hasImages?: boolean;
+}
+/**
+ * Outgoing Slack message
+ */
+export interface SlackOutgoingMessage {
+    channelId: string;
+    text: string;
+    threadTs?: string;
+    blocks?: SlackBlock[];
+    attachments?: SlackAttachment[];
+    unfurlLinks?: boolean;
+    unfurlMedia?: boolean;
+}
+/**
+ * Slack Block Kit block types
+ */
+export type SlackBlockType = 'section' | 'divider' | 'header' | 'context' | 'actions' | 'image';
+/**
+ * Slack Block Kit block
+ */
+export interface SlackBlock {
+    type: SlackBlockType;
+    text?: SlackTextObject;
+    fields?: SlackTextObject[];
+    accessory?: SlackAccessory;
+    elements?: SlackElement[];
+    block_id?: string;
+}
+/**
+ * Slack text object (mrkdwn or plain_text)
+ */
+export interface SlackTextObject {
+    type: 'mrkdwn' | 'plain_text';
+    text: string;
+    emoji?: boolean;
+    verbatim?: boolean;
+}
+/**
+ * Slack accessory element
+ */
+export interface SlackAccessory {
+    type: 'button' | 'image' | 'overflow' | 'datepicker' | 'static_select';
+    action_id?: string;
+    text?: SlackTextObject;
+    value?: string;
+    url?: string;
+    image_url?: string;
+    alt_text?: string;
+}
+/**
+ * Slack interactive element
+ */
+export interface SlackElement {
+    type: string;
+    action_id?: string;
+    text?: SlackTextObject;
+    value?: string;
+    [key: string]: unknown;
+}
+/**
+ * Slack attachment (legacy but still useful)
+ */
+export interface SlackAttachment {
+    color?: string;
+    fallback?: string;
+    title?: string;
+    title_link?: string;
+    text?: string;
+    fields?: SlackAttachmentField[];
+    footer?: string;
+    footer_icon?: string;
+    ts?: number;
+}
+/**
+ * Slack attachment field
+ */
+export interface SlackAttachmentField {
+    title: string;
+    value: string;
+    short?: boolean;
+}
+/**
+ * Slack slash command payload
+ */
+export interface SlackSlashCommand {
+    command: string;
+    text: string;
+    responseUrl: string;
+    triggerId: string;
+    userId: string;
+    userName: string;
+    channelId: string;
+    channelName: string;
+    teamId: string;
+    teamDomain: string;
+}
+/**
+ * Slack event types we handle
+ */
+export type SlackEventType = 'message' | 'app_mention' | 'app_home_opened' | 'member_joined_channel' | 'reaction_added';
+/**
+ * Slack event wrapper
+ */
+export interface SlackEvent<T = unknown> {
+    type: SlackEventType;
+    eventTs: string;
+    user?: string;
+    channel?: string;
+    ts?: string;
+    payload: T;
+}
+/**
+ * Message routing destination
+ */
+export type MessageDestination = {
+    type: 'orchestrator';
+} | {
+    type: 'agent';
+    agentId: string;
+} | {
+    type: 'team';
+    teamId: string;
+} | {
+    type: 'project';
+    projectId: string;
+};
+/**
+ * Parsed command from Slack message
+ */
+export interface ParsedSlackCommand {
+    intent: SlackCommandIntent;
+    target?: MessageDestination;
+    parameters: Record<string, string>;
+    rawText: string;
+}
+/**
+ * Recognized command intents
+ */
+export type SlackCommandIntent = 'status' | 'assign' | 'create_task' | 'create_project' | 'list_projects' | 'list_teams' | 'list_agents' | 'pause' | 'resume' | 'help' | 'conversation' | 'unknown';
+/**
+ * Slack notification types
+ */
+export type SlackNotificationType = 'task_completed' | 'task_failed' | 'task_blocked' | 'agent_error' | 'agent_question' | 'project_update' | 'daily_summary' | 'alert';
+/**
+ * Slack notification payload
+ */
+export interface SlackNotification {
+    type: SlackNotificationType;
+    title: string;
+    message: string;
+    urgency: 'low' | 'normal' | 'high' | 'critical';
+    metadata?: {
+        projectId?: string;
+        teamId?: string;
+        agentId?: string;
+        taskId?: string;
+        errorDetails?: string;
+    };
+    timestamp: string;
+    /** Reply in this Slack thread instead of top-level */
+    threadTs?: string;
+    /** Post to this channel (fallback: defaultChannelId) */
+    channelId?: string;
+}
+/**
+ * Conversation thread context
+ */
+export interface SlackConversationContext {
+    threadTs: string;
+    channelId: string;
+    userId: string;
+    conversationId: string;
+    startedAt: string;
+    lastActivityAt: string;
+    messageCount: number;
+}
+/**
+ * Slack service status
+ */
+export interface SlackServiceStatus {
+    connected: boolean;
+    socketMode: boolean;
+    lastEventAt?: string;
+    lastErrorAt?: string;
+    lastError?: string;
+    messagesSent: number;
+    messagesReceived: number;
+}
+/**
+ * Valid notification urgency levels
+ */
+export declare const NOTIFICATION_URGENCIES: readonly ["low", "normal", "high", "critical"];
+/**
+ * Command intent patterns for parsing
+ */
+export declare const COMMAND_PATTERNS: Record<SlackCommandIntent, RegExp[]>;
+/**
+ * Check if user is allowed to interact with the bot
+ *
+ * @param userId - Slack user ID to check
+ * @param config - Slack configuration with allowed users
+ * @returns True if user is allowed to interact
+ */
+export declare function isUserAllowed(userId: string, config: SlackConfig): boolean;
+/**
+ * Parse command intent from message text
+ *
+ * @param text - Message text to parse
+ * @returns Detected command intent
+ */
+export declare function parseCommandIntent(text: string): SlackCommandIntent;
+//# sourceMappingURL=slack.types.d.ts.map

package/dist/backend/backend/src/types/slack.types.d.ts.map

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

package/dist/backend/backend/src/types/slack.types.js

@@ -0,0 +1,66 @@
+/**
+ * Slack Integration Types
+ *
+ * Types for Slack bot integration enabling mobile communication
+ * with the Crewly orchestrator.
+ *
+ * @module types/slack
+ */
+/**
+ * Valid notification urgency levels
+ */
+export const NOTIFICATION_URGENCIES = ['low', 'normal', 'high', 'critical'];
+/**
+ * Command intent patterns for parsing
+ */
+export const COMMAND_PATTERNS = {
+    status: [
+        /^(what('s| is) the )?status/i,
+        /^how('s| is| are)/i,
+        /^(show|get|check) (me )?(the )?(status|progress)/i,
+    ],
+    assign: [/^assign/i, /^give .+ to/i, /^have .+ (work on|do)/i],
+    create_task: [/^create (a )?task/i, /^add (a )?task/i, /^new task/i],
+    create_project: [/^create (a )?project/i, /^new project/i, /^start (a )?project/i],
+    list_projects: [/^(list|show|get) (all )?(the )?projects/i, /^what projects/i],
+    list_teams: [/^(list|show|get) (all )?(the )?teams/i, /^what teams/i],
+    list_agents: [/^(list|show|get) (all )?(the )?agents/i, /^who('s| is) (working|available)/i],
+    pause: [/^pause/i, /^stop/i, /^hold/i],
+    resume: [/^resume/i, /^continue/i, /^start/i, /^unpause/i],
+    help: [/^help/i, /^what can you do/i, /^commands/i],
+    conversation: [/.*/], // Catch-all for general conversation
+    unknown: [],
+};
+/**
+ * Check if user is allowed to interact with the bot
+ *
+ * @param userId - Slack user ID to check
+ * @param config - Slack configuration with allowed users
+ * @returns True if user is allowed to interact
+ */
+export function isUserAllowed(userId, config) {
+    if (!config.allowedUserIds || config.allowedUserIds.length === 0) {
+        return true; // No restrictions
+    }
+    return config.allowedUserIds.includes(userId);
+}
+/**
+ * Parse command intent from message text
+ *
+ * @param text - Message text to parse
+ * @returns Detected command intent
+ */
+export function parseCommandIntent(text) {
+    const normalizedText = text.trim().toLowerCase();
+    for (const [intent, patterns] of Object.entries(COMMAND_PATTERNS)) {
+        if (intent === 'conversation' || intent === 'unknown')
+            continue;
+        for (const pattern of patterns) {
+            if (pattern.test(normalizedText)) {
+                return intent;
+            }
+        }
+    }
+    return 'conversation'; // Default to conversation
+}
+//# sourceMappingURL=slack.types.js.map

package/dist/backend/backend/src/types/slack.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/slack.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2VH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACpE,MAAM,EAAE;QACN,8BAA8B;QAC9B,oBAAoB;QACpB,mDAAmD;KACpD;IACD,MAAM,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,wBAAwB,CAAC;IAC9D,WAAW,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,YAAY,CAAC;IACpE,cAAc,EAAE,CAAC,uBAAuB,EAAE,eAAe,EAAE,sBAAsB,CAAC;IAClF,aAAa,EAAE,CAAC,0CAA0C,EAAE,iBAAiB,CAAC;IAC9E,UAAU,EAAE,CAAC,uCAAuC,EAAE,cAAc,CAAC;IACrE,WAAW,EAAE,CAAC,wCAAwC,EAAE,mCAAmC,CAAC;IAC5F,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACtC,MAAM,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC;IAC1D,IAAI,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,CAAC;IACnD,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,qCAAqC;IAC3D,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAmB;IAC/D,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClE,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QAEhE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBACjC,OAAO,MAA4B,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC,CAAC,0BAA0B;AACnD,CAAC"}

package/dist/backend/backend/src/types/sop.types.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Standard Operating Procedure (SOP) Type Definitions
+ *
+ * Types for defining, storing, and matching SOPs that guide
+ * agent behavior with standardized procedures.
+ *
+ * @module types/sop.types
+ */
+/**
+ * Roles that can have associated SOPs
+ */
+export type SOPRole = 'orchestrator' | 'pm' | 'tpm' | 'pgm' | 'developer' | 'frontend-developer' | 'backend-developer' | 'qa' | 'tester' | 'designer' | 'devops';
+/**
+ * Categories of SOPs
+ */
+export type SOPCategory = 'workflow' | 'quality' | 'communication' | 'escalation' | 'tools' | 'debugging' | 'testing' | 'git' | 'security';
+/**
+ * Condition operator for SOP activation
+ */
+export type SOPConditionOperator = 'equals' | 'contains' | 'matches';
+/**
+ * Condition type for SOP activation
+ */
+export type SOPConditionType = 'task-type' | 'file-pattern' | 'project-type' | 'custom';
+/**
+ * Condition for SOP activation
+ */
+export interface SOPCondition {
+    /** Type of condition */
+    type: SOPConditionType;
+    /** Value to check against */
+    value: string;
+    /** Comparison operator */
+    operator: SOPConditionOperator;
+}
+/**
+ * Example demonstrating correct SOP usage
+ */
+export interface SOPExample {
+    /** Example title */
+    title: string;
+    /** Scenario description */
+    scenario: string;
+    /** How to correctly handle this scenario */
+    correctApproach: string;
+    /** How NOT to handle this scenario */
+    incorrectApproach?: string;
+}
+/**
+ * Complete SOP definition
+ */
+export interface SOP {
+    /** Unique SOP identifier */
+    id: string;
+    /** Version number (increments on updates) */
+    version: number;
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Creator: 'system' or agentId */
+    createdBy: string;
+    /** Role this SOP applies to, or 'all' for universal */
+    role: SOPRole | 'all';
+    /** Category of the SOP */
+    category: SOPCategory;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Short title */
+    title: string;
+    /** Brief description */
+    description: string;
+    /** Full SOP content in Markdown */
+    content: string;
+    /** Keywords that trigger this SOP */
+    triggers: string[];
+    /** Optional conditions for activation */
+    conditions?: SOPCondition[];
+    /** Categorization tags */
+    tags: string[];
+    /** IDs of related SOPs */
+    relatedSOPs?: string[];
+    /** Usage examples */
+    examples?: SOPExample[];
+}
+/**
+ * Entry in the SOP index for fast lookup
+ */
+export interface SOPIndexEntry {
+    /** SOP identifier */
+    id: string;
+    /** Relative path to the SOP file */
+    path: string;
+    /** Role this SOP applies to */
+    role: SOPRole | 'all';
+    /** Category of the SOP */
+    category: SOPCategory;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Keywords that trigger this SOP */
+    triggers: string[];
+    /** Short title */
+    title: string;
+    /** Whether this is a system SOP (true) or custom (false) */
+    isSystem: boolean;
+}
+/**
+ * Complete SOP index
+ */
+export interface SOPIndex {
+    /** Index format version */
+    version: string;
+    /** ISO timestamp of last update */
+    lastUpdated: string;
+    /** All indexed SOPs */
+    sops: SOPIndexEntry[];
+}
+/**
+ * Parameters for finding relevant SOPs
+ */
+export interface SOPMatchParams {
+    /** Agent role */
+    role: string;
+    /** Current task context */
+    taskContext: string;
+    /** Type of task being performed */
+    taskType?: string;
+    /** File patterns involved */
+    filePatterns?: string[];
+    /** Maximum number of SOPs to return */
+    limit?: number;
+}
+/**
+ * Interface for SOP matching logic
+ */
+export interface ISOPMatcher {
+    /**
+     * Find SOPs relevant to the given context
+     *
+     * @param params - Match parameters
+     * @returns Array of matching SOPs, sorted by relevance
+     */
+    findRelevant(params: SOPMatchParams): Promise<SOP[]>;
+    /**
+     * Score how relevant an SOP is to the given context
+     *
+     * @param sop - SOP index entry to score
+     * @param context - Context string
+     * @returns Relevance score (0-1)
+     */
+    scoreRelevance(sop: SOPIndexEntry, context: string): number;
+}
+/**
+ * SOP file frontmatter (YAML header)
+ */
+export interface SOPFrontmatter {
+    id: string;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    role: SOPRole | 'all';
+    category: SOPCategory;
+    priority: number;
+    title: string;
+    description: string;
+    triggers: string[];
+    conditions?: SOPCondition[];
+    tags: string[];
+    relatedSOPs?: string[];
+}
+/**
+ * Result of parsing an SOP file
+ */
+export interface ParsedSOP {
+    /** Parsed frontmatter */
+    frontmatter: SOPFrontmatter;
+    /** Markdown content (without frontmatter) */
+    content: string;
+    /** Parsed examples (if present) */
+    examples?: SOPExample[];
+}
+/**
+ * SOP constants
+ */
+export declare const SOP_CONSTANTS: {
+    /** Directory names */
+    readonly PATHS: {
+        readonly SOP_DIR: "sops";
+        readonly SYSTEM_SOP_DIR: "system";
+        readonly CUSTOM_SOP_DIR: "custom";
+        readonly INDEX_FILE: "index.json";
+    };
+    /** Limits */
+    readonly LIMITS: {
+        readonly MAX_SOPS_IN_PROMPT: 5;
+        readonly MAX_SOP_CONTENT_LENGTH: 2000;
+        readonly MAX_TRIGGERS_PER_SOP: 20;
+        readonly MAX_CONDITIONS_PER_SOP: 10;
+        readonly MAX_EXAMPLES_PER_SOP: 5;
+    };
+    /** Matching configuration */
+    readonly MATCHING: {
+        readonly MIN_TRIGGER_MATCH_SCORE: 0.3;
+        readonly DEFAULT_PRIORITY: 5;
+        readonly ROLE_MATCH_BOOST: 0.3;
+        readonly CATEGORY_MATCH_BOOST: 0.2;
+    };
+    /** Index version */
+    readonly INDEX_VERSION: "1.0";
+};
+/**
+ * Default SOP categories organized by role
+ */
+export declare const DEFAULT_SOP_CATEGORIES: Record<SOPRole | 'all', SOPCategory[]>;
+/**
+ * All valid SOP roles
+ */
+export declare const ALL_SOP_ROLES: SOPRole[];
+/**
+ * All valid SOP categories
+ */
+export declare const ALL_SOP_CATEGORIES: SOPCategory[];
+//# sourceMappingURL=sop.types.d.ts.map

package/dist/backend/backend/src/types/sop.types.d.ts.map

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