@relayflows/github-primitive 0.1.0

package/README.md

@@ -0,0 +1,129 @@
+# @relayflows/github-primitive
+
+GitHub workflow primitive for Agent Relay. It exposes a typed client and a
+workflow integration step that can run through the local `gh` CLI or a cloud
+GitHub proxy.
+
+## Runtime Selection
+
+The primitive supports three runtime modes:
+
+- `auto`: prefer cloud when Nango or relay-cloud credentials are present,
+  otherwise use the local `gh` CLI when available.
+- `local`: use `gh api` from the current machine.
+- `cloud`: use Nango first, then relay-cloud proxy when configured.
+
+```ts
+import { GitHubClient } from '@relayflows/github-primitive';
+
+const github = await GitHubClient.create({
+  runtime: 'auto',
+});
+
+const repo = await github.getRepo('AgentWorkforce', 'relay');
+console.log(repo.defaultBranch);
+```
+
+## Actions
+
+The client and workflow step support:
+
+- Repositories: `listRepos`, `getRepo`
+- Issues: `listIssues`, `createIssue`, `updateIssue`, `closeIssue`
+- Pull requests: `listPRs`, `getPR`, `createPR`, `updatePR`, `mergePR`
+- Files: `listFiles`, `readFile`, `createFile`, `updateFile`, `deleteFile`
+- Branches and commits: `listBranches`, `createBranch`, `listCommits`, `createCommit`
+- Identity: `getUser`, `listOrganizations`
+
+## End-to-end PR workflow
+
+`examples/end-to-end-pr-workflow.ts` walks the full PR lifecycle against
+a single runtime:
+
+1. `getRepo` — inspect + log the selected runtime.
+2. `createBranch` off the base branch.
+3. `createFile` — write a marker file on the new branch.
+4. `createPR` — the core integration step cloud workflows migrate to.
+5. `getPR` — round-trip verify.
+6. `updatePR` — edit the PR body without code changes.
+7. `listPRs` — confirm indexability.
+8. (commented) `mergePR` — off by default so the example never merges
+   anything real.
+
+Run against a scratch repo:
+
+```
+GITHUB_REPO=AgentWorkforce/scratch npx tsx \
+  packages/github-primitive/examples/end-to-end-pr-workflow.ts
+```
+
+Runtime selection is automatic:
+
+| Path        | Triggered when                                                                                        |
+| ----------- | ----------------------------------------------------------------------------------------------------- |
+| Local `gh`  | `gh auth status` succeeds and no cloud creds are set                                                  |
+| Nango       | `NANGO_SECRET_KEY` + `NANGO_GITHUB_CONNECTION_ID` + `NANGO_GITHUB_PROVIDER_CONFIG_KEY` present        |
+| relay-cloud | `RELAY_CLOUD_API_URL` + `RELAY_CLOUD_API_TOKEN` + `WORKSPACE_ID` present (fallback when Nango absent) |
+
+## Multi-tenant routing
+
+In cloud, every workspace has its own GitHub App install — one Nango
+connection per tenant. `createGitHubStep` accepts a per-step `config`
+field so a single workflow can route different actions through
+different connections. One workflow, many tenants.
+
+`examples/multi-tenant-pr-workflow.ts` demonstrates this: it opens PRs
+in `AgentWorkforce/cloud` (via the AgentWorkforce app) AND in an
+MSD-owned repo (via MSD's app), from the same workflow definition, by
+varying the `config:` field on each step.
+
+### Cloud adoption: the resolver helper
+
+The primitive stays tenant-unaware — it takes a `GitHubRuntimeConfig`
+and does what it's told. The tenant lookup lives in cloud, in a small
+helper:
+
+```ts
+// cloud/packages/web/lib/github/connection-resolver.ts
+import type { GitHubRuntimeConfig } from '@relayflows/github-primitive';
+
+export async function githubConfigForRepo(opts: {
+  repo: string; // "owner/repo"
+  workspaceId?: string; // optional — cloud-owned repos default
+}): Promise<GitHubRuntimeConfig> {
+  const connection = await resolveWorkspaceIntegration(opts.workspaceId, 'github', opts.repo);
+
+  return {
+    runtime: 'auto',
+    nango: {
+      connectionId: connection.connectionId,
+      providerConfigKey: connection.providerConfigKey, // 'github-agentworkforce' | 'github-msd' | 'github-nightcto' | ...
+      secretKey: process.env.NANGO_SECRET_KEY,
+    },
+    relayCloud: {
+      apiUrl: process.env.CLOUD_API_URL,
+      accessToken: process.env.CLOUD_API_TOKEN,
+      workspaceId: opts.workspaceId,
+    },
+  };
+}
+```
+
+Workflow authors in cloud then write:
+
+```ts
+createGitHubStep({
+  name: 'open-pr',
+  action: 'createPR',
+  repo: 'AgentWorkforce/cloud',
+  params: { title, head, base, body },
+  config: await githubConfigForRepo({
+    repo: 'AgentWorkforce/cloud',
+    workspaceId: process.env.RELAY_WORKSPACE_ID,
+  }),
+});
+```
+
+One resolver, one call-site shape. Adding a new GitHub App install is a
+`workspace_integrations` row + (optionally) a `NANGO_*` secret — no
+code change in the workflows that create PRs.

package/dist/actions/branches.d.ts

@@ -0,0 +1,13 @@
+import type { BranchInfo, CreateBranchParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+/**
+ * List branches for a repository.
+ */
+export declare function listBranches(adapter: GitHubActionAdapter, owner: string, repo: string): Promise<BranchInfo[]>;
+/**
+ * Create a branch from another branch, or from the repository default branch.
+ */
+export declare function createBranch(adapter: GitHubActionAdapter, params: CreateBranchParams): Promise<void>;
+export declare function getBranch(adapter: GitHubActionAdapter, owner: string, repo: string, branch: string): Promise<BranchInfo>;
+export declare function mapBranch(value: unknown): BranchInfo;
+//# sourceMappingURL=branches.d.ts.map

package/dist/actions/branches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branches.d.ts","sourceRoot":"","sources":["../../src/actions/branches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAiB,MAAM,aAAa,CAAC;AACjF,OAAO,EAWL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,EAAE,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1G;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYpD"}

package/dist/actions/branches.js

@@ -0,0 +1,59 @@
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, booleanValue, branchEndpoint, numberValue, repoEndpoint, stringValue, withActionError, } from './utils.js';
+/**
+ * List branches for a repository.
+ */
+export async function listBranches(adapter, owner, repo) {
+    return withActionError(`list GitHub branches for ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const response = await adapter.request('GET', repoEndpoint(owner, repo, '/branches'));
+        return asArray(response, 'branches').map(mapBranch);
+    });
+}
+/**
+ * Create a branch from another branch, or from the repository default branch.
+ */
+export async function createBranch(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`create GitHub branch ${params.branch} in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const branch = assertNonEmptyString(params.branch, 'branch');
+        const sourceBranch = params.fromBranch ?? (await getDefaultBranch(adapter, params));
+        const source = await getBranch(adapter, owner, repo, sourceBranch);
+        const sha = assertNonEmptyString(source.commit.sha, 'source branch sha');
+        await adapter.request('POST', repoEndpoint(owner, repo, '/git/refs'), {
+            body: {
+                ref: `refs/heads/${branch}`,
+                sha,
+            },
+        });
+    });
+}
+export async function getBranch(adapter, owner, repo, branch) {
+    const response = await adapter.request('GET', branchEndpoint(owner, repo, branch));
+    return mapBranch(response);
+}
+export function mapBranch(value) {
+    const branch = asRecord(value, 'branch');
+    const commit = asRecord(branch.commit, 'branch commit');
+    return {
+        name: stringValue(branch.name),
+        commit: {
+            sha: stringValue(commit.sha),
+            url: stringValue(commit.url),
+        },
+        protected: booleanValue(branch.protected),
+    };
+}
+async function getDefaultBranch(adapter, params) {
+    const response = await adapter.request('GET', repoEndpoint(params.owner, params.repo));
+    const repository = asRecord(response, 'repository');
+    const branch = stringValue(repository.default_branch);
+    if (!branch) {
+        const id = numberValue(repository.id);
+        throw new Error(id
+            ? `Repository ${params.owner}/${params.repo} did not include a default branch.`
+            : `Repository ${params.owner}/${params.repo} was not a valid repository response.`);
+    }
+    return branch;
+}
+//# sourceMappingURL=branches.js.map

