@kana-ai/edgar-ext-github 0.0.0-stage → 0.1.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.
Files changed (136) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +469 -2
  3. package/agents/dismiss/agent.toml +4 -0
  4. package/agents/dismiss/instructions.md +25 -0
  5. package/dist/src/api/app.d.ts +16 -0
  6. package/dist/src/api/app.js +32 -0
  7. package/dist/src/api/client.d.ts +26 -0
  8. package/dist/src/api/client.js +103 -0
  9. package/dist/src/api/failures.d.ts +8 -0
  10. package/dist/src/api/failures.js +31 -0
  11. package/dist/src/feed/alerts.d.ts +26 -0
  12. package/dist/src/feed/alerts.js +117 -0
  13. package/dist/src/feed/cards.d.ts +32 -0
  14. package/dist/src/feed/cards.js +164 -0
  15. package/dist/src/feed/service.d.ts +28 -0
  16. package/dist/src/feed/service.js +163 -0
  17. package/dist/src/index.d.ts +490 -0
  18. package/dist/src/index.js +62 -0
  19. package/dist/src/schemas/config.d.ts +57 -0
  20. package/dist/src/schemas/config.js +89 -0
  21. package/dist/src/schemas/github.d.ts +417 -0
  22. package/dist/src/schemas/github.js +216 -0
  23. package/dist/src/schemas/tools.d.ts +620 -0
  24. package/dist/src/schemas/tools.js +501 -0
  25. package/dist/src/tools/alerts.d.ts +45 -0
  26. package/dist/src/tools/alerts.js +100 -0
  27. package/dist/src/tools/branch.d.ts +9 -0
  28. package/dist/src/tools/branch.js +48 -0
  29. package/dist/src/tools/checks.d.ts +118 -0
  30. package/dist/src/tools/checks.js +223 -0
  31. package/dist/src/tools/discussion.d.ts +41 -0
  32. package/dist/src/tools/discussion.js +66 -0
  33. package/dist/src/tools/pull-request.d.ts +195 -0
  34. package/dist/src/tools/pull-request.js +537 -0
  35. package/dist/src/tools/repository.d.ts +53 -0
  36. package/dist/src/tools/repository.js +134 -0
  37. package/dist/src/tools/screenshot.d.ts +21 -0
  38. package/dist/src/tools/screenshot.js +99 -0
  39. package/dist/src/tracker/assignee.d.ts +15 -0
  40. package/dist/src/tracker/assignee.js +65 -0
  41. package/dist/src/tracker/cards.d.ts +41 -0
  42. package/dist/src/tracker/cards.js +361 -0
  43. package/dist/src/tracker/comments.d.ts +9 -0
  44. package/dist/src/tracker/comments.js +68 -0
  45. package/dist/src/tracker/description.d.ts +19 -0
  46. package/dist/src/tracker/description.js +55 -0
  47. package/dist/src/tracker/hand-back.d.ts +8 -0
  48. package/dist/src/tracker/hand-back.js +60 -0
  49. package/dist/src/tracker/port.d.ts +2 -0
  50. package/dist/src/tracker/port.js +42 -0
  51. package/dist/src/tracker/states.d.ts +77 -0
  52. package/dist/src/tracker/states.js +189 -0
  53. package/dist/src/tracker/tools.d.ts +143 -0
  54. package/dist/src/tracker/tools.js +131 -0
  55. package/dist/src/tracker/transitions.d.ts +12 -0
  56. package/dist/src/tracker/transitions.js +101 -0
  57. package/edgar-extension.json +507 -0
  58. package/package.json +43 -3
  59. package/schemas/assign.in.json +15 -0
  60. package/schemas/assign.out.json +14 -0
  61. package/schemas/attach_screenshot.in.json +44 -0
  62. package/schemas/attach_screenshot.out.json +31 -0
  63. package/schemas/batch_cards.in.json +27 -0
  64. package/schemas/batch_cards.out.json +37 -0
  65. package/schemas/branch_protection.in.json +15 -0
  66. package/schemas/branch_protection.out.json +67 -0
  67. package/schemas/ci_run.in.json +12 -0
  68. package/schemas/ci_run.out.json +109 -0
  69. package/schemas/close.in.json +14 -0
  70. package/schemas/close.out.json +10 -0
  71. package/schemas/close_pull_request.in.json +21 -0
  72. package/schemas/close_pull_request.out.json +14 -0
  73. package/schemas/comment.in.json +19 -0
  74. package/schemas/comment.out.json +10 -0
  75. package/schemas/config.json +202 -0
  76. package/schemas/count_sighting.in.json +17 -0
  77. package/schemas/count_sighting.out.json +10 -0
  78. package/schemas/create_card.in.json +108 -0
  79. package/schemas/create_card.out.json +13 -0
  80. package/schemas/dependabot_alerts.in.json +49 -0
  81. package/schemas/dependabot_alerts.out.json +75 -0
  82. package/schemas/dismiss_dependabot_alert.in.json +26 -0
  83. package/schemas/dismiss_dependabot_alert.out.json +27 -0
  84. package/schemas/find_assignee.in.json +15 -0
  85. package/schemas/find_assignee.out.json +10 -0
  86. package/schemas/find_cards.in.json +18 -0
  87. package/schemas/find_cards.out.json +33 -0
  88. package/schemas/find_dependabot_dismissal.in.json +12 -0
  89. package/schemas/find_dependabot_dismissal.out.json +27 -0
  90. package/schemas/find_description.in.json +15 -0
  91. package/schemas/find_description.out.json +10 -0
  92. package/schemas/find_pull_request.in.json +25 -0
  93. package/schemas/find_pull_request.out.json +14 -0
  94. package/schemas/hand_back.in.json +11 -0
  95. package/schemas/hand_back.out.json +18 -0
  96. package/schemas/linked_pull_requests.in.json +15 -0
  97. package/schemas/linked_pull_requests.out.json +44 -0
  98. package/schemas/list_pull_requests.in.json +26 -0
  99. package/schemas/list_pull_requests.out.json +42 -0
  100. package/schemas/merge_pull_request.in.json +22 -0
  101. package/schemas/merge_pull_request.out.json +16 -0
  102. package/schemas/move.in.json +15 -0
  103. package/schemas/move.out.json +10 -0
  104. package/schemas/note_pull_request.in.json +15 -0
  105. package/schemas/note_pull_request.out.json +10 -0
  106. package/schemas/open_pull_request.in.json +113 -0
  107. package/schemas/open_pull_request.out.json +15 -0
  108. package/schemas/pull_request_checks.in.json +11 -0
  109. package/schemas/pull_request_checks.out.json +72 -0
  110. package/schemas/pull_request_discussion.in.json +11 -0
  111. package/schemas/pull_request_discussion.out.json +107 -0
  112. package/schemas/pull_request_state.in.json +11 -0
  113. package/schemas/pull_request_state.out.json +52 -0
  114. package/schemas/push_branch.in.json +21 -0
  115. package/schemas/push_branch.out.json +13 -0
  116. package/schemas/release_follow_ups.in.json +15 -0
  117. package/schemas/release_follow_ups.out.json +13 -0
  118. package/schemas/reopen_dependabot_alert.in.json +33 -0
  119. package/schemas/reopen_dependabot_alert.out.json +22 -0
  120. package/schemas/restore_assignee.in.json +20 -0
  121. package/schemas/restore_assignee.out.json +10 -0
  122. package/schemas/restore_description.in.json +20 -0
  123. package/schemas/restore_description.out.json +10 -0
  124. package/schemas/update_description.in.json +15 -0
  125. package/schemas/update_description.out.json +14 -0
  126. package/schemas/update_pull_request.in.json +81 -0
  127. package/schemas/update_pull_request.out.json +10 -0
  128. package/schemas/wait_for_checks.in.json +11 -0
  129. package/schemas/wait_for_checks.out.json +72 -0
  130. package/schemas/wait_for_merge.in.json +11 -0
  131. package/schemas/wait_for_merge.out.json +17 -0
  132. package/schemas/wait_for_passed_checks.in.json +11 -0
  133. package/schemas/wait_for_passed_checks.out.json +72 -0
  134. package/schemas/wait_for_review.in.json +11 -0
  135. package/schemas/wait_for_review.out.json +52 -0
  136. package/workflows/resume.toml +17 -0
