@loopstack/github-module 0.1.0

package/dist/tools/actions/github-list-workflow-runs.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-list-workflow-runs.tool.js","sourceRoot":"","sources":["../../../src/tools/actions/github-list-workflow-runs.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/actions/github-trigger-workflow.tool.d.ts

@@ -0,0 +1,15 @@
+import { RunContext, ToolInterface, ToolResult } from '@loopstack/common';
+export type GitHubTriggerWorkflowArgs = {
+    owner: string;
+    repo: string;
+    workflowId: string;
+    ref: string;
+    inputs?: Record<string, string>;
+};
+export declare class GitHubTriggerWorkflowTool implements ToolInterface {
+    private readonly logger;
+    private tokenStore;
+    args: GitHubTriggerWorkflowArgs;
+    execute(args: GitHubTriggerWorkflowArgs, ctx: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=github-trigger-workflow.tool.d.ts.map

package/dist/tools/actions/github-trigger-workflow.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-trigger-workflow.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/actions/github-trigger-workflow.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,UAAU,EAAQ,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,qBAMa,yBAA0B,YAAW,aAAa;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAGrE,OAAO,CAAC,UAAU,CAAkB;IAapC,IAAI,EAAE,yBAAyB,CAAC;IAE1B,OAAO,CAAC,IAAI,EAAE,yBAAyB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CA0DrF"}

package/dist/tools/actions/github-trigger-workflow.tool.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var GitHubTriggerWorkflowTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubTriggerWorkflowTool = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const oauth_module_1 = require("@loopstack/oauth-module");
+let GitHubTriggerWorkflowTool = GitHubTriggerWorkflowTool_1 = class GitHubTriggerWorkflowTool {
+    logger = new common_1.Logger(GitHubTriggerWorkflowTool_1.name);
+    tokenStore;
+    args;
+    async execute(args, ctx) {
+        const accessToken = await this.tokenStore.getValidAccessToken(ctx.userId, 'github');
+        if (!accessToken) {
+            return {
+                data: {
+                    error: 'unauthorized',
+                    message: 'No valid GitHub token found. Please authenticate first.',
+                },
+            };
+        }
+        const requestBody = {
+            ref: args.ref,
+        };
+        if (args.inputs)
+            requestBody.inputs = args.inputs;
+        const url = `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}/actions/workflows/${encodeURIComponent(args.workflowId)}/dispatches`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (response.status === 401 || response.status === 403) {
+            this.logger.warn(`GitHub API returned ${response.status} for user ${ctx.userId}`);
+            return {
+                data: {
+                    error: '401',
+                    message: 'GitHub token was rejected. Please re-authenticate.',
+                },
+            };
+        }
+        if (!response.ok && response.status !== 204) {
+            const body = await response.text();
+            this.logger.error(`GitHub API error: ${response.status} ${body}`);
+            return {
+                data: {
+                    error: 'api_error',
+                    message: `GitHub API error: ${response.statusText}`,
+                },
+            };
+        }
+        return {
+            data: {
+                triggered: true,
+                message: 'Workflow dispatch event triggered successfully.',
+            },
+        };
+    }
+};
+exports.GitHubTriggerWorkflowTool = GitHubTriggerWorkflowTool;
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", oauth_module_1.OAuthTokenStore)
+], GitHubTriggerWorkflowTool.prototype, "tokenStore", void 0);
+__decorate([
+    (0, common_2.Input)({
+        schema: zod_1.z
+            .object({
+            owner: zod_1.z.string(),
+            repo: zod_1.z.string(),
+            workflowId: zod_1.z.string(),
+            ref: zod_1.z.string(),
+            inputs: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+        })
+            .strict(),
+    }),
+    __metadata("design:type", Object)
+], GitHubTriggerWorkflowTool.prototype, "args", void 0);
+exports.GitHubTriggerWorkflowTool = GitHubTriggerWorkflowTool = GitHubTriggerWorkflowTool_1 = __decorate([
+    (0, common_2.Tool)({
+        config: {
+            description: 'Triggers a GitHub Actions workflow dispatch event. Returns 204 No Content on success. Returns { error: "unauthorized" } if no valid token is available.',
+        },
+    })
+], GitHubTriggerWorkflowTool);
+//# sourceMappingURL=github-trigger-workflow.tool.js.map

package/dist/tools/actions/github-trigger-workflow.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-trigger-workflow.tool.js","sourceRoot":"","sources":["../../../src/tools/actions/github-trigger-workflow.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/content/github-create-or-update-file.tool.d.ts