package/dist/actions/branches.js.map

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

package/dist/actions/commits.d.ts

@@ -0,0 +1,15 @@
+import type { CommitInfo, CreateCommitParams, ListCommitsParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+/**
+ * List commits for a repository.
+ */
+export declare function listCommits(adapter: GitHubActionAdapter, params: ListCommitsParams): Promise<CommitInfo[]>;
+/**
+ * Create a Git commit object.
+ *
+ * This creates the commit object only. Updating a branch ref is intentionally a
+ * separate operation so callers can decide when to move refs.
+ */
+export declare function createCommit(adapter: GitHubActionAdapter, params: CreateCommitParams): Promise<CommitInfo>;
+export declare function mapCommit(value: unknown): CommitInfo;
+//# sourceMappingURL=commits.d.ts.map

package/dist/actions/commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commits.d.ts","sourceRoot":"","sources":["../../src/actions/commits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAGlB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAYL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAcpD"}

package/dist/actions/commits.js

@@ -0,0 +1,71 @@
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, normalizePerPage, optionalRecord, optionalString, removeUndefinedValues, repoEndpoint, stringValue, withActionError, } from './utils.js';
+/**
+ * List commits for a repository.
+ */
+export async function listCommits(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`list GitHub commits for ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const query = {
+            sha: params.sha,
+            path: params.path,
+            author: params.author,
+            since: params.since,
+            until: params.until,
+            per_page: normalizePerPage(params.perPage),
+        };
+        const response = await adapter.request('GET', repoEndpoint(owner, repo, '/commits'), {
+            query,
+        });
+        return asArray(response, 'commits').map(mapCommit);
+    });
+}
+/**
+ * Create a Git commit object.
+ *
+ * This creates the commit object only. Updating a branch ref is intentionally a
+ * separate operation so callers can decide when to move refs.
+ */
+export async function createCommit(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`create GitHub commit in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const message = assertNonEmptyString(params.message, 'commit message');
+        const tree = assertNonEmptyString(params.tree, 'commit tree');
+        if (!Array.isArray(params.parents)) {
+            throw new Error('GitHub commit parents must be an array of parent SHAs.');
+        }
+        const response = await adapter.request('POST', repoEndpoint(owner, repo, '/git/commits'), {
+            body: removeUndefinedValues({
+                message,
+                tree,
+                parents: params.parents.map((parent) => assertNonEmptyString(parent, 'parent sha')),
+                author: params.author,
+                committer: params.committer,
+            }),
+        });
+        return mapCommit(response);
+    });
+}
+export function mapCommit(value) {
+    const topLevel = asRecord(value, 'commit');
+    const nestedCommit = optionalRecord(topLevel.commit);
+    const author = optionalRecord(nestedCommit?.author ?? topLevel.author);
+    const committer = optionalRecord(nestedCommit?.committer ?? topLevel.committer);
+    return {
+        sha: stringValue(topLevel.sha),
+        url: optionalString(topLevel.url),
+        htmlUrl: optionalString(topLevel.html_url),
+        message: optionalString(nestedCommit?.message ?? topLevel.message),
+        author: author ? mapCommitAuthor(author) : undefined,
+        committer: committer ? mapCommitAuthor(committer) : undefined,
+    };
+}
+function mapCommitAuthor(value) {
+    return {
+        name: stringValue(value.name),
+        email: stringValue(value.email),
+        date: optionalString(value.date),
+    };
+}
+//# sourceMappingURL=commits.js.map