@@ -0,0 +1,507 @@
1
+ {
2
+ "contract": 1,
3
+ "name": "github",
4
+ "version": "0.1.1",
5
+ "config_schema": "schemas/config.json",
6
+ "secrets": [
7
+ {
8
+ "name": "GITHUB_TOKEN",
9
+ "hosts": ["api.github.com", "*.blob.core.windows.net", "*.actions.githubusercontent.com"],
10
+ "help": "Make a fine-grained token with Contents, Issues and Pull requests set to Read and write on the repositories EDGAR works on. With [extensions.github] app, set the App's private key (the PEM file) instead. The extension's README lists the permission of each tool."
11
+ },
12
+ {
13
+ "name": "GITHUB_WEBHOOK_SECRET",
14
+ "hosts": []
15
+ }
16
+ ],
17
+ "capabilities": [
18
+ "network:api.github.com",
19
+ "network:*.blob.core.windows.net",
20
+ "network:*.actions.githubusercontent.com",
21
+ "git:push",
22
+ "sandbox:read"
23
+ ],
24
+ "tools": [
25
+ {
26
+ "name": "push_branch",
27
+ "description": "Push to origin through the sandbox, never forced: with `to`, the head of the sandbox to that edgar/ branch; with `branch` alone, that edgar/ branch under its own name",
28
+ "input_schema": "schemas/push_branch.in.json",
29
+ "output_schema": "schemas/push_branch.out.json",
30
+ "secrets": [],
31
+ "capabilities": ["git:push", "sandbox:read"],
32
+ "side_effect": false,
33
+ "approval": "never",
34
+ "disabled": false
35
+ },
36
+ {
37
+ "name": "open_pull_request",
38
+ "description": "Open a pull request from a pushed edgar/ branch onto the default base",
39
+ "input_schema": "schemas/open_pull_request.in.json",
40
+ "output_schema": "schemas/open_pull_request.out.json",
41
+ "secrets": ["GITHUB_TOKEN"],
42
+ "capabilities": ["network:api.github.com"],
43
+ "side_effect": true,
44
+ "compensate": "close_pull_request",
45
+ "lookup": "find_pull_request",
46
+ "approval": "never",
47
+ "disabled": false
48
+ },
49
+ {
50
+ "name": "update_pull_request",
51
+ "description": "Give an open pull request a new title and body when a later change made them untrue; skipped when it is merged or closed",
52
+ "input_schema": "schemas/update_pull_request.in.json",
53
+ "output_schema": "schemas/update_pull_request.out.json",
54
+ "secrets": ["GITHUB_TOKEN"],
55
+ "capabilities": ["network:api.github.com"],
56
+ "side_effect": true,
57
+ "undo": "none",
58
+ "undo_reason": "The new title and body describe what the pull request holds, and they stay true when a later stage is undone.",
59
+ "approval": "never",
60
+ "disabled": false
61
+ },
62
+ {
63
+ "name": "attach_screenshot",
64
+ "description": "Put a screenshot from the sandbox into a pull request's body, stored on the edgar/screenshots branch, or say in the body why it is missing",
65
+ "input_schema": "schemas/attach_screenshot.in.json",
66
+ "output_schema": "schemas/attach_screenshot.out.json",
67
+ "secrets": ["GITHUB_TOKEN"],
68
+ "capabilities": ["network:api.github.com", "sandbox:read"],
69
+ "side_effect": true,
70
+ "undo": "none",
71
+ "undo_reason": "The picture shows the change that the pull request holds, and it stays true when a later stage is undone.",
72
+ "approval": "never",
73
+ "disabled": false
74
+ },
75
+ {
76
+ "name": "close_pull_request",
77
+ "description": "Close a pull request without merging it; skipped when it is merged or closed",
78
+ "input_schema": "schemas/close_pull_request.in.json",
79
+ "output_schema": "schemas/close_pull_request.out.json",
80
+ "secrets": ["GITHUB_TOKEN"],
81
+ "capabilities": ["network:api.github.com"],
82
+ "side_effect": false,
83
+ "approval": "never",
84
+ "disabled": false
85
+ },
86
+ {
87
+ "name": "note_pull_request",
88
+ "description": "Add a line to EDGAR's one note on a pull request: what failed there, what EDGAR does about it, what it changed",
89
+ "input_schema": "schemas/note_pull_request.in.json",
90
+ "output_schema": "schemas/note_pull_request.out.json",
91
+ "secrets": ["GITHUB_TOKEN"],
92
+ "capabilities": ["network:api.github.com"],
93
+ "side_effect": true,
94
+ "undo": "none",
95
+ "undo_reason": "A line of the note says what happened on the pull request, and it stays true when a later stage is undone.",
96
+ "approval": "never",
97
+ "disabled": false
98
+ },
99
+ {
100
+ "name": "linked_pull_requests",
101
+ "description": "Read the pull requests of the repository that a text links, with the state, description and diff of each; skipped when it links none",
102
+ "input_schema": "schemas/linked_pull_requests.in.json",
103
+ "output_schema": "schemas/linked_pull_requests.out.json",
104
+ "secrets": ["GITHUB_TOKEN"],
105
+ "capabilities": ["network:api.github.com"],
106
+ "side_effect": false,
107
+ "approval": "never",
108
+ "disabled": false
109
+ },
110
+ {
111
+ "name": "find_pull_request",
112
+ "description": "Find the pull request of a branch; skipped when there is none",
113
+ "input_schema": "schemas/find_pull_request.in.json",
114
+ "output_schema": "schemas/find_pull_request.out.json",
115
+ "secrets": ["GITHUB_TOKEN"],
116
+ "capabilities": ["network:api.github.com"],
117
+ "side_effect": false,
118
+ "approval": "never",
119
+ "disabled": false
120
+ },
121
+ {
122
+ "name": "list_pull_requests",
123
+ "description": "List the open pull requests on edgar/ branches of each service's repository on github.com, or with merged_within_hours the ones merged within that many hours; a service elsewhere has none here",
124
+ "input_schema": "schemas/list_pull_requests.in.json",
125
+ "output_schema": "schemas/list_pull_requests.out.json",
126
+ "secrets": ["GITHUB_TOKEN"],
127
+ "capabilities": ["network:api.github.com"],
128
+ "side_effect": false,
129
+ "approval": "never",
130
+ "disabled": false
131
+ },
132
+ {
133
+ "name": "pull_request_state",
134
+ "description": "Read a pull request's state, its review state, who approved it, its card, its commit, and its head branch and repository",
135
+ "input_schema": "schemas/pull_request_state.in.json",
136
+ "output_schema": "schemas/pull_request_state.out.json",
137
+ "secrets": ["GITHUB_TOKEN"],
138
+ "capabilities": ["network:api.github.com"],
139
+ "side_effect": false,
140
+ "approval": "never",
141
+ "disabled": false
142
+ },
143
+ {
144
+ "name": "wait_for_review",
145
+ "description": "As pull_request_state, for a wait stage's recheck: skipped while the pull request is open and no review has decided, done once it is approved, has a change request, or is merged or closed",
146
+ "input_schema": "schemas/wait_for_review.in.json",
147
+ "output_schema": "schemas/wait_for_review.out.json",
148
+ "secrets": ["GITHUB_TOKEN"],
149
+ "capabilities": ["network:api.github.com"],
150
+ "side_effect": false,
151
+ "approval": "never",
152
+ "disabled": false
153
+ },
154
+ {
155
+ "name": "wait_for_merge",
156
+ "description": "For a wait stage's recheck: skipped while the pull request is open, done with the merge commit once it is merged, and done with merged false once it is closed without a merge",
157
+ "input_schema": "schemas/wait_for_merge.in.json",
158
+ "output_schema": "schemas/wait_for_merge.out.json",
159
+ "secrets": ["GITHUB_TOKEN"],
160
+ "capabilities": ["network:api.github.com"],
161
+ "side_effect": false,
162
+ "approval": "never",
163
+ "disabled": false
164
+ },
165
+ {
166
+ "name": "merge_pull_request",
167
+ "description": "Merge a pull request; every call needs a person's approval",
168
+ "input_schema": "schemas/merge_pull_request.in.json",
169
+ "output_schema": "schemas/merge_pull_request.out.json",
170
+ "secrets": ["GITHUB_TOKEN"],
171
+ "capabilities": ["network:api.github.com"],
172
+ "side_effect": true,
173
+ "undo": "none",
174
+ "undo_reason": "a merged pull request cannot be unmerged; a revert is a new change",
175
+ "approval": "always",
176
+ "disabled": true
177
+ },
178
+ {
179
+ "name": "pull_request_checks",
180
+ "description": "Read the check runs and commit statuses of a pull request's head commit: pending, passed or failed, or closed when the pull request is closed or merged, with each failed check's name and details URL, and the files the pull request changes",
181
+ "input_schema": "schemas/pull_request_checks.in.json",
182
+ "output_schema": "schemas/pull_request_checks.out.json",
183
+ "secrets": ["GITHUB_TOKEN"],
184
+ "capabilities": ["network:api.github.com"],
185
+ "side_effect": false,
186
+ "approval": "never",
187
+ "disabled": false
188
+ },
189
+ {
190
+ "name": "wait_for_checks",
191
+ "description": "As pull_request_checks, for a wait stage's recheck: skipped while a check runs or while a pull request updated in the last 2 minutes has no check yet, done once every check has ended or the pull request is closed or merged",
192
+ "input_schema": "schemas/wait_for_checks.in.json",
193
+ "output_schema": "schemas/wait_for_checks.out.json",
194
+ "secrets": ["GITHUB_TOKEN"],
195
+ "capabilities": ["network:api.github.com"],
196
+ "side_effect": false,
197
+ "approval": "never",
198
+ "disabled": false
199
+ },
200
+ {
201
+ "name": "wait_for_passed_checks",
202
+ "description": "As wait_for_checks, for a wait that ends only when the checks pass: skipped also while a check has failed, done once every check has passed or the pull request is closed or merged",
203
+ "input_schema": "schemas/wait_for_passed_checks.in.json",
204
+ "output_schema": "schemas/wait_for_passed_checks.out.json",
205
+ "secrets": ["GITHUB_TOKEN"],
206
+ "capabilities": ["network:api.github.com"],
207
+ "side_effect": false,
208
+ "approval": "never",
209
+ "disabled": false
210
+ },
211
+ {
212
+ "name": "ci_run",
213
+ "description": "Read a GitHub Actions run: its workflow, commit and conclusion, each job with its failed steps, and the error lines and a bounded excerpt of each failed job's log",
214
+ "input_schema": "schemas/ci_run.in.json",
215
+ "output_schema": "schemas/ci_run.out.json",
216
+ "secrets": ["GITHUB_TOKEN"],
217
+ "capabilities": [
218
+ "network:api.github.com",
219
+ "network:*.blob.core.windows.net",
220
+ "network:*.actions.githubusercontent.com"
221
+ ],
222
+ "side_effect": false,
223
+ "approval": "never",
224
+ "disabled": false
225
+ },
226
+ {
227
+ "name": "pull_request_discussion",
228
+ "description": "Read what people wrote on a pull request: each review verdict, the line comments as threads with the code they sit on, and the conversation",
229
+ "input_schema": "schemas/pull_request_discussion.in.json",
230
+ "output_schema": "schemas/pull_request_discussion.out.json",
231
+ "secrets": ["GITHUB_TOKEN"],
232
+ "capabilities": ["network:api.github.com"],
233
+ "side_effect": false,
234
+ "approval": "never",
235
+ "disabled": false
236
+ },
237
+ {
238
+ "name": "dependabot_alerts",
239
+ "description": "Read the Dependabot alerts of a repository, or one alert by number: package, severity, vulnerable range, first patched version, manifest and advisory ids",
240
+ "input_schema": "schemas/dependabot_alerts.in.json",
241
+ "output_schema": "schemas/dependabot_alerts.out.json",
242
+ "secrets": ["GITHUB_TOKEN"],
243
+ "capabilities": ["network:api.github.com"],
244
+ "side_effect": false,
245
+ "approval": "never",
246
+ "disabled": false
247
+ },
248
+ {
249
+ "name": "branch_protection",
250
+ "description": "Read what GitHub enforces on a branch: whether a merge needs a pull request and how many approvals, the required checks, and each rule and ruleset that applies",
251
+ "input_schema": "schemas/branch_protection.in.json",
252
+ "output_schema": "schemas/branch_protection.out.json",
253
+ "secrets": ["GITHUB_TOKEN"],
254
+ "capabilities": ["network:api.github.com"],
255
+ "side_effect": false,
256
+ "approval": "never",
257
+ "disabled": false
258
+ },
259
+ {
260
+ "name": "dismiss_dependabot_alert",
261
+ "description": "Dismiss a Dependabot alert of a repository with one of GitHub's reasons and a comment; every call needs a person's approval",
262
+ "input_schema": "schemas/dismiss_dependabot_alert.in.json",
263
+ "output_schema": "schemas/dismiss_dependabot_alert.out.json",
264
+ "secrets": ["GITHUB_TOKEN"],
265
+ "capabilities": ["network:api.github.com"],
266
+ "side_effect": true,
267
+ "compensate": "reopen_dependabot_alert",
268
+ "lookup": "find_dependabot_dismissal",
269
+ "approval": "always",
270
+ "disabled": false
271
+ },
272
+ {
273
+ "name": "reopen_dependabot_alert",
274
+ "description": "Open a Dependabot alert again that dismiss_dependabot_alert dismissed; the engine calls it with the output of that call",
275
+ "input_schema": "schemas/reopen_dependabot_alert.in.json",
276
+ "output_schema": "schemas/reopen_dependabot_alert.out.json",
277
+ "secrets": ["GITHUB_TOKEN"],
278
+ "capabilities": ["network:api.github.com"],
279
+ "side_effect": false,
280
+ "approval": "never",
281
+ "disabled": false
282
+ },
283
+ {
284
+ "name": "find_dependabot_dismissal",
285
+ "description": "Done when a Dependabot alert holds the reason and the comment of a dismiss_dependabot_alert call; skipped otherwise",
286
+ "input_schema": "schemas/find_dependabot_dismissal.in.json",
287
+ "output_schema": "schemas/find_dependabot_dismissal.out.json",
288
+ "secrets": ["GITHUB_TOKEN"],
289
+ "capabilities": ["network:api.github.com"],
290
+ "side_effect": false,
291
+ "approval": "never",
292
+ "disabled": false
293
+ },
294
+ {
295
+ "name": "comment",
296
+ "description": "Post a comment on a card, with an optional link on its own line",
297
+ "input_schema": "schemas/comment.in.json",
298
+ "output_schema": "schemas/comment.out.json",
299
+ "secrets": ["GITHUB_TOKEN"],
300
+ "capabilities": ["network:api.github.com"],
301
+ "side_effect": false,
302
+ "approval": "never",
303
+ "disabled": false
304
+ },
305
+ {
306
+ "name": "move",
307
+ "description": "Move a card to the column of an engine state, forward only; skipped otherwise",
308
+ "input_schema": "schemas/move.in.json",
309
+ "output_schema": "schemas/move.out.json",
310
+ "secrets": ["GITHUB_TOKEN"],
311
+ "capabilities": ["network:api.github.com"],
312
+ "side_effect": false,
313
+ "approval": "never",
314
+ "disabled": false
315
+ },
316
+ {
317
+ "name": "close",
318
+ "description": "Close a card's issue as completed",
319
+ "input_schema": "schemas/close.in.json",
320
+ "output_schema": "schemas/close.out.json",
321
+ "secrets": ["GITHUB_TOKEN"],
322
+ "capabilities": ["network:api.github.com"],
323
+ "side_effect": false,
324
+ "approval": "never",
325
+ "disabled": false
326
+ },
327
+ {
328
+ "name": "create_card",
329
+ "description": "File a card, or return the open card that holds its fingerprint",
330
+ "input_schema": "schemas/create_card.in.json",
331
+ "output_schema": "schemas/create_card.out.json",
332
+ "secrets": ["GITHUB_TOKEN"],
333
+ "capabilities": ["network:api.github.com"],
334
+ "side_effect": false,
335
+ "approval": "never",
336
+ "disabled": false
337
+ },
338
+ {
339
+ "name": "release_follow_ups",
340
+ "description": "Move the cards that wait for a card's merged pull request to ready",
341
+ "input_schema": "schemas/release_follow_ups.in.json",
342
+ "output_schema": "schemas/release_follow_ups.out.json",
343
+ "secrets": ["GITHUB_TOKEN"],
344
+ "capabilities": ["network:api.github.com"],
345
+ "side_effect": false,
346
+ "approval": "never",
347
+ "disabled": false
348
+ },
349
+ {
350
+ "name": "count_sighting",
351
+ "description": "Count one more sighting of the fault that an open card holds: raise occurrences and last_seen in its block; a card with no block is not written",
352
+ "input_schema": "schemas/count_sighting.in.json",
353
+ "output_schema": "schemas/count_sighting.out.json",
354
+ "secrets": ["GITHUB_TOKEN"],
355
+ "capabilities": ["network:api.github.com"],
356
+ "side_effect": false,
357
+ "approval": "never",
358
+ "disabled": false
359
+ },
360
+ {
361
+ "name": "batch_cards",
362
+ "description": "List the other open cards whose decided.batch is the given batch, such as the scanner cards of one repository",
363
+ "input_schema": "schemas/batch_cards.in.json",
364
+ "output_schema": "schemas/batch_cards.out.json",
365
+ "secrets": ["GITHUB_TOKEN"],
366
+ "capabilities": ["network:api.github.com"],
367
+ "side_effect": false,
368
+ "approval": "never",
369
+ "disabled": false
370
+ },
371
+ {
372
+ "name": "find_cards",
373
+ "description": "Search the open cards for words of a fault; with except, only cards made before that card",
374
+ "input_schema": "schemas/find_cards.in.json",
375
+ "output_schema": "schemas/find_cards.out.json",
376
+ "secrets": ["GITHUB_TOKEN"],
377
+ "capabilities": ["network:api.github.com"],
378
+ "side_effect": false,
379
+ "approval": "never",
380
+ "disabled": false
381
+ },
382
+ {
383
+ "name": "hand_back",
384
+ "description": "Assign a card to the person who handed it to EDGAR, else to its writer, and label it edgar:waiting; skipped when nobody can be given it",
385
+ "input_schema": "schemas/hand_back.in.json",
386
+ "output_schema": "schemas/hand_back.out.json",
387
+ "secrets": ["GITHUB_TOKEN"],
388
+ "capabilities": ["network:api.github.com"],
389
+ "side_effect": false,
390
+ "approval": "never",
391
+ "disabled": false
392
+ },
393
+ {
394
+ "name": "update_description",
395
+ "description": "Replace a card's description, keeping its edgar:v0 block",
396
+ "input_schema": "schemas/update_description.in.json",
397
+ "output_schema": "schemas/update_description.out.json",
398
+ "secrets": ["GITHUB_TOKEN"],
399
+ "capabilities": ["network:api.github.com"],
400
+ "side_effect": true,
401
+ "compensate": "restore_description",
402
+ "lookup": "find_description",
403
+ "approval": "never",
404
+ "disabled": false
405
+ },
406
+ {
407
+ "name": "restore_description",
408
+ "description": "Put back the description a card had before update_description",
409
+ "input_schema": "schemas/restore_description.in.json",
410
+ "output_schema": "schemas/restore_description.out.json",
411
+ "secrets": ["GITHUB_TOKEN"],
412
+ "capabilities": ["network:api.github.com"],
413
+ "side_effect": false,
414
+ "approval": "never",
415
+ "disabled": false
416
+ },
417
+ {
418
+ "name": "find_description",
419
+ "description": "Done when a card's description already reads as update_description writes it; skipped otherwise",
420
+ "input_schema": "schemas/find_description.in.json",
421
+ "output_schema": "schemas/find_description.out.json",
422
+ "secrets": ["GITHUB_TOKEN"],
423
+ "capabilities": ["network:api.github.com"],
424
+ "side_effect": false,
425
+ "approval": "never",
426
+ "disabled": false
427
+ },
428
+ {
429
+ "name": "assign",
430
+ "description": "Assign a card to a GitHub login, to EDGAR's own login with `me`, or to nobody with an empty user",
431
+ "input_schema": "schemas/assign.in.json",
432
+ "output_schema": "schemas/assign.out.json",
433
+ "secrets": ["GITHUB_TOKEN"],
434
+ "capabilities": ["network:api.github.com"],
435
+ "side_effect": true,
436
+ "compensate": "restore_assignee",
437
+ "lookup": "find_assignee",
438
+ "approval": "never",
439
+ "disabled": false
440
+ },
441
+ {
442
+ "name": "restore_assignee",
443
+ "description": "Set back the assignee a card had before assign",
444
+ "input_schema": "schemas/restore_assignee.in.json",
445
+ "output_schema": "schemas/restore_assignee.out.json",
446
+ "secrets": ["GITHUB_TOKEN"],
447
+ "capabilities": ["network:api.github.com"],
448
+ "side_effect": false,
449
+ "approval": "never",
450
+ "disabled": false
451
+ },
452
+ {
453
+ "name": "find_assignee",
454
+ "description": "Done when a card already has the assignee that assign sets; skipped otherwise",
455
+ "input_schema": "schemas/find_assignee.in.json",
456
+ "output_schema": "schemas/find_assignee.out.json",
457
+ "secrets": ["GITHUB_TOKEN"],
458
+ "capabilities": ["network:api.github.com"],
459
+ "side_effect": false,
460
+ "approval": "never",
461
+ "disabled": false
462
+ }
463
+ ],
464
+ "webhooks": [
465
+ {
466
+ "route": "events",
467
+ "signature": "hmac-sha256",
468
+ "secret": "GITHUB_WEBHOOK_SECRET",
469
+ "delivery_id_header": "X-GitHub-Delivery"
470
+ }
471
+ ],
472
+ "workflows": ["workflows/resume.toml"],
473
+ "roles": ["agents/dismiss"],
474
+ "skills": [],
475
+ "tracker": {
476
+ "methods": [
477
+ "list_cards",
478
+ "card",
479
+ "comments",
480
+ "attachments",
481
+ "comment",
482
+ "move",
483
+ "set_labels",
484
+ "create_card",
485
+ "close",
486
+ "whoami",
487
+ "person"
488
+ ],
489
+ "secrets": ["GITHUB_TOKEN"],
490
+ "capabilities": ["network:api.github.com"]
491
+ },
492
+ "environments": [],
493
+ "hooks": [],
494
+ "service": {
495
+ "secrets": ["GITHUB_TOKEN"],
496
+ "capabilities": ["network:api.github.com"]
497
+ },
498
+ "executables": {
499
+ "requires": [
500
+ {
501
+ "name": "git",
502
+ "reason": "The tool push_branch runs git in the sandbox of the run to push the branch."
503
+ }
504
+ ],
505
+ "provides": []
506
+ }
507
+ }
package/package.json CHANGED
@@ -1,6 +1,46 @@
1
1
  {
2
2
  "name": "@kana-ai/edgar-ext-github",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.1",
4
+ "description": "EDGAR extension for GitHub: push edgar/ branches, open, watch, close and merge pull requests, and track GitHub issues as cards.",
5
+ "license": "Apache-2.0",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/kana-ai/edgar",
9
+ "directory": "packages/extensions/ext-github"
10
+ },
11
+ "files": [
12
+ "agents",
13
+ "dist/src",
14
+ "edgar-extension.json",
15
+ "schemas",
16
+ "workflows"
17
+ ],
18
+ "type": "module",
19
+ "imports": {
20
+ "#*": "./dist/src/*.js"
21
+ },
22
+ "exports": {
23
+ ".": "./dist/src/index.js"
24
+ },
25
+ "dependencies": {
26
+ "@kana-ai/edgar-contracts": "0.1.1",
27
+ "@kana-ai/edgar-sdk": "0.1.1",
28
+ "zod": "4.6.7"
29
+ },
30
+ "devDependencies": {
31
+ "@types/node": "24.19.2",
32
+ "ajv": "8.20.0",
33
+ "oxfmt": "0.76.0",
34
+ "oxlint": "1.91.0",
35
+ "oxlint-tsgolint": "7.0.2005",
36
+ "typescript": "7.0.2",
37
+ "undici": "7.30.2"
38
+ },
39
+ "scripts": {
40
+ "build": "edgar-extension-build src/index.ts",
41
+ "check-types": "tsc --noEmit",
42
+ "lint": "oxlint --type-aware --deny-warnings",
43
+ "format:check": "oxfmt --check",
44
+ "test": "node --test"
45
+ }
6
46
  }
