@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/integrations/github.js

@@ -0,0 +1,237 @@
+import { createHmac, timingSafeEqual } from 'crypto';
+import { logger } from '../utils/logger.js';
+// ---------------------------------------------------------------------------
+// GitHubIntegration
+// ---------------------------------------------------------------------------
+/**
+ * GitHubIntegration — HMAC verification, event parsing, prompt generation,
+ * and outbound GitHub API calls (comments, reviews).
+ */
+export class GitHubIntegration {
+    /**
+     * Verify an HMAC-SHA256 webhook signature.
+     * GitHub sends: X-Hub-Signature-256: sha256=<hex>
+     */
+    static verifySignature(payload, signature, secret) {
+        if (!signature.startsWith('sha256='))
+            return false;
+        const sig = signature.slice('sha256='.length);
+        const expected = createHmac('sha256', secret).update(payload, 'utf8').digest('hex');
+        if (sig.length !== expected.length)
+            return false;
+        return timingSafeEqual(Buffer.from(sig, 'hex'), Buffer.from(expected, 'hex'));
+    }
+    /**
+     * Parse a GitHub webhook payload into a structured event.
+     * The event type comes from the X-GitHub-Event header.
+     */
+    static parseEvent(headers, body) {
+        const type = headers.get('x-github-event') ?? 'unknown';
+        const action = typeof body.action === 'string' ? body.action : '';
+        return { type, action, payload: body };
+    }
+    /**
+     * Convert a GitHub webhook event into an agent prompt.
+     * Returns null if the event does not warrant agent action.
+     */
+    static eventToPrompt(event) {
+        const { type, action, payload } = event;
+        switch (type) {
+            case 'pull_request': {
+                if (!['opened', 'synchronize', 'review_requested'].includes(action))
+                    return null;
+                const pr = payload.pull_request;
+                const repo = payload.repository;
+                if (!pr || !repo)
+                    return null;
+                const prNumber = pr.number;
+                const prTitle = pr.title;
+                const prBody = pr.body ?? '';
+                const baseBranch = pr.base?.ref;
+                const headBranch = pr.head?.ref;
+                const repoFullName = repo.full_name;
+                const diffUrl = pr.diff_url;
+                return [
+                    `GitHub Pull Request ${action === 'review_requested' ? 'review requested' : action} on ${repoFullName}.`,
+                    `PR #${prNumber}: "${prTitle}"`,
+                    `Base: ${baseBranch} ← Head: ${headBranch}`,
+                    prBody ? `Description:\n${prBody}` : '',
+                    `Diff URL: ${diffUrl}`,
+                    '',
+                    'Please review this pull request:',
+                    '- Check for correctness, logic errors, and edge cases',
+                    '- Identify potential security issues',
+                    '- Suggest improvements to code quality and readability',
+                    '- Note any missing tests or documentation',
+                    `After analysis, post a review comment on PR #${prNumber} of ${repoFullName}.`,
+                ].filter(Boolean).join('\n');
+            }
+            case 'issues': {
+                if (!['opened', 'assigned'].includes(action))
+                    return null;
+                const issue = payload.issue;
+                const repo = payload.repository;
+                if (!issue || !repo)
+                    return null;
+                const issueNumber = issue.number;
+                const issueTitle = issue.title;
+                const issueBody = issue.body ?? '';
+                const repoFullName = repo.full_name;
+                const labels = Array.isArray(issue.labels)
+                    ? issue.labels.map((l) => l.name).join(', ')
+                    : '';
+                return [
+                    `GitHub Issue ${action} on ${repoFullName}.`,
+                    `Issue #${issueNumber}: "${issueTitle}"`,
+                    labels ? `Labels: ${labels}` : '',
+                    issueBody ? `Description:\n${issueBody}` : '',
+                    '',
+                    'Please analyze this issue and suggest an implementation approach:',
+                    '- Identify relevant files and code areas',
+                    '- Outline a solution strategy',
+                    '- Note any potential complications or dependencies',
+                    `Post a comment on issue #${issueNumber} of ${repoFullName} with your analysis.`,
+                ].filter(Boolean).join('\n');
+            }
+            case 'check_run': {
+                if (action !== 'completed')
+                    return null;
+                const checkRun = payload.check_run;
+                if (!checkRun || checkRun.conclusion !== 'failure')
+                    return null;
+                const repo = payload.repository;
+                if (!repo)
+                    return null;
+                const checkName = checkRun.name;
+                const detailsUrl = checkRun.details_url;
+                const headSha = checkRun.head_sha?.slice(0, 8);
+                const repoFullName = repo.full_name;
+                const output = checkRun.output;
+                const summary = output?.summary ?? '';
+                return [
+                    `CI check "${checkName}" failed on ${repoFullName} at commit ${headSha}.`,
+                    summary ? `Summary:\n${summary}` : '',
+                    detailsUrl ? `Details: ${detailsUrl}` : '',
+                    '',
+                    'Please analyze this CI failure:',
+                    '- Identify the root cause of the failure',
+                    '- Suggest fixes',
+                    '- Check if related code changes could have introduced this failure',
+                ].filter(Boolean).join('\n');
+            }
+            case 'check_suite': {
+                if (action !== 'completed')
+                    return null;
+                const suite = payload.check_suite;
+                if (!suite || suite.conclusion !== 'failure')
+                    return null;
+                const repo = payload.repository;
+                if (!repo)
+                    return null;
+                const repoFullName = repo.full_name;
+                const headSha = suite.head_sha?.slice(0, 8);
+                const headBranch = suite.head_branch;
+                return [
+                    `CI check suite failed on ${repoFullName}${headBranch ? ` (branch: ${headBranch})` : ''} at commit ${headSha}.`,
+                    '',
+                    'Please analyze the CI failure and identify what caused the check suite to fail.',
+                ].filter(Boolean).join('\n');
+            }
+            case 'push': {
+                const ref = payload.ref;
+                if (!ref || !['refs/heads/main', 'refs/heads/master'].includes(ref))
+                    return null;
+                const repo = payload.repository;
+                if (!repo)
+                    return null;
+                const repoFullName = repo.full_name;
+                const commits = Array.isArray(payload.commits)
+                    ? payload.commits
+                    : [];
+                const commitMessages = commits
+                    .slice(0, 20)
+                    .map((c) => `- ${c.id ? c.id.slice(0, 8) : '?'}: ${c.message}`)
+                    .join('\n');
+                return [
+                    `New commits pushed to ${ref} on ${repoFullName}.`,
+                    commits.length > 0 ? `Commits:\n${commitMessages}` : '',
+                    '',
+                    'Please generate a changelog entry for these commits:',
+                    '- Group changes by type (feat, fix, chore, docs, etc.)',
+                    '- Write user-facing descriptions',
+                    '- Highlight breaking changes if any',
+                ].filter(Boolean).join('\n');
+            }
+            case 'issue_comment': {
+                if (action !== 'created')
+                    return null;
+                const comment = payload.comment;
+                const issue = payload.issue;
+                const repo = payload.repository;
+                if (!comment || !issue || !repo)
+                    return null;
+                const body = comment.body ?? '';
+                // Only respond to comments mentioning the bot
+                if (!body.includes('@bot') && !body.includes('@goodvibes'))
+                    return null;
+                const issueNumber = issue.number;
+                const repoFullName = repo.full_name;
+                const isPR = Boolean(issue.pull_request);
+                return [
+                    `Bot mention in ${isPR ? 'PR' : 'issue'} #${issueNumber} on ${repoFullName}.`,
+                    `Comment:\n${body}`,
+                    '',
+                    'Please respond to this comment. Address the specific request or question raised.',
+                    `Post your response as a comment on ${isPR ? 'PR' : 'issue'} #${issueNumber} of ${repoFullName}.`,
+                ].filter(Boolean).join('\n');
+            }
+            default:
+                return null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Outbound GitHub API
+    // -------------------------------------------------------------------------
+    /**
+     * Post a comment on a pull request.
+     */
+    async postPRComment(owner, repo, prNumber, body, token) {
+        await this.githubPost(`https://api.github.com/repos/${owner}/${repo}/issues/${prNumber}/comments`, { body }, token);
+    }
+    /**
+     * Post a review on a pull request.
+     */
+    async postPRReview(owner, repo, prNumber, body, event, token) {
+        await this.githubPost(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/reviews`, { body, event }, token);
+    }
+    /**
+     * Post a comment on an issue.
+     */
+    async postIssueComment(owner, repo, issueNumber, body, token) {
+        await this.githubPost(`https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}/comments`, { body }, token);
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    async githubPost(url, data, token) {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Accept': 'application/vnd.github+json',
+                'Content-Type': 'application/json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            logger.error('GitHubIntegration: API request failed', {
+                url,
+                status: res.status,
+                body: text.slice(0, 500),
+            });
+            throw new Error(`GitHub API error ${res.status}: ${text.slice(0, 200)}`);
+        }
+    }
+}

package/dist/_internal/platform/integrations/ntfy.d.ts

@@ -0,0 +1,44 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+export interface NtfyPublishOptions {
+    readonly title?: string;
+    readonly priority?: 1 | 2 | 3 | 4 | 5;
+    readonly tags?: readonly string[];
+    readonly click?: string;
+    readonly attach?: string;
+    readonly actions?: readonly string[];
+}
+export interface NtfyMessage {
+    readonly id?: string;
+    readonly time?: number;
+    readonly event: 'open' | 'keepalive' | 'message' | 'message_delete' | 'message_clear' | 'poll_request' | string;
+    readonly topic?: string;
+    readonly message?: string;
+    readonly title?: string;
+    readonly priority?: number;
+    readonly tags?: readonly string[];
+    readonly click?: string;
+    readonly actions?: readonly unknown[];
+    readonly [key: string]: unknown;
+}
+export interface NtfySubscribeOptions {
+    readonly since?: string;
+    readonly scheduled?: boolean;
+    readonly poll?: boolean;
+    readonly filters?: Record<string, string | number | boolean | readonly string[]>;
+    readonly signal?: AbortSignal;
+}
+export interface NtfyWebSocketOptions extends NtfySubscribeOptions {
+    readonly WebSocketImpl?: typeof WebSocket;
+}
+export declare class NtfyIntegration {
+    private readonly baseUrl;
+    private readonly token?;
+    constructor(baseUrl?: string, token?: string | undefined);
+    publish(topic: string, message: string, options?: NtfyPublishOptions): Promise<void>;
+    buildSubscribeUrl(topic: string, mode?: 'json' | 'sse' | 'raw' | 'ws', options?: NtfySubscribeOptions): string;
+    poll(topic: string, options?: Omit<NtfySubscribeOptions, 'poll'>): Promise<NtfyMessage[]>;
+    subscribeJsonStream(topic: string, onMessage: (message: NtfyMessage) => void | Promise<void>, options?: NtfySubscribeOptions): Promise<void>;
+    connectWebSocket(topic: string, onMessage: (message: NtfyMessage) => void | Promise<void>, options?: NtfyWebSocketOptions): WebSocket;
+    private buildAuthHeaders;
+}
+//# sourceMappingURL=ntfy.d.ts.map

package/dist/_internal/platform/integrations/ntfy.d.ts.map

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

package/dist/_internal/platform/integrations/ntfy.js

@@ -0,0 +1,129 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+export class NtfyIntegration {
+    baseUrl;
+    token;
+    constructor(baseUrl = 'https://ntfy.sh', token) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+    }
+    async publish(topic, message, options = {}) {
+        const target = `${this.baseUrl.replace(/\/+$/, '')}/${encodeURIComponent(topic)}`;
+        const headers = new Headers({
+            'Content-Type': 'text/plain; charset=utf-8',
+        });
+        if (options.title)
+            headers.set('Title', options.title);
+        if (options.priority)
+            headers.set('Priority', String(options.priority));
+        if (options.tags?.length)
+            headers.set('Tags', options.tags.join(','));
+        if (options.click)
+            headers.set('Click', options.click);
+        if (options.attach)
+            headers.set('Attach', options.attach);
+        if (options.actions?.length)
+            headers.set('Actions', options.actions.join(';'));
+        if (this.token)
+            headers.set('Authorization', `Bearer ${this.token}`);
+        const response = await fetch(target, {
+            method: 'POST',
+            headers,
+            body: message,
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`NtfyIntegration.publish failed (${response.status}): ${body}`);
+        }
+    }
+    buildSubscribeUrl(topic, mode = 'json', options = {}) {
+        const pathTopic = topic.split(',').map((entry) => encodeURIComponent(entry.trim())).filter(Boolean).join(',');
+        const url = new URL(`${this.baseUrl.replace(/\/+$/, '')}/${pathTopic}/${mode}`);
+        if (options.poll)
+            url.searchParams.set('poll', '1');
+        if (options.since)
+            url.searchParams.set('since', options.since);
+        if (options.scheduled)
+            url.searchParams.set('scheduled', '1');
+        for (const [key, value] of Object.entries(options.filters ?? {})) {
+            url.searchParams.set(key, Array.isArray(value) ? value.join(',') : String(value));
+        }
+        if (mode === 'ws') {
+            url.protocol = url.protocol === 'http:' ? 'ws:' : 'wss:';
+        }
+        return url.toString();
+    }
+    async poll(topic, options = {}) {
+        const url = this.buildSubscribeUrl(topic, 'json', { ...options, poll: true });
+        const headers = this.buildAuthHeaders();
+        const response = await fetch(url, {
+            method: 'GET',
+            headers,
+            signal: options.signal,
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`NtfyIntegration.poll failed (${response.status}): ${body}`);
+        }
+        const raw = await response.text();
+        return raw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    async subscribeJsonStream(topic, onMessage, options = {}) {
+        const url = this.buildSubscribeUrl(topic, 'json', options);
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.buildAuthHeaders(),
+            signal: options.signal,
+        });
+        if (!response.ok || !response.body) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`NtfyIntegration.subscribeJsonStream failed (${response.status}): ${body}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split(/\r?\n/);
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                await onMessage(JSON.parse(trimmed));
+            }
+        }
+        if (buffer.trim()) {
+            await onMessage(JSON.parse(buffer.trim()));
+        }
+    }
+    connectWebSocket(topic, onMessage, options = {}) {
+        const WebSocketImpl = options.WebSocketImpl ?? WebSocket;
+        const socket = new WebSocketImpl(this.buildSubscribeUrl(topic, 'ws', options));
+        socket.addEventListener('message', (event) => {
+            void (async () => {
+                const raw = typeof event.data === 'string'
+                    ? event.data
+                    : event.data instanceof Buffer
+                        ? event.data.toString('utf-8')
+                        : String(event.data);
+                if (!raw.trim())
+                    return;
+                await onMessage(JSON.parse(raw));
+            })();
+        });
+        return socket;
+    }
+    buildAuthHeaders() {
+        const headers = new Headers();
+        if (this.token)
+            headers.set('Authorization', `Bearer ${this.token}`);
+        return headers;
+    }
+}