@@ -0,0 +1,17 @@
+import { RunContext, ToolInterface, ToolResult } from '@loopstack/common';
+export type GitHubCreateOrUpdateFileArgs = {
+    owner: string;
+    repo: string;
+    path: string;
+    content: string;
+    message: string;
+    sha?: string;
+    branch?: string;
+};
+export declare class GitHubCreateOrUpdateFileTool implements ToolInterface {
+    private readonly logger;
+    private tokenStore;
+    args: GitHubCreateOrUpdateFileArgs;
+    execute(args: GitHubCreateOrUpdateFileArgs, ctx: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=github-create-or-update-file.tool.d.ts.map

package/dist/tools/content/github-create-or-update-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-create-or-update-file.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/content/github-create-or-update-file.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,UAAU,EAAQ,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAMa,4BAA6B,YAAW,aAAa;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IAGxE,OAAO,CAAC,UAAU,CAAkB;IAepC,IAAI,EAAE,4BAA4B,CAAC;IAE7B,OAAO,CAAC,IAAI,EAAE,4BAA4B,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAiFxF"}

package/dist/tools/content/github-create-or-update-file.tool.js

@@ -0,0 +1,115 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var GitHubCreateOrUpdateFileTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubCreateOrUpdateFileTool = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const oauth_module_1 = require("@loopstack/oauth-module");
+let GitHubCreateOrUpdateFileTool = GitHubCreateOrUpdateFileTool_1 = class GitHubCreateOrUpdateFileTool {
+    logger = new common_1.Logger(GitHubCreateOrUpdateFileTool_1.name);
+    tokenStore;
+    args;
+    async execute(args, ctx) {
+        const accessToken = await this.tokenStore.getValidAccessToken(ctx.userId, 'github');
+        if (!accessToken) {
+            return {
+                data: {
+                    error: 'unauthorized',
+                    message: 'No valid GitHub token found. Please authenticate first.',
+                },
+            };
+        }
+        const requestBody = {
+            message: args.message,
+            content: Buffer.from(args.content).toString('base64'),
+        };
+        if (args.sha)
+            requestBody.sha = args.sha;
+        if (args.branch)
+            requestBody.branch = args.branch;
+        const url = `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}/contents/${args.path}`;
+        const response = await fetch(url, {
+            method: 'PUT',
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (response.status === 401 || response.status === 403) {
+            this.logger.warn(`GitHub API returned ${response.status} for user ${ctx.userId}`);
+            return {
+                data: {
+                    error: '401',
+                    message: 'GitHub token was rejected. Please re-authenticate.',
+                },
+            };
+        }
+        if (!response.ok) {
+            const errorBody = await response.text();
+            this.logger.error(`GitHub API error: ${response.status} ${errorBody}`);
+            return {
+                data: {
+                    error: 'api_error',
+                    message: `GitHub API error: ${response.statusText}`,
+                },
+            };
+        }
+        const data = (await response.json());
+        return {
+            data: {
+                file: {
+                    name: data.content.name,
+                    path: data.content.path,
+                    sha: data.content.sha,
+                    htmlUrl: data.content.html_url,
+                },
+                commit: {
+                    sha: data.commit.sha,
+                    message: data.commit.message,
+                },
+            },
+        };
+    }
+};
+exports.GitHubCreateOrUpdateFileTool = GitHubCreateOrUpdateFileTool;
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", oauth_module_1.OAuthTokenStore)
+], GitHubCreateOrUpdateFileTool.prototype, "tokenStore", void 0);
+__decorate([
+    (0, common_2.Input)({
+        schema: zod_1.z
+            .object({
+            owner: zod_1.z.string(),
+            repo: zod_1.z.string(),
+            path: zod_1.z.string(),
+            content: zod_1.z.string(),
+            message: zod_1.z.string(),
+            sha: zod_1.z.string().optional(),
+            branch: zod_1.z.string().optional(),
+        })
+            .strict(),
+    }),
+    __metadata("design:type", Object)
+], GitHubCreateOrUpdateFileTool.prototype, "args", void 0);
+exports.GitHubCreateOrUpdateFileTool = GitHubCreateOrUpdateFileTool = GitHubCreateOrUpdateFileTool_1 = __decorate([
+    (0, common_2.Tool)({
+        config: {
+            description: 'Creates or updates a file in a GitHub repository. Content is provided as plain text and encoded to base64 before sending. To update an existing file, provide the sha of the file being replaced. Returns { error: "unauthorized" } if no valid token is available.',
+        },
+    })
+], GitHubCreateOrUpdateFileTool);
+//# sourceMappingURL=github-create-or-update-file.tool.js.map

package/dist/tools/content/github-create-or-update-file.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-create-or-update-file.tool.js","sourceRoot":"","sources":["../../../src/tools/content/github-create-or-update-file.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/content/github-get-commit.tool.d.ts

@@ -0,0 +1,13 @@
+import { RunContext, ToolInterface, ToolResult } from '@loopstack/common';
+export type GitHubGetCommitArgs = {
+    owner: string;
+    repo: string;
+    ref: string;
+};
+export declare class GitHubGetCommitTool implements ToolInterface {
+    private readonly logger;
+    private tokenStore;
+    args: GitHubGetCommitArgs;
+    execute(args: GitHubGetCommitArgs, ctx: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=github-get-commit.tool.d.ts.map

package/dist/tools/content/github-get-commit.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-get-commit.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/content/github-get-commit.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,UAAU,EAAQ,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,qBAMa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAG/D,OAAO,CAAC,UAAU,CAAkB;IAWpC,IAAI,EAAE,mBAAmB,CAAC;IAEpB,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAyF/E"}

package/dist/tools/content/github-get-commit.tool.js

@@ -0,0 +1,113 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var GitHubGetCommitTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubGetCommitTool = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const oauth_module_1 = require("@loopstack/oauth-module");
+let GitHubGetCommitTool = GitHubGetCommitTool_1 = class GitHubGetCommitTool {
+    logger = new common_1.Logger(GitHubGetCommitTool_1.name);
+    tokenStore;
+    args;
+    async execute(args, ctx) {
+        const accessToken = await this.tokenStore.getValidAccessToken(ctx.userId, 'github');
+        if (!accessToken) {
+            return {
+                data: {
+                    error: 'unauthorized',
+                    message: 'No valid GitHub token found. Please authenticate first.',
+                },
+            };
+        }
+        const url = `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}/commits/${encodeURIComponent(args.ref)}`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+        });
+        if (response.status === 401 || response.status === 403) {
+            this.logger.warn(`GitHub API returned ${response.status} for user ${ctx.userId}`);
+            return {
+                data: {
+                    error: '401',
+                    message: 'GitHub token was rejected. Please re-authenticate.',
+                },
+            };
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            this.logger.error(`GitHub API error: ${response.status} ${body}`);
+            return {
+                data: {
+                    error: 'api_error',
+                    message: `GitHub API error: ${response.statusText}`,
+                },
+            };
+        }
+        const data = (await response.json());
+        return {
+            data: {
+                commit: {
+                    sha: data.sha,
+                    message: data.commit.message,
+                    author: {
+                        name: data.commit.author.name,
+                        email: data.commit.author.email,
+                        date: data.commit.author.date,
+                        login: data.author?.login ?? null,
+                    },
+                    committer: {
+                        name: data.commit.committer.name,
+                        date: data.commit.committer.date,
+                    },
+                    htmlUrl: data.html_url,
+                    stats: data.stats,
+                    files: data.files.map((f) => ({
+                        filename: f.filename,
+                        status: f.status,
+                        additions: f.additions,
+                        deletions: f.deletions,
+                        changes: f.changes,
+                    })),
+                },
+            },
+        };
+    }
+};
+exports.GitHubGetCommitTool = GitHubGetCommitTool;
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", oauth_module_1.OAuthTokenStore)
+], GitHubGetCommitTool.prototype, "tokenStore", void 0);
+__decorate([
+    (0, common_2.Input)({
+        schema: zod_1.z
+            .object({
+            owner: zod_1.z.string(),
+            repo: zod_1.z.string(),
+            ref: zod_1.z.string(),
+        })
+            .strict(),
+    }),
+    __metadata("design:type", Object)
+], GitHubGetCommitTool.prototype, "args", void 0);
+exports.GitHubGetCommitTool = GitHubGetCommitTool = GitHubGetCommitTool_1 = __decorate([
+    (0, common_2.Tool)({
+        config: {
+            description: 'Gets detailed information about a specific commit in a GitHub repository. Returns { error: "unauthorized" } if no valid token is available.',
+        },
+    })
+], GitHubGetCommitTool);
+//# sourceMappingURL=github-get-commit.tool.js.map