@@ -0,0 +1,15 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "card": {
6
+ "type": "string",
7
+ "minLength": 1
8
+ },
9
+ "user": {
10
+ "type": "string",
11
+ "description": "the GitHub login, `me` for EDGAR's own login, or an empty text for nobody"
12
+ }
13
+ },
14
+ "required": ["card", "user"]
15
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "id": {
6
+ "type": "string"
7
+ },
8
+ "previous": {
9
+ "description": "the login the card was assigned to before the write, or an empty text for nobody, which restore_assignee sets back; none when the card already had that assignee",
10
+ "type": "string"
11
+ }
12
+ },
13
+ "required": ["id"]
14
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "url": {
6
+ "type": "string",
7
+ "minLength": 1
8
+ },
9
+ "shot": {
10
+ "anyOf": [
11
+ {
12
+ "type": "object",
13
+ "properties": {
14
+ "path": {
15
+ "type": "string",
16
+ "minLength": 1
17
+ },
18
+ "bytes": {
19
+ "type": "integer",
20
+ "minimum": 0,
21
+ "maximum": 9007199254740991
22
+ },
23
+ "caption": {
24
+ "type": "string",
25
+ "minLength": 1
26
+ }
27
+ },
28
+ "required": ["path", "bytes", "caption"]
29
+ },
30
+ {
31
+ "type": "object",
32
+ "properties": {
33
+ "missing": {
34
+ "type": "string",
35
+ "minLength": 1
36
+ }
37
+ },
38
+ "required": ["missing"]
39
+ }
40
+ ]
41
+ }
42
+ },
43
+ "required": ["url", "shot"]
44
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "anyOf": [
4
+ {
5
+ "type": "object",
6
+ "properties": {
7
+ "attached": {
8
+ "type": "boolean",
9
+ "const": true
10
+ },
11
+ "image": {
12
+ "type": "string"
13
+ }
14
+ },
15
+ "required": ["attached", "image"]
16
+ },
17
+ {
18
+ "type": "object",
19
+ "properties": {
20
+ "attached": {
21
+ "type": "boolean",
22
+ "const": false
23
+ },
24
+ "missing": {
25
+ "type": "string"
26
+ }
27
+ },
28
+ "required": ["attached", "missing"]
29
+ }
30
+ ]
31
+ }