package/dist/actions/commits.js.map

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

package/dist/actions/files.d.ts

@@ -0,0 +1,40 @@
+import type { CreateFileParams, DeleteFileParams, GitHubFile, ListFilesParams, UpdateFileParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+export type ListFileOptions = Omit<ListFilesParams, 'owner' | 'repo' | 'path'>;
+export type CreateFileOptions = Omit<CreateFileParams, 'owner' | 'repo' | 'path' | 'content' | 'message'>;
+export type UpdateFileOptions = Omit<UpdateFileParams, 'owner' | 'repo' | 'path' | 'content' | 'message' | 'sha'>;
+export type DeleteFileOptions = Omit<DeleteFileParams, 'owner' | 'repo' | 'path' | 'sha' | 'message'>;
+/**
+ * List files or directories at a repository path.
+ *
+ * Directory responses are returned as a file list. If the path points at a
+ * single file, the file is returned as a one-item list.
+ */
+export declare function listFiles(adapter: GitHubActionAdapter, owner: string, repo: string, path?: string, options?: ListFileOptions): Promise<GitHubFile[]>;
+/**
+ * Read a repository file and return decoded UTF-8 content.
+ *
+ * The GitHub contents API returns base64 encoded file data; this action decodes
+ * the payload before returning it to callers.
+ */
+export declare function readFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, ref?: string): Promise<string>;
+/**
+ * Create a file in a repository.
+ *
+ * Content is encoded as base64 and committed with the supplied message. The
+ * action resolves when GitHub accepts the create request.
+ */
+export declare function createFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, content: string, message: string, options?: CreateFileOptions): Promise<void>;
+/**
+ * Update an existing repository file.
+ *
+ * The file SHA is required by the GitHub contents API to avoid overwriting an
+ * unexpected version.
+ */
+export declare function updateFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, content: string, message: string, sha: string, options?: UpdateFileOptions): Promise<GitHubFile>;
+/**
+ * Delete a repository file with a commit message.
+ */
+export declare function deleteFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, sha: string, message: string, options?: DeleteFileOptions): Promise<void>;
+export declare function mapFile(value: unknown): GitHubFile;
+//# sourceMappingURL=files.d.ts.map