package/dist/tools/content/github-get-commit.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-get-commit.tool.js","sourceRoot":"","sources":["../../../src/tools/content/github-get-commit.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAgD;AAChD,6BAAwB;AACxB,8CAAuF;AACvF,0DAA0D;AAcnD,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IACb,MAAM,GAAG,IAAI,eAAM,CAAC,qBAAmB,CAAC,IAAI,CAAC,CAAC;IAGvD,UAAU,CAAkB;IAWpC,IAAI,CAAsB;IAE1B,KAAK,CAAC,OAAO,CAAC,IAAyB,EAAE,GAAe;QACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEpF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,yDAAyD;iBACnE;aACF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,gCAAgC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,MAAM,EAAE,6BAA6B;gBACrC,sBAAsB,EAAE,YAAY;aACrC;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,oDAAoD;iBAC9D;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,WAAW;oBAClB,OAAO,EAAE,qBAAqB,QAAQ,CAAC,UAAU,EAAE;iBACpD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAiBlC,CAAC;QAEF,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC5B,MAAM,EAAE;wBACN,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;wBAC7B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK;wBAC/B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;wBAC7B,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI;qBAClC;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI;wBAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI;qBACjC;oBACD,OAAO,EAAE,IAAI,CAAC,QAAQ;oBACtB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;qBACnB,CAAC,CAAC;iBACJ;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA1GY,kDAAmB;AAItB;IADP,IAAA,eAAM,GAAE;8BACW,8BAAe;uDAAC;AAWpC;IATC,IAAA,cAAK,EAAC;QACL,MAAM,EAAE,OAAC;aACN,MAAM,CAAC;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;SAChB,CAAC;aACD,MAAM,EAAE;KACZ,CAAC;;iDACwB;8BAff,mBAAmB;IAN/B,IAAA,aAAI,EAAC;QACJ,MAAM,EAAE;YACN,WAAW,EACT,6IAA6I;SAChJ;KACF,CAAC;GACW,mBAAmB,CA0G/B"}

