@aligndottech/connector-core 0.1.0

package/dist/parsers/CommandParser.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared command parser for communication connectors (Slack, Teams, etc.)
+ * This ensures consistent command handling across all platforms.
+ */
+import type { CommandAction, Issue, RelatedDecision } from '../types/index.js';
+/**
+ * Parse user command text into standardized action
+ */
+export declare class CommandParser {
+    /**
+     * Parse user text into a standardized command action
+     */
+    static parse(text: string): CommandAction;
+    /**
+     * Parse merge-related commands
+     */
+    private static parseMergeCommand;
+    /**
+     * Parse keep commands for conflict resolution
+     * Note: Order matters - check "both" first since "keep b" would otherwise match "keep_old"
+     */
+    private static parseKeepCommand;
+    /**
+     * Parse supersession commands
+     */
+    private static parseSupersessionCommand;
+    /**
+     * Parse create issue command, extracting optional project key
+     */
+    private static parseCreateCommand;
+    /**
+     * Check if text is a greeting
+     */
+    static isGreeting(text: string): boolean;
+}
+/**
+ * Generate command help text for different scenarios
+ */
+export declare class CommandHelpText {
+    /**
+     * Get command list for duplicate decisions
+     */
+    static getDuplicateCommands(): string[];
+    /**
+     * Get command list for conflicting decisions
+     */
+    static getConflictCommands(): string[];
+    /**
+     * Get command list for supersession decisions
+     */
+    static getSupersessionCommands(): string[];
+    /**
+     * Get command list for JIRA/Linear issue linking
+     */
+    static getIssueCommands(connectors?: string[]): string[];
+    /**
+     * Get all applicable commands for a given context
+     */
+    static getApplicableCommands(relatedDecisions: RelatedDecision[], issues: Issue[], enabledConnectors?: string[]): string[];
+    /**
+     * Format commands for Slack (uses backticks and bold)
+     */
+    static formatForSlack(commands: string[]): string;
+    /**
+     * Format commands for Teams (uses ** for bold)
+     */
+    static formatForTeams(commands: string[]): string;
+}
+//# sourceMappingURL=CommandParser.d.ts.map

package/dist/parsers/CommandParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandParser.d.ts","sourceRoot":"","sources":["../../src/parsers/CommandParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAO/E;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAiEzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAuBhC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAc/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAUvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAOjC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM,EAAE;IAQvC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;IAQtC;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAO1C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,GAAE,MAAM,EAAa,GAAG,MAAM,EAAE;IAqBlE;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,gBAAgB,EAAE,eAAe,EAAE,EACnC,MAAM,EAAE,KAAK,EAAE,EACf,iBAAiB,GAAE,MAAM,EAAa,GACrC,MAAM,EAAE;IAqCX;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAIjD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;CAGlD"}

package/dist/parsers/CommandParser.js

