@almadar/integrations 2.0.2 → 2.0.3

package/dist/{factory-Bi5eLpB0.d.ts → BaseIntegration-DNSuiUnG.d.ts}

@@ -124,38 +124,4 @@ declare abstract class BaseIntegration {
     protected executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-/**
- * Factory for creating and managing integration instances
- */
-declare class IntegrationFactory {
-    private instances;
-    private configs;
-    /**
-     * Configure an integration (doesn't instantiate yet)
-     */
-    configure(name: string, config: Omit<IntegrationConfig, 'name'>): void;
-    /**
-     * Get or create an integration instance
-     */
-    get(name: string): BaseIntegration;
-    /**
-     * Execute an action on an integration
-     */
-    execute(integration: string, action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
-    /**
-     * Check if integration is configured
-     */
-    isConfigured(name: string): boolean;
-    /**
-     * Clear all instances (useful for testing)
-     */
-    clear(): void;
-    /**
-     * Clear all instances and configs
-     */
-    reset(): void;
-}
-declare function getIntegrationFactory(): IntegrationFactory;
-declare function resetIntegrationFactory(): void;
-
-export { BaseIntegration as B, type IntegrationLogger as I, type ValidationError as V, type IntegrationErrorCode as a, type IntegrationConfig as b, type IntegrationResult as c, IntegrationError as d, IntegrationFactory as e, type ValidationResult as f, getIntegrationFactory as g, resetIntegrationFactory as r, validateParams as v };
+export { BaseIntegration as B, type IntegrationLogger as I, type ValidationError as V, type IntegrationErrorCode as a, type IntegrationConfig as b, type IntegrationResult as c, IntegrationError as d, type ValidationResult as e, validateParams as v };

package/dist/factory-B1QtCI_c.d.ts

@@ -0,0 +1,37 @@
+import { b as IntegrationConfig, B as BaseIntegration, c as IntegrationResult } from './BaseIntegration-DNSuiUnG.js';
+
+/**
+ * Factory for creating and managing integration instances
+ */
+declare class IntegrationFactory {
+    private instances;
+    private configs;
+    /**
+     * Configure an integration (doesn't instantiate yet)
+     */
+    configure(name: string, config: Omit<IntegrationConfig, 'name'>): void;
+    /**
+     * Get or create an integration instance
+     */
+    get(name: string): BaseIntegration;
+    /**
+     * Execute an action on an integration
+     */
+    execute(integration: string, action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /**
+     * Check if integration is configured
+     */
+    isConfigured(name: string): boolean;
+    /**
+     * Clear all instances (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Clear all instances and configs
+     */
+    reset(): void;
+}
+declare function getIntegrationFactory(): IntegrationFactory;
+declare function resetIntegrationFactory(): void;
+
+export { IntegrationFactory as I, getIntegrationFactory as g, resetIntegrationFactory as r };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { I as IntegrationLogger, a as IntegrationErrorCode, b as IntegrationConfig, B as BaseIntegration, c as IntegrationResult } from './factory-Bi5eLpB0.js';
-export { d as IntegrationError, e as IntegrationFactory, V as ValidationError, f as ValidationResult, g as getIntegrationFactory, r as resetIntegrationFactory, v as validateParams } from './factory-Bi5eLpB0.js';
+import { I as IntegrationLogger, a as IntegrationErrorCode, b as IntegrationConfig, B as BaseIntegration, c as IntegrationResult } from './BaseIntegration-DNSuiUnG.js';
+export { d as IntegrationError, V as ValidationError, e as ValidationResult, v as validateParams } from './BaseIntegration-DNSuiUnG.js';
+export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-B1QtCI_c.js';
+export { GitHubIntegration } from './integrations/github/index.js';
 
 /**
  * Console-based logger implementation
@@ -140,62 +142,6 @@ declare class DeepAgentIntegration extends BaseIntegration {
     private request;
 }
 
-/**
- * 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;
-}
-
 /**
  * CLI integration for Almadar CLI commands.
  *
@@ -365,4 +311,4 @@ declare class DockerIntegration extends BaseIntegration {
     private list;
 }
 
-export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, withRetry };
+export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, DockerIntegration, EmailIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, withRetry };

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 };