@generacy-ai/generacy-plugin-github-actions 0.0.0-preview-20260304013206

package/dist/index.js

@@ -0,0 +1,27 @@
+// Main plugin
+export { GitHubActionsPlugin, createGitHubActionsPlugin, PLUGIN_MANIFEST, } from './plugin.js';
+// Configuration types
+export { gitHubActionsConfigSchema, pollingOptionsSchema, workflowsConfigSchema, parseConfig, DEFAULT_POLLING_CONFIG, } from './types/config.js';
+// Workflow types
+export { isTerminalStatus, isSuccessful, isFailed, } from './types/workflows.js';
+// Job types
+export { isJobComplete, isJobSuccessful, getFailedSteps, } from './types/jobs.js';
+// Artifact types
+export { isArtifactAvailable, formatArtifactSize, } from './types/artifacts.js';
+// Check run types
+export { isCheckComplete, isCheckSuccessful, } from './types/check-runs.js';
+// Event types
+export { isWorkflowCompletedEvent, isWorkflowFailedEvent, isCheckRunCompletedEvent, } from './types/events.js';
+// EventBus interface
+export { SimpleEventBus, } from './events/types.js';
+// Polling types
+export { createPollingConfig, } from './polling/types.js';
+// Error types
+export { GitHubActionsError, RateLimitError, WorkflowNotFoundError, RunNotFoundError, JobNotFoundError, ArtifactNotFoundError, CheckRunNotFoundError, PollingTimeoutError, ConfigurationError, isRateLimitError, isGitHubActionsError, } from './utils/errors.js';
+// Client (for advanced usage)
+export { GitHubClient, createClient } from './client.js';
+// Status poller (for advanced usage)
+export { StatusPoller, createStatusPoller, pollUntilComplete, waitForRun, } from './polling/status-poller.js';
+// Event emitter (for advanced usage)
+export { WorkflowEventEmitter, createEventEmitter, } from './events/emitter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,GAChB,MAAM,aAAa,CAAC;AAKrB,sBAAsB;AACtB,OAAO,EAIL,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAML,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAOL,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,iBAAiB;AACjB,OAAO,EAGL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,kBAAkB;AAClB,OAAO,EASL,eAAe,EACf,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,cAAc;AACd,OAAO,EAML,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EAKL,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAIL,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,cAAc;AACd,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,qCAAqC;AACrC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/operations/artifacts.d.ts

@@ -0,0 +1,46 @@
+import type { GitHubClient } from '../client.js';
+import type { Artifact } from '../types/artifacts.js';
+/**
+ * List artifacts for a workflow run
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @returns Array of artifacts
+ */
+export declare function listArtifacts(client: GitHubClient, runId: number): Promise<Artifact[]>;
+/**
+ * Get a specific artifact by ID
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ * @returns The artifact
+ */
+export declare function getArtifact(client: GitHubClient, artifactId: number): Promise<Artifact>;
+/**
+ * Download an artifact
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ * @returns Artifact content as a Buffer
+ */
+export declare function downloadArtifact(client: GitHubClient, artifactId: number): Promise<Buffer>;
+/**
+ * Delete an artifact
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ */
+export declare function deleteArtifact(client: GitHubClient, artifactId: number): Promise<void>;
+/**
+ * List all artifacts in a repository
+ *
+ * @param client - GitHub API client
+ * @param options - List options
+ * @returns Array of artifacts
+ */
+export declare function listRepoArtifacts(client: GitHubClient, options?: {
+    per_page?: number;
+    page?: number;
+    name?: string;
+}): Promise<Artifact[]>;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/operations/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/operations/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AA8BtD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBrB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC,CAerB"}

package/dist/operations/artifacts.js