package/dist/actions/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/actions/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAYL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAC1G,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EAChB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAC1D,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,SAAK,EACT,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC,CAavB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAkBlD"}

package/dist/actions/files.js

@@ -0,0 +1,133 @@
+import { Buffer } from 'node:buffer';
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, contentsEndpoint, normalizeRepoPath, numberValue, optionalString, removeUndefinedValues, stringValue, withActionError, } from './utils.js';
+/**
+ * List files or directories at a repository path.
+ *
+ * Directory responses are returned as a file list. If the path points at a
+ * single file, the file is returned as a one-item list.
+ */
+export async function listFiles(adapter, owner, repo, path = '', options = {}) {
+    return withActionError(`list GitHub files at ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const response = await adapter.request('GET', contentsEndpoint(owner, repo, path), {
+            query: {
+                ref: options.ref,
+            },
+        });
+        return Array.isArray(response)
+            ? asArray(response, 'repository contents').map(mapFile)
+            : [mapFile(response)];
+    });
+}
+/**
+ * Read a repository file and return decoded UTF-8 content.
+ *
+ * The GitHub contents API returns base64 encoded file data; this action decodes
+ * the payload before returning it to callers.
+ */
+export async function readFile(adapter, owner, repo, path, ref) {
+    return withActionError(`read GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const response = await adapter.request('GET', contentsEndpoint(owner, repo, path), {
+            query: {
+                ref,
+            },
+        });
+        const file = mapFile(response);
+        if (file.type !== 'file') {
+            throw new Error(`GitHub path "${path}" is not a file.`);
+        }
+        if (!file.content) {
+            throw new Error(`GitHub file "${path}" did not include content in the API response.`);
+        }
+        if (file.encoding && file.encoding !== 'base64') {
+            throw new Error(`GitHub file "${path}" used unsupported encoding "${file.encoding}".`);
+        }
+        return Buffer.from(file.content.replace(/\s/g, ''), 'base64').toString('utf8');
+    });
+}
+/**
+ * Create a file in a repository.
+ *
+ * Content is encoded as base64 and committed with the supplied message. The
+ * action resolves when GitHub accepts the create request.
+ */
+export async function createFile(adapter, owner, repo, path, content, message, options = {}) {
+    return withActionError(`create GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        await adapter.request('PUT', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                content: Buffer.from(content, 'utf8').toString('base64'),
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+    });
+}
+/**
+ * Update an existing repository file.
+ *
+ * The file SHA is required by the GitHub contents API to avoid overwriting an
+ * unexpected version.
+ */
+export async function updateFile(adapter, owner, repo, path, content, message, sha, options = {}) {
+    return withActionError(`update GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        const fileSha = assertNonEmptyString(sha, 'file sha');
+        const response = await adapter.request('PUT', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                content: Buffer.from(content, 'utf8').toString('base64'),
+                sha: fileSha,
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+        const contentRecord = asRecord(response, 'update file response').content;
+        return mapFile(contentRecord);
+    });
+}
+/**
+ * Delete a repository file with a commit message.
+ */
+export async function deleteFile(adapter, owner, repo, path, sha, message, options = {}) {
+    return withActionError(`delete GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const fileSha = assertNonEmptyString(sha, 'file sha');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        await adapter.request('DELETE', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                sha: fileSha,
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+    });
+}
+export function mapFile(value) {
+    const file = asRecord(value, 'repository content');
+    const type = stringValue(file.type) === 'dir' ? 'dir' : 'file';
+    return {
+        name: stringValue(file.name),
+        path: stringValue(file.path),
+        sha: stringValue(file.sha),
+        size: numberValue(file.size),
+        url: stringValue(file.url),
+        htmlUrl: stringValue(file.html_url),
+        gitUrl: stringValue(file.git_url),
+        downloadUrl: optionalString(file.download_url),
+        type,
+        content: optionalString(file.content),
+        encoding: optionalString(file.encoding),
+        target: optionalString(file.target),
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/actions/files.js.map

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

package/dist/actions/issues.d.ts

@@ -0,0 +1,29 @@
+import type { CreateIssueParams, Issue, ListIssuesParams, UpdateIssueParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+export type ListIssueOptions = Omit<ListIssuesParams, 'owner' | 'repo'>;
+export type CreateIssueOptions = Omit<CreateIssueParams, 'owner' | 'repo' | 'title' | 'body'>;
+export type IssueUpdates = Omit<UpdateIssueParams, 'owner' | 'repo' | 'issueNumber'>;
+/**
+ * List repository issues.
+ *
+ * Pull requests are excluded from the repository issues endpoint response so
+ * callers receive only true issues. Local and cloud runtimes are handled by the
+ * provided adapter.
+ */
+export declare function listIssues(adapter: GitHubActionAdapter, owner: string, repo: string, options?: ListIssueOptions): Promise<Issue[]>;
+/**
+ * Create an issue in a repository.
+ *
+ * The request body is sent through the adapter request layer, allowing the
+ * local `gh api` runtime and the cloud proxy runtime to share the same action.
+ */
+export declare function createIssue(adapter: GitHubActionAdapter, owner: string, repo: string, title: string, body?: string, options?: CreateIssueOptions): Promise<Issue>;
+/**
+ * Update an existing issue.
+ *
+ * At least one update field must be supplied. Supported updates include title,
+ * body, state, assignee, and labels.
+ */
+export declare function updateIssue(adapter: GitHubActionAdapter, owner: string, repo: string, number: number, updates: IssueUpdates): Promise<Issue>;
+export declare function mapIssue(value: unknown): Issue;
+//# sourceMappingURL=issues.d.ts.map

package/dist/actions/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/actions/issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAoBL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,KAAK,EAAE,CAAC,CAmBlB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,KAAK,CAAC,CAgBhB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,KAAK,CAAC,CAqBhB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA+B9C"}