@@ -0,0 +1,233 @@
+/**
+ * Shared command parser for communication connectors (Slack, Teams, etc.)
+ * This ensures consistent command handling across all platforms.
+ */
+/**
+ * Patterns for detecting greetings
+ */
+const GREETING_PATTERNS = /^(hi|hello|hey|sup|yo|good\s*(morning|afternoon|evening)|howdy|hiya|greetings)$/i;
+/**
+ * Parse user command text into standardized action
+ */
+export class CommandParser {
+    /**
+     * Parse user text into a standardized command action
+     */
+    static parse(text) {
+        const trimmedText = text.trim();
+        const lowerText = trimmedText.toLowerCase();
+        // Greeting detection (should reset conversation)
+        if (GREETING_PATTERNS.test(trimmedText)) {
+            return { type: 'greeting' };
+        }
+        // Help command
+        if (lowerText === 'help' || lowerText === '/help') {
+            return { type: 'help' };
+        }
+        // Skip command
+        if (lowerText === 'skip' || lowerText.includes('skip')) {
+            return { type: 'skip' };
+        }
+        // Acknowledge command (for non-conflict relationships like relates/refines)
+        if (lowerText === 'acknowledge' || lowerText === 'ack' || lowerText === 'ok') {
+            return { type: 'skip' }; // Acknowledge is functionally the same as skip - move to next
+        }
+        // Merge commands
+        if (lowerText.includes('merge')) {
+            return this.parseMergeCommand(text, lowerText);
+        }
+        // Conflict resolution commands
+        if (lowerText.includes('keep')) {
+            const keepAction = this.parseKeepCommand(lowerText);
+            if (keepAction)
+                return keepAction;
+        }
+        // Supersession commands
+        if (lowerText.includes('supersession')) {
+            const supersessionAction = this.parseSupersessionCommand(lowerText);
+            if (supersessionAction)
+                return supersessionAction;
+        }
+        // Create new issue command
+        // Supports: "create new", "create jira", "create linear", "create new in PROJECT", "create in PROJECT"
+        if (lowerText.includes('create') && (lowerText.includes('new') || lowerText.includes('jira') || lowerText.includes('linear') || lowerText.includes(' in '))) {
+            return this.parseCreateCommand(text);
+        }
+        // Link to issue command
+        const issueKeyMatch = text.match(/\b[A-Z]+-\d+\b/);
+        if (lowerText.includes('link') && issueKeyMatch) {
+            return { type: 'link_issue', issueKey: issueKeyMatch[0] };
+        }
+        // Also allow just typing an issue key to link
+        if (issueKeyMatch && !lowerText.includes('create')) {
+            // Check if the message is primarily just an issue key reference
+            const cleanText = trimmedText.replace(/\b[A-Z]+-\d+\b/g, '').trim();
+            if (cleanText.length < 10 || lowerText.includes('link')) {
+                return { type: 'link_issue', issueKey: issueKeyMatch[0] };
+            }
+        }
+        return { type: 'unknown' };
+    }
+    /**
+     * Parse merge-related commands
+     */
+    static parseMergeCommand(text, lowerText) {
+        const indexMatches = text.match(/#(\d+)/g);
+        if (lowerText.includes('merge all')) {
+            return { type: 'merge_all' };
+        }
+        if (indexMatches && indexMatches.length > 1) {
+            // Merge with multiple specific indices: "merge #1, #2"
+            const indices = indexMatches.map(m => parseInt(m.substring(1)) - 1);
+            return { type: 'merge_specific', indices };
+        }
+        if (indexMatches && indexMatches.length === 1) {
+            // Merge with specific index: "merge #1" or "merge with #2"
+            const index = parseInt(indexMatches[0].substring(1)) - 1;
+            return { type: 'merge_single', index };
+        }
+        // Default: merge with first duplicate
+        return { type: 'merge_single', index: 0 };
+    }
+    /**
+     * Parse keep commands for conflict resolution
+     * Note: Order matters - check "both" first since "keep b" would otherwise match "keep_old"
+     */
+    static parseKeepCommand(lowerText) {
+        // Check "both" first - it's the most specific
+        if (lowerText.includes('both')) {
+            return { type: 'keep_both' };
+        }
+        if (lowerText.includes('new') || lowerText === 'keep a') {
+            return { type: 'keep_new' };
+        }
+        if (lowerText.includes('old') || lowerText === 'keep b') {
+            return { type: 'keep_old' };
+        }
+        return null;
+    }
+    /**
+     * Parse supersession commands
+     */
+    static parseSupersessionCommand(lowerText) {
+        if (lowerText.includes('accept')) {
+            return { type: 'accept_supersession' };
+        }
+        if (lowerText.includes('reject')) {
+            return { type: 'reject_supersession' };
+        }
+        return null;
+    }
+    /**
+     * Parse create issue command, extracting optional project key
+     */
+    static parseCreateCommand(text) {
+        // Check for "create new in PROJECT-KEY" pattern
+        const projectMatch = text.match(/create\s+(?:new\s+)?in\s+([A-Z][A-Z0-9]+)/i);
+        const projectKey = projectMatch ? projectMatch[1].toUpperCase() : undefined;
+        return { type: 'create_issue', projectKey };
+    }
+    /**
+     * Check if text is a greeting
+     */
+    static isGreeting(text) {
+        return GREETING_PATTERNS.test(text.trim());
+    }
+}
+/**
+ * Generate command help text for different scenarios
+ */
+export class CommandHelpText {
+    /**
+     * Get command list for duplicate decisions
+     */
+    static getDuplicateCommands() {
+        return [
+            '`merge` - Merge with first duplicate',
+            '`merge all` - Merge with all duplicates',
+            '`merge #1, #2` - Merge with specific duplicates',
+        ];
+    }
+    /**
+     * Get command list for conflicting decisions
+     */
+    static getConflictCommands() {
+        return [
+            '`keep new` (or `keep a`) - Keep new decision, archive conflicting one',
+            '`keep old` (or `keep b`) - Keep old decision, archive new one',
+            '`keep both` - Keep both decisions as separate',
+        ];
+    }
+    /**
+     * Get command list for supersession decisions
+     */
+    static getSupersessionCommands() {
+        return [
+            '`accept supersession` - Archive old decision, keep new one',
+            '`reject supersession` - Keep old decision active',
+        ];
+    }
+    /**
+     * Get command list for JIRA/Linear issue linking
+     */
+    static getIssueCommands(connectors = ['jira']) {
+        const commands = [];
+        if (connectors.includes('jira') || connectors.includes('linear')) {
+            commands.push('`link to PROJ-123` - Link to existing issue');
+        }
+        if (connectors.includes('jira')) {
+            commands.push('`create new` - Create new JIRA issue');
+            commands.push('`create new in PROJ` - Create in specific project');
+        }
+        if (connectors.includes('linear')) {
+            commands.push('`create linear` - Create new Linear issue');
+        }
+        commands.push('`skip` - Continue without linking');
+        return commands;
+    }
+    /**
+     * Get all applicable commands for a given context
+     */
+    static getApplicableCommands(relatedDecisions, issues, enabledConnectors = ['jira']) {
+        const commands = [];
+        const hasDuplicates = relatedDecisions.some(d => d.relationship === 'duplicates');
+        const hasConflicts = relatedDecisions.some(d => d.relationship === 'conflicts_with');
+        const hasSupersessions = relatedDecisions.some(d => d.relationship === 'supersedes');
+        if (hasDuplicates) {
+            commands.push('**Duplicate Resolution:**');
+            commands.push(...this.getDuplicateCommands().map(c => `  ${c}`));
+        }
+        if (hasConflicts) {
+            commands.push('**Conflict Resolution:**');
+            commands.push(...this.getConflictCommands().map(c => `  ${c}`));
+        }
+        if (hasSupersessions) {
+            commands.push('**Supersession:**');
+            commands.push(...this.getSupersessionCommands().map(c => `  ${c}`));
+        }
+        // Issue commands
+        const hasIssueConnectors = enabledConnectors.some(c => ['jira', 'linear'].includes(c));
+        if (hasIssueConnectors) {
+            commands.push('**Issue Tracking:**');
+            commands.push(...this.getIssueCommands(enabledConnectors).map(c => `  ${c}`));
+        }
+        // Always include skip
+        if (!commands.some(c => c.includes('skip'))) {
+            commands.push('`skip` - Skip this step');
+        }
+        return commands;
+    }
+    /**
+     * Format commands for Slack (uses backticks and bold)
+     */
+    static formatForSlack(commands) {
+        return commands.join('\n');
+    }
+    /**
+     * Format commands for Teams (uses ** for bold)
+     */
+    static formatForTeams(commands) {
+        return commands.join('\n');
+    }
+}
+//# sourceMappingURL=CommandParser.js.map

package/dist/parsers/CommandParser.js.map

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

package/dist/services/GatewayClient.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Shared Gateway API client for all communication connectors
+ * Provides consistent API access to the Align Gateway service
+ *
+ * This is the SINGLE SOURCE OF TRUTH for Gateway API access.
+ * DO NOT create duplicate GatewayRepository implementations in connector packages.
+ */
+import type { ConsensusResponse, ConversationalRequest, ConversationalResponse, CreateIssueParams, CreateIssueResult, Decision, DecisionSearchOptions, DecisionSearchResponse, DecisionSnapshot, EpicSuggestion, IngestPayload, IngestResponse, Issue, IssueSearchResult, JiraProject, JiraSettings, StreamEvent } from '../types/index.js';
+/**
+ * Jira credentials from Gateway
+ */
+export interface JiraCredentials {
+    base: string;
+    token: string;
+    cloudId?: string;
+}
+export interface GatewayClientConfig {
+    gatewayUrl: string;
+    bearerToken?: string;
+}
+/**
+ * Shared client for Gateway API operations
+ */
+export declare class GatewayClient {
+    private gatewayUrl;
+    private bearerToken?;
+    constructor(config: GatewayClientConfig);
+    /**
+     * Create from environment variables
+     */
+    static fromEnv(): GatewayClient;
+    /**
+     * Make authenticated request to Gateway
+     */
+    protected request<T>(path: string, options?: {
+        method?: string;
+        body?: unknown;
+        tenantId?: string;
+    }): Promise<T>;
+    /**
+     * Send ingest payload to Gateway for decision extraction
+     */
+    ingest(tenantId: string, payload: IngestPayload): Promise<IngestResponse>;
+    /**
+     * Send payload to Gateway for consensus analysis of a debate
+     */
+    consensus(tenantId: string, payload: IngestPayload): Promise<ConsensusResponse>;
+    /**
+     * Send payload to Gateway for conversational AI processing
+     * Detects intent (decision, consensus, question, etc.) and returns appropriate response
+     */
+    conversational(tenantId: string, payload: ConversationalRequest): Promise<ConversationalResponse>;
+    /**
+     * Stream conversational AI response via SSE.
+     * Yields events: { type: 'token', data: { text: string } }
+     *             or { type: 'complete', data: ConversationalResponse }
+     *             or { type: 'error', data: { error: string } }
+     */
+    streamConversational(tenantId: string, payload: ConversationalRequest): AsyncGenerator<StreamEvent>;
+    /**
+     * Fetch decision details by ID
+     */
+    getDecision(tenantId: string, decisionId: string): Promise<Decision>;
+    /**
+     * Search decisions using smart search (auto-selects semantic vs keyword)
+     */
+    searchDecisions(tenantId: string, query: string, options?: DecisionSearchOptions): Promise<DecisionSearchResponse>;
+    /**
+     * Fetch multiple decisions by IDs in a single request
+     */
+    getDecisions(tenantId: string, decisionIds: string[]): Promise<Decision[]>;
+    /**
+     * Search for issues across enabled connectors
+     */
+    searchIssues(tenantId: string, keywords: string, sourceText?: string): Promise<IssueSearchResult>;
+    /**
+     * Create an issue in the specified connector
+     */
+    createIssue(tenantId: string, params: CreateIssueParams): Promise<CreateIssueResult>;
+    /**
+     * Link a decision to an issue
+     */
+    linkDecisionToIssue(tenantId: string, decisionId: string, issue: Issue): Promise<void>;
+    /**
+     * Fetch JIRA tenant settings
+     */
+    getJiraSettings(tenantId: string): Promise<JiraSettings>;
+    /**
+     * Save JIRA tenant settings (e.g. default project key)
+     */
+    saveJiraSettings(tenantId: string, settings: {
+        default_project_key?: string;
+        default_project_id?: string;
+    }): Promise<void>;
+    /**
+     * Fetch available JIRA projects
+     */
+    getJiraProjects(tenantId: string): Promise<JiraProject[]>;
+    /**
+     * Get AI-suggested epic for a decision
+     */
+    suggestEpic(tenantId: string, projectKey: string, title: string, description: string, goals: string[]): Promise<EpicSuggestion | null>;
+    /**
+     * Get a decision snapshot by ID
+     */
+    getSnapshot(tenantId: string, decisionId: string): Promise<DecisionSnapshot>;
+    /**
+     * Update decision source URL
+     */
+    updateDecisionSourceUrl(tenantId: string, decisionId: string, sourceUrl: string): Promise<DecisionSnapshot>;
+    /**
+     * Fetch a single issue by key
+     */
+    fetchIssue(tenantId: string, issueKey: string): Promise<Issue>;
+    /**
+     * Add a comment to an issue
+     */
+    addCommentToIssue(tenantId: string, issueKey: string, comment: {
+        body: unknown;
+    }): Promise<void>;
+    /**
+     * Get Slack conversation state
+     */
+    getSlackConversationState(tenantId: string, channelId: string, threadTs: string): Promise<{
+        state: unknown;
+    } | null>;
+    /**
+     * Save Slack conversation state
+     */
+    saveSlackConversationState(tenantId: string, data: unknown): Promise<void>;
+    /**
+     * Query the Brain service
+     */
+    queryBrain(tenantId: string, question: string, context: unknown): Promise<{
+        answer: string;
+        sources?: unknown[];
+    }>;
+    /**
+     * Fetch Jira credentials for a tenant
+     */
+    fetchJiraCredentials(tenantId: string): Promise<JiraCredentials>;
+    /**
+     * Trigger a Slack shortcut
+     */
+    triggerSlackShortcut(tenantId: string, data: unknown): Promise<void>;
+}
+//# sourceMappingURL=GatewayClient.d.ts.map

package/dist/services/GatewayClient.d.ts.map

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