@github-tools/sdk 1.15.0 → 1.16.1
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 +2 -3
- package/dist/connect/eve.d.mts.map +1 -1
- package/dist/connect/eve.mjs +1 -1
- package/dist/connect.d.mts +11 -11
- package/dist/connect.d.mts.map +1 -1
- package/dist/connect.mjs +2 -2
- package/dist/{eve-runtime-D1v4C0UP.d.mts → eve-runtime-BnWUzXdV.d.mts} +4 -4
- package/dist/{eve-runtime-D1v4C0UP.d.mts.map → eve-runtime-BnWUzXdV.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 +5 -5
- package/dist/eve-runtime.mjs +3 -3
- package/dist/eve.d.mts +55 -55
- package/dist/eve.d.mts.map +1 -1
- package/dist/eve.mjs +2 -2
- package/dist/{index-PqQNoVuw.d.mts → index-JH3DVh1R.d.mts} +115 -3
- package/dist/index-JH3DVh1R.d.mts.map +1 -0
- package/dist/index.d.mts +3 -3
- 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-B7uiRRTI.mjs → token-Iop2lapd.mjs} +55 -4
- package/dist/{token-B7uiRRTI.mjs.map → token-Iop2lapd.mjs.map} +1 -1
- package/dist/{tool-types-DbZpOYFG.d.mts → tool-types-BsfalcyC.d.mts} +878 -27
- package/dist/tool-types-BsfalcyC.d.mts.map +1 -0
- package/dist/{types-CCoH12WC.d.mts → types-BKXTeCqT.d.mts} +2 -2
- package/dist/{types-CCoH12WC.d.mts.map → types-BKXTeCqT.d.mts.map} +1 -1
- package/dist/{types-v39VrZ-m.d.mts → types-ve9shBaf.d.mts} +3 -3
- package/dist/{types-v39VrZ-m.d.mts.map → types-ve9shBaf.d.mts.map} +1 -1
- package/dist/workflow.d.mts +9 -9
- package/dist/workflow.d.mts.map +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 +14 -13
- package/dist/eve-runtime-BdolQrBF.mjs.map +0 -1
- package/dist/index-PqQNoVuw.d.mts.map +0 -1
- package/dist/tool-types-DbZpOYFG.d.mts.map +0 -1
- package/dist/write-tools-Ct0ZV87Z.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -198,6 +198,14 @@ result.rateLimit?.remaining
|
|
|
198
198
|
|
|
199
199
|
`resource` is `core`, `search`, or `graphql`. On HTTP 403/429 the thrown error message also includes remaining/reset.
|
|
200
200
|
|
|
201
|
+
## Errors
|
|
202
|
+
|
|
203
|
+
Classifiable failures become structured [evlog](https://evlog.dev) catalog errors with a stable `code`, a `why` (technical cause), and a `fix` (actionable remedy) — written so a model recovers instead of hallucinating. The two causes models get wrong most often are spelled out: GitHub answers 404 for private resources the token cannot see (`NOT_FOUND`), and an expired `VERCEL_OIDC_TOKEN` is caught before any request with the exact expiry time (`OIDC_TOKEN_EXPIRED`) instead of surfacing as an opaque Connect 403.
|
|
204
|
+
|
|
205
|
+
Codes: `TOKEN_REQUIRED`, `OIDC_TOKEN_EXPIRED`, `CONNECT_NOT_AUTHORIZED`, `CONNECT_USER_NOT_CONNECTED`, `CONNECT_INSTALLATION_REQUIRED`, `SUBJECT_CONTEXT_REQUIRED`, `UNAUTHORIZED` (401), `FORBIDDEN` (403), `RATE_LIMITED` (403/429), `NOT_FOUND` (404), `VALIDATION_FAILED` (422). Unmapped statuses pass through unchanged; the original Octokit error stays reachable as `cause`.
|
|
206
|
+
|
|
207
|
+
In the eve extension, a failing tool returns `{ error: { code, message, why, fix, link } }` to the model. With `generateText`/`streamText`, the framework forwards `error.message` (self-sufficient by design); use evlog's `parseError(error)` when you need the full structure. The catalog is exported as `githubToolsErrors`. See the [errors guide](https://github-tools.com/guide/errors).
|
|
208
|
+
|
|
201
209
|
## Commit Attribution
|
|
202
210
|
|
|
203
211
|
Control how commits are attributed when using `createOrUpdateFile` or `mergePullRequest`:
|
package/dist/connect/eve.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { a as GithubConnectorInput, t as ConnectGithubEveToolsOptions } from "../types-
|
|
1
|
+
import { a as GithubConnectorInput, t as ConnectGithubEveToolsOptions } from "../types-ve9shBaf.mjs";
|
|
2
2
|
//#region src/connect/eve.d.ts
|
|
3
3
|
/**
|
|
4
4
|
* Register eve GitHub tools backed by a Vercel Connect connector.
|
|
@@ -23,7 +23,6 @@ import { a as GithubConnectorInput, t as ConnectGithubEveToolsOptions } from "..
|
|
|
23
23
|
* `build.externalDependencies: ['@vercel/connect']` in `agent.ts`. Prefer the
|
|
24
24
|
* eve extension (pre-built) so that workaround is unnecessary.
|
|
25
25
|
*/
|
|
26
|
-
declare function connectGithubTools(connector: GithubConnectorInput, options?: ConnectGithubEveToolsOptions): import("eve/tools").DynamicSentinel<Partial<Record<"getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment", import("eve/tools").ToolDefinition<unknown, unknown>>>>;
|
|
26
|
+
export declare function connectGithubTools(connector: GithubConnectorInput, options?: ConnectGithubEveToolsOptions): import("eve/tools").DynamicSentinel<Partial<Record<"getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment", import("eve/tools").ToolDefinition<unknown, unknown>>>>;
|
|
27
27
|
//#endregion
|
|
28
|
-
export { connectGithubTools };
|
|
29
28
|
//# sourceMappingURL=eve.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eve.d.mts","names":[],"sources":["../../src/connect/eve.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"eve.d.mts","names":[],"sources":["../../src/connect/eve.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;wBA4BgB,mBACd,WAAW,sBACX,UAAS,mDAAiC,gBAAA,QAAA,qqDAAA"}
|
package/dist/connect/eve.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createGithubTools } from "../eve.mjs";
|
|
2
|
-
import { t as connectGithubToken } from "../token-
|
|
2
|
+
import { t as connectGithubToken } from "../token-Iop2lapd.mjs";
|
|
3
3
|
//#region src/connect/eve.ts
|
|
4
4
|
/**
|
|
5
5
|
* Register eve GitHub tools backed by a Vercel Connect connector.
|
package/dist/connect.d.mts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { a as
|
|
2
|
-
import { a as
|
|
3
|
-
import "./eve-runtime-
|
|
1
|
+
import { a as GithubTokenInput, d as GithubToolPreset, h as GithubToolName, t as AllGithubTools } from "./tool-types-BsfalcyC.mjs";
|
|
2
|
+
import { a as GithubConnectorInput, i as GithubConnectParams, n as ConnectGithubTokenOptions, o as resolveGithubConnector, r as ConnectGithubToolsOptions, t as ConnectGithubEveToolsOptions } from "./types-ve9shBaf.mjs";
|
|
3
|
+
import "./eve-runtime-BnWUzXdV.mjs";
|
|
4
4
|
import { ConnectTokenSubject } from "@vercel/connect";
|
|
5
5
|
//#region src/connect/scopes.d.ts
|
|
6
6
|
/**
|
|
@@ -24,7 +24,7 @@ import { ConnectTokenSubject } from "@vercel/connect";
|
|
|
24
24
|
* that only applies to user access tokens, so `listNotifications` /
|
|
25
25
|
* `markNotificationRead` need a PAT with the "Notifications" account permission.
|
|
26
26
|
*/
|
|
27
|
-
declare const PRESET_CONNECT_SCOPES: {
|
|
27
|
+
export declare const PRESET_CONNECT_SCOPES: {
|
|
28
28
|
readonly 'repo-explorer': readonly ["contents:read", "metadata:read", "pull_requests:read", "issues:read", "discussions:read", "actions:read", "checks:read", "statuses:read"];
|
|
29
29
|
readonly 'code-review': readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write", "checks:read", "statuses:read"];
|
|
30
30
|
readonly 'issue-triage': readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
|
|
@@ -41,17 +41,17 @@ declare const PRESET_CONNECT_SCOPES: {
|
|
|
41
41
|
* intentional for gist and notification tools (installation tokens cannot
|
|
42
42
|
* satisfy those APIs).
|
|
43
43
|
*/
|
|
44
|
-
declare const TOOL_CONNECT_SCOPES: Record<"getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment", readonly string[]>;
|
|
44
|
+
export declare const TOOL_CONNECT_SCOPES: Record<"getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment", readonly string[]>;
|
|
45
45
|
/**
|
|
46
46
|
* Returns Vercel Connect scopes for a preset or combined presets.
|
|
47
47
|
* Without a preset, returns the union of all preset scopes (full tool set).
|
|
48
48
|
*/
|
|
49
|
-
declare function connectGithubScopesForPreset(preset?: GithubToolPreset | GithubToolPreset[]): string[];
|
|
49
|
+
export declare function connectGithubScopesForPreset(preset?: GithubToolPreset | GithubToolPreset[]): string[];
|
|
50
50
|
/**
|
|
51
51
|
* Returns Connect scopes covering exactly the given tools.
|
|
52
52
|
* Always includes `metadata:read`. Gist and notification tools contribute nothing.
|
|
53
53
|
*/
|
|
54
|
-
declare function connectGithubScopesForTools(names: readonly GithubToolName[]): string[];
|
|
54
|
+
export declare function connectGithubScopesForTools(names: readonly GithubToolName[]): string[];
|
|
55
55
|
type ConnectScopeSelection = {
|
|
56
56
|
preset?: GithubToolPreset | GithubToolPreset[];
|
|
57
57
|
include?: readonly GithubToolName[];
|
|
@@ -65,7 +65,7 @@ type ConnectScopeSelection = {
|
|
|
65
65
|
* - With `include` and/or `exclude`: scopes are derived from the resolved tools
|
|
66
66
|
* so a hand-picked `include` list does not mint the full admin surface.
|
|
67
67
|
*/
|
|
68
|
-
declare function connectGithubScopesForSelection(selection?: ConnectScopeSelection): string[];
|
|
68
|
+
export declare function connectGithubScopesForSelection(selection?: ConnectScopeSelection): string[];
|
|
69
69
|
//#endregion
|
|
70
70
|
//#region src/connect/token.d.ts
|
|
71
71
|
/**
|
|
@@ -77,7 +77,7 @@ declare function connectGithubScopesForSelection(selection?: ConnectScopeSelecti
|
|
|
77
77
|
* different connector per environment (production vs. preview) or tenant.
|
|
78
78
|
* It's re-resolved on every call, alongside the token itself.
|
|
79
79
|
*/
|
|
80
|
-
declare function connectGithubToken(connector: GithubConnectorInput, options?: ConnectGithubTokenOptions): GithubTokenInput;
|
|
80
|
+
export declare function connectGithubToken(connector: GithubConnectorInput, options?: ConnectGithubTokenOptions): GithubTokenInput;
|
|
81
81
|
//#endregion
|
|
82
82
|
//#region src/connect/tools.d.ts
|
|
83
83
|
/**
|
|
@@ -87,7 +87,7 @@ declare function connectGithubToken(connector: GithubConnectorInput, options?: C
|
|
|
87
87
|
* `connector` may be a static name or a resolver function — e.g. to pick a
|
|
88
88
|
* different connector per environment (production vs. preview) or tenant.
|
|
89
89
|
*/
|
|
90
|
-
declare function connectGithubTools(connector: GithubConnectorInput, options?: ConnectGithubToolsOptions): AllGithubTools | Pick<AllGithubTools, "getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment">;
|
|
90
|
+
export declare function connectGithubTools(connector: GithubConnectorInput, options?: ConnectGithubToolsOptions): AllGithubTools | Pick<AllGithubTools, "getPullRequest" | "listPullRequests" | "listPullRequestFiles" | "listPullRequestReviews" | "listPullRequestReviewThreads" | "getPullRequestContext" | "getFileContent" | "listCommits" | "getCommit" | "getBlame" | "compareCommits" | "getRepository" | "listBranches" | "searchCode" | "listCheckRuns" | "getCombinedStatus" | "updatePullRequest" | "addPullRequestComment" | "updatePullRequestComment" | "deletePullRequestComment" | "createPullRequestReview" | "replyToReviewComment" | "resolveReviewThread" | "requestReviewers" | "listIssues" | "getIssueContext" | "listIssueComments" | "createIssue" | "addIssueComment" | "updateIssueComment" | "deleteIssueComment" | "closeIssue" | "updateIssue" | "addLabels" | "removeLabel" | "createLabel" | "updateLabel" | "deleteLabel" | "addAssignees" | "removeAssignees" | "listIssueReactions" | "addIssueReaction" | "listCommentReactions" | "addCommentReaction" | "searchRepositories" | "searchIssues" | "listWorkflows" | "listWorkflowRuns" | "getWorkflowRun" | "listWorkflowJobs" | "getWorkflowJobLogs" | "getCiFailureContext" | "triggerWorkflow" | "cancelWorkflowRun" | "rerunWorkflowRun" | "getRepositoryTree" | "getIssue" | "listDiscussions" | "getDiscussion" | "listLabels" | "listGists" | "getGist" | "listGistComments" | "listReleases" | "getLatestRelease" | "getRelease" | "getReleaseContext" | "createRelease" | "updateRelease" | "deleteRelease" | "addDiscussionComment" | "listNotifications" | "markNotificationRead" | "createBranch" | "deleteBranch" | "createOrUpdateFile" | "createPullRequest" | "forkRepository" | "createRepository" | "mergePullRequest" | "createGist" | "updateGist" | "deleteGist" | "createGistComment">;
|
|
91
91
|
//#endregion
|
|
92
|
-
export { type ConnectGithubEveToolsOptions, type ConnectGithubTokenOptions, type ConnectGithubToolsOptions, type ConnectScopeSelection, type ConnectTokenSubject, type GithubConnectParams, type GithubConnectorInput,
|
|
92
|
+
export { type ConnectGithubEveToolsOptions, type ConnectGithubTokenOptions, type ConnectGithubToolsOptions, type ConnectScopeSelection, type ConnectTokenSubject, type GithubConnectParams, type GithubConnectorInput, resolveGithubConnector };
|
|
93
93
|
//# sourceMappingURL=connect.d.mts.map
|
package/dist/connect.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"connect.d.mts","names":[],"sources":["../src/connect/scopes.ts","../src/connect/token.ts","../src/connect/tools.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"connect.d.mts","names":[],"sources":["../src/connect/scopes.ts","../src/connect/token.ts","../src/connect/tools.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBa;;;;;;;;;;;;;;;;;qBAwHA,qBAAmB;;;;;wBAgBhB,6BACd,SAAS,mBAAmB;;;;;wBAcd,4BAA4B,gBAAgB;KAUhD;EACV,SAAS,mBAAmB;EAC5B,mBAAmB;EACnB,mBAAmB;;;;;;;;;;wBA6BL,gCAAgC,YAAW;;;;;;;;;;;;wBCnM3C,mBACd,WAAW,sBACX,UAAS,4BACR;;;;;;;;;;wBCda,mBACd,WAAW,sBACX,UAAS,4BAAA,iBAA8B,KAAA"}
|
package/dist/connect.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as createGithubTools } from "./src-
|
|
2
|
-
import { a as connectGithubScopesForSelection, i as connectGithubScopesForPreset, n as PRESET_CONNECT_SCOPES, o as connectGithubScopesForTools, r as TOOL_CONNECT_SCOPES, s as resolveGithubConnector, t as connectGithubToken } from "./token-
|
|
1
|
+
import { t as createGithubTools } from "./src-C54blWpT.mjs";
|
|
2
|
+
import { a as connectGithubScopesForSelection, i as connectGithubScopesForPreset, n as PRESET_CONNECT_SCOPES, o as connectGithubScopesForTools, r as TOOL_CONNECT_SCOPES, s as resolveGithubConnector, t as connectGithubToken } from "./token-Iop2lapd.mjs";
|
|
3
3
|
//#region src/connect/tools.ts
|
|
4
4
|
/**
|
|
5
5
|
* Create GitHub tools backed by a Vercel Connect connector.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { d as GithubToolPreset, g as GithubWriteToolName, h as GithubToolName, p as PresetToolName, u as CombinedPresetToolNames } from "./tool-types-
|
|
2
|
-
import { i as EveToolFactoryOptions, n as EveApprovalValue, r as EveGithubToolsOptions, t as EveApprovalConfig } from "./types-
|
|
3
|
-
import "./index-
|
|
1
|
+
import { d as GithubToolPreset, g as GithubWriteToolName, h as GithubToolName, p as PresetToolName, u as CombinedPresetToolNames } from "./tool-types-BsfalcyC.mjs";
|
|
2
|
+
import { i as EveToolFactoryOptions, n as EveApprovalValue, r as EveGithubToolsOptions, t as EveApprovalConfig } from "./types-BKXTeCqT.mjs";
|
|
3
|
+
import "./index-JH3DVh1R.mjs";
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { ToolDefinition, ToolModelOutput } from "eve/tools";
|
|
6
6
|
import { Approval, ApprovalPolicy } from "eve/tools/approval";
|
|
@@ -82,4 +82,4 @@ declare function resolveEveToolApproval(toolName: GithubWriteToolName, config: E
|
|
|
82
82
|
declare const MISSING_EVE_MESSAGE = "The \"eve\" package is required to use @github-tools/sdk/eve. Install it with: pnpm add eve";
|
|
83
83
|
//#endregion
|
|
84
84
|
export { resolveEveToolApproval as a, createEveGithubToolsDynamic as c, listResolvedEveToolNames as d, formatGithubEveToolOutput as f, resolveEveApproval as i, executeGithubEveTool as l, isEveApprovalDisabled as n, buildEveToolDefinition as o, hasGithubEveToolModelOutput as p, mapEveApprovalValue as r, buildEveToolMap as s, MISSING_EVE_MESSAGE as t, listEveToolDescriptors as u };
|
|
85
|
-
//# sourceMappingURL=eve-runtime-
|
|
85
|
+
//# sourceMappingURL=eve-runtime-BnWUzXdV.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eve-runtime-
|
|
1
|
+
{"version":3,"file":"eve-runtime-BnWUzXdV.d.mts","names":[],"sources":["../src/eve/registry.ts","../src/eve/build.ts","../src/eve/approval.ts","../src/eve/load-eve.ts"],"mappings":";;;;;;;;iBAoEgB,4BAA4B,MAAM;;;;;;;iBAUlC,0BAA0B,MAAM,gBAAgB,kBAAkB;;;KCrE7E,eAAe,yBAAyB;EAA0B,SAAS;;KAC3E,aAAa,QAAQ,OAAO,gBAAgB;iBA8CjC,uBACd,MAAM,gBACN,UAAS,eACR;iBAgCa,gBAAgB,UAAS,wBAA6B;iBAmCtD,4BAA4B,UAAS,4CAA0B,gBAAA,QAAA,ipDAAA;iBAY/D,yBAAyB;EAAY;EAAoB;EAAqB;IAAwB;iBACtG,yBAAyB,UAAU,kBAAkB;EAAW,QAAQ;EAAG;EAAqB;IAAwB,eAAe;iBACvI,yBAAyB,mBAAmB,oBAAoB;EAAW,QAAQ;EAAG;EAAqB;IAAwB,wBAAwB;iBAC3J,yBAAyB,SAAS,KAAK,2DAA2D;;;;;iBAUlG,uBAAuB,UAAS;;;;aAAA;;;;;;;iBA2B1B,qBACpB,MAAM,gBACN,OAAO,yBACP,UAAS,wBAA0B;;;;;;;;iBC3KrB,sBAAsB,OAAO;iBAI7B,oBAAoB,OAAO,mBAAmB;iBAY9C,mBACd,UAAU,qBACV,QAAQ,gCACP;;;;;;iBAgBa,uBACd,UAAU,qBACV,QAAQ,+BACR,WAAW,mBACV;;;;;;;;;cChCU"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Ci as compareCommitsToModelOutput, Di as getRepositoryTreeToModelOutput, Ei as getPullRequestContextToModelOutput, Oi as listPullRequestFilesToModelOutput, Si as resolveGithubToken, Ti as getFileContentToModelOutput, a as isGithubWriteToolName, d as softenContextSchema, i as GITHUB_TOOL_CATALOG, r as ALL_GITHUB_TOOL_NAMES, ra as
|
|
1
|
+
import { Ci as compareCommitsToModelOutput, Di as getRepositoryTreeToModelOutput, Ei as getPullRequestContextToModelOutput, Oi as listPullRequestFilesToModelOutput, Si as resolveGithubToken, Ti as getFileContentToModelOutput, a as isGithubWriteToolName, aa as toModelErrorPayload, d as softenContextSchema, i as GITHUB_TOOL_CATALOG, oa as stripRateLimit, r as ALL_GITHUB_TOOL_NAMES, ra as EvlogError, s as resolvePresetTools, u as mergeContextArgs, wi as getCommitToModelOutput, xi as createGithubTokenResolver } from "./write-tools-BvuWAzwo.mjs";
|
|
2
2
|
import * as eveTools from "eve/tools";
|
|
3
3
|
import * as eveApproval from "eve/tools/approval";
|
|
4
4
|
//#region src/eve/load-eve.ts
|
|
@@ -148,6 +148,7 @@ async function runGithubToolStep(name, input, ctx) {
|
|
|
148
148
|
token
|
|
149
149
|
});
|
|
150
150
|
} catch (error) {
|
|
151
|
+
if (EvlogError.isEvlogError(error)) return { error: toModelErrorPayload(error) };
|
|
151
152
|
return { error: error instanceof Error ? error.message : String(error) };
|
|
152
153
|
}
|
|
153
154
|
}
|
|
@@ -272,4 +273,4 @@ async function executeGithubEveTool(name, input, options = {}) {
|
|
|
272
273
|
//#endregion
|
|
273
274
|
export { listEveToolDescriptors as a, hasGithubEveToolModelOutput as c, resolveEveApproval as d, resolveEveToolApproval as f, executeGithubEveTool as i, isEveApprovalDisabled as l, buildEveToolMap as n, listResolvedEveToolNames as o, MISSING_EVE_MESSAGE as p, createEveGithubToolsDynamic as r, formatGithubEveToolOutput as s, buildEveToolDefinition as t, mapEveApprovalValue as u };
|
|
274
275
|
|
|
275
|
-
//# sourceMappingURL=eve-runtime-
|
|
276
|
+
//# sourceMappingURL=eve-runtime-Cfyy1tzp.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eve-runtime-Cfyy1tzp.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 { EvlogError, toModelErrorPayload } from '../core/errors'\nimport { 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 // Catalog errors keep their { code, why, fix, link } structure so the model can recover.\n if (EvlogError.isEvlogError(error)) {\n return { error: toModelErrorPayload(error) }\n }\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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"}
|
package/dist/eve-runtime.d.mts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { _ as CommitIdentity, d as GithubToolPreset, f as PRESET_TOOLS, g as GithubWriteToolName, h as GithubToolName, i as PickGithubTools, l as GITHUB_WRITE_TOOLS, m as GITHUB_TOOL_NAMES, o as resolveGithubToken, p as PresetToolName, r as GithubToolsForPreset, t as AllGithubTools, u as CombinedPresetToolNames } from "./tool-types-
|
|
2
|
-
import { a as EveToolOverrides, i as EveToolFactoryOptions, n as EveApprovalValue, r as EveGithubToolsOptions, t as EveApprovalConfig } from "./types-
|
|
3
|
-
import { o as GithubRateLimit } from "./index-
|
|
4
|
-
import { a as resolveEveToolApproval, c as createEveGithubToolsDynamic, d as listResolvedEveToolNames, f as formatGithubEveToolOutput, i as resolveEveApproval, l as executeGithubEveTool, n as isEveApprovalDisabled, o as buildEveToolDefinition, p as hasGithubEveToolModelOutput, r as mapEveApprovalValue, s as buildEveToolMap, t as MISSING_EVE_MESSAGE, u as listEveToolDescriptors } from "./eve-runtime-
|
|
5
|
-
export { type AllGithubTools, type CombinedPresetToolNames, type CommitIdentity, type EveApprovalConfig, type EveApprovalValue, type EveGithubToolsOptions, type EveToolFactoryOptions, type EveToolOverrides, GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, type GithubRateLimit, type GithubToolName, type GithubToolPreset, type GithubToolsForPreset, type GithubWriteToolName, MISSING_EVE_MESSAGE, PRESET_TOOLS, type PickGithubTools, type PresetToolName, buildEveToolDefinition, buildEveToolMap, createEveGithubToolsDynamic, executeGithubEveTool, formatGithubEveToolOutput, hasGithubEveToolModelOutput, isEveApprovalDisabled, listEveToolDescriptors, listResolvedEveToolNames, mapEveApprovalValue, resolveEveApproval, resolveEveToolApproval, resolveGithubToken };
|
|
1
|
+
import { _ as CommitIdentity, d as GithubToolPreset, f as PRESET_TOOLS, g as GithubWriteToolName, h as GithubToolName, i as PickGithubTools, l as GITHUB_WRITE_TOOLS, m as GITHUB_TOOL_NAMES, o as resolveGithubToken, p as PresetToolName, r as GithubToolsForPreset, t as AllGithubTools, u as CombinedPresetToolNames } from "./tool-types-BsfalcyC.mjs";
|
|
2
|
+
import { a as EveToolOverrides, i as EveToolFactoryOptions, n as EveApprovalValue, r as EveGithubToolsOptions, t as EveApprovalConfig } from "./types-BKXTeCqT.mjs";
|
|
3
|
+
import { o as githubToolsErrors, s as GithubRateLimit } from "./index-JH3DVh1R.mjs";
|
|
4
|
+
import { a as resolveEveToolApproval, c as createEveGithubToolsDynamic, d as listResolvedEveToolNames, f as formatGithubEveToolOutput, i as resolveEveApproval, l as executeGithubEveTool, n as isEveApprovalDisabled, o as buildEveToolDefinition, p as hasGithubEveToolModelOutput, r as mapEveApprovalValue, s as buildEveToolMap, t as MISSING_EVE_MESSAGE, u as listEveToolDescriptors } from "./eve-runtime-BnWUzXdV.mjs";
|
|
5
|
+
export { type AllGithubTools, type CombinedPresetToolNames, type CommitIdentity, type EveApprovalConfig, type EveApprovalValue, type EveGithubToolsOptions, type EveToolFactoryOptions, type EveToolOverrides, GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, type GithubRateLimit, type GithubToolName, type GithubToolPreset, type GithubToolsForPreset, type GithubWriteToolName, MISSING_EVE_MESSAGE, PRESET_TOOLS, type PickGithubTools, type PresetToolName, buildEveToolDefinition, buildEveToolMap, createEveGithubToolsDynamic, executeGithubEveTool, formatGithubEveToolOutput, githubToolsErrors, hasGithubEveToolModelOutput, isEveApprovalDisabled, listEveToolDescriptors, listResolvedEveToolNames, mapEveApprovalValue, resolveEveApproval, resolveEveToolApproval, resolveGithubToken };
|
package/dist/eve-runtime.mjs
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { Si as resolveGithubToken, n as GITHUB_TOOL_NAMES, o as PRESET_TOOLS, t as GITHUB_WRITE_TOOLS } from "./write-tools-
|
|
2
|
-
import { a as listEveToolDescriptors, c as hasGithubEveToolModelOutput, d as resolveEveApproval, f as resolveEveToolApproval, i as executeGithubEveTool, l as isEveApprovalDisabled, n as buildEveToolMap, o as listResolvedEveToolNames, p as MISSING_EVE_MESSAGE, r as createEveGithubToolsDynamic, s as formatGithubEveToolOutput, t as buildEveToolDefinition, u as mapEveApprovalValue } from "./eve-runtime-
|
|
3
|
-
export { GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, MISSING_EVE_MESSAGE, PRESET_TOOLS, buildEveToolDefinition, buildEveToolMap, createEveGithubToolsDynamic, executeGithubEveTool, formatGithubEveToolOutput, hasGithubEveToolModelOutput, isEveApprovalDisabled, listEveToolDescriptors, listResolvedEveToolNames, mapEveApprovalValue, resolveEveApproval, resolveEveToolApproval, resolveGithubToken };
|
|
1
|
+
import { Si as resolveGithubToken, ia as githubToolsErrors, n as GITHUB_TOOL_NAMES, o as PRESET_TOOLS, t as GITHUB_WRITE_TOOLS } from "./write-tools-BvuWAzwo.mjs";
|
|
2
|
+
import { a as listEveToolDescriptors, c as hasGithubEveToolModelOutput, d as resolveEveApproval, f as resolveEveToolApproval, i as executeGithubEveTool, l as isEveApprovalDisabled, n as buildEveToolMap, o as listResolvedEveToolNames, p as MISSING_EVE_MESSAGE, r as createEveGithubToolsDynamic, s as formatGithubEveToolOutput, t as buildEveToolDefinition, u as mapEveApprovalValue } from "./eve-runtime-Cfyy1tzp.mjs";
|
|
3
|
+
export { GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, MISSING_EVE_MESSAGE, PRESET_TOOLS, buildEveToolDefinition, buildEveToolMap, createEveGithubToolsDynamic, executeGithubEveTool, formatGithubEveToolOutput, githubToolsErrors, hasGithubEveToolModelOutput, isEveApprovalDisabled, listEveToolDescriptors, listResolvedEveToolNames, mapEveApprovalValue, resolveEveApproval, resolveEveToolApproval, resolveGithubToken };
|