thoth-agents 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +339 -0
  3. package/dist/agents/deep.d.ts +2 -0
  4. package/dist/agents/designer.d.ts +2 -0
  5. package/dist/agents/explorer.d.ts +2 -0
  6. package/dist/agents/index.d.ts +8 -0
  7. package/dist/agents/librarian.d.ts +2 -0
  8. package/dist/agents/oracle.d.ts +2 -0
  9. package/dist/agents/orchestrator.d.ts +15 -0
  10. package/dist/agents/prompt-dialects.d.ts +28 -0
  11. package/dist/agents/prompt-sections.d.ts +47 -0
  12. package/dist/agents/prompt-utils.d.ts +25 -0
  13. package/dist/agents/quick.d.ts +2 -0
  14. package/dist/cli/codex-config-io.d.ts +31 -0
  15. package/dist/cli/codex-install.d.ts +41 -0
  16. package/dist/cli/codex-paths.d.ts +29 -0
  17. package/dist/cli/config-io.d.ts +22 -0
  18. package/dist/cli/config-manager.d.ts +4 -0
  19. package/dist/cli/custom-skills.d.ts +48 -0
  20. package/dist/cli/index.d.ts +3 -0
  21. package/dist/cli/index.js +4579 -0
  22. package/dist/cli/install.d.ts +3 -0
  23. package/dist/cli/model-key-normalization.d.ts +1 -0
  24. package/dist/cli/paths.d.ts +21 -0
  25. package/dist/cli/providers.d.ts +120 -0
  26. package/dist/cli/skill-manifest.d.ts +32 -0
  27. package/dist/cli/skills.d.ts +26 -0
  28. package/dist/cli/system.d.ts +6 -0
  29. package/dist/cli/types.d.ts +58 -0
  30. package/dist/config/constants.d.ts +17 -0
  31. package/dist/config/index.d.ts +5 -0
  32. package/dist/config/loader.d.ts +33 -0
  33. package/dist/config/schema.d.ts +279 -0
  34. package/dist/config/utils.d.ts +10 -0
  35. package/dist/delegation/project-id.d.ts +10 -0
  36. package/dist/delegation/types.d.ts +39 -0
  37. package/dist/harness/adapters/codex-surfaces.d.ts +219 -0
  38. package/dist/harness/adapters/codex.d.ts +8 -0
  39. package/dist/harness/adapters/opencode.d.ts +10 -0
  40. package/dist/harness/codex-plugin-paths.d.ts +1 -0
  41. package/dist/harness/core/agent-pack.d.ts +88 -0
  42. package/dist/harness/core/memory-governance.d.ts +33 -0
  43. package/dist/harness/core/sdd.d.ts +100 -0
  44. package/dist/harness/core/skills.d.ts +183 -0
  45. package/dist/harness/generate-codex-plugin.d.ts +9 -0
  46. package/dist/harness/registry.d.ts +6 -0
  47. package/dist/harness/types.d.ts +85 -0
  48. package/dist/harness/writers/codex-plugin-package.d.ts +26 -0
  49. package/dist/harness/writers/codex-toml.d.ts +10 -0
  50. package/dist/harness/writers/skill-layout.d.ts +15 -0
  51. package/dist/hooks/auto-update-checker/cache.d.ts +7 -0
  52. package/dist/hooks/auto-update-checker/checker.d.ts +28 -0
  53. package/dist/hooks/auto-update-checker/constants.d.ts +11 -0
  54. package/dist/hooks/auto-update-checker/index.d.ts +18 -0
  55. package/dist/hooks/auto-update-checker/types.d.ts +23 -0
  56. package/dist/hooks/chat-headers.d.ts +16 -0
  57. package/dist/hooks/delegate-task-retry/guidance.d.ts +2 -0
  58. package/dist/hooks/delegate-task-retry/hook.d.ts +8 -0
  59. package/dist/hooks/delegate-task-retry/index.d.ts +4 -0
  60. package/dist/hooks/delegate-task-retry/patterns.d.ts +11 -0
  61. package/dist/hooks/foreground-fallback/index.d.ts +73 -0
  62. package/dist/hooks/index.d.ts +10 -0
  63. package/dist/hooks/json-error-recovery/hook.d.ts +18 -0
  64. package/dist/hooks/json-error-recovery/index.d.ts +1 -0
  65. package/dist/hooks/phase-reminder/index.d.ts +26 -0
  66. package/dist/hooks/post-read-nudge/index.d.ts +18 -0
  67. package/dist/hooks/skill-sync.d.ts +10 -0
  68. package/dist/hooks/thoth-mem/index.d.ts +46 -0
  69. package/dist/hooks/thoth-mem/protocol.d.ts +7 -0
  70. package/dist/index.d.ts +5 -0
  71. package/dist/index.js +6509 -0
  72. package/dist/mcp/context7.d.ts +7 -0
  73. package/dist/mcp/exa.d.ts +6 -0
  74. package/dist/mcp/grep-app.d.ts +7 -0
  75. package/dist/mcp/index.d.ts +7 -0
  76. package/dist/mcp/thoth.d.ts +3 -0
  77. package/dist/mcp/types.d.ts +12 -0
  78. package/dist/sdd/artifact-governance/artifact-loader.d.ts +55 -0
  79. package/dist/sdd/artifact-governance/index.d.ts +6 -0
  80. package/dist/sdd/artifact-governance/tasks-validator.d.ts +17 -0
  81. package/dist/sdd/artifact-governance/types.d.ts +52 -0
  82. package/dist/thoth/client.d.ts +14 -0
  83. package/dist/thoth/index.d.ts +2 -0
  84. package/dist/tools/ast-grep/cli.d.ts +15 -0
  85. package/dist/tools/ast-grep/constants.d.ts +25 -0
  86. package/dist/tools/ast-grep/downloader.d.ts +5 -0
  87. package/dist/tools/ast-grep/index.d.ts +10 -0
  88. package/dist/tools/ast-grep/tools.d.ts +3 -0
  89. package/dist/tools/ast-grep/types.d.ts +30 -0
  90. package/dist/tools/ast-grep/utils.d.ts +4 -0
  91. package/dist/tools/index.d.ts +2 -0
  92. package/dist/tools/lsp/client.d.ts +42 -0
  93. package/dist/tools/lsp/config-store.d.ts +29 -0
  94. package/dist/tools/lsp/config.d.ts +4 -0
  95. package/dist/tools/lsp/constants.d.ts +25 -0
  96. package/dist/tools/lsp/index.d.ts +4 -0
  97. package/dist/tools/lsp/tools.d.ts +5 -0
  98. package/dist/tools/lsp/types.d.ts +35 -0
  99. package/dist/tools/lsp/utils.d.ts +34 -0
  100. package/dist/utils/agent-variant.d.ts +47 -0
  101. package/dist/utils/env.d.ts +1 -0
  102. package/dist/utils/file-io.d.ts +3 -0
  103. package/dist/utils/frontmatter-yaml.d.ts +4 -0
  104. package/dist/utils/index.d.ts +7 -0
  105. package/dist/utils/internal-initiator.d.ts +6 -0
  106. package/dist/utils/logger.d.ts +1 -0
  107. package/dist/utils/polling.d.ts +21 -0
  108. package/dist/utils/subprocess.d.ts +24 -0
  109. package/dist/utils/tmux-session-manager.d.ts +63 -0
  110. package/dist/utils/tmux.d.ts +32 -0
  111. package/dist/utils/zip-extractor.d.ts +1 -0
  112. package/package.json +81 -0
  113. package/src/skills/_shared/openspec-convention.md +131 -0
  114. package/src/skills/_shared/persistence-contract.md +162 -0
  115. package/src/skills/_shared/thoth-mem-convention.md +124 -0
  116. package/src/skills/executing-plans/SKILL.md +245 -0
  117. package/src/skills/plan-reviewer/SKILL.md +115 -0
  118. package/src/skills/requirements-interview/SKILL.md +212 -0
  119. package/src/skills/sdd-apply/SKILL.md +89 -0
  120. package/src/skills/sdd-archive/SKILL.md +87 -0
  121. package/src/skills/sdd-design/SKILL.md +92 -0
  122. package/src/skills/sdd-init/SKILL.md +148 -0
  123. package/src/skills/sdd-propose/SKILL.md +89 -0
  124. package/src/skills/sdd-spec/SKILL.md +93 -0
  125. package/src/skills/sdd-tasks/SKILL.md +142 -0
  126. package/src/skills/sdd-verify/SKILL.md +99 -0
  127. package/src/skills/thoth-mem-agents/SKILL.md +355 -0
  128. package/thoth-agents.schema.json +470 -0
