@kana-ai/edgar-contracts 0.1.1 → 0.1.3

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.
@@ -0,0 +1,2111 @@
1
+ {
2
+ "$defs": {
3
+ "AgentDefaults": {
4
+ "additionalProperties": false,
5
+ "properties": {
6
+ "max_tokens": {
7
+ "description": "An agent attempt that uses more tokens than this ends; no budget when unset.",
8
+ "format": "uint64",
9
+ "minimum": 1,
10
+ "title": "Agent token budget",
11
+ "type": ["integer", "null"],
12
+ "x-edgar": {
13
+ "apply": "live",
14
+ "console": "edit",
15
+ "group": "agents"
16
+ }
17
+ },
18
+ "silence_seconds": {
19
+ "description": "An agent attempt that sends nothing for this many seconds ends as silent.",
20
+ "format": "uint64",
21
+ "minimum": 1,
22
+ "title": "Agent silence limit",
23
+ "type": ["integer", "null"],
24
+ "x-edgar": {
25
+ "apply": "live",
26
+ "console": "edit",
27
+ "group": "agents"
28
+ }
29
+ },
30
+ "timeout_seconds": {
31
+ "description": "The most seconds one agent attempt may take.",
32
+ "format": "uint64",
33
+ "minimum": 1,
34
+ "title": "Agent time limit",
35
+ "type": ["integer", "null"],
36
+ "x-edgar": {
37
+ "apply": "live",
38
+ "console": "edit",
39
+ "group": "agents"
40
+ }
41
+ }
42
+ },
43
+ "type": "object"
44
+ },
45
+ "Alerts": {
46
+ "additionalProperties": false,
47
+ "description": "`[alerts]`: EDGAR's own alerts that work as designed, such as a command the sandbox blocks on purpose. An alert that holds one of `expected` stays in the events and the console, and gets no card on the service `edgar`. Empty by default, so nothing is hidden that the project does not name.",
48
+ "properties": {
49
+ "expected": {
50
+ "default": [],
51
+ "description": "Words an expected alert holds, matched as they are written; an alert that holds one gets no card.",
52
+ "items": {
53
+ "type": "string"
54
+ },
55
+ "title": "Expected alerts",
56
+ "type": "array",
57
+ "x-edgar": {
58
+ "apply": "restart",
59
+ "console": "edit",
60
+ "group": "notices"
61
+ }
62
+ }
63
+ },
64
+ "type": "object"
65
+ },
66
+ "Api": {
67
+ "additionalProperties": false,
68
+ "description": "`[api]`; no `bind` means loopback.",
69
+ "properties": {
70
+ "bind": {
71
+ "description": "Where `edgar api` serves the API; `127.0.0.1:7400` when unset.",
72
+ "title": "API address",
73
+ "type": ["string", "null"],
74
+ "x-edgar": {
75
+ "apply": "restart",
76
+ "console": "view",
77
+ "group": "console"
78
+ }
79
+ },
80
+ "identity": {
81
+ "anyOf": [
82
+ {
83
+ "$ref": "#/$defs/IdentityExtension"
84
+ },
85
+ {
86
+ "type": "null"
87
+ }
88
+ ],
89
+ "description": "`{ extension = \"<name>\" }`: the enabled extension that says who sends each request by the host of `public_url`, from the headers that a sign-in proxy in front of EDGAR adds.",
90
+ "title": "Identity extension",
91
+ "x-edgar": {
92
+ "apply": "restart",
93
+ "console": "view",
94
+ "group": "console"
95
+ }
96
+ },
97
+ "public_url": {
98
+ "description": "The address people open EDGAR at from another machine, through a reverse proxy, such as `https://edgar.example.com`.",
99
+ "title": "Public URL",
100
+ "type": ["string", "null"],
101
+ "x-edgar": {
102
+ "apply": "restart",
103
+ "console": "view",
104
+ "group": "console"
105
+ }
106
+ }
107
+ },
108
+ "type": "object"
109
+ },
110
+ "ApprovalPolicy": {
111
+ "description": "A tool's approval word; a project may only make the manifest's word stricter.",
112
+ "enum": ["never", "once", "always", "auto"],
113
+ "type": "string"
114
+ },
115
+ "Argv": {
116
+ "description": "A program and its arguments, run with no shell. A list with no program is refused as `C005`.",
117
+ "items": {
118
+ "type": "string"
119
+ },
120
+ "type": "array"
121
+ },
122
+ "Backoff": {
123
+ "enum": ["fixed", "exponential"],
124
+ "type": "string"
125
+ },
126
+ "BucketName": {
127
+ "description": "A bucket name both vendors accept: 3 to 63 of `a-z`, `0-9`, `-`, `.` and `_`, starting and ending with a letter or digit.",
128
+ "type": "string"
129
+ },
130
+ "Check": {
131
+ "additionalProperties": false,
132
+ "description": "A check command as structured arguments, never a shell string.",
133
+ "properties": {
134
+ "cmd": {
135
+ "description": "The program and its arguments that the check runs, never a shell string.",
136
+ "items": {
137
+ "type": "string"
138
+ },
139
+ "title": "Check command",
140
+ "type": "array",
141
+ "x-edgar": {
142
+ "apply": "restart",
143
+ "console": "view",
144
+ "group": "project"
145
+ }
146
+ },
147
+ "timeout_seconds": {
148
+ "description": "The most seconds this check may take; the check default when unset.",
149
+ "format": "uint64",
150
+ "minimum": 1,
151
+ "title": "Check time limit",
152
+ "type": ["integer", "null"],
153
+ "x-edgar": {
154
+ "apply": "restart",
155
+ "console": "edit",
156
+ "group": "project"
157
+ }
158
+ }
159
+ },
160
+ "required": ["cmd"],
161
+ "type": "object"
162
+ },
163
+ "Concurrency": {
164
+ "additionalProperties": false,
165
+ "description": "`[concurrency]`; unset values follow the machine.",
166
+ "properties": {
167
+ "sandboxes": {
168
+ "description": "How many runs hold a sandbox at the same time; four for each slot when unset.",
169
+ "format": "uint32",
170
+ "minimum": 1,
171
+ "title": "Sandboxes at once",
172
+ "type": ["integer", "null"],
173
+ "x-edgar": {
174
+ "apply": "restart",
175
+ "console": "edit",
176
+ "group": "sandbox"
177
+ }
178
+ },
179
+ "slots": {
180
+ "description": "How many stages run at the same time; the CPU count minus one when unset.",
181
+ "format": "uint32",
182
+ "minimum": 1,
183
+ "title": "Stages at once",
184
+ "type": ["integer", "null"],
185
+ "x-edgar": {
186
+ "apply": "restart",
187
+ "console": "edit",
188
+ "group": "sandbox"
189
+ }
190
+ }
191
+ },
192
+ "type": "object"
193
+ },
194
+ "Console": {
195
+ "additionalProperties": false,
196
+ "description": "`[console]`: where `edgar console` serves the console with the API beside it, and how many questions the console's Ask panel may put to stage sessions each minute.",
197
+ "properties": {
198
+ "ask_per_minute": {
199
+ "description": "How many questions the console's Ask panel may put to stage sessions each minute; 10 when unset.",
200
+ "format": "uint32",
201
+ "minimum": 1,
202
+ "title": "Questions per minute",
203
+ "type": ["integer", "null"],
204
+ "x-edgar": {
205
+ "apply": "live",
206
+ "console": "edit",
207
+ "group": "limits"
208
+ }
209
+ },
210
+ "bind": {
211
+ "description": "Where `edgar console` serves the console; `127.0.0.1:7401` when unset.",
212
+ "title": "Console address",
213
+ "type": ["string", "null"],
214
+ "x-edgar": {
215
+ "apply": "restart",
216
+ "console": "view",
217
+ "group": "console"
218
+ }
219
+ }
220
+ },
221
+ "type": "object"
222
+ },
223
+ "Daemon": {
224
+ "additionalProperties": false,
225
+ "description": "`[daemon]`: `enabled = true` makes `edgar start` detach as `edgar start --daemon` does.",
226
+ "properties": {
227
+ "enabled": {
228
+ "default": false,
229
+ "description": "Whether `edgar start` runs in the background, as `edgar start --daemon` does.",
230
+ "title": "Run in the background",
231
+ "type": "boolean",
232
+ "x-edgar": {
233
+ "apply": "restart",
234
+ "console": "edit",
235
+ "group": "updates"
236
+ }
237
+ }
238
+ },
239
+ "type": "object"
240
+ },
241
+ "Defaults": {
242
+ "additionalProperties": false,
243
+ "description": "`[defaults.<kind>]`; a missing bound takes the kind's built-in value. A `workflow` stage has no bound of its own, so it has no table.",
244
+ "properties": {
245
+ "agent": {
246
+ "$ref": "#/$defs/AgentDefaults",
247
+ "default": {
248
+ "max_tokens": null,
249
+ "silence_seconds": null,
250
+ "timeout_seconds": null
251
+ }
252
+ },
253
+ "check": {
254
+ "$ref": "#/$defs/KindDefaults",
255
+ "default": {
256
+ "timeout_seconds": null
257
+ }
258
+ },
259
+ "tool": {
260
+ "$ref": "#/$defs/KindDefaults",
261
+ "default": {
262
+ "timeout_seconds": null
263
+ }
264
+ },
265
+ "wait": {
266
+ "$ref": "#/$defs/KindDefaults",
267
+ "default": {
268
+ "timeout_seconds": null
269
+ }
270
+ }
271
+ },
272
+ "type": "object"
273
+ },
274
+ "Effort": {
275
+ "enum": ["low", "medium", "high", "max"],
276
+ "type": "string"
277
+ },
278
+ "Endpoint": {
279
+ "description": "`https://<host>[:port][/path]`, or `http://` to a loopback host only, with no user in it.",
280
+ "type": "string"
281
+ },
282
+ "Environment": {
283
+ "additionalProperties": false,
284
+ "description": "A service's running stack, run by an extension's environment provider.",
285
+ "properties": {
286
+ "provider": {
287
+ "type": "string"
288
+ }
289
+ },
290
+ "required": ["provider"],
291
+ "type": "object"
292
+ },
293
+ "Extensions": {
294
+ "additionalProperties": {
295
+ "description": "One extension's settings, checked against its manifest's `config_schema`.",
296
+ "properties": {
297
+ "hosts": {
298
+ "description": "Hosts every call of this extension may reach, beside its manifest's own.",
299
+ "items": {
300
+ "type": "string"
301
+ },
302
+ "title": "Extra hosts",
303
+ "type": "array",
304
+ "x-edgar": {
305
+ "apply": "restart",
306
+ "console": "view",
307
+ "group": "extensions"
308
+ }
309
+ }
310
+ },
311
+ "type": "object"
312
+ },
313
+ "properties": {
314
+ "enabled": {
315
+ "description": "The extensions this project uses, by name.",
316
+ "items": {
317
+ "type": "string"
318
+ },
319
+ "title": "Enabled extensions",
320
+ "type": "array",
321
+ "x-edgar": {
322
+ "apply": "restart",
323
+ "console": "edit",
324
+ "group": "extensions"
325
+ }
326
+ }
327
+ },
328
+ "type": "object"
329
+ },
330
+ "GitToken": {
331
+ "anyOf": [
332
+ {
333
+ "type": "string"
334
+ },
335
+ {
336
+ "additionalProperties": false,
337
+ "properties": {
338
+ "extension": {
339
+ "type": "string"
340
+ }
341
+ },
342
+ "required": ["extension"],
343
+ "type": "object"
344
+ }
345
+ ],
346
+ "description": "Where the token of a `[sandbox] git_tokens` host comes from: a `[secrets]` name, read once at start, or `{ extension = \"<name>\" }`, an enabled extension that mints one when git needs it, such as a GitHub App's installation token."
347
+ },
348
+ "HookTimeout": {
349
+ "enum": ["pass", "deny"],
350
+ "type": "string"
351
+ },
352
+ "Hooks": {
353
+ "additionalProperties": false,
354
+ "description": "`[hooks]`.",
355
+ "properties": {
356
+ "on_timeout": {
357
+ "$ref": "#/$defs/HookTimeout",
358
+ "default": "pass",
359
+ "description": "What a hook that does not answer in time means: `pass` or `deny`.",
360
+ "title": "When a hook does not answer",
361
+ "x-edgar": {
362
+ "apply": "live",
363
+ "console": "edit",
364
+ "group": "approval"
365
+ }
366
+ },
367
+ "order": {
368
+ "default": ["edgar__guardrails"],
369
+ "description": "The hooks that judge each tool call, in order; removing `edgar__guardrails` drops its checks.",
370
+ "items": {
371
+ "type": "string"
372
+ },
373
+ "title": "Hook order",
374
+ "type": "array",
375
+ "x-edgar": {
376
+ "apply": "live",
377
+ "console": "view",
378
+ "group": "approval"
379
+ }
380
+ }
381
+ },
382
+ "type": "object"
383
+ },
384
+ "IdentityExtension": {
385
+ "additionalProperties": false,
386
+ "description": "The extension that `[api] identity` names.",
387
+ "properties": {
388
+ "extension": {
389
+ "type": "string"
390
+ }
391
+ },
392
+ "required": ["extension"],
393
+ "type": "object"
394
+ },
395
+ "KeyedConcurrency": {
396
+ "additionalProperties": false,
397
+ "description": "`concurrency = { key = \"trigger.<field>\", limit = n }`: at most `limit` runs of the workflow hold a start at once for each value the key reads from the run's input; the next one stays `queued`. A run whose input has no value at `key` counts under the value `null`.",
398
+ "properties": {
399
+ "key": {
400
+ "$ref": "#/$defs/TriggerPath"
401
+ },
402
+ "limit": {
403
+ "format": "uint32",
404
+ "minimum": 1,
405
+ "type": "integer"
406
+ }
407
+ },
408
+ "required": ["key", "limit"],
409
+ "type": "object"
410
+ },
411
+ "KindDefaults": {
412
+ "additionalProperties": false,
413
+ "properties": {
414
+ "timeout_seconds": {
415
+ "description": "The most seconds one stage of this kind may take.",
416
+ "format": "uint64",
417
+ "minimum": 1,
418
+ "title": "Time limit",
419
+ "type": ["integer", "null"],
420
+ "x-edgar": {
421
+ "apply": "live",
422
+ "console": "edit",
423
+ "group": "agents"
424
+ }
425
+ }
426
+ },
427
+ "type": "object"
428
+ },
429
+ "Limits": {
430
+ "additionalProperties": false,
431
+ "description": "`[limits]`.",
432
+ "properties": {
433
+ "card_runs_per_day": {
434
+ "default": 20,
435
+ "description": "How many runs one card starts in a day; past it, the card is handed back to a person once with a comment that says why, so a card that keeps failing cannot loop forever.",
436
+ "format": "uint32",
437
+ "minimum": 1,
438
+ "title": "Runs per card per day",
439
+ "type": "integer",
440
+ "x-edgar": {
441
+ "apply": "live",
442
+ "console": "edit",
443
+ "group": "limits"
444
+ }
445
+ },
446
+ "comment_bytes": {
447
+ "default": 65536,
448
+ "description": "The longest comment EDGAR reads or writes on a card.",
449
+ "format": "uint32",
450
+ "minimum": 1,
451
+ "title": "Longest comment (bytes)",
452
+ "type": "integer",
453
+ "x-edgar": {
454
+ "apply": "live",
455
+ "console": "edit",
456
+ "group": "limits"
457
+ }
458
+ },
459
+ "pull_requests": {
460
+ "anyOf": [
461
+ {
462
+ "$ref": "#/$defs/PullRequestCap"
463
+ },
464
+ {
465
+ "type": "null"
466
+ }
467
+ ]
468
+ },
469
+ "questions_per_day": {
470
+ "default": 10,
471
+ "description": "How many questions a stage marked `question` posts on the cards of one tracker in a UTC day; past it, a question waits for the next day, except on a critical or high card.",
472
+ "format": "uint32",
473
+ "minimum": 1,
474
+ "title": "Questions per tracker per day",
475
+ "type": "integer",
476
+ "x-edgar": {
477
+ "apply": "live",
478
+ "console": "edit",
479
+ "group": "limits"
480
+ }
481
+ },
482
+ "run_usd": {
483
+ "description": "The most one run spends on model calls, in USD, with the sub-runs it starts; once its spend reaches this, the run starts no more work and ends failed. No budget when unset.",
484
+ "format": "double",
485
+ "title": "Budget per run (USD)",
486
+ "type": ["number", "null"],
487
+ "x-edgar": {
488
+ "apply": "live",
489
+ "console": "edit",
490
+ "group": "limits"
491
+ }
492
+ },
493
+ "self_merge_files": {
494
+ "default": 5,
495
+ "description": "EDGAR merges its own pull request with no person only when it changes fewer files than this; `0` turns that off.",
496
+ "format": "uint32",
497
+ "minimum": 0,
498
+ "title": "Files in a self-merge",
499
+ "type": "integer",
500
+ "x-edgar": {
501
+ "apply": "live",
502
+ "console": "edit",
503
+ "group": "limits"
504
+ }
505
+ }
506
+ },
507
+ "type": "object"
508
+ },
509
+ "LogFormat": {
510
+ "oneOf": [
511
+ {
512
+ "const": "text",
513
+ "description": "One line per event, its spans before it.",
514
+ "type": "string"
515
+ },
516
+ {
517
+ "const": "json",
518
+ "description": "One JSON object per event, with its span and the list of spans above it.",
519
+ "type": "string"
520
+ }
521
+ ]
522
+ },
523
+ "Logs": {
524
+ "additionalProperties": false,
525
+ "description": "`[logs]`: how `edgar` writes its log to stderr; `EDGAR_LOG` picks which spans and events.",
526
+ "properties": {
527
+ "format": {
528
+ "$ref": "#/$defs/LogFormat",
529
+ "default": "text",
530
+ "description": "How `edgar` writes its log: one line of text, or one JSON object, for each event.",
531
+ "title": "Log format",
532
+ "x-edgar": {
533
+ "apply": "restart",
534
+ "console": "edit",
535
+ "group": "updates"
536
+ }
537
+ },
538
+ "keep": {
539
+ "description": "How many rotated log files a daemon keeps; 5 when unset.",
540
+ "format": "uint32",
541
+ "minimum": 1,
542
+ "title": "Rotated logs kept",
543
+ "type": ["integer", "null"],
544
+ "x-edgar": {
545
+ "apply": "restart",
546
+ "console": "edit",
547
+ "group": "updates"
548
+ }
549
+ },
550
+ "max_bytes": {
551
+ "description": "The size at which a daemon's `edgar.log` rotates; 10 MiB when unset.",
552
+ "format": "uint64",
553
+ "minimum": 1,
554
+ "title": "Log size before rotation",
555
+ "type": ["integer", "null"],
556
+ "x-edgar": {
557
+ "apply": "restart",
558
+ "console": "edit",
559
+ "group": "updates"
560
+ }
561
+ }
562
+ },
563
+ "type": "object"
564
+ },
565
+ "Mcp": {
566
+ "additionalProperties": false,
567
+ "description": "`[mcp]`: `/mcp` answers a loopback `Host` only, unless `[mcp.remote]` is enabled.",
568
+ "properties": {
569
+ "remote": {
570
+ "anyOf": [
571
+ {
572
+ "$ref": "#/$defs/RemoteMcp"
573
+ },
574
+ {
575
+ "type": "null"
576
+ }
577
+ ]
578
+ }
579
+ },
580
+ "type": "object"
581
+ },
582
+ "OutboxChannel": {
583
+ "additionalProperties": false,
584
+ "description": "`[outbox.<channel>]`.",
585
+ "properties": {
586
+ "retry": {
587
+ "$ref": "#/$defs/RetryPolicy",
588
+ "default": {
589
+ "backoff": "exponential",
590
+ "interval_seconds": 60,
591
+ "max_attempts": 10
592
+ },
593
+ "description": "How the outbox sends a write to this channel again after it fails.",
594
+ "title": "Retry",
595
+ "x-edgar": {
596
+ "apply": "restart",
597
+ "console": "edit",
598
+ "group": "notices"
599
+ }
600
+ }
601
+ },
602
+ "type": "object"
603
+ },
604
+ "Outside": {
605
+ "description": "`[tracker] outside`.",
606
+ "enum": ["answers", "nothing"],
607
+ "type": "string"
608
+ },
609
+ "PathNotice": {
610
+ "additionalProperties": false,
611
+ "description": "`[[services.<name>.path_notices]]`.",
612
+ "properties": {
613
+ "notice": {
614
+ "type": "string"
615
+ },
616
+ "prefix": {
617
+ "type": "string"
618
+ }
619
+ },
620
+ "required": ["prefix", "notice"],
621
+ "type": "object"
622
+ },
623
+ "Person": {
624
+ "additionalProperties": false,
625
+ "description": "`[people.<name>]`: a person who works with EDGAR, with their id in each extension, keyed by the extension's name. The name signs the moves of `edgar console --as <name>`.",
626
+ "properties": {
627
+ "email": {
628
+ "description": "The person's email address.",
629
+ "title": "Email",
630
+ "type": ["string", "null"],
631
+ "x-edgar": {
632
+ "apply": "restart",
633
+ "console": "edit",
634
+ "group": "people"
635
+ }
636
+ },
637
+ "ids": {
638
+ "additionalProperties": {
639
+ "type": "string"
640
+ },
641
+ "default": {},
642
+ "description": "The person's id in each extension, keyed by the extension's name: an id only their own account can change, such as an email or a login, never a display name; an id names one person.",
643
+ "title": "Ids",
644
+ "type": "object",
645
+ "x-edgar": {
646
+ "apply": "restart",
647
+ "console": "edit",
648
+ "group": "people"
649
+ }
650
+ }
651
+ },
652
+ "type": "object"
653
+ },
654
+ "Prepare": {
655
+ "additionalProperties": false,
656
+ "description": "`[services.<name>] prepare`: `cmd` runs once in a new sandbox for each content of the files in `inputs`; what it adds to the work folder becomes the service's prepared layer, which each later sandbox with the same inputs gets a copy of.",
657
+ "properties": {
658
+ "cmd": {
659
+ "description": "The program and its arguments, never a shell string, such as `[\"pnpm\", \"install\", \"--frozen-lockfile\"]`.",
660
+ "items": {
661
+ "type": "string"
662
+ },
663
+ "type": "array"
664
+ },
665
+ "inputs": {
666
+ "description": "The files, relative to the repository, whose content names the layer, such as `[\"pnpm-lock.yaml\"]`.",
667
+ "items": {
668
+ "type": "string"
669
+ },
670
+ "type": "array"
671
+ },
672
+ "scripts": {
673
+ "default": false,
674
+ "description": "Whether the packages' install scripts run; off unless set.",
675
+ "type": "boolean"
676
+ }
677
+ },
678
+ "required": ["cmd", "inputs"],
679
+ "type": "object"
680
+ },
681
+ "Prices": {
682
+ "additionalProperties": false,
683
+ "description": "USD per million tokens. Cached tokens with no `cached` price cost the input price.",
684
+ "properties": {
685
+ "cache_write": {
686
+ "default": null,
687
+ "format": "double",
688
+ "type": ["number", "null"]
689
+ },
690
+ "cached": {
691
+ "default": null,
692
+ "format": "double",
693
+ "type": ["number", "null"]
694
+ },
695
+ "input": {
696
+ "format": "double",
697
+ "type": "number"
698
+ },
699
+ "output": {
700
+ "format": "double",
701
+ "type": "number"
702
+ }
703
+ },
704
+ "required": ["input", "output"],
705
+ "type": "object"
706
+ },
707
+ "ProjectSettings": {
708
+ "additionalProperties": false,
709
+ "properties": {
710
+ "dry_run": {
711
+ "default": false,
712
+ "description": "Whether EDGAR works and commits on the machine but pushes, opens and posts nothing, and logs each write it held back.",
713
+ "title": "Dry run",
714
+ "type": "boolean",
715
+ "x-edgar": {
716
+ "apply": "restart",
717
+ "console": "view",
718
+ "group": "project"
719
+ }
720
+ },
721
+ "name": {
722
+ "description": "The project's name; `edgar init` sets it to the folder's name.",
723
+ "title": "Project name",
724
+ "type": "string",
725
+ "x-edgar": {
726
+ "apply": "restart",
727
+ "console": "edit",
728
+ "group": "project"
729
+ }
730
+ }
731
+ },
732
+ "required": ["name"],
733
+ "type": "object"
734
+ },
735
+ "ProviderSettings": {
736
+ "additionalProperties": false,
737
+ "description": "One `[providers.<name>]` table.",
738
+ "properties": {
739
+ "command": {
740
+ "description": "The ACP agent's program and its arguments.",
741
+ "items": {
742
+ "type": "string"
743
+ },
744
+ "title": "Agent command",
745
+ "type": ["array", "null"],
746
+ "x-edgar": {
747
+ "apply": "restart",
748
+ "console": "view",
749
+ "group": "agents"
750
+ }
751
+ },
752
+ "env_key": {
753
+ "description": "The variable the API key reaches the ACP agent as; `ANTHROPIC_API_KEY` when unset.",
754
+ "title": "Key variable",
755
+ "type": ["string", "null"],
756
+ "x-edgar": {
757
+ "apply": "restart",
758
+ "console": "view",
759
+ "group": "agents"
760
+ }
761
+ },
762
+ "model": {
763
+ "description": "The vendor's model id every session of this provider asks for; the vendor's default when unset.",
764
+ "title": "Model",
765
+ "type": ["string", "null"],
766
+ "x-edgar": {
767
+ "apply": "live",
768
+ "console": "edit",
769
+ "group": "agents"
770
+ }
771
+ },
772
+ "prices": {
773
+ "anyOf": [
774
+ {
775
+ "$ref": "#/$defs/Prices"
776
+ },
777
+ {
778
+ "type": "null"
779
+ }
780
+ ],
781
+ "description": "US dollars for each million tokens, which give each model call its cost.",
782
+ "title": "Prices",
783
+ "x-edgar": {
784
+ "apply": "live",
785
+ "console": "edit",
786
+ "group": "agents"
787
+ }
788
+ }
789
+ },
790
+ "type": "object"
791
+ },
792
+ "PublicWebhooks": {
793
+ "additionalProperties": false,
794
+ "description": "`[webhooks.public]`: with `enabled`, the tracker webhook routes also answer a `Host` that `host` names, the name a reverse proxy forwards; each delivery still needs its signature.",
795
+ "properties": {
796
+ "enabled": {
797
+ "default": false,
798
+ "description": "Whether the tracker webhook routes also answer requests forwarded for the public host name.",
799
+ "title": "Public webhooks",
800
+ "type": "boolean",
801
+ "x-edgar": {
802
+ "apply": "restart",
803
+ "console": "view",
804
+ "group": "console"
805
+ }
806
+ },
807
+ "host": {
808
+ "description": "The public name a reverse proxy forwards to `/hooks/`, such as `edgar.example.com`.",
809
+ "title": "Public webhook host",
810
+ "type": "string",
811
+ "x-edgar": {
812
+ "apply": "restart",
813
+ "console": "view",
814
+ "group": "console"
815
+ }
816
+ }
817
+ },
818
+ "required": ["host"],
819
+ "type": "object"
820
+ },
821
+ "PullRequestCap": {
822
+ "additionalProperties": false,
823
+ "description": "`pull_requests = { per_hour = 10, per_day = 40 }`: past a cap, a call of `tool` waits for a person instead of opening another change. A missing cap does not count.",
824
+ "properties": {
825
+ "per_day": {
826
+ "description": "How many pull requests EDGAR opens in a day before a person must approve the next.",
827
+ "format": "uint32",
828
+ "minimum": 1,
829
+ "title": "Pull requests per day",
830
+ "type": ["integer", "null"],
831
+ "x-edgar": {
832
+ "apply": "live",
833
+ "console": "edit",
834
+ "group": "limits"
835
+ }
836
+ },
837
+ "per_hour": {
838
+ "description": "How many pull requests EDGAR opens in an hour before a person must approve the next.",
839
+ "format": "uint32",
840
+ "minimum": 1,
841
+ "title": "Pull requests per hour",
842
+ "type": ["integer", "null"],
843
+ "x-edgar": {
844
+ "apply": "live",
845
+ "console": "edit",
846
+ "group": "limits"
847
+ }
848
+ },
849
+ "tool": {
850
+ "description": "The tool whose calls the caps count; `github__open_pull_request` when unset.",
851
+ "title": "Tool that opens a change",
852
+ "type": ["string", "null"],
853
+ "x-edgar": {
854
+ "apply": "live",
855
+ "console": "edit",
856
+ "group": "limits"
857
+ }
858
+ }
859
+ },
860
+ "type": "object"
861
+ },
862
+ "RemoteMcp": {
863
+ "additionalProperties": false,
864
+ "description": "`[mcp.remote]`: with `enabled`, `/mcp` also answers a `Host` that `host` names, the name a reverse proxy forwards, and only with a personal token from `edgar token new`.",
865
+ "properties": {
866
+ "enabled": {
867
+ "default": false,
868
+ "description": "Whether `/mcp` also answers requests forwarded for the public host name.",
869
+ "title": "Remote MCP",
870
+ "type": "boolean",
871
+ "x-edgar": {
872
+ "apply": "restart",
873
+ "console": "view",
874
+ "group": "console"
875
+ }
876
+ },
877
+ "host": {
878
+ "description": "The public name a reverse proxy forwards to `/mcp`, such as `edgar.example.com`.",
879
+ "title": "Remote MCP host",
880
+ "type": "string",
881
+ "x-edgar": {
882
+ "apply": "restart",
883
+ "console": "view",
884
+ "group": "console"
885
+ }
886
+ }
887
+ },
888
+ "required": ["host"],
889
+ "type": "object"
890
+ },
891
+ "RetryOverride": {
892
+ "additionalProperties": false,
893
+ "description": "`retry = { ... }` of a stage override: each key it names replaces that key of the stage's retry policy, and the others keep the stage's own.",
894
+ "properties": {
895
+ "backoff": {
896
+ "anyOf": [
897
+ {
898
+ "$ref": "#/$defs/Backoff"
899
+ },
900
+ {
901
+ "type": "null"
902
+ }
903
+ ],
904
+ "description": "Whether the wait between attempts stays the same (`fixed`) or doubles (`exponential`).",
905
+ "title": "Wait between attempts",
906
+ "x-edgar": {
907
+ "apply": "restart",
908
+ "console": "edit",
909
+ "group": "stages"
910
+ }
911
+ },
912
+ "interval_seconds": {
913
+ "description": "The seconds before the second attempt.",
914
+ "format": "uint64",
915
+ "minimum": 0,
916
+ "title": "Seconds between attempts",
917
+ "type": ["integer", "null"],
918
+ "x-edgar": {
919
+ "apply": "restart",
920
+ "console": "edit",
921
+ "group": "stages"
922
+ }
923
+ },
924
+ "max_attempts": {
925
+ "description": "How many times this stage may run in all, the first time included.",
926
+ "format": "uint32",
927
+ "minimum": 1,
928
+ "title": "Attempts",
929
+ "type": ["integer", "null"],
930
+ "x-edgar": {
931
+ "apply": "restart",
932
+ "console": "edit",
933
+ "group": "stages"
934
+ }
935
+ }
936
+ },
937
+ "type": "object"
938
+ },
939
+ "RetryPolicy": {
940
+ "additionalProperties": false,
941
+ "description": "`retry = { max_attempts, interval_seconds, backoff }`; the default is one attempt.",
942
+ "properties": {
943
+ "backoff": {
944
+ "$ref": "#/$defs/Backoff",
945
+ "default": "fixed"
946
+ },
947
+ "interval_seconds": {
948
+ "default": 0,
949
+ "format": "uint64",
950
+ "minimum": 0,
951
+ "type": "integer"
952
+ },
953
+ "max_attempts": {
954
+ "default": 1,
955
+ "format": "uint32",
956
+ "minimum": 1,
957
+ "type": "integer"
958
+ }
959
+ },
960
+ "type": "object"
961
+ },
962
+ "RoleSettings": {
963
+ "additionalProperties": false,
964
+ "description": "`[agents.<role>]`: `disabled = true` removes a role of a lower layer; `model`, `effort`, `fallback` and `steer` replace the role's own, so a project changes them with no copy of the role's folder.",
965
+ "properties": {
966
+ "disabled": {
967
+ "default": false,
968
+ "description": "Whether this role is turned off.",
969
+ "title": "Turned off",
970
+ "type": "boolean",
971
+ "x-edgar": {
972
+ "apply": "restart",
973
+ "console": "edit",
974
+ "group": "agents"
975
+ }
976
+ },
977
+ "effort": {
978
+ "anyOf": [
979
+ {
980
+ "$ref": "#/$defs/Effort"
981
+ },
982
+ {
983
+ "type": "null"
984
+ }
985
+ ],
986
+ "default": null,
987
+ "description": "How hard this role thinks: `low`, `medium`, `high` or `max`, in place of the role's own.",
988
+ "title": "Effort",
989
+ "x-edgar": {
990
+ "apply": "restart",
991
+ "console": "edit",
992
+ "group": "agents"
993
+ }
994
+ },
995
+ "fallback": {
996
+ "default": null,
997
+ "description": "The providers this role moves to, in order, when its own is unavailable.",
998
+ "items": {
999
+ "type": "string"
1000
+ },
1001
+ "title": "Fallback providers",
1002
+ "type": ["array", "null"],
1003
+ "x-edgar": {
1004
+ "apply": "restart",
1005
+ "console": "edit",
1006
+ "group": "agents"
1007
+ }
1008
+ },
1009
+ "model": {
1010
+ "default": null,
1011
+ "description": "The provider this role runs on, such as `claude` or `codex`, in place of the role's own.",
1012
+ "title": "Provider",
1013
+ "type": ["string", "null"],
1014
+ "x-edgar": {
1015
+ "apply": "restart",
1016
+ "console": "edit",
1017
+ "group": "agents"
1018
+ }
1019
+ },
1020
+ "steer": {
1021
+ "default": null,
1022
+ "description": "Whether a team comment on the card reaches a running stage of this role at the end of its turn, in place of starting a run, in place of the role's own `steer`.",
1023
+ "title": "Steer from comments",
1024
+ "type": ["boolean", "null"],
1025
+ "x-edgar": {
1026
+ "apply": "restart",
1027
+ "console": "edit",
1028
+ "group": "agents"
1029
+ }
1030
+ }
1031
+ },
1032
+ "type": "object"
1033
+ },
1034
+ "Roles": {
1035
+ "additionalProperties": false,
1036
+ "description": "`[roles]`; an empty `operator` list means everyone on the box.",
1037
+ "properties": {
1038
+ "operator": {
1039
+ "default": [],
1040
+ "description": "The people who may approve, deny, complete or cancel; everyone when empty.",
1041
+ "items": {
1042
+ "type": "string"
1043
+ },
1044
+ "title": "Operators",
1045
+ "type": "array",
1046
+ "x-edgar": {
1047
+ "apply": "restart",
1048
+ "console": "edit",
1049
+ "group": "people"
1050
+ }
1051
+ }
1052
+ },
1053
+ "type": "object"
1054
+ },
1055
+ "Runtime": {
1056
+ "additionalProperties": false,
1057
+ "description": "`[runtime]`.",
1058
+ "properties": {
1059
+ "idle_seconds": {
1060
+ "default": 300,
1061
+ "description": "A provider or extension runtime with no work for this long exits.",
1062
+ "format": "uint64",
1063
+ "minimum": 1,
1064
+ "title": "Idle seconds before a runtime exits",
1065
+ "type": "integer",
1066
+ "x-edgar": {
1067
+ "apply": "restart",
1068
+ "console": "edit",
1069
+ "group": "sandbox"
1070
+ }
1071
+ }
1072
+ },
1073
+ "type": "object"
1074
+ },
1075
+ "Sandbox": {
1076
+ "additionalProperties": false,
1077
+ "description": "`[sandbox]`.",
1078
+ "properties": {
1079
+ "deny": {
1080
+ "default": [],
1081
+ "description": "Commands refused by their first words, such as `pnpm deploy`.",
1082
+ "items": {
1083
+ "type": "string"
1084
+ },
1085
+ "title": "Refused commands",
1086
+ "type": "array",
1087
+ "x-edgar": {
1088
+ "apply": "restart",
1089
+ "console": "view",
1090
+ "group": "sandbox"
1091
+ }
1092
+ },
1093
+ "git_tokens": {
1094
+ "additionalProperties": {
1095
+ "$ref": "#/$defs/GitToken"
1096
+ },
1097
+ "default": {
1098
+ "github.com": "GITHUB_TOKEN"
1099
+ },
1100
+ "description": "For each `https://` host, the token that EDGAR's own git sends there.",
1101
+ "title": "Git tokens",
1102
+ "type": "object",
1103
+ "x-edgar": {
1104
+ "apply": "restart",
1105
+ "console": "view",
1106
+ "group": "sandbox"
1107
+ }
1108
+ },
1109
+ "image": {
1110
+ "description": "The container image that commands run in when the sandbox kind is `container`.",
1111
+ "title": "Container image",
1112
+ "type": ["string", "null"],
1113
+ "x-edgar": {
1114
+ "apply": "restart",
1115
+ "console": "view",
1116
+ "group": "sandbox"
1117
+ }
1118
+ },
1119
+ "keep_while_waiting_hours": {
1120
+ "default": 72,
1121
+ "description": "How long a run that waits for a person keeps its sandbox folder.",
1122
+ "format": "uint32",
1123
+ "minimum": 1,
1124
+ "title": "Hours a waiting run keeps its sandbox",
1125
+ "type": "integer",
1126
+ "x-edgar": {
1127
+ "apply": "restart",
1128
+ "console": "edit",
1129
+ "group": "sandbox"
1130
+ }
1131
+ },
1132
+ "kind": {
1133
+ "$ref": "#/$defs/SandboxKind",
1134
+ "default": "worktree",
1135
+ "description": "How commands are isolated: a Git worktree, a container, or no isolation at all.",
1136
+ "title": "Sandbox kind",
1137
+ "x-edgar": {
1138
+ "apply": "restart",
1139
+ "console": "view",
1140
+ "group": "sandbox"
1141
+ }
1142
+ },
1143
+ "max_behind": {
1144
+ "default": 20,
1145
+ "description": "Kept work this many commits behind the default branch does not resume.",
1146
+ "format": "uint32",
1147
+ "minimum": 0,
1148
+ "title": "Commits behind before work restarts",
1149
+ "type": "integer",
1150
+ "x-edgar": {
1151
+ "apply": "restart",
1152
+ "console": "edit",
1153
+ "group": "sandbox"
1154
+ }
1155
+ },
1156
+ "min_free_gb": {
1157
+ "default": 5,
1158
+ "description": "EDGAR makes no new sandbox while the disk has less free space than this.",
1159
+ "format": "uint32",
1160
+ "minimum": 0,
1161
+ "title": "Free disk needed (GB)",
1162
+ "type": "integer",
1163
+ "x-edgar": {
1164
+ "apply": "restart",
1165
+ "console": "edit",
1166
+ "group": "sandbox"
1167
+ }
1168
+ },
1169
+ "network": {
1170
+ "default": [],
1171
+ "description": "Hosts that every command in the sandbox may reach, such as a package registry.",
1172
+ "items": {
1173
+ "type": "string"
1174
+ },
1175
+ "title": "Hosts every command reaches",
1176
+ "type": "array",
1177
+ "x-edgar": {
1178
+ "apply": "restart",
1179
+ "console": "view",
1180
+ "group": "sandbox"
1181
+ }
1182
+ },
1183
+ "secret_files": {
1184
+ "default": [],
1185
+ "description": "Paths of the service checkout, globs allowed, that no read returns and no push carries.",
1186
+ "items": {
1187
+ "type": "string"
1188
+ },
1189
+ "title": "Secret files",
1190
+ "type": "array",
1191
+ "x-edgar": {
1192
+ "apply": "restart",
1193
+ "console": "view",
1194
+ "group": "sandbox"
1195
+ }
1196
+ },
1197
+ "signed_commits": {
1198
+ "additionalProperties": {
1199
+ "type": "string"
1200
+ },
1201
+ "description": "For each `https://` host, the extension that publishes EDGAR's pushes there as commits the host signs, in place of `git push`.",
1202
+ "title": "Signed commits",
1203
+ "type": "object",
1204
+ "x-edgar": {
1205
+ "apply": "restart",
1206
+ "console": "view",
1207
+ "group": "sandbox"
1208
+ }
1209
+ }
1210
+ },
1211
+ "type": "object"
1212
+ },
1213
+ "SandboxKind": {
1214
+ "enum": ["worktree", "container", "none"],
1215
+ "type": "string"
1216
+ },
1217
+ "Screenshots": {
1218
+ "additionalProperties": false,
1219
+ "description": "`[screenshots]`: where the pictures of pull requests are kept, when `[storage]` and `[api] public_url` are set.",
1220
+ "properties": {
1221
+ "legacy": {
1222
+ "anyOf": [
1223
+ {
1224
+ "$ref": "#/$defs/StorageLocation"
1225
+ },
1226
+ {
1227
+ "type": "null"
1228
+ }
1229
+ ],
1230
+ "description": "Where the first version of EDGAR kept its pictures, such as `gs://example-pub`, read for an old `/pub/<id>.png` that `[storage]` does not hold.",
1231
+ "title": "Earlier pictures",
1232
+ "x-edgar": {
1233
+ "apply": "restart",
1234
+ "console": "view",
1235
+ "group": "storage"
1236
+ }
1237
+ }
1238
+ },
1239
+ "type": "object"
1240
+ },
1241
+ "SecretSource": {
1242
+ "description": "Where a secret comes from, in order of preference.",
1243
+ "oneOf": [
1244
+ {
1245
+ "additionalProperties": false,
1246
+ "properties": {
1247
+ "env": {
1248
+ "type": "string"
1249
+ }
1250
+ },
1251
+ "required": ["env"],
1252
+ "type": "object"
1253
+ },
1254
+ {
1255
+ "additionalProperties": false,
1256
+ "properties": {
1257
+ "file": {
1258
+ "type": "string"
1259
+ }
1260
+ },
1261
+ "required": ["file"],
1262
+ "type": "object"
1263
+ },
1264
+ {
1265
+ "additionalProperties": false,
1266
+ "properties": {
1267
+ "command": {
1268
+ "items": {
1269
+ "type": "string"
1270
+ },
1271
+ "type": "array"
1272
+ }
1273
+ },
1274
+ "required": ["command"],
1275
+ "type": "object"
1276
+ }
1277
+ ]
1278
+ },
1279
+ "Service": {
1280
+ "additionalProperties": false,
1281
+ "description": "`[services.<name>]`.",
1282
+ "properties": {
1283
+ "checks": {
1284
+ "additionalProperties": {
1285
+ "$ref": "#/$defs/Check"
1286
+ },
1287
+ "default": {},
1288
+ "type": "object"
1289
+ },
1290
+ "default_branch": {
1291
+ "description": "The branch each change of this service starts from.",
1292
+ "title": "Default branch",
1293
+ "type": "string",
1294
+ "x-edgar": {
1295
+ "apply": "restart",
1296
+ "console": "edit",
1297
+ "group": "project"
1298
+ }
1299
+ },
1300
+ "env": {
1301
+ "additionalProperties": {
1302
+ "type": "string"
1303
+ },
1304
+ "default": {},
1305
+ "description": "Variables every command in this service's sandbox gets; never a credential.",
1306
+ "title": "Variables",
1307
+ "type": "object",
1308
+ "x-edgar": {
1309
+ "apply": "restart",
1310
+ "console": "edit",
1311
+ "group": "project"
1312
+ }
1313
+ },
1314
+ "environment": {
1315
+ "anyOf": [
1316
+ {
1317
+ "$ref": "#/$defs/Environment"
1318
+ },
1319
+ {
1320
+ "type": "null"
1321
+ }
1322
+ ],
1323
+ "description": "The extension that runs the service's stack around its checks.",
1324
+ "title": "Running stack",
1325
+ "x-edgar": {
1326
+ "apply": "restart",
1327
+ "console": "edit",
1328
+ "group": "project"
1329
+ }
1330
+ },
1331
+ "path_notices": {
1332
+ "default": [],
1333
+ "description": "A note a pull request carries once when it changes a path under a given prefix.",
1334
+ "items": {
1335
+ "$ref": "#/$defs/PathNotice"
1336
+ },
1337
+ "title": "Path notices",
1338
+ "type": "array",
1339
+ "x-edgar": {
1340
+ "apply": "restart",
1341
+ "console": "edit",
1342
+ "group": "project"
1343
+ }
1344
+ },
1345
+ "prepare": {
1346
+ "anyOf": [
1347
+ {
1348
+ "$ref": "#/$defs/Prepare"
1349
+ },
1350
+ {
1351
+ "type": "null"
1352
+ }
1353
+ ],
1354
+ "description": "The command that installs the service's dependencies once for each content of its `inputs`, so each sandbox starts with them.",
1355
+ "title": "Prepared dependencies",
1356
+ "x-edgar": {
1357
+ "apply": "restart",
1358
+ "console": "view",
1359
+ "group": "project"
1360
+ }
1361
+ },
1362
+ "repo": {
1363
+ "description": "The Git address or folder of the service's repository.",
1364
+ "title": "Repository",
1365
+ "type": "string",
1366
+ "x-edgar": {
1367
+ "apply": "restart",
1368
+ "console": "edit",
1369
+ "group": "project"
1370
+ }
1371
+ }
1372
+ },
1373
+ "required": ["repo", "default_branch"],
1374
+ "type": "object"
1375
+ },
1376
+ "StageOverride": {
1377
+ "additionalProperties": false,
1378
+ "description": "`[workflows.<name>.stages.<stage>]`: each key it names replaces the stage's own after every layer merged, and each key it leaves out keeps the stage's own value. A stage of a project's workflow file replaces the lower stage whole; this table changes one key of it.",
1379
+ "properties": {
1380
+ "agent": {
1381
+ "description": "The role this agent stage runs as, in place of its own.",
1382
+ "title": "Role",
1383
+ "type": ["string", "null"],
1384
+ "x-edgar": {
1385
+ "apply": "restart",
1386
+ "console": "edit",
1387
+ "group": "stages"
1388
+ }
1389
+ },
1390
+ "effort": {
1391
+ "anyOf": [
1392
+ {
1393
+ "$ref": "#/$defs/Effort"
1394
+ },
1395
+ {
1396
+ "type": "null"
1397
+ }
1398
+ ],
1399
+ "description": "How hard this agent stage thinks: `low`, `medium`, `high` or `max`, in place of its role's.",
1400
+ "title": "Effort",
1401
+ "x-edgar": {
1402
+ "apply": "restart",
1403
+ "console": "edit",
1404
+ "group": "stages"
1405
+ }
1406
+ },
1407
+ "max_tokens": {
1408
+ "description": "An attempt of this stage that uses more tokens than this ends.",
1409
+ "format": "uint64",
1410
+ "minimum": 1,
1411
+ "title": "Token budget",
1412
+ "type": ["integer", "null"],
1413
+ "x-edgar": {
1414
+ "apply": "restart",
1415
+ "console": "edit",
1416
+ "group": "stages"
1417
+ }
1418
+ },
1419
+ "model": {
1420
+ "description": "The provider this agent stage runs on, such as `claude` or `codex`, in place of its role's.",
1421
+ "title": "Provider",
1422
+ "type": ["string", "null"],
1423
+ "x-edgar": {
1424
+ "apply": "restart",
1425
+ "console": "edit",
1426
+ "group": "stages"
1427
+ }
1428
+ },
1429
+ "network": {
1430
+ "default": [],
1431
+ "description": "Hosts this stage's commands may reach, added to the stage's own.",
1432
+ "items": {
1433
+ "type": "string"
1434
+ },
1435
+ "title": "Added hosts",
1436
+ "type": "array",
1437
+ "x-edgar": {
1438
+ "apply": "restart",
1439
+ "console": "view",
1440
+ "group": "stages"
1441
+ }
1442
+ },
1443
+ "retry": {
1444
+ "$ref": "#/$defs/RetryOverride",
1445
+ "default": {
1446
+ "backoff": null,
1447
+ "interval_seconds": null,
1448
+ "max_attempts": null
1449
+ }
1450
+ },
1451
+ "silence_seconds": {
1452
+ "description": "An attempt of this agent stage that sends nothing for this many seconds ends as silent.",
1453
+ "format": "uint64",
1454
+ "minimum": 1,
1455
+ "title": "Silence limit",
1456
+ "type": ["integer", "null"],
1457
+ "x-edgar": {
1458
+ "apply": "restart",
1459
+ "console": "edit",
1460
+ "group": "stages"
1461
+ }
1462
+ },
1463
+ "timeout_seconds": {
1464
+ "description": "The most seconds one attempt of this stage may take, in place of the stage's own.",
1465
+ "format": "uint64",
1466
+ "minimum": 1,
1467
+ "title": "Time limit",
1468
+ "type": ["integer", "null"],
1469
+ "x-edgar": {
1470
+ "apply": "restart",
1471
+ "console": "edit",
1472
+ "group": "stages"
1473
+ }
1474
+ }
1475
+ },
1476
+ "type": "object"
1477
+ },
1478
+ "StorageLocation": {
1479
+ "description": "`gs://<bucket>[/<folder>]` or `s3://<bucket>[/<folder>]`.",
1480
+ "type": "string"
1481
+ },
1482
+ "StorageProvider": {
1483
+ "description": "The cloud vendors whose object storage `[storage]` names.",
1484
+ "enum": ["google", "amazon"],
1485
+ "type": "string"
1486
+ },
1487
+ "StorageSettings": {
1488
+ "additionalProperties": false,
1489
+ "description": "`[storage]`: the bucket that holds EDGAR's state off the machine. Credentials are never here: the machine's own identity, or a key that `[secrets]` names.",
1490
+ "properties": {
1491
+ "bucket": {
1492
+ "$ref": "#/$defs/BucketName",
1493
+ "description": "The bucket that holds EDGAR's state off the machine.",
1494
+ "title": "Bucket",
1495
+ "x-edgar": {
1496
+ "apply": "restart",
1497
+ "console": "view",
1498
+ "group": "storage"
1499
+ }
1500
+ },
1501
+ "endpoint": {
1502
+ "anyOf": [
1503
+ {
1504
+ "$ref": "#/$defs/Endpoint"
1505
+ },
1506
+ {
1507
+ "type": "null"
1508
+ }
1509
+ ],
1510
+ "description": "An S3-compatible service or an emulator to use in place of the vendor's own.",
1511
+ "title": "Storage address",
1512
+ "x-edgar": {
1513
+ "apply": "restart",
1514
+ "console": "view",
1515
+ "group": "storage"
1516
+ }
1517
+ },
1518
+ "prefix": {
1519
+ "description": "The folder in the bucket that EDGAR writes under, such as `edgar/production`.",
1520
+ "title": "Folder in the bucket",
1521
+ "type": ["string", "null"],
1522
+ "x-edgar": {
1523
+ "apply": "restart",
1524
+ "console": "view",
1525
+ "group": "storage"
1526
+ }
1527
+ },
1528
+ "provider": {
1529
+ "$ref": "#/$defs/StorageProvider",
1530
+ "description": "The vendor whose bucket holds EDGAR's state off the machine: `google` or `amazon`.",
1531
+ "title": "Cloud vendor",
1532
+ "x-edgar": {
1533
+ "apply": "restart",
1534
+ "console": "view",
1535
+ "group": "storage"
1536
+ }
1537
+ },
1538
+ "region": {
1539
+ "description": "The Amazon region of the bucket; from the environment when unset.",
1540
+ "title": "Region",
1541
+ "type": ["string", "null"],
1542
+ "x-edgar": {
1543
+ "apply": "restart",
1544
+ "console": "view",
1545
+ "group": "storage"
1546
+ }
1547
+ }
1548
+ },
1549
+ "required": ["provider", "bucket"],
1550
+ "type": "object"
1551
+ },
1552
+ "Store": {
1553
+ "additionalProperties": false,
1554
+ "description": "`[store]`; `retention_days = 0` keeps every payload.",
1555
+ "properties": {
1556
+ "backup_command": {
1557
+ "anyOf": [
1558
+ {
1559
+ "$ref": "#/$defs/Argv"
1560
+ },
1561
+ {
1562
+ "type": "null"
1563
+ }
1564
+ ],
1565
+ "description": "A program EDGAR runs after each copy, with the copy's path as its last argument.",
1566
+ "title": "Command after each backup",
1567
+ "x-edgar": {
1568
+ "apply": "live",
1569
+ "console": "view",
1570
+ "group": "storage"
1571
+ }
1572
+ },
1573
+ "backup_minutes": {
1574
+ "default": 1440,
1575
+ "description": "The minutes from one copy of the store to the next, at least 15.",
1576
+ "format": "uint32",
1577
+ "minimum": 0,
1578
+ "title": "Minutes between backups",
1579
+ "type": "integer",
1580
+ "x-edgar": {
1581
+ "apply": "live",
1582
+ "console": "edit",
1583
+ "group": "storage"
1584
+ }
1585
+ },
1586
+ "retention_days": {
1587
+ "default": 90,
1588
+ "description": "EDGAR trims what runs said after this many days; `0` keeps everything.",
1589
+ "format": "uint32",
1590
+ "minimum": 0,
1591
+ "title": "Days kept",
1592
+ "type": "integer",
1593
+ "x-edgar": {
1594
+ "apply": "live",
1595
+ "console": "edit",
1596
+ "group": "storage"
1597
+ }
1598
+ }
1599
+ },
1600
+ "type": "object"
1601
+ },
1602
+ "Tools": {
1603
+ "additionalProperties": false,
1604
+ "description": "`[tools] disabled` removes a tool; `enabled` turns on one its manifest ships off.",
1605
+ "properties": {
1606
+ "disabled": {
1607
+ "default": [],
1608
+ "description": "Tools that this project turns off.",
1609
+ "items": {
1610
+ "type": "string"
1611
+ },
1612
+ "title": "Turned-off tools",
1613
+ "type": "array",
1614
+ "x-edgar": {
1615
+ "apply": "restart",
1616
+ "console": "edit",
1617
+ "group": "agents"
1618
+ }
1619
+ },
1620
+ "enabled": {
1621
+ "default": [],
1622
+ "description": "Tools that an extension ships turned off and this project turns on.",
1623
+ "items": {
1624
+ "type": "string"
1625
+ },
1626
+ "title": "Turned-on tools",
1627
+ "type": "array",
1628
+ "x-edgar": {
1629
+ "apply": "restart",
1630
+ "console": "edit",
1631
+ "group": "agents"
1632
+ }
1633
+ }
1634
+ },
1635
+ "type": "object"
1636
+ },
1637
+ "Tracker": {
1638
+ "additionalProperties": false,
1639
+ "description": "`[tracker]`. `attachment_hosts` empty: only the host of the card's own url.",
1640
+ "properties": {
1641
+ "attachment_hosts": {
1642
+ "default": [],
1643
+ "description": "Hosts that a card's attachments may come from, beside the host of the card's own link.",
1644
+ "items": {
1645
+ "type": "string"
1646
+ },
1647
+ "title": "Attachment hosts",
1648
+ "type": "array",
1649
+ "x-edgar": {
1650
+ "apply": "restart",
1651
+ "console": "view",
1652
+ "group": "tracker"
1653
+ }
1654
+ },
1655
+ "default": {
1656
+ "description": "The tracker that gets work with no card, in a project with more than one tracker.",
1657
+ "title": "Default tracker",
1658
+ "type": ["string", "null"],
1659
+ "x-edgar": {
1660
+ "apply": "restart",
1661
+ "console": "edit",
1662
+ "group": "tracker"
1663
+ }
1664
+ },
1665
+ "default_service": {
1666
+ "description": "The service of a card that names none, in a project with more than one service.",
1667
+ "title": "Default service",
1668
+ "type": ["string", "null"],
1669
+ "x-edgar": {
1670
+ "apply": "live",
1671
+ "console": "edit",
1672
+ "group": "tracker"
1673
+ }
1674
+ },
1675
+ "mark_seen": {
1676
+ "default": true,
1677
+ "description": "Whether a run that starts from a card first marks the card seen, with a reaction where the tracker has one, so the person who filed it knows EDGAR picked it up.",
1678
+ "title": "Mark cards seen",
1679
+ "type": "boolean",
1680
+ "x-edgar": {
1681
+ "apply": "live",
1682
+ "console": "edit",
1683
+ "group": "tracker"
1684
+ }
1685
+ },
1686
+ "outside": {
1687
+ "$ref": "#/$defs/Outside",
1688
+ "default": "answers",
1689
+ "description": "What the words of a person outside the team, as the tracker says, may start: `answers`, the workflows whose trigger does not ask for `trust = \"team\"`, such as triage and answers, or `nothing`.",
1690
+ "title": "Outside the team",
1691
+ "x-edgar": {
1692
+ "apply": "restart",
1693
+ "console": "edit",
1694
+ "group": "tracker"
1695
+ }
1696
+ },
1697
+ "sweep_seconds": {
1698
+ "default": 30,
1699
+ "description": "How often EDGAR reads each tracker for new and changed cards.",
1700
+ "format": "uint64",
1701
+ "minimum": 1,
1702
+ "title": "Seconds between tracker reads",
1703
+ "type": "integer",
1704
+ "x-edgar": {
1705
+ "apply": "restart",
1706
+ "console": "edit",
1707
+ "group": "tracker"
1708
+ }
1709
+ }
1710
+ },
1711
+ "type": "object"
1712
+ },
1713
+ "TriggerPath": {
1714
+ "anyOf": [
1715
+ {
1716
+ "type": "string"
1717
+ },
1718
+ {
1719
+ "items": {
1720
+ "type": "string"
1721
+ },
1722
+ "minItems": 1,
1723
+ "type": "array"
1724
+ }
1725
+ ],
1726
+ "description": "A path into the run's input, `trigger.` then a field, or a list of them where the first with a value is the key."
1727
+ },
1728
+ "Update": {
1729
+ "additionalProperties": false,
1730
+ "description": "`[update]`: whether the worker looks for a newer release of EDGAR, how often, and when and to which version it updates itself.",
1731
+ "properties": {
1732
+ "check_minutes": {
1733
+ "description": "How often the worker looks for a newer release; 360 when unset.",
1734
+ "format": "uint32",
1735
+ "minimum": 1,
1736
+ "title": "Minutes between update checks",
1737
+ "type": ["integer", "null"],
1738
+ "x-edgar": {
1739
+ "apply": "restart",
1740
+ "console": "edit",
1741
+ "group": "updates"
1742
+ }
1743
+ },
1744
+ "enabled": {
1745
+ "default": true,
1746
+ "description": "Whether the worker looks for a newer release of EDGAR and installs it in the window.",
1747
+ "title": "Self-update",
1748
+ "type": "boolean",
1749
+ "x-edgar": {
1750
+ "apply": "restart",
1751
+ "console": "edit",
1752
+ "group": "updates"
1753
+ }
1754
+ },
1755
+ "time_zone": {
1756
+ "description": "The IANA zone that reads the update window, such as `Europe/Paris`; the machine's own zone when unset.",
1757
+ "title": "Time zone",
1758
+ "type": ["string", "null"],
1759
+ "x-edgar": {
1760
+ "apply": "restart",
1761
+ "console": "edit",
1762
+ "group": "updates"
1763
+ }
1764
+ },
1765
+ "version": {
1766
+ "description": "The one version EDGAR updates to; the newest stable release when unset.",
1767
+ "title": "Version to hold",
1768
+ "type": ["string", "null"],
1769
+ "x-edgar": {
1770
+ "apply": "restart",
1771
+ "console": "edit",
1772
+ "group": "updates"
1773
+ }
1774
+ },
1775
+ "window": {
1776
+ "anyOf": [
1777
+ {
1778
+ "$ref": "#/$defs/Window"
1779
+ },
1780
+ {
1781
+ "type": "null"
1782
+ }
1783
+ ],
1784
+ "description": "The time of night when the worker installs a newer release, as `HH:MM-HH:MM`; `00:00-06:00` when unset.",
1785
+ "title": "Update window",
1786
+ "x-edgar": {
1787
+ "apply": "restart",
1788
+ "console": "edit",
1789
+ "group": "updates"
1790
+ }
1791
+ }
1792
+ },
1793
+ "type": "object"
1794
+ },
1795
+ "Webhooks": {
1796
+ "additionalProperties": false,
1797
+ "description": "`[webhooks]`: `/hooks/<extension>/<route>` answers a loopback `Host` only, unless `[webhooks.public]` is enabled.",
1798
+ "properties": {
1799
+ "public": {
1800
+ "anyOf": [
1801
+ {
1802
+ "$ref": "#/$defs/PublicWebhooks"
1803
+ },
1804
+ {
1805
+ "type": "null"
1806
+ }
1807
+ ]
1808
+ }
1809
+ },
1810
+ "type": "object"
1811
+ },
1812
+ "Window": {
1813
+ "description": "`HH:MM-HH:MM`: the minutes of a day from `start` up to `end`, past midnight when `end` comes first.",
1814
+ "type": "string"
1815
+ },
1816
+ "WorkflowSettings": {
1817
+ "additionalProperties": false,
1818
+ "description": "`[workflows.<name>]`: the settings of one workflow that its file does not hold.",
1819
+ "properties": {
1820
+ "concurrency": {
1821
+ "anyOf": [
1822
+ {
1823
+ "$ref": "#/$defs/KeyedConcurrency"
1824
+ },
1825
+ {
1826
+ "type": "null"
1827
+ }
1828
+ ],
1829
+ "description": "At most `limit` runs of this workflow at once for each value of `key` in the run's input; the next one waits.",
1830
+ "title": "Runs at once per key",
1831
+ "x-edgar": {
1832
+ "apply": "live",
1833
+ "console": "edit",
1834
+ "group": "schedules"
1835
+ }
1836
+ },
1837
+ "stages": {
1838
+ "additionalProperties": {
1839
+ "$ref": "#/$defs/StageOverride"
1840
+ },
1841
+ "description": "The keys of one stage this project changes, by the stage's name, on top of the stage every layer gives, so the stage is never copied.",
1842
+ "type": "object"
1843
+ }
1844
+ },
1845
+ "type": "object"
1846
+ }
1847
+ },
1848
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1849
+ "additionalProperties": false,
1850
+ "properties": {
1851
+ "agents": {
1852
+ "additionalProperties": {
1853
+ "$ref": "#/$defs/RoleSettings"
1854
+ },
1855
+ "default": {},
1856
+ "type": "object"
1857
+ },
1858
+ "alerts": {
1859
+ "$ref": "#/$defs/Alerts",
1860
+ "default": {
1861
+ "expected": []
1862
+ }
1863
+ },
1864
+ "api": {
1865
+ "$ref": "#/$defs/Api",
1866
+ "default": {
1867
+ "bind": null,
1868
+ "identity": null,
1869
+ "public_url": null
1870
+ }
1871
+ },
1872
+ "approval": {
1873
+ "additionalProperties": {
1874
+ "$ref": "#/$defs/ApprovalPolicy"
1875
+ },
1876
+ "default": {},
1877
+ "description": "When each tool waits for a person: `never`, `auto`, `once` or `always`, only stricter than its extension's own.",
1878
+ "title": "Approval",
1879
+ "type": "object",
1880
+ "x-edgar": {
1881
+ "apply": "live",
1882
+ "console": "edit",
1883
+ "group": "approval"
1884
+ }
1885
+ },
1886
+ "concurrency": {
1887
+ "$ref": "#/$defs/Concurrency",
1888
+ "default": {
1889
+ "sandboxes": null,
1890
+ "slots": null
1891
+ }
1892
+ },
1893
+ "console": {
1894
+ "$ref": "#/$defs/Console",
1895
+ "default": {
1896
+ "ask_per_minute": null,
1897
+ "bind": null
1898
+ }
1899
+ },
1900
+ "daemon": {
1901
+ "$ref": "#/$defs/Daemon",
1902
+ "default": {
1903
+ "enabled": false
1904
+ }
1905
+ },
1906
+ "defaults": {
1907
+ "$ref": "#/$defs/Defaults",
1908
+ "default": {
1909
+ "agent": {
1910
+ "max_tokens": null,
1911
+ "silence_seconds": null,
1912
+ "timeout_seconds": null
1913
+ },
1914
+ "check": {
1915
+ "timeout_seconds": null
1916
+ },
1917
+ "tool": {
1918
+ "timeout_seconds": null
1919
+ },
1920
+ "wait": {
1921
+ "timeout_seconds": null
1922
+ }
1923
+ }
1924
+ },
1925
+ "extensions": {
1926
+ "$ref": "#/$defs/Extensions",
1927
+ "default": {
1928
+ "enabled": []
1929
+ }
1930
+ },
1931
+ "hooks": {
1932
+ "$ref": "#/$defs/Hooks",
1933
+ "default": {
1934
+ "on_timeout": "pass",
1935
+ "order": ["edgar__guardrails"]
1936
+ }
1937
+ },
1938
+ "limits": {
1939
+ "$ref": "#/$defs/Limits",
1940
+ "default": {
1941
+ "card_runs_per_day": 20,
1942
+ "comment_bytes": 65536,
1943
+ "pull_requests": null,
1944
+ "questions_per_day": 10,
1945
+ "self_merge_files": 5
1946
+ }
1947
+ },
1948
+ "logs": {
1949
+ "$ref": "#/$defs/Logs",
1950
+ "default": {
1951
+ "format": "text",
1952
+ "keep": null,
1953
+ "max_bytes": null
1954
+ }
1955
+ },
1956
+ "mcp": {
1957
+ "$ref": "#/$defs/Mcp",
1958
+ "default": {
1959
+ "remote": null
1960
+ }
1961
+ },
1962
+ "outbox": {
1963
+ "additionalProperties": {
1964
+ "$ref": "#/$defs/OutboxChannel"
1965
+ },
1966
+ "default": {},
1967
+ "type": "object"
1968
+ },
1969
+ "people": {
1970
+ "additionalProperties": {
1971
+ "$ref": "#/$defs/Person"
1972
+ },
1973
+ "default": {},
1974
+ "type": "object"
1975
+ },
1976
+ "project": {
1977
+ "$ref": "#/$defs/ProjectSettings"
1978
+ },
1979
+ "providers": {
1980
+ "additionalProperties": false,
1981
+ "default": {},
1982
+ "properties": {
1983
+ "acp": {
1984
+ "$ref": "#/$defs/ProviderSettings"
1985
+ },
1986
+ "claude": {
1987
+ "$ref": "#/$defs/ProviderSettings"
1988
+ },
1989
+ "codex": {
1990
+ "$ref": "#/$defs/ProviderSettings"
1991
+ }
1992
+ },
1993
+ "type": "object"
1994
+ },
1995
+ "roles": {
1996
+ "$ref": "#/$defs/Roles",
1997
+ "default": {
1998
+ "operator": []
1999
+ }
2000
+ },
2001
+ "runtime": {
2002
+ "$ref": "#/$defs/Runtime",
2003
+ "default": {
2004
+ "idle_seconds": 300
2005
+ }
2006
+ },
2007
+ "sandbox": {
2008
+ "$ref": "#/$defs/Sandbox",
2009
+ "default": {
2010
+ "deny": [],
2011
+ "git_tokens": {
2012
+ "github.com": "GITHUB_TOKEN"
2013
+ },
2014
+ "image": null,
2015
+ "keep_while_waiting_hours": 72,
2016
+ "kind": "worktree",
2017
+ "max_behind": 20,
2018
+ "min_free_gb": 5,
2019
+ "network": [],
2020
+ "secret_files": []
2021
+ }
2022
+ },
2023
+ "screenshots": {
2024
+ "$ref": "#/$defs/Screenshots",
2025
+ "default": {}
2026
+ },
2027
+ "secrets": {
2028
+ "additionalProperties": {
2029
+ "$ref": "#/$defs/SecretSource"
2030
+ },
2031
+ "default": {},
2032
+ "description": "Where each secret comes from; only the names and the kind of source are shown.",
2033
+ "title": "Secrets",
2034
+ "type": "object",
2035
+ "x-edgar": {
2036
+ "apply": "restart",
2037
+ "console": "view",
2038
+ "group": "agents"
2039
+ }
2040
+ },
2041
+ "services": {
2042
+ "additionalProperties": {
2043
+ "$ref": "#/$defs/Service"
2044
+ },
2045
+ "default": {},
2046
+ "type": "object"
2047
+ },
2048
+ "storage": {
2049
+ "anyOf": [
2050
+ {
2051
+ "$ref": "#/$defs/StorageSettings"
2052
+ },
2053
+ {
2054
+ "type": "null"
2055
+ }
2056
+ ],
2057
+ "description": "With no table, every backup stays on the machine."
2058
+ },
2059
+ "store": {
2060
+ "$ref": "#/$defs/Store",
2061
+ "default": {
2062
+ "backup_minutes": 1440,
2063
+ "retention_days": 90
2064
+ }
2065
+ },
2066
+ "tools": {
2067
+ "$ref": "#/$defs/Tools",
2068
+ "default": {
2069
+ "disabled": [],
2070
+ "enabled": []
2071
+ }
2072
+ },
2073
+ "tracker": {
2074
+ "$ref": "#/$defs/Tracker",
2075
+ "default": {
2076
+ "attachment_hosts": [],
2077
+ "default": null,
2078
+ "default_service": null,
2079
+ "mark_seen": true,
2080
+ "outside": "answers",
2081
+ "sweep_seconds": 30
2082
+ }
2083
+ },
2084
+ "update": {
2085
+ "$ref": "#/$defs/Update",
2086
+ "default": {
2087
+ "check_minutes": null,
2088
+ "enabled": true,
2089
+ "time_zone": null,
2090
+ "version": null,
2091
+ "window": null
2092
+ }
2093
+ },
2094
+ "webhooks": {
2095
+ "$ref": "#/$defs/Webhooks",
2096
+ "default": {
2097
+ "public": null
2098
+ }
2099
+ },
2100
+ "workflows": {
2101
+ "additionalProperties": {
2102
+ "$ref": "#/$defs/WorkflowSettings"
2103
+ },
2104
+ "default": {},
2105
+ "type": "object"
2106
+ }
2107
+ },
2108
+ "required": ["project"],
2109
+ "title": "Config",
2110
+ "type": "object"
2111
+ }