package/dist/tools/content/github-get-file-content.tool.d.ts

@@ -0,0 +1,14 @@
+import { RunContext, ToolInterface, ToolResult } from '@loopstack/common';
+export type GitHubGetFileContentArgs = {
+    owner: string;
+    repo: string;
+    path: string;
+    ref?: string;
+};
+export declare class GitHubGetFileContentTool implements ToolInterface {
+    private readonly logger;
+    private tokenStore;
+    args: GitHubGetFileContentArgs;
+    execute(args: GitHubGetFileContentArgs, ctx: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=github-get-file-content.tool.d.ts.map

package/dist/tools/content/github-get-file-content.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-get-file-content.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/content/github-get-file-content.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,UAAU,EAAQ,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAMa,wBAAyB,YAAW,aAAa;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAGpE,OAAO,CAAC,UAAU,CAAkB;IAYpC,IAAI,EAAE,wBAAwB,CAAC;IAEzB,OAAO,CAAC,IAAI,EAAE,wBAAwB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CA2EpF"}

package/dist/tools/content/github-get-file-content.tool.js

@@ -0,0 +1,107 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var GitHubGetFileContentTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubGetFileContentTool = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const oauth_module_1 = require("@loopstack/oauth-module");
+let GitHubGetFileContentTool = GitHubGetFileContentTool_1 = class GitHubGetFileContentTool {
+    logger = new common_1.Logger(GitHubGetFileContentTool_1.name);
+    tokenStore;
+    args;
+    async execute(args, ctx) {
+        const accessToken = await this.tokenStore.getValidAccessToken(ctx.userId, 'github');
+        if (!accessToken) {
+            return {
+                data: {
+                    error: 'unauthorized',
+                    message: 'No valid GitHub token found. Please authenticate first.',
+                },
+            };
+        }
+        const params = new URLSearchParams();
+        if (args.ref)
+            params.set('ref', args.ref);
+        const url = `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}/contents/${args.path}${params.toString() ? `?${params.toString()}` : ''}`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+        });
+        if (response.status === 401 || response.status === 403) {
+            this.logger.warn(`GitHub API returned ${response.status} for user ${ctx.userId}`);
+            return {
+                data: {
+                    error: '401',
+                    message: 'GitHub token was rejected. Please re-authenticate.',
+                },
+            };
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            this.logger.error(`GitHub API error: ${response.status} ${body}`);
+            return {
+                data: {
+                    error: 'api_error',
+                    message: `GitHub API error: ${response.statusText}`,
+                },
+            };
+        }
+        const data = (await response.json());
+        let content = null;
+        if (data.content && data.encoding === 'base64') {
+            content = Buffer.from(data.content, 'base64').toString('utf-8');
+        }
+        return {
+            data: {
+                file: {
+                    name: data.name,
+                    path: data.path,
+                    sha: data.sha,
+                    size: data.size,
+                    type: data.type,
+                    content,
+                    htmlUrl: data.html_url,
+                },
+            },
+        };
+    }
+};
+exports.GitHubGetFileContentTool = GitHubGetFileContentTool;
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", oauth_module_1.OAuthTokenStore)
+], GitHubGetFileContentTool.prototype, "tokenStore", void 0);
+__decorate([
+    (0, common_2.Input)({
+        schema: zod_1.z
+            .object({
+            owner: zod_1.z.string(),
+            repo: zod_1.z.string(),
+            path: zod_1.z.string(),
+            ref: zod_1.z.string().optional(),
+        })
+            .strict(),
+    }),
+    __metadata("design:type", Object)
+], GitHubGetFileContentTool.prototype, "args", void 0);
+exports.GitHubGetFileContentTool = GitHubGetFileContentTool = GitHubGetFileContentTool_1 = __decorate([
+    (0, common_2.Tool)({
+        config: {
+            description: 'Gets the content of a file from a GitHub repository. Decodes base64-encoded content from the API. Returns { error: "unauthorized" } if no valid token is available.',
+        },
+    })
+], GitHubGetFileContentTool);
+//# sourceMappingURL=github-get-file-content.tool.js.map

