@github-tools/sdk 1.14.0 → 1.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -0
- package/dist/connect/eve.d.mts +1 -1
- package/dist/connect/eve.mjs +1 -1
- package/dist/connect.d.mts +8 -8
- package/dist/connect.d.mts.map +1 -1
- package/dist/connect.mjs +2 -2
- package/dist/{eve-runtime-D1v4C0UP.d.mts → eve-runtime-Bu8Gy8CS.d.mts} +2 -2
- package/dist/{eve-runtime-D1v4C0UP.d.mts.map → eve-runtime-Bu8Gy8CS.d.mts.map} +1 -1
- package/dist/{eve-runtime-BdolQrBF.mjs → eve-runtime-Cfyy1tzp.mjs} +3 -2
- package/dist/eve-runtime-Cfyy1tzp.mjs.map +1 -0
- package/dist/eve-runtime.d.mts +4 -4
- package/dist/eve-runtime.mjs +3 -3
- package/dist/eve.d.mts +1 -1
- package/dist/eve.mjs +2 -2
- package/dist/{index-PqQNoVuw.d.mts → index-BOerqLIm.d.mts} +114 -2
- package/dist/index-BOerqLIm.d.mts.map +1 -0
- package/dist/index.d.mts +2 -2
- package/dist/index.mjs +3 -3
- package/dist/{src-D9WxaIVj.mjs → src-C54blWpT.mjs} +2 -2
- package/dist/{src-D9WxaIVj.mjs.map → src-C54blWpT.mjs.map} +1 -1
- package/dist/{token-Dt6qs_kf.mjs → token-Iop2lapd.mjs} +61 -10
- package/dist/token-Iop2lapd.mjs.map +1 -0
- package/dist/tool-types-DbZpOYFG.d.mts.map +1 -1
- package/dist/{types-BAEqBfM5.d.mts → types-v39VrZ-m.d.mts} +11 -2
- package/dist/types-v39VrZ-m.d.mts.map +1 -0
- package/dist/workflow.d.mts +1 -1
- package/dist/workflow.mjs +2 -2
- package/dist/{write-tools-Ct0ZV87Z.mjs → write-tools-BvuWAzwo.mjs} +154 -14
- package/dist/write-tools-BvuWAzwo.mjs.map +1 -0
- package/package.json +2 -1
- package/dist/eve-runtime-BdolQrBF.mjs.map +0 -1
- package/dist/index-PqQNoVuw.d.mts.map +0 -1
- package/dist/token-Dt6qs_kf.mjs.map +0 -1
- package/dist/types-BAEqBfM5.d.mts.map +0 -1
- package/dist/write-tools-Ct0ZV87Z.mjs.map +0 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@github-tools/sdk",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.16.0",
|
|
4
4
|
"description": "A typed tool layer for GitHub AI agents, with presets, human approval, and durable execution. Works with eve, the AI SDK, Vercel Workflow, and Chat SDK",
|
|
5
5
|
"author": "HugoRCD <hugo.richard@vercel.com",
|
|
6
6
|
"repository": {
|
|
@@ -59,6 +59,7 @@
|
|
|
59
59
|
],
|
|
60
60
|
"license": "MIT",
|
|
61
61
|
"dependencies": {
|
|
62
|
+
"evlog": "^2.27.1",
|
|
62
63
|
"octokit": "^5.0.5"
|
|
63
64
|
},
|
|
64
65
|
"peerDependencies": {
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"eve-runtime-BdolQrBF.mjs","names":[],"sources":["../src/eve/load-eve.ts","../src/eve/approval.ts","../src/eve/registry.ts","../src/eve/steps.ts","../src/eve/build.ts"],"sourcesContent":["import * as eveTools from 'eve/tools'\nimport * as eveApproval from 'eve/tools/approval'\n\n/**\n * Static ESM imports so bundlers (eve/Nitro/Vercel) can resolve `eve` when it is\n * compiled into the output rather than left as `node_modules/eve` at runtime.\n * Runtime `createRequire(\"eve/tools\")` fails in those targets.\n */\nexport type EveToolsModule = typeof import('eve/tools')\nexport type EveApprovalModule = typeof import('eve/tools/approval')\n\n/**\n * @deprecated Never thrown since eve moved to static ESM imports — a missing\n * `eve` package now fails at module resolution with the bundler/runtime's own\n * error. Kept only for backward compatibility of the public export; do not\n * match on it. Will be removed in the next major.\n */\nexport const MISSING_EVE_MESSAGE =\n 'The \"eve\" package is required to use @github-tools/sdk/eve. Install it with: pnpm add eve'\n\nexport function getEveTools(): EveToolsModule {\n return eveTools\n}\n\nexport function getEveApprovalHelpers(): EveApprovalModule {\n return eveApproval\n}\n","import type { Approval, ApprovalPolicy } from 'eve/tools/approval'\nimport type { GithubWriteToolName } from '../core/write-tools'\nimport { getEveApprovalHelpers } from './load-eve'\nimport type { EveApprovalConfig, EveApprovalValue } from './types'\n\n/**\n * `false` / `'never'` should omit the tool `approval` field entirely.\n * eve treats a missing `approval` like `never()`; attaching `never()` is\n * redundant and has caused approval UI noise on some channels.\n */\nexport function isEveApprovalDisabled(value: EveApprovalValue | undefined): boolean {\n return value === false || value === 'never'\n}\n\nexport function mapEveApprovalValue(value: EveApprovalValue): ApprovalPolicy {\n if (typeof value === 'function') return value\n // Object-shaped eve `ApprovalConfiguration` — the request-time policy lives on `request`.\n if (typeof value === 'object') return value.request\n\n const { always, never, once } = getEveApprovalHelpers()\n\n if (value === true || value === 'always') return always()\n if (value === false || value === 'never') return never()\n return once()\n}\n\nexport function resolveEveApproval(\n toolName: GithubWriteToolName,\n config: EveApprovalConfig | undefined,\n): ApprovalPolicy {\n if (config === undefined) return getEveApprovalHelpers().always()\n if (config === true) return getEveApprovalHelpers().always()\n if (config === false) return getEveApprovalHelpers().never()\n\n const value = config[toolName]\n if (value === undefined) return getEveApprovalHelpers().always()\n\n return mapEveApprovalValue(value)\n}\n\n/**\n * Approval to attach on a write tool, or `undefined` to omit the field.\n * Prefer this when building `defineTool` values so `false` / `'never'` do not\n * attach a redundant `never()` handler.\n */\nexport function resolveEveToolApproval(\n toolName: GithubWriteToolName,\n config: EveApprovalConfig | undefined,\n override?: EveApprovalValue,\n): Approval | undefined {\n const value = override !== undefined\n ? override\n : typeof config === 'object' && config !== null\n ? config[toolName]\n : config\n\n if (value === undefined) return getEveApprovalHelpers().always()\n if (isEveApprovalDisabled(value)) return undefined\n // Pass policies and `ApprovalConfiguration` objects through unchanged so a\n // response-time authorizer (`response`) survives onto `defineTool`.\n if (typeof value === 'function' || typeof value === 'object') return value\n return mapEveApprovalValue(value)\n}\n","import type { ToolModelOutput } from 'eve/tools'\nimport type { z } from 'zod'\nimport type { CommitIdentity } from '../types'\nimport { GITHUB_TOOL_CATALOG, isGithubWriteToolName } from '../core/catalog'\nimport { mergeContextArgs, softenContextSchema, type GithubToolsContext } from '../core/context'\nimport {\n compareCommitsToModelOutput,\n getCommitToModelOutput,\n getFileContentToModelOutput,\n getPullRequestContextToModelOutput,\n getRepositoryTreeToModelOutput,\n listPullRequestFilesToModelOutput,\n} from '../core/model-output'\nimport { stripRateLimit } from '../core/rate-limit'\nimport { resolveGithubToken, type GithubTokenInput } from '../core/token'\nimport type { GithubWriteToolName } from '../core/write-tools'\nimport { ALL_GITHUB_TOOL_NAMES, type GithubToolName } from '../core/tool-names'\nexport type { GithubToolName } from '../core/tool-names'\nexport { ALL_GITHUB_TOOL_NAMES } from '../core/tool-names'\n\nexport type ToolBuildContext = {\n token: GithubTokenInput\n context?: GithubToolsContext\n author?: CommitIdentity\n committer?: CommitIdentity\n coAuthors?: CommitIdentity[]\n}\n\ntype ToolRegistryEntry = {\n name: GithubToolName\n writeTool?: GithubWriteToolName\n description: string\n inputSchema: z.ZodType\n execute: (args: Record<string, unknown>) => Promise<unknown>\n toModelOutput?: (output: unknown) => ToolModelOutput\n}\n\nfunction withToken<T extends Record<string, unknown>>(\n core: (args: T & { token: string }) => Promise<unknown>,\n ctx: ToolBuildContext,\n extra?: Record<string, unknown>,\n) {\n return async (input: Record<string, unknown>) =>\n core({\n token: await resolveGithubToken(ctx.token),\n ...extra,\n ...mergeContextArgs(input, ctx.context ?? {}),\n } as T & { token: string })\n}\n\nfunction modelOutputAdapter(\n fn: (options: { toolCallId: string, input: unknown, output: unknown }) => { type: 'json' | 'text', value: unknown },\n) {\n return (output: unknown) => fn({ toolCallId: '', input: {}, output }) as ToolModelOutput\n}\n\nconst GITHUB_EVE_TOOL_MODEL_OUTPUT = {\n getFileContent: modelOutputAdapter(getFileContentToModelOutput),\n getRepositoryTree: modelOutputAdapter(getRepositoryTreeToModelOutput),\n listPullRequestFiles: modelOutputAdapter(listPullRequestFilesToModelOutput),\n getPullRequestContext: modelOutputAdapter(getPullRequestContextToModelOutput),\n getCommit: modelOutputAdapter(getCommitToModelOutput),\n compareCommits: modelOutputAdapter(compareCommitsToModelOutput),\n} satisfies Partial<Record<GithubToolName, (output: unknown) => ToolModelOutput>>\n\nconst EVE_TOOL_MODEL_OUTPUTS: Partial<Record<GithubToolName, (output: unknown) => ToolModelOutput>> = GITHUB_EVE_TOOL_MODEL_OUTPUT\n\n/** Whether a GitHub tool has a built-in eve `toModelOutput` projection. */\nexport function hasGithubEveToolModelOutput(name: GithubToolName): boolean {\n return Object.hasOwn(GITHUB_EVE_TOOL_MODEL_OUTPUT, name)\n}\n\n/**\n * Apply the built-in eve `toModelOutput` projection for a tool.\n * Strips `rateLimit` so it never reaches the model. Tools without a dedicated\n * formatter get `{ type: 'json', value }` of the remaining payload.\n * Used by `@github-tools/eve-extension` so the callback only closes over a serializable tool name.\n */\nexport function formatGithubEveToolOutput(name: GithubToolName, output: unknown): ToolModelOutput {\n const stripped = stripRateLimit(output)\n // `runGithubToolStep` returns `{ error }` when execute throws. The per-tool\n // formatters assume the success shape (e.g. `listPullRequestFilesToModelOutput`\n // calls `.map` on the payload), so dispatching an error payload would throw a\n // second time inside model-output formatting and re-break the tool loop.\n if (isErrorPayload(stripped)) {\n return { type: 'json', value: stripped }\n }\n const format = GITHUB_EVE_TOOL_MODEL_OUTPUT[name as keyof typeof GITHUB_EVE_TOOL_MODEL_OUTPUT]\n if (!format) {\n return { type: 'json', value: stripped }\n }\n return format(stripped)\n}\n\nfunction isErrorPayload(output: unknown): output is { error: string } {\n return (\n output != null\n && typeof output === 'object'\n && !Array.isArray(output)\n && typeof (output as { error?: unknown }).error === 'string'\n )\n}\n\nexport function createToolRegistry(ctx: ToolBuildContext): ToolRegistryEntry[] {\n // Commit-identity options are session-level, not model inputs, so they ride\n // alongside the token instead of living in the tool's input schema.\n const commitExtras: Partial<Record<GithubToolName, Record<string, unknown>>> = {\n createOrUpdateFile: { author: ctx.author, committer: ctx.committer, coAuthors: ctx.coAuthors },\n mergePullRequest: { coAuthors: ctx.coAuthors },\n }\n\n const entries = ALL_GITHUB_TOOL_NAMES.map((name): ToolRegistryEntry => {\n const descriptor = GITHUB_TOOL_CATALOG[name]\n // Argument types vary per tool; `withToken` re-narrows at the dispatch boundary.\n const core = descriptor.core as (args: Record<string, unknown> & { token: string }) => Promise<unknown>\n const toModelOutput = EVE_TOOL_MODEL_OUTPUTS[name]\n return {\n name,\n ...(isGithubWriteToolName(name) && { writeTool: name }),\n description: descriptor.description,\n inputSchema: descriptor.inputSchema,\n execute: withToken(core, ctx, commitExtras[name]),\n ...(toModelOutput && { toModelOutput }),\n }\n })\n\n if (!ctx.context) return entries\n\n return entries.map(entry => ({\n ...entry,\n inputSchema: softenContextSchema(entry.inputSchema, ctx.context!),\n }))\n}\n","import { resolveGithubToken } from '../core/token'\nimport { createToolRegistry, type GithubToolName, type ToolBuildContext } from './registry'\n\nasync function executeGithubToolStep(\n name: GithubToolName,\n input: Record<string, unknown>,\n ctx: ToolBuildContext,\n) {\n 'use step'\n const entry = createToolRegistry(ctx).find(tool => tool.name === name)\n if (!entry) {\n throw new Error(`Unknown GitHub tool: ${name}`)\n }\n return entry.execute(input)\n}\n\nexport async function runGithubToolStep(\n name: GithubToolName,\n input: Record<string, unknown>,\n ctx: ToolBuildContext,\n) {\n try {\n // Resolve the token before entering the step so only a serializable string crosses the boundary.\n const token = await resolveGithubToken(ctx.token)\n return await executeGithubToolStep(name, input, { ...ctx, token })\n } catch (error) {\n // Eve's tool-loop logs thrown execute errors but does not always append a\n // tool_result. Returning a payload keeps the Anthropic tool_use/tool_result pairing intact.\n return { error: error instanceof Error ? error.message : String(error) }\n }\n}\n","import type { ToolDefinition } from 'eve/tools'\nimport { resolvePresetTools, type CombinedPresetToolNames, type GithubToolPreset, type PresetToolName } from '../core/presets'\nimport { createGithubTokenResolver } from '../core/token'\nimport { isEveApprovalDisabled, mapEveApprovalValue, resolveEveToolApproval } from './approval'\nimport { getEveTools } from './load-eve'\nimport { ALL_GITHUB_TOOL_NAMES, createToolRegistry, formatGithubEveToolOutput, hasGithubEveToolModelOutput, type GithubToolName, type ToolBuildContext } from './registry'\nimport { runGithubToolStep } from './steps'\nimport type { EveGithubToolsOptions, EveToolFactoryOptions, EveToolOverrides } from './types'\n\ntype BuildOptions = EveGithubToolsOptions | (EveToolFactoryOptions & { preset?: EveGithubToolsOptions['preset'] })\ntype EveToolMap = Partial<Record<GithubToolName, ToolDefinition>>\n\nfunction resolveAllowedToolNames(\n options: Pick<EveGithubToolsOptions, 'preset' | 'include' | 'exclude'>,\n): (name: GithubToolName) => boolean {\n const presetAllowed = options.preset ? resolvePresetTools(options.preset) : null\n const includeAllowed = options.include ? new Set(options.include) : null\n const excluded = options.exclude ? new Set(options.exclude) : null\n\n // `preset` and `include` compose as a union (add tools a preset is missing);\n // `exclude` always subtracts from that combined set afterward.\n const allowed = presetAllowed && includeAllowed\n ? new Set([...presetAllowed, ...includeAllowed])\n : presetAllowed ?? includeAllowed\n\n return name => (!allowed || allowed.has(name)) && !excluded?.has(name)\n}\n\nfunction applyOverrides<T extends ToolDefinition>(\n tool: T,\n name: GithubToolName,\n overrides?: EveToolOverrides,\n): T {\n const override = overrides?.[name]\n if (!override) return tool\n\n const next: T = {\n ...tool,\n ...override.description !== undefined && { description: override.description },\n ...override.toModelOutput !== undefined && { toModelOutput: override.toModelOutput },\n ...override.outputSchema !== undefined && { outputSchema: override.outputSchema },\n }\n\n if (override.approval === undefined) return next\n if (isEveApprovalDisabled(override.approval)) {\n const rest = { ...next }\n delete (rest as { approval?: unknown }).approval\n return rest\n }\n // Preserve policies and `ApprovalConfiguration` objects as-is; only literals need mapping.\n const approval = typeof override.approval === 'function' || typeof override.approval === 'object'\n ? override.approval\n : mapEveApprovalValue(override.approval)\n return { ...next, approval }\n}\n\nexport function buildEveToolDefinition(\n name: GithubToolName,\n options: BuildOptions = {},\n): ToolDefinition {\n const { defineTool } = getEveTools()\n const ctx: ToolBuildContext = {\n token: createGithubTokenResolver(options.token),\n context: options.context,\n author: options.author,\n committer: options.committer,\n coAuthors: options.coAuthors,\n }\n\n const entry = createToolRegistry(ctx).find(tool => tool.name === name)\n if (!entry) {\n throw new Error(`Unknown GitHub tool: ${name}`)\n }\n\n const approval = entry.writeTool\n ? resolveEveToolApproval(entry.writeTool, options.requireApproval)\n : undefined\n\n // Annotated so defineTool resolves to its ToolDefinition overload — inference\n // from the bare literal picks the background-tool overload on eve 0.45+.\n const definition: ToolDefinition = {\n description: entry.description,\n inputSchema: entry.inputSchema,\n ...(approval && { approval }),\n toModelOutput: (output: unknown) => formatGithubEveToolOutput(name, output),\n execute: async (input) => runGithubToolStep(name, input as Record<string, unknown>, ctx),\n }\n\n return applyOverrides(defineTool(definition), name, options.overrides)\n}\n\nexport function buildEveToolMap(options: EveGithubToolsOptions = {}): EveToolMap {\n const { defineTool } = getEveTools()\n const ctx: ToolBuildContext = {\n token: createGithubTokenResolver(options.token),\n context: options.context,\n author: options.author,\n committer: options.committer,\n coAuthors: options.coAuthors,\n }\n\n const isAllowed = resolveAllowedToolNames(options)\n const registry = createToolRegistry(ctx)\n const tools = {} as EveToolMap\n\n for (const entry of registry) {\n if (!isAllowed(entry.name)) continue\n\n const approval = entry.writeTool\n ? resolveEveToolApproval(entry.writeTool, options.requireApproval)\n : undefined\n\n const definition: ToolDefinition = {\n description: entry.description,\n inputSchema: entry.inputSchema,\n ...(approval && { approval }),\n toModelOutput: (output: unknown) => formatGithubEveToolOutput(entry.name, output),\n execute: async (input) => runGithubToolStep(entry.name, input as Record<string, unknown>, ctx),\n }\n\n tools[entry.name] = applyOverrides(defineTool(definition), entry.name, options.overrides)\n }\n\n return tools\n}\n\nexport function createEveGithubToolsDynamic(options: EveGithubToolsOptions = {}) {\n const { defineDynamic } = getEveTools()\n\n // TODO(eve-auth): resolve token from ctx.getToken('github') when eve-managed auth lands.\n // Deferred — eve does not yet expose managed GitHub tokens on the session context.\n return defineDynamic({\n events: {\n 'step.started': async () => buildEveToolMap(options),\n },\n })\n}\n\nexport function listResolvedEveToolNames(options?: { preset?: undefined, include?: undefined, exclude?: undefined }): GithubToolName[]\nexport function listResolvedEveToolNames<P extends GithubToolPreset>(options: { preset: P, include?: undefined, exclude?: undefined }): PresetToolName<P>[]\nexport function listResolvedEveToolNames<P extends readonly GithubToolPreset[]>(options: { preset: P, include?: undefined, exclude?: undefined }): CombinedPresetToolNames<P>[]\nexport function listResolvedEveToolNames(options: Pick<EveGithubToolsOptions, 'preset' | 'include' | 'exclude'>): GithubToolName[]\nexport function listResolvedEveToolNames(options: Pick<EveGithubToolsOptions, 'preset' | 'include' | 'exclude'> = {}): GithubToolName[] {\n const isAllowed = resolveAllowedToolNames(options)\n return ALL_GITHUB_TOOL_NAMES.filter(isAllowed)\n}\n\n/**\n * Tool descriptors (no `execute`) for authored eve `defineTool` loops.\n * Prefer this when registering tools outside the SDK package so durable transforms can hoist inline execute.\n */\nexport function listEveToolDescriptors(options: EveGithubToolsOptions = {}) {\n const ctx: ToolBuildContext = {\n token: createGithubTokenResolver(options.token),\n context: options.context,\n author: options.author,\n committer: options.committer,\n coAuthors: options.coAuthors,\n }\n\n const isAllowed = resolveAllowedToolNames(options)\n return createToolRegistry(ctx)\n .filter(entry => isAllowed(entry.name))\n .map(entry => ({\n name: entry.name,\n description: entry.description,\n inputSchema: entry.inputSchema,\n writeTool: entry.writeTool,\n toModelOutput: entry.toModelOutput,\n }))\n}\n\nexport { formatGithubEveToolOutput, hasGithubEveToolModelOutput }\n\n/**\n * Execute a GitHub tool by name with the given eve options (token/context/attribution).\n * Used by `@github-tools/eve-extension` so `execute` only closes over a serializable tool name.\n */\nexport async function executeGithubEveTool(\n name: GithubToolName,\n input: Record<string, unknown>,\n options: EveGithubToolsOptions = {},\n) {\n const ctx: ToolBuildContext = {\n token: createGithubTokenResolver(options.token),\n context: options.context,\n author: options.author,\n committer: options.committer,\n coAuthors: options.coAuthors,\n }\n return runGithubToolStep(name, input, ctx)\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index-PqQNoVuw.d.mts","names":[],"sources":["../src/client.ts","../src/tools/repository.ts","../src/tools/pull-requests.ts","../src/tools/issues.ts","../src/tools/reactions.ts","../src/tools/discussions.ts","../src/tools/notifications.ts","../src/tools/search.ts","../src/tools/commits.ts","../src/tools/gists.ts","../src/tools/workflows.ts","../src/tools/checks.ts","../src/tools/releases.ts","../src/tools/bundles.ts","../src/core/rate-limit.ts","../src/agents.ts","../src/index.ts"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"token-Dt6qs_kf.mjs","names":[],"sources":["../src/connect/connector.ts","../src/connect/scopes.ts","../src/connect/params.ts","../src/connect/token.ts"],"sourcesContent":["/**\n * A Vercel Connect connector name, or a resolver that returns one.\n *\n * Use a function to pick the connector dynamically — e.g. a different\n * connector per environment (`production` vs. `preview`) or per tenant.\n * It's resolved lazily, on every token request, alongside the token itself.\n */\nexport type GithubConnectorInput = string | (() => string | Promise<string>)\n\n/** Resolves a {@link GithubConnectorInput} to a connector name string. */\nexport async function resolveGithubConnector(connector: GithubConnectorInput): Promise<string> {\n return typeof connector === 'function' ? await connector() : connector\n}\n","import { resolvePresetTools, type GithubToolPreset } from '../core/presets'\nimport { GITHUB_TOOL_CATALOG } from '../core/catalog'\nimport { ALL_GITHUB_TOOL_NAMES, type GithubToolName } from '../core/tool-names'\n\n/**\n * Vercel Connect scope strings mapped to each {@link GithubToolPreset}.\n *\n * Scopes mirror GitHub App permissions (`contents`, `pull_requests`, `issues`,\n * `discussions`, `actions`, `checks`, `statuses`, `administration`, `metadata`)\n * and must cover every read/write family a preset's tools touch, not just its\n * primary domain. Release tools fall under the `contents` permission on GitHub\n * Apps, and reaction tools under `issues`, so neither needs a scope of its own.\n *\n * Gist tools in `repo-explorer` and `maintainer` are intentionally left\n * unscoped: the Gists API only accepts GitHub App *user* access tokens, never\n * installation tokens, and Connect always mints `subject: { type: 'app' }`\n * installation tokens. Gist calls made with a Connect-derived token 403\n * regardless of requested scopes — use a fine-grained PAT with the \"Gists\"\n * account permission for those tools instead.\n *\n * Notification tools in `maintainer` and `notification-inbox` are unscoped for\n * the same reason: `notifications` is an account-level GitHub App permission\n * that only applies to user access tokens, so `listNotifications` /\n * `markNotificationRead` need a PAT with the \"Notifications\" account permission.\n */\nexport const PRESET_CONNECT_SCOPES = {\n 'repo-explorer': [\n 'contents:read',\n 'metadata:read',\n 'pull_requests:read',\n 'issues:read',\n 'discussions:read',\n 'actions:read',\n 'checks:read',\n 'statuses:read',\n ],\n 'code-review': [\n 'contents:read',\n 'metadata:read',\n 'pull_requests:read',\n 'pull_requests:write',\n 'checks:read',\n 'statuses:read',\n ],\n 'issue-triage': [\n 'contents:read',\n 'metadata:read',\n 'issues:read',\n 'issues:write',\n ],\n 'ci-ops': [\n 'contents:read',\n 'metadata:read',\n 'actions:read',\n 'actions:write',\n 'checks:read',\n 'statuses:read',\n ],\n 'security-audit': [\n 'contents:read',\n 'metadata:read',\n 'pull_requests:read',\n 'issues:read',\n 'issues:write',\n 'actions:read',\n 'checks:read',\n 'statuses:read',\n ],\n 'release-manager': [\n 'contents:read',\n 'contents:write',\n 'metadata:read',\n 'pull_requests:read',\n 'actions:read',\n 'actions:write',\n ],\n 'discussion-moderator': [\n 'contents:read',\n 'metadata:read',\n 'issues:read',\n 'issues:write',\n 'discussions:read',\n 'discussions:write',\n ],\n 'notification-inbox': [\n 'contents:read',\n 'metadata:read',\n 'pull_requests:read',\n 'issues:read',\n ],\n 'pr-author': [\n 'contents:read',\n 'contents:write',\n 'metadata:read',\n 'pull_requests:read',\n 'pull_requests:write',\n ],\n 'maintainer': [\n 'contents:read',\n 'contents:write',\n 'metadata:read',\n 'pull_requests:read',\n 'pull_requests:write',\n 'issues:read',\n 'issues:write',\n 'discussions:read',\n 'discussions:write',\n 'actions:read',\n 'actions:write',\n 'checks:read',\n 'statuses:read',\n 'administration:read',\n 'administration:write',\n ],\n} as const satisfies Record<GithubToolPreset, readonly string[]>\n\n/** Default scopes when no preset is specified — union of all preset scopes. */\nconst ALL_CONNECT_SCOPES = [\n ...new Set(Object.values(PRESET_CONNECT_SCOPES).flat()),\n] as string[]\n\n/** Stable scope order for tool-derived unions (tests + Connect payloads). */\nconst SCOPE_ORDER = [\n 'contents:read',\n 'contents:write',\n 'metadata:read',\n 'pull_requests:read',\n 'pull_requests:write',\n 'issues:read',\n 'issues:write',\n 'discussions:read',\n 'discussions:write',\n 'actions:read',\n 'actions:write',\n 'checks:read',\n 'statuses:read',\n 'administration:read',\n 'administration:write',\n] as const\n\n/**\n * Per-tool Connect scopes, derived from `GITHUB_TOOL_CATALOG`. Empty arrays are\n * intentional for gist and notification tools (installation tokens cannot\n * satisfy those APIs).\n */\nexport const TOOL_CONNECT_SCOPES = ALL_GITHUB_TOOL_NAMES.reduce(\n (map, name) => {\n map[name] = GITHUB_TOOL_CATALOG[name].connectScopes\n return map\n },\n {} as Record<GithubToolName, readonly string[]>,\n)\n\nfunction orderScopes(scopes: Set<string>): string[] {\n return SCOPE_ORDER.filter(scope => scopes.has(scope))\n}\n\n/**\n * Returns Vercel Connect scopes for a preset or combined presets.\n * Without a preset, returns the union of all preset scopes (full tool set).\n */\nexport function connectGithubScopesForPreset(\n preset?: GithubToolPreset | GithubToolPreset[],\n): string[] {\n if (!preset) return [...ALL_CONNECT_SCOPES]\n\n const presets = Array.isArray(preset) ? preset : [preset]\n return [\n ...new Set(presets.flatMap(p => PRESET_CONNECT_SCOPES[p])),\n ]\n}\n\n/**\n * Returns Connect scopes covering exactly the given tools.\n * Always includes `metadata:read`. Gist and notification tools contribute nothing.\n */\nexport function connectGithubScopesForTools(names: readonly GithubToolName[]): string[] {\n const scopes = new Set<string>(['metadata:read'])\n for (const name of names) {\n for (const scope of TOOL_CONNECT_SCOPES[name]) {\n scopes.add(scope)\n }\n }\n return orderScopes(scopes)\n}\n\nexport type ConnectScopeSelection = {\n preset?: GithubToolPreset | GithubToolPreset[]\n include?: readonly GithubToolName[]\n exclude?: readonly GithubToolName[]\n}\n\nfunction resolveSelectedToolNames({\n preset,\n include,\n exclude,\n}: ConnectScopeSelection): GithubToolName[] {\n const presetAllowed = preset ? resolvePresetTools(preset) : null\n const includeAllowed = include ? new Set(include) : null\n const excluded = exclude ? new Set(exclude) : null\n\n const allowed = presetAllowed && includeAllowed\n ? new Set([...presetAllowed, ...includeAllowed])\n : presetAllowed ?? includeAllowed\n\n return ALL_GITHUB_TOOL_NAMES.filter(\n name => (!allowed || allowed.has(name)) && !excluded?.has(name),\n )\n}\n\n/**\n * Resolves Connect scopes for the effective tool set.\n *\n * - No `include` / `exclude`: same as {@link connectGithubScopesForPreset}\n * (omitted preset → full union, including `administration:write`).\n * - With `include` and/or `exclude`: scopes are derived from the resolved tools\n * so a hand-picked `include` list does not mint the full admin surface.\n */\nexport function connectGithubScopesForSelection(selection: ConnectScopeSelection = {}): string[] {\n const { preset, include, exclude } = selection\n if (!include && !exclude) {\n return connectGithubScopesForPreset(preset)\n }\n return connectGithubScopesForTools(resolveSelectedToolNames(selection))\n}\n","import type { ConnectTokenParams } from '@vercel/connect'\nimport { connectGithubScopesForSelection } from './scopes'\nimport type { ConnectGithubTokenOptions, GithubConnectParams } from './types'\n\nexport function resolveGithubConnectTokenParams(\n options: ConnectGithubTokenOptions = {},\n): ConnectTokenParams {\n const { preset, include, exclude, params } = options\n const scopes = params?.scopes ?? connectGithubScopesForSelection({ preset, include, exclude })\n return buildConnectTokenParams(scopes, params)\n}\n\nfunction buildConnectTokenParams(\n scopes: string[],\n params?: GithubConnectParams,\n): ConnectTokenParams {\n const { repositories, ...rest } = params ?? {}\n\n const authorizationDetails = rest.authorizationDetails\n ?? (repositories?.length\n ? [{ type: 'github_app_installation' as const, repositories }]\n : undefined)\n\n return {\n subject: { type: 'app' },\n ...rest,\n scopes,\n ...(authorizationDetails && { authorizationDetails }),\n }\n}\n","import { getToken, type ConnectOptions } from '@vercel/connect'\nimport type { GithubTokenInput } from '../core/token'\nimport { resolveGithubConnector, type GithubConnectorInput } from './connector'\nimport { resolveGithubConnectTokenParams } from './params'\nimport type { ConnectGithubTokenOptions } from './types'\n\n/**\n * Returns a lazy GitHub token provider backed by a Vercel Connect connector.\n * Scopes are derived from `preset`, or from the resolved `include`/`exclude`\n * tool set when those are set, unless overridden in `params.scopes`.\n *\n * `connector` may be a static name or a resolver function — e.g. to pick a\n * different connector per environment (production vs. preview) or tenant.\n * It's re-resolved on every call, alongside the token itself.\n */\nexport function connectGithubToken(\n connector: GithubConnectorInput,\n options: ConnectGithubTokenOptions = {},\n): GithubTokenInput {\n const { connectOptions } = options\n const tokenParams = resolveGithubConnectTokenParams(options)\n\n return async () => getToken(\n await resolveGithubConnector(connector),\n tokenParams,\n resolveConnectOptions(connectOptions),\n )\n}\n\n/**\n * Prefer an explicit `vercelToken`, then `VERCEL_OIDC_TOKEN` from the environment.\n * Passing the env token into `getToken` skips `@vercel/oidc`'s project-root walk,\n * which fails inside eve/workflow snapshots that have no `.vercel` directory.\n */\nfunction resolveConnectOptions(connectOptions?: ConnectOptions): ConnectOptions | undefined {\n const vercelToken = connectOptions?.vercelToken ?? process.env.VERCEL_OIDC_TOKEN\n if (!vercelToken && !connectOptions) return undefined\n return {\n ...vercelToken ? { vercelToken } : {},\n ...connectOptions,\n }\n}\n\nexport type { ConnectOptions }\n"],"mappings":";;;;AAUA,eAAsB,uBAAuB,WAAkD;CAC7F,OAAO,OAAO,cAAc,aAAa,MAAM,UAAU,IAAI;AAC/D;;;;;;;;;;;;;;;;;;;;;;;;ACaA,MAAa,wBAAwB;CACnC,iBAAiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACA;CACF;CACA,gBAAgB;EACd;EACA;EACA;EACA;CACF;CACA,UAAU;EACR;EACA;EACA;EACA;EACA;EACA;CACF;CACA,kBAAkB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,mBAAmB;EACjB;EACA;EACA;EACA;EACA;EACA;CACF;CACA,wBAAwB;EACtB;EACA;EACA;EACA;EACA;EACA;CACF;CACA,sBAAsB;EACpB;EACA;EACA;EACA;CACF;CACA,aAAa;EACX;EACA;EACA;EACA;EACA;CACF;CACA,cAAc;EACZ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;AAGA,MAAM,qBAAqB,CACzB,GAAG,IAAI,IAAI,OAAO,OAAO,qBAAqB,CAAC,CAAC,KAAK,CAAC,CACxD;;AAGA,MAAM,cAAc;CAClB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,MAAa,sBAAsB,sBAAsB,QACtD,KAAK,SAAS;CACb,IAAI,QAAQ,oBAAoB,KAAK,CAAC;CACtC,OAAO;AACT,GACA,CAAC,CACH;AAEA,SAAS,YAAY,QAA+B;CAClD,OAAO,YAAY,QAAO,UAAS,OAAO,IAAI,KAAK,CAAC;AACtD;;;;;AAMA,SAAgB,6BACd,QACU;CACV,IAAI,CAAC,QAAQ,OAAO,CAAC,GAAG,kBAAkB;CAG1C,OAAO,CACL,GAAG,IAAI,KAFO,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM,EAAA,CAEnC,SAAQ,MAAK,sBAAsB,EAAE,CAAC,CAC3D;AACF;;;;;AAMA,SAAgB,4BAA4B,OAA4C;CACtF,MAAM,yBAAS,IAAI,IAAY,CAAC,eAAe,CAAC;CAChD,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,SAAS,oBAAoB,OACtC,OAAO,IAAI,KAAK;CAGpB,OAAO,YAAY,MAAM;AAC3B;AAQA,SAAS,yBAAyB,EAChC,QACA,SACA,WAC0C;CAC1C,MAAM,gBAAgB,SAAS,mBAAmB,MAAM,IAAI;CAC5D,MAAM,iBAAiB,UAAU,IAAI,IAAI,OAAO,IAAI;CACpD,MAAM,WAAW,UAAU,IAAI,IAAI,OAAO,IAAI;CAE9C,MAAM,UAAU,iBAAiB,iCAC7B,IAAI,IAAI,CAAC,GAAG,eAAe,GAAG,cAAc,CAAC,IAC7C,iBAAiB;CAErB,OAAO,sBAAsB,QAC3B,UAAS,CAAC,WAAW,QAAQ,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,CAChE;AACF;;;;;;;;;AAUA,SAAgB,gCAAgC,YAAmC,CAAC,GAAa;CAC/F,MAAM,EAAE,QAAQ,SAAS,YAAY;CACrC,IAAI,CAAC,WAAW,CAAC,SACf,OAAO,6BAA6B,MAAM;CAE5C,OAAO,4BAA4B,yBAAyB,SAAS,CAAC;AACxE;;;AC5NA,SAAgB,gCACd,UAAqC,CAAC,GAClB;CACpB,MAAM,EAAE,QAAQ,SAAS,SAAS,WAAW;CAE7C,OAAO,wBADQ,QAAQ,UAAU,gCAAgC;EAAE;EAAQ;EAAS;CAAQ,CAAC,GACtD,MAAM;AAC/C;AAEA,SAAS,wBACP,QACA,QACoB;CACpB,MAAM,EAAE,cAAc,GAAG,SAAS,UAAU,CAAC;CAE7C,MAAM,uBAAuB,KAAK,yBAC5B,cAAc,SACd,CAAC;EAAE,MAAM;EAAoC;CAAa,CAAC,IAC3D,KAAA;CAEN,OAAO;EACL,SAAS,EAAE,MAAM,MAAM;EACvB,GAAG;EACH;EACA,GAAI,wBAAwB,EAAE,qBAAqB;CACrD;AACF;;;;;;;;;;;;ACdA,SAAgB,mBACd,WACA,UAAqC,CAAC,GACpB;CAClB,MAAM,EAAE,mBAAmB;CAC3B,MAAM,cAAc,gCAAgC,OAAO;CAE3D,OAAO,YAAY,SACjB,MAAM,uBAAuB,SAAS,GACtC,aACA,sBAAsB,cAAc,CACtC;AACF;;;;;;AAOA,SAAS,sBAAsB,gBAA6D;CAC1F,MAAM,cAAc,gBAAgB,eAAe,QAAQ,IAAI;CAC/D,IAAI,CAAC,eAAe,CAAC,gBAAgB,OAAO,KAAA;CAC5C,OAAO;EACL,GAAG,cAAc,EAAE,YAAY,IAAI,CAAC;EACpC,GAAG;CACL;AACF"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"types-BAEqBfM5.d.mts","names":[],"sources":["../src/connect/connector.ts","../src/connect/types.ts"],"mappings":";;;;;;;;;;;KAOY,gDAAgD;;iBAGtC,uBAAuB,WAAW,uBAAuB;;;;;;;KCAnE,sBAAsB,KAAK;;EAErC;;KAGU,4BAA4B;EACtC,SAAS,mBAAmB;EAC5B,UAAU;;KAGA,+BAA+B,KAAK;EAC9C,UAAU;;KAGA;EACV,SAAS,mBAAmB;;EAE5B,mBAAmB;;EAEnB,mBAAmB;EACnB,SAAS;EACT,iBAAiB"}
|