@@ -0,0 +1,166 @@
+import { ArtifactNotFoundError, RunNotFoundError } from '../utils/errors.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Map Octokit artifact response to our Artifact type
+ */
+function mapArtifact(artifact) {
+    const workflowRun = artifact.workflow_run;
+    return {
+        id: artifact.id,
+        node_id: artifact.node_id,
+        name: artifact.name,
+        size_in_bytes: artifact.size_in_bytes,
+        archive_download_url: artifact.archive_download_url,
+        expired: artifact.expired,
+        created_at: artifact.created_at ?? '',
+        updated_at: artifact.updated_at ?? '',
+        expires_at: artifact.expires_at ?? '',
+        workflow_run: workflowRun ? {
+            id: workflowRun.id ?? 0,
+            repository_id: workflowRun.repository_id ?? 0,
+            head_repository_id: workflowRun.head_repository_id ?? 0,
+            head_branch: workflowRun.head_branch ?? '',
+            head_sha: workflowRun.head_sha ?? '',
+        } : undefined,
+    };
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+/**
+ * List artifacts for a workflow run
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @returns Array of artifacts
+ */
+export async function listArtifacts(client, runId) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        const response = await client.request((octokit) => octokit.rest.actions.listWorkflowRunArtifacts({
+            owner,
+            repo,
+            run_id: runId,
+        }));
+        return response.artifacts.map(mapArtifact);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new RunNotFoundError(runId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Get a specific artifact by ID
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ * @returns The artifact
+ */
+export async function getArtifact(client, artifactId) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        const artifact = await client.request((octokit) => octokit.rest.actions.getArtifact({
+            owner,
+            repo,
+            artifact_id: artifactId,
+        }));
+        return mapArtifact(artifact);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new ArtifactNotFoundError(artifactId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Download an artifact
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ * @returns Artifact content as a Buffer
+ */
+export async function downloadArtifact(client, artifactId) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        const response = await client.requestRaw((octokit) => octokit.rest.actions.downloadArtifact({
+            owner,
+            repo,
+            artifact_id: artifactId,
+            archive_format: 'zip',
+        }));
+        // Handle different response types
+        if (response && typeof response === 'object' && 'data' in response) {
+            const data = response.data;
+            if (Buffer.isBuffer(data)) {
+                return data;
+            }
+            if (data instanceof ArrayBuffer) {
+                return Buffer.from(data);
+            }
+            if (typeof data === 'string') {
+                return Buffer.from(data);
+            }
+        }
+        // Fallback: convert to buffer if possible
+        if (Buffer.isBuffer(response)) {
+            return response;
+        }
+        if (response instanceof ArrayBuffer) {
+            return Buffer.from(response);
+        }
+        throw new Error('Unexpected response format from artifact download');
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new ArtifactNotFoundError(artifactId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Delete an artifact
+ *
+ * @param client - GitHub API client
+ * @param artifactId - Artifact ID
+ */
+export async function deleteArtifact(client, artifactId) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        await client.request((octokit) => octokit.rest.actions.deleteArtifact({
+            owner,
+            repo,
+            artifact_id: artifactId,
+        }));
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new ArtifactNotFoundError(artifactId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * List all artifacts in a repository
+ *
+ * @param client - GitHub API client
+ * @param options - List options
+ * @returns Array of artifacts
+ */
+export async function listRepoArtifacts(client, options) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    const response = await client.request((octokit) => octokit.rest.actions.listArtifactsForRepo({
+        owner,
+        repo,
+        per_page: options?.per_page ?? 30,
+        page: options?.page ?? 1,
+        name: options?.name,
+    }));
+    return response.artifacts.map(mapArtifact);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/operations/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/operations/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/operations/check-runs.d.ts

@@ -0,0 +1,58 @@
+import type { GitHubClient } from '../client.js';
+import type { CheckRun, CreateCheckRunParams, UpdateCheckRunParams } from '../types/check-runs.js';
+/**
+ * Create a new check run
+ *
+ * @param client - GitHub API client
+ * @param params - Check run creation parameters
+ * @returns The created check run
+ */
+export declare function createCheckRun(client: GitHubClient, params: CreateCheckRunParams): Promise<CheckRun>;
+/**
+ * Update an existing check run
+ *
+ * @param client - GitHub API client
+ * @param checkRunId - Check run ID
+ * @param params - Check run update parameters
+ * @returns The updated check run
+ */
+export declare function updateCheckRun(client: GitHubClient, checkRunId: number, params: UpdateCheckRunParams): Promise<CheckRun>;
+/**
+ * Get a check run by ID
+ *
+ * @param client - GitHub API client
+ * @param checkRunId - Check run ID
+ * @returns The check run
+ */
+export declare function getCheckRun(client: GitHubClient, checkRunId: number): Promise<CheckRun>;
+/**
+ * List check runs for a Git reference
+ *
+ * @param client - GitHub API client
+ * @param ref - Git ref (SHA, branch name, or tag name)
+ * @param options - List options
+ * @returns Array of check runs
+ */
+export declare function listCheckRuns(client: GitHubClient, ref: string, options?: {
+    check_name?: string;
+    status?: 'queued' | 'in_progress' | 'completed';
+    filter?: 'latest' | 'all';
+    per_page?: number;
+    page?: number;
+}): Promise<CheckRun[]>;
+/**
+ * List check runs for a check suite
+ *
+ * @param client - GitHub API client
+ * @param checkSuiteId - Check suite ID
+ * @param options - List options
+ * @returns Array of check runs
+ */
+export declare function listCheckRunsForSuite(client: GitHubClient, checkSuiteId: number, options?: {
+    check_name?: string;
+    status?: 'queued' | 'in_progress' | 'completed';
+    filter?: 'latest' | 'all';
+    per_page?: number;
+    page?: number;
+}): Promise<CheckRun[]>;
+//# sourceMappingURL=check-runs.d.ts.map

package/dist/operations/check-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-runs.d.ts","sourceRoot":"","sources":["../../src/operations/check-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAgChC;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoCnB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAyCnB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkBrB"}

package/dist/operations/check-runs.js

@@ -0,0 +1,188 @@
+import { CheckRunNotFoundError } from '../utils/errors.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Map Octokit check run response to our CheckRun type
+ */
+function mapCheckRun(check) {
+    return {
+        id: check.id,
+        node_id: check.node_id ?? '',
+        name: check.name ?? '',
+        head_sha: check.head_sha ?? '',
+        external_id: check.external_id ?? undefined,
+        status: check.status ?? 'queued',
+        conclusion: check.conclusion,
+        details_url: check.details_url ?? undefined,
+        html_url: check.html_url ?? '',
+        output: check.output
+            ? {
+                title: check.output.title,
+                summary: check.output.summary,
+                text: check.output.text,
+                annotations_count: check.output.annotations_count ?? 0,
+            }
+            : undefined,
+        started_at: check.started_at ?? undefined,
+        completed_at: check.completed_at ?? undefined,
+    };
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+/**
+ * Create a new check run
+ *
+ * @param client - GitHub API client
+ * @param params - Check run creation parameters
+ * @returns The created check run
+ */
+export async function createCheckRun(client, params) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    const check = await client.request((octokit) => octokit.rest.checks.create({
+        owner,
+        repo,
+        name: params.name,
+        head_sha: params.head_sha,
+        external_id: params.external_id,
+        details_url: params.details_url,
+        status: params.status,
+        output: params.output
+            ? {
+                title: params.output.title,
+                summary: params.output.summary,
+                text: params.output.text,
+                annotations: params.output.annotations?.map((a) => ({
+                    path: a.path,
+                    start_line: a.start_line,
+                    end_line: a.end_line,
+                    start_column: a.start_column,
+                    end_column: a.end_column,
+                    annotation_level: a.annotation_level,
+                    message: a.message,
+                    title: a.title,
+                    raw_details: a.raw_details,
+                })),
+            }
+            : undefined,
+        started_at: params.started_at,
+    }));
+    return mapCheckRun(check);
+}
+/**
+ * Update an existing check run
+ *
+ * @param client - GitHub API client
+ * @param checkRunId - Check run ID
+ * @param params - Check run update parameters
+ * @returns The updated check run
+ */
+export async function updateCheckRun(client, checkRunId, params) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        const check = await client.request((octokit) => octokit.rest.checks.update({
+            owner,
+            repo,
+            check_run_id: checkRunId,
+            status: params.status,
+            conclusion: params.conclusion ?? undefined,
+            output: params.output
+                ? {
+                    title: params.output.title,
+                    summary: params.output.summary,
+                    text: params.output.text,
+                    annotations: params.output.annotations?.map((a) => ({
+                        path: a.path,
+                        start_line: a.start_line,
+                        end_line: a.end_line,
+                        start_column: a.start_column,
+                        end_column: a.end_column,
+                        annotation_level: a.annotation_level,
+                        message: a.message,
+                        title: a.title,
+                        raw_details: a.raw_details,
+                    })),
+                }
+                : undefined,
+            completed_at: params.completed_at,
+        }));
+        return mapCheckRun(check);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new CheckRunNotFoundError(checkRunId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Get a check run by ID
+ *
+ * @param client - GitHub API client
+ * @param checkRunId - Check run ID
+ * @returns The check run
+ */
+export async function getCheckRun(client, checkRunId) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    try {
+        const check = await client.request((octokit) => octokit.rest.checks.get({
+            owner,
+            repo,
+            check_run_id: checkRunId,
+        }));
+        return mapCheckRun(check);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Not Found')) {
+            throw new CheckRunNotFoundError(checkRunId, error);
+        }
+        throw error;
+    }
+}
+/**
+ * List check runs for a Git reference
+ *
+ * @param client - GitHub API client
+ * @param ref - Git ref (SHA, branch name, or tag name)
+ * @param options - List options
+ * @returns Array of check runs
+ */
+export async function listCheckRuns(client, ref, options) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    const response = await client.request((octokit) => octokit.rest.checks.listForRef({
+        owner,
+        repo,
+        ref,
+        check_name: options?.check_name,
+        status: options?.status,
+        filter: options?.filter,
+        per_page: options?.per_page ?? 30,
+        page: options?.page ?? 1,
+    }));
+    return response.check_runs.map(mapCheckRun);
+}
+/**
+ * List check runs for a check suite
+ *
+ * @param client - GitHub API client
+ * @param checkSuiteId - Check suite ID
+ * @param options - List options
+ * @returns Array of check runs
+ */
+export async function listCheckRunsForSuite(client, checkSuiteId, options) {
+    const owner = client.getOwner();
+    const repo = client.getRepo();
+    const response = await client.request((octokit) => octokit.rest.checks.listForSuite({
+        owner,
+        repo,
+        check_suite_id: checkSuiteId,
+        check_name: options?.check_name,
+        status: options?.status,
+        filter: options?.filter,
+        per_page: options?.per_page ?? 30,
+        page: options?.page ?? 1,
+    }));
+    return response.check_runs.map(mapCheckRun);
+}
+//# sourceMappingURL=check-runs.js.map

package/dist/operations/check-runs.js.map

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

package/dist/operations/jobs.d.ts

@@ -0,0 +1,35 @@
+import type { GitHubClient } from '../client.js';
+import type { Job } from '../types/jobs.js';
+/**
+ * Get jobs for a workflow run
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @returns Array of jobs
+ */
+export declare function getJobs(client: GitHubClient, runId: number): Promise<Job[]>;
+/**
+ * Get a specific job by ID
+ *
+ * @param client - GitHub API client
+ * @param jobId - Job ID
+ * @returns The job
+ */
+export declare function getJob(client: GitHubClient, jobId: number): Promise<Job>;
+/**
+ * Download job logs
+ *
+ * @param client - GitHub API client
+ * @param jobId - Job ID
+ * @returns Job logs as a string
+ */
+export declare function getJobLogs(client: GitHubClient, jobId: number): Promise<string>;
+/**
+ * Get failed jobs from a workflow run
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @returns Array of failed jobs
+ */
+export declare function getFailedJobs(client: GitHubClient, runId: number): Promise<Job[]>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/operations/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/operations/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAQ,MAAM,kBAAkB,CAAC;AAqClD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,GAAG,CAAC,CAoBd;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC,CAGhB"}