package/dist/_internal/platform/integrations/slack.d.ts

@@ -0,0 +1,190 @@
+export interface SlackSlashCommand {
+    type: 'slash_command';
+    command: string;
+    text: string;
+    userId: string;
+    userName: string;
+    channelId: string;
+    channelName: string;
+    teamId: string;
+    responseUrl: string;
+}
+export interface SlackInteraction {
+    type: 'interaction';
+    interactionType: string;
+    payload: Record<string, unknown>;
+    userId: string;
+    channelId: string;
+    responseUrl?: string;
+}
+export interface SlackEventCallback {
+    type: 'event_callback';
+    eventType: string;
+    text: string;
+    userId: string;
+    channelId: string;
+    teamId: string;
+    threadTs?: string;
+    eventTs?: string;
+    raw: Record<string, unknown>;
+}
+export type SlackEvent = SlackSlashCommand | SlackInteraction | SlackEventCallback;
+export interface SlackOAuthAuthorizeOptions {
+    readonly clientId: string;
+    readonly redirectUri?: string;
+    readonly scopes?: readonly string[];
+    readonly userScopes?: readonly string[];
+    readonly state?: string;
+    readonly teamId?: string;
+}
+export interface SlackOAuthExchangeOptions {
+    readonly clientId: string;
+    readonly clientSecret: string;
+    readonly code: string;
+    readonly redirectUri?: string;
+}
+export interface SlackOAuthExchangeResult {
+    readonly ok: boolean;
+    readonly access_token?: string;
+    readonly bot_user_id?: string;
+    readonly app_id?: string;
+    readonly team?: {
+        readonly id?: string;
+        readonly name?: string;
+    };
+    readonly authed_user?: Record<string, unknown>;
+    readonly error?: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackAuthTestResult {
+    readonly ok: boolean;
+    readonly url?: string;
+    readonly team?: string;
+    readonly user?: string;
+    readonly team_id?: string;
+    readonly user_id?: string;
+    readonly bot_id?: string;
+    readonly error?: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackSocketModeConnection {
+    readonly ok: boolean;
+    readonly url?: string;
+    readonly error?: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackConversationRecord {
+    readonly id: string;
+    readonly name?: string;
+    readonly is_channel?: boolean;
+    readonly is_group?: boolean;
+    readonly is_im?: boolean;
+    readonly is_mpim?: boolean;
+    readonly is_archived?: boolean;
+    readonly num_members?: number;
+    readonly [key: string]: unknown;
+}
+export interface SlackUserRecord {
+    readonly id: string;
+    readonly name?: string;
+    readonly real_name?: string;
+    readonly is_bot?: boolean;
+    readonly deleted?: boolean;
+    readonly profile?: Record<string, unknown>;
+    readonly [key: string]: unknown;
+}
+export interface SlackCursorPage<T> {
+    readonly ok: boolean;
+    readonly entries: readonly T[];
+    readonly nextCursor: string;
+    readonly error?: string;
+}
+export interface SlackSocketModeEnvelope {
+    readonly envelope_id?: string;
+    readonly type?: string;
+    readonly accepts_response_payload?: boolean;
+    readonly payload?: Record<string, unknown>;
+    readonly [key: string]: unknown;
+}
+export interface SlackSocketModeClientOptions {
+    readonly appToken: string;
+    readonly integration: SlackIntegration;
+    readonly onEnvelope: (envelope: SlackSocketModeEnvelope, client: SlackSocketModeClient) => void | Promise<void>;
+    readonly WebSocketImpl?: typeof WebSocket;
+}
+/**
+ * SlackIntegration — handles inbound webhook verification/parsing and outbound
+ * message posting for Slack slash commands and interactions.
+ *
+ * Env vars:
+ *   SLACK_WEBHOOK_URL      — incoming webhook URL for outbound posting
+ *   SLACK_BOT_TOKEN        — Bot User OAuth token (xoxb-…) for API calls
+ *   SLACK_SIGNING_SECRET   — used to verify X-Slack-Signature on inbound
+ */
+export declare class SlackIntegration {
+    private webhookUrl?;
+    private botToken?;
+    constructor(webhookUrl?: string | undefined, botToken?: string | undefined);
+    static buildOAuthAuthorizeUrl(options: SlackOAuthAuthorizeOptions): string;
+    authTest(token?: string | undefined): Promise<SlackAuthTestResult>;
+    appsConnectionsOpen(appToken: string): Promise<SlackSocketModeConnection>;
+    exchangeOAuthCode(options: SlackOAuthExchangeOptions): Promise<SlackOAuthExchangeResult>;
+    listConversations(options?: {
+        readonly token?: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+        readonly types?: readonly string[];
+        readonly excludeArchived?: boolean;
+        readonly teamId?: string;
+    }): Promise<SlackCursorPage<SlackConversationRecord>>;
+    listUsers(options?: {
+        readonly token?: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+        readonly teamId?: string;
+    }): Promise<SlackCursorPage<SlackUserRecord>>;
+    /**
+     * Verify an inbound Slack request using HMAC-SHA256.
+     * Slack signs requests with: v0={HMAC-SHA256("v0:{timestamp}:{body}")}
+     */
+    verifySignature(body: string, timestamp: string, signature: string, signingSecret: string): boolean;
+    /**
+     * Parse an inbound Slack payload into a typed SlackEvent.
+     * Supports slash commands (application/x-www-form-urlencoded) and
+     * interaction payloads (JSON-encoded in a "payload" field).
+     */
+    parseEvent(body: Record<string, unknown>): SlackEvent;
+    private callApi;
+    /**
+     * Post a message to a channel using the Slack Web API (chat.postMessage).
+     * Requires SLACK_BOT_TOKEN.
+     */
+    postMessage(channel: string, text: string, blocks?: unknown[]): Promise<void>;
+    /**
+     * Post a message via an Incoming Webhook URL.
+     * Requires SLACK_WEBHOOK_URL or a URL passed at call time.
+     */
+    postWebhook(text: string, blocks?: unknown[], url?: string): Promise<void>;
+    /**
+     * Format an agent result as Slack Block Kit blocks.
+     */
+    formatAgentResult(agentId: string, task: string, result: string): unknown[];
+    /**
+     * Format a session summary as Slack Block Kit blocks.
+     */
+    formatSessionSummary(sessionId: string, messageCount: number, tokensUsed: number): unknown[];
+}
+export declare class SlackSocketModeClient {
+    private readonly options;
+    private socket;
+    private started;
+    private readonly WebSocketImpl;
+    constructor(options: SlackSocketModeClientOptions);
+    start(): Promise<SlackSocketModeConnection>;
+    stop(): void;
+    ack(envelopeId: string, payload?: Record<string, unknown>): void;
+    send(payload: Record<string, unknown>): void;
+    get isStarted(): boolean;
+    private handleMessage;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/_internal/platform/integrations/slack.d.ts.map

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