@almadar/agent 1.6.4 → 2.0.1

package/dist/tools/github.d.ts

@@ -0,0 +1,297 @@
+/**
+ * GitHub Tools for DeepAgent
+ *
+ * LangChain tools that wrap GitHubIntegration operations.
+ * These tools enable the agent to clone repos, create branches, commit, push, and create PRs.
+ */
+import { z } from 'zod';
+/**
+ * GitHub tools configuration
+ */
+export interface GitHubToolsConfig {
+    /** GitHub personal access token */
+    token: string;
+    /** Repository owner (e.g., 'octocat') */
+    owner?: string;
+    /** Repository name (e.g., 'hello-world') */
+    repo?: string;
+    /** Working directory for git operations */
+    workDir: string;
+}
+/**
+ * Create GitHub tools for the agent
+ */
+export declare function createGitHubTools(config: GitHubToolsConfig): {
+    github_clone: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        repoUrl: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        depth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        repoUrl: string;
+        branch?: string | undefined;
+        depth?: number | undefined;
+    }, {
+        repoUrl: string;
+        branch?: string | undefined;
+        depth?: number | undefined;
+    }>, {
+        repoUrl: string;
+        branch?: string | undefined;
+        depth?: number | undefined;
+    }, {
+        repoUrl: string;
+        branch?: string | undefined;
+        depth?: number | undefined;
+    }, string, "github_clone">;
+    github_create_branch: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        branchName: z.ZodString;
+        baseBranch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        branchName: string;
+        baseBranch?: string | undefined;
+    }, {
+        branchName: string;
+        baseBranch?: string | undefined;
+    }>, {
+        branchName: string;
+        baseBranch?: string | undefined;
+    }, {
+        branchName: string;
+        baseBranch?: string | undefined;
+    }, string, "github_create_branch">;
+    github_commit: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        message: z.ZodString;
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        files?: string[] | undefined;
+    }, {
+        message: string;
+        files?: string[] | undefined;
+    }>, {
+        message: string;
+        files?: string[] | undefined;
+    }, {
+        message: string;
+        files?: string[] | undefined;
+    }, string, "github_commit">;
+    github_push: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        branchName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        branchName: string;
+    }, {
+        branchName: string;
+    }>, {
+        branchName: string;
+    }, {
+        branchName: string;
+    }, string, "github_push">;
+    github_create_pr: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+        baseBranch: z.ZodString;
+        headBranch: z.ZodString;
+        draft: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        baseBranch: string;
+        title: string;
+        body: string;
+        headBranch: string;
+        draft?: boolean | undefined;
+    }, {
+        baseBranch: string;
+        title: string;
+        body: string;
+        headBranch: string;
+        draft?: boolean | undefined;
+    }>, {
+        baseBranch: string;
+        title: string;
+        body: string;
+        headBranch: string;
+        draft?: boolean | undefined;
+    }, {
+        baseBranch: string;
+        title: string;
+        body: string;
+        headBranch: string;
+        draft?: boolean | undefined;
+    }, string, "github_create_pr">;
+    github_list_issues: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        state: z.ZodOptional<z.ZodEnum<["open", "closed", "all"]>>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        state?: "open" | "closed" | "all" | undefined;
+        labels?: string[] | undefined;
+    }, {
+        limit?: number | undefined;
+        state?: "open" | "closed" | "all" | undefined;
+        labels?: string[] | undefined;
+    }>, {
+        limit?: number | undefined;
+        state?: "open" | "closed" | "all" | undefined;
+        labels?: string[] | undefined;
+    }, {
+        limit?: number | undefined;
+        state?: "open" | "closed" | "all" | undefined;
+        labels?: string[] | undefined;
+    }, string, "github_list_issues">;
+    github_get_issue: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        issueNumber: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        issueNumber: number;
+    }, {
+        issueNumber: number;
+    }>, {
+        issueNumber: number;
+    }, {
+        issueNumber: number;
+    }, string, "github_get_issue">;
+    github_get_pr_comments: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        prNumber: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        prNumber: number;
+    }, {
+        prNumber: number;
+    }>, {
+        prNumber: number;
+    }, {
+        prNumber: number;
+    }, string, "github_get_pr_comments">;
+};
+/**
+ * Create GitHub tools as array (for easy spreading into agent tools)
+ */
+export declare function createGitHubToolsArray(config: GitHubToolsConfig): (import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    repoUrl: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    repoUrl: string;
+    branch?: string | undefined;
+    depth?: number | undefined;
+}, {
+    repoUrl: string;
+    branch?: string | undefined;
+    depth?: number | undefined;
+}>, {
+    repoUrl: string;
+    branch?: string | undefined;
+    depth?: number | undefined;
+}, {
+    repoUrl: string;
+    branch?: string | undefined;
+    depth?: number | undefined;
+}, string, "github_clone"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    branchName: z.ZodString;
+    baseBranch: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    branchName: string;
+    baseBranch?: string | undefined;
+}, {
+    branchName: string;
+    baseBranch?: string | undefined;
+}>, {
+    branchName: string;
+    baseBranch?: string | undefined;
+}, {
+    branchName: string;
+    baseBranch?: string | undefined;
+}, string, "github_create_branch"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    message: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    files?: string[] | undefined;
+}, {
+    message: string;
+    files?: string[] | undefined;
+}>, {
+    message: string;
+    files?: string[] | undefined;
+}, {
+    message: string;
+    files?: string[] | undefined;
+}, string, "github_commit"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    branchName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    branchName: string;
+}, {
+    branchName: string;
+}>, {
+    branchName: string;
+}, {
+    branchName: string;
+}, string, "github_push"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodString;
+    baseBranch: z.ZodString;
+    headBranch: z.ZodString;
+    draft: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    baseBranch: string;
+    title: string;
+    body: string;
+    headBranch: string;
+    draft?: boolean | undefined;
+}, {
+    baseBranch: string;
+    title: string;
+    body: string;
+    headBranch: string;
+    draft?: boolean | undefined;
+}>, {
+    baseBranch: string;
+    title: string;
+    body: string;
+    headBranch: string;
+    draft?: boolean | undefined;
+}, {
+    baseBranch: string;
+    title: string;
+    body: string;
+    headBranch: string;
+    draft?: boolean | undefined;
+}, string, "github_create_pr"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    state: z.ZodOptional<z.ZodEnum<["open", "closed", "all"]>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    state?: "open" | "closed" | "all" | undefined;
+    labels?: string[] | undefined;
+}, {
+    limit?: number | undefined;
+    state?: "open" | "closed" | "all" | undefined;
+    labels?: string[] | undefined;
+}>, {
+    limit?: number | undefined;
+    state?: "open" | "closed" | "all" | undefined;
+    labels?: string[] | undefined;
+}, {
+    limit?: number | undefined;
+    state?: "open" | "closed" | "all" | undefined;
+    labels?: string[] | undefined;
+}, string, "github_list_issues"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    issueNumber: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    issueNumber: number;
+}, {
+    issueNumber: number;
+}>, {
+    issueNumber: number;
+}, {
+    issueNumber: number;
+}, string, "github_get_issue"> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    prNumber: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    prNumber: number;
+}, {
+    prNumber: number;
+}>, {
+    prNumber: number;
+}, {
+    prNumber: number;
+}, string, "github_get_pr_comments">)[];