{"_id":"@agency-lang/github","_rev":"2-1c52b136db4a60086d36cd0221f931e7","name":"@agency-lang/github","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@agency-lang/github","version":"0.1.0","author":{"name":"Aditya Bhargava"},"license":"ISC","_id":"@agency-lang/github@0.1.0","maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"homepage":"https://github.com/egonSchiele/agency-lang","bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"dist":{"shasum":"67053305c009f3446f9518952449b9230e0553eb","tarball":"https://registry.npmjs.org/@agency-lang/github/-/github-0.1.0.tgz","fileCount":30,"integrity":"sha512-orJtmRtdjVLscS2dMMX10mz2Dt0O6l0RA3IPSfzGP+inwjfTCdd/acmKiRsEUxafR1aSf/eLntU62Q0SZMJMOw==","signatures":[{"sig":"MEYCIQC3O4NGnxCZIItfdvkOFdX2ikwWdLAeaANV9/+aBy3mCgIhAKVkFPyMZkXp0GgCPnETgVNBulQlLi+HntUQfbOVWHOt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102713},"main":"./index.js","type":"module","_from":"file:agency-lang-github-0.1.0.tgz","agency":"./index.agency","exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"},"./package.json":"./package.json"},"gitHead":"a0b178258e7de28699bf9cc46f1178ea31f20640","scripts":{"test":"vitest","build":"tsc","test:run":"vitest run","test:agency":"agency tests/agency"},"_npmUser":{"name":"egonschiele","email":"npm@adit.io"},"_resolved":"/private/var/folders/mh/dp92mgm94_1c4b_yr1w17dsw0000gn/T/1b6672c7373a3a20f1db29fada0d9479/agency-lang-github-0.1.0.tgz","_integrity":"sha512-orJtmRtdjVLscS2dMMX10mz2Dt0O6l0RA3IPSfzGP+inwjfTCdd/acmKiRsEUxafR1aSf/eLntU62Q0SZMJMOw==","_npmVersion":"10.9.2","description":"GitHub integration for Agency","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@octokit/rest":"^21.0.0"},"_hasShrinkwrap":false,"devDependencies":{"nock":"^14.0.15","vitest":"^3.0.0","typescript":"^5.0.0","@types/node":"^25.0.0"},"peerDependencies":{"agency-lang":"0.1.1"},"_npmOperationalInternal":{"tmp":"tmp/github_0.1.0_1778595364219_0.7065422443812179","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agency-lang/github","version":"0.1.1","description":"GitHub integration for Agency","type":"module","agency":"./index.agency","main":"./index.js","exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"},"./package.json":"./package.json"},"author":{"name":"Aditya Bhargava"},"license":"ISC","bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"homepage":"https://github.com/egonSchiele/agency-lang","peerDependencies":{"agency-lang":">=0.9.0"},"dependencies":{"@octokit/rest":"^21.0.0"},"devDependencies":{"@types/node":"^25.0.0","nock":"^14.0.15","typescript":"^5.0.0","vitest":"^3.0.0","agency-lang":"0.9.0"},"scripts":{"build":"tsc","test":"vitest","test:run":"vitest run","test:agency":"agency tests/agency"},"_id":"@agency-lang/github@0.1.1","_integrity":"sha512-nq6XZn1yWG+5J1sFxtcAtHbmpzhlrW1MRLqm0jfFa3MIDWfZpAb64iajJXBGuNs2Oq6+OPydejbmlrN2YYqmjQ==","_resolved":"/private/var/folders/7v/4q_s04w13_dg2278232mcqz80000gn/T/1c0b7124d4108ccd9e99813528f32c26/agency-lang-github-0.1.1.tgz","_from":"file:agency-lang-github-0.1.1.tgz","_nodeVersion":"25.1.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-nq6XZn1yWG+5J1sFxtcAtHbmpzhlrW1MRLqm0jfFa3MIDWfZpAb64iajJXBGuNs2Oq6+OPydejbmlrN2YYqmjQ==","shasum":"3940868b1a47b56cc180b33d72141bc136a1982a","tarball":"https://registry.npmjs.org/@agency-lang/github/-/github-0.1.1.tgz","fileCount":29,"unpackedSize":30713,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG2dHUp7Xf2GvGpYmEacT+1yVVzzCHyMXwG4/sGOfiC2AiEAt+gKeAk9WqxAvsD5Q0m/YFVC2foSDiuH3647qR1vetI="}]},"_npmUser":{"name":"egonschiele","email":"npm@adit.io"},"directories":{},"maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/github_0.1.1_1784420629716_0.6848083604836501"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T14:16:04.008Z","modified":"2026-07-19T00:23:50.052Z","0.1.0":"2026-05-12T14:16:04.368Z","0.1.1":"2026-07-19T00:23:49.859Z"},"bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"author":{"name":"Aditya Bhargava"},"license":"ISC","homepage":"https://github.com/egonSchiele/agency-lang","description":"GitHub integration for Agency","maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"readme":"# @agency-lang/github\n\nGitHub operations stdlib for Agency. Built on Octokit + the local `git` binary.\n\n## Install\n\n```bash\nnpm install @agency-lang/github\n```\n\n## Auth\n\n- `GITHUB_TOKEN` — preferred (auto-provided in `egonSchiele/run-agency-action`).\n- `GH_TOKEN` — `gh` CLI compatibility.\n- `token` argument on each call — explicit override.\n\n## Repo context\n\nAuto-detected from `git remote get-url origin` (HTTPS or SSH form). Override per call with `owner` / `repo` arguments.\n\n## Functions\n\n| Function | Read-only? | Description |\n|---|---|---|\n| `createBranch` |  | Create a branch from another (default: default branch). |\n| `deleteBranch` |  | Delete a branch. |\n| `branchExists` | ✓ | Check whether a branch exists. |\n| `commitFiles` |  | Stage + commit local changes, optionally push. Adds a `Generated-by-Agency-Action` trailer. |\n| `openPullRequest` |  | Open a PR. |\n| `listPullRequests` | ✓ | List PRs. |\n| `commentOnPullRequest` |  | Comment on a PR. |\n| `addLabel` |  | Add labels. |\n| `requestReview` |  | Request reviewers. |\n| `listIssues` | ✓ | List issues (excludes PRs). |\n| `commentOnIssue` |  | Comment on an issue. |\n| `createIssue` |  | Create an issue. |\n| `defaultBranch` | ✓ | Get the repo's default branch. |\n\nRead-only functions are marked `safe` so they're surfaced as `readOnlyHint` in `agency serve mcp`.\n\n## Security\n\n- Branch names are validated with a strict regex before being passed to `git`. Argument-injection patterns like `--upload-pack=...` are rejected.\n- File paths in `git add` are passed after a `--` separator.\n- `git push` is never `--force` or `--force-with-lease`.\n- `commitFiles` does not modify global git config or write tokens to disk; auth uses whatever `origin` already has (e.g. `actions/checkout`'s extraheader, or your local credential helper).\n\n## Example\n\n```ts\nimport { commitFiles, openPullRequest } from \"pkg::@agency-lang/github\"\n\nnode main() {\n  const commit = commitFiles(message: \"agent: tidy\", branch: \"agent/tidy\")\n  openPullRequest(title: \"Tidy\", body: \"Automated.\", head: \"agent/tidy\")\n}\n```\n","readmeFilename":"README.md"}