package/thoth-agents.schema.json ADDED
@@ -0,0 +1,470 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "preset": {
6
+ "type": "string"
7
+ },
8
+ "setDefaultAgent": {
9
+ "type": "boolean"
10
+ },
11
+ "scoringEngineVersion": {
12
+ "type": "string",
13
+ "enum": ["v1", "v2-shadow", "v2"]
14
+ },
15
+ "balanceProviderUsage": {
16
+ "type": "boolean"
17
+ },
18
+ "manualPlan": {
19
+ "type": "object",
20
+ "properties": {
21
+ "orchestrator": {
22
+ "type": "object",
23
+ "properties": {
24
+ "primary": {
25
+ "type": "string",
26
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
27
+ },
28
+ "fallback1": {
29
+ "type": "string",
30
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
31
+ },
32
+ "fallback2": {
33
+ "type": "string",
34
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
35
+ },
36
+ "fallback3": {
37
+ "type": "string",
38
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
39
+ }
40
+ },
41
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
42
+ },
43
+ "oracle": {
44
+ "type": "object",
45
+ "properties": {
46
+ "primary": {
47
+ "type": "string",
48
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
49
+ },
50
+ "fallback1": {
51
+ "type": "string",
52
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
53
+ },
54
+ "fallback2": {
55
+ "type": "string",
56
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
57
+ },
58
+ "fallback3": {
59
+ "type": "string",
60
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
61
+ }
62
+ },
63
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
64
+ },
65
+ "designer": {
66
+ "type": "object",
67
+ "properties": {
68
+ "primary": {
69
+ "type": "string",
70
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
71
+ },
72
+ "fallback1": {
73
+ "type": "string",
74
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
75
+ },
76
+ "fallback2": {
77
+ "type": "string",
78
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
79
+ },
80
+ "fallback3": {
81
+ "type": "string",
82
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
83
+ }
84
+ },
85
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
86
+ },
87
+ "explorer": {
88
+ "type": "object",
89
+ "properties": {
90
+ "primary": {
91
+ "type": "string",
92
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
93
+ },
94
+ "fallback1": {
95
+ "type": "string",
96
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
97
+ },
98
+ "fallback2": {
99
+ "type": "string",
100
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
101
+ },
102
+ "fallback3": {
103
+ "type": "string",
104
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
105
+ }
106
+ },
107
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
108
+ },
109
+ "librarian": {
110
+ "type": "object",
111
+ "properties": {
112
+ "primary": {
113
+ "type": "string",
114
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
115
+ },
116
+ "fallback1": {
117
+ "type": "string",
118
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
119
+ },
120
+ "fallback2": {
121
+ "type": "string",
122
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
123
+ },
124
+ "fallback3": {
125
+ "type": "string",
126
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
127
+ }
128
+ },
129
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
130
+ },
131
+ "quick": {
132
+ "type": "object",
133
+ "properties": {
134
+ "primary": {
135
+ "type": "string",
136
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
137
+ },
138
+ "fallback1": {
139
+ "type": "string",
140
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
141
+ },
142
+ "fallback2": {
143
+ "type": "string",
144
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
145
+ },
146
+ "fallback3": {
147
+ "type": "string",
148
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
149
+ }
150
+ },
151
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
152
+ },
153
+ "deep": {
154
+ "type": "object",
155
+ "properties": {
156
+ "primary": {
157
+ "type": "string",
158
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
159
+ },
160
+ "fallback1": {
161
+ "type": "string",
162
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
163
+ },
164
+ "fallback2": {
165
+ "type": "string",
166
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
167
+ },
168
+ "fallback3": {
169
+ "type": "string",
170
+ "pattern": "^[^/\\s]+\\/[^\\s]+$"
171
+ }
172
+ },
173
+ "required": ["primary", "fallback1", "fallback2", "fallback3"]
174
+ }
175
+ },
176
+ "required": [
177
+ "orchestrator",
178
+ "oracle",
179
+ "designer",
180
+ "explorer",
181
+ "librarian",
182
+ "quick",
183
+ "deep"
184
+ ],
185
+ "additionalProperties": false
186
+ },
187
+ "presets": {
188
+ "type": "object",
189
+ "propertyNames": {
190
+ "type": "string"
191
+ },
192
+ "additionalProperties": {
193
+ "type": "object",
194
+ "propertyNames": {
195
+ "type": "string"
196
+ },
197
+ "additionalProperties": {
198
+ "type": "object",
199
+ "properties": {
200
+ "model": {
201
+ "anyOf": [
202
+ {
203
+ "type": "string"
204
+ },
205
+ {
206
+ "type": "array",
207
+ "items": {
208
+ "anyOf": [
209
+ {
210
+ "type": "string"
211
+ },
212
+ {
213
+ "type": "object",
214
+ "properties": {
215
+ "id": {
216
+ "type": "string"
217
+ },
218
+ "variant": {
219
+ "type": "string"
220
+ }
221
+ },
222
+ "required": ["id"]
223
+ }
224
+ ]
225
+ }
226
+ }
227
+ ]
228
+ },
229
+ "temperature": {
230
+ "type": "number",
231
+ "minimum": 0,
232
+ "maximum": 2
233
+ },
234
+ "steps": {
235
+ "type": "integer",
236
+ "minimum": 1,
237
+ "maximum": 9007199254740991
238
+ },
239
+ "variant": {
240
+ "type": "string"
241
+ }
242
+ }
243
+ }
244
+ }
245
+ },
246
+ "agents": {
247
+ "type": "object",
248
+ "propertyNames": {
249
+ "type": "string"
250
+ },
251
+ "additionalProperties": {
252
+ "type": "object",
253
+ "properties": {
254
+ "model": {
255
+ "anyOf": [
256
+ {
257
+ "type": "string"
258
+ },
259
+ {
260
+ "type": "array",
261
+ "items": {
262
+ "anyOf": [
263
+ {
264
+ "type": "string"
265
+ },
266
+ {
267
+ "type": "object",
268
+ "properties": {
269
+ "id": {
270
+ "type": "string"
271
+ },
272
+ "variant": {
273
+ "type": "string"
274
+ }
275
+ },
276
+ "required": ["id"]
277
+ }
278
+ ]
279
+ }
280
+ }
281
+ ]
282
+ },
283
+ "temperature": {
284
+ "type": "number",
285
+ "minimum": 0,
286
+ "maximum": 2
287
+ },
288
+ "steps": {
289
+ "type": "integer",
290
+ "minimum": 1,
291
+ "maximum": 9007199254740991
292
+ },
293
+ "variant": {
294
+ "type": "string"
295
+ }
296
+ }
297
+ }
298
+ },
299
+ "disabled_mcps": {
300
+ "type": "array",
301
+ "items": {
302
+ "type": "string"
303
+ }
304
+ },
305
+ "tmux": {
306
+ "type": "object",
307
+ "properties": {
308
+ "enabled": {
309
+ "default": false,
310
+ "type": "boolean"
311
+ },
312
+ "layout": {
313
+ "default": "main-vertical",
314
+ "type": "string",
315
+ "enum": [
316
+ "main-horizontal",
317
+ "main-vertical",
318
+ "tiled",
319
+ "even-horizontal",
320
+ "even-vertical"
321
+ ]
322
+ },
323
+ "main_pane_size": {
324
+ "default": 60,
325
+ "type": "number",
326
+ "minimum": 20,
327
+ "maximum": 80
328
+ }
329
+ }
330
+ },
331
+ "fallback": {
332
+ "type": "object",
333
+ "properties": {
334
+ "enabled": {
335
+ "default": true,
336
+ "type": "boolean"
337
+ },
338
+ "timeoutMs": {
339
+ "default": 15000,
340
+ "type": "number",
341
+ "minimum": 0
342
+ },
343
+ "retryDelayMs": {
344
+ "default": 500,
345
+ "type": "number",
346
+ "minimum": 0
347
+ },
348
+ "chains": {
349
+ "default": {},
350
+ "type": "object",
351
+ "properties": {
352
+ "orchestrator": {
353
+ "minItems": 1,
354
+ "type": "array",
355
+ "items": {
356
+ "type": "string"
357
+ }
358
+ },
359
+ "oracle": {
360
+ "minItems": 1,
361
+ "type": "array",
362
+ "items": {
363
+ "type": "string"
364
+ }
365
+ },
366
+ "designer": {
367
+ "minItems": 1,
368
+ "type": "array",
369
+ "items": {
370
+ "type": "string"
371
+ }
372
+ },
373
+ "explorer": {
374
+ "minItems": 1,
375
+ "type": "array",
376
+ "items": {
377
+ "type": "string"
378
+ }
379
+ },
380
+ "librarian": {
381
+ "minItems": 1,
382
+ "type": "array",
383
+ "items": {
384
+ "type": "string"
385
+ }
386
+ },
387
+ "quick": {
388
+ "minItems": 1,
389
+ "type": "array",
390
+ "items": {
391
+ "type": "string"
392
+ }
393
+ },
394
+ "deep": {
395
+ "minItems": 1,
396
+ "type": "array",
397
+ "items": {
398
+ "type": "string"
399
+ }
400
+ }
401
+ },
402
+ "additionalProperties": {
403
+ "minItems": 1,
404
+ "type": "array",
405
+ "items": {
406
+ "type": "string"
407
+ }
408
+ }
409
+ }
410
+ }
411
+ },
412
+ "thoth": {
413
+ "type": "object",
414
+ "properties": {
415
+ "command": {
416
+ "type": "array",
417
+ "items": {
418
+ "type": "string"
419
+ }
420
+ },
421
+ "data_dir": {
422
+ "type": "string"
423
+ },
424
+ "environment": {
425
+ "type": "object",
426
+ "propertyNames": {
427
+ "type": "string"
428
+ },
429
+ "additionalProperties": {
430
+ "type": "string"
431
+ }
432
+ },
433
+ "timeout": {
434
+ "type": "number"
435
+ },
436
+ "http_port": {
437
+ "type": "number"
438
+ }
439
+ }
440
+ },
441
+ "artifactStore": {
442
+ "type": "object",
443
+ "properties": {
444
+ "mode": {
445
+ "default": "hybrid",
446
+ "type": "string",
447
+ "enum": ["thoth-mem", "openspec", "hybrid"]
448
+ }
449
+ }
450
+ },
451
+ "codex": {
452
+ "type": "object",
453
+ "properties": {
454
+ "enabled": {
455
+ "default": false,
456
+ "type": "boolean"
457
+ },
458
+ "outputRoot": {
459
+ "type": "string"
460
+ },
461
+ "dryRun": {
462
+ "default": true,
463
+ "type": "boolean"
464
+ }
465
+ }
466
+ }
467
+ },
468
+ "title": "thoth-agents",
469
+ "description": "Configuration schema for thoth-agents plugin for OpenCode"
470
+ }