@almadar/integrations 2.0.1 → 2.0.3

package/dist/integrations/github/index.d.ts

@@ -0,0 +1,326 @@
+import { B as BaseIntegration, b as IntegrationConfig, c as IntegrationResult } from '../../BaseIntegration-DNSuiUnG.js';
+
+/**
+ * GitHub integration types
+ */
+/**
+ * GitHub clone repository parameters
+ */
+interface GitHubCloneParams {
+    /** Repository URL (e.g., https://github.com/owner/repo) */
+    repoUrl: string;
+    /** Target directory for clone */
+    targetDir: string;
+    /** Optional branch to checkout */
+    branch?: string;
+    /** Clone depth (default: 1 for shallow clone) */
+    depth?: number;
+}
+/**
+ * GitHub create branch parameters
+ */
+interface GitHubCreateBranchParams {
+    /** Branch name to create */
+    branchName: string;
+    /** Base branch (defaults to current branch) */
+    baseBranch?: string;
+    /** Working directory (defaults to workspace root) */
+    workDir?: string;
+}
+/**
+ * GitHub commit parameters
+ */
+interface GitHubCommitParams {
+    /** Commit message */
+    message: string;
+    /** Optional specific files to commit (defaults to all changes) */
+    files?: string[];
+    /** Working directory (defaults to workspace root) */
+    workDir?: string;
+}
+/**
+ * GitHub push parameters
+ */
+interface GitHubPushParams {
+    /** Branch name to push */
+    branchName: string;
+    /** Force push (NEVER set to true in agent context) */
+    force?: boolean;
+    /** Working directory (defaults to workspace root) */
+    workDir?: string;
+}
+/**
+ * GitHub create pull request parameters
+ */
+interface GitHubCreatePRParams {
+    /** PR title */
+    title: string;
+    /** PR body/description */
+    body: string;
+    /** Base branch (e.g., 'main') */
+    baseBranch: string;
+    /** Head branch (feature branch) */
+    headBranch: string;
+    /** Draft PR (default: false) */
+    draft?: boolean;
+}
+/**
+ * GitHub get PR comments parameters
+ */
+interface GitHubGetPRCommentsParams {
+    /** Pull request number */
+    prNumber: number;
+}
+/**
+ * GitHub list issues parameters
+ */
+interface GitHubListIssuesParams {
+    /** Issue state filter */
+    state?: 'open' | 'closed' | 'all';
+    /** Labels to filter by */
+    labels?: string[];
+    /** Maximum number of issues to return */
+    limit?: number;
+}
+/**
+ * GitHub get issue parameters
+ */
+interface GitHubGetIssueParams {
+    /** Issue number */
+    issueNumber: number;
+}
+/**
+ * GitHub pull request response
+ */
+interface GitHubPullRequest {
+    /** PR number */
+    number: number;
+    /** PR URL */
+    url: string;
+    /** PR title */
+    title: string;
+    /** PR state */
+    state: string;
+    /** Head branch */
+    head: {
+        ref: string;
+    };
+    /** Base branch */
+    base: {
+        ref: string;
+    };
+}
+/**
+ * GitHub issue response
+ */
+interface GitHubIssue {
+    /** Issue number */
+    number: number;
+    /** Issue URL */
+    url: string;
+    /** Issue title */
+    title: string;
+    /** Issue body */
+    body: string | null;
+    /** Issue state */
+    state: string;
+    /** Issue labels */
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    /** Created at */
+    created_at: string;
+    /** Updated at */
+    updated_at: string;
+}
+/**
+ * GitHub comment response
+ */
+interface GitHubComment {
+    /** Comment ID */
+    id: number;
+    /** Comment body */
+    body: string;
+    /** Comment author */
+    user: {
+        login: string;
+    };
+    /** Created at */
+    created_at: string;
+}
+/**
+ * GitHub rate limit info
+ */
+interface GitHubRateLimit {
+    /** Requests remaining */
+    remaining: number;
+    /** Total requests allowed */
+    limit: number;
+    /** Reset timestamp */
+    reset: number;
+}
+
+/**
+ * Git CLI operations for GitHub integration
+ */
+
+/**
+ * Clone a repository
+ */
+declare function cloneRepo(params: GitHubCloneParams, token: string): Promise<void>;
+/**
+ * Create a new branch
+ */
+declare function createBranch(params: GitHubCreateBranchParams, workDir: string): Promise<void>;
+/**
+ * Commit changes
+ */
+declare function commit(params: GitHubCommitParams, workDir: string): Promise<void>;
+/**
+ * Push branch to remote
+ */
+declare function push(params: GitHubPushParams, workDir: string, token: string): Promise<void>;
+/**
+ * Get current branch name
+ */
+declare function getCurrentBranch(workDir: string): Promise<string>;
+/**
+ * Check if working directory has uncommitted changes
+ */
+declare function hasUncommittedChanges(workDir: string): Promise<boolean>;
+
+/**
+ * GitHub REST API client
+ */
+
+/**
+ * GitHub API client configuration
+ */
+interface GitHubAPIConfig {
+    token: string;
+    owner: string;
+    repo: string;
+}
+/**
+ * Create a pull request
+ */
+declare function createPR(params: GitHubCreatePRParams, config: GitHubAPIConfig): Promise<GitHubPullRequest>;
+/**
+ * Get pull request comments
+ */
+declare function getPRComments(params: GitHubGetPRCommentsParams, config: GitHubAPIConfig): Promise<GitHubComment[]>;
+/**
+ * List repository issues
+ */
+declare function listIssues(params: GitHubListIssuesParams, config: GitHubAPIConfig): Promise<GitHubIssue[]>;
+/**
+ * Get issue details
+ */
+declare function getIssue(params: GitHubGetIssueParams, config: GitHubAPIConfig): Promise<{
+    issue: GitHubIssue;
+    comments: GitHubComment[];
+}>;
+/**
+ * Get current rate limit status
+ */
+declare function getRateLimit(config: GitHubAPIConfig): Promise<GitHubRateLimit>;
+/**
+ * A commit from the GitHub API with optional stats.
+ */
+interface GitHubCommit {
+    sha: string;
+    message: string;
+    author: {
+        name: string;
+        email: string;
+        date: string;
+    };
+    stats?: {
+        additions: number;
+        deletions: number;
+        total: number;
+    };
+}
+/**
+ * List commits for a repository, optionally filtered by file path.
+ */
+declare function listCommits(config: GitHubAPIConfig, options?: {
+    path?: string;
+    perPage?: number;
+    page?: number;
+}): Promise<GitHubCommit[]>;
+/**
+ * Get the diff for a specific commit as a unified diff string.
+ */
+declare function getCommitDiff(config: GitHubAPIConfig, sha: string): Promise<string>;
+/**
+ * Get a file's content at a specific commit SHA.
+ * Returns null if the file doesn't exist at that commit.
+ */
+declare function getFileAtCommit(config: GitHubAPIConfig, path: string, sha: string): Promise<string | null>;
+/**
+ * Parse repository owner and name from URL
+ */
+declare function parseRepoUrl(repoUrl: string): {
+    owner: string;
+    repo: string;
+};
+
+/**
+ * GitHub Integration for Almadar
+ * Provides git operations and GitHub API access for the agent
+ */
+
+/**
+ * GitHub integration class
+ */
+declare class GitHubIntegration extends BaseIntegration {
+    private token;
+    private owner;
+    private repo;
+    private workDir;
+    constructor(config: IntegrationConfig);
+    /**
+     * Execute a GitHub action
+     */
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /**
+     * Clone a repository
+     */
+    private cloneRepo;
+    /**
+     * Create a branch
+     */
+    private createBranch;
+    /**
+     * Commit changes
+     */
+    private commit;
+    /**
+     * Push branch
+     */
+    private push;
+    /**
+     * Create a pull request
+     */
+    private createPR;
+    /**
+     * Get PR comments
+     */
+    private getPRComments;
+    /**
+     * List issues
+     */
+    private listIssues;
+    /**
+     * Get issue details
+     */
+    private getIssue;
+    /**
+     * Get API config for GitHub API calls
+     */
+    private getAPIConfig;
+}
+
+export { type GitHubAPIConfig, type GitHubCloneParams, type GitHubComment, type GitHubCommit, type GitHubCommitParams, type GitHubCreateBranchParams, type GitHubCreatePRParams, type GitHubGetIssueParams, type GitHubGetPRCommentsParams, GitHubIntegration, type GitHubIssue, type GitHubListIssuesParams, type GitHubPullRequest, type GitHubPushParams, type GitHubRateLimit, cloneRepo, commit, createBranch, createPR, getCommitDiff, getCurrentBranch, getFileAtCommit, getIssue, getPRComments, getRateLimit, hasUncommittedChanges, listCommits, listIssues, parseRepoUrl, push };