package/dist/tools/content/github-get-file-content.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-get-file-content.tool.js","sourceRoot":"","sources":["../../../src/tools/content/github-get-file-content.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAgD;AAChD,6BAAwB;AACxB,8CAAuF;AACvF,0DAA0D;AAenD,IAAM,wBAAwB,gCAA9B,MAAM,wBAAwB;IAClB,MAAM,GAAG,IAAI,eAAM,CAAC,0BAAwB,CAAC,IAAI,CAAC,CAAC;IAG5D,UAAU,CAAkB;IAYpC,IAAI,CAA2B;IAE/B,KAAK,CAAC,OAAO,CAAC,IAA8B,EAAE,GAAe;QAC3D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEpF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,yDAAyD;iBACnE;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,gCAAgC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvL,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,MAAM,EAAE,6BAA6B;gBACrC,sBAAsB,EAAE,YAAY;aACrC;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,oDAAoD;iBAC9D;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EAAE,WAAW;oBAClB,OAAO,EAAE,qBAAqB,QAAQ,CAAC,UAAU,EAAE;iBACpD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CASlC,CAAC;QAEF,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/C,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO;oBACP,OAAO,EAAE,IAAI,CAAC,QAAQ;iBACvB;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA7FY,4DAAwB;AAI3B;IADP,IAAA,eAAM,GAAE;8BACW,8BAAe;4DAAC;AAYpC;IAVC,IAAA,cAAK,EAAC;QACL,MAAM,EAAE,OAAC;aACN,MAAM,CAAC;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B,CAAC;aACD,MAAM,EAAE;KACZ,CAAC;;sDAC6B;mCAhBpB,wBAAwB;IANpC,IAAA,aAAI,EAAC;QACJ,MAAM,EAAE;YACN,WAAW,EACT,qKAAqK;SACxK;KACF,CAAC;GACW,wBAAwB,CA6FpC"}

package/dist/tools/content/github-list-directory.tool.d.ts

@@ -0,0 +1,14 @@
+import { RunContext, ToolInterface, ToolResult } from '@loopstack/common';
+export type GitHubListDirectoryArgs = {
+    owner: string;
+    repo: string;
+    path?: string;
+    ref?: string;
+};
+export declare class GitHubListDirectoryTool implements ToolInterface {
+    private readonly logger;
+    private tokenStore;
+    args: GitHubListDirectoryArgs;
+    execute(args: GitHubListDirectoryArgs, ctx: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=github-list-directory.tool.d.ts.map

package/dist/tools/content/github-list-directory.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-list-directory.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/content/github-list-directory.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,UAAU,EAAQ,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAMa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAGnE,OAAO,CAAC,UAAU,CAAkB;IAYpC,IAAI,EAAE,uBAAuB,CAAC;IAExB,OAAO,CAAC,IAAI,EAAE,uBAAuB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAoEnF"}